App SDK
Modern composition and developer contracts
Release the current composition contract, notifications, and automatic approval surfaces.
Changed
-
SDK distribution moves to GitHub (
nexia-cloud-os/app-sdk-laravel) for private Composer source and public npmjs for@amuzcorp/nexia-app-sdk-react. Existing0.5.0artifacts retain their versions and content. Consumers update registry/repository configuration; npm downloads need no token, while private Composer source still requires GitHub access. -
Resource Composition now has one modern
schema_version: 1wire contract. It requires graphrelationships,population, typedwherepredicates, and the modern result fields; row results additionally requirerow_source. -
React SDK source development supports
pnpm run build:watchfrompackages/react. It updates the publicdistexports as source changes, reports type errors, and resumes after corrections. Core can run this watcher with Vite when the local SDK source is selected. Published package names and exports are unchanged. -
ResourceReferenceResolutionContextaccepts bounded, owner-defined selector filters and sorting so a resource provider can apply them before pagination. Existing constructors remain compatible because the new arguments are optional.
Removed
- Removed schema-v2 through schema-v5 parsing and the earlier schema-v1 relationship and
filtersshape. Existing saved compositions must be recreated with the modern schema-1 shape after the coordinated environment reset; the SDK does not convert old payloads.
Added
- Added app-neutral contracts for contributing and publishing business-result notifications from durable events. The implementing Core host owns tenant scope, recipient access, preferences, idempotency and rendering.
- Added automatic-approval fact and outcome contracts. Apps provide current bound resource facts; the Core host controls policy authority and preserves decision evidence without synthesizing a human signature.
Upgrade required
Use Core 0.6.0 with these Laravel and React 0.6.0 artifacts. Earlier composition payloads are not converted automatically. Recreate affected saved compositions through the coordinated upgrade procedure; do not run a destructive reset implicitly. Review and update consumer compatibility constraints before adoption.