workerstack 0.1.0-beta.0

package/dist/workers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/workers/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CACH,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAAA;CACrB,CAAA;AAKD,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAEtD;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAC5B;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,GAAG,EAAE,SAAS,CAAA;CAAE,GAC5C,SAAS,CAIZ;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}

package/dist/workers/registry.js

@@ -0,0 +1,19 @@
+let current;
+let currentEnv;
+export function registerWorker(worker) {
+    current = worker;
+}
+export function rememberWorkerEnv(env) {
+    currentEnv = env;
+}
+/** The registered Worker and its env, once a request has reached it. */
+export function registeredWorker() {
+    return current && currentEnv
+        ? { worker: current, env: currentEnv }
+        : undefined;
+}
+export function resetRegistryForTests() {
+    current = undefined;
+    currentEnv = undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/workers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/workers/registry.ts"],"names":[],"mappings":"AAcA,IAAI,OAAqC,CAAA;AACzC,IAAI,UAAiC,CAAA;AAErC,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,OAAO,GAAG,MAAM,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAc;IAC9C,UAAU,GAAG,GAAG,CAAA;AAClB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB;IAG9B,OAAO,OAAO,IAAI,UAAU;QAC1B,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE;QACtC,CAAC,CAAC,SAAS,CAAA;AACf,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,GAAG,SAAS,CAAA;IACnB,UAAU,GAAG,SAAS,CAAA;AACxB,CAAC","sourcesContent":["// src/workers/registry.ts — the workerstack Worker of this isolate. A package\n// entry registers it; server-side fetch in Start calls it without a network hop.\n// The env is the one the Worker last received: it is the same for every request\n// in an isolate, and SSR code runs inside a request that reached the Worker.\nimport type { ExecutionContextLike, WorkerEnv } from './types'\n\nexport type RegisteredWorker = {\n  fetch(\n    request: Request,\n    env: WorkerEnv,\n    ctx: ExecutionContextLike,\n  ): Promise<Response>\n}\n\nlet current: RegisteredWorker | undefined\nlet currentEnv: WorkerEnv | undefined\n\nexport function registerWorker(worker: RegisteredWorker): void {\n  current = worker\n}\n\nexport function rememberWorkerEnv(env: WorkerEnv): void {\n  currentEnv = env\n}\n\n/** The registered Worker and its env, once a request has reached it. */\nexport function registeredWorker():\n  | { worker: RegisteredWorker; env: WorkerEnv }\n  | undefined {\n  return current && currentEnv\n    ? { worker: current, env: currentEnv }\n    : undefined\n}\n\nexport function resetRegistryForTests(): void {\n  current = undefined\n  currentEnv = undefined\n}\n"]}

package/dist/workers/scheduler.d.ts

@@ -0,0 +1,13 @@
+import type { WorkerstackBackend } from '../backend.js';
+import type { DurableObjectStateLike, WorkerEnv } from './types.js';
+export declare const TICK_BUDGET_MS = 25000;
+export declare const NOTIFY_RETRY_MS = 1000;
+export declare const SAFETY_MS = 3600000;
+export declare const MIN_GAP_MS = 1000;
+export interface SchedulerObject {
+    fetch(request: Request): Promise<Response>;
+    alarm(): Promise<void>;
+}
+export type SchedulerClass = new (state: DurableObjectStateLike, env: WorkerEnv) => SchedulerObject;
+export declare function createSchedulerClass(backend: WorkerstackBackend<any>): SchedulerClass;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/workers/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/workers/scheduler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIhE,eAAO,MAAM,cAAc,QAAS,CAAA;AACpC,eAAO,MAAM,eAAe,OAAQ,CAAA;AACpC,eAAO,MAAM,SAAS,UAAY,CAAA;AAClC,eAAO,MAAM,UAAU,OAAQ,CAAA;AAE/B,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,KAC3B,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,SAAS,KACX,eAAe,CAAA;AAGpB,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAC/B,cAAc,CAkEhB"}

package/dist/workers/scheduler.js

@@ -0,0 +1,71 @@
+import { appFor } from './app.js';
+export const TICK_BUDGET_MS = 25_000;
+export const NOTIFY_RETRY_MS = 1_000;
+export const SAFETY_MS = 3_600_000;
+export const MIN_GAP_MS = 1_000;
+// An explicit return type keeps the private members out of the emitted .d.ts.
+export function createSchedulerClass(backend) {
+    return class Scheduler {
+        state;
+        env;
+        notified = false;
+        retried = false;
+        constructor(state, env) {
+            this.state = state;
+            this.env = env;
+        }
+        app() {
+            // Enqueues from job handlers move this alarm directly, not via a stub.
+            return appFor(backend, this.env, 'scheduler', {
+                jobs: { notify: (runAt) => this.schedule(runAt) },
+            });
+        }
+        /** Only ever moves the alarm earlier. */
+        async schedule(runAt) {
+            const current = await this.state.storage.getAlarm();
+            if (current === null || runAt < current) {
+                await this.state.storage.setAlarm(runAt);
+            }
+        }
+        async fetch(request) {
+            const url = new URL(request.url);
+            if (url.pathname !== '/notify' || request.method !== 'POST') {
+                return new Response('Not found', { status: 404 });
+            }
+            const { runAt } = (await request.json());
+            this.notified = true;
+            this.retried = false;
+            await this.schedule(runAt);
+            return new Response(null, { status: 204 });
+        }
+        async alarm() {
+            // Clear the alarm that fired, so schedule() below can set a later one.
+            // Cloudflare has already cleared it; celld and the test fake may not.
+            const fired = await this.state.storage.getAlarm();
+            if (fired !== null && fired <= Date.now()) {
+                await this.state.storage.deleteAlarm();
+            }
+            const app = await this.app();
+            const started = Date.now();
+            let claimed = 0;
+            for (;;) {
+                const result = await app.jobs.tick(Date.now());
+                claimed += result.claimed;
+                if (result.claimed === 0 || Date.now() - started > TICK_BUDGET_MS) {
+                    break;
+                }
+            }
+            const now = Date.now();
+            // An enqueue inside a transaction notifies before its commit.
+            if (this.notified && claimed === 0 && !this.retried) {
+                this.retried = true;
+                await this.schedule(now + NOTIFY_RETRY_MS);
+                return;
+            }
+            this.notified = false;
+            const next = await app.jobs.nextDueAt(now, now + SAFETY_MS);
+            await this.schedule(Math.max(next ?? now + SAFETY_MS, now + MIN_GAP_MS));
+        }
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/workers/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/workers/scheduler.ts"],"names":[],"mappings":"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","sourcesContent":["// src/workers/scheduler.ts — the only place background work runs in a Worker.\n// One instance per app ('main'). Its alarm chain follows app.jobs.nextDueAt;\n// enqueues and Cron Triggers pull the alarm earlier through /notify.\nimport type { WorkerstackBackend } from '../backend'\nimport type { DurableObjectStateLike, WorkerEnv } from './types'\n\nimport { appFor, type WorkerApp } from './app'\n\nexport const TICK_BUDGET_MS = 25_000\nexport const NOTIFY_RETRY_MS = 1_000\nexport const SAFETY_MS = 3_600_000\nexport const MIN_GAP_MS = 1_000\n\nexport interface SchedulerObject {\n  fetch(request: Request): Promise<Response>\n  alarm(): Promise<void>\n}\n\nexport type SchedulerClass = new (\n  state: DurableObjectStateLike,\n  env: WorkerEnv,\n) => SchedulerObject\n\n// An explicit return type keeps the private members out of the emitted .d.ts.\nexport function createSchedulerClass(\n  backend: WorkerstackBackend<any>,\n): SchedulerClass {\n  return class Scheduler {\n    private notified = false\n    private retried = false\n\n    constructor(\n      private readonly state: DurableObjectStateLike,\n      private readonly env: WorkerEnv,\n    ) {}\n\n    private app(): Promise<WorkerApp> {\n      // Enqueues from job handlers move this alarm directly, not via a stub.\n      return appFor(backend, this.env, 'scheduler', {\n        jobs: { notify: (runAt) => this.schedule(runAt) },\n      })\n    }\n\n    /** Only ever moves the alarm earlier. */\n    private async schedule(runAt: number) {\n      const current = await this.state.storage.getAlarm()\n      if (current === null || runAt < current) {\n        await this.state.storage.setAlarm(runAt)\n      }\n    }\n\n    async fetch(request: Request): Promise<Response> {\n      const url = new URL(request.url)\n      if (url.pathname !== '/notify' || request.method !== 'POST') {\n        return new Response('Not found', { status: 404 })\n      }\n      const { runAt } = (await request.json()) as { runAt: number }\n      this.notified = true\n      this.retried = false\n      await this.schedule(runAt)\n      return new Response(null, { status: 204 })\n    }\n\n    async alarm(): Promise<void> {\n      // Clear the alarm that fired, so schedule() below can set a later one.\n      // Cloudflare has already cleared it; celld and the test fake may not.\n      const fired = await this.state.storage.getAlarm()\n      if (fired !== null && fired <= Date.now()) {\n        await this.state.storage.deleteAlarm()\n      }\n      const app = await this.app()\n      const started = Date.now()\n      let claimed = 0\n      for (;;) {\n        const result = await app.jobs.tick(Date.now())\n        claimed += result.claimed\n        if (result.claimed === 0 || Date.now() - started > TICK_BUDGET_MS) {\n          break\n        }\n      }\n      const now = Date.now()\n      // An enqueue inside a transaction notifies before its commit.\n      if (this.notified && claimed === 0 && !this.retried) {\n        this.retried = true\n        await this.schedule(now + NOTIFY_RETRY_MS)\n        return\n      }\n      this.notified = false\n      const next = await app.jobs.nextDueAt(now, now + SAFETY_MS)\n      await this.schedule(Math.max(next ?? now + SAFETY_MS, now + MIN_GAP_MS))\n    }\n  }\n}\n"]}

package/dist/workers/types.d.ts

@@ -0,0 +1,55 @@
+export interface DurableObjectStorageLike {
+    getAlarm(): Promise<number | null>;
+    setAlarm(scheduledTime: number | Date): Promise<void>;
+    deleteAlarm(): Promise<void>;
+}
+export interface DurableObjectStateLike {
+    storage: DurableObjectStorageLike;
+}
+export interface FetcherLike {
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+}
+export interface DurableObjectNamespaceLike {
+    idFromName(name: string): unknown;
+    get(id: unknown): FetcherLike;
+}
+export interface ExecutionContextLike {
+    waitUntil(promise: Promise<unknown>): void;
+}
+export interface R2ObjectLike {
+    key: string;
+    size: number;
+    httpMetadata?: {
+        contentType?: string;
+    };
+}
+export interface R2ObjectBodyLike extends R2ObjectLike {
+    body: ReadableStream;
+}
+export interface R2BucketLike {
+    put(key: string, value: ArrayBuffer | ReadableStream | string, options?: {
+        httpMetadata?: {
+            contentType?: string;
+        };
+    }): Promise<unknown>;
+    get(key: string): Promise<R2ObjectBodyLike | null>;
+    head(key: string): Promise<R2ObjectLike | null>;
+    delete(key: string): Promise<void>;
+    list(options?: {
+        prefix?: string;
+        cursor?: string;
+    }): Promise<{
+        objects: R2ObjectLike[];
+        truncated: boolean;
+        cursor?: string;
+    }>;
+}
+export type WorkerEnv = {
+    SCHEDULER?: DurableObjectNamespaceLike;
+    REALTIME?: DurableObjectNamespaceLike;
+    RATE_LIMITER?: DurableObjectNamespaceLike;
+    ASSETS?: FetcherLike;
+    [binding: string]: unknown;
+};
+export declare function stub(namespace: DurableObjectNamespaceLike, name: string): FetcherLike;
+//# sourceMappingURL=types.d.ts.map

package/dist/workers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,wBAAwB,CAAA;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACvE;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACjC,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACxC;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,GAAG,cAAc,GAAG,MAAM,EAC5C,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GACpD,OAAO,CAAC,OAAO,CAAC,CAAA;IACnB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAClD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5D,OAAO,EAAE,YAAY,EAAE,CAAA;QACvB,SAAS,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;CACH;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,CAAC,EAAE,0BAA0B,CAAA;IACtC,QAAQ,CAAC,EAAE,0BAA0B,CAAA;IACrC,YAAY,CAAC,EAAE,0BAA0B,CAAA;IACzC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA;AAED,wBAAgB,IAAI,CAClB,SAAS,EAAE,0BAA0B,EACrC,IAAI,EAAE,MAAM,GACX,WAAW,CAEb"}

package/dist/workers/types.js

@@ -0,0 +1,4 @@
+export function stub(namespace, name) {
+    return namespace.get(namespace.idFromName(name));
+}
+//# sourceMappingURL=types.js.map

package/dist/workers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":"AA4DA,MAAM,UAAU,IAAI,CAClB,SAAqC,EACrC,IAAY;IAEZ,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;AAClD,CAAC","sourcesContent":["// src/workers/types.ts — the small part of the Workers API that workerstack\n// uses. Local interfaces keep `cloudflare:workers` and its type package out of\n// the core, so the same classes run under `bun test` with in-memory fakes.\nexport interface DurableObjectStorageLike {\n  getAlarm(): Promise<number | null>\n  setAlarm(scheduledTime: number | Date): Promise<void>\n  deleteAlarm(): Promise<void>\n}\n\nexport interface DurableObjectStateLike {\n  storage: DurableObjectStorageLike\n}\n\nexport interface FetcherLike {\n  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>\n}\n\nexport interface DurableObjectNamespaceLike {\n  idFromName(name: string): unknown\n  get(id: unknown): FetcherLike\n}\n\nexport interface ExecutionContextLike {\n  waitUntil(promise: Promise<unknown>): void\n}\n\nexport interface R2ObjectLike {\n  key: string\n  size: number\n  httpMetadata?: { contentType?: string }\n}\n\nexport interface R2ObjectBodyLike extends R2ObjectLike {\n  body: ReadableStream\n}\n\nexport interface R2BucketLike {\n  put(\n    key: string,\n    value: ArrayBuffer | ReadableStream | string,\n    options?: { httpMetadata?: { contentType?: string } },\n  ): Promise<unknown>\n  get(key: string): Promise<R2ObjectBodyLike | null>\n  head(key: string): Promise<R2ObjectLike | null>\n  delete(key: string): Promise<void>\n  list(options?: { prefix?: string; cursor?: string }): Promise<{\n    objects: R2ObjectLike[]\n    truncated: boolean\n    cursor?: string\n  }>\n}\n\nexport type WorkerEnv = {\n  SCHEDULER?: DurableObjectNamespaceLike\n  REALTIME?: DurableObjectNamespaceLike\n  RATE_LIMITER?: DurableObjectNamespaceLike\n  ASSETS?: FetcherLike\n  [binding: string]: unknown\n}\n\nexport function stub(\n  namespace: DurableObjectNamespaceLike,\n  name: string,\n): FetcherLike {\n  return namespace.get(namespace.idFromName(name))\n}\n"]}

package/dist/workers/wrangler.d.ts

@@ -0,0 +1,62 @@
+import type { WorkerPlan } from '../worker-plan.js';
+export type WranglerConfig = ReturnType<typeof toWranglerConfig>;
+export declare function toWranglerConfig(plan: WorkerPlan, names: {
+    name: string;
+    bucketName: (logical: string) => string;
+}, 
+/** artifact: main and assets of the build output instead of the source. */
+options?: {
+    artifact?: boolean;
+}): {
+    triggers?: {
+        crons: string[];
+    } | undefined;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    durable_objects: {
+        bindings: {
+            name: string;
+            class_name: string;
+        }[];
+    };
+    migrations: {
+        tag: string;
+        new_sqlite_classes: string[];
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    assets: {
+        run_worker_first?: string[] | undefined;
+        directory: string;
+        binding: string;
+        not_found_handling: "none" | "single-page-application";
+    };
+};
+/** A Worker name from package.json#name: no scope, lowercase, [a-z0-9-]. */
+export declare function workerName(packageName: string | undefined): string;
+/**
+ * Imports the app's backend. Entry precedence: the argument,
+ * package.json#workerstack.entry, src/workerstack.ts.
+ */
+export declare function loadBackend(directory: string, entry?: string): Promise<{
+    pkg: {
+        name?: string;
+        workerstack?: {
+            entry?: string;
+        };
+    };
+    backend: import("..").WorkerstackBackend<unknown>;
+}>;
+export declare function runWranglerCommand(options: {
+    directory: string;
+    name?: string;
+    output?: string;
+}): Promise<{
+    path: string;
+    changed: boolean;
+}>;
+//# sourceMappingURL=wrangler.d.ts.map

package/dist/workers/wrangler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrangler.d.ts","sourceRoot":"","sources":["../../src/workers/wrangler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAMhD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEhE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE;AAChE,2EAA2E;AAC3E,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCrC;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;;eAGnD,MAAM;sBAAgB;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE;;;GASvD;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA4B9C"}

package/dist/workers/wrangler.js

@@ -0,0 +1,90 @@
+// src/workers/wrangler.ts — wrangler.json rendered from the committed
+// blueprint. The file is a local artifact (git-ignored): `celld dev`, a manual
+// `wrangler deploy`, or `celld deploy` read it. Hosts render their own config
+// from the same WorkerPlan.
+import { readFile, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { isWorkerstackBackend } from '../backend.js';
+import { parseWorkerBlueprintYaml } from '../blueprint.js';
+import { workerPlanFromBlueprint } from '../worker-plan.js';
+export function toWranglerConfig(plan, names, 
+/** artifact: main and assets of the build output instead of the source. */
+options = {}) {
+    return {
+        name: names.name,
+        main: options.artifact ? plan.artifact.main : plan.main,
+        compatibility_date: plan.compatibilityDate,
+        compatibility_flags: [...plan.compatibilityFlags],
+        durable_objects: {
+            bindings: plan.durableObjects.bindings.map((binding) => ({
+                name: binding.name,
+                class_name: binding.className,
+            })),
+        },
+        migrations: plan.durableObjects.migrations.map((migration) => ({
+            tag: migration.tag,
+            new_sqlite_classes: [...migration.newSqliteClasses],
+        })),
+        r2_buckets: plan.buckets.map((bucket) => ({
+            binding: bucket.binding,
+            bucket_name: names.bucketName(bucket.name),
+        })),
+        assets: {
+            directory: options.artifact
+                ? plan.artifact.assets
+                : plan.assets.directory,
+            binding: 'ASSETS',
+            not_found_handling: plan.assets.notFoundHandling,
+            ...(plan.assets.runWorkerFirst.length > 0
+                ? { run_worker_first: [...plan.assets.runWorkerFirst] }
+                : {}),
+        },
+        ...(plan.crons.length > 0 ? { triggers: { crons: [...plan.crons] } } : {}),
+    };
+}
+/** A Worker name from package.json#name: no scope, lowercase, [a-z0-9-]. */
+export function workerName(packageName) {
+    return (packageName ?? 'app')
+        .replace(/^@[^/]+\//, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-');
+}
+/**
+ * Imports the app's backend. Entry precedence: the argument,
+ * package.json#workerstack.entry, src/workerstack.ts.
+ */
+export async function loadBackend(directory, entry) {
+    const pkg = JSON.parse(await readFile(join(directory, 'package.json'), 'utf8'));
+    const path = entry ?? pkg.workerstack?.entry ?? 'src/workerstack.ts';
+    const module = (await import(pathToFileURL(join(directory, path)).href));
+    if (!isWorkerstackBackend(module.backend)) {
+        throw new Error(`[workerstack] ${path} must export backend`);
+    }
+    return { pkg, backend: module.backend };
+}
+export async function runWranglerCommand(options) {
+    const directory = resolve(options.directory);
+    const pkg = JSON.parse(await readFile(join(directory, 'package.json'), 'utf8'));
+    let source;
+    try {
+        source = await readFile(join(directory, 'workerstack.blueprint.yaml'), 'utf8');
+    }
+    catch {
+        throw new Error('[workerstack] workerstack.blueprint.yaml does not exist; run `workerstack blueprint`');
+    }
+    const plan = workerPlanFromBlueprint(parseWorkerBlueprintYaml(source));
+    const name = workerName(options.name ?? pkg.name);
+    const config = toWranglerConfig(plan, {
+        name,
+        bucketName: (bucket) => `${name}-${bucket}`,
+    });
+    const path = join(directory, options.output ?? 'wrangler.json');
+    const text = `${JSON.stringify(config, null, 2)}\n`;
+    const existing = await readFile(path, 'utf8').catch(() => undefined);
+    if (existing === text)
+        return { path, changed: false };
+    await writeFile(path, text);
+    return { path, changed: true };
+}
+//# sourceMappingURL=wrangler.js.map

package/dist/workers/wrangler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrangler.js","sourceRoot":"","sources":["../../src/workers/wrangler.ts"],"names":[],"mappings":"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","sourcesContent":["// src/workers/wrangler.ts — wrangler.json rendered from the committed\n// blueprint. The file is a local artifact (git-ignored): `celld dev`, a manual\n// `wrangler deploy`, or `celld deploy` read it. Hosts render their own config\n// from the same WorkerPlan.\nimport { readFile, writeFile } from 'node:fs/promises'\nimport { join, resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\n\nimport type { WorkerPlan } from '../worker-plan'\n\nimport { isWorkerstackBackend } from '../backend'\nimport { parseWorkerBlueprintYaml } from '../blueprint'\nimport { workerPlanFromBlueprint } from '../worker-plan'\n\nexport type WranglerConfig = ReturnType<typeof toWranglerConfig>\n\nexport function toWranglerConfig(\n  plan: WorkerPlan,\n  names: { name: string; bucketName: (logical: string) => string },\n  /** artifact: main and assets of the build output instead of the source. */\n  options: { artifact?: boolean } = {},\n) {\n  return {\n    name: names.name,\n    main: options.artifact ? plan.artifact.main : plan.main,\n    compatibility_date: plan.compatibilityDate,\n    compatibility_flags: [...plan.compatibilityFlags],\n    durable_objects: {\n      bindings: plan.durableObjects.bindings.map((binding) => ({\n        name: binding.name,\n        class_name: binding.className,\n      })),\n    },\n    migrations: plan.durableObjects.migrations.map((migration) => ({\n      tag: migration.tag,\n      new_sqlite_classes: [...migration.newSqliteClasses],\n    })),\n    r2_buckets: plan.buckets.map((bucket) => ({\n      binding: bucket.binding,\n      bucket_name: names.bucketName(bucket.name),\n    })),\n    assets: {\n      directory: options.artifact\n        ? plan.artifact.assets\n        : plan.assets.directory,\n      binding: 'ASSETS',\n      not_found_handling: plan.assets.notFoundHandling,\n      ...(plan.assets.runWorkerFirst.length > 0\n        ? { run_worker_first: [...plan.assets.runWorkerFirst] }\n        : {}),\n    },\n    ...(plan.crons.length > 0 ? { triggers: { crons: [...plan.crons] } } : {}),\n  }\n}\n\n/** A Worker name from package.json#name: no scope, lowercase, [a-z0-9-]. */\nexport function workerName(packageName: string | undefined): string {\n  return (packageName ?? 'app')\n    .replace(/^@[^/]+\\//, '')\n    .toLowerCase()\n    .replace(/[^a-z0-9-]/g, '-')\n}\n\n/**\n * Imports the app's backend. Entry precedence: the argument,\n * package.json#workerstack.entry, src/workerstack.ts.\n */\nexport async function loadBackend(directory: string, entry?: string) {\n  const pkg = JSON.parse(\n    await readFile(join(directory, 'package.json'), 'utf8'),\n  ) as { name?: string; workerstack?: { entry?: string } }\n  const path = entry ?? pkg.workerstack?.entry ?? 'src/workerstack.ts'\n  const module = (await import(pathToFileURL(join(directory, path)).href)) as {\n    backend?: unknown\n  }\n  if (!isWorkerstackBackend(module.backend)) {\n    throw new Error(`[workerstack] ${path} must export backend`)\n  }\n  return { pkg, backend: module.backend }\n}\n\nexport async function runWranglerCommand(options: {\n  directory: string\n  name?: string\n  output?: string\n}): Promise<{ path: string; changed: boolean }> {\n  const directory = resolve(options.directory)\n  const pkg = JSON.parse(\n    await readFile(join(directory, 'package.json'), 'utf8'),\n  ) as { name?: string }\n  let source: string\n  try {\n    source = await readFile(\n      join(directory, 'workerstack.blueprint.yaml'),\n      'utf8',\n    )\n  } catch {\n    throw new Error(\n      '[workerstack] workerstack.blueprint.yaml does not exist; run `workerstack blueprint`',\n    )\n  }\n  const plan = workerPlanFromBlueprint(parseWorkerBlueprintYaml(source))\n  const name = workerName(options.name ?? pkg.name)\n  const config = toWranglerConfig(plan, {\n    name,\n    bucketName: (bucket) => `${name}-${bucket}`,\n  })\n  const path = join(directory, options.output ?? 'wrangler.json')\n  const text = `${JSON.stringify(config, null, 2)}\\n`\n  const existing = await readFile(path, 'utf8').catch(() => undefined)\n  if (existing === text) return { path, changed: false }\n  await writeFile(path, text)\n  return { path, changed: true }\n}\n"]}