alchemy 0.25.0 → 0.26.1

package/lib/planetscale/database.js

@@ -0,0 +1,184 @@
+import { Resource } from "../resource.js";
+import { PlanetScaleApi } from "./api.js";
+import { fixClusterSize, waitForDatabaseReady, } from "./utils.js";
+/**
+ * Create, manage and delete PlanetScale databases
+ *
+ * @example
+ * // Create a basic database in a specific organization
+ * const db = await Database("my-app-db", {
+ *   name: "my-app-db",
+ *   organizationId: "my-org",
+ *   clusterSize: "PS_10"
+ * });
+ *
+ * @example
+ * // Create a database with specific region and settings
+ * const db = await Database("my-app-db", {
+ *   name: "my-app-db",
+ *   organizationId: "my-org",
+ *   region: {
+ *     slug: "us-east"
+ *   },
+ *   clusterSize: "PS_10",
+ *   requireApprovalForDeploy: true,
+ *   allowDataBranching: true,
+ *   automaticMigrations: true
+ * });
+ *
+ * @example
+ * // Create a database with custom API key
+ * const db = await Database("my-app-db", {
+ *   name: "my-app-db",
+ *   organizationId: "my-org",
+ *   apiKey: alchemy.secret(process.env.CUSTOM_PLANETSCALE_TOKEN),
+ *   clusterSize: "PS_10"
+ * });
+ */
+export const Database = Resource("planetscale::Database", async function (_id, props) {
+    const apiKey = props.apiKey?.unencrypted || process.env.PLANETSCALE_API_TOKEN;
+    if (!apiKey) {
+        throw new Error("PLANETSCALE_API_TOKEN environment variable is required");
+    }
+    const api = new PlanetScaleApi({ apiKey });
+    if (this.phase === "delete") {
+        try {
+            if (this.output?.name) {
+                const response = await api.delete(`/organizations/${props.organizationId}/databases/${this.output.name}`);
+                if (!response.ok && response.status !== 404) {
+                    throw new Error(`Failed to delete database: ${response.statusText} ${await response.text()}`);
+                }
+            }
+        }
+        catch (error) {
+            console.error("Error deleting database:", error);
+            throw error;
+        }
+        return this.destroy();
+    }
+    try {
+        // Check if database exists
+        const getResponse = await api.get(`/organizations/${props.organizationId}/databases/${props.name}`);
+        const getData = await getResponse.json();
+        if (this.phase === "update" || (props.adopt && getResponse.ok)) {
+            if (!getResponse.ok) {
+                throw new Error(`Database ${props.name} not found`);
+            }
+            // Update database settings
+            // If updating to a non-'main' default branch, create it first
+            if (props.defaultBranch && props.defaultBranch !== "main") {
+                const branchResponse = await api.get(`/organizations/${props.organizationId}/databases/${props.name}/branches/${props.defaultBranch}`);
+                if (!getData.ready) {
+                    await waitForDatabaseReady(api, props.organizationId, props.name);
+                }
+                if (!branchResponse.ok && branchResponse.status === 404) {
+                    // Create the branch
+                    const createBranchResponse = await api.post(`/organizations/${props.organizationId}/databases/${props.name}/branches`, {
+                        name: props.defaultBranch,
+                        parent_branch: "main",
+                    });
+                    if (!createBranchResponse.ok) {
+                        throw new Error(`Failed to create default branch: ${createBranchResponse.statusText} ${await createBranchResponse.text()}`);
+                    }
+                }
+            }
+            const updateResponse = await api.patch(`/organizations/${props.organizationId}/databases/${props.name}`, {
+                automatic_migrations: props.automaticMigrations,
+                migration_framework: props.migrationFramework,
+                migration_table_name: props.migrationTableName,
+                require_approval_for_deploy: props.requireApprovalForDeploy,
+                restrict_branch_region: props.restrictBranchRegion,
+                allow_data_branching: props.allowDataBranching,
+                insights_raw_queries: props.insightsRawQueries,
+                production_branch_web_console: props.productionBranchWebConsole,
+                default_branch: props.defaultBranch,
+            });
+            if (!updateResponse.ok) {
+                throw new Error(`Failed to update database: ${updateResponse.statusText} ${await updateResponse.text()}`);
+            }
+            await fixClusterSize(api, props.organizationId, props.name, props.defaultBranch || "main", props.clusterSize, getData.ready);
+            const data = await updateResponse.json();
+            return this({
+                ...props,
+                id: data.id,
+                state: data.state,
+                defaultBranch: data.default_branch,
+                plan: data.plan,
+                createdAt: data.created_at,
+                updatedAt: data.updated_at,
+                htmlUrl: data.html_url,
+            });
+        }
+        if (getResponse.ok) {
+            throw new Error(`Database with name ${props.name} already exists`);
+        }
+        // Create new database
+        const createResponse = await api.post(`/organizations/${props.organizationId}/databases`, {
+            name: props.name,
+            region_slug: props.region?.slug,
+            require_approval_for_deploy: props.requireApprovalForDeploy,
+            allow_data_branching: props.allowDataBranching,
+            automatic_migrations: props.automaticMigrations,
+            restrict_branch_region: props.restrictBranchRegion,
+            insights_raw_queries: props.insightsRawQueries,
+            production_branch_web_console: props.productionBranchWebConsole,
+            migration_framework: props.migrationFramework,
+            migration_table_name: props.migrationTableName,
+            cluster_size: props.clusterSize,
+        });
+        if (!createResponse.ok) {
+            throw new Error(`Failed to create database: ${createResponse.statusText} ${await createResponse.text()}`);
+        }
+        const data = await createResponse.json();
+        // If a non-'main' default branch is specified, create it
+        if (props.defaultBranch && props.defaultBranch !== "main") {
+            await waitForDatabaseReady(api, props.organizationId, props.name);
+            // Check if branch exists
+            const branchResponse = await api.get(`/organizations/${props.organizationId}/databases/${props.name}/branches/${props.defaultBranch}`);
+            if (!branchResponse.ok && branchResponse.status === 404) {
+                // Create the branch
+                const createBranchResponse = await api.post(`/organizations/${props.organizationId}/databases/${props.name}/branches`, {
+                    name: props.defaultBranch,
+                    parent_branch: "main",
+                });
+                if (!createBranchResponse.ok) {
+                    throw new Error(`Failed to create default branch: ${createBranchResponse.statusText} ${await createBranchResponse.text()}`);
+                }
+                await fixClusterSize(api, props.organizationId, props.name, props.defaultBranch || "main", props.clusterSize, false);
+                // Update database to use new branch as default
+                const updateResponse = await api.patch(`/organizations/${props.organizationId}/databases/${props.name}`, {
+                    default_branch: props.defaultBranch,
+                });
+                if (!updateResponse.ok) {
+                    throw new Error(`Failed to set default branch: ${updateResponse.statusText} ${await updateResponse.text()}`);
+                }
+                const updatedData = await updateResponse.json();
+                return this({
+                    ...props,
+                    id: data.id,
+                    state: updatedData.state,
+                    defaultBranch: updatedData.default_branch,
+                    plan: updatedData.plan,
+                    createdAt: updatedData.created_at,
+                    updatedAt: updatedData.updated_at,
+                    htmlUrl: updatedData.html_url,
+                });
+            }
+        }
+        return this({
+            ...props,
+            id: data.id,
+            state: data.state,
+            defaultBranch: data.default_branch || "main",
+            plan: data.plan,
+            createdAt: data.created_at,
+            updatedAt: data.updated_at,
+            htmlUrl: data.html_url,
+        });
+    }
+    catch (error) {
+        console.error("Error managing database:", error);
+        throw error;
+    }
+});
+//# sourceMappingURL=database.js.map

package/lib/planetscale/database.js.map

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

package/lib/planetscale/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./api.ts";
+export * from "./utils.ts";
+export * from "./database.ts";
+export * from "./branch.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planetscale/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/lib/planetscale/index.js

@@ -0,0 +1,5 @@
+export * from "./api.js";
+export * from "./utils.js";
+export * from "./database.js";
+export * from "./branch.js";
+//# sourceMappingURL=index.js.map

package/lib/planetscale/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planetscale/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/lib/planetscale/utils.d.ts

@@ -0,0 +1,15 @@
+import type { PlanetScaleApi } from "./api.ts";
+export type PlanetScaleClusterSize = "PS_DEV" | "PS_10" | "PS_20" | "PS_40" | "PS_80" | "PS_160" | "PS_320" | "PS_400" | "PS_640" | "PS_700" | "PS_900" | "PS_1280" | "PS_1400" | "PS_1800" | "PS_2100" | "PS_2560" | "PS_2700" | "PS_2800" | (string & {});
+/**
+ * Wait for a database to be ready with exponential backoff
+ */
+export declare function waitForDatabaseReady(api: PlanetScaleApi, organizationId: string, databaseName: string, branchName?: string): Promise<void>;
+/**
+ * Wait for a keyspace to be ready
+ */
+export declare function waitForKeyspaceReady(api: PlanetScaleApi, org: string, db: string, branch: string, keyspace: string): Promise<void>;
+/**
+ * Fix cluster size for a branch
+ */
+export declare function fixClusterSize(api: PlanetScaleApi, organizationId: string, databaseName: string, branchName: string, expectedClusterSize: PlanetScaleClusterSize, isDBReady: boolean): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/lib/planetscale/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/planetscale/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,sBAAsB,EAC3C,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

package/lib/planetscale/utils.js

@@ -0,0 +1,95 @@
+/**
+ * Wait for a database to be ready with exponential backoff
+ */
+export async function waitForDatabaseReady(api, organizationId, databaseName, branchName) {
+    const startTime = Date.now();
+    let waitMs = 100;
+    const branchSuffix = branchName ? `/branches/${branchName}` : "";
+    while (true) {
+        const response = await api.get(`/organizations/${organizationId}/databases/${databaseName}${branchSuffix}`);
+        if (!response.ok) {
+            throw new Error(`Failed to check database state: ${response.statusText}`);
+        }
+        const data = await response.json();
+        if (data.ready === true) {
+            return;
+        }
+        if (Date.now() - startTime >= 60000) {
+            throw new Error(`Timeout waiting for database ${databaseName} to be ready`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+        waitMs = Math.min(waitMs * 2, 1000); // Cap at 1s intervals
+    }
+}
+/**
+ * Wait for a keyspace to be ready
+ */
+export async function waitForKeyspaceReady(api, org, db, branch, keyspace) {
+    const start = Date.now();
+    let delay = 100;
+    while (true) {
+        const res = await api.get(`/organizations/${org}/databases/${db}/branches/${branch}/keyspaces/${keyspace}/resizes`);
+        if (!res.ok) {
+            throw new Error(`Error fetching keyspace "${keyspace}": ${res.statusText}`);
+        }
+        const ks = await res.json();
+        // once it's fully ready, we can proceed
+        if (ks.data.every((item) => item.state !== "resizing")) {
+            return;
+        }
+        if (Date.now() - start > 600_000) {
+            throw new Error(`Timeout waiting for keyspace "${keyspace}" to be ready`);
+        }
+        await new Promise((r) => setTimeout(r, delay));
+        delay = Math.min(delay * 2, 1_000);
+    }
+}
+/**
+ * Fix cluster size for a branch
+ */
+export async function fixClusterSize(api, organizationId, databaseName, branchName, expectedClusterSize, isDBReady) {
+    if (!isDBReady) {
+        await waitForDatabaseReady(api, organizationId, databaseName);
+    }
+    // 1. Ensure branch is production
+    let branchRes = await api.get(`/organizations/${organizationId}/databases/${databaseName}/branches/${branchName}`);
+    if (!branchRes.ok) {
+        throw new Error(`Unable to get branch data: ${branchRes.statusText}`);
+    }
+    let branchData = await branchRes.json();
+    if (!branchData.production) {
+        if (!branchData.ready) {
+            await waitForDatabaseReady(api, organizationId, databaseName, branchName);
+        }
+        const promoteRes = await api.post(`/organizations/${organizationId}/databases/${databaseName}/branches/${branchName}/promote`);
+        if (!promoteRes.ok) {
+            throw new Error(`Unable to promote branch: ${promoteRes.statusText}`);
+        }
+    }
+    // 2. Load default keyspace
+    const ksListRes = await api.get(`/organizations/${organizationId}/databases/${databaseName}/branches/${branchName}/keyspaces`);
+    if (!ksListRes.ok) {
+        throw new Error(`Failed to list keyspaces: ${ksListRes.statusText}`);
+    }
+    const ksList = (await ksListRes.json()).data;
+    const defaultKsData = ksList.find((x) => x.name === databaseName); // Default keypsace is always the same name as the database
+    if (ksList.length === 0 || !defaultKsData) {
+        throw new Error(`No default keyspace found for branch ${branchName}`);
+    }
+    const defaultKs = defaultKsData.name;
+    let currentSize = defaultKsData.cluster_name;
+    // 3. Wait until any in-flight resize is done
+    await waitForKeyspaceReady(api, organizationId, databaseName, branchName, defaultKs);
+    // 4. If size mismatch, trigger resize and wait again
+    // Ideally this would use the undocumented Keyspaces API, but there seems to be a missing oauth scope that we cannot add via the console yet
+    if (currentSize !== expectedClusterSize) {
+        const resizeRes = await api.patch(`/organizations/${organizationId}/databases/${databaseName}/branches/${branchName}/cluster`, { cluster_size: expectedClusterSize });
+        if (!resizeRes.ok) {
+            const text = await resizeRes.text();
+            throw new Error(`Failed to start resize: ${resizeRes.statusText} ${text}`);
+        }
+        // Poll until the resize completes
+        await waitForKeyspaceReady(api, organizationId, databaseName, branchName, defaultKs);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/lib/planetscale/utils.js.map

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

package/lib/resource.js

@@ -44,7 +44,13 @@ export function Resource(type, ...args) {
             const otherResource = scope.resources.get(resourceID);
             if (otherResource?.[ResourceKind] !== type) {
                 scope.fail();
-                throw new Error(`Resource ${resourceID} already exists in the stack and is of a different type: '${otherResource?.[ResourceKind]}' !== '${type}'`);
+                const error = new Error(`Resource ${resourceID} already exists in the stack and is of a different type: '${otherResource?.[ResourceKind]}' !== '${type}'`);
+                scope.telemetryClient.record({
+                    event: "resource.error",
+                    resource: type,
+                    error,
+                });
+                throw error;
             }
         }
         // get a sequence number (unique within the scope) for the resource

package/lib/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,KAAK,IAAI,MAAM,EAAc,MAAM,YAAY,CAAC;AAEzD,MAAM,CAAC,MAAM,SAAS,GAA6C,IAAI,GAAG,EAGvE,CAAC;AACJ,MAAM,0BAA0B,GAA8B,EAAE,CAAC;AAMjE;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAgC;IAEhC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,QAAQ,GAAsC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5E,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,0BAA0B,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAGD,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAkE9D,MAAM,UAAU,QAAQ,CAGtB,IAAU,EAAE,GAAG,IAAyC;IACxD,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,iBAAiB,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAI3E,MAAM,QAAQ,GAAG,CAAC,KAAK,EACrB,UAAkB,EAClB,KAAoB,EACO,EAAE;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC;QAE7B,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,0DAA0D;YAC1D,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,kCAAkC;YAClC,wEAAwE;YACxE,MAAM,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACtD,IAAI,aAAa,EAAE,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,YAAY,UAAU,6DAA6D,aAAa,EAAE,CAAC,YAAY,CAAC,UAAU,IAAI,GAAG,CAClI,CAAC;YACJ,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,iBAAuD,CAAC;QAC5D,MAAM,IAAI,GAAG;YACX,CAAC,YAAY,CAAC,EAAE,IAAI;YACpB,CAAC,UAAU,CAAC,EAAE,UAAU;YACxB,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;YACpC,CAAC,WAAW,CAAC,EAAE,GAAG;YAClB,CAAC,aAAa,CAAC,EAAE,KAAK;YACtB,CAAC,kBAAkB,CAAC,EAAE,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,EAAE;gBACnD,iBAAiB,GAAG,OAAO,CAAC;YAC9B,CAAC,CAAC;SAC4B,CAAC;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YACjC,GAAG,OAAO;YACV,iBAAiB;SAClB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC1C,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAsB,CAAC;IACxB,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"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"}

package/lib/runtime/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/runtime/plugin.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGtC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,QAAI;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,EAAE,MAqH7B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/runtime/plugin.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,QAAI;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,EAAE,MAqH7B,CAAC"}

package/lib/runtime/plugin.js

@@ -1,4 +1,5 @@
 import fs from "node:fs/promises";
+import { logger } from "../util/logger.js";
 /**
  * Bundles a single Worker function entrypoint by:
  * 1. Evaluate the script and detect which resources are included in its bundle.
@@ -117,7 +118,7 @@ export const bootstrapPlugin = {
                 return transformed(code);
             }
             catch (error) {
-                console.error(`Error transforming ${args.path}:`, error);
+                logger.error(`Error transforming ${args.path}:`, error);
                 return {
                     errors: [
                         {

package/lib/runtime/plugin.js.map

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

package/lib/scope.d.ts

@@ -2,7 +2,9 @@ import { AsyncLocalStorage } from "node:async_hooks";
 import type { Phase } from "./alchemy.ts";
 import { ResourceID, type PendingResource } from "./resource.ts";
 import type { StateStore, StateStoreType } from "./state.ts";
-export type ScopeOptions = {
+import { type LoggerApi } from "./util/cli.tsx";
+import type { ITelemetryClient } from "./util/telemetry/client.ts";
+export interface ScopeOptions {
     appName?: string;
     stage?: string;
     parent?: Scope;
@@ -11,7 +13,8 @@ export type ScopeOptions = {
     stateStore?: StateStoreType;
     quiet?: boolean;
     phase?: Phase;
-};
+    telemetryClient?: ITelemetryClient;
+}
 export declare class Scope {
     static readonly KIND: "alchemy::Scope";
     static storage: AsyncLocalStorage<Scope>;
@@ -30,8 +33,11 @@ export declare class Scope {
     readonly stateStore: StateStoreType;
     readonly quiet: boolean;
     readonly phase: Phase;
+    readonly logger: LoggerApi;
+    readonly telemetryClient: ITelemetryClient;
     private isErrored;
     private finalized;
+    private startedAt;
     private deferred;
     constructor(options: ScopeOptions);
     get root(): Scope;
@@ -45,6 +51,11 @@ export declare class Scope {
     fqn(resourceID: ResourceID): string;
     run<T>(fn: (scope: Scope) => Promise<T>): Promise<T>;
     [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * The telemetry client for the root scope.
+     * This is used so that app-level hooks are only called once.
+     */
+    private get rootTelemetryClient();
     finalize(): Promise<void>;
     /**
      * Defers execution of a function until the Alchemy application finalizes.

package/lib/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAKF,qBAAa,KAAK;IAChB,gBAAuB,IAAI,EAAG,gBAAgB,CAAU;IAExD,OAAc,OAAO,2BAAkC;IACvD,OAAc,OAAO,EAAE,KAAK,EAAE,CAAM;WAEtB,GAAG,IAAI,KAAK,GAAG,SAAS;IAItC,WAAkB,IAAI,IAAI,KAAK,CAE9B;IAED,WAAkB,OAAO,IAAI,KAAK,CASjC;IAED,SAAgB,SAAS,wCAA0C;IACnE,SAAgB,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAa;IAC7D,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,SAAgB,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1C,SAAgB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,SAAgB,KAAK,EAAE,UAAU,CAAC;IAClC,SAAgB,UAAU,EAAE,cAAc,CAAC;IAC3C,SAAgB,KAAK,EAAE,OAAO,CAAC;IAC/B,SAAgB,KAAK,EAAE,KAAK,CAAC;IAE7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,QAAQ,CAA8B;gBAElC,OAAO,EAAE,YAAY;IA6BjC,IAAW,IAAI,IAAI,KAAK,CAMvB;IAEY,MAAM,CAAC,UAAU,EAAE,UAAU;IAK1C,OAAO,CAAC,IAAI,CAAK;IAEV,GAAG;IAIV,IAAW,KAAK,IAAI,MAAM,EAAE,CAO3B;IAEM,IAAI;IAKE,IAAI;IAIJ,MAAM;IAKZ,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAI7B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjE,CAAC,MAAM,CAAC,YAAY,CAAC;IAIR,QAAQ;IAqCrB;;OAEG;IACI,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBjD;;OAEG;IACI,QAAQ;CAQhB;AAED,OAAO,CAAC,MAAM,CAAC;IAGb,IAAI,iBAAiB,EAAE,OAAO,KAAK,CAAC;CACrC"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"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"}

package/lib/scope.js

@@ -2,6 +2,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
 import { destroyAll } from "./destroy.js";
 import { FileSystemStateStore } from "./fs/file-system-state-store.js";
 import { ResourceID } from "./resource.js";
+import { createDummyLogger, createLoggerInstance, } from "./util/cli.js";
 // TODO: support browser
 const DEFAULT_STAGE = process.env.ALCHEMY_STAGE ?? process.env.USER ?? "dev";
 export class Scope {
@@ -9,19 +10,22 @@ export class Scope {
     static storage = new AsyncLocalStorage();
     static globals = [];
     static get() {
-        return Scope.storage.getStore();
+        const scope = Scope.storage.getStore();
+        if (!scope) {
+            if (Scope.globals.length > 0) {
+                return Scope.globals[Scope.globals.length - 1];
+            }
+            return undefined;
+        }
+        return scope;
     }
     static get root() {
         return Scope.current.root;
     }
     static get current() {
         const scope = Scope.get();
-        if (!scope) {
-            if (Scope.globals.length > 0) {
-                return Scope.globals[Scope.globals.length - 1];
-            }
+        if (!scope)
             throw new Error("Not running within an Alchemy Scope");
-        }
         return scope;
     }
     resources = new Map();
@@ -35,8 +39,11 @@ export class Scope {
     stateStore;
     quiet;
     phase;
+    logger;
+    telemetryClient;
     isErrored = false;
     finalized = false;
+    startedAt = performance.now();
     deferred = [];
     constructor(options) {
         this.appName = options.appName;
@@ -57,11 +64,23 @@ export class Scope {
             throw new Error("Phase is required");
         }
         this.phase = phase;
+        this.logger = this.quiet
+            ? createDummyLogger()
+            : createLoggerInstance({
+                phase: this.phase,
+                stage: this.stage,
+                appName: this.appName ?? "",
+            });
         this.stateStore =
             options.stateStore ??
                 this.parent?.stateStore ??
                 ((scope) => new FileSystemStateStore(scope));
         this.state = this.stateStore(this);
+        if (!options.telemetryClient && !this.parent?.telemetryClient) {
+            throw new Error("Telemetry client is required");
+        }
+        this.telemetryClient =
+            options.telemetryClient ?? this.parent?.telemetryClient;
     }
     get root() {
         let root = this;
@@ -87,11 +106,11 @@ export class Scope {
         return [...app, this.stage, ...thisScope];
     }
     fail() {
-        console.error("Scope failed", this.chain.join("/"));
+        this.logger.error("Scope failed", this.chain.join("/"));
         this.isErrored = true;
     }
     async init() {
-        await this.state.init?.();
+        await Promise.all([this.state.init?.(), this.telemetryClient.ready]);
     }
     async deinit() {
         await this.parent?.state.delete(this.scopeName);
@@ -106,8 +125,22 @@ export class Scope {
     [Symbol.asyncDispose]() {
         return this.finalize();
     }
+    /**
+     * The telemetry client for the root scope.
+     * This is used so that app-level hooks are only called once.
+     */
+    get rootTelemetryClient() {
+        if (!this.parent) {
+            return this.telemetryClient;
+        }
+        return null;
+    }
     async finalize() {
         if (this.phase === "read") {
+            this.rootTelemetryClient?.record({
+                event: "app.success",
+                elapsed: performance.now() - this.startedAt,
+            });
             return;
         }
         if (this.finalized) {
@@ -116,7 +149,7 @@ export class Scope {
         if (this.parent === undefined && Scope.globals.length > 0) {
             const last = Scope.globals.pop();
             if (last !== this) {
-                throw new Error("Running in AsyncLocaStorage.enterWith emultation mode and attempted to finalize a global Scope that wasn't top of the stack");
+                throw new Error("Running in AsyncLocaStorage.enterWith emulation mode and attempted to finalize a global Scope that wasn't top of the stack");
             }
         }
         this.finalized = true;
@@ -132,10 +165,20 @@ export class Scope {
                 quiet: this.quiet,
                 strategy: "sequential",
             });
+            this.rootTelemetryClient?.record({
+                event: "app.success",
+                elapsed: performance.now() - this.startedAt,
+            });
         }
         else {
-            console.warn("Scope is in error, skipping finalize");
+            this.logger.warn("Scope is in error, skipping finalize");
+            this.rootTelemetryClient?.record({
+                event: "app.error",
+                error: new Error("Scope failed"),
+                elapsed: performance.now() - this.startedAt,
+            });
         }
+        await this.rootTelemetryClient?.finalize();
     }
     /**
      * Defers execution of a function until the Alchemy application finalizes.