alchemy 0.25.0 → 0.26.0

package/src/cloudflare/zone.ts

@@ -1,5 +1,6 @@
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
+import { logger } from "../util/logger.ts";
 import { handleApiError } from "./api-error.ts";
 import { createCloudflareApi, type CloudflareApiOptions } from "./api.ts";
 import type {
@@ -329,7 +330,7 @@ export const Zone = Resource(
           );
         }
       } else {
-        console.warn(`Zone '${props.name}' not found, skipping delete`);
+        logger.warn(`Zone '${props.name}' not found, skipping delete`);
       }
       return this.destroy();
     }
@@ -387,7 +388,7 @@ export const Zone = Resource(
     if (!response.ok) {
       if (response.status === 400 && body.includes("already exists")) {
         // Zone already exists, fetch it instead
-        console.warn(
+        logger.warn(
           `Zone '${props.name}' already exists during Zone create, adopting it...`,
         );
         const getResponse = await api.get(`/zones?name=${props.name}`);
@@ -488,7 +489,7 @@ async function updateZoneSettings(
         if (!response.ok) {
           const data = await response.text();
           if (response.status === 400 && data.includes("already enabled")) {
-            console.warn(`Warning: Setting '${key}' already enabled`);
+            logger.warn(`Warning: Setting '${key}' already enabled`);
             return;
           }
           throw new Error(

package/src/destroy.ts

@@ -10,6 +10,8 @@ import {
   ResourceSeq,
 } from "./resource.ts";
 import { Scope } from "./scope.ts";
+import { formatFQN } from "./util/cli.tsx";
+import { logger } from "./util/logger.ts";
 
 export class DestroyedSignal extends Error {}
 
@@ -37,18 +39,21 @@ export async function destroy<Type extends string>(
       ...(args[1] ?? {}),
     } satisfies DestroyOptions;
 
-    // destroy all active resources
-    await destroyAll(Array.from(scope.resources.values()), options);
-
-    // then detect orphans and destroy them
-    const orphans = await scope.state.all();
-    await destroyAll(
-      Object.values(orphans).map((orphan) => ({
-        ...orphan.output,
-        Scope: scope,
-      })),
-      options,
-    );
+    await scope.run(async () => {
+      // destroy all active resources
+      await destroyAll(Array.from(scope.resources.values()), options);
+
+      // then detect orphans and destroy them
+      const orphans = await scope.state.all();
+      await destroyAll(
+        Object.values(orphans).map((orphan) => ({
+          ...orphan.output,
+          Scope: scope,
+        })),
+        options,
+      );
+    });
+
     // finally, destroy the scope container
     await scope.deinit();
     return;
@@ -65,7 +70,7 @@ export async function destroy<Type extends string>(
       parent: instance[ResourceScope],
       scopeName: instance[ResourceID],
     });
-    console.log("Destroying scope", scope.chain.join("/"));
+    logger.log("Destroying scope", scope.chain.join("/"));
     return await destroy(scope, options);
   }
 
@@ -78,13 +83,19 @@ export async function destroy<Type extends string>(
 
   const scope = instance[ResourceScope];
   if (!scope) {
-    console.warn(`Resource "${instance[ResourceFQN]}" has no scope`);
+    logger.warn(`Resource "${instance[ResourceFQN]}" has no scope`);
   }
   const quiet = options?.quiet ?? scope.quiet;
 
   try {
     if (!quiet) {
-      console.log(`Delete:  "${instance[ResourceFQN]}"`);
+      logger.task(instance[ResourceFQN], {
+        prefix: "DELETING",
+        prefixColor: "magenta",
+        resource: formatFQN(instance[ResourceFQN]),
+        message: "Deleting Resource...",
+      });
+      logger.log(`Delete:  "${instance[ResourceFQN]}"`);
     }
 
     const state = await scope.state.get(instance[ResourceID]);
@@ -140,10 +151,17 @@ export async function destroy<Type extends string>(
     await scope.delete(instance[ResourceID]);
 
     if (!quiet) {
-      console.log(`Deleted: "${instance[ResourceFQN]}"`);
+      logger.task(instance[ResourceFQN], {
+        prefix: "DELETED",
+        prefixColor: "greenBright",
+        resource: formatFQN(instance[ResourceFQN]),
+        message: "Deleted Resource",
+        status: "success",
+      });
+      logger.log(`Deleted: "${instance[ResourceFQN]}"`);
     }
   } catch (error) {
-    console.error(error);
+    logger.error(error);
     throw error;
   }
 }

package/src/dns/godaddy.ts

@@ -1,3 +1,4 @@
+import { logger } from "../util/logger.ts";
 import { safeFetch } from "../util/safe-fetch.ts";
 
 export type UpdateNameserversOptions = {
@@ -23,9 +24,9 @@ export async function updateNameservers(options: UpdateNameserversOptions) {
   });
 
   if (response.ok) {
-    console.log(`✅ Nameservers updated for ${options.domain}`);
+    logger.log(`✅ Nameservers updated for ${options.domain}`);
   } else {
     const error = await response.json();
-    console.error("❌ Failed to update nameservers:", error);
+    logger.error("❌ Failed to update nameservers:", error);
   }
 }

package/src/dns/import-dns.ts

@@ -1,5 +1,6 @@
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
+import { logger } from "../util/logger.ts";
 import { DEFAULT_RECORD_TYPES, type DnsRecordType } from "./record.ts";
 
 /**
@@ -195,7 +196,7 @@ export const ImportDnsRecords = Resource(
           allRecords.push(...compatRecords);
         }
       } catch (error) {
-        console.warn(
+        logger.warn(
           `Failed to fetch ${type} records for ${props.domain}:`,
           error,
         );

package/src/esbuild/bundle.ts

@@ -4,6 +4,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
+import { logger } from "../util/logger.ts";
 
 /**
  * Properties for creating or updating an esbuild bundle
@@ -199,7 +200,7 @@ export async function bundle(props: BundleProps) {
     metafile: true,
   };
   if (process.env.DEBUG) {
-    console.log(options);
+    logger.log(options);
   }
   const esbuild = await import("esbuild");
   return await esbuild.build(options);

package/src/fs/copy-file.ts

@@ -2,6 +2,7 @@ import fs from "node:fs";
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
 import { ignore } from "../util/ignore.ts";
+import { logger } from "../util/logger.ts";
 
 /**
  * Properties for creating a CopyFile resource
@@ -107,7 +108,7 @@ export const CopyFile = Resource(
         createdAt: Date.now(),
       });
     } catch (error) {
-      console.error(`Error copying file from ${src} to ${dest}:`, error);
+      logger.error("Error copying file:", error);
       throw error;
     }
   },

package/src/fs/file.ts

@@ -3,6 +3,7 @@ import path from "node:path";
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
 import { ignore } from "../util/ignore.ts";
+import { logger } from "../util/logger.ts";
 
 import { alchemy } from "../alchemy.ts";
 import type { FileCollection } from "./file-collection.ts";
@@ -176,7 +177,7 @@ export const File = Resource(
       this.output.path !== filePath
     ) {
       // If path has changed, delete the old file
-      console.log(
+      logger.log(
         `File: Path changed from ${this.output.path} to ${filePath}, removing old file`,
       );
       await ignore("ENOENT", async () => fs.promises.unlink(this.output.path));
@@ -186,6 +187,7 @@ export const File = Resource(
     await fs.promises.mkdir(path.dirname(filePath), {
       recursive: true,
     });
+
     await fs.promises.writeFile(filePath, props.content);
 
     return this({

package/src/github/client.ts

@@ -1,6 +1,7 @@
 import { Octokit } from "@octokit/rest";
 import { exec } from "node:child_process";
 import { promisify } from "node:util";
+import { logger } from "../util/logger.ts";
 
 // Convert exec to promise-based
 const execAsync = promisify(exec);
@@ -77,36 +78,36 @@ export async function verifyGitHubAuth(
     });
   } catch (error: any) {
     if (error.status === 401) {
-      console.error(
+      logger.error(
         "\n⚠️ GitHub authentication failed. Please try one of the following:",
       );
-      console.error(
+      logger.error(
         "1. Run 'gh auth login' to authenticate with the GitHub CLI",
       );
-      console.error(
+      logger.error(
         "2. Set the GITHUB_TOKEN environment variable with a personal access token",
       );
-      console.error("3. Pass a token directly to the constructor");
-      console.error(
+      logger.error("3. Pass a token directly to the constructor");
+      logger.error(
         "\nTo create a token, visit: https://github.com/settings/tokens",
       );
-      console.error(
+      logger.error(
         "Required scopes: 'repo' for private repos or 'public_repo' for public repos\n",
       );
       throw new Error("GitHub authentication failed");
     }
     if (error.status === 403) {
-      console.error(
+      logger.error(
         "\n⚠️ Insufficient permissions. You need admin access to the repository.",
       );
-      console.error(
+      logger.error(
         "Make sure your token has the 'repo' scope for private repos or 'public_repo' for public repos\n",
       );
       throw new Error("Insufficient GitHub permissions");
     }
     if (error.status === 404) {
-      console.error(`\n⚠️ Repository not found: ${owner}/${repo}`);
-      console.error(
+      logger.error(`\n⚠️ Repository not found: ${owner}/${repo}`);
+      logger.error(
         "Make sure the repository exists and you have access to it\n",
       );
       throw new Error("GitHub repository not found");

package/src/github/repository-environment.ts

@@ -1,5 +1,6 @@
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
+import { logger } from "../util/logger.ts";
 import { createGitHubClient, verifyGitHubAuth } from "./client.ts";
 
 /**
@@ -198,7 +199,7 @@ export const RepositoryEnvironment = Resource(
         } catch (error: any) {
           // Ignore 404 errors (environment already deleted)
           if (error.status === 404) {
-            console.log("Environment doesn't exist, ignoring");
+            logger.log("Environment doesn't exist, ignoring");
           } else {
             throw error;
           }
@@ -447,14 +448,14 @@ export const RepositoryEnvironment = Resource(
         error.status === 403 &&
         error.message?.includes("Must have admin rights")
       ) {
-        console.error(
+        logger.error(
           "\n⚠️ Error creating/updating GitHub environment: You must have admin rights to the repository.",
         );
-        console.error(
+        logger.error(
           "Make sure your GitHub token has the required permissions (repo scope for private repos).\n",
         );
       } else {
-        console.error(
+        logger.error(
           "Error creating/updating GitHub environment:",
           error.message,
         );

package/src/github/secret.ts

@@ -2,6 +2,7 @@ import sodium from "libsodium-wrappers";
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
 import type { Secret } from "../secret.ts";
+import { logger } from "../util/logger.ts";
 import { createGitHubClient, verifyGitHubAuth } from "./client.ts";
 /**
  * Properties for creating or updating a GitHub Secret
@@ -172,7 +173,7 @@ export const GitHubSecret = Resource(
         } catch (error: any) {
           // Ignore 404 errors (secret already deleted)
           if (error.status === 404) {
-            console.log("Secret doesn't exist, ignoring");
+            logger.log("Secret doesn't exist, ignoring");
           } else {
             throw error;
           }
@@ -190,7 +191,7 @@ export const GitHubSecret = Resource(
 
         // If secret type changed, we need to delete the old one first
         if (secretTypeChanged) {
-          console.log(
+          logger.log(
             `Secret type changed from ${wasEnvironmentSecret ? "environment" : "repository"} to ${isEnvironmentSecret ? "environment" : "repository"} secret. Deleting the old secret first.`,
           );
 
@@ -214,7 +215,7 @@ export const GitHubSecret = Resource(
           } catch (error: any) {
             // Log but don't fail if the old secret doesn't exist or can't be deleted
             if (error.status === 404) {
-              console.log(
+              logger.log(
                 "Old secret not found, continuing with creation of new secret",
               );
             } else {
@@ -293,14 +294,14 @@ export const GitHubSecret = Resource(
         error.status === 403 &&
         error.message?.includes("Must have admin rights")
       ) {
-        console.error(
+        logger.error(
           "\n⚠️ Error creating/updating GitHub secret: You must have admin rights to the repository.",
         );
-        console.error(
+        logger.error(
           "Make sure your GitHub token has the required permissions (repo scope for private repos).\n",
         );
       } else {
-        console.error("Error creating/updating GitHub secret:", error.message);
+        logger.error("Error creating/updating GitHub secret:", error.message);
       }
       throw error;
     }

package/src/index.ts

@@ -1,4 +1,4 @@
-export type { AlchemyOptions } from "./alchemy.ts";
+export type { AlchemyOptions, Phase } from "./alchemy.ts";
 export type * from "./context.ts";
 export * from "./resource.ts";
 export type * from "./scope.ts";
@@ -7,6 +7,7 @@ export * from "./serde.ts";
 export * from "./state.ts";
 export * from "./type.ts";
 export * from "./util/ignore.ts";
+export * from "./util/logger.ts";
 
 import { alchemy } from "./alchemy.ts";
 export default alchemy;

package/src/neon/project.ts

@@ -2,6 +2,7 @@ import { alchemy } from "../alchemy.ts";
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
 import type { Secret } from "../secret.ts";
+import { logger } from "../util/logger.ts";
 import { handleApiError } from "./api-error.ts";
 import { createNeonApi, type NeonApiOptions } from "./api.ts";
 
@@ -525,7 +526,7 @@ export const NeonProject = Resource(
           }
         }
       } catch (error) {
-        console.error(`Error deleting Neon project ${id}:`, error);
+        logger.error(`Error deleting Neon project ${id}:`, error);
         throw error;
       }
       return this.destroy();
@@ -628,7 +629,7 @@ export const NeonProject = Resource(
         endpoints: response.endpoints,
       });
     } catch (error) {
-      console.error(`Error ${this.phase} Neon project '${id}':`, error);
+      logger.error(`Error ${this.phase} Neon project '${id}':`, error);
       throw error;
     }
   },

package/src/planetscale/api.ts

@@ -0,0 +1,115 @@
+/**
+ * Options for PlanetScale API requests
+ */
+export interface PlanetScaleApiOptions {
+  /**
+   * PlanetScale API token (overrides environment variable)
+   */
+  apiKey?: string;
+}
+
+/**
+ * Minimal API client for PlanetScale using raw fetch
+ */
+export class PlanetScaleApi {
+  /** Base URL for API */
+  readonly baseUrl: string;
+
+  /** API token */
+  readonly apiToken: string;
+
+  /**
+   * Create a new API client
+   *
+   * @param options API options
+   */
+  constructor(options: PlanetScaleApiOptions = {}) {
+    this.baseUrl = "https://api.planetscale.com/v1";
+    this.apiToken = options.apiKey || process.env.PLANETSCALE_API_TOKEN || "";
+    if (!this.apiToken) {
+      throw new Error("PLANETSCALE_API_TOKEN environment variable is required");
+    }
+  }
+
+  /**
+   * Make a request to the API
+   *
+   * @param path API path (without base URL)
+   * @param init Fetch init options
+   * @returns Raw Response object from fetch
+   */
+  private async fetch(path: string, init: RequestInit = {}): Promise<Response> {
+    const headers: Record<string, string> = {
+      Authorization: `${this.apiToken}`,
+      "Content-Type": "application/json",
+    };
+
+    if (init.headers) {
+      Object.assign(headers, init.headers);
+    }
+
+    return fetch(`${this.baseUrl}${path}`, {
+      ...init,
+      headers,
+    });
+  }
+
+  /**
+   * Helper for GET requests
+   */
+  async get(path: string, init: RequestInit = {}): Promise<Response> {
+    return this.fetch(path, { ...init, method: "GET" });
+  }
+
+  /**
+   * Helper for POST requests
+   */
+  async post(
+    path: string,
+    body?: any,
+    init: RequestInit = {},
+  ): Promise<Response> {
+    return this.fetch(path, {
+      ...init,
+      method: "POST",
+      body: body ? JSON.stringify(body) : undefined,
+    });
+  }
+
+  /**
+   * Helper for PUT requests
+   */
+  async put(
+    path: string,
+    body?: any,
+    init: RequestInit = {},
+  ): Promise<Response> {
+    return this.fetch(path, {
+      ...init,
+      method: "PUT",
+      body: body ? JSON.stringify(body) : undefined,
+    });
+  }
+
+  /**
+   * Helper for PATCH requests
+   */
+  async patch(
+    path: string,
+    body?: any,
+    init: RequestInit = {},
+  ): Promise<Response> {
+    return this.fetch(path, {
+      ...init,
+      method: "PATCH",
+      body: body ? JSON.stringify(body) : undefined,
+    });
+  }
+
+  /**
+   * Helper for DELETE requests
+   */
+  async delete(path: string, init: RequestInit = {}): Promise<Response> {
+    return this.fetch(path, { ...init, method: "DELETE" });
+  }
+}