@moku-labs/worker 0.7.2 → 0.8.0

package/dist/{cli-D8UmSqh4.mjs → cli-By06KF-9.mjs}

@@ -739,7 +739,8 @@ const createQueuesApi = (ctx) => {
 			kind: "queue",
 			name: instance.name,
 			binding: instance.binding,
-			...instance.onMessage ? { consumer: true } : {}
+			...instance.onMessage ? { consumer: true } : {},
+			...instance.maxBatchTimeout === void 0 ? {} : { maxBatchTimeout: instance.maxBatchTimeout }
 		}))
 	};
 };
@@ -2185,6 +2186,57 @@ const renderProvisionResult = (ui, result) => {
 		}
 	}
 };
+/**
+* Format an elapsed duration compactly: sub-second as `820ms`, otherwise one-decimal seconds (`4.2s`),
+* and minutes once it crosses 60s (`1m04s`) so a long deploy stays readable.
+*
+* @param ms - The elapsed milliseconds.
+* @returns The compact duration string.
+* @example
+* ```ts
+* formatDuration(4234); // "4.2s"
+* ```
+*/
+const formatDuration = (ms) => {
+	if (ms < 1e3) return `${String(ms)}ms`;
+	const seconds = ms / 1e3;
+	if (seconds < 60) return `${seconds.toFixed(1)}s`;
+	const whole = Math.floor(seconds);
+	return `${String(Math.floor(whole / 60))}m${String(whole % 60).padStart(2, "0")}s`;
+};
+/**
+* Render the terminal deploy summary as a branded panel — the headline the user actually wants. The
+* live URL leads on its own line (pink, so it is the first thing the eye lands on), then a dim
+* key/value block: the target stage, the resource tally (with a red `failed` count when non-zero),
+* and the wall-clock time the whole deploy took. Replaces the prior single `deployed → url` line.
+*
+* @param ui - The branded console to render through.
+* @param summary - The deploy summary fields.
+* @param summary.url - The live deployed URL (the panel headline).
+* @param summary.stage - The target stage the worker deployed to.
+* @param summary.created - How many resources were created this run.
+* @param summary.exists - How many resources already existed (skipped).
+* @param summary.failed - How many resources failed to provision.
+* @param summary.elapsedMs - The wall-clock deploy duration in milliseconds.
+* @example
+* ```ts
+* renderDeploySummary(ui, { url, stage: "production", created: 0, exists: 5, failed: 0, elapsedMs: 4234 });
+* ```
+*/
+const renderDeploySummary = (ui, summary) => {
+	const { palette } = ui;
+	const tally = `${String(summary.exists)} exist · ${String(summary.created)} created`;
+	const failedLabel = palette.red(`${String(summary.failed)} failed`);
+	const resources = summary.failed > 0 ? `${tally} · ${failedLabel}` : tally;
+	ui.heading("Deployed");
+	ui.box([
+		palette.pink(summary.url),
+		"",
+		`${palette.dim("stage".padEnd(10))}${summary.stage}`,
+		`${palette.dim("resources".padEnd(10))}${resources}`,
+		`${palette.dim("took".padEnd(10))}${formatDuration(summary.elapsedMs)}`
+	]);
+};
 //#endregion
 //#region src/plugins/deploy/naming.ts
 /**
@@ -2560,13 +2612,14 @@ const buildD1Databases = (resources, ids) => resources.filter((resource) => reso
 * Every queue is a `producer`; a queue flagged `consumer: true` (it declares an `onMessage` handler)
 * is ALSO registered as a `consumer` so wrangler delivers its messages to this Worker's queue()
 * handler — both locally under `wrangler dev` and in production. Without the consumer entry the
-* handler never runs (the bug that silently drops a queue-driven activity feed).
+* handler never runs (the bug that silently drops a queue-driven activity feed). A consumer that
+* sets `maxBatchTimeout` carries it through as wrangler's `max_batch_timeout` (lower delivery latency).
 *
 * @param resources - All resource descriptors from the manifest.
 * @returns The queues section (producers, plus consumers when any), or undefined when there are none.
 * @example
 * ```ts
-* const q = buildQueues([{ kind: "queue", name: "tracker-activity", binding: "ACTIVITY", consumer: true }]);
+* const q = buildQueues([{ kind: "queue", name: "tracker-activity", binding: "ACTIVITY", consumer: true, maxBatchTimeout: 1 }]);
 * ```
 */
 const buildQueues = (resources) => {
@@ -2576,7 +2629,11 @@ const buildQueues = (resources) => {
 		queue: resource.name,
 		binding: resource.binding
 	}));
-	const consumers = queueResources.filter((resource) => resource.consumer === true).map((resource) => ({ queue: resource.name }));
+	const consumers = queueResources.filter((resource) => resource.consumer === true).map((resource) => {
+		const entry = { queue: resource.name };
+		if (resource.maxBatchTimeout !== void 0) entry.max_batch_timeout = resource.maxBatchTimeout;
+		return entry;
+	});
 	return consumers.length > 0 ? {
 		producers,
 		consumers
@@ -3065,29 +3122,31 @@ const guidedUpload = async (ctx, manifest, deps) => {
 };
 /**
 * The final deploy step: confirm the target (guided only), run `wrangler deploy` with interactive
-* retry, then emit deploy:complete. Resolves false when the target gate or a deploy retry is declined.
+* retry, then emit deploy:complete. Returns the deployed URL, or undefined when the target gate or a
+* deploy retry is declined (so the caller renders the summary panel only on a real success).
 *
 * @param ctx - The deploy plugin context.
 * @param manifest - The assembled (or caller-supplied) deploy manifest.
 * @param stage - The resolved deploy stage (for the confirm prompt).
 * @param deps - Interactivity + the confirm prompt.
-* @returns True once deployed; false when the user declined the gate or a retry (abort).
+* @returns The deployed URL once live; undefined when the user declined the gate or a retry (abort).
 * @example
 * ```ts
-* if (!(await guidedDeployStep(ctx, manifest, stage, deps))) return emitAborted(ctx);
+* const url = await guidedDeployStep(ctx, manifest, stage, deps);
+* if (url === undefined) return emitAborted(ctx);
 * ```
 */
 const guidedDeployStep = async (ctx, manifest, stage, deps) => {
-	if (!await deps.confirm(`Deploy "${manifest.name}" to ${stage}?`)) return false;
+	if (!await deps.confirm(`Deploy "${manifest.name}" to ${stage}?`)) return void 0;
 	ctx.emit("deploy:phase", { phase: "deploy" });
 	const url = await guidedStep(() => runWrangler([
 		"deploy",
 		"--config",
 		ctx.config.configFile
 	]), HINTS.deploy, deps);
-	if (url === ABORTED) return false;
+	if (url === ABORTED) return void 0;
 	ctx.emit("deploy:complete", { url });
-	return true;
+	return url;
 };
 /**
 * Create the deploy api. Assembles the manifest from each resource plugin's own deployManifest(),
@@ -3135,6 +3194,7 @@ const createDeployApi = (ctx) => ({
 			interactive,
 			confirm: interactive ? createBrandPrompts().confirm : async (_question) => true
 		};
+		const startedAt = Date.now();
 		ctx.emit("deploy:phase", { phase: "auth" });
 		if (!await guidedAuth(ctx, deps)) return emitAborted(ctx);
 		if (!await guidedWebBuild(ctx, opts?.webBuild ?? ctx.config.webBuild, deps)) return emitAborted(ctx);
@@ -3146,7 +3206,16 @@ const createDeployApi = (ctx) => ({
 		ctx.emit("deploy:phase", { phase: "wrangler-config" });
 		await writeWranglerConfig(ctx.config.configFile, manifest, provisioned.ids, wranglerExtra(ctx.config));
 		if (!await guidedUpload(ctx, manifest, deps)) return emitAborted(ctx);
-		if (!await guidedDeployStep(ctx, manifest, stage, deps)) return emitAborted(ctx);
+		const url = await guidedDeployStep(ctx, manifest, stage, deps);
+		if (url === void 0) return emitAborted(ctx);
+		renderDeploySummary(createBrandConsole(), {
+			url,
+			stage,
+			created: provisioned.created.length,
+			exists: provisioned.skipped.length,
+			failed: provisioned.failed.length,
+			elapsedMs: Date.now() - startedAt
+		});
 	},
 	/**
 	* Start a long-lived local dev session: cold-build the Moku site, spawn `wrangler dev
@@ -3631,7 +3700,7 @@ const SPINNER_CLEAR = `\r${" ".repeat(72)}\r`;
 * const hooks = createCliHooks(ctx);
 * hooks["deploy:phase"]({ phase: "detect" }); // logs "detect" → renders "  › detect"
 * hooks["dev:phase"]({ phase: "serve", detail: "http://localhost:8787" }); // "serve · …"
-* hooks["deploy:complete"]({ url: "https://x.workers.dev" }); // "deployed → https://x.workers.dev"
+* hooks["deploy:complete"](); // settles the deploy spinner; the "Deployed" panel renders separately
 * ```
 */
 const createCliHooks = (ctx) => {
@@ -3718,17 +3787,16 @@ const createCliHooks = (ctx) => {
 			ctx.log.warn(p.message);
 		},
 		/**
-		* Log the terminal success line with the deployed URL.
+		* Settle the final deploy spinner. The deployed URL + summary now render as a branded panel (the
+		* deploy plugin's renderDeploySummary), so the cli no longer logs a duplicate `deployed → url`.
 		*
-		* @param p - The deploy:complete event payload.
 		* @example
 		* ```ts
-		* handler({ url: "https://my-worker.workers.dev" }); // "deployed → https://my-worker.workers.dev"
+		* handler(); // clears the `deploy` spinner; the "Deployed" panel follows from the deploy plugin
 		* ```
 		*/
-		"deploy:complete"(p) {
+		"deploy:complete"() {
 			stopSpinner();
-			ctx.log.info(`deployed → ${p.url}`);
 		}
 	};
 };

package/dist/{cli-BPnG_JGR.cjs → cli-DkoPBbJC.cjs}

@@ -762,7 +762,8 @@ const createQueuesApi = (ctx) => {
 			kind: "queue",
 			name: instance.name,
 			binding: instance.binding,
-			...instance.onMessage ? { consumer: true } : {}
+			...instance.onMessage ? { consumer: true } : {},
+			...instance.maxBatchTimeout === void 0 ? {} : { maxBatchTimeout: instance.maxBatchTimeout }
 		}))
 	};
 };
@@ -2208,6 +2209,57 @@ const renderProvisionResult = (ui, result) => {
 		}
 	}
 };
+/**
+* Format an elapsed duration compactly: sub-second as `820ms`, otherwise one-decimal seconds (`4.2s`),
+* and minutes once it crosses 60s (`1m04s`) so a long deploy stays readable.
+*
+* @param ms - The elapsed milliseconds.
+* @returns The compact duration string.
+* @example
+* ```ts
+* formatDuration(4234); // "4.2s"
+* ```
+*/
+const formatDuration = (ms) => {
+	if (ms < 1e3) return `${String(ms)}ms`;
+	const seconds = ms / 1e3;
+	if (seconds < 60) return `${seconds.toFixed(1)}s`;
+	const whole = Math.floor(seconds);
+	return `${String(Math.floor(whole / 60))}m${String(whole % 60).padStart(2, "0")}s`;
+};
+/**
+* Render the terminal deploy summary as a branded panel — the headline the user actually wants. The
+* live URL leads on its own line (pink, so it is the first thing the eye lands on), then a dim
+* key/value block: the target stage, the resource tally (with a red `failed` count when non-zero),
+* and the wall-clock time the whole deploy took. Replaces the prior single `deployed → url` line.
+*
+* @param ui - The branded console to render through.
+* @param summary - The deploy summary fields.
+* @param summary.url - The live deployed URL (the panel headline).
+* @param summary.stage - The target stage the worker deployed to.
+* @param summary.created - How many resources were created this run.
+* @param summary.exists - How many resources already existed (skipped).
+* @param summary.failed - How many resources failed to provision.
+* @param summary.elapsedMs - The wall-clock deploy duration in milliseconds.
+* @example
+* ```ts
+* renderDeploySummary(ui, { url, stage: "production", created: 0, exists: 5, failed: 0, elapsedMs: 4234 });
+* ```
+*/
+const renderDeploySummary = (ui, summary) => {
+	const { palette } = ui;
+	const tally = `${String(summary.exists)} exist · ${String(summary.created)} created`;
+	const failedLabel = palette.red(`${String(summary.failed)} failed`);
+	const resources = summary.failed > 0 ? `${tally} · ${failedLabel}` : tally;
+	ui.heading("Deployed");
+	ui.box([
+		palette.pink(summary.url),
+		"",
+		`${palette.dim("stage".padEnd(10))}${summary.stage}`,
+		`${palette.dim("resources".padEnd(10))}${resources}`,
+		`${palette.dim("took".padEnd(10))}${formatDuration(summary.elapsedMs)}`
+	]);
+};
 //#endregion
 //#region src/plugins/deploy/naming.ts
 /**
@@ -2583,13 +2635,14 @@ const buildD1Databases = (resources, ids) => resources.filter((resource) => reso
 * Every queue is a `producer`; a queue flagged `consumer: true` (it declares an `onMessage` handler)
 * is ALSO registered as a `consumer` so wrangler delivers its messages to this Worker's queue()
 * handler — both locally under `wrangler dev` and in production. Without the consumer entry the
-* handler never runs (the bug that silently drops a queue-driven activity feed).
+* handler never runs (the bug that silently drops a queue-driven activity feed). A consumer that
+* sets `maxBatchTimeout` carries it through as wrangler's `max_batch_timeout` (lower delivery latency).
 *
 * @param resources - All resource descriptors from the manifest.
 * @returns The queues section (producers, plus consumers when any), or undefined when there are none.
 * @example
 * ```ts
-* const q = buildQueues([{ kind: "queue", name: "tracker-activity", binding: "ACTIVITY", consumer: true }]);
+* const q = buildQueues([{ kind: "queue", name: "tracker-activity", binding: "ACTIVITY", consumer: true, maxBatchTimeout: 1 }]);
 * ```
 */
 const buildQueues = (resources) => {
@@ -2599,7 +2652,11 @@ const buildQueues = (resources) => {
 		queue: resource.name,
 		binding: resource.binding
 	}));
-	const consumers = queueResources.filter((resource) => resource.consumer === true).map((resource) => ({ queue: resource.name }));
+	const consumers = queueResources.filter((resource) => resource.consumer === true).map((resource) => {
+		const entry = { queue: resource.name };
+		if (resource.maxBatchTimeout !== void 0) entry.max_batch_timeout = resource.maxBatchTimeout;
+		return entry;
+	});
 	return consumers.length > 0 ? {
 		producers,
 		consumers
@@ -3088,29 +3145,31 @@ const guidedUpload = async (ctx, manifest, deps) => {
 };
 /**
 * The final deploy step: confirm the target (guided only), run `wrangler deploy` with interactive
-* retry, then emit deploy:complete. Resolves false when the target gate or a deploy retry is declined.
+* retry, then emit deploy:complete. Returns the deployed URL, or undefined when the target gate or a
+* deploy retry is declined (so the caller renders the summary panel only on a real success).
 *
 * @param ctx - The deploy plugin context.
 * @param manifest - The assembled (or caller-supplied) deploy manifest.
 * @param stage - The resolved deploy stage (for the confirm prompt).
 * @param deps - Interactivity + the confirm prompt.
-* @returns True once deployed; false when the user declined the gate or a retry (abort).
+* @returns The deployed URL once live; undefined when the user declined the gate or a retry (abort).
 * @example
 * ```ts
-* if (!(await guidedDeployStep(ctx, manifest, stage, deps))) return emitAborted(ctx);
+* const url = await guidedDeployStep(ctx, manifest, stage, deps);
+* if (url === undefined) return emitAborted(ctx);
 * ```
 */
 const guidedDeployStep = async (ctx, manifest, stage, deps) => {
-	if (!await deps.confirm(`Deploy "${manifest.name}" to ${stage}?`)) return false;
+	if (!await deps.confirm(`Deploy "${manifest.name}" to ${stage}?`)) return void 0;
 	ctx.emit("deploy:phase", { phase: "deploy" });
 	const url = await guidedStep(() => runWrangler([
 		"deploy",
 		"--config",
 		ctx.config.configFile
 	]), HINTS.deploy, deps);
-	if (url === ABORTED) return false;
+	if (url === ABORTED) return void 0;
 	ctx.emit("deploy:complete", { url });
-	return true;
+	return url;
 };
 /**
 * Create the deploy api. Assembles the manifest from each resource plugin's own deployManifest(),
@@ -3158,6 +3217,7 @@ const createDeployApi = (ctx) => ({
 			interactive,
 			confirm: interactive ? (0, _moku_labs_common_cli.createBrandPrompts)().confirm : async (_question) => true
 		};
+		const startedAt = Date.now();
 		ctx.emit("deploy:phase", { phase: "auth" });
 		if (!await guidedAuth(ctx, deps)) return emitAborted(ctx);
 		if (!await guidedWebBuild(ctx, opts?.webBuild ?? ctx.config.webBuild, deps)) return emitAborted(ctx);
@@ -3169,7 +3229,16 @@ const createDeployApi = (ctx) => ({
 		ctx.emit("deploy:phase", { phase: "wrangler-config" });
 		await writeWranglerConfig(ctx.config.configFile, manifest, provisioned.ids, wranglerExtra(ctx.config));
 		if (!await guidedUpload(ctx, manifest, deps)) return emitAborted(ctx);
-		if (!await guidedDeployStep(ctx, manifest, stage, deps)) return emitAborted(ctx);
+		const url = await guidedDeployStep(ctx, manifest, stage, deps);
+		if (url === void 0) return emitAborted(ctx);
+		renderDeploySummary((0, _moku_labs_common_cli.createBrandConsole)(), {
+			url,
+			stage,
+			created: provisioned.created.length,
+			exists: provisioned.skipped.length,
+			failed: provisioned.failed.length,
+			elapsedMs: Date.now() - startedAt
+		});
 	},
 	/**
 	* Start a long-lived local dev session: cold-build the Moku site, spawn `wrangler dev
@@ -3654,7 +3723,7 @@ const SPINNER_CLEAR = `\r${" ".repeat(72)}\r`;
 * const hooks = createCliHooks(ctx);
 * hooks["deploy:phase"]({ phase: "detect" }); // logs "detect" → renders "  › detect"
 * hooks["dev:phase"]({ phase: "serve", detail: "http://localhost:8787" }); // "serve · …"
-* hooks["deploy:complete"]({ url: "https://x.workers.dev" }); // "deployed → https://x.workers.dev"
+* hooks["deploy:complete"](); // settles the deploy spinner; the "Deployed" panel renders separately
 * ```
 */
 const createCliHooks = (ctx) => {
@@ -3741,17 +3810,16 @@ const createCliHooks = (ctx) => {
 			ctx.log.warn(p.message);
 		},
 		/**
-		* Log the terminal success line with the deployed URL.
+		* Settle the final deploy spinner. The deployed URL + summary now render as a branded panel (the
+		* deploy plugin's renderDeploySummary), so the cli no longer logs a duplicate `deployed → url`.
 		*
-		* @param p - The deploy:complete event payload.
 		* @example
 		* ```ts
-		* handler({ url: "https://my-worker.workers.dev" }); // "deployed → https://my-worker.workers.dev"
+		* handler(); // clears the `deploy` spinner; the "Deployed" panel follows from the deploy plugin
 		* ```
 		*/
-		"deploy:complete"(p) {
+		"deploy:complete"() {
 			stopSpinner();
-			ctx.log.info(`deployed → ${p.url}`);
 		}
 	};
 };

package/dist/cli.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cli = require("./cli-BPnG_JGR.cjs");
+const require_cli = require("./cli-DkoPBbJC.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-DCweBI9s.cjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BuY9o1u0.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-DCweBI9s.mjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-BuY9o1u0.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-D8UmSqh4.mjs";
+import { n as deployPlugin, t as cliPlugin } from "./cli-By06KF-9.mjs";
 export { cliPlugin, deployPlugin };

package/dist/{index-DCweBI9s.d.cts → index-BuY9o1u0.d.cts}

@@ -179,6 +179,7 @@ type ResourceManifest = {
   name: string;
   binding: string;
   consumer?: boolean;
+  maxBatchTimeout?: number;
 } | {
   kind: "do";
   binding: string;

package/dist/{index-DCweBI9s.d.mts → index-BuY9o1u0.d.mts}

@@ -179,6 +179,7 @@ type ResourceManifest = {
   name: string;
   binding: string;
   consumer?: boolean;
+  maxBatchTimeout?: number;
 } | {
   kind: "do";
   binding: string;

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-DCweBI9s.cjs";
+import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-BuY9o1u0.cjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 
@@ -774,7 +774,14 @@ declare namespace types_d_exports$3 {
 type QueueInstance = {
   /** Base Cloudflare queue name (stage-suffixed at deploy, e.g. `tracker-activity-dev`). */name: string; /** Producer env binding the Queue resolves off the per-request `env` (e.g. `env.ACTIVITY`). */
   binding: string; /** Per-instance consumer handler — awaited once per message in `consume()`. Optional → no-op. */
-  onMessage?: (message: Message, env: WorkerEnv) => Promise<void>; /** Marks this instance the default when more than one is configured. */
+  onMessage?: (message: Message, env: WorkerEnv) => Promise<void>;
+  /**
+   * Max seconds the consumer waits to fill a batch before delivering it (Cloudflare's
+   * `max_batch_timeout`, 0–60). Lower means lower delivery latency and smaller batches; omit to use
+   * Cloudflare's default (~5s). Written to the generated wrangler `consumers` entry, so it only has
+   * an effect on an instance that also declares an `onMessage` handler.
+   */
+  maxBatchTimeout?: number; /** Marks this instance the default when more than one is configured. */
   default?: boolean;
 };
 /**
@@ -861,6 +868,7 @@ type Api = QueueProducerApi & {
     name: string;
     binding: string;
     consumer?: boolean;
+    maxBatchTimeout?: number;
   }>;
 };
 /**

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-DCweBI9s.mjs";
+import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-BuY9o1u0.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 
@@ -774,7 +774,14 @@ declare namespace types_d_exports$3 {
 type QueueInstance = {
   /** Base Cloudflare queue name (stage-suffixed at deploy, e.g. `tracker-activity-dev`). */name: string; /** Producer env binding the Queue resolves off the per-request `env` (e.g. `env.ACTIVITY`). */
   binding: string; /** Per-instance consumer handler — awaited once per message in `consume()`. Optional → no-op. */
-  onMessage?: (message: Message, env: WorkerEnv) => Promise<void>; /** Marks this instance the default when more than one is configured. */
+  onMessage?: (message: Message, env: WorkerEnv) => Promise<void>;
+  /**
+   * Max seconds the consumer waits to fill a batch before delivering it (Cloudflare's
+   * `max_batch_timeout`, 0–60). Lower means lower delivery latency and smaller batches; omit to use
+   * Cloudflare's default (~5s). Written to the generated wrangler `consumers` entry, so it only has
+   * an effect on an instance that also declares an `onMessage` handler.
+   */
+  maxBatchTimeout?: number; /** Marks this instance the default when more than one is configured. */
   default?: boolean;
 };
 /**
@@ -861,6 +868,7 @@ type Api = QueueProducerApi & {
     name: string;
     binding: string;
     consumer?: boolean;
+    maxBatchTimeout?: number;
   }>;
 };
 /**

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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-D8UmSqh4.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-By06KF-9.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 //#region src/env-provider.ts
 /**

package/package.json

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