alchemy 0.15.10 → 0.15.11

package/lib/cloudflare/d1-import.js

@@ -0,0 +1,143 @@
+import { createHash } from "node:crypto";
+/**
+ * Calculates MD5 hash for a string
+ */
+function getMd5Hash(data) {
+    return createHash("md5").update(data).digest("hex");
+}
+/**
+ * Initiates an import of SQL into a Cloudflare D1 database.
+ * Implements a flow to get an upload URL, upload the SQL file, and poll for status updates.
+ *
+ * Based on Cloudflare API:
+ * https://developers.cloudflare.com/api/resources/d1/subresources/database/methods/import/
+ *
+ * @param api The CloudflareApi instance to use for requests
+ * @param options Options including the database ID and SQL data to import
+ * @returns An object containing the import results and status upon completion
+ * @throws Will throw an error if the API call fails or the import process reports an error
+ */
+export async function importD1Database(api, options) {
+    // Convert data to string for hashing if it's not already
+    let sqlDataString;
+    if (typeof options.sqlData === "string") {
+        sqlDataString = options.sqlData;
+    }
+    else if (options.sqlData instanceof Blob) {
+        sqlDataString = await options.sqlData.text();
+    }
+    else {
+        // BufferSource (ArrayBuffer, etc.)
+        sqlDataString = new TextDecoder().decode(options.sqlData);
+    }
+    // Calculate MD5 hash of SQL data
+    const etag = getMd5Hash(sqlDataString);
+    // Step 1: Initialize the import process to get an upload URL
+    const initResponse = await api.post(`/accounts/${api.accountId}/d1/database/${options.databaseId}/import`, {
+        action: "init",
+        etag,
+    });
+    if (!initResponse.ok) {
+        const errorData = (await initResponse.json());
+        throw new Error(`Failed to initialize D1 database import: ${errorData.error || errorData.errors?.[0]?.message || "Unknown error"}`);
+    }
+    const initData = (await initResponse.json());
+    const uploadResult = initData.result;
+    if (!uploadResult.success || !uploadResult.upload_url) {
+        throw new Error(uploadResult.error || "Failed to get upload URL for D1 import");
+    }
+    // Step 2: Upload the SQL file
+    await uploadSqlFile(uploadResult.upload_url, options.sqlData, options.filename || uploadResult.filename);
+    // Step 3: Ingest the uploaded file
+    const ingestResponse = await api.post(`/accounts/${api.accountId}/d1/database/${options.databaseId}/import`, {
+        action: "ingest",
+        etag,
+        filename: uploadResult.filename,
+    });
+    if (!ingestResponse.ok) {
+        const errorData = (await ingestResponse.json());
+        throw new Error(`Failed to ingest D1 database upload: ${errorData.error || errorData.errors?.[0]?.message || "Unknown error"}`);
+    }
+    const ingestData = (await ingestResponse.json());
+    const ingestResult = ingestData.result;
+    if (!ingestResult.success) {
+        throw new Error(ingestResult.error || "Failed to start ingestion for D1 import");
+    }
+    if (!ingestResult.at_bookmark) {
+        throw new Error("Ingest response did not contain a bookmark for polling");
+    }
+    // Step 4: Poll for status
+    return pollImportStatus(api, options.databaseId, ingestResult.at_bookmark);
+}
+/**
+ * Uploads an SQL file to the provided URL
+ */
+async function uploadSqlFile(uploadUrl, sqlData, filename) {
+    // Convert data to the right format if needed
+    let blob;
+    if (typeof sqlData === "string") {
+        blob = new Blob([sqlData], { type: "application/sql" });
+    }
+    else if (sqlData instanceof Blob) {
+        blob = sqlData;
+    }
+    else {
+        // BufferSource (ArrayBuffer, etc.)
+        blob = new Blob([sqlData], { type: "application/sql" });
+    }
+    // Create a FormData object with the file
+    const formData = new FormData();
+    formData.append("file", blob, filename || "import.sql");
+    const response = await fetch(uploadUrl, {
+        method: "PUT",
+        body: blob,
+        headers: {
+            "Content-Type": "application/sql",
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to upload SQL file: ${response.statusText}`);
+    }
+}
+/**
+ * Polls for the import status with the provided bookmark
+ */
+async function pollImportStatus(api, databaseId, bookmark) {
+    if (!bookmark) {
+        throw new Error("Cannot poll an import without a bookmark");
+    }
+    const response = await api.post(`/accounts/${api.accountId}/d1/database/${databaseId}/import`, {
+        action: "poll",
+        current_bookmark: bookmark,
+    });
+    if (!response.ok) {
+        const errorData = (await response.json());
+        throw new Error(`Failed to poll D1 import status: ${errorData.error || errorData.errors?.[0]?.message || "Unknown error"}`);
+    }
+    const data = (await response.json()).result;
+    if (!data.success) {
+        throw new Error(data.error || "Unknown error during D1 import");
+    }
+    // Log messages for visibility
+    if (data.messages && data.messages.length > 0) {
+        for (const message of data.messages) {
+            console.log(`D1 Import: ${message}`);
+        }
+    }
+    if (data.status === "complete" && data.result) {
+        return {
+            filename: data.filename || "import.sql",
+            result: data.result,
+            status: data.status,
+            success: data.success,
+        };
+    }
+    else if (data.status === "error") {
+        throw new Error(data.error || "Error during D1 import");
+    }
+    else {
+        // Continue polling with bookmark
+        return pollImportStatus(api, databaseId, data.at_bookmark);
+    }
+}
+//# sourceMappingURL=d1-import.js.map

package/lib/cloudflare/d1-import.js.map

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

package/lib/cloudflare/index.d.ts

@@ -11,7 +11,10 @@ export * from "./bucket.js";
 export * from "./bundle/external.js";
 export * from "./bundle/local-dev-cloudflare-shim.js";
 export * from "./custom-domain.js";
+export * from "./d1-clone.js";
 export * from "./d1-database.js";
+export * from "./d1-export.js";
+export * from "./d1-import.js";
 export * from "./dns-records.js";
 export * from "./durable-object-namespace.js";
 export * from "./hyperdrive.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}

package/lib/cloudflare/index.js

@@ -11,7 +11,10 @@ export * from "./bucket.js";
 export * from "./bundle/external.js";
 export * from "./bundle/local-dev-cloudflare-shim.js";
 export * from "./custom-domain.js";
+export * from "./d1-clone.js";
 export * from "./d1-database.js";
+export * from "./d1-export.js";
+export * from "./d1-import.js";
 export * from "./dns-records.js";
 export * from "./durable-object-namespace.js";
 export * from "./hyperdrive.js";

package/lib/cloudflare/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cloudflare/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}

package/lib/util/sleep.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to sleep.
+ * @returns A promise that resolves after the specified time.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/lib/util/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/util/sleep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/lib/util/sleep.js

@@ -0,0 +1,9 @@
+/**
+ * Pauses execution for a specified number of milliseconds.
+ * @param ms The number of milliseconds to sleep.
+ * @returns A promise that resolves after the specified time.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/lib/util/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/util/sleep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.15.10",
+  "version": "0.15.11",
   "type": "module",
   "module": "./lib/index.js",
   "scripts": {

package/src/cloudflare/d1-clone.ts

@@ -0,0 +1,113 @@
+import type { CloudflareApi } from "./api.js";
+import {
+  exportD1Database,
+  type ExportD1DatabaseOptions,
+  type ExportD1DatabaseResult,
+} from "./d1-export.js";
+import {
+  importD1Database,
+  type ImportD1DatabaseOptions,
+  type ImportD1DatabaseResult,
+} from "./d1-import.js";
+
+/**
+ * Options for cloning a D1 database
+ */
+export interface CloneD1DatabaseOptions {
+  /**
+   * The ID of the source D1 database to clone from
+   */
+  sourceDatabaseId: string;
+
+  /**
+   * The ID of the target D1 database to clone to
+   */
+  targetDatabaseId: string;
+
+  /**
+   * Optional export options for the source database
+   */
+  exportOptions?: Omit<ExportD1DatabaseOptions, "databaseId">;
+
+  /**
+   * Optional import options for the target database
+   */
+  importOptions?: Omit<ImportD1DatabaseOptions, "databaseId" | "sqlData">;
+}
+
+/**
+ * Response from the clone D1 database operation
+ */
+export interface CloneD1DatabaseResult {
+  /**
+   * Result of the export operation
+   */
+  exportResult: ExportD1DatabaseResult;
+
+  /**
+   * Result of the import operation
+   */
+  importResult: ImportD1DatabaseResult;
+
+  /**
+   * Whether the clone operation was successful
+   */
+  success: boolean;
+}
+
+/**
+ * Clones a D1 database by exporting from a source database and importing to a target database.
+ * Handles the full workflow:
+ * 1. Export source database to get a signed URL
+ * 2. Fetch SQL content from the signed URL
+ * 3. Import SQL content into the target database
+ *
+ * @param api The CloudflareApi instance to use for requests
+ * @param options Options including source and target database IDs
+ * @returns An object containing results from both export and import operations
+ * @throws Will throw an error if any part of the clone process fails
+ */
+export async function cloneD1Database(
+  api: CloudflareApi,
+  options: CloneD1DatabaseOptions,
+): Promise<CloneD1DatabaseResult> {
+  const exportResult = await exportD1Database(api, {
+    databaseId: options.sourceDatabaseId,
+    ...options.exportOptions,
+  });
+
+  if (!exportResult.success) {
+    throw new Error(
+      `Failed to export source database: ${options.sourceDatabaseId}`,
+    );
+  }
+
+  // Step 2: Fetch SQL content from the signed URL
+  const sqlResponse = await fetch(exportResult.signed_url);
+
+  if (!sqlResponse.ok) {
+    throw new Error(`Failed to fetch SQL content: ${sqlResponse.statusText}`);
+  }
+
+  const sqlData = await sqlResponse.text();
+
+  // Step 3: Import SQL content into target database
+  const importResult = await importD1Database(api, {
+    databaseId: options.targetDatabaseId,
+    sqlData,
+    filename: exportResult.filename,
+    ...options.importOptions,
+  });
+
+  if (!importResult.success) {
+    throw new Error(
+      `Failed to import to target database: ${options.targetDatabaseId}`,
+    );
+  }
+
+  return {
+    exportResult,
+    importResult,
+    success: true,
+  };
+}

package/src/cloudflare/d1-database.ts

@@ -2,10 +2,11 @@ import type { Context } from "../context.js";
 import { Resource } from "../resource.js";
 import { CloudflareApiError, handleApiError } from "./api-error.js";
 import {
-  type CloudflareApi,
   createCloudflareApi,
+  type CloudflareApi,
   type CloudflareApiOptions,
 } from "./api.js";
+import { cloneD1Database } from "./d1-clone.js";
 import { applyMigrations, listMigrationsFiles } from "./d1-migrations.js";
 
 /**
@@ -61,6 +62,17 @@ export interface D1DatabaseProps extends CloudflareApiOptions {
    */
   adopt?: boolean;
 
+  /**
+   * Clone data from an existing database to this new database.
+   * Only applicable during creation phase.
+   *
+   * Can be specified as:
+   * - A D1Database object
+   * - An object with an id property
+   * - An object with a name property (will look up the ID by name)
+   */
+  clone?: D1Database | { id: string } | { name: string };
+
   /**
    * These files will be generated internally with the D1Database wrapper function when migrationsDir is specified
    *
@@ -123,20 +135,6 @@ export type D1Database = Resource<"cloudflare::D1Database"> &
     };
   };
 
-export async function D1Database(
-  id: string,
-  props: Omit<D1DatabaseProps, "migrationsFiles">,
-) {
-  const migrationsFiles = props.migrationsDir
-    ? await listMigrationsFiles(props.migrationsDir)
-    : [];
-
-  return D1DatabaseResource(id, {
-    ...props,
-    migrationsFiles,
-  });
-}
-
 /**
  * Creates and manages Cloudflare D1 Databases.
  *
@@ -173,8 +171,43 @@ export async function D1Database(
  *   migrationsDir: "./migrations",
  * });
  *
+ * @example
+ * // Clone an existing database by ID
+ * const clonedDb = await D1Database("cloned-db", {
+ *   name: "cloned-db",
+ *   clone: otherDb
+ * });
+ *
+ * @example
+ * // Clone an existing database by ID
+ * const clonedDb = await D1Database("cloned-db", {
+ *   name: "cloned-db",
+ *   clone: { id: "existing-db-uuid" }
+ * });
+ *
+ * @example
+ * // Clone an existing database by name
+ * const clonedDb = await D1Database("cloned-db", {
+ *   name: "cloned-db",
+ *   clone: { name: "existing-db-name" }
+ * });
+ *
  * @see https://developers.cloudflare.com/d1/
  */
+export async function D1Database(
+  id: string,
+  props: Omit<D1DatabaseProps, "migrationsFiles">,
+) {
+  const migrationsFiles = props.migrationsDir
+    ? await listMigrationsFiles(props.migrationsDir)
+    : [];
+
+  return D1DatabaseResource(id, {
+    ...props,
+    migrationsFiles,
+  });
+}
+
 export const D1DatabaseResource = Resource(
   "cloudflare::D1Database",
   async function (
@@ -202,6 +235,11 @@ export const D1DatabaseResource = Resource(
       console.log("Creating D1 database:", databaseName);
       try {
         dbData = await createDatabase(api, databaseName, props);
+
+        // If clone property is provided, perform cloning after database creation
+        if (props.clone && dbData.result.uuid) {
+          await cloneDb(api, props.clone, dbData.result.uuid);
+        }
       } catch (error) {
         // Check if this is a "database already exists" error and adopt is enabled
         if (
@@ -480,3 +518,49 @@ export async function updateDatabase(
 
   return (await updateResponse.json()) as CloudflareD1Response;
 }
+
+/**
+ * Helper function to clone data from a source database to a target database
+ * Resolves the source database ID from different input formats and performs the cloning operation
+ *
+ * @param api CloudflareApi instance
+ * @param sourceDb Source database specification (can be an ID, a name, or a D1Database object)
+ * @param targetDbId Target database ID
+ */
+async function cloneDb(
+  api: CloudflareApi,
+  sourceDb: D1Database | { id: string } | { name: string },
+  targetDbId: string,
+): Promise<void> {
+  let sourceId: string;
+
+  // Determine source database ID
+  if ("id" in sourceDb && sourceDb.id) {
+    // Use provided ID directly
+    sourceId = sourceDb.id;
+  } else if ("name" in sourceDb && sourceDb.name) {
+    // Look up ID by name
+    const databases = await listDatabases(api, sourceDb.name);
+    const foundDb = databases.find((db) => db.name === sourceDb.name);
+
+    if (!foundDb) {
+      throw new Error(
+        `Source database with name '${sourceDb.name}' not found for cloning`,
+      );
+    }
+
+    sourceId = foundDb.id;
+  } else if ("type" in sourceDb && sourceDb.type === "d1" && "id" in sourceDb) {
+    // It's a D1Database object
+    sourceId = sourceDb.id;
+  } else {
+    throw new Error("Invalid clone property: must provide either id or name");
+  }
+
+  // Perform the cloning
+  console.log(`Cloning data from database ${sourceId} to ${targetDbId}`);
+  await cloneD1Database(api, {
+    sourceDatabaseId: sourceId,
+    targetDatabaseId: targetDbId,
+  });
+}

package/src/cloudflare/d1-export.ts

@@ -0,0 +1,173 @@
+import type { CloudflareApi } from "./api.js"; // Ensure CloudflareApi is exported if not already
+
+/**
+ * Options for exporting a D1 database
+ */
+export interface ExportD1DatabaseOptions {
+  /**
+   * The ID of the D1 database to export
+   */
+  databaseId: string;
+
+  /**
+   * Optional dump options to control what is exported
+   */
+  dumpOptions?: {
+    /**
+     * Optional list of tables to export
+     */
+    tables?: string[];
+
+    /**
+     * Whether to exclude schema in the export
+     */
+    no_schema?: boolean;
+
+    /**
+     * Whether to exclude data in the export
+     */
+    no_data?: boolean;
+  };
+}
+
+/**
+ * Response from the export D1 database operation
+ */
+export interface ExportD1DatabaseResult {
+  /**
+   * The filename of the exported database
+   */
+  filename: string;
+
+  /**
+   * The signed URL for downloading the exported database
+   */
+  signed_url: string;
+
+  /**
+   * The status of the export operation
+   */
+  status: "complete";
+
+  /**
+   * Whether the export operation was successful
+   */
+  success: boolean;
+}
+
+/**
+ * Error response from Cloudflare API
+ */
+interface CloudflareErrorResponse {
+  error?: string;
+  errors?: Array<{
+    message: string;
+  }>;
+}
+
+/**
+ * Response during polling for D1 database export
+ */
+interface ExportPollingResponse {
+  /**
+   * Bookmark for continuing the polling process
+   */
+  at_bookmark?: string;
+
+  /**
+   * Error message if any
+   */
+  error?: string;
+
+  /**
+   * Progress messages from the export process
+   */
+  messages: string[];
+
+  /**
+   * Result data if export is complete
+   */
+  result?: {
+    filename: string;
+    signed_url: string;
+  };
+
+  /**
+   * Status of the export process
+   */
+  status: "complete" | "error" | "processing";
+
+  /**
+   * Whether the current polling request was successful
+   */
+  success: boolean;
+
+  /**
+   * Type of operation
+   */
+  type: "export";
+}
+
+/**
+ * Initiates an export of a Cloudflare D1 database and returns a download URL.
+ * Implements recursive polling with bookmark handling, similar to wrangler.
+ * Waits indefinitely until the export process completes or fails.
+ *
+ * Based on Cloudflare API:
+ * https://developers.cloudflare.com/api/resources/d1/subresources/database/methods/export/
+ * and wrangler implementation.
+ *
+ * @param options Options including the database ID and optional dump parameters.
+ * @returns An object containing the download URL, filename, and status upon completion.
+ * @throws Will throw an error if the API call fails or the export process reports an error.
+ */
+export async function exportD1Database(
+  api: CloudflareApi,
+  options: ExportD1DatabaseOptions,
+  currentBookmark?: string,
+): Promise<ExportD1DatabaseResult> {
+  const response = await api.post(
+    `/accounts/${api.accountId}/d1/database/${options.databaseId}/export`,
+    {
+      output_format: "polling",
+      dump_options: options.dumpOptions || {},
+      current_bookmark: currentBookmark,
+    },
+  );
+
+  if (!response.ok) {
+    const errorData = (await response.json()) as CloudflareErrorResponse;
+    throw new Error(
+      `Failed to export D1 database: ${errorData.error || errorData.errors?.[0]?.message || "Unknown error"}`,
+    );
+  }
+
+  const { result: data } = (await response.json()) as {
+    result: ExportPollingResponse;
+  };
+
+  if (!data.success) {
+    throw new Error(data.error || "Unknown error during D1 export");
+  }
+
+  // Log messages for visibility
+  if (data.messages && data.messages.length > 0) {
+    for (const message of data.messages) {
+      console.log(`D1 Export: ${message}`);
+    }
+  }
+
+  if (data.status === "complete" && data.result) {
+    return {
+      filename: data.result.filename,
+      signed_url: data.result.signed_url,
+      status: data.status,
+      success: data.success,
+    };
+  } else if (data.status === "error") {
+    throw new Error(data.error || "Error during D1 export");
+  } else {
+    // Continue polling with bookmark
+    return exportD1Database(api, options, data.at_bookmark);
+  }
+}