@astrale-os/adapter-cloudflare 0.5.0-beta.152 → 0.5.0-beta.154

package/README.md

@@ -53,3 +53,23 @@ This subpath is runtime-safe. `stagedWorkerName(providerDeployment)` addresses o
 candidate. The public Worker name and `/invoke` endpoint remain stable across compatible
 implementation and Schema updates. Provider staging identity never enters Release, Publication,
 Kernel routing, or graph identity.
+
+## Material for a custom Worker entrypoint
+
+Workers with provider-specific routes or environment initialization can reuse the adapter's
+material emission without adopting the entire generated entrypoint:
+
+```ts
+import { generateBuildMaterialModule } from '@astrale-os/adapter-cloudflare/build'
+import { writeFile } from 'node:fs/promises'
+
+// build is an admitted Build returned by compile(application).
+await writeFile('src/build-material.gen.ts', generateBuildMaterialModule(build))
+```
+
+The generated TypeScript module exports `loadBuildMaterial()`. Call it from the
+`load` callback of `generatedCloudflareWorkerEntry` alongside the application's Runtime.
+It constructs the same verified, deduplicated material as the adapter's generated Service;
+allocation is deferred until the factory is called and the SDK deep-freezes it before use.
+The generated file needs only a type import from the SDK. Keep its compiler and runtime SDK
+versions aligned, and regenerate it when either the Application or that SDK version changes.

package/dist/build/index.d.ts

@@ -1,3 +1,4 @@
+export { generateBuildMaterialModule } from './material.js';
 export { artifact, materialize, prepareWorkerArtifact } from './artifact.js';
 export { loadWorkerArtifact } from './worker/index.js';
 export type { WorkerArtifact } from './worker/index.js';

package/dist/build/index.js

@@ -1,3 +1,4 @@
+export { generateBuildMaterialModule } from './material.js';
 export { artifact, materialize, prepareWorkerArtifact } from './artifact.js';
 export { loadWorkerArtifact } from './worker/index.js';
 export { resolveRouter, workerName } from './configuration.js';

package/dist/build/material.d.ts

@@ -0,0 +1,10 @@
+import type { Build } from '@astrale-os/sdk/deployment/build';
+/**
+ * Generate a TypeScript module exporting `loadBuildMaterial()` for a custom Worker entrypoint.
+ *
+ * The module uses the same verified shared literal as the adapter's generated Service. Its
+ * factory allocates the material on demand; `generatedCloudflareWorkerEntry` seals it before use.
+ * Write the source at build time and import its factory from the Worker. No authoring or
+ * compression dependency is needed by the generated module at runtime.
+ */
+export declare function generateBuildMaterialModule(build: Build): string;

package/dist/build/material.js

@@ -0,0 +1,25 @@
+import { generatedMaterial } from '@astrale-os/sdk/deployment/build';
+import { sharedLiteral, verifySharedLiteral } from './worker/codegen/literal.js';
+/**
+ * Generate a TypeScript module exporting `loadBuildMaterial()` for a custom Worker entrypoint.
+ *
+ * The module uses the same verified shared literal as the adapter's generated Service. Its
+ * factory allocates the material on demand; `generatedCloudflareWorkerEntry` seals it before use.
+ * Write the source at build time and import its factory from the Worker. No authoring or
+ * compression dependency is needed by the generated module at runtime.
+ */
+export function generateBuildMaterialModule(build) {
+    const generated = generatedMaterial(build);
+    const literal = sharedLiteral(generated);
+    verifySharedLiteral(literal, generated);
+    // An empty shared array otherwise has an implicit any[] type in strict TypeScript consumers.
+    const declarations = literal.declarations.map((line) => `  ${line.replace(/ = \[\]$/, ': readonly [] = []')}`);
+    return `// AUTO-GENERATED by @astrale-os/adapter-cloudflare — do not edit.
+import type { GeneratedBuildMaterial } from '@astrale-os/sdk/deployment/build'
+
+export function loadBuildMaterial(): GeneratedBuildMaterial {
+${declarations.join('\n')}
+  return ${literal.expression} as unknown as GeneratedBuildMaterial
+}
+`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/adapter-cloudflare",
-  "version": "0.5.0-beta.152",
+  "version": "0.5.0-beta.154",
   "description": "Deploy an Astrale application through Cloudflare Workers",
   "keywords": [
     "adapter",
@@ -53,7 +53,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@astrale-os/sdk": "0.5.0-beta.149",
+    "@astrale-os/sdk": "0.5.0-beta.151",
     "@noble/hashes": "2.3.0",
     "hono": "^4.6.20",
     "jose": "^6.1.3",