alchemy 0.1.11 → 0.1.12

package/lib/cloudflare/state.d.ts

@@ -0,0 +1,83 @@
+import type { KVNamespace } from "@cloudflare/workers-types";
+import type { State, StateStore } from "../state";
+/**
+ * Options for CloudflareStateStore
+ */
+export interface CloudflareStateStoreOptions {
+    /**
+     * The prefix to use for keys in the KV namespace
+     * This allows multiple state stores to use the same KV namespace
+     */
+    prefix?: string;
+}
+/**
+ * State store implementation using Cloudflare KV Namespace
+ */
+export declare class CloudflareStateStore implements StateStore {
+    private namespace;
+    private prefix;
+    /**
+     * Create a new CloudflareStateStore
+     *
+     * @param namespace The KV namespace to use for storing state
+     * @param options Options for the state store
+     */
+    constructor(namespace: KVNamespace, options?: CloudflareStateStoreOptions);
+    /**
+     * No initialization needed for KV namespaces as they are pre-provisioned
+     */
+    init(): Promise<void>;
+    /**
+     * KV namespaces cannot be deleted programmatically
+     */
+    deinit(): Promise<void>;
+    /**
+     * List all resources in the state store
+     */
+    list(): Promise<string[]>;
+    /**
+     * Count the number of items in the state store
+     */
+    count(): Promise<number>;
+    /**
+     * Get a state by key
+     *
+     * @param key The key to look up
+     * @returns The state or undefined if not found
+     */
+    get(key: string): Promise<State | undefined>;
+    /**
+     * Get multiple states by their keys
+     *
+     * @param ids Array of keys to fetch
+     * @returns Record mapping keys to their states
+     */
+    getBatch(ids: string[]): Promise<Record<string, State>>;
+    /**
+     * Get all states in the store
+     *
+     * @returns Record mapping all keys to their states
+     */
+    all(): Promise<Record<string, State>>;
+    /**
+     * Set a state for a key
+     *
+     * @param key The key to set
+     * @param value The state to store
+     */
+    set(key: string, value: State): Promise<void>;
+    /**
+     * Delete a state by key
+     *
+     * @param key The key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Get the namespaced key for storage
+     *
+     * @param key The original key
+     * @returns The key with prefix for use in the KV namespace
+     */
+    private getNamespacedKey;
+}
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/cloudflare/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,UAAU;IACrD,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;OAKG;gBAED,SAAS,EAAE,WAAW,EACtB,OAAO,GAAE,2BAAgC;IAM3C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAKlD;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAgB7D;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAK3C;;;;;OAKG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;CAGzB"}

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,10 @@
+export interface Env {
+    ASSETS: KVNamespace;
+    INDEX_PAGE: string;
+    ERROR_PAGE?: 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":"AAMA,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;;mBAGsB,OAAO,OAAO,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;;AAD5D,wBAqFE"}

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

@@ -0,0 +1,88 @@
+export default {
+    async fetch(request, env) {
+        const url = new URL(request.url);
+        console.log("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);
+        }
+        // Handle failed to render error page
+        return new Response("Page Not Found", { status: 404 });
+        async function lookupCache() {
+            const cache = caches.default;
+            const r = await cache.match(request);
+            // 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, 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;
+        }
+    },
+};
+function base64ToArrayBuffer(base64) {
+    const binaryString = atob(base64);
+    const len = binaryString.length;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes.buffer;
+}
+//# 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 type { WorkerProps } 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;
+    /**
+     * Routes to associate with this site
+     * Format: example.com/* or *.example.com/*
+     */
+    routes?: 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;
+        }[];
+    };
+    /**
+     * Additional Worker bindings to include
+     */
+    additionalBindings?: WorkerProps["bindings"];
+    /**
+     * 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?: Partial<BundleProps>;
+}
+/**
+ * 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;
+    /**
+     * Routes to associate with this site
+     */
+    routes?: 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;
+}
+declare const StaticSite_base: import("../resource").Provider<"cloudflare::StaticSite", [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;AAO9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;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;;OAEG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAE7C;;;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,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B;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,MAAM,EAAE,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;CACd;;AAED,qBAAa,UAAW,SAAQ,eAyK/B;CAAG"}

package/lib/cloudflare/static-site.js

@@ -0,0 +1,152 @@
+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";
+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 {
+            console.log(props.build.command);
+            const execAsync = promisify(exec);
+            const { stdout, stderr } = await execAsync(props.build.command, {
+                cwd: process.cwd(),
+            });
+            if (stdout)
+                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 namespace = new KVNamespace("assets", {
+        title: `${siteName}-assets`,
+    });
+    const [{ id: kvNamespaceId }, assetManifest] = await Promise.all([
+        apply(namespace),
+        generateAssetManifest(props.dir),
+    ]);
+    // Step 3: Upload assets to KV
+    await uploadAssetManifest(api, kvNamespaceId, assetManifest);
+    // Define the worker script path
+    const routerScriptPath = path.resolve(__dirname, "static-site-router.ts");
+    // Prepare the bindings for the worker
+    const bindings = [
+        {
+            name: "ASSETS",
+            type: "kv_namespace",
+            namespace_id: kvNamespaceId,
+        },
+        {
+            name: "INDEX_PAGE",
+            type: "plain_text",
+            text: indexPage,
+        },
+    ];
+    // Add error page binding if specified
+    if (props.errorPage) {
+        bindings.push({
+            name: "ERROR_PAGE",
+            type: "plain_text",
+            text: props.errorPage,
+        });
+    }
+    // Add any additional bindings
+    if (props.additionalBindings) {
+        bindings.push(...props.additionalBindings);
+    }
+    // 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 worker = new Worker("worker", {
+        name: siteName,
+        url: true,
+        format: props.format || "esm",
+        routes: props.routes || [],
+        // If a custom worker script is provided, use it, otherwise use the entrypoint from router
+        ...(props.workerScript
+            ? { script: props.workerScript }
+            : {
+                entrypoint: routerScriptPath,
+                bundleOptions: {
+                    ...props.bundle,
+                    options: {
+                        ...props.bundle?.options,
+                        banner: {
+                            js: assetManifestBanner,
+                            ...props.bundle?.options?.banner,
+                        },
+                    },
+                },
+            }),
+        bindings,
+    }, 
+    // place a dependency on the namespace
+    namespace.id);
+    // Step 4: Create or update the worker
+    const { id: workerId, url } = await apply(worker);
+    // Get current timestamp
+    const now = Date.now();
+    // Construct the output
+    const output = {
+        id: siteName,
+        workerId,
+        name: siteName,
+        directory: props.dir,
+        routes: props.routes || [],
+        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,
+    };
+    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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"}