@moku-labs/worker 0.2.0 → 0.2.1

package/dist/config-Bj3GUJT_.d.cts

@@ -0,0 +1,63 @@
+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;
+  };
+};
+/**
+ * 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-Bj3GUJT_.d.mts

@@ -0,0 +1,63 @@
+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;
+  };
+};
+/**
+ * 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/index.d.cts

@@ -1,5 +1,5 @@
-import { n as WorkerEnv, r as WorkerEvents, t as WorkerConfig } from "./config-AjH57AmD.cjs";
-import { PluginCtx, PluginInstance } from "@moku-labs/core";
+import { i as WorkerPluginCtx, n as WorkerEnv, r as WorkerEvents, t as WorkerConfig } from "./config-Bj3GUJT_.cjs";
+import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 
 //#region \0rolldown/runtime.js
@@ -50,7 +50,7 @@ type BindingsApi = {
  * api-factory context. State slot is Record<string, never> — bindings holds NO
  * state (F4). Type-argument order is PluginCtx<Config, State, Events>.
  */
-type Context = PluginCtx<Config$4, Record<string, never>, WorkerEvents>;
+type Context = PluginCtx$1<Config$4, Record<string, never>, WorkerEvents>;
 //#endregion
 //#region src/plugins/bindings/index.d.ts
 /**
@@ -186,7 +186,7 @@ type ServerEvents = {
   };
 };
 /** Full server plugin context (own config + state + merged events + cross-plugin reach). */
-type ServerCtx = PluginCtx<ServerConfig, ServerState, WorkerEvents & ServerEvents> & {
+type ServerCtx = PluginCtx$1<ServerConfig, ServerState, WorkerEvents & ServerEvents> & {
   /** Cross-plugin require threaded into each RequestContext. */require: RequireFn; /** Presence check for an optional plugin. */
   has: (name: string) => boolean;
 };
@@ -417,7 +417,7 @@ type Api$2 = {
  * Internal context type — own config first, no state, no d1-local events.
  * Intersected with a narrow `require` typed to the one dependency d1 resolves.
  */
-type D1Ctx = PluginCtx<Config$3, Record<string, never>, WorkerEvents> & {
+type D1Ctx = PluginCtx$1<Config$3, Record<string, never>, WorkerEvents> & {
   /**
    * Resolve a dependency plugin's api. d1 only ever resolves `bindingsPlugin`.
    *
@@ -493,7 +493,7 @@ type Api$1 = {
  * Internal context type — own config first, no state, no DO events.
  * Intersected with a narrow `require` typed to the one dependency durableObjects resolves.
  */
-type Ctx$1 = PluginCtx<Config$2, Record<string, never>, WorkerEvents> & {
+type Ctx$1 = PluginCtx$1<Config$2, Record<string, never>, WorkerEvents> & {
   /**
    * Resolve a dependency plugin's api. durableObjects only ever resolves `bindingsPlugin`.
    *
@@ -732,7 +732,7 @@ type Api = {
  * (core's "advanced composition" note), typed to the one dependency queues resolves —
  * `require(bindingsPlugin)` → `BindingsApi`. Core does not export `RequireFunction`.
  */
-type Ctx = PluginCtx<Config$1, Record<string, never>, WorkerEvents & QueueEvents> & {
+type Ctx = PluginCtx$1<Config$1, Record<string, never>, WorkerEvents & QueueEvents> & {
   /**
    * Resolve a dependency plugin's api. queues only ever resolves `bindingsPlugin`.
    *
@@ -878,7 +878,7 @@ type StorageApi = {
  * resolves — mirrors the kv/api.ts pattern (PluginCtx has no `require` by
  * default; core does not export a generic RequireFunction).
  */
-type StorageCtx = PluginCtx<StorageConfig, Record<string, never>, WorkerEvents> & {
+type StorageCtx = PluginCtx$1<StorageConfig, Record<string, never>, WorkerEvents> & {
   /**
    * Resolve a dependency plugin's api. storage only ever resolves bindingsPlugin.
    *
@@ -1028,4 +1028,4 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     current: () => "production" | "development" | "test";
   }>]>>;
 //#endregion
-export { type types_d_exports as Bindings, type types_d_exports$1 as D1, type types_d_exports$2 as DurableObjects, type types_d_exports$3 as Queues, type types_d_exports$4 as Server, type StageApi, type types_d_exports$5 as Storage, type WorkerConfig, type WorkerEnv, type WorkerEvents, bindingsPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };
+export { type types_d_exports as Bindings, type types_d_exports$1 as D1, type types_d_exports$2 as DurableObjects, type PluginCtx, type types_d_exports$3 as Queues, type types_d_exports$4 as Server, type StageApi, type types_d_exports$5 as Storage, type WorkerConfig, type WorkerEnv, type WorkerEvents, type WorkerPluginCtx, bindingsPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { n as WorkerEnv, r as WorkerEvents, t as WorkerConfig } from "./config-AjH57AmD.mjs";
+import { i as WorkerPluginCtx, n as WorkerEnv, r as WorkerEvents, t as WorkerConfig } from "./config-Bj3GUJT_.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
-import { PluginCtx, PluginInstance } from "@moku-labs/core";
+import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 
 //#region \0rolldown/runtime.js
 declare namespace types_d_exports {
@@ -50,7 +50,7 @@ type BindingsApi = {
  * api-factory context. State slot is Record<string, never> — bindings holds NO
  * state (F4). Type-argument order is PluginCtx<Config, State, Events>.
  */
-type Context = PluginCtx<Config$4, Record<string, never>, WorkerEvents>;
+type Context = PluginCtx$1<Config$4, Record<string, never>, WorkerEvents>;
 //#endregion
 //#region src/plugins/bindings/index.d.ts
 /**
@@ -186,7 +186,7 @@ type ServerEvents = {
   };
 };
 /** Full server plugin context (own config + state + merged events + cross-plugin reach). */
-type ServerCtx = PluginCtx<ServerConfig, ServerState, WorkerEvents & ServerEvents> & {
+type ServerCtx = PluginCtx$1<ServerConfig, ServerState, WorkerEvents & ServerEvents> & {
   /** Cross-plugin require threaded into each RequestContext. */require: RequireFn; /** Presence check for an optional plugin. */
   has: (name: string) => boolean;
 };
@@ -417,7 +417,7 @@ type Api$2 = {
  * Internal context type — own config first, no state, no d1-local events.
  * Intersected with a narrow `require` typed to the one dependency d1 resolves.
  */
-type D1Ctx = PluginCtx<Config$3, Record<string, never>, WorkerEvents> & {
+type D1Ctx = PluginCtx$1<Config$3, Record<string, never>, WorkerEvents> & {
   /**
    * Resolve a dependency plugin's api. d1 only ever resolves `bindingsPlugin`.
    *
@@ -493,7 +493,7 @@ type Api$1 = {
  * Internal context type — own config first, no state, no DO events.
  * Intersected with a narrow `require` typed to the one dependency durableObjects resolves.
  */
-type Ctx$1 = PluginCtx<Config$2, Record<string, never>, WorkerEvents> & {
+type Ctx$1 = PluginCtx$1<Config$2, Record<string, never>, WorkerEvents> & {
   /**
    * Resolve a dependency plugin's api. durableObjects only ever resolves `bindingsPlugin`.
    *
@@ -732,7 +732,7 @@ type Api = {
  * (core's "advanced composition" note), typed to the one dependency queues resolves —
  * `require(bindingsPlugin)` → `BindingsApi`. Core does not export `RequireFunction`.
  */
-type Ctx = PluginCtx<Config$1, Record<string, never>, WorkerEvents & QueueEvents> & {
+type Ctx = PluginCtx$1<Config$1, Record<string, never>, WorkerEvents & QueueEvents> & {
   /**
    * Resolve a dependency plugin's api. queues only ever resolves `bindingsPlugin`.
    *
@@ -878,7 +878,7 @@ type StorageApi = {
  * resolves — mirrors the kv/api.ts pattern (PluginCtx has no `require` by
  * default; core does not export a generic RequireFunction).
  */
-type StorageCtx = PluginCtx<StorageConfig, Record<string, never>, WorkerEvents> & {
+type StorageCtx = PluginCtx$1<StorageConfig, Record<string, never>, WorkerEvents> & {
   /**
    * Resolve a dependency plugin's api. storage only ever resolves bindingsPlugin.
    *
@@ -1028,4 +1028,4 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     current: () => "production" | "development" | "test";
   }>]>>;
 //#endregion
-export { type types_d_exports as Bindings, type types_d_exports$1 as D1, type types_d_exports$2 as DurableObjects, type types_d_exports$3 as Queues, type types_d_exports$4 as Server, type StageApi, type types_d_exports$5 as Storage, type WorkerConfig, type WorkerEnv, type WorkerEvents, bindingsPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };
+export { type types_d_exports as Bindings, type types_d_exports$1 as D1, type types_d_exports$2 as DurableObjects, type PluginCtx, type types_d_exports$3 as Queues, type types_d_exports$4 as Server, type StageApi, type types_d_exports$5 as Storage, type WorkerConfig, type WorkerEnv, type WorkerEvents, type WorkerPluginCtx, bindingsPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/worker",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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-AjH57AmD.d.cts

@@ -1,36 +0,0 @@
-//#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;
-  };
-};
-//#endregion
-export { WorkerEnv as n, WorkerEvents as r, WorkerConfig as t };

package/dist/config-AjH57AmD.d.mts

@@ -1,36 +0,0 @@
-//#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;
-  };
-};
-//#endregion
-export { WorkerEnv as n, WorkerEvents as r, WorkerConfig as t };