@moku-labs/worker 0.5.0 → 0.5.1

package/dist/cli.cjs

@@ -507,6 +507,26 @@ const runWranglerInherit = (args) => {
 /** Convention build script auto-detected when no webBuild/buildCommand is configured. */
 const AUTO_DETECT = "scripts/build.ts";
 /**
+* Opportunistically read a numeric `files` count off an arbitrary web build result. A real web
+* build returns its own summary shape (the worker framework cannot know it), so anything without a
+* numeric `files` field reports 0.
+*
+* @param result - The resolved value of a {@link WebBuild} hook (any shape).
+* @returns The `files` count when present and numeric, else 0.
+* @example
+* ```ts
+* fileCountOf({ files: 12 }); // 12
+* fileCountOf({ outDir: "dist", pageCount: 4 }); // 0
+* ```
+*/
+const fileCountOf = (result) => {
+	if (typeof result === "object" && result !== null && "files" in result) {
+		const { files } = result;
+		return typeof files === "number" ? files : 0;
+	}
+	return 0;
+};
+/**
 * Run a shell build command, resolving on a zero exit and rejecting otherwise.
 *
 * @param command - The shell command to run (the consumer's own configured build).
@@ -552,7 +572,7 @@ const runShellBuild = (command) => {
 */
 const buildSite = async (ctx, webBuild) => {
 	const hook = webBuild ?? ctx.config.webBuild;
-	if (hook !== void 0) return { files: (await hook())?.files ?? 0 };
+	if (hook !== void 0) return { files: fileCountOf(await hook()) };
 	const command = ctx.config.buildCommand || ((0, node_fs.existsSync)(AUTO_DETECT) ? `bun run ${AUTO_DETECT}` : "");
 	if (command === "") {
 		ctx.emit("dev:error", { message: "No site build configured (pass webBuild or set buildCommand); serving worker only." });

package/dist/cli.d.cts

@@ -4,19 +4,19 @@ import { PluginCtx, PluginInstance } from "@moku-labs/core";
 /**
  * A web-site build hook wired in from the consumer's deploy/dev script — e.g.
  * `() => webApp.cli.build()`. This is the seam that lets one small app-side script compose a
- * Moku Web app with this Worker framework: `dev` / `deploy` invoke it to (re)build the site
- * before serving or deploying. May resolve a `{ files }` count (surfaced in `dev:rebuilt`) or
- * nothing.
+ * Moku Web app with this Worker framework: `dev` / `deploy` invoke it to (re)build the site before
+ * serving or deploying. The hook may resolve ANYTHING — `void`, the web app's own build summary, or
+ * a `{ files }` count; when the resolved value carries a numeric `files` field it is surfaced in
+ * `dev:rebuilt`, otherwise the count is reported as 0. Returning `Promise<unknown>` keeps the hook
+ * assignable from any real build function (whose return type the worker framework cannot know).
  *
- * @returns Resolves when the web build completes; optionally a rebuilt-file count.
+ * @returns Resolves when the web build completes (the value is read opportunistically for `files`).
  * @example
  * ```ts
  * await server.cli.dev({ webBuild: () => web.cli.build() });
  * ```
  */
-type WebBuild = () => Promise<void> | Promise<{
-  files?: number;
-}>;
+type WebBuild = () => Promise<unknown>;
 /** deploy plugin configuration. Flat; complete defaults so omission never yields undefined. */
 type Config$1 = {
   /**

package/dist/cli.d.mts

@@ -4,19 +4,19 @@ import { PluginCtx, PluginInstance } from "@moku-labs/core";
 /**
  * A web-site build hook wired in from the consumer's deploy/dev script — e.g.
  * `() => webApp.cli.build()`. This is the seam that lets one small app-side script compose a
- * Moku Web app with this Worker framework: `dev` / `deploy` invoke it to (re)build the site
- * before serving or deploying. May resolve a `{ files }` count (surfaced in `dev:rebuilt`) or
- * nothing.
+ * Moku Web app with this Worker framework: `dev` / `deploy` invoke it to (re)build the site before
+ * serving or deploying. The hook may resolve ANYTHING — `void`, the web app's own build summary, or
+ * a `{ files }` count; when the resolved value carries a numeric `files` field it is surfaced in
+ * `dev:rebuilt`, otherwise the count is reported as 0. Returning `Promise<unknown>` keeps the hook
+ * assignable from any real build function (whose return type the worker framework cannot know).
  *
- * @returns Resolves when the web build completes; optionally a rebuilt-file count.
+ * @returns Resolves when the web build completes (the value is read opportunistically for `files`).
  * @example
  * ```ts
  * await server.cli.dev({ webBuild: () => web.cli.build() });
  * ```
  */
-type WebBuild = () => Promise<void> | Promise<{
-  files?: number;
-}>;
+type WebBuild = () => Promise<unknown>;
 /** deploy plugin configuration. Flat; complete defaults so omission never yields undefined. */
 type Config$1 = {
   /**

package/dist/cli.mjs

@@ -483,6 +483,26 @@ const runWranglerInherit = (args) => {
 /** Convention build script auto-detected when no webBuild/buildCommand is configured. */
 const AUTO_DETECT = "scripts/build.ts";
 /**
+* Opportunistically read a numeric `files` count off an arbitrary web build result. A real web
+* build returns its own summary shape (the worker framework cannot know it), so anything without a
+* numeric `files` field reports 0.
+*
+* @param result - The resolved value of a {@link WebBuild} hook (any shape).
+* @returns The `files` count when present and numeric, else 0.
+* @example
+* ```ts
+* fileCountOf({ files: 12 }); // 12
+* fileCountOf({ outDir: "dist", pageCount: 4 }); // 0
+* ```
+*/
+const fileCountOf = (result) => {
+	if (typeof result === "object" && result !== null && "files" in result) {
+		const { files } = result;
+		return typeof files === "number" ? files : 0;
+	}
+	return 0;
+};
+/**
 * Run a shell build command, resolving on a zero exit and rejecting otherwise.
 *
 * @param command - The shell command to run (the consumer's own configured build).
@@ -528,7 +548,7 @@ const runShellBuild = (command) => {
 */
 const buildSite = async (ctx, webBuild) => {
 	const hook = webBuild ?? ctx.config.webBuild;
-	if (hook !== void 0) return { files: (await hook())?.files ?? 0 };
+	if (hook !== void 0) return { files: fileCountOf(await hook()) };
 	const command = ctx.config.buildCommand || (existsSync(AUTO_DETECT) ? `bun run ${AUTO_DETECT}` : "");
 	if (command === "") {
 		ctx.emit("dev:error", { message: "No site build configured (pass webBuild or set buildCommand); serving worker only." });

package/package.json

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