alchemy 0.1.16 → 0.1.17

package/lib/cloudflare/api.js

@@ -0,0 +1,184 @@
+import { getCloudflareHeaders } from "./auth";
+/**
+ * Creates a CloudflareApi instance with automatic account ID discovery if not provided
+ *
+ * @param options API options
+ * @returns Promise resolving to a CloudflareApi instance
+ */
+export async function createCloudflareApi(options = {}) {
+    try {
+        return new CloudflareApi({
+            ...options,
+            accountId: options.accountId ||
+                process.env.CLOUDFLARE_ACCOUNT_ID ||
+                (await fetchAccountId()),
+        });
+    }
+    catch (error) {
+        console.error("Error during Cloudflare account ID discovery:", error);
+        throw new Error("Failed to automatically discover Cloudflare account ID. Please provide an account ID explicitly or ensure your API token/key has sufficient permissions.");
+    }
+}
+/**
+ * Cloudflare API client using raw fetch
+ */
+export class CloudflareApi {
+    /** Base URL for Cloudflare API */
+    baseUrl;
+    /** Cloudflare API Key */
+    apiKey;
+    /** Cloudflare account ID */
+    accountId;
+    /** Cloudflare zone ID (if provided) */
+    zoneId;
+    /** User email (when using API Key auth) */
+    email;
+    /** Auth options for making requests */
+    authOptions;
+    /**
+     * Create a new Cloudflare API client
+     * Use createCloudflareApi factory function instead of direct constructor
+     * for automatic account ID discovery.
+     *
+     * @param options API options
+     */
+    constructor(options = {}) {
+        this.baseUrl = "https://api.cloudflare.com/client/v4";
+        const apiKey = options.apiKey || process.env.CLOUDFLARE_API_KEY || undefined;
+        if (!apiKey) {
+            throw new Error("No API key provided. Use createCloudflareApi() instead for automatic account discovery.");
+        }
+        this.apiKey = apiKey;
+        this.email = options.email || process.env.CLOUDFLARE_EMAIL;
+        if (!this.email) {
+            throw new Error("No email provided. Use createCloudflareApi() instead for automatic account discovery.");
+        }
+        // Get account ID from options or environment
+        this.accountId =
+            options.accountId || process.env.CLOUDFLARE_ACCOUNT_ID || "";
+        if (!this.accountId) {
+            throw new Error("No account ID provided. Use createCloudflareApi() instead for automatic account discovery.");
+        }
+        // Zone ID is optional for some operations
+        this.zoneId = options.zoneId || process.env.CLOUDFLARE_ZONE_ID || null;
+        // Store auth options for later use
+        this.authOptions = {
+            email: this.email,
+        };
+    }
+    /**
+     * Make a fetch request to the Cloudflare API
+     *
+     * @param path API path (without base URL)
+     * @param init Fetch init options
+     * @returns Raw Response object from fetch
+     */
+    async fetch(path, init = {}) {
+        // Get content type from init headers or default to application/json
+        let contentType = "application/json";
+        if (init.headers) {
+            const initHeaders = init.headers;
+            if (initHeaders["Content-Type"]) {
+                contentType = initHeaders["Content-Type"];
+            }
+        }
+        // Get auth headers (async now)
+        const authHeaders = await getCloudflareHeaders(contentType, this.authOptions);
+        // Combine all headers
+        const combinedHeaders = {
+            ...authHeaders,
+        };
+        // Add headers from init if provided
+        if (init.headers) {
+            const initHeadersObj = init.headers;
+            Object.keys(initHeadersObj).forEach((key) => {
+                combinedHeaders[key] = initHeadersObj[key];
+            });
+        }
+        // If using FormData, remove Content-Type to let browser set it with boundary
+        if (init.body instanceof FormData) {
+            delete combinedHeaders["Content-Type"];
+        }
+        const url = `${this.baseUrl}${path}`;
+        // Make the request
+        return fetch(url, {
+            ...init,
+            headers: combinedHeaders,
+        });
+    }
+    /**
+     * Helper for GET requests
+     */
+    async get(path, init = {}) {
+        return this.fetch(path, { ...init, method: "GET" });
+    }
+    /**
+     * Helper for HEAD requests
+     */
+    async head(path, init = {}) {
+        return this.fetch(path, { ...init, method: "HEAD" });
+    }
+    /**
+     * Helper for POST requests
+     */
+    async post(path, body, init = {}) {
+        const requestBody = body instanceof FormData
+            ? body
+            : typeof body === "string"
+                ? body
+                : JSON.stringify(body);
+        return this.fetch(path, { ...init, method: "POST", body: requestBody });
+    }
+    /**
+     * Helper for PUT requests
+     */
+    async put(path, body, init = {}) {
+        const requestBody = body instanceof FormData ? body : JSON.stringify(body);
+        return this.fetch(path, { ...init, method: "PUT", body: requestBody });
+    }
+    /**
+     * Helper for PATCH requests
+     */
+    async patch(path, body, init = {}) {
+        return this.fetch(path, {
+            ...init,
+            method: "PATCH",
+            body: JSON.stringify(body),
+        });
+    }
+    /**
+     * Helper for DELETE requests
+     */
+    async delete(path, init = {}) {
+        return this.fetch(path, { ...init, method: "DELETE" });
+    }
+}
+/**
+ * Create a temporary API client for bootstrapping
+ * This client can only be used to fetch the account ID
+ */
+async function fetchAccountId() {
+    // Create a minimal API client for bootstrapping
+    const baseUrl = "https://api.cloudflare.com/client/v4";
+    // Get content type and auth headers
+    const authHeaders = await getCloudflareHeaders("application/json");
+    // Make the request to get accounts
+    const response = await fetch(`${baseUrl}/accounts`, {
+        method: "GET",
+        headers: authHeaders,
+    });
+    if (!response.ok) {
+        const errorData = await response.json().catch(() => ({
+            errors: [{ message: response.statusText }],
+        }));
+        throw new Error(`Error fetching Cloudflare accounts: ${errorData.errors?.[0]?.message || response.statusText}`);
+    }
+    const data = await response.json();
+    const accounts = data.result;
+    if (!accounts || accounts.length === 0) {
+        throw new Error("No Cloudflare accounts found. Check your API token/key permissions.");
+    }
+    // Return the first account ID
+    return accounts[0].id;
+}
+//# sourceMappingURL=api.js.map

package/lib/cloudflare/api.js.map

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

package/lib/cloudflare/asset-manifest.d.ts

@@ -0,0 +1,15 @@
+export type AssetManifest = AssetManifestEntry[];
+export interface AssetManifestEntry {
+    source: string;
+    key: string;
+    hash: string;
+    cacheControl: string;
+    contentType?: string;
+}
+export interface FileOption {
+    files: string | string[];
+    cacheControl: string;
+    contentType?: string;
+    ignore?: string[];
+}
+//# sourceMappingURL=asset-manifest.d.ts.map

package/lib/cloudflare/asset-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-manifest.d.ts","sourceRoot":"","sources":["../../src/cloudflare/asset-manifest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,kBAAkB,EAAE,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/lib/cloudflare/asset-manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asset-manifest.js.map

package/lib/cloudflare/asset-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-manifest.js","sourceRoot":"","sources":["../../src/cloudflare/asset-manifest.ts"],"names":[],"mappings":""}

package/lib/cloudflare/auth.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Authentication options for Cloudflare API
+ */
+export interface CloudflareAuthOptions {
+    /**
+     * If true, throw an error when no authentication is found
+     * @default true
+     */
+    required?: boolean;
+    /**
+     * Email to use with API Key
+     * If not provided, will attempt to discover from Cloudflare API
+     */
+    email?: string;
+}
+/**
+ * Authentication headers for Cloudflare API
+ */
+export interface CloudflareAuthHeaders {
+    /**
+     * Authentication headers to use with fetch
+     */
+    headers: Record<string, string>;
+    /**
+     * Type of authentication being used
+     */
+    type: "token" | "key" | "none";
+    /**
+     * User email (only present when using API Key auth)
+     */
+    email?: string;
+}
+/**
+ * Get authentication headers for Cloudflare API
+ *
+ * Priority:
+ * 1. API Token (CLOUDFLARE_API_TOKEN) - Recommended by Cloudflare
+ * 2. API Key (CLOUDFLARE_API_KEY) - Will attempt to discover email automatically
+ *
+ * @param options Authentication options
+ * @returns Authentication headers
+ */
+export declare function getCloudflareAuth(options?: CloudflareAuthOptions): Promise<CloudflareAuthHeaders>;
+/**
+ * Get headers for a Cloudflare API request, including content-type
+ *
+ * @param contentType Content type for the request
+ * @param options Authentication options
+ * @returns Complete headers for the request
+ */
+export declare function getCloudflareHeaders(contentType?: string, options?: CloudflareAuthOptions): Promise<Record<string, string>>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/cloudflare/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAeD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAkEhC;AAyCD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,SAAqB,EAChC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOjC"}

package/lib/cloudflare/auth.js

@@ -0,0 +1,114 @@
+/**
+ * Get authentication headers for Cloudflare API
+ *
+ * Priority:
+ * 1. API Token (CLOUDFLARE_API_TOKEN) - Recommended by Cloudflare
+ * 2. API Key (CLOUDFLARE_API_KEY) - Will attempt to discover email automatically
+ *
+ * @param options Authentication options
+ * @returns Authentication headers
+ */
+export async function getCloudflareAuth(options = {}) {
+    const { required = true } = options;
+    // Check for API Token (preferred method)
+    const apiToken = process.env.CLOUDFLARE_API_TOKEN;
+    if (apiToken) {
+        return {
+            headers: {
+                Authorization: `Bearer ${apiToken}`,
+            },
+            type: "token",
+        };
+    }
+    // Check for API Key
+    const apiKey = process.env.CLOUDFLARE_API_KEY;
+    if (apiKey) {
+        // If email is provided directly, use it
+        const providedEmail = options.email || process.env.CLOUDFLARE_EMAIL;
+        if (providedEmail) {
+            return {
+                headers: {
+                    "X-Auth-Key": apiKey,
+                    "X-Auth-Email": providedEmail,
+                },
+                type: "key",
+                email: providedEmail,
+            };
+        }
+        // Otherwise, try to discover email from Cloudflare API
+        try {
+            const email = await getUserEmailFromApiKey(apiKey);
+            return {
+                headers: {
+                    "X-Auth-Key": apiKey,
+                    "X-Auth-Email": email,
+                },
+                type: "key",
+                email,
+            };
+        }
+        catch (error) {
+            console.error("Failed to discover email from API key:", error);
+            throw new Error("Failed to automatically discover email for API Key authentication.\n" +
+                "Options:\n" +
+                "1. Set CLOUDFLARE_EMAIL environment variable\n" +
+                "2. Use CLOUDFLARE_API_TOKEN instead (recommended by Cloudflare)");
+        }
+    }
+    // No authentication found
+    if (required) {
+        throw new Error("Cloudflare authentication required. Set either:\n" +
+            "1. CLOUDFLARE_API_TOKEN (recommended by Cloudflare)\n" +
+            "   Generate a token at: https://dash.cloudflare.com/profile/api-tokens\n" +
+            "2. CLOUDFLARE_API_KEY environment variable");
+    }
+    return {
+        headers: {},
+        type: "none",
+    };
+}
+/**
+ * Fetch the user's email from Cloudflare API using API Key
+ *
+ * @param apiKey The Cloudflare API key
+ * @returns The user's email
+ */
+async function getUserEmailFromApiKey(apiKey) {
+    try {
+        const baseUrl = "https://api.cloudflare.com/client/v4";
+        // Call the /user endpoint to get user information
+        const response = await fetch(`${baseUrl}/user`, {
+            headers: {
+                "Content-Type": "application/json",
+                "X-Auth-Key": apiKey,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get user information: ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.success || !data.result || !data.result.email) {
+            throw new Error("Cloudflare API did not return valid user information");
+        }
+        return data.result.email;
+    }
+    catch (error) {
+        console.error("Error retrieving email from Cloudflare API:", error);
+        throw new Error("Failed to automatically discover email for API Key authentication");
+    }
+}
+/**
+ * Get headers for a Cloudflare API request, including content-type
+ *
+ * @param contentType Content type for the request
+ * @param options Authentication options
+ * @returns Complete headers for the request
+ */
+export async function getCloudflareHeaders(contentType = "application/json", options = {}) {
+    const auth = await getCloudflareAuth(options);
+    return {
+        "Content-Type": contentType,
+        ...auth.headers,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/lib/cloudflare/auth.js.map

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

package/lib/cloudflare/bindings.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Type definitions for Cloudflare Worker bindings
+ * Based on Cloudflare API documentation:
+ * https://developers.cloudflare.com/api/resources/workers/subresources/scripts/methods/update/
+ */
+import type { Bucket } from "./bucket";
+import type { DurableObjectNamespace } from "./durable-object-namespace";
+import type { KVNamespace } from "./kv-namespace";
+import type { Worker } from "./worker";
+export type Bindings = {
+    [bindingName: string]: Binding;
+};
+/**
+ * L2 Binding Resources.
+ */
+export type Binding = DurableObjectNamespace | KVNamespace | Worker | Bucket | string;
+/**
+ * Union type for all Worker binding types (API spec)
+ */
+export type WorkerBindingSpec = WorkerBindingAI | WorkerBindingAnalyticsEngine | WorkerBindingAssets | WorkerBindingBrowserRendering | WorkerBindingD1 | WorkerBindingDispatchNamespace | WorkerBindingDurableObjectNamespace | WorkerBindingHyperdrive | WorkerBindingJson | WorkerBindingKVNamespace | WorkerBindingMTLSCertificate | WorkerBindingPlainText | WorkerBindingQueue | WorkerBindingR2Bucket | WorkerBindingSecretText | WorkerBindingService | WorkerBindingStaticContent | WorkerBindingTailConsumer | WorkerBindingVectorize | WorkerBindingVersionMetadata | WorkerBindingWasmModule;
+/**
+ * AI binding type
+ */
+export interface WorkerBindingAI {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for AI binding */
+    type: "ai";
+}
+/**
+ * Analytics Engine binding type
+ */
+export interface WorkerBindingAnalyticsEngine {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Analytics Engine binding */
+    type: "analytics_engine";
+    /** Dataset name */
+    dataset: string;
+}
+/**
+ * Assets binding type
+ */
+export interface WorkerBindingAssets {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Assets binding */
+    type: "assets";
+}
+/**
+ * Browser Rendering binding type
+ */
+export interface WorkerBindingBrowserRendering {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Browser Rendering binding */
+    type: "browser_rendering";
+}
+/**
+ * D1 database binding type
+ */
+export interface WorkerBindingD1 {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for D1 binding */
+    type: "d1";
+    /** D1 database ID */
+    id: string;
+}
+/**
+ * Dispatch Namespace binding type
+ */
+export interface WorkerBindingDispatchNamespace {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Dispatch Namespace binding */
+    type: "dispatch_namespace";
+    /** Namespace identifier */
+    namespace: string;
+    /** Optional outbound service */
+    outbound?: any;
+}
+/**
+ * Durable Object Namespace binding type
+ */
+export interface WorkerBindingDurableObjectNamespace {
+    /**
+     * The stable ID of the binding
+     * @internal
+     */
+    stableId?: string;
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Durable Object Namespace binding */
+    type: "durable_object_namespace";
+    /** Durable Object class name */
+    class_name: string;
+    /** Script name that contains the Durable Object */
+    script_name?: string;
+    /** Environment */
+    environment?: string;
+    /** Namespace ID */
+    namespace_id?: string;
+}
+/**
+ * Hyperdrive binding type
+ */
+export interface WorkerBindingHyperdrive {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Hyperdrive binding */
+    type: "hyperdrive";
+    /** Hyperdrive ID */
+    id: string;
+}
+/**
+ * JSON binding type
+ */
+export interface WorkerBindingJson {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for JSON binding */
+    type: "json";
+    /** JSON value */
+    json: any;
+}
+/**
+ * KV Namespace binding type
+ */
+export interface WorkerBindingKVNamespace {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for KV Namespace binding */
+    type: "kv_namespace";
+    /** KV Namespace ID */
+    namespace_id: string;
+}
+/**
+ * MTLS Certificate binding type
+ */
+export interface WorkerBindingMTLSCertificate {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for MTLS Certificate binding */
+    type: "mtls_certificate";
+    /** Certificate ID */
+    certificate_id: string;
+}
+/**
+ * Plain Text binding type
+ */
+export interface WorkerBindingPlainText {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Plain Text binding */
+    type: "plain_text";
+    /** Text content */
+    text: string;
+}
+/**
+ * Queue binding type
+ */
+export interface WorkerBindingQueue {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Queue binding */
+    type: "queue";
+    /** Queue name */
+    queue_name: string;
+}
+/**
+ * R2 Bucket binding type
+ */
+export interface WorkerBindingR2Bucket {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for R2 Bucket binding */
+    type: "r2_bucket";
+    /** Bucket name */
+    bucket_name: string;
+}
+/**
+ * Secret Text binding type
+ */
+export interface WorkerBindingSecretText {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Secret Text binding */
+    type: "secret_text";
+    /** Secret value */
+    text: string;
+}
+/**
+ * Service binding type
+ */
+export interface WorkerBindingService {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Service binding */
+    type: "service";
+    /** Service name */
+    service: string;
+    /** Environment */
+    environment?: string;
+    /** Service namespace */
+    namespace?: string;
+}
+/**
+ * Tail Consumer binding type
+ */
+export interface WorkerBindingTailConsumer {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Tail Consumer binding */
+    type: "tail_consumer";
+    /** Service name */
+    service: string;
+}
+/**
+ * Vectorize binding type
+ */
+export interface WorkerBindingVectorize {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Vectorize binding */
+    type: "vectorize";
+    /** Index name */
+    index_name: string;
+}
+/**
+ * Version Metadata binding type
+ */
+export interface WorkerBindingVersionMetadata {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Version Metadata binding */
+    type: "version_metadata";
+}
+/**
+ * WASM Module binding type
+ */
+export interface WorkerBindingWasmModule {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for WASM Module binding */
+    type: "wasm_module";
+    /** Module name */
+    module: string;
+}
+/**
+ * Static content binding for Cloudflare Workers
+ * Used for Workers Sites and static assets
+ */
+export interface WorkerBindingStaticContent {
+    /** The name of the binding */
+    name: string;
+    /** Type identifier for Static Content binding */
+    type: "static_content";
+}
+//# sourceMappingURL=bindings.d.ts.map

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

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

package/lib/cloudflare/bindings.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bindings.js.map

package/lib/cloudflare/bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/cloudflare/bindings.ts"],"names":[],"mappings":""}