@astrale-domains/services 0.5.1 → 0.7.0

package/dist/schema/modules/deployment/types/worker-configuration.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/**
+ * The `WorkerConfigurationV1` (`@astrale-os/sdk/deployment/worker`) one deployment freezes beside
+ * its build: the Workers runtime it runs on, its plain variables, the names of its secrets (never
+ * their values) and what it asks of its host: the record it publishes, a signing identity of its
+ * own, the router. Its digest and the build digest make the deployment's label. This shape only
+ * bounds what a request and the graph carry; the SDK's `acceptWorkerConfiguration` admits its
+ * exact canonical form.
+ */
+export declare const workerConfiguration: z.ZodObject<{
+    format: z.ZodLiteral<"astrale.worker.configuration">;
+    version: z.ZodLiteral<1>;
+    compatibilityDate: z.ZodString;
+    compatibilityFlags: z.ZodArray<z.ZodString>;
+    vars: z.ZodRecord<z.ZodString, z.ZodString>;
+    secrets: z.ZodArray<z.ZodString>;
+    record: z.ZodBoolean;
+    signingIdentity: z.ZodBoolean;
+    router: z.ZodBoolean;
+}, z.core.$strict>;
+export type WorkerConfiguration = z.output<typeof workerConfiguration>;

package/dist/schema/modules/deployment/types/worker-configuration.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+const name = z.string().min(1).max(128);
+/**
+ * The `WorkerConfigurationV1` (`@astrale-os/sdk/deployment/worker`) one deployment freezes beside
+ * its build: the Workers runtime it runs on, its plain variables, the names of its secrets (never
+ * their values) and what it asks of its host: the record it publishes, a signing identity of its
+ * own, the router. Its digest and the build digest make the deployment's label. This shape only
+ * bounds what a request and the graph carry; the SDK's `acceptWorkerConfiguration` admits its
+ * exact canonical form.
+ */
+export const workerConfiguration = z.strictObject({
+    format: z.literal('astrale.worker.configuration'),
+    version: z.literal(1),
+    compatibilityDate: z.string().min(10).max(10),
+    compatibilityFlags: z.array(name).max(64),
+    vars: z.record(name, z.string().max(64 * 1024)),
+    secrets: z.array(name).max(64),
+    record: z.boolean(),
+    signingIdentity: z.boolean(),
+    router: z.boolean(),
+});

package/dist/schema/modules/deployment/types/worker-record.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/**
+ * The record one deployment publishes (`WorkerRecordWireV1`): opaque bytes, as canonical Base64,
+ * and the media type the dispatcher serves them with at `/.well-known/astrale/deployment.json`.
+ * Services never reads it: it is the deployer's, and a deployment keeps the record it was created
+ * with. The SDK's `decodeWorkerRecord` admits it exactly.
+ */
+export declare const workerRecord: z.ZodObject<{
+    contentType: z.ZodString;
+    contentBase64: z.ZodString;
+}, z.core.$strict>;
+export type WorkerRecordWire = z.output<typeof workerRecord>;

package/dist/schema/modules/deployment/types/worker-record.js

@@ -0,0 +1,15 @@
+import { WORKER_DEPLOYMENT_LIMITS } from '@astrale-os/sdk/deployment/worker';
+import { z } from 'zod';
+/**
+ * The record one deployment publishes (`WorkerRecordWireV1`): opaque bytes, as canonical Base64,
+ * and the media type the dispatcher serves them with at `/.well-known/astrale/deployment.json`.
+ * Services never reads it: it is the deployer's, and a deployment keeps the record it was created
+ * with. The SDK's `decodeWorkerRecord` admits it exactly.
+ */
+export const workerRecord = z.strictObject({
+    contentType: z.string().min(3).max(256),
+    contentBase64: z
+        .string()
+        .min(4)
+        .max(Math.ceil(WORKER_DEPLOYMENT_LIMITS.recordSize / 3) * 4),
+});

package/dist/schema/modules/service/classes/cloudflare-service.d.ts

@@ -1,4 +1,7 @@
-/** One Service whose deployments are Workers for Platforms scripts. */
+/**
+ * One Service whose deployments are Cloudflare Workers for Platforms scripts: any Cloudflare
+ * Worker, an Astrale Domain release or a generic Worker (an API, a cron job) alike.
+ */
 export declare const CloudflareService: import("@astrale-os/sdk/schema").AuthoredNodeClass<{
     readonly description: "One Service whose deployments are Cloudflare Workers for Platforms scripts.";
     readonly icon: import("@astrale-os/sdk/schema").ClassIcon;
@@ -8,7 +11,7 @@ export declare const CloudflareService: import("@astrale-os/sdk/schema").Authore
         readonly icon: import("@astrale-os/sdk/schema").ClassIcon;
         readonly extends: readonly [import("@astrale-os/sdk/schema").KernelClass<"Named">, import("@astrale-os/sdk/schema").KernelClass<"Timestamped">];
         readonly properties: {
-            origin: import("zod").ZodString;
+            project: import("zod").ZodString;
             environment: import("zod").ZodString;
             fingerprint: import("zod").ZodString;
             url: import("zod").ZodString;
@@ -25,73 +28,30 @@ export declare const CloudflareService: import("@astrale-os/sdk/schema").Authore
     }>];
     readonly methods: {
         deploy: import("@astrale-os/sdk/schema").Method<import("@astrale-os/sdk/schema").CallableProjection<{
-            format: "astrale.services.deployment-request";
+            format: "astrale.worker.deployment-request";
             version: 1;
             owner?: string | undefined;
-            origin: string;
+            project: string;
             environment: string;
-            addressing: "opaque";
             label: string;
             buildDigest: string;
             configuration: {
-                format: "astrale.deployment.configuration";
+                format: "astrale.worker.configuration";
                 version: 1;
+                compatibilityDate: string;
+                compatibilityFlags: string[];
                 vars: Record<string, string>;
-                settings: {
-                    maximumRequestBytes: number;
-                    invocationTimeoutMs: number;
-                    tokenExchange: false | {
-                        maximumLifetimeSeconds: number;
-                    };
-                    durableOptions?: {
-                        retentionMs?: number | undefined;
-                        retry?: {
-                            initialIntervalMs?: number | undefined;
-                            maxAttempts?: number | undefined;
-                            maxIntervalMs?: number | undefined;
-                        } | undefined;
-                        stepTimeoutMs?: number | undefined;
-                    } | undefined;
-                };
-                runtime: {
-                    compatibilityDate: string;
-                    compatibilityFlags: string[];
-                };
-                bindings: {
-                    services: {
-                        name: string;
-                        service: string;
-                    }[];
-                    dispatchNamespaces: {
-                        name: string;
-                        namespace: string;
-                    }[];
-                    secrets: string[];
-                };
-                router: false | {
-                    service: string;
-                    hostSuffix: string;
-                    minLabels: number;
-                };
+                secrets: string[];
+                record: boolean;
+                signingIdentity: boolean;
+                router: boolean;
             };
-            record: {
-                releaseDigest: string;
-                schemaRevision: string;
-                schemaBundle: string;
-                commit: {
-                    sha: string;
-                    dirty: boolean;
-                    base?: {
-                        version: string;
-                        distance: number;
-                    } | undefined;
-                } | null;
-            };
-            bundle: {
-                entrypoint: string;
+            worker: {
+                manifest: Record<string, unknown>;
+                mainModule: string;
                 modules: {
                     name: string;
-                    kind?: "data" | "esm" | "text" | "wasm" | undefined;
+                    kind: "data" | "esm" | "text" | "wasm";
                     content: {
                         encoding: "gzip" | "identity";
                         decodedSize: number;
@@ -103,29 +63,26 @@ export declare const CloudflareService: import("@astrale-os/sdk/schema").Authore
                     };
                 }[];
                 assets?: {
-                    files: {
-                        path: string;
-                        contentType?: string | undefined;
-                        content: {
-                            encoding: "gzip" | "identity";
-                            decodedSize: number;
-                            contentBase64: string;
-                        } | {
-                            encoding: "gzip" | "identity";
-                            decodedSize: number;
-                            contentBase64Chunks: string[];
-                        };
-                    }[];
-                    notFound?: "404-page" | "none" | "single-page-application" | undefined;
-                    runWorkerFirst?: boolean | undefined;
-                    htmlHandling?: "none" | undefined;
-                } | undefined;
+                    path: string;
+                    contentType?: string | undefined;
+                    content: {
+                        encoding: "gzip" | "identity";
+                        decodedSize: number;
+                        contentBase64: string;
+                    } | {
+                        encoding: "gzip" | "identity";
+                        decodedSize: number;
+                        contentBase64Chunks: string[];
+                    };
+                }[] | undefined;
             };
+            record?: {
+                contentType: string;
+                contentBase64: string;
+            } | undefined;
+            readiness?: string[] | undefined;
             secrets: Record<string, string>;
             promote?: boolean | undefined;
-            readiness?: {
-                paths: string[];
-            } | undefined;
         }, {
             readonly mode: 'value';
             readonly value: {
@@ -145,31 +102,20 @@ export declare const CloudflareService: import("@astrale-os/sdk/schema").Authore
                     label: string;
                     serviceId: string;
                     service: string;
+                    project: string;
+                    environment: string;
                     owner: string;
                     state: "active" | "deploying" | "failed" | "retired" | "retiring";
                     current: boolean;
                     createdAt: string;
                     retiredAt?: string | undefined;
-                    signingKeyId: string;
-                    record: {
-                        format: "astrale.deployment-record";
-                        version: 1;
-                        origin: string;
-                        environment: string;
-                        releaseDigest: string;
-                        buildDigest: string;
-                        schemaRevision: string;
-                        configuration: string;
-                        providerScript: string;
-                        commit: {
-                            sha: string;
-                            dirty: boolean;
-                            base?: {
-                                version: string;
-                                distance: number;
-                            } | undefined;
-                        } | null;
-                    };
+                    buildDigest: string;
+                    configuration: string;
+                    signingKeyId?: string | undefined;
+                    record?: {
+                        contentType: string;
+                        contentBase64: string;
+                    } | undefined;
                 };
             };
         }, "authenticated", true, false, undefined>>;
@@ -177,60 +123,35 @@ export declare const CloudflareService: import("@astrale-os/sdk/schema").Authore
             readonly mode: 'value';
             readonly value: {
                 routingDomain: string;
-                addressing: "opaque";
             };
         }, "authenticated", true, false, undefined>>;
         list: import("@astrale-os/sdk/schema").Method<import("@astrale-os/sdk/schema").CallableProjection<{
-            origin?: string | undefined;
+            project?: string | undefined;
             environment?: string | undefined;
         }, {
             readonly mode: 'value';
             readonly value: {
-                deployments: ({
-                    id: string;
-                    url: string;
-                    label: string;
-                    serviceId: string;
-                    service: string;
-                    owner: string;
-                    state: "active" | "deploying" | "failed" | "retired" | "retiring";
-                    current: boolean;
-                    createdAt: string;
-                    retiredAt?: string | undefined;
-                    signingKeyId: string;
-                    record: {
-                        format: "astrale.deployment-record";
-                        version: 1;
-                        origin: string;
-                        environment: string;
-                        releaseDigest: string;
-                        buildDigest: string;
-                        schemaRevision: string;
-                        configuration: string;
-                        providerScript: string;
-                        commit: {
-                            sha: string;
-                            dirty: boolean;
-                            base?: {
-                                version: string;
-                                distance: number;
-                            } | undefined;
-                        } | null;
-                    };
-                } | {
+                deployments: {
                     id: string;
                     url: string;
                     label: string;
                     serviceId: string;
                     service: string;
+                    project: string;
+                    environment: string;
                     owner: string;
                     state: "active" | "deploying" | "failed" | "retired" | "retiring";
                     current: boolean;
                     createdAt: string;
                     retiredAt?: string | undefined;
-                    signingKeyId: string;
-                    record: unknown;
-                })[];
+                    buildDigest: string;
+                    configuration: string;
+                    signingKeyId?: string | undefined;
+                    record?: {
+                        contentType: string;
+                        contentBase64: string;
+                    } | undefined;
+                }[];
             };
         }, "authenticated", true, false, undefined>>;
         promote: import("@astrale-os/sdk/schema").Method<import("@astrale-os/sdk/schema").CallableProjection<{

package/dist/schema/modules/service/classes/cloudflare-service.js

@@ -13,7 +13,10 @@ import { setServiceSecret } from '../functions/set-service-secret.js';
 import { transferService } from '../functions/transfer-service.js';
 import { OwnService } from '../policies/own-service.js';
 import { Service } from './service.js';
-/** One Service whose deployments are Workers for Platforms scripts. */
+/**
+ * One Service whose deployments are Cloudflare Workers for Platforms scripts: any Cloudflare
+ * Worker, an Astrale Domain release or a generic Worker (an API, a cron job) alike.
+ */
 export const CloudflareService = nodeClass({
     description: 'One Service whose deployments are Cloudflare Workers for Platforms scripts.',
     icon: classIcon.lucide(CloudCog),

package/dist/schema/modules/service/classes/service.d.ts

@@ -1,10 +1,10 @@
 import { z } from 'zod';
 /**
- * One deployed Service: the stable identity of one origin in one environment, owned by one
- * Identity. Every deploy adds an immutable Deployment of it, and its URL serves the one it
- * currently points at. Its `name` derives from the origin and the environment: it is the DNS label
- * of the Service and the prefix of each deployment's label, unique among Services, and free again
- * once the Service is deleted.
+ * One Service: the stable identity of one project in one environment, owned by one Identity,
+ * whatever its Worker serves (an Astrale Domain release, an API, a cron job). Every deploy adds an
+ * immutable Deployment of it, and its URL serves the one it currently points at. Its `name` is the
+ * SDK's `serviceName(project, environment)`: the DNS label of the Service and the prefix of each
+ * deployment's label, unique among Services, and free again once the Service is deleted.
  */
 export declare const Service: import("@astrale-os/sdk/schema").AuthoredNodeClass<{
     readonly abstract: true;
@@ -12,9 +12,10 @@ export declare const Service: import("@astrale-os/sdk/schema").AuthoredNodeClass
     readonly icon: import("@astrale-os/sdk/schema").ClassIcon;
     readonly extends: readonly [import("@astrale-os/sdk/schema").KernelClass<"Named">, import("@astrale-os/sdk/schema").KernelClass<"Timestamped">];
     readonly properties: {
-        origin: z.ZodString;
+        /** Any project name; a Domain deployer names its Domain's origin. */
+        project: z.ZodString;
         environment: z.ZodString;
-        /** The 16-character fingerprint of `(origin, environment)`; it alone identifies the Service. */
+        /** `serviceName(project, environment)`, 16 characters; it alone identifies the Service. */
         fingerprint: z.ZodString;
         /** `https://<name>.<routing domain>`: always serves the current deployment. */
         url: z.ZodString;

package/dist/schema/modules/service/classes/service.js

@@ -3,11 +3,11 @@ import { Server } from '@astrale-os/sdk/schema/icons';
 import { z } from 'zod';
 import { serviceLifecycle } from '../states/index.js';
 /**
- * One deployed Service: the stable identity of one origin in one environment, owned by one
- * Identity. Every deploy adds an immutable Deployment of it, and its URL serves the one it
- * currently points at. Its `name` derives from the origin and the environment: it is the DNS label
- * of the Service and the prefix of each deployment's label, unique among Services, and free again
- * once the Service is deleted.
+ * One Service: the stable identity of one project in one environment, owned by one Identity,
+ * whatever its Worker serves (an Astrale Domain release, an API, a cron job). Every deploy adds an
+ * immutable Deployment of it, and its URL serves the one it currently points at. Its `name` is the
+ * SDK's `serviceName(project, environment)`: the DNS label of the Service and the prefix of each
+ * deployment's label, unique among Services, and free again once the Service is deleted.
  */
 export const Service = nodeClass({
     abstract: true,
@@ -15,9 +15,10 @@ export const Service = nodeClass({
     icon: classIcon.lucide(Server),
     extends: [K.classes.Named, K.classes.Timestamped],
     properties: {
-        origin: z.string().min(1).max(253),
+        /** Any project name; a Domain deployer names its Domain's origin. */
+        project: z.string().min(1).max(253),
         environment: z.string().min(1).max(63),
-        /** The 16-character fingerprint of `(origin, environment)`; it alone identifies the Service. */
+        /** `serviceName(project, environment)`, 16 characters; it alone identifies the Service. */
         fingerprint: z.string().check(fullMatch('[a-z2-7]{16}')),
         /** `https://<name>.<routing domain>`: always serves the current deployment. */
         url: z.string().min(1).max(2_048),

package/dist/schema/modules/service/functions/deploy-service.d.ts

@@ -1,77 +1,35 @@
 /**
- * Host one release as an immutable deployment of the Service of its origin and environment,
- * creating that Service on its first deploy, and by default make it the one the Service serves.
- * Any authenticated identity may ask; the handler proves that the caller owns the Service, or for
- * a new one that it is or acts as the owner it names, before any write.
+ * Host one Cloudflare Worker release (`WorkerDeploymentRequestV1`) as an immutable deployment of
+ * the Service of its project and environment, creating that Service on its first deploy, and by
+ * default make it the one the Service serves. Any authenticated identity may ask; the handler
+ * proves that the caller owns the Service, or for a new one that it is or acts as the owner it
+ * names, before any write.
  */
 export declare const deployService: import("@astrale-os/sdk/schema").Method<import("@astrale-os/sdk/schema").CallableProjection<{
-    format: "astrale.services.deployment-request";
+    format: "astrale.worker.deployment-request";
     version: 1;
     owner?: string | undefined;
-    origin: string;
+    project: string;
     environment: string;
-    addressing: "opaque";
     label: string;
     buildDigest: string;
     configuration: {
-        format: "astrale.deployment.configuration";
+        format: "astrale.worker.configuration";
         version: 1;
+        compatibilityDate: string;
+        compatibilityFlags: string[];
         vars: Record<string, string>;
-        settings: {
-            maximumRequestBytes: number;
-            invocationTimeoutMs: number;
-            tokenExchange: false | {
-                maximumLifetimeSeconds: number;
-            };
-            durableOptions?: {
-                retentionMs?: number | undefined;
-                retry?: {
-                    initialIntervalMs?: number | undefined;
-                    maxAttempts?: number | undefined;
-                    maxIntervalMs?: number | undefined;
-                } | undefined;
-                stepTimeoutMs?: number | undefined;
-            } | undefined;
-        };
-        runtime: {
-            compatibilityDate: string;
-            compatibilityFlags: string[];
-        };
-        bindings: {
-            services: {
-                name: string;
-                service: string;
-            }[];
-            dispatchNamespaces: {
-                name: string;
-                namespace: string;
-            }[];
-            secrets: string[];
-        };
-        router: false | {
-            service: string;
-            hostSuffix: string;
-            minLabels: number;
-        };
-    };
-    record: {
-        releaseDigest: string;
-        schemaRevision: string;
-        schemaBundle: string;
-        commit: {
-            sha: string;
-            dirty: boolean;
-            base?: {
-                version: string;
-                distance: number;
-            } | undefined;
-        } | null;
+        secrets: string[];
+        record: boolean;
+        signingIdentity: boolean;
+        router: boolean;
     };
-    bundle: {
-        entrypoint: string;
+    worker: {
+        manifest: Record<string, unknown>;
+        mainModule: string;
         modules: {
             name: string;
-            kind?: "data" | "esm" | "text" | "wasm" | undefined;
+            kind: "data" | "esm" | "text" | "wasm";
             content: {
                 encoding: "gzip" | "identity";
                 decodedSize: number;
@@ -83,29 +41,26 @@ export declare const deployService: import("@astrale-os/sdk/schema").Method<impo
             };
         }[];
         assets?: {
-            files: {
-                path: string;
-                contentType?: string | undefined;
-                content: {
-                    encoding: "gzip" | "identity";
-                    decodedSize: number;
-                    contentBase64: string;
-                } | {
-                    encoding: "gzip" | "identity";
-                    decodedSize: number;
-                    contentBase64Chunks: string[];
-                };
-            }[];
-            notFound?: "404-page" | "none" | "single-page-application" | undefined;
-            runWorkerFirst?: boolean | undefined;
-            htmlHandling?: "none" | undefined;
-        } | undefined;
+            path: string;
+            contentType?: string | undefined;
+            content: {
+                encoding: "gzip" | "identity";
+                decodedSize: number;
+                contentBase64: string;
+            } | {
+                encoding: "gzip" | "identity";
+                decodedSize: number;
+                contentBase64Chunks: string[];
+            };
+        }[] | undefined;
     };
+    record?: {
+        contentType: string;
+        contentBase64: string;
+    } | undefined;
+    readiness?: string[] | undefined;
     secrets: Record<string, string>;
     promote?: boolean | undefined;
-    readiness?: {
-        paths: string[];
-    } | undefined;
 }, {
     readonly mode: 'value';
     readonly value: {
@@ -125,31 +80,20 @@ export declare const deployService: import("@astrale-os/sdk/schema").Method<impo
             label: string;
             serviceId: string;
             service: string;
+            project: string;
+            environment: string;
             owner: string;
             state: "active" | "deploying" | "failed" | "retired" | "retiring";
             current: boolean;
             createdAt: string;
             retiredAt?: string | undefined;
-            signingKeyId: string;
-            record: {
-                format: "astrale.deployment-record";
-                version: 1;
-                origin: string;
-                environment: string;
-                releaseDigest: string;
-                buildDigest: string;
-                schemaRevision: string;
-                configuration: string;
-                providerScript: string;
-                commit: {
-                    sha: string;
-                    dirty: boolean;
-                    base?: {
-                        version: string;
-                        distance: number;
-                    } | undefined;
-                } | null;
-            };
+            buildDigest: string;
+            configuration: string;
+            signingKeyId?: string | undefined;
+            record?: {
+                contentType: string;
+                contentBase64: string;
+            } | undefined;
         };
     };
 }, "authenticated", true, false, undefined>>;

package/dist/schema/modules/service/functions/deploy-service.js

@@ -1,13 +1,14 @@
 import { method } from '@astrale-os/sdk/schema';
 import { deploymentRequest, deploymentResponse } from '../../deployment/index.js';
 /**
- * Host one release as an immutable deployment of the Service of its origin and environment,
- * creating that Service on its first deploy, and by default make it the one the Service serves.
- * Any authenticated identity may ask; the handler proves that the caller owns the Service, or for
- * a new one that it is or acts as the owner it names, before any write.
+ * Host one Cloudflare Worker release (`WorkerDeploymentRequestV1`) as an immutable deployment of
+ * the Service of its project and environment, creating that Service on its first deploy, and by
+ * default make it the one the Service serves. Any authenticated identity may ask; the handler
+ * proves that the caller owns the Service, or for a new one that it is or acts as the owner it
+ * names, before any write.
  */
 export const deployService = method({
-    description: 'Host one release as an immutable deployment of its Service.',
+    description: 'Host one Worker release as an immutable deployment of its Service.',
     auth: 'authenticated',
     static: true,
     input: deploymentRequest,

package/dist/schema/modules/service/functions/describe-hosting.d.ts

@@ -3,6 +3,5 @@ export declare const describeHosting: import("@astrale-os/sdk/schema").Method<im
     readonly mode: 'value';
     readonly value: {
         routingDomain: string;
-        addressing: "opaque";
     };
 }, "authenticated", true, false, undefined>>;