@astrale-os/adapter-astrale 0.4.0 → 0.5.0-beta.1

package/README.md

@@ -0,0 +1,11 @@
+# `@astrale-os/adapter-astrale`
+
+Managed Astrale platform deployment adapter for Astrale Domains.
+
+During the SDK beta program, install the beta cohort explicitly:
+
+```bash
+npm install @astrale-os/sdk@beta @astrale-os/adapter-astrale@beta
+```
+
+Bare installs return to stable releases when the cohort is promoted and npm `latest` advances.

package/dist/astrale.d.ts

@@ -3,15 +3,15 @@
  *
  * Ships the domain THROUGH the target instance's `services` domain instead of to
  * the author's own cloud account. `deploy` builds the same single-module workerd
- * bundle the Cloudflare adapter ships (shared codegen + `wrangler deploy
- * --dry-run`), then:
+ * bundle and frontend artifact the Cloudflare adapter ships (shared codegen +
+ * `wrangler deploy --dry-run`), then:
  *
  *   1. hosts it on the instance's services domain — `CloudflareWorker.deploy
  *      { name, entry, modules, assets, vars }` → a public worker `url`;
  *   2. (optional) pushes runtime secrets via the service's `setSecret`;
  *   3. installs the domain on the instance from that `url`
  *      (`astrale domain install <url>` → the child kernel's `Domain.install`,
- *      which fetches + verifies the signed bundle and runs its `postInstall`).
+ *      which fetches, verifies, and reconciles the signed Publication).
  *
  * The admin control plane is NOT involved: hosting moved out of admin into the
  * per-instance `services` domain (a separate bounded context). No Cloudflare
@@ -24,9 +24,62 @@
  * `watch` is identical to the Cloudflare adapter's local dev (wrangler dev on
  * localhost) — managed deploys change WHERE the worker runs, not how you iterate.
  */
-import type { DomainAdapter } from '@astrale-os/sdk';
-import type { AstraleParams } from './params';
+import type { CompiledFrontendArtifact, DomainAdapter } from '@astrale-os/sdk';
+import { buildCloudflareWorker, buildFrontend, logTo, prepare, runWranglerBundle, runWranglerDev, runWranglerTypes, watchFrontend } from '@astrale-os/adapter-cloudflare/build';
+import { loadDeclaredSecrets } from '@astrale-os/sdk/cli';
+import type { AstraleParams } from './params.js';
+import { ensureServicesDomainInstalled, waitForManagedServiceReady } from './managed-service.js';
 export declare function astrale(envs: Record<string, AstraleParams>): DomainAdapter<AstraleParams>;
+export interface AstraleAdapterDependencies {
+    readonly astraleBin: typeof astraleBin;
+    readonly astraleCall: typeof astraleCall;
+    readonly buildCloudflareWorker: typeof buildCloudflareWorker;
+    readonly buildFrontend: typeof buildFrontend;
+    readonly ensureServicesDomainInstalled: typeof ensureServicesDomainInstalled;
+    readonly loadDeclaredSecrets: typeof loadDeclaredSecrets;
+    readonly logTo: typeof logTo;
+    readonly prepare: typeof prepare;
+    readonly readBytes: (path: string) => Buffer;
+    readonly readText: (path: string) => string;
+    readonly runAstrale: typeof runAstrale;
+    readonly runWranglerBundle: typeof runWranglerBundle;
+    readonly runWranglerDev: typeof runWranglerDev;
+    readonly runWranglerTypes: typeof runWranglerTypes;
+    readonly watchFrontend: typeof watchFrontend;
+    readonly waitForManagedServiceReady: typeof waitForManagedServiceReady;
+}
+/** Exact orchestration seam used by adapter-level managed deployment qualification. */
+export declare function astraleWithDependencies(envs: Record<string, AstraleParams>, dependencies: AstraleAdapterDependencies): DomainAdapter<AstraleParams>;
+export interface ManagedDeploymentVersionInput {
+    readonly bundle: Uint8Array;
+    readonly frontend?: CompiledFrontendArtifact;
+    readonly compatibilityDate?: string;
+    readonly compatibilityFlags?: readonly string[];
+    readonly serviceBindings?: readonly {
+        readonly name: string;
+        readonly service: string;
+    }[];
+    readonly vars?: Readonly<Record<string, string>>;
+}
+/**
+ * Stable generation for the whole managed serving contract. The Worker bytes
+ * alone are insufficient: frontend files/routes, compatibility settings,
+ * bindings, and vars can all change without producing a different bundle.
+ */
+export declare function managedDeploymentVersion(input: ManagedDeploymentVersionInput): string;
+/** Preserve author vars while reserving the generation value owned by the adapter. */
+export declare function managedDeploymentVars(vars: Readonly<Record<string, string>> | undefined, deploymentVersion: string): Readonly<Record<string, string>>;
+type AssetFile = {
+    path: string;
+    contentBase64: string;
+    contentType?: string;
+};
+/** Convert the materialized frontend into the services provider's immutable
+ * asset envelope. External frontends deliberately retain routes but no local
+ * files, so the callable worker and browser host remain independently swappable. */
+export declare function managedFrontendAssets(frontend: CompiledFrontendArtifact | undefined): readonly AssetFile[];
+/** Semantic method address; independent of the installed domain's tree placement. */
+export declare function servicesDeployMethodFor(origin: string): string;
 /** Service name from the origin: first DNS label (e.g. `my-notes.example.dev` → `my-notes`). */
 export declare function serviceNameFor(origin: string): string;
 /** Per-instance-unique graph slug from the FULL origin (dots → dashes), e.g.
@@ -34,4 +87,21 @@ export declare function serviceNameFor(origin: string): string;
  * (serviceNameFor) can collide across domains (`app.foo.dev` / `app.bar.dev`),
  * so the service NODE is placed by this; the display name stays the short label. */
 export declare function serviceSlugFor(origin: string): string;
+/**
+ * Invoke the user's `astrale` CLI for one platform call (against the target
+ * INSTANCE) and parse its JSON output. The CLI owns identity (IdP session,
+ * audience scoping, delegation minting) — reimplementing that here would fork
+ * the trust path.
+ */
+declare function astraleCall(projectDir: string, params: AstraleParams, call: {
+    instance: string;
+    path: string;
+    data: unknown;
+    viaStdin?: boolean;
+}): Promise<unknown>;
+/** Spawn the astrale CLI, feed optional stdin, and return stdout. Throws with bounded diagnostics. */
+declare function runAstrale(bin: string, cwd: string, args: string[], stdin?: string): Promise<string>;
+/** The user's astrale CLI: ~/.astrale/bin/astrale when present, else PATH. */
+declare function astraleBin(_projectDir: string): string;
+export {};
 //# sourceMappingURL=astrale.d.ts.map

package/dist/astrale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"astrale.d.ts","sourceRoot":"","sources":["../src/astrale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAa,aAAa,EAAY,MAAM,iBAAiB,CAAA;AAoBzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAW7C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,aAAa,CAAC,aAAa,CAAC,CAuOzF;AAkGD,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;oFAGoF;AACpF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKrD"}
+{"version":3,"file":"astrale.d.ts","sourceRoot":"","sources":["../src/astrale.ts"],"names":[],"mappings":"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"}