alchemy 0.7.0 → 0.7.1

package/src/cloudflare/queue.ts

@@ -0,0 +1,371 @@
+import type { Context } from "../context";
+import { Resource } from "../resource";
+import {
+  CloudflareApi,
+  createCloudflareApi,
+  type CloudflareApiOptions,
+} from "./api";
+import { CloudflareApiError, handleApiError } from "./api-error";
+
+/**
+ * Settings for a Cloudflare Queue
+ */
+export interface QueueSettings {
+  /**
+   * Delay in seconds before message delivery
+   * Queue will not deliver messages until this time has elapsed
+   */
+  deliveryDelay?: number;
+
+  /**
+   * Whether delivery is paused
+   * If true, the queue will not deliver messages to consumers
+   */
+  deliveryPaused?: boolean;
+
+  /**
+   * Period in seconds to retain messages
+   * Messages will be automatically deleted after this time
+   */
+  messageRetentionPeriod?: number;
+}
+
+/**
+ * Properties for creating or updating a Cloudflare Queue
+ */
+export interface QueueProps extends CloudflareApiOptions {
+  /**
+   * Name of the queue
+   * Required during creation
+   * Cannot be changed after creation
+   */
+  name: string;
+
+  /**
+   * Settings for the queue
+   * These can be updated after queue creation
+   */
+  settings?: QueueSettings;
+
+  /**
+   * Whether to delete the queue.
+   * If set to false, the queue will remain but the resource will be removed from state
+   *
+   * @default true
+   */
+  delete?: boolean;
+}
+
+/**
+ * Output returned after Cloudflare Queue creation/update
+ */
+export interface Queue extends Resource<"cloudflare::Queue">, QueueProps {
+  /**
+   * Type identifier for Cloudflare Queue
+   */
+  type: "queue";
+
+  /**
+   * The unique ID of the queue
+   */
+  id: string;
+
+  /**
+   * Time when the queue was created
+   */
+  createdOn: string;
+
+  /**
+   * Modified timestamp
+   */
+  modifiedOn: string;
+}
+
+interface CloudflareQueueResponse {
+  result: {
+    queue_id?: string;
+    queue_name: string;
+    created_on?: string;
+    modified_on?: string;
+    settings?: {
+      delivery_delay?: number;
+      delivery_paused?: boolean;
+      message_retention_period?: number;
+    };
+  };
+  success: boolean;
+  errors: Array<{ code: number; message: string }>;
+  messages: string[];
+}
+
+/**
+ * Creates and manages Cloudflare Queues.
+ *
+ * Queues provide a managed queue system for reliable message delivery
+ * between workers and other systems.
+ *
+ * @example
+ * // Create a basic queue with default settings
+ * const basicQueue = await Queue("my-app-queue", {
+ *   name: "my-app-queue"
+ * });
+ *
+ * @example
+ * // Create a queue with custom settings
+ * const customQueue = await Queue("delayed-queue", {
+ *   name: "delayed-queue",
+ *   settings: {
+ *     deliveryDelay: 30, // 30 second delay before message delivery
+ *     messageRetentionPeriod: 86400 // Store messages for 1 day
+ *   }
+ * });
+ *
+ * @example
+ * // Create a paused queue for later activation
+ * const pausedQueue = await Queue("paused-queue", {
+ *   name: "paused-queue",
+ *   settings: {
+ *     deliveryPaused: true
+ *   }
+ * });
+ *
+ * @see https://developers.cloudflare.com/queues/
+ */
+export const Queue = Resource(
+  "cloudflare::Queue",
+  async function (
+    this: Context<Queue>,
+    id: string,
+    props: QueueProps
+  ): Promise<Queue> {
+    const api = await createCloudflareApi(props);
+    const queueName = props.name || id;
+
+    if (this.phase === "delete") {
+      console.log("Deleting Cloudflare Queue:", queueName);
+      if (props.delete !== false) {
+        // Delete Queue
+        await deleteQueue(api, this.output?.id);
+      }
+
+      // Return void (a deleted queue has no content)
+      return this.destroy();
+    } else {
+      let queueData: CloudflareQueueResponse;
+
+      if (this.phase === "create") {
+        console.log("Creating Cloudflare Queue:", queueName);
+        queueData = await createQueue(api, queueName, props);
+      } else {
+        // Update operation
+        if (this.output?.id) {
+          console.log("Updating Cloudflare Queue:", queueName);
+
+          // Check if name is being changed, which is not allowed
+          if (props.name !== this.output.name) {
+            throw new Error(
+              "Cannot update Queue name after creation. Queue name is immutable."
+            );
+          }
+
+          // Update the queue with new settings
+          queueData = await updateQueue(api, this.output.id, props);
+        } else {
+          // If no ID exists, fall back to creating a new queue
+          console.log(
+            "No existing Queue ID found, creating new Cloudflare Queue:",
+            queueName
+          );
+          queueData = await createQueue(api, queueName, props);
+        }
+      }
+
+      return this({
+        type: "queue",
+        id: queueData.result.queue_id || "",
+        name: queueName,
+        settings: queueData.result.settings
+          ? {
+              deliveryDelay: queueData.result.settings.delivery_delay,
+              deliveryPaused: queueData.result.settings.delivery_paused,
+              messageRetentionPeriod:
+                queueData.result.settings.message_retention_period,
+            }
+          : undefined,
+        createdOn: queueData.result.created_on || new Date().toISOString(),
+        modifiedOn: queueData.result.modified_on || new Date().toISOString(),
+        accountId: api.accountId,
+      });
+    }
+  }
+);
+
+/**
+ * Create a new Cloudflare Queue
+ */
+export async function createQueue(
+  api: CloudflareApi,
+  queueName: string,
+  props: QueueProps
+): Promise<CloudflareQueueResponse> {
+  // Prepare the create payload
+  const createPayload: any = {
+    queue_name: queueName,
+  };
+
+  // Add settings if provided
+  if (props.settings) {
+    createPayload.settings = {};
+
+    if (props.settings.deliveryDelay !== undefined) {
+      createPayload.settings.delivery_delay = props.settings.deliveryDelay;
+    }
+
+    if (props.settings.deliveryPaused !== undefined) {
+      createPayload.settings.delivery_paused = props.settings.deliveryPaused;
+    }
+
+    if (props.settings.messageRetentionPeriod !== undefined) {
+      createPayload.settings.message_retention_period =
+        props.settings.messageRetentionPeriod;
+    }
+  }
+
+  const createResponse = await api.post(
+    `/accounts/${api.accountId}/queues`,
+    createPayload
+  );
+
+  if (!createResponse.ok) {
+    return await handleApiError(createResponse, "creating", "Queue", queueName);
+  }
+
+  return (await createResponse.json()) as CloudflareQueueResponse;
+}
+
+/**
+ * Get a Cloudflare Queue
+ */
+export async function getQueue(
+  api: CloudflareApi,
+  queueId: string
+): Promise<CloudflareQueueResponse> {
+  const response = await api.get(
+    `/accounts/${api.accountId}/queues/${queueId}`
+  );
+
+  if (!response.ok) {
+    return await handleApiError(response, "getting", "Queue", queueId);
+  }
+
+  return (await response.json()) as CloudflareQueueResponse;
+}
+
+/**
+ * Delete a Cloudflare Queue
+ */
+export async function deleteQueue(
+  api: CloudflareApi,
+  queueId?: string
+): Promise<void> {
+  if (!queueId) {
+    console.log("No Queue ID provided, skipping delete");
+    return;
+  }
+
+  // Delete Queue
+  const deleteResponse = await api.delete(
+    `/accounts/${api.accountId}/queues/${queueId}`
+  );
+
+  if (!deleteResponse.ok && deleteResponse.status !== 404) {
+    const errorData: any = await deleteResponse.json().catch(() => ({
+      errors: [{ message: deleteResponse.statusText }],
+    }));
+    throw new CloudflareApiError(
+      `Error deleting Cloudflare Queue '${queueId}': ${errorData.errors?.[0]?.message || deleteResponse.statusText}`,
+      deleteResponse
+    );
+  }
+}
+
+/**
+ * Update a Cloudflare Queue
+ *
+ * Note: According to Cloudflare API, the queue name cannot be changed after creation.
+ * Only the settings can be updated.
+ */
+export async function updateQueue(
+  api: CloudflareApi,
+  queueId: string,
+  props: QueueProps
+): Promise<CloudflareQueueResponse> {
+  // Prepare the update payload - only include settings
+  const updatePayload: any = {};
+
+  // Add settings if provided
+  if (props.settings) {
+    updatePayload.settings = {};
+
+    if (props.settings.deliveryDelay !== undefined) {
+      updatePayload.settings.delivery_delay = props.settings.deliveryDelay;
+    }
+
+    if (props.settings.deliveryPaused !== undefined) {
+      updatePayload.settings.delivery_paused = props.settings.deliveryPaused;
+    }
+
+    if (props.settings.messageRetentionPeriod !== undefined) {
+      updatePayload.settings.message_retention_period =
+        props.settings.messageRetentionPeriod;
+    }
+  }
+
+  // Use PATCH for partial updates (only settings can be updated)
+  const updateResponse = await api.patch(
+    `/accounts/${api.accountId}/queues/${queueId}`,
+    updatePayload
+  );
+
+  if (!updateResponse.ok) {
+    return await handleApiError(updateResponse, "updating", "Queue", queueId);
+  }
+
+  return (await updateResponse.json()) as CloudflareQueueResponse;
+}
+
+/**
+ * List all Cloudflare Queues in an account
+ */
+export async function listQueues(
+  api: CloudflareApi
+): Promise<{ name: string; id: string }[]> {
+  const response = await api.get(`/accounts/${api.accountId}/queues`);
+
+  if (!response.ok) {
+    throw new CloudflareApiError(
+      `Failed to list queues: ${response.statusText}`,
+      response
+    );
+  }
+
+  const data = (await response.json()) as {
+    success: boolean;
+    errors?: Array<{ code: number; message: string }>;
+    result?: Array<{
+      queue_name: string;
+      queue_id: string;
+    }>;
+  };
+
+  if (!data.success) {
+    const errorMessage = data.errors?.[0]?.message || "Unknown error";
+    throw new Error(`Failed to list queues: ${errorMessage}`);
+  }
+
+  // Transform API response
+  return (data.result || []).map((queue) => ({
+    name: queue.queue_name,
+    id: queue.queue_id,
+  }));
+}

package/src/cloudflare/worker.ts

@@ -15,7 +15,6 @@ import { type Assets } from "./assets";
 import { type Bindings, type WorkerBindingSpec } from "./bindings";
 import type { Bound } from "./bound";
 import { type DurableObjectNamespace } from "./durable-object-namespace";
-import { isKVNamespace } from "./kv-namespace";
 import type { WorkerScriptMetadata } from "./worker-metadata";
 import type { SingleStepMigration } from "./worker-migration";
 import { upsertWorkflow, type Workflow } from "./workflow";
@@ -319,8 +318,10 @@ export const Worker = Resource(
 
     // Construct the output
     return this({
+      ...props,
       type: "service",
       id,
+      entrypoint: props.entrypoint,
       name: workerName,
       script: scriptContent,
       format: props.format || "esm", // Include format in the output
@@ -521,17 +522,23 @@ async function prepareWorkerMetadata<B extends Bindings>(
   for (const [bindingName, binding] of Object.entries(bindings)) {
     // Create a copy of the binding to avoid modifying the original
 
-    if (isKVNamespace(binding)) {
+    if (typeof binding === "string") {
       meta.bindings.push({
-        type: "kv_namespace",
+        type: "plain_text",
         name: bindingName,
-        namespace_id: binding.namespaceId,
+        text: binding,
       });
-    } else if (typeof binding === "string") {
+    } else if (binding.type === "d1") {
       meta.bindings.push({
-        type: "plain_text",
+        type: "d1",
         name: bindingName,
-        text: binding,
+        id: binding.id,
+      });
+    } else if (binding.type === "kv_namespace") {
+      meta.bindings.push({
+        type: "kv_namespace",
+        name: bindingName,
+        namespace_id: binding.namespaceId,
       });
     } else if (binding.type === "service") {
       meta.bindings.push({
@@ -577,6 +584,12 @@ async function prepareWorkerMetadata<B extends Bindings>(
       });
       // it's unclear whether this is needed, but it works both ways
       configureClassMigration(binding, binding.id, binding.className);
+    } else if (binding.type === "queue") {
+      meta.bindings.push({
+        type: "queue",
+        name: bindingName,
+        queue_name: binding.name,
+      });
     } else {
       // @ts-expect-error - we should never reach here
       throw new Error(`Unsupported binding type: ${binding.type}`);