alchemy 0.12.6 → 0.12.8

package/lib/neon/project.js

@@ -0,0 +1,305 @@
+import { alchemy } from "../alchemy.js";
+import { Resource } from "../resource.js";
+import { handleApiError } from "./api-error.js";
+import { createNeonApi } from "./api.js";
+/**
+ * Creates a Neon serverless PostgreSQL project.
+ *
+ * @example
+ * // Create a basic Neon project with default settings:
+ * const project = await NeonProject("my-project", {
+ *   name: "My Project"
+ * });
+ *
+ * @example
+ * // Create a Neon project in a specific region with a specific PostgreSQL version:
+ * const euProject = await NeonProject("my-eu-project", {
+ *   name: "My EU Project",
+ *   region_id: "aws-eu-west-1",
+ *   pg_version: 16,
+ *   apiKey: alchemy.secret(process.env.NEON_API_KEY)
+ * });
+ *
+ * @example
+ * // Create a Neon project with a custom default branch name:
+ * const devProject = await NeonProject("dev-project", {
+ *   name: "Development Project",
+ *   default_branch_name: "development"
+ * });
+ */
+export const NeonProject = Resource("neon::Project", async function (id, props) {
+    const api = createNeonApi(props);
+    const projectId = props.existing_project_id || this.output?.id;
+    if (this.phase === "delete") {
+        try {
+            // Check if the project exists before attempting to delete
+            if (projectId) {
+                const deleteResponse = await api.delete(`/projects/${projectId}`);
+                if (!deleteResponse.ok && deleteResponse.status !== 404) {
+                    await handleApiError(deleteResponse, "delete", "project", id);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`Error deleting Neon project ${id}:`, error);
+            throw error;
+        }
+        return this.destroy();
+    }
+    let response;
+    try {
+        if (this.phase === "update" && projectId) {
+            // Update existing project
+            // Neon only allows updating the project name
+            const projectResponse = await api.patch(`/projects/${projectId}`, {
+                project: {
+                    name: props.name,
+                },
+            });
+            if (!projectResponse.ok) {
+                await handleApiError(projectResponse, "update", "project", id);
+            }
+            const initialData = await projectResponse.json();
+            // Reify project properties to get complete data
+            response = await getProject(api, projectId, initialData);
+        }
+        else {
+            // Check if a project with this ID already exists
+            if (projectId) {
+                const getResponse = await api.get(`/projects/${projectId}`);
+                if (getResponse.ok) {
+                    // Project exists, update it
+                    const projectResponse = await api.patch(`/projects/${projectId}`, {
+                        project: {
+                            name: props.name,
+                        },
+                    });
+                    if (!projectResponse.ok) {
+                        await handleApiError(projectResponse, "update", "project", id);
+                    }
+                    const initialData = await projectResponse.json();
+                    // Reify project properties to get complete data
+                    response = await getProject(api, projectId, initialData);
+                }
+                else if (getResponse.status !== 404) {
+                    // Unexpected error during GET check
+                    await handleApiError(getResponse, "get", "project", id);
+                    throw new Error("Failed to check if project exists");
+                }
+                else {
+                    // Project doesn't exist, create new
+                    response = await createNewProject(api, props);
+                }
+            }
+            else {
+                // No output ID, create new project
+                response = await createNewProject(api, props);
+            }
+        }
+        // Wait for any pending operations to complete
+        if (response.operations && response.operations.length > 0) {
+            await waitForOperations(api, response.operations);
+        }
+        // Get the latest project state after operations complete
+        if (response.project?.id) {
+            // Reify project properties to get complete data
+            response = await getProject(api, response.project.id, response);
+        }
+        return this({
+            id: response.project.id,
+            name: response.project.name,
+            region_id: response.project.region_id,
+            pg_version: response.project.pg_version,
+            created_at: response.project.created_at,
+            updated_at: response.project.updated_at,
+            proxy_host: response.project.proxy_host,
+            // Pass through the provided props except apiKey (which is sensitive)
+            default_endpoint: props.default_endpoint,
+            default_branch_name: props.default_branch_name,
+            baseUrl: props.baseUrl,
+            // Add all available data
+            // @ts-ignore - api ensures they're non-empty
+            connection_uris: response.connection_uris,
+            // @ts-ignore
+            roles: response.roles,
+            // @ts-ignore
+            databases: response.databases,
+            // @ts-ignore
+            branch: response.branch,
+            // @ts-ignore
+            endpoints: response.endpoints,
+        });
+    }
+    catch (error) {
+        console.error(`Error ${this.phase} Neon project '${id}':`, error);
+        throw error;
+    }
+});
+/**
+ * Helper function to create a new Neon project
+ */
+async function createNewProject(api, props) {
+    const defaultEndpoint = props.default_endpoint ?? true;
+    const projectResponse = await api.post("/projects", {
+        project: {
+            name: props.name,
+            region_id: props.region_id || "aws-us-east-1",
+            pg_version: props.pg_version || 15,
+            default_endpoint: defaultEndpoint,
+            branch: defaultEndpoint
+                ? { name: props.default_branch_name || "main" }
+                : undefined,
+        },
+    });
+    if (!projectResponse.ok) {
+        await handleApiError(projectResponse, "create", "project");
+    }
+    return (await projectResponse.json());
+}
+/**
+ * Helper function to get complete project details by fetching all related data
+ *
+ * @param api The Neon API client
+ * @param projectId The project ID
+ * @param initialData Initial project data (optional)
+ * @returns Complete project data with all related resources
+ */
+async function getProject(api, projectId, initialData = {}) {
+    // Get the latest project details
+    const updatedData = await getProjectDetails(api, projectId);
+    // Start with a copy of the initial data
+    let responseData = { ...initialData };
+    // Check if we have a branch ID from the initial data
+    const branchId = initialData.branch?.id;
+    if (branchId) {
+        // Get the branch details
+        const branchData = await getBranchDetails(api, projectId, branchId);
+        // Update with the latest branch data
+        responseData.branch = branchData.branch;
+        // Also fetch the latest endpoint details for this branch
+        const endpointData = await getEndpointDetails(api, projectId, branchId);
+        // Update with the latest endpoint data if available
+        if (endpointData.endpoints && endpointData.endpoints.length > 0) {
+            responseData.endpoints = endpointData.endpoints;
+        }
+    }
+    // Preserve all data from the original response
+    // Only update properties that might have changed during operations
+    return {
+        ...responseData,
+        connection_uris: (updatedData.connection_uris || responseData.connection_uris)?.map((uri) => ({
+            connection_uri: alchemy.secret(uri.connection_uri),
+            connection_parameters: {
+                database: uri.connection_parameters.database,
+                host: uri.connection_parameters.host,
+                port: uri.connection_parameters.port ?? 5432,
+                user: uri.connection_parameters.user ?? "neondb_owner",
+                password: alchemy.secret(uri.connection_parameters.password),
+            },
+        })),
+        project: updatedData.project,
+        branch: updatedData.branch || responseData.branch,
+        endpoints: updatedData.endpoints || responseData.endpoints,
+    };
+}
+/**
+ * Wait for operations to complete
+ *
+ * @param api The Neon API client
+ * @param operations Operations to wait for
+ * @throws Error if an operation fails or times out
+ * @returns Promise that resolves when all operations complete
+ */
+async function waitForOperations(api, operations) {
+    const pendingOperations = operations.filter((op) => op.status !== "finished" && op.status !== "failed");
+    if (pendingOperations.length === 0) {
+        return;
+    }
+    // Maximum wait time in milliseconds (5 minutes)
+    const maxWaitTime = 5 * 60 * 1000;
+    // Initial delay between retries in milliseconds
+    const initialRetryDelay = 500;
+    // Maximum delay between retries
+    const maxRetryDelay = 10000;
+    // Backoff factor for exponential backoff
+    const backoffFactor = 1.5;
+    for (const operation of pendingOperations) {
+        let totalWaitTime = 0;
+        let retryDelay = initialRetryDelay;
+        let operationStatus = operation.status;
+        while (operationStatus !== "finished" &&
+            operationStatus !== "failed" &&
+            totalWaitTime < maxWaitTime) {
+            // Wait before checking again with exponential backoff
+            await new Promise((resolve) => setTimeout(resolve, retryDelay));
+            totalWaitTime += retryDelay;
+            // Increase delay for next retry with exponential backoff, up to max
+            retryDelay = Math.min(retryDelay * backoffFactor, maxRetryDelay);
+            // Check operation status
+            const operationResponse = await api.get(`/projects/${operation.project_id}/operations/${operation.id}`);
+            if (operationResponse.ok) {
+                const operationData = await operationResponse.json();
+                operationStatus = operationData.operation?.status;
+            }
+            else {
+                throw new Error(`Failed to check operation ${operation.id} status: HTTP ${operationResponse.status}`);
+            }
+        }
+        if (operationStatus === "failed") {
+            throw new Error(`Operation ${operation.id} (${operation.action}) failed`);
+        }
+        else if (totalWaitTime >= maxWaitTime) {
+            throw new Error(`Timeout waiting for operation ${operation.id} (${operation.action}) to complete`);
+        }
+    }
+    // Explicitly return when all operations are complete
+    return;
+}
+/**
+ * Get the latest project details
+ *
+ * @param api The Neon API client
+ * @param projectId The project ID
+ * @returns Project details including branch and endpoints
+ * @throws Error if project details cannot be retrieved
+ */
+async function getProjectDetails(api, projectId) {
+    const response = await api.get(`/projects/${projectId}`);
+    if (!response.ok) {
+        throw new Error(`Failed to get project details: HTTP ${response.status}`);
+    }
+    return (await response.json());
+}
+/**
+ * Get the latest branch details
+ *
+ * @param api The Neon API client
+ * @param projectId The project ID
+ * @param branchId The branch ID
+ * @returns Branch details
+ * @throws Error if branch details cannot be retrieved
+ */
+async function getBranchDetails(api, projectId, branchId) {
+    const response = await api.get(`/projects/${projectId}/branches/${branchId}`);
+    if (!response.ok) {
+        throw new Error(`Failed to get branch details: HTTP ${response.status}`);
+    }
+    return (await response.json());
+}
+/**
+ * Get the latest endpoint details for a branch
+ *
+ * @param api The Neon API client
+ * @param projectId The project ID
+ * @param branchId The branch ID
+ * @returns Endpoint details for the branch
+ * @throws Error if endpoint details cannot be retrieved
+ */
+async function getEndpointDetails(api, projectId, branchId) {
+    const response = await api.get(`/projects/${projectId}/branches/${branchId}/endpoints`);
+    if (!response.ok) {
+        throw new Error(`Failed to get endpoint details: HTTP ${response.status}`);
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=project.js.map

package/lib/neon/project.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.12.6",
+  "version": "0.12.8",
   "type": "module",
   "module": "./lib/index.js",
   "scripts": {
@@ -21,6 +21,7 @@
     "./esbuild": "./lib/esbuild/index.js",
     "./fs": "./lib/fs/index.js",
     "./github": "./lib/github/index.js",
+    "./neon": "./lib/neon/index.js",
     "./os": "./lib/os/index.js",
     "./shadcn": "./lib/shadcn/index.js",
     "./stripe": "./lib/stripe/index.js",

package/src/cloudflare/ai-gateway.ts

@@ -151,7 +151,6 @@ export interface AiGateway
  */
 export const AiGateway = Resource(
   "cloudflare::AiGateway",
-  { alwaysUpdate: true }, // AI Gateway PUT updates, so always run update logic
   async function (
     this: Context<AiGateway>,
     id: string,

package/src/cloudflare/bindings.ts

@@ -9,6 +9,7 @@ import type { Assets } from "./assets.js";
 import type { R2Bucket } from "./bucket.js";
 import type { D1Database } from "./d1-database.js";
 import type { DurableObjectNamespace } from "./durable-object-namespace.js";
+import type { Hyperdrive } from "./hyperdrive.js";
 import type { KVNamespace } from "./kv-namespace.js";
 import type { Pipeline } from "./pipeline.js";
 import type { Queue } from "./queue.js";
@@ -24,9 +25,11 @@ export type Bindings = {
  * L2 Binding Resources.
  */
 export type Binding =
+  | AiGateway
   | Assets
   | D1Database
   | DurableObjectNamespace
+  | Hyperdrive
   | KVNamespace
   | Pipeline
   | Queue
@@ -35,8 +38,7 @@ export type Binding =
   | string
   | VectorizeIndex
   | Worker
-  | Workflow
-  | AiGateway;
+  | Workflow;
 
 /**
  * Union type for all Worker binding types (API spec)

package/src/cloudflare/bound.ts

@@ -6,6 +6,7 @@ import type { Binding } from "./bindings.js";
 import type { R2Bucket as _R2Bucket } from "./bucket.js";
 import type { D1Database as _D1Database } from "./d1-database.js";
 import type { DurableObjectNamespace as _DurableObjectNamespace } from "./durable-object-namespace.js";
+import type { Hyperdrive as _Hyperdrive } from "./hyperdrive.js";
 import type { KVNamespace as _KVNamespace } from "./kv-namespace.js";
 import type { Pipeline as _Pipeline } from "./pipeline.js";
 import type { Queue as _Queue } from "./queue.js";
@@ -23,20 +24,22 @@ export type Bound<T extends Binding> = T extends _DurableObjectNamespace
         ? R2Bucket
         : T extends _AiGateway
           ? AiGateway
-          : T extends Secret
-            ? string
-            : T extends Assets
-              ? Service
-              : T extends _Workflow<infer P>
-                ? Workflow<P>
-                : T extends _D1Database
-                  ? D1Database
-                  : T extends _VectorizeIndex
-                    ? VectorizeIndex
-                    : T extends _Queue
-                      ? Queue
-                      : T extends _Pipeline<infer R>
-                        ? Pipeline<R>
-                        : T extends string
-                          ? string
-                          : Service;
+          : T extends _Hyperdrive
+            ? Hyperdrive
+            : T extends Secret
+              ? string
+              : T extends Assets
+                ? Service
+                : T extends _Workflow<infer P>
+                  ? Workflow<P>
+                  : T extends _D1Database
+                    ? D1Database
+                    : T extends _VectorizeIndex
+                      ? VectorizeIndex
+                      : T extends _Queue<infer Body>
+                        ? Queue<Body>
+                        : T extends _Pipeline<infer R>
+                          ? Pipeline<R>
+                          : T extends string
+                            ? string
+                            : Service;

package/src/cloudflare/bucket.ts

@@ -13,8 +13,10 @@ export interface BucketProps {
    * Name of the bucket
    * Names can only contain lowercase letters (a-z), numbers (0-9), and hyphens (-)
    * Cannot begin or end with a hyphen
+   *
+   * @default - the id of the resource
    */
-  name: string;
+  name?: string;
 
   /**
    * Optional location hint for the bucket
@@ -90,6 +92,11 @@ export interface R2Bucket
    */
   type: "r2_bucket";
 
+  /**
+   * The name of the bucket
+   */
+  name: string;
+
   /**
    * Location of the bucket
    */
@@ -150,7 +157,7 @@ export const R2Bucket = Resource(
   async function (
     this: Context<R2Bucket>,
     id: string,
-    props: BucketProps
+    props: BucketProps = {}
   ): Promise<R2Bucket> {
     const api = await createCloudflareApi(props);
     const bucketName = props.name || this.id;

package/src/cloudflare/d1-database.ts

@@ -14,8 +14,10 @@ import { applyMigrations, listMigrationsFiles } from "./d1-migrations.js";
 export interface D1DatabaseProps extends CloudflareApiOptions {
   /**
    * Name of the database
+   *
+   * @default id
    */
-  name: string;
+  name?: string;
 
   /**
    * Optional primary location hint for the database
@@ -90,6 +92,11 @@ export type D1Database = Resource<"cloudflare::D1Database"> &
      */
     id: string;
 
+    /**
+     * The name of the database
+     */
+    name: string;
+
     /**
      * File size of the database
      */
@@ -173,10 +180,10 @@ export const D1DatabaseResource = Resource(
   async function (
     this: Context<D1Database>,
     id: string,
-    props: D1DatabaseProps
+    props: D1DatabaseProps = {}
   ): Promise<D1Database> {
     const api = await createCloudflareApi(props);
-    const databaseName = props.name || id;
+    const databaseName = props.name ?? id;
 
     if (this.phase === "delete") {
       console.log("Deleting D1 database:", databaseName);

package/src/cloudflare/event-source.ts

@@ -0,0 +1,33 @@
+import type { QueueConsumerSettings } from "./queue-consumer.js";
+import type { Queue } from "./queue.js";
+
+/**
+ * Base interface for event sources that can be bound to a Worker
+ */
+export type EventSource = QueueEventSource | Queue;
+
+/**
+ * Configuration for a Queue as an event source for a Worker
+ */
+export interface QueueEventSource {
+  /**
+   * The queue to consume messages from
+   */
+  readonly queue: Queue;
+
+  /**
+   * Optional settings for configuring how the Worker consumes the queue
+   */
+  readonly settings?: QueueConsumerSettings;
+}
+
+/**
+ * Checks if an event source is a QueueEventSource
+ * @param eventSource - The event source to check
+ * @returns true if the event source is a QueueEventSource, false otherwise
+ */
+export function isQueueEventSource(
+  eventSource: any
+): eventSource is QueueEventSource {
+  return "queue" in eventSource;
+}