alchemy 0.12.6 → 0.12.8

package/lib/neon/api-error.js

@@ -0,0 +1,73 @@
+/**
+ * Error class for Neon API errors
+ */
+export class NeonApiError extends Error {
+    /**
+     * HTTP status code
+     */
+    status;
+    /**
+     * HTTP status text
+     */
+    statusText;
+    /**
+     * Error data from the API response
+     */
+    errorData;
+    /**
+     * Create a new NeonApiError
+     */
+    constructor(message, response, errorData) {
+        super(message);
+        this.name = "NeonApiError";
+        this.status = response.status;
+        this.statusText = response.statusText;
+        this.errorData = errorData;
+        // Capture stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, NeonApiError);
+        }
+    }
+}
+/**
+ * Handle API errors and throw NeonApiError with context
+ *
+ * @param response Response object from fetch
+ * @param action Action that was being performed
+ * @param resourceType Type of resource
+ * @param resourceId ID of the resource
+ */
+export async function handleApiError(response, action, resourceType, resourceId) {
+    const resourceDisplay = resourceId ? `'${resourceId}'` : "";
+    let errorData;
+    try {
+        errorData = await response.json();
+    }
+    catch (e) {
+        // If we can't parse JSON, just use the response text
+        try {
+            errorData = { message: await response.text() };
+        }
+        catch (textError) {
+            errorData = { message: response.statusText };
+        }
+    }
+    let message = `Error ${action} ${resourceType} ${resourceDisplay}: `;
+    if (errorData?.error?.message) {
+        message += errorData.error.message;
+    }
+    else if (errorData?.message) {
+        message += errorData.message;
+    }
+    else if (errorData?.error) {
+        message +=
+            typeof errorData.error === "string"
+                ? errorData.error
+                : JSON.stringify(errorData.error);
+    }
+    else {
+        message += response.statusText;
+    }
+    throw new NeonApiError(message, response, errorData);
+}
+//# sourceMappingURL=api-error.js.map

package/lib/neon/api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.js","sourceRoot":"","sources":["../../src/neon/api-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC;;OAEG;IACa,MAAM,CAAS;IAE/B;;OAEG;IACa,UAAU,CAAS;IAEnC;;OAEG;IACa,SAAS,CAAO;IAEhC;;OAEG;IACH,YAAY,OAAe,EAAE,QAAkB,EAAE,SAAe;QAC9D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,sBAAsB;QACtB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAkB,EAClB,MAAuD,EACvD,YAAoB,EACpB,UAAmB;IAEnB,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,IAAI,SAAc,CAAC;IAEnB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,qDAAqD;QACrD,IAAI,CAAC;YACH,SAAS,GAAG,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,SAAS,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,OAAO,GAAG,SAAS,MAAM,IAAI,YAAY,IAAI,eAAe,IAAI,CAAC;IAErE,IAAI,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC9B,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;IACrC,CAAC;SAAM,IAAI,SAAS,EAAE,OAAO,EAAE,CAAC;QAC9B,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC;IAC/B,CAAC;SAAM,IAAI,SAAS,EAAE,KAAK,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ;gBACjC,CAAC,CAAC,SAAS,CAAC,KAAK;gBACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC"}

package/lib/neon/api.d.ts

@@ -0,0 +1,70 @@
+import type { Secret } from "../secret.js";
+/**
+ * Options for Neon API requests
+ */
+export interface NeonApiOptions {
+    /**
+     * Base URL for Neon API
+     * @default https://console.neon.tech/api/v2
+     */
+    baseUrl?: string;
+    /**
+     * API Key to use (overrides NEON_API_KEY env var)
+     */
+    apiKey?: Secret;
+}
+/**
+ * Create a NeonApi instance with environment variable fallback
+ * @param options API options
+ * @returns NeonApi instance
+ */
+export declare function createNeonApi(options?: Partial<NeonApiOptions>): NeonApi;
+/**
+ * Get authentication headers for Neon API
+ * @param options NeonApiOptions
+ * @returns Headers for authentication
+ */
+export declare function getNeonAuthHeaders(options: Partial<NeonApiOptions>): Promise<Record<string, string>>;
+/**
+ * Neon API client using raw fetch
+ */
+export declare class NeonApi {
+    private readonly options;
+    readonly baseUrl: string;
+    /**
+     * Create a new Neon API client
+     * Use createNeonApi factory function instead of direct constructor
+     *
+     * @param options API options
+     */
+    constructor(options: NeonApiOptions);
+    /**
+     * Make a fetch request to the Neon API
+     *
+     * @param path API path (without base URL)
+     * @param init Fetch init options
+     * @returns Raw Response object from fetch
+     */
+    fetch(path: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Helper for GET requests
+     */
+    get(path: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Helper for POST requests
+     */
+    post(path: string, body: any, init?: RequestInit): Promise<Response>;
+    /**
+     * Helper for PUT requests
+     */
+    put(path: string, body: any, init?: RequestInit): Promise<Response>;
+    /**
+     * Helper for PATCH requests
+     */
+    patch(path: string, body: any, init?: RequestInit): Promise<Response>;
+    /**
+     * Helper for DELETE requests
+     */
+    delete(path: string, init?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/neon/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,OAAO,CAK5E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAcjC;AAED;;GAEG;AACH,qBAAa,OAAO;IASN,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC;;;;;OAKG;gBAC0B,OAAO,EAAE,cAAc;IAIpD;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IA2CpE;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIlE;;OAEG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC;IAUpB;;OAEG;IACG,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC;IAKpB;;OAEG;IACG,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,EACT,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC;IAQpB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGtE"}

package/lib/neon/api.js

@@ -0,0 +1,128 @@
+import { withExponentialBackoff } from "../util/retry.js";
+/**
+ * Create a NeonApi instance with environment variable fallback
+ * @param options API options
+ * @returns NeonApi instance
+ */
+export function createNeonApi(options = {}) {
+    return new NeonApi({
+        baseUrl: options.baseUrl,
+        apiKey: options.apiKey,
+    });
+}
+/**
+ * Get authentication headers for Neon API
+ * @param options NeonApiOptions
+ * @returns Headers for authentication
+ */
+export async function getNeonAuthHeaders(options) {
+    const apiKey = options.apiKey?.unencrypted ?? process.env.NEON_API_KEY;
+    if (!apiKey) {
+        throw new Error("Neon API key is required. Set NEON_API_KEY environment variable or provide apiKey option.");
+    }
+    return {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        Authorization: `Bearer ${apiKey}`,
+    };
+}
+/**
+ * Neon API client using raw fetch
+ */
+export class NeonApi {
+    options;
+    baseUrl;
+    /**
+     * Create a new Neon API client
+     * Use createNeonApi factory function instead of direct constructor
+     *
+     * @param options API options
+     */
+    constructor(options) {
+        this.options = options;
+        this.baseUrl = options.baseUrl ?? "https://console.neon.tech/api/v2";
+    }
+    /**
+     * Make a fetch request to the Neon API
+     *
+     * @param path API path (without base URL)
+     * @param init Fetch init options
+     * @returns Raw Response object from fetch
+     */
+    async fetch(path, init = {}) {
+        let headers = {};
+        if (Array.isArray(init.headers)) {
+            init.headers.forEach(([key, value]) => {
+                headers[key] = value;
+            });
+        }
+        else if (init.headers instanceof Headers) {
+            init.headers.forEach((value, key) => {
+                headers[key] = value;
+            });
+        }
+        else if (init.headers) {
+            headers = init.headers;
+        }
+        headers = {
+            ...(await getNeonAuthHeaders(this.options)),
+            ...headers,
+        };
+        // Use withExponentialBackoff for automatic retry on network errors
+        return withExponentialBackoff(() => fetch(`${this.baseUrl}${path}`, {
+            ...init,
+            headers,
+        }), (error) => {
+            // Only retry on network-related errors
+            const errorMsg = error.message || "";
+            const isNetworkError = errorMsg.includes("socket connection was closed") ||
+                errorMsg.includes("ECONNRESET") ||
+                errorMsg.includes("ETIMEDOUT") ||
+                errorMsg.includes("ECONNREFUSED");
+            return isNetworkError || error?.status?.toString().startsWith("5");
+        }, 5, // Maximum 5 attempts (1 initial + 4 retries)
+        1000 // Start with 1s delay, will exponentially increase
+        );
+    }
+    /**
+     * Helper for GET requests
+     */
+    async get(path, init = {}) {
+        return this.fetch(path, { ...init, method: "GET" });
+    }
+    /**
+     * Helper for POST requests
+     */
+    async post(path, body, init = {}) {
+        const requestBody = body instanceof FormData
+            ? body
+            : typeof body === "string"
+                ? body
+                : JSON.stringify(body);
+        return this.fetch(path, { ...init, method: "POST", body: requestBody });
+    }
+    /**
+     * Helper for PUT requests
+     */
+    async put(path, body, init = {}) {
+        const requestBody = body instanceof FormData ? body : JSON.stringify(body);
+        return this.fetch(path, { ...init, method: "PUT", body: requestBody });
+    }
+    /**
+     * Helper for PATCH requests
+     */
+    async patch(path, body, init = {}) {
+        return this.fetch(path, {
+            ...init,
+            method: "PATCH",
+            body: JSON.stringify(body),
+        });
+    }
+    /**
+     * Helper for DELETE requests
+     */
+    async delete(path, init = {}) {
+        return this.fetch(path, { ...init, method: "DELETE" });
+    }
+}
+//# sourceMappingURL=api.js.map

package/lib/neon/api.js.map

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

package/lib/neon/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./api-error.js";
+export * from "./api.js";
+export * from "./project.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/neon/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

package/lib/neon/index.js

@@ -0,0 +1,4 @@
+export * from "./api-error.js";
+export * from "./api.js";
+export * from "./project.js";
+//# sourceMappingURL=index.js.map

package/lib/neon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/neon/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

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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"}