alchemy 0.1.16 → 0.1.17

package/lib/cloudflare/state.js

@@ -0,0 +1,109 @@
+/**
+ * State store implementation using Cloudflare KV Namespace
+ */
+export class CloudflareStateStore {
+    namespace;
+    prefix;
+    /**
+     * Create a new CloudflareStateStore
+     *
+     * @param namespace The KV namespace to use for storing state
+     * @param options Options for the state store
+     */
+    constructor(namespace, options = {}) {
+        this.namespace = namespace;
+        this.prefix = options.prefix || "alchemy-state:";
+    }
+    /**
+     * No initialization needed for KV namespaces as they are pre-provisioned
+     */
+    async init() {
+        // KV namespaces are pre-provisioned in Cloudflare, so no initialization is needed
+    }
+    /**
+     * KV namespaces cannot be deleted programmatically
+     */
+    async deinit() {
+        // KV namespaces can only be deleted through the Cloudflare dashboard or API
+        // We cannot delete the namespace itself here
+    }
+    /**
+     * List all resources in the state store
+     */
+    async list() {
+        const list = await this.namespace.list({ prefix: this.prefix });
+        return list.keys.map((key) => key.name.slice(this.prefix.length));
+    }
+    /**
+     * Count the number of items in the state store
+     */
+    async count() {
+        const list = await this.namespace.list({ prefix: this.prefix });
+        return list.keys.length;
+    }
+    /**
+     * Get a state by key
+     *
+     * @param key The key to look up
+     * @returns The state or undefined if not found
+     */
+    async get(key) {
+        const data = await this.namespace.get(this.getNamespacedKey(key), "json");
+        return data;
+    }
+    /**
+     * Get multiple states by their keys
+     *
+     * @param ids Array of keys to fetch
+     * @returns Record mapping keys to their states
+     */
+    async getBatch(ids) {
+        const result = {};
+        // KV doesn't have a native batch get operation, so we need to make multiple requests
+        // We could optimize this with Promise.all for parallel fetching
+        const promises = ids.map(async (id) => {
+            const state = await this.get(id);
+            if (state) {
+                result[id] = state;
+            }
+        });
+        await Promise.all(promises);
+        return result;
+    }
+    /**
+     * Get all states in the store
+     *
+     * @returns Record mapping all keys to their states
+     */
+    async all() {
+        const keys = await this.list();
+        return this.getBatch(keys);
+    }
+    /**
+     * Set a state for a key
+     *
+     * @param key The key to set
+     * @param value The state to store
+     */
+    async set(key, value) {
+        await this.namespace.put(this.getNamespacedKey(key), JSON.stringify(value));
+    }
+    /**
+     * Delete a state by key
+     *
+     * @param key The key to delete
+     */
+    async delete(key) {
+        await this.namespace.delete(this.getNamespacedKey(key));
+    }
+    /**
+     * Get the namespaced key for storage
+     *
+     * @param key The original key
+     * @returns The key with prefix for use in the KV namespace
+     */
+    getNamespacedKey(key) {
+        return `${this.prefix}${key}`;
+    }
+}
+//# sourceMappingURL=state.js.map

package/lib/cloudflare/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/cloudflare/state.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACvB,SAAS,CAAc;IACvB,MAAM,CAAS;IAEvB;;;;;OAKG;IACH,YACE,SAAsB,EACtB,UAAuC,EAAE;QAEzC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,kFAAkF;IACpF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,4EAA4E;QAC5E,6CAA6C;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1E,OAAO,IAAyB,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAa;QAC1B,MAAM,MAAM,GAA0B,EAAE,CAAC;QAEzC,qFAAqF;QACrF,gEAAgE;QAChE,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAY;QACjC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,GAAW;QAClC,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;IAChC,CAAC;CACF"}

package/lib/cloudflare/static-site-router.d.ts

@@ -0,0 +1,19 @@
+export type Env = {
+    ASSETS: KVNamespace;
+    INDEX_PAGE: string;
+    ERROR_PAGE?: string;
+    /**
+     * Optional backend worker bound to this static site
+     * Used to handle requests that don't match any static files
+     */
+    BACKEND_WORKER?: Service;
+} & {
+    [key in `ROUTE_${string}`]: Service;
+} & {
+    [key in `__ROUTE_${string}`]: string;
+};
+declare const _default: {
+    fetch(request: Request, env: Env): Promise<Response>;
+};
+export default _default;
+//# sourceMappingURL=static-site-router.d.ts.map

package/lib/cloudflare/static-site-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-site-router.d.ts","sourceRoot":"","sources":["../../src/cloudflare/static-site-router.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,GAAG,GAAG;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG;KAED,GAAG,IAAI,SAAS,MAAM,EAAE,GAAG,OAAO;CACpC,GAAG;KAED,GAAG,IAAI,WAAW,MAAM,EAAE,GAAG,MAAM;CACrC,CAAC;;mBAMqB,OAAO,OAAO,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;;AAD5D,wBAqBE"}

package/lib/cloudflare/static-site-router.js

@@ -0,0 +1,110 @@
+import { Hono } from "hono";
+let isInit = false;
+const app = new Hono();
+export default {
+    async fetch(request, env) {
+        if (!isInit) {
+            isInit = true;
+            for (const [key, value] of Object.entries(env)) {
+                if (key.startsWith("ROUTE_")) {
+                    console.log(key, value);
+                    const service = value;
+                    const patternKey = `__${key}`;
+                    if (!(patternKey in env)) {
+                        throw new Error(`Missing pattern key: ${patternKey}`);
+                    }
+                    const pattern = env[`__${key}`];
+                    console.log("pattern", pattern);
+                    // TODO(sam): we should support narrowing down METHOD
+                    app.all(pattern, (ctx) => service.fetch(ctx.req.raw));
+                }
+            }
+        }
+        return app.fetch(request, env);
+    },
+};
+// fall back to assuming the request is a static file
+app.notFound(async (ctx) => {
+    console.log("not found");
+    const request = ctx.req;
+    const env = ctx.env;
+    const url = new URL(request.url);
+    const pathname = url.pathname.replace(/^\//, "");
+    const filePath = pathname === "" ? env.INDEX_PAGE : pathname;
+    // Return from cache if available
+    const cachedResponse = await lookupCache();
+    if (cachedResponse) {
+        return cachedResponse;
+    }
+    // Fetch from KV
+    {
+        const object = await env.ASSETS.getWithMetadata(filePath);
+        if (object.value) {
+            return await respond(200, filePath, object);
+        }
+    }
+    {
+        const guess = filePath + (filePath.endsWith("/") ? "" : "/") + "index.html";
+        const object = await env.ASSETS.getWithMetadata(guess);
+        if (object.value) {
+            return await respond(200, guess, object);
+        }
+    }
+    {
+        const guess = filePath + ".html";
+        const object = await env.ASSETS.getWithMetadata(guess);
+        if (object.value) {
+            return await respond(200, guess, object);
+        }
+    }
+    // Handle error page
+    if (env.ERROR_PAGE) {
+        const object = await env.ASSETS.getWithMetadata(env.ERROR_PAGE);
+        if (object.value) {
+            return await respond(404, env.ERROR_PAGE, object);
+        }
+    }
+    else {
+        const object = await env.ASSETS.getWithMetadata(env.INDEX_PAGE);
+        if (object.value) {
+            return await respond(200, env.INDEX_PAGE, object);
+        }
+    }
+    return new Response("Page Not Found", { status: 404 });
+    async function lookupCache() {
+        const cache = caches.default;
+        const r = await cache.match(request.url);
+        // cache does not exist
+        if (!r)
+            return;
+        // cache exists but etag does not match
+        if (r.headers.get("etag") !== __ASSET_MANIFEST__[filePath])
+            return;
+        // cache exists
+        return r;
+    }
+    async function saveCache(response) {
+        const cache = caches.default;
+        await cache.put(request.url, response.clone());
+    }
+    async function respond(status, filePath, object) {
+        // build response
+        const headers = new Headers();
+        if (__ASSET_MANIFEST__[filePath]) {
+            headers.set("etag", __ASSET_MANIFEST__[filePath]);
+            headers.set("content-type", object.metadata.contentType);
+            headers.set("cache-control", object.metadata.cacheControl);
+        }
+        // TODO: do we need base64 encoded here?
+        // const response = new Response(base64ToArrayBuffer(object.value), {
+        const response = new Response(object.value, {
+            status,
+            headers,
+        });
+        if (request.method === "GET") {
+            await saveCache(response);
+        }
+        return response;
+    }
+});
+//# sourceMappingURL=static-site-router.js.map

package/lib/cloudflare/static-site-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-site-router.js","sourceRoot":"","sources":["../../src/cloudflare/static-site-router.ts"],"names":[],"mappings":"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"}

package/lib/cloudflare/static-site.d.ts

@@ -0,0 +1,166 @@
+import type { BundleProps } from "../esbuild";
+import { Worker } from "./worker";
+/**
+ * Idea of using KV with timeout inspired by SST: https://github.com/sst/sst/blob/dev/platform/src/components/cloudflare/static-site.ts
+ */
+/**
+ * Properties for creating or updating a StaticSite
+ */
+export interface StaticSiteProps {
+    /**
+     * Name for the site
+     * This is mandatory - must be explicitly specified
+     */
+    name: string;
+    /**
+     * Path to the directory containing static assets
+     */
+    dir: string;
+    /**
+     * Custom Worker script to serve the site
+     * If not provided, a default script will be used
+     */
+    workerScript?: string;
+    /**
+     * Worker script format
+     * 'esm' - ECMAScript modules (default)
+     * 'cjs' - CommonJS modules
+     * @default 'esm'
+     */
+    format?: "esm" | "cjs";
+    /**
+     * Custom error page path (relative to directory)
+     * @example "404.html"
+     */
+    errorPage?: string;
+    /**
+     * Index page filename
+     * @default "index.html"
+     */
+    indexPage?: string;
+    /**
+     * Configure how the static site's assets are uploaded to KV
+     */
+    assets?: {
+        /**
+         * File options for configuring caching behavior
+         */
+        fileOptions?: {
+            /**
+             * File pattern(s) to match
+             * Can be a glob string or array of glob strings
+             */
+            files: string | string[];
+            /**
+             * Files to ignore (glob patterns)
+             */
+            ignore?: string | string[];
+            /**
+             * Cache-Control header to set for matching files
+             */
+            cacheControl: string;
+            /**
+             * Content-Type to set (overrides auto-detection)
+             */
+            contentType?: string;
+        }[];
+    };
+    /**
+     * Whether the site should be deployed to production
+     * @default true
+     */
+    production?: boolean;
+    /**
+     * Custom domain for the site
+     */
+    domain?: string | {
+        name: string;
+        redirects?: string[];
+    };
+    build?: {
+        /**
+         * Command to run before deploying the site
+         * Will be executed in the shell to build the site
+         */
+        command?: string;
+    };
+    /**
+     * Bundle options for the worker script
+     */
+    bundle?: Partial<BundleProps>;
+    /**
+     * Additional workers to route requests to.
+     */
+    routes?: {
+        [key: string]: Worker;
+    };
+}
+/**
+ * Output returned after StaticSite creation/update
+ */
+export interface StaticSiteOutput {
+    /**
+     * The ID of the site
+     */
+    id: string;
+    /**
+     * The ID of the worker
+     */
+    workerId: string;
+    /**
+     * Name for the site
+     */
+    name: string;
+    /**
+     * Path to the directory containing static assets
+     */
+    directory: string;
+    /**
+     * Worker script format
+     */
+    format?: "esm" | "cjs";
+    /**
+     * Custom error page path
+     */
+    errorPage?: string;
+    /**
+     * Index page filename
+     */
+    indexPage?: string;
+    /**
+     * Time at which the site was created
+     */
+    createdAt: number;
+    /**
+     * Time at which the site was last updated
+     */
+    updatedAt: number;
+    /**
+     * List of uploaded asset files
+     */
+    assets: string[];
+    /**
+     * Custom domain for the site
+     */
+    domain?: string | {
+        name: string;
+        redirects?: string[];
+    };
+    /**
+     * Whether the site is deployed to production
+     */
+    production?: boolean;
+    /**
+     * The URL of the deployed site
+     */
+    url?: string;
+    /**
+     * Information about the backend worker if configured
+     */
+    routes?: Record<string, string>;
+}
+declare const StaticSite_base: import("../resource").Provider<string, [props: StaticSiteProps], StaticSiteOutput>;
+export declare class StaticSite extends StaticSite_base {
+}
+export {};
+//# sourceMappingURL=static-site.d.ts.map

package/lib/cloudflare/static-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-site.d.ts","sourceRoot":"","sources":["../../src/cloudflare/static-site.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,WAAW,CAAC,EAAE;YACZ;;;eAGG;YACH,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;YAEzB;;eAEG;YACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;YAE3B;;eAEG;YACH,YAAY,EAAE,MAAM,CAAC;YAErB;;eAEG;YACH,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,EAAE,CAAC;KACL,CAAC;IAEF;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EACH,MAAM,GACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IAEN,KAAK,CAAC,EAAE;QACN;;;WAGG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE9B;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EACH,MAAM,GACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IAEN;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;;AAED,qBAAa,UAAW,SAAQ,eAiL/B;CAAG"}

package/lib/cloudflare/static-site.js

@@ -0,0 +1,161 @@
+import { exec } from "child_process";
+import { promises as fs } from "fs";
+import path from "path";
+import { promisify } from "util";
+import { apply } from "../apply";
+import { Resource } from "../resource";
+import { createCloudflareApi } from "./api";
+import { generateAssetManifest } from "./generate-asset-manifest";
+import { KVNamespace } from "./kv-namespace";
+import { uploadAssetManifest } from "./upload-asset-manifest";
+import { Worker } from "./worker";
+const __dirname = import.meta.dirname;
+export class StaticSite extends Resource("cloudflare::StaticSite", {
+    alwaysUpdate: true,
+}, async (ctx, props) => {
+    if (ctx.event === "delete") {
+        // For delete operations, we'll rely on the Worker delete to clean up
+        // Return empty output for deleted state
+        return;
+    }
+    // Validate that a name is provided
+    if (!props.name) {
+        throw new Error("StaticSite name is required - must be explicitly specified");
+    }
+    // Validate directory exists
+    if (!props.dir) {
+        throw new Error("Directory is required for StaticSite");
+    }
+    try {
+        const dirStat = await fs.stat(props.dir);
+        if (!dirStat.isDirectory()) {
+            throw new Error(`"${props.dir}" is not a directory`);
+        }
+    }
+    catch (error) {
+        throw new Error(`Directory "${props.dir}" does not exist: ${error.message}`);
+    }
+    // Run build command if provided
+    if (props.build?.command) {
+        try {
+            if (!ctx.quiet) {
+                console.log(props.build.command);
+            }
+            const execAsync = promisify(exec);
+            const { stdout, stderr } = await execAsync(props.build.command, {
+                cwd: process.cwd(),
+            });
+            if (stdout && !ctx.quiet)
+                console.log(stdout);
+        }
+        catch (error) {
+            // Log detailed error information
+            console.error(`Build command failed with exit code ${error.code}`);
+            if (error.stdout)
+                console.error(`Command stdout: ${error.stdout}`);
+            if (error.stderr)
+                console.error(`Command stderr: ${error.stderr}`);
+            // Throw a more descriptive error that includes the exit code and stderr
+            throw new Error(`Build command "${props.build.command}" failed with exit code ${error.code}:\n${error.stderr || error.message}`);
+        }
+    }
+    // Use the provided name
+    const siteName = props.name;
+    const indexPage = props.indexPage || "index.html";
+    // Create Cloudflare API client with automatic account discovery
+    const api = await createCloudflareApi();
+    // Step 1: Create or get the KV namespace for assets
+    const kv = new KVNamespace("assets", {
+        title: `${siteName}-assets`,
+    });
+    const [{ id: kvNamespaceId }, assetManifest] = await Promise.all([
+        apply(kv, {
+            quiet: ctx.quiet,
+        }),
+        generateAssetManifest(props.dir),
+    ]);
+    // Step 3: Upload assets to KV
+    await uploadAssetManifest(api, kvNamespaceId, assetManifest);
+    // Prepare the bindings for the worker
+    const bindings = {
+        ASSETS: kv,
+        INDEX_PAGE: indexPage,
+        // Add error page binding if specified
+        ...(props.errorPage ? { ERROR_PAGE: props.errorPage } : {}),
+    };
+    const routes = {};
+    // Create backend worker if configured
+    if (props.routes) {
+        for (const [path, worker] of Object.entries(props.routes)) {
+            // @ts-ignore - TODO: need to use Resolved<Worker> to get the string ...
+            routes[path] = worker.id;
+            bindings[`ROUTE_${worker.id}`] = worker;
+        }
+    }
+    // Create asset manifest banner for static site router
+    const assetManifestBanner = `const __ASSET_MANIFEST__ = ${JSON.stringify(Object.fromEntries(assetManifest.map((item) => [item.key, item.hash])))};\n`;
+    const bundleOptions = {
+        ...props.bundle,
+        options: {
+            ...props.bundle?.options,
+            banner: {
+                js: assetManifestBanner,
+                ...props.bundle?.options?.banner,
+            },
+        },
+    };
+    // Determine the entrypoint file - check for .ts first, fallback to .js
+    let entrypointFile = "static-site-router.js";
+    try {
+        const tsFile = path.resolve(__dirname, "static-site-router.ts");
+        await fs.access(tsFile);
+        // If we reach here, the TypeScript file exists
+        entrypointFile = "static-site-router.ts";
+    }
+    catch (error) {
+        // TypeScript file doesn't exist, use JavaScript (default)
+    }
+    const worker = new Worker("worker", {
+        name: siteName,
+        url: true,
+        format: props.format || "esm",
+        // If a custom worker script is provided, use it, otherwise use the entrypoint from router
+        ...(props.workerScript
+            ? { script: props.workerScript }
+            : {
+                entrypoint: path.resolve(__dirname, entrypointFile),
+                bundle: bundleOptions,
+            }),
+        bindings,
+        env: {
+            ...Object.fromEntries(Object.entries(routes).map(([key, value]) => [
+                `__ROUTE_${value}`,
+                key,
+            ])),
+        },
+    }, 
+    // place a dependency on the namespace
+    kv.id);
+    // Get current timestamp
+    const now = Date.now();
+    // Construct the output
+    const output = {
+        id: siteName,
+        workerId: worker.id,
+        name: siteName,
+        directory: props.dir,
+        format: props.format || "esm",
+        errorPage: props.errorPage,
+        indexPage,
+        assets: assetManifest.map((item) => item.key),
+        createdAt: ctx.output?.createdAt || now,
+        updatedAt: now,
+        domain: props.domain,
+        production: props.production !== false,
+        url: worker.url,
+        routes,
+    };
+    return output;
+}) {
+}
+//# sourceMappingURL=static-site.js.map

package/lib/cloudflare/static-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-site.js","sourceRoot":"","sources":["../../src/cloudflare/static-site.ts"],"names":[],"mappings":"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"}

package/lib/cloudflare/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Cloudflare API response format
+ */
+export interface CloudflareApiResponse<T> {
+    /**
+     * API response result
+     */
+    result: T;
+    /**
+     * Success status
+     */
+    success: boolean;
+    /**
+     * Error details if success is false
+     */
+    errors: CloudflareApiError[];
+    /**
+     * Response messages
+     */
+    messages: string[];
+    /**
+     * Result information (typically for paginated results)
+     */
+    result_info?: {
+        page: number;
+        per_page: number;
+        total_pages: number;
+        count: number;
+        total_count: number;
+    };
+}
+/**
+ * Cloudflare API error format
+ */
+export interface CloudflareApiError {
+    /**
+     * Error code
+     */
+    code: number;
+    /**
+     * Error message
+     */
+    message: string;
+}
+/**
+ * Helper to extract and handle Cloudflare API errors
+ *
+ * @param response Fetch response object
+ * @returns Formatted error message
+ */
+export declare function extractCloudflareError(response: Response): Promise<string>;
+//# sourceMappingURL=types.d.ts.map

package/lib/cloudflare/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cloudflare/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC;IAEV;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAE7B;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/lib/cloudflare/types.js

@@ -0,0 +1,21 @@
+/**
+ * Helper to extract and handle Cloudflare API errors
+ *
+ * @param response Fetch response object
+ * @returns Formatted error message
+ */
+export async function extractCloudflareError(response) {
+    try {
+        const data = (await response.json());
+        if (data.errors && data.errors.length > 0) {
+            return data.errors.map((e) => `Error ${e.code}: ${e.message}`).join(", ");
+        }
+        else {
+            return `HTTP ${response.status}: ${response.statusText}`;
+        }
+    }
+    catch (e) {
+        return `HTTP ${response.status}: ${response.statusText}`;
+    }
+}
+//# sourceMappingURL=types.js.map