@moku-labs/worker 0.6.0 → 0.7.0

package/dist/cli.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cli = require("./cli-Dc0q0hIy.cjs");
+const require_cli = require("./cli-C8DdTtzn.cjs");
 exports.cliPlugin = require_cli.cliPlugin;
 exports.deployPlugin = require_cli.deployPlugin;

package/dist/cli.d.cts

@@ -1,2 +1,2 @@
-import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-VZ99IAMv.cjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BKOUpKtC.cjs";
 export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };

package/dist/cli.d.mts

@@ -1,2 +1,2 @@
-import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-VZ99IAMv.mjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BKOUpKtC.mjs";
 export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };

package/dist/cli.mjs

@@ -1,2 +1,2 @@
-import { n as deployPlugin, t as cliPlugin } from "./cli-DgZv5A0G.mjs";
+import { n as deployPlugin, t as cliPlugin } from "./cli-Bb37rYq_.mjs";
 export { cliPlugin, deployPlugin };

package/dist/{index-VZ99IAMv.d.cts → index-BKOUpKtC.d.cts}

@@ -109,6 +109,32 @@ type Config$1 = {
    * Also the file parsed in the universal/non-moku path.
    */
   configFile: string;
+  /**
+   * The Worker entry module → wrangler `main` (e.g. "src/cloudflare/worker.ts"). Required for any
+   * real Worker deploy (its absence is wrangler's "Missing entry-point" error).
+   */
+  entry?: string;
+  /**
+   * Enable Node.js compat → `compatibility_flags: ["nodejs_compat"]`. Needed when the Worker bundle
+   * pulls in Node-flavored code (e.g. composing the deploy/cli tooling into the runtime app).
+   */
+  nodeCompat?: boolean;
+  /**
+   * Static assets served via `env.<binding>` → the wrangler `assets` block. `spa: true` sets
+   * `not_found_handling: "single-page-application"` so client-routed deep links resolve to index.html.
+   */
+  assets?: {
+    binding: string;
+    directory: string;
+    spa?: boolean;
+  };
+  /**
+   * Escape hatch — extra top-level wrangler keys merged into the generated config for anything the
+   * typed fields above don't cover (`vars`, `routes`, `observability`, `triggers`, …). The
+   * deploy-managed resource keys (name, compatibility_date, kv_namespaces, r2_buckets, d1_databases,
+   * queues, durable_objects, and the auto-derived Durable Object `migrations`) always win over these.
+   */
+  wrangler?: Record<string, unknown>;
   /**
    * Standing CI/automated default for `run()`. When true (or when stdout is non-TTY) the deploy
    * never prompts and auto-confirms every gate; `run({ ci })` overrides it per call. CF credentials
@@ -127,24 +153,35 @@ type Config$1 = {
   migrateLocal: boolean; /** Debounce window (ms) coalescing rapid file changes into one rebuild. */
   debounceMs: number;
 };
-/** Discriminated union of resource descriptors returned by each plugin's deployManifest(). */
+/**
+ * Discriminated union of per-INSTANCE resource descriptors. Each resource plugin's `deployManifest()`
+ * returns an ARRAY of these (one per configured instance). `name` is the base Cloudflare resource
+ * name (stage-suffixed downstream via {@link stageName}); `binding` is the stable env var. Durable
+ * Objects carry no provisioned `name` — they ship with the Worker script — and declare the exported
+ * `className` instead.
+ */
 type ResourceManifest = {
   kind: "r2";
-  bucket: string;
+  name: string;
+  binding: string;
   upload?: string;
 } | {
   kind: "kv";
+  name: string;
   binding: string;
 } | {
   kind: "d1";
+  name: string;
   binding: string;
   migrations?: string;
 } | {
   kind: "queue";
-  producers: string[];
+  name: string;
+  binding: string;
 } | {
   kind: "do";
-  bindings: Record<string, string>;
+  binding: string;
+  className: string;
 };
 /**
  * The whole deploy manifest the pipeline consumes (assembled, or caller-supplied for the
@@ -174,12 +211,23 @@ type InfraPlan = {
   missing: ResourceManifest[];
 };
 /**
- * Outcome of acting on an {@link InfraPlan}: the resources just created, those skipped because
- * they already existed, and the merged id map (binding → Cloudflare id) for the config writer.
+ * A resource that failed to provision, with the (branded) error message captured so the guided flow
+ * can show WHICH resource failed and why — instead of aborting the whole run on the first failure.
+ */
+type ProvisionFailure = {
+  /** The resource descriptor that failed to create. */resource: ResourceManifest; /** The captured error message (e.g. the branded wrangler failure). */
+  error: string;
+};
+/**
+ * Outcome of acting on an {@link InfraPlan}: the resources just created, those skipped because they
+ * already existed, those that FAILED to create, and the merged id map (binding → Cloudflare id) for
+ * the config writer. Provisioning is resilient — a single resource failure is captured here, not
+ * thrown, so the guided flow can report a clear per-resource result.
  */
 type ProvisionResult = {
   /** Resources created during this run. */created: ProvisionedRef[]; /** Resources skipped because they already existed. */
-  skipped: ProvisionedRef[]; /** Merged binding → Cloudflare id map (existing + created) for writeWranglerConfig. */
+  skipped: ProvisionedRef[]; /** Resources that failed to create (captured, not thrown). */
+  failed: ProvisionFailure[]; /** Merged binding → Cloudflare id map (existing + created) for writeWranglerConfig. */
   ids: Record<string, string>;
 };
 /** Result of verifying the `.env` Cloudflare API token and resolving its account. */
@@ -332,13 +380,15 @@ declare const cliPlugin: import("@moku-labs/core").PluginInstance<"cli", Config,
 declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", Config$1, Record<string, never>, {
   run(opts?: {
     ci?: boolean;
+    stage?: string;
     webBuild?: WebBuild;
     manifest?: ExternalManifest;
   }): Promise<void>;
-  dev: (opts?: {
+  dev(opts?: {
     port?: number;
+    stage?: string;
     webBuild?: WebBuild;
-  }) => Promise<void>;
+  }): Promise<void>;
   init: (opts?: {
     ci?: boolean;
   }) => Promise<void>;
@@ -346,6 +396,7 @@ declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", C
   provisionInfra: (plan: InfraPlan) => Promise<ProvisionResult>;
   verifyAuth: () => Promise<AuthStatus>;
   requiredToken: () => TokenRequirement;
+  ciToken: () => PermissionGroup[];
   tokenInstructions: () => string;
   wrangler: (args: string[]) => Promise<void>;
 }, {}> & Record<never, never>;

package/dist/{index-VZ99IAMv.d.mts → index-BKOUpKtC.d.mts}

@@ -109,6 +109,32 @@ type Config$1 = {
    * Also the file parsed in the universal/non-moku path.
    */
   configFile: string;
+  /**
+   * The Worker entry module → wrangler `main` (e.g. "src/cloudflare/worker.ts"). Required for any
+   * real Worker deploy (its absence is wrangler's "Missing entry-point" error).
+   */
+  entry?: string;
+  /**
+   * Enable Node.js compat → `compatibility_flags: ["nodejs_compat"]`. Needed when the Worker bundle
+   * pulls in Node-flavored code (e.g. composing the deploy/cli tooling into the runtime app).
+   */
+  nodeCompat?: boolean;
+  /**
+   * Static assets served via `env.<binding>` → the wrangler `assets` block. `spa: true` sets
+   * `not_found_handling: "single-page-application"` so client-routed deep links resolve to index.html.
+   */
+  assets?: {
+    binding: string;
+    directory: string;
+    spa?: boolean;
+  };
+  /**
+   * Escape hatch — extra top-level wrangler keys merged into the generated config for anything the
+   * typed fields above don't cover (`vars`, `routes`, `observability`, `triggers`, …). The
+   * deploy-managed resource keys (name, compatibility_date, kv_namespaces, r2_buckets, d1_databases,
+   * queues, durable_objects, and the auto-derived Durable Object `migrations`) always win over these.
+   */
+  wrangler?: Record<string, unknown>;
   /**
    * Standing CI/automated default for `run()`. When true (or when stdout is non-TTY) the deploy
    * never prompts and auto-confirms every gate; `run({ ci })` overrides it per call. CF credentials
@@ -127,24 +153,35 @@ type Config$1 = {
   migrateLocal: boolean; /** Debounce window (ms) coalescing rapid file changes into one rebuild. */
   debounceMs: number;
 };
-/** Discriminated union of resource descriptors returned by each plugin's deployManifest(). */
+/**
+ * Discriminated union of per-INSTANCE resource descriptors. Each resource plugin's `deployManifest()`
+ * returns an ARRAY of these (one per configured instance). `name` is the base Cloudflare resource
+ * name (stage-suffixed downstream via {@link stageName}); `binding` is the stable env var. Durable
+ * Objects carry no provisioned `name` — they ship with the Worker script — and declare the exported
+ * `className` instead.
+ */
 type ResourceManifest = {
   kind: "r2";
-  bucket: string;
+  name: string;
+  binding: string;
   upload?: string;
 } | {
   kind: "kv";
+  name: string;
   binding: string;
 } | {
   kind: "d1";
+  name: string;
   binding: string;
   migrations?: string;
 } | {
   kind: "queue";
-  producers: string[];
+  name: string;
+  binding: string;
 } | {
   kind: "do";
-  bindings: Record<string, string>;
+  binding: string;
+  className: string;
 };
 /**
  * The whole deploy manifest the pipeline consumes (assembled, or caller-supplied for the
@@ -174,12 +211,23 @@ type InfraPlan = {
   missing: ResourceManifest[];
 };
 /**
- * Outcome of acting on an {@link InfraPlan}: the resources just created, those skipped because
- * they already existed, and the merged id map (binding → Cloudflare id) for the config writer.
+ * A resource that failed to provision, with the (branded) error message captured so the guided flow
+ * can show WHICH resource failed and why — instead of aborting the whole run on the first failure.
+ */
+type ProvisionFailure = {
+  /** The resource descriptor that failed to create. */resource: ResourceManifest; /** The captured error message (e.g. the branded wrangler failure). */
+  error: string;
+};
+/**
+ * Outcome of acting on an {@link InfraPlan}: the resources just created, those skipped because they
+ * already existed, those that FAILED to create, and the merged id map (binding → Cloudflare id) for
+ * the config writer. Provisioning is resilient — a single resource failure is captured here, not
+ * thrown, so the guided flow can report a clear per-resource result.
  */
 type ProvisionResult = {
   /** Resources created during this run. */created: ProvisionedRef[]; /** Resources skipped because they already existed. */
-  skipped: ProvisionedRef[]; /** Merged binding → Cloudflare id map (existing + created) for writeWranglerConfig. */
+  skipped: ProvisionedRef[]; /** Resources that failed to create (captured, not thrown). */
+  failed: ProvisionFailure[]; /** Merged binding → Cloudflare id map (existing + created) for writeWranglerConfig. */
   ids: Record<string, string>;
 };
 /** Result of verifying the `.env` Cloudflare API token and resolving its account. */
@@ -332,13 +380,15 @@ declare const cliPlugin: import("@moku-labs/core").PluginInstance<"cli", Config,
 declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", Config$1, Record<string, never>, {
   run(opts?: {
     ci?: boolean;
+    stage?: string;
     webBuild?: WebBuild;
     manifest?: ExternalManifest;
   }): Promise<void>;
-  dev: (opts?: {
+  dev(opts?: {
     port?: number;
+    stage?: string;
     webBuild?: WebBuild;
-  }) => Promise<void>;
+  }): Promise<void>;
   init: (opts?: {
     ci?: boolean;
   }) => Promise<void>;
@@ -346,6 +396,7 @@ declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", C
   provisionInfra: (plan: InfraPlan) => Promise<ProvisionResult>;
   verifyAuth: () => Promise<AuthStatus>;
   requiredToken: () => TokenRequirement;
+  ciToken: () => PermissionGroup[];
   tokenInstructions: () => string;
   wrangler: (args: string[]) => Promise<void>;
 }, {}> & Record<never, never>;

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cli = require("./cli-Dc0q0hIy.cjs");
+const require_cli = require("./cli-C8DdTtzn.cjs");
 let _moku_labs_common = require("@moku-labs/common");
 //#region src/env-provider.ts
 /**