alchemy 0.12.6 → 0.12.7

package/lib/neon/project.d.ts

@@ -0,0 +1,345 @@
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import type { Secret } from "../secret.js";
+import { type NeonApiOptions } from "./api.js";
+/**
+ * A Neon region where projects can be provisioned
+ */
+export type NeonRegion = "aws-us-east-1" | "aws-us-east-2" | "aws-us-west-2" | "aws-eu-central-1" | "aws-eu-west-2" | "aws-ap-southeast-1" | "aws-ap-southeast-2" | "aws-sa-east-1" | "azure-eastus2" | "azure-westus3" | "azure-gwc";
+/**
+ * Properties for creating or updating a Neon project
+ */
+export interface NeonProjectProps extends NeonApiOptions {
+    /**
+     * Name of the project
+     */
+    name: string;
+    /**
+     * Region where the project will be provisioned
+     * @default "aws-us-east-1"
+     */
+    region_id?: NeonRegion;
+    /**
+     * PostgreSQL version to use
+     * @default 15
+     */
+    pg_version?: 14 | 15 | 16;
+    /**
+     * Whether to create a default branch and endpoint
+     * @default true
+     */
+    default_endpoint?: boolean;
+    /**
+     * Default branch name
+     * @default "main"
+     */
+    default_branch_name?: string;
+    /**
+     * Existing project ID to update
+     * Used internally during update operations
+     * @internal
+     */
+    existing_project_id?: string;
+}
+/**
+ * A Neon database
+ */
+export interface NeonDatabase {
+    /**
+     * Database ID
+     */
+    id: number;
+    /**
+     * ID of the branch this database belongs to
+     */
+    branch_id: string;
+    /**
+     * Database name
+     */
+    name: string;
+    /**
+     * Name of the database owner role
+     */
+    owner_name: string;
+    /**
+     * Time at which the database was created
+     */
+    created_at: string;
+    /**
+     * Time at which the database was last updated
+     */
+    updated_at: string;
+}
+/**
+ * A Neon database role
+ */
+export interface NeonRole {
+    /**
+     * ID of the branch this role belongs to
+     */
+    branch_id: string;
+    /**
+     * Role name
+     */
+    name: string;
+    /**
+     * Role password (only included during creation)
+     */
+    password?: string;
+    /**
+     * Whether this role is protected from deletion
+     */
+    protected: boolean;
+    /**
+     * Time at which the role was created
+     */
+    created_at: string;
+    /**
+     * Time at which the role was last updated
+     */
+    updated_at: string;
+}
+/**
+ * A Neon branch
+ */
+export interface NeonBranch {
+    /**
+     * Branch ID
+     */
+    id: string;
+    /**
+     * ID of the project this branch belongs to
+     */
+    project_id: string;
+    /**
+     * Branch name
+     */
+    name: string;
+    /**
+     * Current state of the branch
+     */
+    current_state: string;
+    /**
+     * Pending state of the branch
+     */
+    pending_state: string;
+    /**
+     * Time at which the branch was created
+     */
+    created_at: string;
+    /**
+     * Time at which the branch was last updated
+     */
+    updated_at: string;
+}
+/**
+ * A Neon compute endpoint
+ */
+export interface NeonEndpoint {
+    /**
+     * Endpoint ID
+     */
+    id: string;
+    /**
+     * Host for connecting to this endpoint
+     */
+    host: string;
+    /**
+     * ID of the project this endpoint belongs to
+     */
+    project_id: string;
+    /**
+     * ID of the branch this endpoint belongs to
+     */
+    branch_id: string;
+    /**
+     * Endpoint type (read_write, read_only)
+     */
+    type: string;
+    /**
+     * Current state of the endpoint
+     */
+    current_state: string;
+    /**
+     * Pending state of the endpoint
+     */
+    pending_state: string;
+    /**
+     * Region ID where this endpoint is provisioned
+     */
+    region_id: string;
+    /**
+     * Minimum compute units for autoscaling
+     */
+    autoscaling_limit_min_cu: number;
+    /**
+     * Maximum compute units for autoscaling
+     */
+    autoscaling_limit_max_cu: number;
+    /**
+     * Whether connection pooler is enabled
+     */
+    pooler_enabled: boolean;
+    /**
+     * Connection pooler mode
+     */
+    pooler_mode: string;
+    /**
+     * Whether this endpoint is disabled
+     */
+    disabled: boolean;
+    /**
+     * Whether passwordless access is enabled
+     */
+    passwordless_access: boolean;
+    /**
+     * Time at which the endpoint was created
+     */
+    created_at: string;
+    /**
+     * Time at which the endpoint was last updated
+     */
+    updated_at: string;
+    /**
+     * Proxy host for this endpoint
+     */
+    proxy_host: string;
+    /**
+     * Endpoint settings
+     */
+    settings: {
+        /**
+         * PostgreSQL settings
+         */
+        pg_settings: Record<string, any>;
+    };
+}
+/**
+ * A Neon connection URI
+ */
+export interface NeonConnectionUri {
+    /**
+     * Connection URI string
+     */
+    connection_uri: Secret;
+    /**
+     * Connection parameters
+     */
+    connection_parameters: {
+        database: string;
+        host: string;
+        port: number;
+        user: string;
+        password: Secret;
+    };
+}
+/**
+ * A Neon operation
+ */
+export interface NeonOperation {
+    /**
+     * Operation ID
+     */
+    id: string;
+    /**
+     * ID of the project this operation belongs to
+     */
+    project_id: string;
+    /**
+     * ID of the branch this operation affects, if applicable
+     */
+    branch_id?: string;
+    /**
+     * ID of the endpoint this operation affects, if applicable
+     */
+    endpoint_id?: string;
+    /**
+     * Action being performed
+     */
+    action: string;
+    /**
+     * Current status of the operation
+     */
+    status: string;
+    /**
+     * Number of failures encountered
+     */
+    failures_count: number;
+    /**
+     * Time at which the operation was created
+     */
+    created_at: string;
+    /**
+     * Time at which the operation was last updated
+     */
+    updated_at: string;
+}
+/**
+ * Output returned after Neon project creation/update
+ * IMPORTANT: The interface name MUST match the exported resource name
+ */
+export interface NeonProject extends Resource<"neon::Project">, Omit<NeonProjectProps, "apiKey" | "existing_project_id"> {
+    /**
+     * The ID of the project
+     */
+    id: string;
+    /**
+     * Time at which the project was created
+     */
+    created_at: string;
+    /**
+     * Time at which the project was last updated
+     */
+    updated_at: string;
+    /**
+     * Hostname for proxy access
+     */
+    proxy_host?: string;
+    /**
+     * Connection URIs for the databases
+     */
+    connection_uris: [NeonConnectionUri, ...NeonConnectionUri[]];
+    /**
+     * Database roles created with the project
+     */
+    roles: [NeonRole, ...NeonRole[]];
+    /**
+     * Databases created with the project
+     */
+    databases?: [NeonDatabase, ...NeonDatabase[]];
+    /**
+     * Default branch information
+     */
+    branch?: NeonBranch;
+    /**
+     * Compute endpoints for the project
+     */
+    endpoints: [NeonEndpoint, ...NeonEndpoint[]];
+}
+/**
+ * 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 declare const NeonProject: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<NeonProject>, id: string, props: NeonProjectProps) => Promise<NeonProject>);
+//# sourceMappingURL=project.d.ts.map

package/lib/neon/project.d.ts.map

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

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.7",
   "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",