@moku-labs/worker 0.1.0

package/dist/cli.d.cts

@@ -0,0 +1,139 @@
+import { PluginCtx, PluginInstance } from "@moku-labs/core";
+
+//#region src/plugins/cli/types.d.ts
+/**
+ * @file cli plugin — type definitions (Config, Api).
+ */
+/** Resolved configuration for the cli plugin. Flat; complete defaults so omission never yields undefined. */
+type Config$1 = {
+  /**
+   * Default local dev port forwarded to deploy.dev when dev() gets no port.
+   * Passed through to `wrangler dev --port <n>`.
+   *
+   * @default 8787
+   */
+  readonly port: number;
+};
+/** Public api surface of the cli plugin, mounted at app.cli.*. */
+type Api = {
+  /**
+   * Run the Worker locally via Wrangler (delegates to deploy.dev).
+   * Defaults port to the configured value (8787) when called with no opts.
+   *
+   * @param opts - Optional port override.
+   * @param opts.port - Local dev port to bind.
+   * @returns Resolves when the dev session ends.
+   * @example
+   * ```ts
+   * await app.cli.dev();            // port 8787
+   * await app.cli.dev({ port: 3000 }); // port 3000
+   * ```
+   */
+  dev(opts?: {
+    port?: number;
+  }): Promise<void>;
+  /**
+   * One-command guided Cloudflare deploy (delegates to deploy.run).
+   * Forwards opts verbatim — passes undefined when called with no opts.
+   *
+   * @param opts - Optional guided/yes flags.
+   * @param opts.guided - Walk through each step interactively.
+   * @param opts.yes - Skip confirmation prompts (non-interactive).
+   * @returns Resolves once the deploy completes.
+   * @example
+   * ```ts
+   * await app.cli.deploy({ guided: true });
+   * await app.cli.deploy({ yes: true }); // CI
+   * await app.cli.deploy(); // no opts → undefined forwarded
+   * ```
+   */
+  deploy(opts?: {
+    guided?: boolean;
+    yes?: boolean;
+  }): Promise<void>;
+};
+//#endregion
+//#region src/plugins/cli/index.d.ts
+/**
+ * Standard tier (node-only) — developer-facing CLI surface.
+ *
+ * Mounts `app.cli.dev()` and `app.cli.deploy()` as thin passthroughs to deployPlugin.
+ * Hooks subscribe to the global deploy:phase / provision:resource / deploy:complete events
+ * and print a live progress TUI via the injected ctx.log core API.
+ *
+ * Inline lambdas on `api`/`hooks` preserve event-name inference so the hook map keys
+ * are constrained to `WorkerEvents` keys (spec/15 §5).
+ *
+ * @see README.md
+ */
+declare const cliPlugin: import("@moku-labs/core").PluginInstance<"cli", Config$1, Record<string, never>, Api, {}> & Record<never, never>;
+//#endregion
+//#region src/plugins/deploy/types.d.ts
+/** deploy plugin configuration. Flat; complete defaults so omission never yields undefined. */
+type Config = {
+  /**
+   * Wrangler config file generated/updated and read by `wrangler deploy`. Default "wrangler.jsonc".
+   * Also the file parsed in the universal/non-moku path.
+   */
+  configFile: string;
+  /**
+   * CI mode. When true (or when stdout is non-TTY), the guided flow NEVER prompts.
+   * CF credentials are read from the Node env (CLOUDFLARE_API_TOKEN / CLOUDFLARE_ACCOUNT_ID).
+   * Default false.
+   */
+  ci: boolean;
+};
+/** Discriminated union of resource descriptors returned by each plugin's deployManifest(). */
+type ResourceManifest = {
+  kind: "r2";
+  bucket: string;
+  upload?: string;
+} | {
+  kind: "kv";
+  binding: string;
+} | {
+  kind: "d1";
+  binding: string;
+  migrations?: string;
+} | {
+  kind: "queue";
+  producers: string[];
+} | {
+  kind: "do";
+  bindings: Record<string, string>;
+};
+/**
+ * The whole deploy manifest the pipeline consumes (assembled, or caller-supplied for the
+ * universal path).
+ */
+type ExternalManifest = {
+  /** Worker name. */name: string; /** Cloudflare compatibility date. */
+  compatibilityDate: string; /** Resource descriptors to provision. */
+  resources: ResourceManifest[];
+};
+//#endregion
+//#region src/plugins/deploy/index.d.ts
+/**
+ * Complex tier (node-only) — build-time deploy orchestrator over the five resource plugins.
+ *
+ * Assembles each resource plugin's deployManifest() via ctx.require, provisions resources,
+ * generates/updates wrangler config, uploads the R2 upload dir, and runs wrangler deploy.
+ * Also supports a universal path: run({ manifest }) uses a caller-supplied manifest verbatim.
+ *
+ * @see README.md
+ */
+declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", Config, Record<string, never>, {
+  run(opts?: {
+    guided?: boolean;
+    yes?: boolean;
+    manifest?: ExternalManifest;
+  }): Promise<void>;
+  dev: (opts?: {
+    port?: number;
+  }) => Promise<void>;
+  init: (opts?: {
+    ci?: boolean;
+  }) => Promise<void>;
+}, {}> & Record<never, never>;
+//#endregion
+export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };

package/dist/cli.d.mts

@@ -0,0 +1,139 @@
+import { PluginCtx, PluginInstance } from "@moku-labs/core";
+
+//#region src/plugins/cli/types.d.ts
+/**
+ * @file cli plugin — type definitions (Config, Api).
+ */
+/** Resolved configuration for the cli plugin. Flat; complete defaults so omission never yields undefined. */
+type Config$1 = {
+  /**
+   * Default local dev port forwarded to deploy.dev when dev() gets no port.
+   * Passed through to `wrangler dev --port <n>`.
+   *
+   * @default 8787
+   */
+  readonly port: number;
+};
+/** Public api surface of the cli plugin, mounted at app.cli.*. */
+type Api = {
+  /**
+   * Run the Worker locally via Wrangler (delegates to deploy.dev).
+   * Defaults port to the configured value (8787) when called with no opts.
+   *
+   * @param opts - Optional port override.
+   * @param opts.port - Local dev port to bind.
+   * @returns Resolves when the dev session ends.
+   * @example
+   * ```ts
+   * await app.cli.dev();            // port 8787
+   * await app.cli.dev({ port: 3000 }); // port 3000
+   * ```
+   */
+  dev(opts?: {
+    port?: number;
+  }): Promise<void>;
+  /**
+   * One-command guided Cloudflare deploy (delegates to deploy.run).
+   * Forwards opts verbatim — passes undefined when called with no opts.
+   *
+   * @param opts - Optional guided/yes flags.
+   * @param opts.guided - Walk through each step interactively.
+   * @param opts.yes - Skip confirmation prompts (non-interactive).
+   * @returns Resolves once the deploy completes.
+   * @example
+   * ```ts
+   * await app.cli.deploy({ guided: true });
+   * await app.cli.deploy({ yes: true }); // CI
+   * await app.cli.deploy(); // no opts → undefined forwarded
+   * ```
+   */
+  deploy(opts?: {
+    guided?: boolean;
+    yes?: boolean;
+  }): Promise<void>;
+};
+//#endregion
+//#region src/plugins/cli/index.d.ts
+/**
+ * Standard tier (node-only) — developer-facing CLI surface.
+ *
+ * Mounts `app.cli.dev()` and `app.cli.deploy()` as thin passthroughs to deployPlugin.
+ * Hooks subscribe to the global deploy:phase / provision:resource / deploy:complete events
+ * and print a live progress TUI via the injected ctx.log core API.
+ *
+ * Inline lambdas on `api`/`hooks` preserve event-name inference so the hook map keys
+ * are constrained to `WorkerEvents` keys (spec/15 §5).
+ *
+ * @see README.md
+ */
+declare const cliPlugin: import("@moku-labs/core").PluginInstance<"cli", Config$1, Record<string, never>, Api, {}> & Record<never, never>;
+//#endregion
+//#region src/plugins/deploy/types.d.ts
+/** deploy plugin configuration. Flat; complete defaults so omission never yields undefined. */
+type Config = {
+  /**
+   * Wrangler config file generated/updated and read by `wrangler deploy`. Default "wrangler.jsonc".
+   * Also the file parsed in the universal/non-moku path.
+   */
+  configFile: string;
+  /**
+   * CI mode. When true (or when stdout is non-TTY), the guided flow NEVER prompts.
+   * CF credentials are read from the Node env (CLOUDFLARE_API_TOKEN / CLOUDFLARE_ACCOUNT_ID).
+   * Default false.
+   */
+  ci: boolean;
+};
+/** Discriminated union of resource descriptors returned by each plugin's deployManifest(). */
+type ResourceManifest = {
+  kind: "r2";
+  bucket: string;
+  upload?: string;
+} | {
+  kind: "kv";
+  binding: string;
+} | {
+  kind: "d1";
+  binding: string;
+  migrations?: string;
+} | {
+  kind: "queue";
+  producers: string[];
+} | {
+  kind: "do";
+  bindings: Record<string, string>;
+};
+/**
+ * The whole deploy manifest the pipeline consumes (assembled, or caller-supplied for the
+ * universal path).
+ */
+type ExternalManifest = {
+  /** Worker name. */name: string; /** Cloudflare compatibility date. */
+  compatibilityDate: string; /** Resource descriptors to provision. */
+  resources: ResourceManifest[];
+};
+//#endregion
+//#region src/plugins/deploy/index.d.ts
+/**
+ * Complex tier (node-only) — build-time deploy orchestrator over the five resource plugins.
+ *
+ * Assembles each resource plugin's deployManifest() via ctx.require, provisions resources,
+ * generates/updates wrangler config, uploads the R2 upload dir, and runs wrangler deploy.
+ * Also supports a universal path: run({ manifest }) uses a caller-supplied manifest verbatim.
+ *
+ * @see README.md
+ */
+declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", Config, Record<string, never>, {
+  run(opts?: {
+    guided?: boolean;
+    yes?: boolean;
+    manifest?: ExternalManifest;
+  }): Promise<void>;
+  dev: (opts?: {
+    port?: number;
+  }) => Promise<void>;
+  init: (opts?: {
+    ci?: boolean;
+  }) => Promise<void>;
+}, {}> & Record<never, never>;
+//#endregion
+export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };