@moku-labs/worker 0.5.1 → 0.6.0

package/dist/index.mjs

@@ -1,5 +1,36 @@
-import { a as defineDurableObject, c as coreConfig, d as stagePlugin, i as durableObjectsPlugin, l as createCore, n as queuesPlugin, o as d1Plugin, r as kvPlugin, s as bindingsPlugin, t as storagePlugin, u as createPlugin$1 } from "./storage-COo-F38H.mjs";
+import { a as kvPlugin, c as d1Plugin, d as createCore, f as createPlugin$1, i as queuesPlugin, l as bindingsPlugin, n as deployPlugin, o as durableObjectsPlugin, p as stagePlugin, r as storagePlugin, s as defineDurableObject, t as cliPlugin, u as coreConfig } from "./cli-DgZv5A0G.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
+//#region src/env-provider.ts
+/**
+* Build the default env provider: a shallow copy of `process.env` when a `process` global exists,
+* else an empty record. Safe to evaluate at Worker cold start — it never throws on a missing
+* `process` (typeof of an undeclared identifier is the string "undefined", not a ReferenceError).
+*
+* @returns An {@link EnvProvider} named `worker-process-env`.
+* @example
+* ```ts
+* // wired by createApp so `ctx.env.get("CLOUDFLARE_API_TOKEN")` resolves under Bun/Node
+* const provider = workerSafeProcessEnv();
+* provider.load().CLOUDFLARE_API_TOKEN;
+* ```
+*/
+const workerSafeProcessEnv = () => ({
+	name: "worker-process-env",
+	/**
+	* Read a shallow copy of `process.env`, or `{}` when there is no `process` global (workerd
+	* without nodejs_compat). Never throws at cold start.
+	*
+	* @returns The current environment as a flat record (empty when `process` is absent).
+	* @example
+	* ```ts
+	* workerSafeProcessEnv().load();
+	* ```
+	*/
+	load() {
+		return typeof process === "undefined" ? {} : { ...process.env };
+	}
+});
+//#endregion
 //#region src/plugins/server/api.ts
 /**
 * Builds the `app.server.*` surface the consumer's Worker default export reads.
@@ -483,50 +514,6 @@ const serverPlugin = createPlugin$1("server", {
 });
 //#endregion
 //#region src/index.ts
-/**
-* @file `@moku-labs/worker` — server-side Cloudflare Workers app + deploy framework on `@moku-labs/core`.
-*
-* The package root exports the bound {@link createApp} factory (the Layer-3 entry
-* point), {@link createPlugin} for consumer plugins, every runtime plugin instance,
-* the `server`/`durable-objects` helpers, and the framework types. Node-only tooling
-* (`deploy`, `cli`) ships from the separate `@moku-labs/worker/cli` entry, never here.
-*
-* `createApp(options?)` boots a fully-typed, synchronous, per-isolate app. The
-* framework defaults `[logPlugin, envPlugin, stagePlugin, bindingsPlugin, serverPlugin]`
-* are applied first, then the `options` below are shallow-merged on top:
-*
-* - `config` — `Partial<WorkerConfig>`; defaults `{ stage: "production", name: "moku-worker", compatibilityDate: "" }`.
-*   `config.stage` is the single stage source: the framework mirrors it into the `stage` core
-*   plugin so `ctx.stage.*` / `app.stage.*` stay in lockstep with `ctx.global.stage` (see {@link createApp}).
-* - `pluginConfigs` — per-plugin config overrides keyed by plugin name (e.g. `server.endpoints`, `bindings.required`); default `{}`.
-* - `plugins` — extra `PluginInstance[]` appended to the defaults; default `[]`. Do NOT re-list a default plugin.
-* - `onReady` — optional `(app) => void`, runs after every plugin's `onInit`.
-* - `onError` — optional `(error) => void` boot/lifecycle error handler.
-* - `onStart` / `onStop` — optional `() => void | Promise<void>` runtime lifecycle hooks (`app.start()` / `app.stop()`).
-*
-* Re-listing a default plugin name in `plugins` throws
-* `TypeError: [moku-worker] Duplicate plugin name: "<name>"` — `bindings` and `server`
-* are already wired, so consumers list only the resource plugins they add (`kv`, `d1`, …).
-*
-* Minimal HTTP Worker (shape taken from the server integration test):
-*
-* ```typescript
-* import { createApp, endpoint } from "@moku-labs/worker";
-*
-* export const app = createApp({
-*   config: { name: "my-worker", compatibilityDate: "2024-09-23" },
-*   pluginConfigs: {
-*     server: { endpoints: [endpoint("/health").get(() => new Response("ok"))] }
-*   }
-* });
-*
-* // worker.ts — the default export is hand-assembled; no plugin produces it.
-* export default {
-*   fetch: (request: Request, env: Record<string, unknown>, ctx: ExecutionContext) =>
-*     app.server.handle(request, env, ctx)
-* } satisfies ExportedHandler;
-* ```
-*/
 const framework = createCore(coreConfig, { plugins: [bindingsPlugin, serverPlugin] });
 const { createPlugin } = framework;
 /** The core-bound app factory; wrapped by {@link createApp} to bridge `config.stage`. */
@@ -543,8 +530,11 @@ const boundCreateApp = framework.createApp;
 * that sees the consumer's chosen stage, so it mirrors `config.stage` into the stage
 * plugin's level-4 `pluginConfigs` override (`WorkerConfig.stage → pluginConfigs.stage.stage`).
 * When `config.stage` is omitted, the global config and the stage plugin both fall back
-* to their identical `"production"` default. See the module JSDoc above for the full
-* options/defaults table.
+* to their identical `"production"` default. It ALSO wires a default workerd-safe
+* {@link workerSafeProcessEnv} provider into the `env` core plugin (same bridge mechanism) so
+* deploy/auth can read `CLOUDFLARE_API_TOKEN` and friends via `ctx.env` — without it the env plugin
+* has zero providers and every `ctx.env` read is undefined. See the module JSDoc above for the
+* full options/defaults table.
 *
 * @param options - The createApp options (`config`, `pluginConfigs`, `plugins`, and lifecycle callbacks).
 * @returns The initialized app — every plugin's `onInit` has already run.
@@ -552,18 +542,24 @@ const boundCreateApp = framework.createApp;
 * ```typescript
 * const app = createApp({ config: { stage: "development", name: "my-worker" } });
 * app.stage.isDev(); // true — bridged from config.stage
+* app.env.get("CLOUDFLARE_API_TOKEN"); // read from process.env via the default env provider
 * ```
 */
 const createApp = (options) => {
 	const explicitStage = options?.config?.stage;
-	if (explicitStage === void 0) return boundCreateApp(options);
+	const provided = options?.pluginConfigs;
+	const pluginConfigs = {
+		...options?.pluginConfigs,
+		env: {
+			...provided?.env,
+			providers: provided?.env?.providers ?? [workerSafeProcessEnv()]
+		}
+	};
+	if (explicitStage !== void 0) pluginConfigs.stage = { stage: explicitStage };
 	return boundCreateApp({
 		...options,
-		pluginConfigs: {
-			...options?.pluginConfigs,
-			stage: { stage: explicitStage }
-		}
+		pluginConfigs
 	});
 };
 //#endregion
-export { bindingsPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };
+export { bindingsPlugin, cliPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, deployPlugin, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/worker",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Cloudflare Worker framework for Moku — Durable Objects, Queues, R2, D1, and KV plugins that compose with Moku Web.",
   "repository": {
     "type": "git",

package/dist/config-BYPJvEbl.d.cts

@@ -1,88 +0,0 @@
-import { PluginCtx } from "@moku-labs/core";
-
-//#region src/config.d.ts
-/** Per-request Cloudflare bindings object (env). Framework-level shared type. */
-type WorkerEnv = Record<string, unknown>;
-/** Global framework config — flat, with complete defaults. */
-type WorkerConfig = {
-  stage: "production" | "development" | "test";
-  name: string;
-  compatibilityDate: string;
-};
-/** Global framework events — declared once, visible to every plugin. */
-type WorkerEvents = {
-  "request:start": {
-    method: string;
-    path: string;
-    requestId: string;
-  };
-  "request:end": {
-    method: string;
-    path: string;
-    status: number;
-    ms: number;
-  };
-  "deploy:phase": {
-    phase: string;
-    detail?: string;
-  };
-  "deploy:complete": {
-    url: string;
-  };
-  "provision:resource": {
-    kind: "kv" | "r2" | "d1" | "queue" | "do";
-    name: string;
-  };
-  "provision:plan": {
-    exists: number;
-    missing: number;
-    account: string;
-  };
-  "provision:skip": {
-    kind: "kv" | "r2" | "d1" | "queue" | "do";
-    name: string;
-  };
-  "auth:verified": {
-    account: string;
-    accountId: string;
-    scopes: string[];
-  };
-  "dev:phase": {
-    phase: string;
-    detail?: string;
-  };
-  "dev:rebuilt": {
-    files: number;
-    ms: number;
-  };
-  "dev:error": {
-    message: string;
-  };
-};
-/**
- * Worker-bound plugin context for Layer-3 consumer plugins. Aliases the core
- * {@link PluginCtx} with the global {@link WorkerEvents} pre-merged into the event
- * map, so a consumer plugin types its own `config`/`state`/`emit` by passing only
- * its OWN event map — never hand-merging `WorkerEvents`, and never importing from
- * `@moku-labs/core` (a Layer-1 boundary the spec validator flags for consumers).
- *
- * A plugin that resolves sibling plugins also needs a `require` field; intersect the
- * public `Server.RequireFn` for it, exactly as this framework's own plugins do. When
- * you need the unaliased shape (e.g. a different global event map), use the raw
- * re-exported {@link PluginCtx} instead.
- *
- * @template Config - This plugin's own flat configuration object.
- * @template State - This plugin's mutable state (use `Record<string, never>` when stateless).
- * @template Events - This plugin's own event map, merged on top of {@link WorkerEvents}; defaults to none.
- * @example
- * ```typescript
- * import type { Server, WorkerPluginCtx } from "@moku-labs/worker";
- * type MyEvents = { "my:done": { id: string } };
- * export type MyCtx = WorkerPluginCtx<MyConfig, Record<string, never>, MyEvents> & {
- *   require: Server.RequireFn;
- * };
- * ```
- */
-type WorkerPluginCtx<Config, State, Events extends Record<string, unknown> = Record<never, never>> = PluginCtx<Config, State, WorkerEvents & Events>;
-//#endregion
-export { WorkerPluginCtx as i, WorkerEnv as n, WorkerEvents as r, WorkerConfig as t };

package/dist/config-BYPJvEbl.d.mts

@@ -1,88 +0,0 @@
-import { PluginCtx } from "@moku-labs/core";
-
-//#region src/config.d.ts
-/** Per-request Cloudflare bindings object (env). Framework-level shared type. */
-type WorkerEnv = Record<string, unknown>;
-/** Global framework config — flat, with complete defaults. */
-type WorkerConfig = {
-  stage: "production" | "development" | "test";
-  name: string;
-  compatibilityDate: string;
-};
-/** Global framework events — declared once, visible to every plugin. */
-type WorkerEvents = {
-  "request:start": {
-    method: string;
-    path: string;
-    requestId: string;
-  };
-  "request:end": {
-    method: string;
-    path: string;
-    status: number;
-    ms: number;
-  };
-  "deploy:phase": {
-    phase: string;
-    detail?: string;
-  };
-  "deploy:complete": {
-    url: string;
-  };
-  "provision:resource": {
-    kind: "kv" | "r2" | "d1" | "queue" | "do";
-    name: string;
-  };
-  "provision:plan": {
-    exists: number;
-    missing: number;
-    account: string;
-  };
-  "provision:skip": {
-    kind: "kv" | "r2" | "d1" | "queue" | "do";
-    name: string;
-  };
-  "auth:verified": {
-    account: string;
-    accountId: string;
-    scopes: string[];
-  };
-  "dev:phase": {
-    phase: string;
-    detail?: string;
-  };
-  "dev:rebuilt": {
-    files: number;
-    ms: number;
-  };
-  "dev:error": {
-    message: string;
-  };
-};
-/**
- * Worker-bound plugin context for Layer-3 consumer plugins. Aliases the core
- * {@link PluginCtx} with the global {@link WorkerEvents} pre-merged into the event
- * map, so a consumer plugin types its own `config`/`state`/`emit` by passing only
- * its OWN event map — never hand-merging `WorkerEvents`, and never importing from
- * `@moku-labs/core` (a Layer-1 boundary the spec validator flags for consumers).
- *
- * A plugin that resolves sibling plugins also needs a `require` field; intersect the
- * public `Server.RequireFn` for it, exactly as this framework's own plugins do. When
- * you need the unaliased shape (e.g. a different global event map), use the raw
- * re-exported {@link PluginCtx} instead.
- *
- * @template Config - This plugin's own flat configuration object.
- * @template State - This plugin's mutable state (use `Record<string, never>` when stateless).
- * @template Events - This plugin's own event map, merged on top of {@link WorkerEvents}; defaults to none.
- * @example
- * ```typescript
- * import type { Server, WorkerPluginCtx } from "@moku-labs/worker";
- * type MyEvents = { "my:done": { id: string } };
- * export type MyCtx = WorkerPluginCtx<MyConfig, Record<string, never>, MyEvents> & {
- *   require: Server.RequireFn;
- * };
- * ```
- */
-type WorkerPluginCtx<Config, State, Events extends Record<string, unknown> = Record<never, never>> = PluginCtx<Config, State, WorkerEvents & Events>;
-//#endregion
-export { WorkerPluginCtx as i, WorkerEnv as n, WorkerEvents as r, WorkerConfig as t };