alchemy 0.2.0 → 0.2.1

package/lib/cloudflare/index.d.ts

@@ -5,3 +5,5 @@ export * from "./kv-namespace";
 export * from "./state";
 export * from "./static-site";
 export * from "./worker";
+export * from "./wrangler.json";
+export * from "./zone";

package/lib/cloudflare/index.js

@@ -5,3 +5,5 @@ export * from "./kv-namespace";
 export * from "./state";
 export * from "./static-site";
 export * from "./worker";
+export * from "./wrangler.json";
+export * from "./zone";

package/lib/cloudflare/static-site.js

@@ -25,15 +25,6 @@ export const StaticSite = Resource("cloudflare::StaticSite", {
     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 {
@@ -58,6 +49,15 @@ export const StaticSite = Resource("cloudflare::StaticSite", {
             throw new Error(`Build command "${props.build.command}" failed with exit code ${error.code}:\n${error.stderr || error.message}`);
         }
     }
+    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}`);
+    }
     // Use the provided name
     const siteName = props.name;
     const indexPage = props.indexPage || "index.html";

package/lib/cloudflare/worker.js

@@ -272,7 +272,7 @@ async function assertWorkerDoesNotExist(ctx, api, workerName) {
         throw new Error(`Worker with name '${workerName}' already exists. Please use a unique name.`);
     }
     else {
-        throw new Error(`Error checking if worker exists: ${response.status} ${response.statusText}`);
+        throw new Error(`Error checking if worker exists: ${response.status} ${response.statusText} ${await response.text()}`);
     }
 }
 async function bundleWorkerScript(props) {

package/lib/cloudflare/wrangler.json.d.ts

@@ -0,0 +1,243 @@
+import type { Context } from "../context";
+import { Resource } from "../resource";
+/**
+ * Properties for wrangler.json configuration file
+ */
+export interface WranglerJsonProps {
+    /**
+     * The name of your worker
+     */
+    name: string;
+    /**
+     * The directory containing your worker entry point
+     * @default "src"
+     */
+    main?: string;
+    /**
+     * The entry point for your worker
+     * @default "index.ts" or "index.js"
+     */
+    entrypoint?: string;
+    /**
+     * The directory to store build artifacts
+     * @default "dist"
+     */
+    outdir?: string;
+    /**
+     * The directory to serve static assets from
+     */
+    assets?: string;
+    /**
+     * Minify the worker script
+     * @default true
+     */
+    minify?: boolean;
+    /**
+     * Node.js compatibility mode
+     * @default false
+     */
+    node_compat?: boolean;
+    /**
+     * First-party worker service bindings
+     */
+    services?: Array<{
+        /**
+         * Binding name
+         */
+        name: string;
+        /**
+         * Service environment
+         */
+        environment?: string;
+    }>;
+    /**
+     * Worker environment variables
+     */
+    vars?: Record<string, string>;
+    /**
+     * KV Namespace bindings
+     */
+    kv_namespaces?: Array<{
+        /**
+         * Binding name
+         */
+        binding: string;
+        /**
+         * KV namespace ID
+         */
+        id: string;
+        /**
+         * Preview KV namespace ID
+         */
+        preview_id?: string;
+    }>;
+    /**
+     * R2 bucket bindings
+     */
+    r2_buckets?: Array<{
+        /**
+         * Binding name
+         */
+        binding: string;
+        /**
+         * Bucket name
+         */
+        bucket_name: string;
+        /**
+         * Preview bucket name
+         */
+        preview_bucket_name?: string;
+    }>;
+    /**
+     * D1 database bindings
+     */
+    d1_databases?: Array<{
+        /**
+         * Binding name
+         */
+        binding: string;
+        /**
+         * Database name
+         */
+        database_name: string;
+        /**
+         * Database ID
+         */
+        database_id: string;
+        /**
+         * Preview database ID
+         */
+        preview_database_id?: string;
+    }>;
+    /**
+     * Durable Object bindings
+     */
+    durable_objects?: {
+        /**
+         * Durable Object bindings
+         */
+        bindings: Array<{
+            /**
+             * Binding name
+             */
+            name: string;
+            /**
+             * Class name
+             */
+            class_name: string;
+            /**
+             * Script name
+             */
+            script_name?: string;
+            /**
+             * Environment name
+             */
+            environment?: string;
+        }>;
+    };
+    /**
+     * Queue bindings
+     */
+    queues?: {
+        /**
+         * Producer bindings
+         */
+        producers?: Array<{
+            /**
+             * Binding name
+             */
+            binding: string;
+            /**
+             * Queue name
+             */
+            queue: string;
+        }>;
+        /**
+         * Consumer configuration
+         */
+        consumers?: Array<{
+            /**
+             * Queue name
+             */
+            queue: string;
+            /**
+             * Maximum batch size
+             */
+            max_batch_size?: number;
+            /**
+             * Maximum batch timeout
+             */
+            max_batch_timeout?: number;
+            /**
+             * Maximum retries
+             */
+            max_retries?: number;
+            /**
+             * Dead letter queue
+             */
+            dead_letter_queue?: string;
+        }>;
+    };
+    /**
+     * Analytics Engine bindings
+     */
+    analytics_engine_datasets?: Array<{
+        /**
+         * Binding name
+         */
+        binding: string;
+        /**
+         * Dataset name
+         */
+        dataset?: string;
+    }>;
+    /**
+     * Route configuration
+     */
+    routes?: Array<string>;
+    /**
+     * Triggers configuration
+     */
+    triggers?: {
+        /**
+         * Cron triggers
+         */
+        crons: Array<string>;
+    };
+    /**
+     * Worker compatibility date
+     */
+    compatibility_date?: string;
+    /**
+     * Worker compatibility flags
+     */
+    compatibility_flags?: Array<string>;
+    /**
+     * Worker usage model
+     * "bundled" - Includes resources like CPU and memory. Better for consistent workloads.
+     * "unbound" - Pay only for what you use. Better for sporadic workloads.
+     */
+    usage_model?: "bundled" | "unbound";
+    /**
+     * Path to the wrangler.json file
+     * @internal
+     */
+    path?: string;
+}
+/**
+ * Output returned after WranglerJson creation/update
+ */
+export interface WranglerJson extends Resource<"cloudflare::WranglerJson">, WranglerJsonProps {
+    /**
+     * Time at which the file was created
+     */
+    createdAt: number;
+    /**
+     * Time at which the file was last updated
+     */
+    updatedAt: number;
+}
+/**
+ * Resource for managing wrangler.json configuration files
+ */
+export declare const WranglerJson: ((this: Context<WranglerJson>, id: string, props: WranglerJsonProps) => Promise<WranglerJson>) | (((this: any, id: string, props: WranglerJsonProps) => never) & (new (_: never) => never));

package/lib/cloudflare/wrangler.json.js

@@ -0,0 +1,35 @@
+import * as fs from "fs/promises";
+import { Resource } from "../resource";
+/**
+ * Resource for managing wrangler.json configuration files
+ */
+export const WranglerJson = Resource("cloudflare::WranglerJson", async function (id, props) {
+    // Default path is wrangler.json in current directory
+    const filePath = props.path || "wrangler.json";
+    if (this.phase === "delete") {
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            // Ignore errors if file doesn't exist
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        return this.destroy();
+    }
+    // Create or update the file
+    const config = {
+        ...props,
+        // Remove internal path property
+        path: undefined,
+    };
+    // Write the file
+    await fs.writeFile(filePath, JSON.stringify(config, null, 2));
+    // Return the resource
+    return this({
+        ...props,
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+    });
+});

package/lib/cloudflare/zone-settings.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Common response fields for all settings
+ */
+export interface CloudflareSettingBase {
+    /**
+     * The identifier of the setting
+     */
+    id: string;
+    /**
+     * When the setting was last modified
+     */
+    modified_on: string | null;
+    /**
+     * Whether the setting can be modified
+     */
+    editable: boolean;
+}
+/**
+ * Value types for each setting
+ */
+export type SSLValue = "off" | "flexible" | "full" | "strict";
+export type MinTLSVersionValue = "1.0" | "1.1" | "1.2" | "1.3";
+export type TLS13Value = "on" | "off" | "zrt";
+export type CacheLevelValue = "aggressive" | "basic" | "simplified";
+export type AlwaysUseHTTPSValue = "on" | "off";
+export type AutomaticHTTPSRewritesValue = "on" | "off";
+export type BrotliValue = "on" | "off";
+export type DevelopmentModeValue = "on" | "off";
+export type EarlyHintsValue = "on" | "off";
+export type EmailObfuscationValue = "on" | "off";
+export type HotlinkProtectionValue = "on" | "off";
+export type HTTP2Value = "on" | "off";
+export type HTTP3Value = "on" | "off";
+export type IPv6Value = "on" | "off";
+export type WebSocketsValue = "on" | "off";
+export type ZeroRTTValue = "on" | "off";
+/**
+ * Common response fields for boolean settings that use "on"/"off"
+ */
+export interface CloudflareBooleanSetting extends CloudflareSettingBase {
+    /**
+     * The value of the setting
+     */
+    value: "on" | "off";
+}
+/**
+ * Advanced DDoS protection setting
+ * @see https://developers.cloudflare.com/api/resources/zones/#advanced-ddos
+ */
+export interface AdvancedDDoSSetting extends CloudflareBooleanSetting {
+    id: "advanced_ddos";
+    value: "on" | "off";
+}
+/**
+ * Always Online setting
+ * When enabled, Cloudflare serves limited copies of web pages from the Internet Archive if your server is offline
+ */
+export interface AlwaysOnlineSetting extends CloudflareBooleanSetting {
+    id: "always_online";
+    value: "on" | "off";
+}
+/**
+ * Always Use HTTPS setting
+ * Redirects all HTTP traffic to HTTPS
+ */
+export interface AlwaysUseHTTPSSetting extends CloudflareSettingBase {
+    id: "always_use_https";
+    value: AlwaysUseHTTPSValue;
+}
+/**
+ * Automatic HTTPS Rewrites setting
+ * Automatically rewrites HTTP URLs to HTTPS
+ */
+export interface AutomaticHTTPSRewritesSetting extends CloudflareSettingBase {
+    id: "automatic_https_rewrites";
+    value: AutomaticHTTPSRewritesValue;
+}
+/**
+ * Automatic Platform Optimization setting
+ */
+export interface AutomaticPlatformOptimizationSetting extends CloudflareSettingBase {
+    id: "automatic_platform_optimization";
+    value: {
+        enabled: boolean;
+        cf: boolean;
+        wordpress: boolean;
+        wordpress_plugin: boolean;
+        cache_by_device_type: boolean;
+    };
+}
+/**
+ * Brotli compression setting
+ */
+export interface BrotliSetting extends CloudflareSettingBase {
+    id: "brotli";
+    value: BrotliValue;
+}
+/**
+ * Browser Cache TTL setting
+ */
+export interface BrowserCacheTTLSetting extends CloudflareSettingBase {
+    id: "browser_cache_ttl";
+    value: number;
+}
+/**
+ * Browser Check setting
+ */
+export interface BrowserCheckSetting extends CloudflareSettingBase {
+    id: "browser_check";
+    value: "on" | "off";
+}
+/**
+ * Cache Level setting
+ */
+export interface CacheLevelSetting extends CloudflareSettingBase {
+    id: "cache_level";
+    value: CacheLevelValue;
+}
+/**
+ * Challenge TTL setting
+ */
+export interface ChallengeTTLSetting extends CloudflareSettingBase {
+    id: "challenge_ttl";
+    value: number;
+}
+/**
+ * Ciphers setting
+ */
+export interface CiphersSetting extends CloudflareSettingBase {
+    id: "ciphers";
+    value: string[];
+}
+/**
+ * Development Mode setting
+ */
+export interface DevelopmentModeSetting extends CloudflareSettingBase {
+    id: "development_mode";
+    value: DevelopmentModeValue;
+}
+/**
+ * Early Hints setting
+ */
+export interface EarlyHintsSetting extends CloudflareSettingBase {
+    id: "early_hints";
+    value: EarlyHintsValue;
+}
+/**
+ * Email Obfuscation setting
+ */
+export interface EmailObfuscationSetting extends CloudflareSettingBase {
+    id: "email_obfuscation";
+    value: EmailObfuscationValue;
+}
+/**
+ * Hotlink Protection setting
+ */
+export interface HotlinkProtectionSetting extends CloudflareSettingBase {
+    id: "hotlink_protection";
+    value: HotlinkProtectionValue;
+}
+/**
+ * HTTP/2 setting
+ */
+export interface HTTP2Setting extends CloudflareSettingBase {
+    id: "http2";
+    value: HTTP2Value;
+}
+/**
+ * HTTP/3 setting
+ */
+export interface HTTP3Setting extends CloudflareSettingBase {
+    id: "http3";
+    value: HTTP3Value;
+}
+/**
+ * IP Geolocation setting
+ */
+export interface IPGeolocationSetting extends CloudflareSettingBase {
+    id: "ip_geolocation";
+    value: "on" | "off";
+}
+/**
+ * IPv6 setting
+ */
+export interface IPv6Setting extends CloudflareSettingBase {
+    id: "ipv6";
+    value: IPv6Value;
+}
+/**
+ * Minimum TLS Version setting
+ */
+export interface MinTLSVersionSetting extends CloudflareSettingBase {
+    id: "min_tls_version";
+    value: MinTLSVersionValue;
+}
+/**
+ * Opportunistic Encryption setting
+ */
+export interface OpportunisticEncryptionSetting extends CloudflareSettingBase {
+    id: "opportunistic_encryption";
+    value: "on" | "off";
+}
+/**
+ * SSL setting
+ */
+export interface SSLSetting extends CloudflareSettingBase {
+    id: "ssl";
+    value: SSLValue;
+    certificate_status?: string;
+    validation_errors?: Array<{
+        message: string;
+    }>;
+}
+/**
+ * TLS 1.3 setting
+ */
+export interface TLS13Setting extends CloudflareSettingBase {
+    id: "tls_1_3";
+    value: TLS13Value;
+}
+/**
+ * WebSockets setting
+ */
+export interface WebSocketsSetting extends CloudflareSettingBase {
+    id: "websockets";
+    value: WebSocketsValue;
+}
+/**
+ * Zero-RTT setting
+ */
+export interface ZeroRTTSetting extends CloudflareSettingBase {
+    id: "0rtt";
+    value: ZeroRTTValue;
+}
+/**
+ * All possible zone settings
+ */
+export type CloudflareZoneSetting = AdvancedDDoSSetting | AlwaysOnlineSetting | AlwaysUseHTTPSSetting | AutomaticHTTPSRewritesSetting | AutomaticPlatformOptimizationSetting | BrotliSetting | BrowserCacheTTLSetting | BrowserCheckSetting | CacheLevelSetting | ChallengeTTLSetting | CiphersSetting | DevelopmentModeSetting | EarlyHintsSetting | EmailObfuscationSetting | HotlinkProtectionSetting | HTTP2Setting | HTTP3Setting | IPGeolocationSetting | IPv6Setting | MinTLSVersionSetting | OpportunisticEncryptionSetting | SSLSetting | TLS13Setting | WebSocketsSetting | ZeroRTTSetting;
+/**
+ * Input for updating a zone setting
+ */
+export interface UpdateZoneSettingParams {
+    /**
+     * The value to set
+     */
+    value: CloudflareZoneSetting["value"];
+}
+/**
+ * Response for zone settings operations
+ */
+export interface CloudflareZoneSettingResponse {
+    /**
+     * Whether the API call was successful
+     */
+    success: boolean;
+    /**
+     * Any error messages
+     */
+    errors: Array<{
+        code: number;
+        message: string;
+    }>;
+    /**
+     * Any informational messages
+     */
+    messages: Array<{
+        code: number;
+        message: string;
+    }>;
+    /**
+     * The settings that were operated on
+     */
+    result: CloudflareZoneSetting[];
+}
+/**
+ * Response for a single zone setting operation
+ */
+export interface CloudflareZoneSettingSingleResponse {
+    /**
+     * Whether the API call was successful
+     */
+    success: boolean;
+    /**
+     * Any error messages
+     */
+    errors: Array<{
+        code: number;
+        message: string;
+    }>;
+    /**
+     * Any informational messages
+     */
+    messages: Array<{
+        code: number;
+        message: string;
+    }>;
+    /**
+     * The setting that was operated on
+     */
+    result: CloudflareZoneSetting;
+}

package/lib/cloudflare/zone-settings.js

@@ -0,0 +1 @@
+export {};