@astrale-os/sdk 0.5.0-beta.50 → 0.5.0-beta.51

package/dist/deployment/build/index.d.ts

@@ -1,6 +1,6 @@
 export { isBuild } from './admission.js';
 export { compile } from './compile.js';
-export { material, restoreBuild, type BuildMaterial } from './material.js';
+export { material, generatedMaterial, restoreBuild, restoreGeneratedBuild, type BuildMaterial, type GeneratedBuildMaterial, } from './material.js';
 export type { Build } from './build.js';
 export * as frontend from './frontend/index.js';
 export type { BuildBundle, BuildSchema } from './schema.js';

package/dist/deployment/build/index.js

@@ -1,4 +1,4 @@
 export { isBuild } from './admission.js';
 export { compile } from './compile.js';
-export { material, restoreBuild } from './material.js';
+export { material, generatedMaterial, restoreBuild, restoreGeneratedBuild, } from './material.js';
 export * as frontend from './frontend/index.js';

package/dist/deployment/build/material.d.ts

@@ -17,7 +17,26 @@ export interface BuildMaterial {
     readonly routes: Build['routes'];
     readonly frontend?: FrontendCompilation;
 }
+declare const GENERATED_BUILD_MATERIAL: unique symbol;
+/** Exact Build material embedded by an Astrale execution-code generator. */
+export interface GeneratedBuildMaterial {
+    readonly format: 'astrale.sdk.generated-build-material';
+    readonly version: 1;
+    readonly material: BuildMaterial;
+    readonly digest: Build['schema']['bundle']['ref']['digest'];
+    readonly [GENERATED_BUILD_MATERIAL]: 'generated-build-material';
+}
 /** Detach the provider-neutral, runtime-free material embedded into generated execution code. */
 export declare function material(build: Build): BuildMaterial;
+/** Produce opaque material for execution code from one admitted Build. */
+export declare function generatedMaterial(build: Build): GeneratedBuildMaterial;
 /** Re-admit generated Build material and bind it to the exact imported Runtime value. */
 export declare function restoreBuild<RuntimeValue extends Runtime>(input: BuildMaterial, runtime: RuntimeValue): Build<DomainSchema, RuntimeValue>;
+/**
+ * Bind material embedded by generated release code without repeating its external admission.
+ * Build generators must call {@link generatedMaterial} before embedding the exact envelope;
+ * decoded files, network values, and caller-provided JSON must continue through
+ * {@link restoreBuild}.
+ */
+export declare function restoreGeneratedBuild<RuntimeValue extends Runtime>(input: GeneratedBuildMaterial, runtime: RuntimeValue): Build<DomainSchema, RuntimeValue>;
+export {};

package/dist/deployment/build/material.js

@@ -1,4 +1,5 @@
 import * as bundle from '@astrale-os/kernel-dsl/v1/bundle/transport';
+import { load as loadGeneratedSchema } from '@astrale-os/kernel-dsl/v1/compiled/generated';
 import { load as loadCompiledSchema } from '@astrale-os/kernel-dsl/v1/compiled/loader';
 import { revision } from '@astrale-os/kernel-dsl/v1/schema/revision';
 import { equal } from '@astrale-os/kernel-dsl/value';
@@ -28,24 +29,19 @@ export function material(build) {
         ...(build.frontend === undefined ? {} : { frontend: build.frontend }),
     });
 }
+/** Produce opaque material for execution code from one admitted Build. */
+export function generatedMaterial(build) {
+    const value = deepFreeze(material(build));
+    return Object.freeze({
+        format: 'astrale.sdk.generated-build-material',
+        version: 1,
+        material: value,
+        digest: digestOf(value),
+    });
+}
 /** Re-admit generated Build material and bind it to the exact imported Runtime value. */
 export function restoreBuild(input, runtime) {
-    if (!isRuntime(runtime))
-        throw new TypeError('Generated Runtime is not admitted.');
-    if (input === null ||
-        typeof input !== 'object' ||
-        Array.isArray(input) ||
-        input.format !== 'astrale.sdk.build-material' ||
-        input.version !== 1 ||
-        Reflect.ownKeys(input).some((key) => key !== 'format' &&
-            key !== 'version' &&
-            key !== 'schema' &&
-            key !== 'callables' &&
-            key !== 'requirements' &&
-            key !== 'routes' &&
-            key !== 'frontend')) {
-        invalid();
-    }
+    assertMaterialEnvelope(input, runtime);
     const domain = loadCompiledSchema(input.schema.compiled);
     const bytes = Uint8Array.from(input.schema.bundle.bytes);
     const decoded = bundle.decode(bytes);
@@ -57,12 +53,7 @@ export function restoreBuild(input, runtime) {
         revision(decoded.root) !== input.schema.compiled.root.revision) {
         invalid();
     }
-    const registry = admitRuntimeRegistry(domain, runtime);
-    const callables = registry.implementations.map(({ callable }) => callable.key).sort();
-    if (callables.length !== input.callables.length ||
-        callables.some((key, index) => key !== input.callables[index])) {
-        throw new TypeError('Generated Runtime differs from Build material.');
-    }
+    const registry = bindRuntime(domain, runtime, input.callables);
     const requirements = admitRequirements(input.requirements);
     validateRequirements(decoded.root, decoded.closure, requirements);
     const plan = admitRoutePlan(input.routes, domain);
@@ -87,6 +78,82 @@ export function restoreBuild(input, runtime) {
     });
     return admitBuild(build, { domain, registry });
 }
+/**
+ * Bind material embedded by generated release code without repeating its external admission.
+ * Build generators must call {@link generatedMaterial} before embedding the exact envelope;
+ * decoded files, network values, and caller-provided JSON must continue through
+ * {@link restoreBuild}.
+ */
+export function restoreGeneratedBuild(input, runtime) {
+    const generated = acceptGeneratedMaterial(input, runtime);
+    const domain = loadGeneratedSchema(generated.schema.compiled);
+    const registry = bindRuntime(domain, runtime, generated.callables);
+    const detached = Uint8Array.from(generated.schema.bundle.bytes);
+    const build = Object.freeze({
+        kind: 'build',
+        schema: Object.freeze({
+            compiled: generated.schema.compiled,
+            bundle: Object.freeze({
+                ref: generated.schema.bundle.ref,
+                bytes: () => new Uint8Array(detached),
+            }),
+        }),
+        runtime,
+        callables: Object.freeze([...generated.callables]),
+        requirements: generated.requirements,
+        routes: generated.routes,
+        ...(generated.frontend === undefined ? {} : { frontend: generated.frontend }),
+    });
+    return admitBuild(build, { domain, registry });
+}
+function acceptGeneratedMaterial(input, runtime) {
+    if (input === null ||
+        typeof input !== 'object' ||
+        Array.isArray(input) ||
+        input.format !== 'astrale.sdk.generated-build-material' ||
+        input.version !== 1 ||
+        Reflect.ownKeys(input).some((key) => key !== 'format' && key !== 'version' && key !== 'material' && key !== 'digest') ||
+        digestOf(input.material) !== input.digest) {
+        invalid();
+    }
+    assertMaterialEnvelope(input.material, runtime);
+    return deepFreeze(input).material;
+}
+function digestOf(input) {
+    try {
+        return artifact.identify(new TextEncoder().encode(JSON.stringify(input)), 'application/vnd.astrale.sdk.build-material+json').digest;
+    }
+    catch {
+        invalid();
+    }
+}
+function assertMaterialEnvelope(input, runtime) {
+    if (!isRuntime(runtime))
+        throw new TypeError('Generated Runtime is not admitted.');
+    if (input === null ||
+        typeof input !== 'object' ||
+        Array.isArray(input) ||
+        input.format !== 'astrale.sdk.build-material' ||
+        input.version !== 1 ||
+        Reflect.ownKeys(input).some((key) => key !== 'format' &&
+            key !== 'version' &&
+            key !== 'schema' &&
+            key !== 'callables' &&
+            key !== 'requirements' &&
+            key !== 'routes' &&
+            key !== 'frontend')) {
+        invalid();
+    }
+}
+function bindRuntime(domain, runtime, expected) {
+    const registry = admitRuntimeRegistry(domain, runtime);
+    const callables = registry.implementations.map(({ callable }) => callable.key).sort();
+    if (callables.length !== expected.length ||
+        callables.some((key, index) => key !== expected[index])) {
+        throw new TypeError('Generated Runtime differs from Build material.');
+    }
+    return registry;
+}
 function admitRoutePlan(input, domain) {
     if (input.origin !== domain.origin ||
         input.revision !== domain.revision ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/sdk",
-  "version": "0.5.0-beta.50",
+  "version": "0.5.0-beta.51",
   "description": "Schema-first SDK for defining, composing, and deploying Astrale domains",
   "keywords": [
     "astrale",
@@ -210,11 +210,11 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@astrale-os/kernel-client": "0.6.0-beta.19",
-    "@astrale-os/kernel-core": "0.9.0-beta.15",
-    "@astrale-os/kernel-dsl": "0.2.0-beta.12",
-    "@astrale-os/kernel-protocol": "0.5.0-beta.15",
-    "@astrale-os/kernel-server": "0.5.0-beta.16",
+    "@astrale-os/kernel-client": "0.6.0-beta.20",
+    "@astrale-os/kernel-core": "0.9.0-beta.16",
+    "@astrale-os/kernel-dsl": "0.2.0-beta.13",
+    "@astrale-os/kernel-protocol": "0.5.0-beta.16",
+    "@astrale-os/kernel-server": "0.5.0-beta.17",
     "@typescript/native-preview": "7.0.0-dev.20260707.2",
     "hono": "^4.13.2",
     "jose": "^6.2.9",