@moku-labs/worker 0.1.3 → 0.2.0

package/README.md

@@ -33,7 +33,7 @@ export const app = createApp({
     server: {
       endpoints: [
         endpoint("/health").get(() => new Response("ok", { status: 200 })),
-        endpoint("/api/data/{lang?}").get(({ params }) =>
+        endpoint("/api/data/{lang:?}").get(({ params }) =>
           Response.json({ lang: params.lang ?? "en" })
         ),
         endpoint("/users/{userId}").get(

package/dist/cli.cjs

@@ -1,9 +1,31 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_storage = require("./storage-Sy--rX1T.cjs");
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+const require_storage = require("./storage-CgXl-dUA.cjs");
 let node_child_process = require("node:child_process");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
-node_path = require_storage.__toESM(node_path, 1);
+node_path = __toESM(node_path, 1);
 let node_fs = require("node:fs");
 //#region src/plugins/deploy/runner.ts
 /**
@@ -596,6 +618,9 @@ const createDeployApi = (ctx) => ({
 * 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.
 *
+* Emits only the global events `deploy:phase`, `deploy:complete`, and `provision:resource`
+* (declared in WorkerEvents — no per-plugin events block).
+*
 * @see README.md
 */
 const deployPlugin = require_storage.createPlugin("deploy", {

package/dist/cli.d.cts

@@ -120,6 +120,9 @@ type ExternalManifest = {
  * 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.
  *
+ * Emits only the global events `deploy:phase`, `deploy:complete`, and `provision:resource`
+ * (declared in WorkerEvents — no per-plugin events block).
+ *
  * @see README.md
  */
 declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", Config, Record<string, never>, {

package/dist/cli.d.mts

@@ -120,6 +120,9 @@ type ExternalManifest = {
  * 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.
  *
+ * Emits only the global events `deploy:phase`, `deploy:complete`, and `provision:resource`
+ * (declared in WorkerEvents — no per-plugin events block).
+ *
  * @see README.md
  */
 declare const deployPlugin: import("@moku-labs/core").PluginInstance<"deploy", Config, Record<string, never>, {

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { i as durableObjectsPlugin, n as queuesPlugin, o as d1Plugin, r as kvPlugin, t as storagePlugin, u as createPlugin } from "./storage-DCOQ4EAg.mjs";
+import { i as durableObjectsPlugin, n as queuesPlugin, o as d1Plugin, r as kvPlugin, t as storagePlugin, u as createPlugin } from "./storage-COo-F38H.mjs";
 import { spawn } from "node:child_process";
 import { readdir, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
@@ -594,6 +594,9 @@ const createDeployApi = (ctx) => ({
 * 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.
 *
+* Emits only the global events `deploy:phase`, `deploy:complete`, and `provision:resource`
+* (declared in WorkerEvents — no per-plugin events block).
+*
 * @see README.md
 */
 const deployPlugin = createPlugin("deploy", {

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_storage = require("./storage-Sy--rX1T.cjs");
+const require_storage = require("./storage-CgXl-dUA.cjs");
 let _moku_labs_common = require("@moku-labs/common");
 //#region src/plugins/server/api.ts
 /**
@@ -121,17 +121,21 @@ const makeEndpoint = (path, method, handler) => ({
 	handler
 });
 /**
-* Build a typed `Endpoint`. `{name}` → required param; `{name?}` → optional param.
+* Build a typed `Endpoint`. `{name}` → required param (`string`); `{name:?}` →
+* optional param (`string | undefined`). The path template flows into each
+* handler's `ctx.params` ({@link PathParams}), so a required `{id}` is typed
+* `string` — no `?? ""` fallback needed.
 *
 * PURE factory (spec/03 §1): no ctx, no lifecycle, no side effects; safe to run
 * before `createApp`. Each verb method (`get`, `post`, …, `all`) returns the
 * truthful Endpoint value — `method: "ALL"` is never used as a `"get"` sentinel.
 *
-* @param path - Endpoint path, optionally with `{name}` / `{name?}` params.
+* @template Path - The path template literal, inferred from `path`.
+* @param path - Endpoint path, optionally with `{name}` / `{name:?}` params.
 * @returns A builder whose verb methods each return a typed `Endpoint`.
 * @example
 * ```typescript
-* endpoint("/api/data/{lang?}").get(({ params }) =>
+* endpoint("/api/data/{lang:?}").get(({ params }) =>
 *   Response.json({ lang: params.lang ?? "en" })
 * );
 * ```
@@ -232,27 +236,28 @@ const endpoint = (path) => ({
 const LITERAL_WEIGHT = 2;
 /** Specificity weight for a required param segment `{name}`. */
 const REQUIRED_PARAM_WEIGHT = 1;
-/** Specificity weight for an optional param segment `{name?}`. */
+/** Specificity weight for an optional param segment `{name:?}`. */
 const OPTIONAL_PARAM_WEIGHT = 0;
 /**
 * Parse one path segment string into a typed `PathSegment`.
 *
-* `{name}` → required param; `{name?}` → optional param; anything else → literal.
+* `{name}` → required param; `{name:?}` → optional param; anything else → literal.
+* The `:?` optional suffix matches the `@moku-labs/web` router pattern.
 *
 * @param raw - A single path segment token (no leading slash).
 * @returns The parsed `PathSegment`.
 * @example
 * ```typescript
-* parseSegment("{id}")  // → { value: "id", param: true, optional: false }
-* parseSegment("{id?}") // → { value: "id", param: true, optional: true }
-* parseSegment("api")   // → { value: "api", param: false, optional: false }
+* parseSegment("{id}")   // → { value: "id", param: true, optional: false }
+* parseSegment("{id:?}") // → { value: "id", param: true, optional: true }
+* parseSegment("api")    // → { value: "api", param: false, optional: false }
 * ```
 */
 const parseSegment = (raw) => {
 	if (raw.startsWith("{") && raw.endsWith("}")) {
 		const inner = raw.slice(1, -1);
-		if (inner.endsWith("?")) return {
-			value: inner.slice(0, -1),
+		if (inner.endsWith(":?")) return {
+			value: inner.slice(0, -2),
 			param: true,
 			optional: true
 		};
@@ -347,7 +352,7 @@ const tryMatchEndpoint = (compiled, method, tokens) => {
 * @example
 * ```typescript
 * const a = compileEndpoint(endpoint("/api/{id}").get(handler));   // specificity 3
-* const b = compileEndpoint(endpoint("/api/{id?}").get(handler));  // specificity 2
+* const b = compileEndpoint(endpoint("/api/{id:?}").get(handler));  // specificity 2
 * [b, a].sort(bySpecificityDesc); // → [a, b] — higher specificity first
 * ```
 */
@@ -390,10 +395,12 @@ const findBestMatch = (table, method, tokens) => {
 *
 * Called by `onInit` — the one-time per-isolate setup. Sorts `state.table` by
 * specificity (descending), validates that no endpoint path contains duplicate
-* `{param}` names, and sets `state.compiled = true` to guard re-entry.
+* `{param}` names or the retired `{name?}` optional syntax, and sets
+* `state.compiled = true` to guard re-entry.
 *
 * @param state - The mutable server state whose `table` should be compiled.
-* @throws {Error} With `[moku-worker]` prefix when a path has duplicate param names.
+* @throws {Error} With `[moku-worker]` prefix when a path has duplicate param
+*   names, or uses the old `{name?}` optional syntax (now `{name:?}`).
 * @example
 * ```typescript
 * // Called inside serverPlugin.onInit:
@@ -407,6 +414,10 @@ const compileServerState = (state) => {
 		const seen = /* @__PURE__ */ new Set();
 		for (const segment of compiled.segments) {
 			if (!segment.param) continue;
+			if (segment.value.endsWith("?")) {
+				const name = segment.value.slice(0, -1);
+				throw new Error(`[moku-worker] endpoint path "${compiled.endpoint.path}" uses the old optional-param syntax "{${segment.value}}".\n  Optional params now use the colon form (matching @moku-labs/web): write "{${name}:?}" instead of "{${name}?}".`);
+			}
 			if (seen.has(segment.value)) throw new Error(`[moku-worker] endpoint path "${compiled.endpoint.path}" has duplicate param "{${segment.value}}".\n  Each {param} name in a path must be unique.`);
 			seen.add(segment.value);
 		}
@@ -471,62 +482,8 @@ const serverPlugin = require_storage.createPlugin("server", {
 	},
 	helpers: { endpoint }
 });
-//#endregion
-//#region src/plugins/bindings/types.ts
-var types_exports = /* @__PURE__ */ require_storage.__exportAll({});
-//#endregion
-//#region src/plugins/d1/types.ts
-var types_exports$1 = /* @__PURE__ */ require_storage.__exportAll({});
-//#endregion
-//#region src/plugins/durable-objects/types.ts
-var types_exports$2 = /* @__PURE__ */ require_storage.__exportAll({});
-//#endregion
-//#region src/plugins/queues/types.ts
-var types_exports$3 = /* @__PURE__ */ require_storage.__exportAll({});
-//#endregion
-//#region src/plugins/server/types.ts
-var types_exports$4 = /* @__PURE__ */ require_storage.__exportAll({});
-//#endregion
-//#region src/plugins/storage/types.ts
-var types_exports$5 = /* @__PURE__ */ require_storage.__exportAll({});
 const { createApp, createPlugin } = require_storage.createCore(require_storage.coreConfig, { plugins: [require_storage.bindingsPlugin, serverPlugin] });
 //#endregion
-Object.defineProperty(exports, "Bindings", {
-	enumerable: true,
-	get: function() {
-		return types_exports;
-	}
-});
-Object.defineProperty(exports, "D1", {
-	enumerable: true,
-	get: function() {
-		return types_exports$1;
-	}
-});
-Object.defineProperty(exports, "DurableObjects", {
-	enumerable: true,
-	get: function() {
-		return types_exports$2;
-	}
-});
-Object.defineProperty(exports, "Queues", {
-	enumerable: true,
-	get: function() {
-		return types_exports$3;
-	}
-});
-Object.defineProperty(exports, "Server", {
-	enumerable: true,
-	get: function() {
-		return types_exports$4;
-	}
-});
-Object.defineProperty(exports, "Storage", {
-	enumerable: true,
-	get: function() {
-		return types_exports$5;
-	}
-});
 exports.bindingsPlugin = require_storage.bindingsPlugin;
 exports.createApp = createApp;
 exports.createPlugin = createPlugin;

package/dist/index.d.cts

@@ -64,19 +64,19 @@ type Context = PluginCtx<Config$4, Record<string, never>, WorkerEvents>;
  */
 declare const bindingsPlugin: import("@moku-labs/core").PluginInstance<"bindings", Config$4, Record<string, never>, BindingsApi, {}> & Record<never, never>;
 declare namespace types_d_exports$4 {
-  export { Api$3 as Api, CompiledEndpoint, Endpoint, EndpointHandler, MatchResult, Method, PathSegment, RequestContext, RequireFn, ServerConfig, ServerCtx, ServerEvents, ServerState };
+  export { Api$3 as Api, CompiledEndpoint, Endpoint, EndpointHandler, MatchResult, Method, PathParams, PathSegment, RequestContext, RequireFn, ServerConfig, ServerCtx, ServerEvents, ServerState };
 }
 /** HTTP method an endpoint matches; "ALL" matches any verb. */
 type Method = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "ALL";
-/** One parsed path segment: a literal, a required `{name}`, or an optional `{name?}`. */
+/** One parsed path segment: a literal, a required `{name}`, or an optional `{name:?}`. */
 type PathSegment = {
-  /** The literal text, or the param name when a param. */readonly value: string; /** Whether this segment is a `{name}` / `{name?}` parameter. */
-  readonly param: boolean; /** Whether the param is optional (`{name?}`). */
+  /** The literal text, or the param name when a param. */readonly value: string; /** Whether this segment is a `{name}` / `{name:?}` parameter. */
+  readonly param: boolean; /** Whether the param is optional (`{name:?}`). */
   readonly optional: boolean;
 };
 /** A declarative endpoint produced by the pure endpoint() builder. */
 type Endpoint = {
-  /** Endpoint path, optionally with `{name}` / `{name?}` params. */readonly path: string; /** HTTP method or "ALL". */
+  /** Endpoint path, optionally with `{name}` / `{name:?}` params. */readonly path: string; /** HTTP method or "ALL". */
   readonly method: Method; /** The handler invoked on a match. */
   readonly handler: EndpointHandler;
 };
@@ -125,14 +125,55 @@ type ApiOf<P> = P extends {
 } ? A : never;
 /** Cross-plugin reach used inside handlers: require(plugin) returns that plugin's API. Mirrors ctx.require. */
 type RequireFn = <P extends AnyPlugin>(plugin: P) => ApiOf<P>;
-/** A request handler: receives the per-request context, returns a Response. */
-type EndpointHandler = (ctx: RequestContext) => Response | Promise<Response>;
-/** Fresh per-request object threaded to each EndpointHandler. */
-type RequestContext = {
+/**
+ * Prettify an intersection into a single flat object type for readable hovers.
+ * Homomorphic mapped type — preserves each property's `?` optionality modifier.
+ */
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+/**
+ * Required param names in a path template, as a string union (`never` if none).
+ * Walks each `{...}` segment: collects a bare `{name}`, skips an optional `{name:?}`.
+ */
+type RequiredParamNames<Path extends string> = Path extends `${string}{${infer Rest}` ? Rest extends `${infer Body}}${infer Tail}` ? Body extends `${string}:?` ? RequiredParamNames<Tail> : Body | RequiredParamNames<Tail> : never : never;
+/**
+ * Optional param names in a path template with the `:?` suffix stripped, as a
+ * string union (`never` if none). Collects `{name:?}`, skips a bare `{name}`.
+ */
+type OptionalParamNames<Path extends string> = Path extends `${string}{${infer Rest}` ? Rest extends `${infer Body}}${infer Tail}` ? Body extends `${infer Name}:?` ? Name | OptionalParamNames<Tail> : OptionalParamNames<Tail> : never : never;
+/**
+ * Map a path template to its typed `params` object: a required `{name}` becomes
+ * `name: string`; an optional `{name:?}` becomes `name?: string`. A non-literal
+ * `string` path (e.g. one assembled at runtime) widens to the permissive
+ * `Record<string, string | undefined>`.
+ *
+ * @example
+ * ```typescript
+ * type P = PathParams<"/boards/{id}/data/{lang:?}">;
+ * // { id: string; lang?: string }
+ * ```
+ */
+type PathParams<Path extends string> = string extends Path ? Record<string, string | undefined> : Prettify<{ [K in RequiredParamNames<Path>]: string } & { [K in OptionalParamNames<Path>]?: string }>;
+/**
+ * A request handler: receives the per-request context, returns a Response.
+ *
+ * @template Params - Path-params shape, inferred by the `endpoint()` builder
+ *   from the path template ({@link PathParams}) — a required `{name}` is
+ *   `string`, an optional `{name:?}` is `string | undefined`. Defaults to the
+ *   permissive `Record<string, string | undefined>` for hand-written handler types.
+ */
+type EndpointHandler<Params = Record<string, string | undefined>> = (ctx: RequestContext<Params>) => Response | Promise<Response>;
+/**
+ * Fresh per-request object threaded to each EndpointHandler.
+ *
+ * @template Params - Path-params shape for `params`, inferred from the path
+ *   template by the `endpoint()` builder ({@link PathParams}). Defaults to the
+ *   permissive `Record<string, string | undefined>`.
+ */
+type RequestContext<Params = Record<string, string | undefined>> = {
   /** The incoming request. */readonly request: Request; /** Per-request Cloudflare bindings — threaded on the stack, NEVER stored in state. */
   readonly env: WorkerEnv; /** waitUntil / passThroughOnException. */
-  readonly exec: ExecutionContext; /** Path params extracted from the matched endpoint. */
-  readonly params: Record<string, string | undefined>; /** Parsed request URL. */
+  readonly exec: ExecutionContext; /** Path params extracted from the matched endpoint, typed from the path template. */
+  readonly params: Params; /** Parsed request URL. */
   readonly url: URL; /** Cross-plugin reach for handlers (e.g. require(bindingsPlugin)). */
   readonly require: RequireFn; /** Presence check for an optional plugin. */
   readonly has: (name: string) => boolean;
@@ -175,12 +216,14 @@ type Api$3 = {
 /**
  * Fluent builder whose verb methods each return a typed `Endpoint`.
  *
+ * @template Path - The path template literal, used to infer each handler's
+ *   typed `ctx.params` ({@link PathParams}).
  * @example
  * ```typescript
- * const e = endpoint("/api/{id}").get(handler);
+ * const e = endpoint("/api/{id}").get(({ params }) => Response.json({ id: params.id }));
  * ```
  */
-type EndpointBuilder = {
+type EndpointBuilder<Path extends string> = {
   /**
    * Build a GET endpoint bound to this path.
    *
@@ -191,7 +234,7 @@ type EndpointBuilder = {
    * endpoint("/health").get(() => new Response("ok"));
    * ```
    */
-  get(handler: EndpointHandler): Endpoint;
+  get(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a POST endpoint bound to this path.
    *
@@ -202,7 +245,7 @@ type EndpointBuilder = {
    * endpoint("/users").post(({ request }) => Response.json({ created: true }, { status: 201 }));
    * ```
    */
-  post(handler: EndpointHandler): Endpoint;
+  post(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a PUT endpoint bound to this path.
    *
@@ -213,7 +256,7 @@ type EndpointBuilder = {
    * endpoint("/users/{id}").put(({ params }) => Response.json({ updated: params.id }));
    * ```
    */
-  put(handler: EndpointHandler): Endpoint;
+  put(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a PATCH endpoint bound to this path.
    *
@@ -224,7 +267,7 @@ type EndpointBuilder = {
    * endpoint("/users/{id}").patch(({ params }) => Response.json({ patched: params.id }));
    * ```
    */
-  patch(handler: EndpointHandler): Endpoint;
+  patch(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a DELETE endpoint bound to this path.
    *
@@ -235,7 +278,7 @@ type EndpointBuilder = {
    * endpoint("/users/{id}").delete(() => new Response(null, { status: 204 }));
    * ```
    */
-  delete(handler: EndpointHandler): Endpoint;
+  delete(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a HEAD endpoint bound to this path.
    *
@@ -246,7 +289,7 @@ type EndpointBuilder = {
    * endpoint("/health").head(() => new Response(null, { status: 200 }));
    * ```
    */
-  head(handler: EndpointHandler): Endpoint;
+  head(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build an OPTIONS endpoint bound to this path.
    *
@@ -257,7 +300,7 @@ type EndpointBuilder = {
    * endpoint("/api").options(() => new Response(null, { headers: { Allow: "GET, POST" } }));
    * ```
    */
-  options(handler: EndpointHandler): Endpoint;
+  options(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build an ALL-method endpoint bound to this path (`method: "ALL"` — matches any verb).
    *
@@ -268,25 +311,29 @@ type EndpointBuilder = {
    * endpoint("0 * * * *").all(async () => new Response("cron done"));
    * ```
    */
-  all(handler: EndpointHandler): Endpoint;
+  all(handler: EndpointHandler<PathParams<Path>>): Endpoint;
 };
 /**
- * Build a typed `Endpoint`. `{name}` → required param; `{name?}` → optional param.
+ * Build a typed `Endpoint`. `{name}` → required param (`string`); `{name:?}` →
+ * optional param (`string | undefined`). The path template flows into each
+ * handler's `ctx.params` ({@link PathParams}), so a required `{id}` is typed
+ * `string` — no `?? ""` fallback needed.
  *
  * PURE factory (spec/03 §1): no ctx, no lifecycle, no side effects; safe to run
  * before `createApp`. Each verb method (`get`, `post`, …, `all`) returns the
  * truthful Endpoint value — `method: "ALL"` is never used as a `"get"` sentinel.
  *
- * @param path - Endpoint path, optionally with `{name}` / `{name?}` params.
+ * @template Path - The path template literal, inferred from `path`.
+ * @param path - Endpoint path, optionally with `{name}` / `{name:?}` params.
  * @returns A builder whose verb methods each return a typed `Endpoint`.
  * @example
  * ```typescript
- * endpoint("/api/data/{lang?}").get(({ params }) =>
+ * endpoint("/api/data/{lang:?}").get(({ params }) =>
  *   Response.json({ lang: params.lang ?? "en" })
  * );
  * ```
  */
-declare const endpoint: (path: string) => EndpointBuilder;
+declare const endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
 declare namespace types_d_exports$1 {
   export { Api$2 as Api, Config$3 as Config, D1Ctx, DeployManifest$2 as DeployManifest };
 }
@@ -442,8 +489,19 @@ type Api$1 = {
    */
   deployManifest(): DeployManifest$1;
 };
-/** Internal context type — own config first, no state, no DO events. */
-type Ctx$1 = PluginCtx<Config$2, Record<string, never>, WorkerEvents>;
+/**
+ * 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> & {
+  /**
+   * Resolve a dependency plugin's api. durableObjects only ever resolves `bindingsPlugin`.
+   *
+   * @param plugin - The bindingsPlugin instance.
+   * @returns The resolved bindings api.
+   */
+  require(plugin: typeof bindingsPlugin): BindingsApi;
+};
 //#endregion
 //#region src/plugins/durable-objects/helpers.d.ts
 /**
@@ -691,6 +749,8 @@ type Ctx = PluginCtx<Config$1, Record<string, never>, WorkerEvents & QueueEvents
  * `events` is declared first and via `register.map<QueueEvents>` so the plugin's own events infer
  * into the factory context; the api wiring is therefore arrow-wrapped (contextually typed).
  *
+ * Emits the plugin-local `queue:message` event after each consumed message.
+ *
  * @see README.md
  */
 declare const queuesPlugin: import("@moku-labs/core").PluginInstance<"queues", Config$1, Record<string, never>, {
@@ -722,7 +782,7 @@ declare const serverPlugin: import("@moku-labs/core").PluginInstance<"server", S
     method: string;
   };
 }> & {
-  endpoint: (path: string) => EndpointBuilder;
+  endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
 };
 //#endregion
 //#region src/plugins/storage/providers/types.d.ts
@@ -940,7 +1000,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
       method: string;
     };
   }> & {
-    endpoint: (path: string) => EndpointBuilder;
+    endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
   }) | ExtraPlugins[number], [...ExtraPlugins], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common").LogConfig, import("@moku-labs/common").LogState, import("@moku-labs/common").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common").EnvConfig, import("@moku-labs/common").EnvState, import("@moku-labs/common").EnvApi>, import("@moku-labs/core").CorePluginInstance<"stage", {
     stage: "production" | "development" | "test";
   }, Record<string, never>, {
@@ -953,7 +1013,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
       method: string;
     };
   }> & {
-    endpoint: (path: string) => EndpointBuilder;
+    endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
   }) | ExtraPlugins[number], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common").LogConfig, import("@moku-labs/common").LogState, import("@moku-labs/common").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common").EnvConfig, import("@moku-labs/common").EnvState, import("@moku-labs/common").EnvApi>, import("@moku-labs/core").CorePluginInstance<"stage", {
     stage: "production" | "development" | "test";
   }, Record<string, never>, {
@@ -968,4 +1028,4 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     current: () => "production" | "development" | "test";
   }>]>>;
 //#endregion
-export { types_d_exports as Bindings, types_d_exports$1 as D1, types_d_exports$2 as DurableObjects, types_d_exports$3 as Queues, types_d_exports$4 as Server, type StageApi, 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 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 };

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { n as WorkerEnv, r as WorkerEvents, t as WorkerConfig } from "./config-A
 import { envPlugin, logPlugin } from "@moku-labs/common";
 import { PluginCtx, PluginInstance } from "@moku-labs/core";
 
-//#region src/plugins/bindings/types.d.ts
+//#region \0rolldown/runtime.js
 declare namespace types_d_exports {
   export { BindingsApi, Config$4 as Config, Context };
 }
@@ -64,19 +64,19 @@ type Context = PluginCtx<Config$4, Record<string, never>, WorkerEvents>;
  */
 declare const bindingsPlugin: import("@moku-labs/core").PluginInstance<"bindings", Config$4, Record<string, never>, BindingsApi, {}> & Record<never, never>;
 declare namespace types_d_exports$4 {
-  export { Api$3 as Api, CompiledEndpoint, Endpoint, EndpointHandler, MatchResult, Method, PathSegment, RequestContext, RequireFn, ServerConfig, ServerCtx, ServerEvents, ServerState };
+  export { Api$3 as Api, CompiledEndpoint, Endpoint, EndpointHandler, MatchResult, Method, PathParams, PathSegment, RequestContext, RequireFn, ServerConfig, ServerCtx, ServerEvents, ServerState };
 }
 /** HTTP method an endpoint matches; "ALL" matches any verb. */
 type Method = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS" | "ALL";
-/** One parsed path segment: a literal, a required `{name}`, or an optional `{name?}`. */
+/** One parsed path segment: a literal, a required `{name}`, or an optional `{name:?}`. */
 type PathSegment = {
-  /** The literal text, or the param name when a param. */readonly value: string; /** Whether this segment is a `{name}` / `{name?}` parameter. */
-  readonly param: boolean; /** Whether the param is optional (`{name?}`). */
+  /** The literal text, or the param name when a param. */readonly value: string; /** Whether this segment is a `{name}` / `{name:?}` parameter. */
+  readonly param: boolean; /** Whether the param is optional (`{name:?}`). */
   readonly optional: boolean;
 };
 /** A declarative endpoint produced by the pure endpoint() builder. */
 type Endpoint = {
-  /** Endpoint path, optionally with `{name}` / `{name?}` params. */readonly path: string; /** HTTP method or "ALL". */
+  /** Endpoint path, optionally with `{name}` / `{name:?}` params. */readonly path: string; /** HTTP method or "ALL". */
   readonly method: Method; /** The handler invoked on a match. */
   readonly handler: EndpointHandler;
 };
@@ -125,14 +125,55 @@ type ApiOf<P> = P extends {
 } ? A : never;
 /** Cross-plugin reach used inside handlers: require(plugin) returns that plugin's API. Mirrors ctx.require. */
 type RequireFn = <P extends AnyPlugin>(plugin: P) => ApiOf<P>;
-/** A request handler: receives the per-request context, returns a Response. */
-type EndpointHandler = (ctx: RequestContext) => Response | Promise<Response>;
-/** Fresh per-request object threaded to each EndpointHandler. */
-type RequestContext = {
+/**
+ * Prettify an intersection into a single flat object type for readable hovers.
+ * Homomorphic mapped type — preserves each property's `?` optionality modifier.
+ */
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+/**
+ * Required param names in a path template, as a string union (`never` if none).
+ * Walks each `{...}` segment: collects a bare `{name}`, skips an optional `{name:?}`.
+ */
+type RequiredParamNames<Path extends string> = Path extends `${string}{${infer Rest}` ? Rest extends `${infer Body}}${infer Tail}` ? Body extends `${string}:?` ? RequiredParamNames<Tail> : Body | RequiredParamNames<Tail> : never : never;
+/**
+ * Optional param names in a path template with the `:?` suffix stripped, as a
+ * string union (`never` if none). Collects `{name:?}`, skips a bare `{name}`.
+ */
+type OptionalParamNames<Path extends string> = Path extends `${string}{${infer Rest}` ? Rest extends `${infer Body}}${infer Tail}` ? Body extends `${infer Name}:?` ? Name | OptionalParamNames<Tail> : OptionalParamNames<Tail> : never : never;
+/**
+ * Map a path template to its typed `params` object: a required `{name}` becomes
+ * `name: string`; an optional `{name:?}` becomes `name?: string`. A non-literal
+ * `string` path (e.g. one assembled at runtime) widens to the permissive
+ * `Record<string, string | undefined>`.
+ *
+ * @example
+ * ```typescript
+ * type P = PathParams<"/boards/{id}/data/{lang:?}">;
+ * // { id: string; lang?: string }
+ * ```
+ */
+type PathParams<Path extends string> = string extends Path ? Record<string, string | undefined> : Prettify<{ [K in RequiredParamNames<Path>]: string } & { [K in OptionalParamNames<Path>]?: string }>;
+/**
+ * A request handler: receives the per-request context, returns a Response.
+ *
+ * @template Params - Path-params shape, inferred by the `endpoint()` builder
+ *   from the path template ({@link PathParams}) — a required `{name}` is
+ *   `string`, an optional `{name:?}` is `string | undefined`. Defaults to the
+ *   permissive `Record<string, string | undefined>` for hand-written handler types.
+ */
+type EndpointHandler<Params = Record<string, string | undefined>> = (ctx: RequestContext<Params>) => Response | Promise<Response>;
+/**
+ * Fresh per-request object threaded to each EndpointHandler.
+ *
+ * @template Params - Path-params shape for `params`, inferred from the path
+ *   template by the `endpoint()` builder ({@link PathParams}). Defaults to the
+ *   permissive `Record<string, string | undefined>`.
+ */
+type RequestContext<Params = Record<string, string | undefined>> = {
   /** The incoming request. */readonly request: Request; /** Per-request Cloudflare bindings — threaded on the stack, NEVER stored in state. */
   readonly env: WorkerEnv; /** waitUntil / passThroughOnException. */
-  readonly exec: ExecutionContext; /** Path params extracted from the matched endpoint. */
-  readonly params: Record<string, string | undefined>; /** Parsed request URL. */
+  readonly exec: ExecutionContext; /** Path params extracted from the matched endpoint, typed from the path template. */
+  readonly params: Params; /** Parsed request URL. */
   readonly url: URL; /** Cross-plugin reach for handlers (e.g. require(bindingsPlugin)). */
   readonly require: RequireFn; /** Presence check for an optional plugin. */
   readonly has: (name: string) => boolean;
@@ -175,12 +216,14 @@ type Api$3 = {
 /**
  * Fluent builder whose verb methods each return a typed `Endpoint`.
  *
+ * @template Path - The path template literal, used to infer each handler's
+ *   typed `ctx.params` ({@link PathParams}).
  * @example
  * ```typescript
- * const e = endpoint("/api/{id}").get(handler);
+ * const e = endpoint("/api/{id}").get(({ params }) => Response.json({ id: params.id }));
  * ```
  */
-type EndpointBuilder = {
+type EndpointBuilder<Path extends string> = {
   /**
    * Build a GET endpoint bound to this path.
    *
@@ -191,7 +234,7 @@ type EndpointBuilder = {
    * endpoint("/health").get(() => new Response("ok"));
    * ```
    */
-  get(handler: EndpointHandler): Endpoint;
+  get(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a POST endpoint bound to this path.
    *
@@ -202,7 +245,7 @@ type EndpointBuilder = {
    * endpoint("/users").post(({ request }) => Response.json({ created: true }, { status: 201 }));
    * ```
    */
-  post(handler: EndpointHandler): Endpoint;
+  post(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a PUT endpoint bound to this path.
    *
@@ -213,7 +256,7 @@ type EndpointBuilder = {
    * endpoint("/users/{id}").put(({ params }) => Response.json({ updated: params.id }));
    * ```
    */
-  put(handler: EndpointHandler): Endpoint;
+  put(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a PATCH endpoint bound to this path.
    *
@@ -224,7 +267,7 @@ type EndpointBuilder = {
    * endpoint("/users/{id}").patch(({ params }) => Response.json({ patched: params.id }));
    * ```
    */
-  patch(handler: EndpointHandler): Endpoint;
+  patch(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a DELETE endpoint bound to this path.
    *
@@ -235,7 +278,7 @@ type EndpointBuilder = {
    * endpoint("/users/{id}").delete(() => new Response(null, { status: 204 }));
    * ```
    */
-  delete(handler: EndpointHandler): Endpoint;
+  delete(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build a HEAD endpoint bound to this path.
    *
@@ -246,7 +289,7 @@ type EndpointBuilder = {
    * endpoint("/health").head(() => new Response(null, { status: 200 }));
    * ```
    */
-  head(handler: EndpointHandler): Endpoint;
+  head(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build an OPTIONS endpoint bound to this path.
    *
@@ -257,7 +300,7 @@ type EndpointBuilder = {
    * endpoint("/api").options(() => new Response(null, { headers: { Allow: "GET, POST" } }));
    * ```
    */
-  options(handler: EndpointHandler): Endpoint;
+  options(handler: EndpointHandler<PathParams<Path>>): Endpoint;
   /**
    * Build an ALL-method endpoint bound to this path (`method: "ALL"` — matches any verb).
    *
@@ -268,25 +311,29 @@ type EndpointBuilder = {
    * endpoint("0 * * * *").all(async () => new Response("cron done"));
    * ```
    */
-  all(handler: EndpointHandler): Endpoint;
+  all(handler: EndpointHandler<PathParams<Path>>): Endpoint;
 };
 /**
- * Build a typed `Endpoint`. `{name}` → required param; `{name?}` → optional param.
+ * Build a typed `Endpoint`. `{name}` → required param (`string`); `{name:?}` →
+ * optional param (`string | undefined`). The path template flows into each
+ * handler's `ctx.params` ({@link PathParams}), so a required `{id}` is typed
+ * `string` — no `?? ""` fallback needed.
  *
  * PURE factory (spec/03 §1): no ctx, no lifecycle, no side effects; safe to run
  * before `createApp`. Each verb method (`get`, `post`, …, `all`) returns the
  * truthful Endpoint value — `method: "ALL"` is never used as a `"get"` sentinel.
  *
- * @param path - Endpoint path, optionally with `{name}` / `{name?}` params.
+ * @template Path - The path template literal, inferred from `path`.
+ * @param path - Endpoint path, optionally with `{name}` / `{name:?}` params.
  * @returns A builder whose verb methods each return a typed `Endpoint`.
  * @example
  * ```typescript
- * endpoint("/api/data/{lang?}").get(({ params }) =>
+ * endpoint("/api/data/{lang:?}").get(({ params }) =>
  *   Response.json({ lang: params.lang ?? "en" })
  * );
  * ```
  */
-declare const endpoint: (path: string) => EndpointBuilder;
+declare const endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
 declare namespace types_d_exports$1 {
   export { Api$2 as Api, Config$3 as Config, D1Ctx, DeployManifest$2 as DeployManifest };
 }
@@ -442,8 +489,19 @@ type Api$1 = {
    */
   deployManifest(): DeployManifest$1;
 };
-/** Internal context type — own config first, no state, no DO events. */
-type Ctx$1 = PluginCtx<Config$2, Record<string, never>, WorkerEvents>;
+/**
+ * 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> & {
+  /**
+   * Resolve a dependency plugin's api. durableObjects only ever resolves `bindingsPlugin`.
+   *
+   * @param plugin - The bindingsPlugin instance.
+   * @returns The resolved bindings api.
+   */
+  require(plugin: typeof bindingsPlugin): BindingsApi;
+};
 //#endregion
 //#region src/plugins/durable-objects/helpers.d.ts
 /**
@@ -691,6 +749,8 @@ type Ctx = PluginCtx<Config$1, Record<string, never>, WorkerEvents & QueueEvents
  * `events` is declared first and via `register.map<QueueEvents>` so the plugin's own events infer
  * into the factory context; the api wiring is therefore arrow-wrapped (contextually typed).
  *
+ * Emits the plugin-local `queue:message` event after each consumed message.
+ *
  * @see README.md
  */
 declare const queuesPlugin: import("@moku-labs/core").PluginInstance<"queues", Config$1, Record<string, never>, {
@@ -722,7 +782,7 @@ declare const serverPlugin: import("@moku-labs/core").PluginInstance<"server", S
     method: string;
   };
 }> & {
-  endpoint: (path: string) => EndpointBuilder;
+  endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
 };
 //#endregion
 //#region src/plugins/storage/providers/types.d.ts
@@ -940,7 +1000,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
       method: string;
     };
   }> & {
-    endpoint: (path: string) => EndpointBuilder;
+    endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
   }) | ExtraPlugins[number], [...ExtraPlugins], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common").LogConfig, import("@moku-labs/common").LogState, import("@moku-labs/common").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common").EnvConfig, import("@moku-labs/common").EnvState, import("@moku-labs/common").EnvApi>, import("@moku-labs/core").CorePluginInstance<"stage", {
     stage: "production" | "development" | "test";
   }, Record<string, never>, {
@@ -953,7 +1013,7 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
       method: string;
     };
   }> & {
-    endpoint: (path: string) => EndpointBuilder;
+    endpoint: <Path extends string>(path: Path) => EndpointBuilder<Path>;
   }) | ExtraPlugins[number], import("@moku-labs/core").CoreApisFromTuple<[import("@moku-labs/core").CorePluginInstance<"log", import("@moku-labs/common").LogConfig, import("@moku-labs/common").LogState, import("@moku-labs/common").LogApi>, import("@moku-labs/core").CorePluginInstance<"env", import("@moku-labs/common").EnvConfig, import("@moku-labs/common").EnvState, import("@moku-labs/common").EnvApi>, import("@moku-labs/core").CorePluginInstance<"stage", {
     stage: "production" | "development" | "test";
   }, Record<string, never>, {
@@ -968,4 +1028,4 @@ declare const createApp: <const ExtraPlugins extends readonly import("@moku-labs
     current: () => "production" | "development" | "test";
   }>]>>;
 //#endregion
-export { types_d_exports as Bindings, types_d_exports$1 as D1, types_d_exports$2 as DurableObjects, types_d_exports$3 as Queues, types_d_exports$4 as Server, type StageApi, 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 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 };

package/dist/index.mjs

@@ -1,5 +1,4 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-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-DCOQ4EAg.mjs";
+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 { envPlugin, logPlugin } from "@moku-labs/common";
 //#region src/plugins/server/api.ts
 /**
@@ -121,17 +120,21 @@ const makeEndpoint = (path, method, handler) => ({
 	handler
 });
 /**
-* Build a typed `Endpoint`. `{name}` → required param; `{name?}` → optional param.
+* Build a typed `Endpoint`. `{name}` → required param (`string`); `{name:?}` →
+* optional param (`string | undefined`). The path template flows into each
+* handler's `ctx.params` ({@link PathParams}), so a required `{id}` is typed
+* `string` — no `?? ""` fallback needed.
 *
 * PURE factory (spec/03 §1): no ctx, no lifecycle, no side effects; safe to run
 * before `createApp`. Each verb method (`get`, `post`, …, `all`) returns the
 * truthful Endpoint value — `method: "ALL"` is never used as a `"get"` sentinel.
 *
-* @param path - Endpoint path, optionally with `{name}` / `{name?}` params.
+* @template Path - The path template literal, inferred from `path`.
+* @param path - Endpoint path, optionally with `{name}` / `{name:?}` params.
 * @returns A builder whose verb methods each return a typed `Endpoint`.
 * @example
 * ```typescript
-* endpoint("/api/data/{lang?}").get(({ params }) =>
+* endpoint("/api/data/{lang:?}").get(({ params }) =>
 *   Response.json({ lang: params.lang ?? "en" })
 * );
 * ```
@@ -232,27 +235,28 @@ const endpoint = (path) => ({
 const LITERAL_WEIGHT = 2;
 /** Specificity weight for a required param segment `{name}`. */
 const REQUIRED_PARAM_WEIGHT = 1;
-/** Specificity weight for an optional param segment `{name?}`. */
+/** Specificity weight for an optional param segment `{name:?}`. */
 const OPTIONAL_PARAM_WEIGHT = 0;
 /**
 * Parse one path segment string into a typed `PathSegment`.
 *
-* `{name}` → required param; `{name?}` → optional param; anything else → literal.
+* `{name}` → required param; `{name:?}` → optional param; anything else → literal.
+* The `:?` optional suffix matches the `@moku-labs/web` router pattern.
 *
 * @param raw - A single path segment token (no leading slash).
 * @returns The parsed `PathSegment`.
 * @example
 * ```typescript
-* parseSegment("{id}")  // → { value: "id", param: true, optional: false }
-* parseSegment("{id?}") // → { value: "id", param: true, optional: true }
-* parseSegment("api")   // → { value: "api", param: false, optional: false }
+* parseSegment("{id}")   // → { value: "id", param: true, optional: false }
+* parseSegment("{id:?}") // → { value: "id", param: true, optional: true }
+* parseSegment("api")    // → { value: "api", param: false, optional: false }
 * ```
 */
 const parseSegment = (raw) => {
 	if (raw.startsWith("{") && raw.endsWith("}")) {
 		const inner = raw.slice(1, -1);
-		if (inner.endsWith("?")) return {
-			value: inner.slice(0, -1),
+		if (inner.endsWith(":?")) return {
+			value: inner.slice(0, -2),
 			param: true,
 			optional: true
 		};
@@ -347,7 +351,7 @@ const tryMatchEndpoint = (compiled, method, tokens) => {
 * @example
 * ```typescript
 * const a = compileEndpoint(endpoint("/api/{id}").get(handler));   // specificity 3
-* const b = compileEndpoint(endpoint("/api/{id?}").get(handler));  // specificity 2
+* const b = compileEndpoint(endpoint("/api/{id:?}").get(handler));  // specificity 2
 * [b, a].sort(bySpecificityDesc); // → [a, b] — higher specificity first
 * ```
 */
@@ -390,10 +394,12 @@ const findBestMatch = (table, method, tokens) => {
 *
 * Called by `onInit` — the one-time per-isolate setup. Sorts `state.table` by
 * specificity (descending), validates that no endpoint path contains duplicate
-* `{param}` names, and sets `state.compiled = true` to guard re-entry.
+* `{param}` names or the retired `{name?}` optional syntax, and sets
+* `state.compiled = true` to guard re-entry.
 *
 * @param state - The mutable server state whose `table` should be compiled.
-* @throws {Error} With `[moku-worker]` prefix when a path has duplicate param names.
+* @throws {Error} With `[moku-worker]` prefix when a path has duplicate param
+*   names, or uses the old `{name?}` optional syntax (now `{name:?}`).
 * @example
 * ```typescript
 * // Called inside serverPlugin.onInit:
@@ -407,6 +413,10 @@ const compileServerState = (state) => {
 		const seen = /* @__PURE__ */ new Set();
 		for (const segment of compiled.segments) {
 			if (!segment.param) continue;
+			if (segment.value.endsWith("?")) {
+				const name = segment.value.slice(0, -1);
+				throw new Error(`[moku-worker] endpoint path "${compiled.endpoint.path}" uses the old optional-param syntax "{${segment.value}}".\n  Optional params now use the colon form (matching @moku-labs/web): write "{${name}:?}" instead of "{${name}?}".`);
+			}
 			if (seen.has(segment.value)) throw new Error(`[moku-worker] endpoint path "${compiled.endpoint.path}" has duplicate param "{${segment.value}}".\n  Each {param} name in a path must be unique.`);
 			seen.add(segment.value);
 		}
@@ -471,24 +481,6 @@ const serverPlugin = createPlugin$1("server", {
 	},
 	helpers: { endpoint }
 });
-//#endregion
-//#region src/plugins/bindings/types.ts
-var types_exports = /* @__PURE__ */ __exportAll({});
-//#endregion
-//#region src/plugins/d1/types.ts
-var types_exports$1 = /* @__PURE__ */ __exportAll({});
-//#endregion
-//#region src/plugins/durable-objects/types.ts
-var types_exports$2 = /* @__PURE__ */ __exportAll({});
-//#endregion
-//#region src/plugins/queues/types.ts
-var types_exports$3 = /* @__PURE__ */ __exportAll({});
-//#endregion
-//#region src/plugins/server/types.ts
-var types_exports$4 = /* @__PURE__ */ __exportAll({});
-//#endregion
-//#region src/plugins/storage/types.ts
-var types_exports$5 = /* @__PURE__ */ __exportAll({});
 const { createApp, createPlugin } = createCore(coreConfig, { plugins: [bindingsPlugin, serverPlugin] });
 //#endregion
-export { types_exports as Bindings, types_exports$1 as D1, types_exports$2 as DurableObjects, types_exports$3 as Queues, types_exports$4 as Server, types_exports$5 as Storage, bindingsPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };
+export { bindingsPlugin, createApp, createPlugin, d1Plugin, defineDurableObject, durableObjectsPlugin, endpoint, envPlugin, kvPlugin, logPlugin, queuesPlugin, serverPlugin, stagePlugin, storagePlugin };

package/dist/{storage-DCOQ4EAg.mjs → storage-COo-F38H.mjs}

@@ -661,6 +661,8 @@ const createQueuesApi = (ctx) => {
 * `events` is declared first and via `register.map<QueueEvents>` so the plugin's own events infer
 * into the factory context; the api wiring is therefore arrow-wrapped (contextually typed).
 *
+* Emits the plugin-local `queue:message` event after each consumed message.
+*
 * @see README.md
 */
 const queuesPlugin = createPlugin("queues", {

package/dist/{storage-Sy--rX1T.cjs → storage-CgXl-dUA.cjs}

@@ -1,34 +1,3 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
 let _moku_labs_common = require("@moku-labs/common");
 let _moku_labs_core = require("@moku-labs/core");
 /**
@@ -692,6 +661,8 @@ const createQueuesApi = (ctx) => {
 * `events` is declared first and via `register.map<QueueEvents>` so the plugin's own events infer
 * into the factory context; the api wiring is therefore arrow-wrapped (contextually typed).
 *
+* Emits the plugin-local `queue:message` event after each consumed message.
+*
 * @see README.md
 */
 const queuesPlugin = createPlugin("queues", {
@@ -910,18 +881,6 @@ const storagePlugin = createPlugin("storage", {
 	api: createStorageApi
 });
 //#endregion
-Object.defineProperty(exports, "__exportAll", {
-	enumerable: true,
-	get: function() {
-		return __exportAll;
-	}
-});
-Object.defineProperty(exports, "__toESM", {
-	enumerable: true,
-	get: function() {
-		return __toESM;
-	}
-});
 Object.defineProperty(exports, "bindingsPlugin", {
 	enumerable: true,
 	get: function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/worker",
-  "version": "0.1.3",
+  "version": "0.2.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/rolldown-runtime-D7D4PA-g.mjs

@@ -1,13 +0,0 @@
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
-export { __exportAll as t };