alchemy 0.79.0 → 0.80.0

package/lib/docker/container.js

@@ -87,62 +87,82 @@ export const Container = Resource("docker::Container", async function (id, props
         // Return destroyed state
         return this.destroy();
     }
-    else {
-        let containerState = "created";
+    let containerState = "created";
+    // Check if container already exists
+    const containerExists = await api.containerExists(containerName);
+    if (containerExists) {
         if (this.phase === "update") {
-            // Check if container already exists (for update)
-            const containerExists = await api.containerExists(containerName);
-            if (containerExists) {
-                // Remove existing container for update
-                await api.removeContainer(containerName, true);
-            }
+            // Remove existing container for update
+            await api.removeContainer(containerName, true);
         }
-        // Prepare port mappings
-        const portMappings = {};
-        if (props.ports) {
-            for (const port of props.ports) {
-                const protocol = port.protocol || "tcp";
-                portMappings[`${port.external}`] = `${port.internal}/${protocol}`;
+        else {
+            // Create phase - check for adoption
+            if (!props.adopt) {
+                throw new Error(`Container "${containerName}" already exists. Use adopt: true to adopt it.`);
             }
-        }
-        // Prepare volume mappings
-        const volumeMappings = {};
-        if (props.volumes) {
-            for (const volume of props.volumes) {
-                const readOnlyFlag = volume.readOnly ? ":ro" : "";
-                volumeMappings[volume.hostPath] =
-                    `${volume.containerPath}${readOnlyFlag}`;
+            // Adopt existing container
+            const containerInfos = await api.inspectContainer(containerName);
+            const containerInfo = containerInfos[0];
+            let adoptedState = containerInfo.State.Status;
+            // Optionally start the container if requested
+            if (props.start && containerInfo.State.Status !== "running") {
+                await api.startContainer(containerName);
+                adoptedState = "running";
             }
+            return {
+                ...props,
+                id: containerInfo.Id,
+                name: containerName,
+                state: adoptedState,
+                createdAt: new Date(containerInfo.Created).getTime(),
+            };
         }
-        // Create new container
-        const containerId = await api.createContainer(imageRef, containerName, {
-            ports: portMappings,
-            env: props.environment,
-            volumes: volumeMappings,
-            cmd: props.command,
-            healthcheck: props.healthcheck,
-        });
-        // Connect to networks if specified
-        if (props.networks) {
-            for (const network of props.networks) {
-                const networkId = typeof network === "string" ? network : network.name;
-                await api.connectNetwork(containerId, networkId, {
-                    aliases: network.aliases,
-                });
-            }
+    }
+    // Prepare port mappings
+    const portMappings = {};
+    if (props.ports) {
+        for (const port of props.ports) {
+            const protocol = port.protocol || "tcp";
+            portMappings[`${port.external}`] = `${port.internal}/${protocol}`;
         }
-        // Start container if requested
-        if (props.start) {
-            await api.startContainer(containerId);
-            containerState = "running";
+    }
+    // Prepare volume mappings
+    const volumeMappings = {};
+    if (props.volumes) {
+        for (const volume of props.volumes) {
+            const readOnlyFlag = volume.readOnly ? ":ro" : "";
+            volumeMappings[volume.hostPath] =
+                `${volume.containerPath}${readOnlyFlag}`;
+        }
+    }
+    // Create new container
+    const containerId = await api.createContainer(imageRef, containerName, {
+        ports: portMappings,
+        env: props.environment,
+        volumes: volumeMappings,
+        cmd: props.command,
+        healthcheck: props.healthcheck,
+    });
+    // Connect to networks if specified
+    if (props.networks) {
+        for (const network of props.networks) {
+            const networkId = typeof network === "string" ? network : network.name;
+            await api.connectNetwork(containerId, networkId, {
+                aliases: network.aliases,
+            });
         }
-        return {
-            ...props,
-            id: containerId,
-            name: containerName,
-            state: containerState,
-            createdAt: Date.now(),
-        };
     }
+    // Start container if requested
+    if (props.start) {
+        await api.startContainer(containerId);
+        containerState = "running";
+    }
+    return {
+        ...props,
+        id: containerId,
+        name: containerName,
+        state: containerState,
+        createdAt: Date.now(),
+    };
 });
 //# sourceMappingURL=container.js.map

package/lib/docker/container.js.map

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

package/lib/docker/volume.d.ts

@@ -35,6 +35,11 @@ export interface VolumeProps {
      * Custom metadata labels for the volume
      */
     labels?: VolumeLabel[] | Record<string, string>;
+    /**
+     * Whether to adopt the volume if it already exists
+     * @default false
+     */
+    adopt?: boolean;
 }
 /**
  * Docker Volume resource

package/lib/docker/volume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/docker/volume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,WAAW;IACzC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,MAAM,yFAGT,OAAO,CAAC,MAAM,CAAC,MACjB,MAAM,SACH,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,CA2DnB,CAAC"}
+{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/docker/volume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,WAAW;IACzC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,MAAM,yFAGT,OAAO,CAAC,MAAM,CAAC,MACjB,MAAM,SACH,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,CA0FnB,CAAC"}

package/lib/docker/volume.js

@@ -54,25 +54,49 @@ export const Volume = Resource("docker::Volume", async function (id, props) {
         // Return destroyed state
         return this.destroy();
     }
-    else {
-        // Set default driver if not provided
-        const driver = props.driver || "local";
-        const driverOpts = props.driverOpts || {};
-        // Create the volume
-        const volumeId = await api.createVolume(volumeName, driver, driverOpts, processedLabels);
-        // Get volume details to retrieve mountpoint
-        const volumeInfos = await api.inspectVolume(volumeId);
-        const mountpoint = volumeInfos[0].Mountpoint;
-        return {
-            ...props,
-            driver: driver,
-            id: volumeId,
-            name: volumeName,
-            mountpoint,
-            createdAt: Date.now(),
-            labels: Array.isArray(props.labels) ? props.labels : undefined,
-            driverOpts: props.driverOpts,
-        };
+    // Check if volume already exists
+    const volumeExists = await api.volumeExists(volumeName);
+    if (volumeExists) {
+        if (this.phase === "update") {
+            this.replace();
+        }
+        else {
+            // Create phase - check for adoption
+            if (!props.adopt) {
+                throw new Error(`Volume "${volumeName}" already exists. Use adopt: true to adopt it.`);
+            }
+            // Adopt existing volume
+            const volumeInfos = await api.inspectVolume(volumeName);
+            const volumeInfo = volumeInfos[0];
+            return {
+                ...props,
+                id: volumeInfo.Name,
+                name: volumeInfo.Name,
+                driver: volumeInfo.Driver,
+                mountpoint: volumeInfo.Mountpoint,
+                createdAt: new Date(volumeInfo.CreatedAt).getTime(),
+                labels: Array.isArray(props.labels) ? props.labels : undefined,
+                driverOpts: volumeInfo.Options,
+            };
+        }
     }
+    // Set default driver if not provided
+    const driver = props.driver || "local";
+    const driverOpts = props.driverOpts || {};
+    // Create the volume
+    const volumeId = await api.createVolume(volumeName, driver, driverOpts, processedLabels);
+    // Get volume details to retrieve mountpoint
+    const volumeInfos = await api.inspectVolume(volumeId);
+    const mountpoint = volumeInfos[0].Mountpoint;
+    return {
+        ...props,
+        driver: driver,
+        id: volumeId,
+        name: volumeName,
+        mountpoint,
+        createdAt: Date.now(),
+        labels: Array.isArray(props.labels) ? props.labels : undefined,
+        driverOpts: props.driverOpts,
+    };
 });
 //# sourceMappingURL=volume.js.map

package/lib/docker/volume.js.map

@@ -1 +1 @@
-{"version":3,"file":"volume.js","sourceRoot":"","sources":["../../src/docker/volume.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAsErC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAC5B,gBAAgB,EAChB,KAAK,WAEH,EAAU,EACV,KAAkB;IAElB,+BAA+B;IAC/B,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;IAE5B,MAAM,UAAU,GACd,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAEvE,6CAA6C;IAC7C,MAAM,eAAe,GAA2B,EAAE,CAAC;IACnD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,2CAA2C;YAC3C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;YAC5C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,sBAAsB;YACtB,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;YACtB,gBAAgB;YAChB,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,yBAAyB;QACzB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,qCAAqC;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;QACvC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;QAE1C,oBAAoB;QACpB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,YAAY,CACrC,UAAU,EACV,MAAM,EACN,UAAU,EACV,eAAe,CAChB,CAAC;QAEF,4CAA4C;QAC5C,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAE7C,OAAO;YACL,GAAG,KAAK;YACR,MAAM,EAAE,MAAM;YACd,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,UAAU;YAChB,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC9D,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC"}
+{"version":3,"file":"volume.js","sourceRoot":"","sources":["../../src/docker/volume.ts"],"names":[],"mappings":"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"}

package/lib/neon/project.d.ts

@@ -11,6 +11,16 @@ export type NeonPgVersion = 14 | 15 | 16 | 17 | 18;
  * Properties for creating or updating a Neon project
  */
 export interface NeonProjectProps extends NeonApiOptions {
+    /**
+     * When `true`, will adopt an existing project by `name`
+     */
+    adopt?: true;
+    /**
+     * Whether to delete the database when the resource is destroyed.
+     * When false, the database will only be removed from the state but not deleted via API.
+     * @default true, unless the resource was adopted
+     */
+    delete?: boolean;
     /**
      * Name of the project
      *
@@ -122,6 +132,13 @@ export interface NeonProject {
  * });
  *
  * @example
+ * // Adopt an existing Neon project by name:
+ * const project = await NeonProject("my-project", {
+ *   adopt: true
+ *   name: "adjective-noun-123",
+ * });
+ *
+ * @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",
@@ -137,21 +154,18 @@ export interface NeonProject {
  *   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<{
-    id: string;
+export declare const NeonProject: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<NeonProject>, id: string, props: NeonProjectProps) => Promise<NeonProject>);
+/**
+ * References an existing Neon project by name. You can use this to reference an existing NeonProject without adopting it.
+ *
+ * @example
+ * const project = await NeonProjectRef({
+ *   name: "my-project"
+ * });
+ *
+ * @warning Project names must be unique when referencing existing projects. If multiple projects are found with the same name, an error will be thrown.
+ */
+export declare function NeonProjectRef(props: NeonProjectProps & {
     name: string;
-    created_at: string;
-    updated_at: string;
-    proxy_host: string;
-    region_id: NeonRegion;
-    pg_version: NeonPgVersion;
-    settings: neon.ProjectSettingsData | undefined;
-    default_endpoint_settings: neon.DefaultEndpointSettings | undefined;
-    history_retention_seconds: number;
-    connection_uris: [NeonConnectionUri, ...NeonConnectionUri[]];
-    roles: [NeonRole, ...NeonRole[]];
-    databases: [neon.Database, ...neon.Database[]];
-    branch: neon.Branch;
-    endpoints: [neon.Endpoint, ...neon.Endpoint[]];
-}>);
+}): Promise<NeonProject>;
 //# sourceMappingURL=project.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/neon/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,eAAe,GACf,WAAW,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAEpC;;OAEG;IACH,yBAAyB,CAAC,EAAE,IAAI,CAAC,uBAAuB,CAAC;IAEzD;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAE/C;;OAEG;IACH,yBAAyB,EAAE,IAAI,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAEpE;;OAEG;IACH,yBAAyB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,UAAU,EAAE,aAAa,CAAC;IAE1B;;OAEG;IACH,eAAe,EAAE,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC,CAAC;IAE7D;;OAEG;IACH,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAEjC;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE/C;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,yFAGd,OAAO,CAAC,WAAW,CAAC,MACtB,MAAM,SACH,gBAAgB;;;;;;eAkDoB,UAAU;gBACR,aAAa;;;;qBAIc,CAChE,iBAAiB,EACjB,GAAG,iBAAiB,EAAE,CACvB;WACoC,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC;eACjC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;;eAExC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;GAkDpE,CAAC"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/neon/project.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE9D,OAAO,KAAK,KAAK,IAAI,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EAEd,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,eAAe,GACf,WAAW,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC;IAEb;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB;;;OAGG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;IAEpC;;OAEG;IACH,yBAAyB,CAAC,EAAE,IAAI,CAAC,uBAAuB,CAAC;IAEzD;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,IAAI,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAE/C;;OAEG;IACH,yBAAyB,EAAE,IAAI,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAEpE;;OAEG;IACH,yBAAyB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,UAAU,EAAE,aAAa,CAAC;IAE1B;;OAEG;IACH,eAAe,EAAE,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC,CAAC;IAE7D;;OAEG;IACH,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAEjC;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE/C;;OAEG;IACH,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,WAAW,yFAGd,OAAO,CAAC,WAAW,CAAC,MACtB,MAAM,SACH,gBAAgB,0BA4H1B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,WAAW,CAAC,CAEtB"}

package/lib/neon/project.js

@@ -1,3 +1,4 @@
+import { alchemy } from "../alchemy.js";
 import { Resource } from "../resource.js";
 import { createNeonApi } from "./api.js";
 import { formatConnectionUri, formatRole, waitForOperations, } from "./utils.js";
@@ -11,6 +12,13 @@ import { formatConnectionUri, formatRole, waitForOperations, } from "./utils.js"
  * });
  *
  * @example
+ * // Adopt an existing Neon project by name:
+ * const project = await NeonProject("my-project", {
+ *   adopt: true
+ *   name: "adjective-noun-123",
+ * });
+ *
+ * @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",
@@ -31,6 +39,17 @@ export const NeonProject = Resource("neon::Project", async function (id, props)
     const name = props.name ?? this.output?.name ?? this.scope.createPhysicalName(id);
     switch (this.phase) {
         case "create": {
+            if (props.adopt) {
+                try {
+                    return await fetchProject(api, { ...props, name });
+                }
+                catch (error) {
+                    if (!(error instanceof NeonProjectNotFound)) {
+                        throw error;
+                    }
+                    // project not found, continue with creation
+                }
+            }
             const { data } = await api.createProject({
                 body: {
                     project: {
@@ -110,7 +129,7 @@ export const NeonProject = Resource("neon::Project", async function (id, props)
             };
         }
         case "delete": {
-            if (this.output?.id) {
+            if (props.delete !== false && this.output?.id) {
                 const response = await api.deleteProject({
                     path: {
                         project_id: this.output.id,
@@ -127,4 +146,107 @@ export const NeonProject = Resource("neon::Project", async function (id, props)
         }
     }
 });
+/**
+ * References an existing Neon project by name. You can use this to reference an existing NeonProject without adopting it.
+ *
+ * @example
+ * const project = await NeonProjectRef({
+ *   name: "my-project"
+ * });
+ *
+ * @warning Project names must be unique when referencing existing projects. If multiple projects are found with the same name, an error will be thrown.
+ */
+export async function NeonProjectRef(props) {
+    return await fetchProject(createNeonApi(props), props);
+}
+async function fetchProject(api, props) {
+    const project = await api
+        .listProjects({
+        query: { search: props.name },
+    })
+        .then(({ data: { projects } }) => {
+        if (!projects.length) {
+            throw new NeonProjectNotFound(props.name);
+        }
+        if (projects.length > 1) {
+            throw new Error(`Multiple projects found with name "${props.name}". Name must be unique when referencing existing projects.`);
+        }
+        return projects[0];
+    });
+    const endpointsPromise = api
+        .listProjectEndpoints({
+        path: { project_id: project.id },
+    })
+        .then((res) => res.data.endpoints);
+    const branch = await api
+        .listProjectBranches({
+        path: { project_id: project.id },
+        query: { search: props.default_branch_name ?? "main" },
+    })
+        .then((res) => {
+        if (!res.data.branches.length) {
+            throw new Error(`Branch ${props.default_branch_name ?? "main"} does not exist in Neon project "${props.name}" (${project.id}).`);
+        }
+        return res.data.branches[0];
+    });
+    const rolesPromise = api
+        .listProjectBranchRoles({
+        path: { project_id: project.id, branch_id: branch.id },
+    })
+        .then((res) => res.data.roles.map(formatRole));
+    const databases = await api
+        .listProjectBranchDatabases({
+        path: { project_id: project.id, branch_id: branch.id },
+    })
+        .then((res) => res.data.databases);
+    const [connection_uris, endpoints, roles] = await Promise.all([
+        Promise.all(databases.map(fetchConnectionUri)),
+        endpointsPromise,
+        rolesPromise,
+    ]);
+    return {
+        id: project.id,
+        name: project.name,
+        created_at: project.created_at,
+        updated_at: project.updated_at,
+        proxy_host: project.proxy_host,
+        region_id: project.region_id,
+        pg_version: project.pg_version,
+        settings: project.settings,
+        default_endpoint_settings: project.default_endpoint_settings,
+        history_retention_seconds: project.history_retention_seconds ?? 86400,
+        connection_uris,
+        roles,
+        databases,
+        branch,
+        endpoints,
+    };
+    async function fetchConnectionUri(database) {
+        const { data: { uri }, } = await api.getConnectionUri({
+            path: { project_id: project.id },
+            query: {
+                branch_id: database.branch_id,
+                database_name: database.name,
+                role_name: database.owner_name,
+                pooled: false, // match default behavior from create endpoint (should this be true?)
+            },
+        });
+        const url = new URL(uri);
+        return {
+            connection_uri: alchemy.secret(uri),
+            connection_parameters: {
+                database: database.name,
+                host: url.host,
+                port: 5432,
+                user: url.username,
+                password: alchemy.secret(url.password),
+            },
+        };
+    }
+}
+class NeonProjectNotFound extends Error {
+    constructor(name) {
+        super(`Failed to find existing project "${name}".`);
+    }
+}
 //# sourceMappingURL=project.js.map

package/lib/neon/project.js.map

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

package/lib/util/find-open-port.d.ts

@@ -1,2 +1,3 @@
+export declare function reservePort(key: string): Promise<number>;
 export declare function findOpenPort(min?: number, max?: number): Promise<number>;
 //# sourceMappingURL=find-open-port.d.ts.map

package/lib/util/find-open-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find-open-port.d.ts","sourceRoot":"","sources":["../../src/util/find-open-port.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAAC,GAAG,SAAO,EAAE,GAAG,SAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAO3E"}
+{"version":3,"file":"find-open-port.d.ts","sourceRoot":"","sources":["../../src/util/find-open-port.ts"],"names":[],"mappings":"AAQA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,mBAU5C;AAED,wBAAsB,YAAY,CAAC,GAAG,SAAO,EAAE,GAAG,SAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAO3E"}

package/lib/util/find-open-port.js

@@ -1,4 +1,19 @@
 import net from "node:net";
+import { AsyncMutex } from "./mutex.js";
+const owners = new Map();
+const ports = new Map();
+const mutex = new AsyncMutex();
+export async function reservePort(key) {
+    if (owners.has(key)) {
+        return owners.get(key);
+    }
+    return mutex.lock(async () => {
+        const port = await findOpenPort();
+        owners.set(key, port);
+        ports.set(port, key);
+        return port;
+    });
+}
 export async function findOpenPort(min = 1337, max = 65535) {
     for (let port = min; port <= max; port++) {
         if (await isPortAvailable("0.0.0.0", port)) {

package/lib/util/find-open-port.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-open-port.js","sourceRoot":"","sources":["../../src/util/find-open-port.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAG,GAAG,IAAI,EAAE,GAAG,GAAG,KAAK;IACxD,KAAK,IAAI,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,MAAM,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,iBAAiB;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC7B,oBAAoB;YACpB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"find-open-port.js","sourceRoot":"","sources":["../../src/util/find-open-port.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;AACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QAC3B,MAAM,IAAI,GAAG,MAAM,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAG,GAAG,IAAI,EAAE,GAAG,GAAG,KAAK;IACxD,KAAK,IAAI,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,MAAM,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,QAAQ,GAAG,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,iBAAiB;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;YAC7B,oBAAoB;YACpB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.79.0",
+  "version": "0.80.0",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
   "homepage": "https://alchemy.run",

package/src/cloudflare/bindings.ts

@@ -26,10 +26,10 @@ import type { SecretRef as CloudflareSecretRef } from "./secret-ref.ts";
 import type { Secret as CloudflareSecret } from "./secret.ts";
 import type { VectorizeIndex } from "./vectorize-index.ts";
 import type { VersionMetadata } from "./version-metadata.ts";
+import type { WorkerLoader } from "./worker-loader.ts";
 import type { WorkerRef } from "./worker-ref.ts";
 import type { WorkerStub } from "./worker-stub.ts";
 import type { Worker } from "./worker.ts";
-import type { WorkerLoader } from "./worker-loader.ts";
 import type { Workflow } from "./workflow.ts";
 
 export type Bindings = {
@@ -72,6 +72,8 @@ export type Binding =
   | string
   | VectorizeIndex
   | Worker
+  | Worker.DevDomain
+  | Worker.DevUrl
   | WorkerStub
   | WorkerRef
   | WorkerEntrypoint

package/src/cloudflare/bound.ts

@@ -88,17 +88,23 @@ export type Bound<T extends Binding> =
                                                   ? ImagesBinding
                                                   : T extends _VersionMetadata
                                                     ? WorkerVersionMetadata
-                                                    : T extends Self
-                                                      ? Service
-                                                      : T extends Json<infer T>
-                                                        ? T
-                                                        : T extends _Container<
-                                                              infer Obj
+                                                    : T extends
+                                                          | _Worker.DevDomain
+                                                          | _Worker.DevUrl
+                                                      ? string
+                                                      : T extends Self
+                                                        ? Service
+                                                        : T extends Json<
+                                                              infer T
                                                             >
-                                                          ? DurableObjectNamespace<
-                                                              Obj &
-                                                                Rpc.DurableObjectBranded
-                                                            >
-                                                          : T extends undefined
-                                                            ? undefined
-                                                            : Service;
+                                                          ? T
+                                                          : T extends _Container<
+                                                                infer Obj
+                                                              >
+                                                            ? DurableObjectNamespace<
+                                                                Obj &
+                                                                  Rpc.DurableObjectBranded
+                                                              >
+                                                            : T extends undefined
+                                                              ? undefined
+                                                              : Service;

package/src/cloudflare/compatibility-date.gen.ts

@@ -4,4 +4,4 @@
 /**
  * The default Cloudflare Workers compatibility date, set based on the latest workerd release at the time of build.
  */
-export const DEFAULT_COMPATIBILITY_DATE = "2025-11-28";
+export const DEFAULT_COMPATIBILITY_DATE = "2025-12-02";