alchemy 0.12.20 → 0.13.0

package/src/github/secret.ts

@@ -135,7 +135,7 @@ export const GitHubSecret = Resource(
   async function (
     this: Context<GitHubSecretOutput>,
     id: string,
-    props: GitHubSecretProps
+    props: GitHubSecretProps,
   ): Promise<GitHubSecretOutput> {
     // Create authenticated Octokit client - will automatically handle token resolution
     /// TODO: use fetch
@@ -181,133 +181,128 @@ export const GitHubSecret = Resource(
 
       // Return void (a deleted resource has no content)
       return this.destroy();
-    } else {
-      try {
-        // Check if we're transitioning between secret types (repo <-> environment)
-        if (this.phase === "update") {
-          const wasEnvironmentSecret = !!this.output.environment;
-          const secretTypeChanged =
-            isEnvironmentSecret !== wasEnvironmentSecret;
+    }
+    try {
+      // Check if we're transitioning between secret types (repo <-> environment)
+      if (this.phase === "update") {
+        const wasEnvironmentSecret = !!this.output.environment;
+        const secretTypeChanged = isEnvironmentSecret !== wasEnvironmentSecret;
 
-          // If secret type changed, we need to delete the old one first
-          if (secretTypeChanged) {
-            console.log(
-              `Secret type changed from ${wasEnvironmentSecret ? "environment" : "repository"} to ${isEnvironmentSecret ? "environment" : "repository"} secret. Deleting the old secret first.`
-            );
+        // If secret type changed, we need to delete the old one first
+        if (secretTypeChanged) {
+          console.log(
+            `Secret type changed from ${wasEnvironmentSecret ? "environment" : "repository"} to ${isEnvironmentSecret ? "environment" : "repository"} secret. Deleting the old secret first.`,
+          );
 
-            try {
-              if (wasEnvironmentSecret) {
-                // Delete the old environment secret
-                await octokit.rest.actions.deleteEnvironmentSecret({
-                  owner: this.output.owner,
-                  repo: this.output.repository,
-                  environment_name: this.output.environment!,
-                  secret_name: this.output.name,
-                });
-              } else {
-                // Delete the old repository secret
-                await octokit.rest.actions.deleteRepoSecret({
-                  owner: this.output.owner,
-                  repo: this.output.repository,
-                  secret_name: this.output.name,
-                });
-              }
-            } 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(
-                  "Old secret not found, continuing with creation of new secret"
-                );
-              } else {
-                throw error;
-              }
+          try {
+            if (wasEnvironmentSecret) {
+              // Delete the old environment secret
+              await octokit.rest.actions.deleteEnvironmentSecret({
+                owner: this.output.owner,
+                repo: this.output.repository,
+                environment_name: this.output.environment!,
+                secret_name: this.output.name,
+              });
+            } else {
+              // Delete the old repository secret
+              await octokit.rest.actions.deleteRepoSecret({
+                owner: this.output.owner,
+                repo: this.output.repository,
+                secret_name: this.output.name,
+              });
+            }
+          } 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(
+                "Old secret not found, continuing with creation of new secret",
+              );
+            } else {
+              throw error;
             }
           }
         }
+      }
 
-        let publicKey;
-
-        // Get the appropriate public key for encrypting secrets
-        if (isEnvironmentSecret) {
-          // Get the environment's public key
-          const { data } = await octokit.rest.actions.getEnvironmentPublicKey({
-            owner: props.owner,
-            repo: props.repository,
-            environment_name: props.environment!,
-          });
-          publicKey = data;
-        } else {
-          // Get the repository's public key
-          const { data } = await octokit.rest.actions.getRepoPublicKey({
-            owner: props.owner,
-            repo: props.repository,
-          });
-          publicKey = data;
-        }
+      let publicKey;
 
-        // Encrypt the secret value using libsodium
-        const encryptedValue = await encryptString(
-          props.value.unencrypted,
-          publicKey.key
-        );
+      // Get the appropriate public key for encrypting secrets
+      if (isEnvironmentSecret) {
+        // Get the environment's public key
+        const { data } = await octokit.rest.actions.getEnvironmentPublicKey({
+          owner: props.owner,
+          repo: props.repository,
+          environment_name: props.environment!,
+        });
+        publicKey = data;
+      } else {
+        // Get the repository's public key
+        const { data } = await octokit.rest.actions.getRepoPublicKey({
+          owner: props.owner,
+          repo: props.repository,
+        });
+        publicKey = data;
+      }
 
-        // Create or update the secret with the encrypted value and key_id
-        if (isEnvironmentSecret) {
-          await octokit.rest.actions.createOrUpdateEnvironmentSecret({
-            owner: props.owner,
-            repo: props.repository,
-            environment_name: props.environment!,
-            secret_name: props.name,
-            encrypted_value: encryptedValue,
-            key_id: publicKey.key_id,
-          });
-        } else {
-          await octokit.rest.actions.createOrUpdateRepoSecret({
-            owner: props.owner,
-            repo: props.repository,
-            secret_name: props.name,
-            encrypted_value: encryptedValue,
-            key_id: publicKey.key_id,
-          });
-        }
+      // Encrypt the secret value using libsodium
+      const encryptedValue = await encryptString(
+        props.value.unencrypted,
+        publicKey.key,
+      );
 
-        // GitHub doesn't return the secret details on create/update, so we need to construct it
-        const idParts = [props.owner, props.repository];
-        if (isEnvironmentSecret) {
-          idParts.push(props.environment!);
-        }
-        idParts.push(props.name);
-
-        return this({
-          id: idParts.join("/"),
+      // Create or update the secret with the encrypted value and key_id
+      if (isEnvironmentSecret) {
+        await octokit.rest.actions.createOrUpdateEnvironmentSecret({
           owner: props.owner,
-          repository: props.repository,
-          name: props.name,
-          environment: props.environment,
-          token: props.token,
-          updatedAt: new Date().toISOString(),
+          repo: props.repository,
+          environment_name: props.environment!,
+          secret_name: props.name,
+          encrypted_value: encryptedValue,
+          key_id: publicKey.key_id,
         });
-      } catch (error: any) {
-        if (
-          error.status === 403 &&
-          error.message?.includes("Must have admin rights")
-        ) {
-          console.error(
-            "\n⚠️ Error creating/updating GitHub secret: You must have admin rights to the repository."
-          );
-          console.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
-          );
-        }
-        throw error;
+      } else {
+        await octokit.rest.actions.createOrUpdateRepoSecret({
+          owner: props.owner,
+          repo: props.repository,
+          secret_name: props.name,
+          encrypted_value: encryptedValue,
+          key_id: publicKey.key_id,
+        });
+      }
+
+      // GitHub doesn't return the secret details on create/update, so we need to construct it
+      const idParts = [props.owner, props.repository];
+      if (isEnvironmentSecret) {
+        idParts.push(props.environment!);
+      }
+      idParts.push(props.name);
+
+      return this({
+        id: idParts.join("/"),
+        owner: props.owner,
+        repository: props.repository,
+        name: props.name,
+        environment: props.environment,
+        token: props.token,
+        updatedAt: new Date().toISOString(),
+      });
+    } catch (error: any) {
+      if (
+        error.status === 403 &&
+        error.message?.includes("Must have admin rights")
+      ) {
+        console.error(
+          "\n⚠️ Error creating/updating GitHub secret: You must have admin rights to the repository.",
+        );
+        console.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);
       }
+      throw error;
     }
-  }
+  },
 );
 
 /**
@@ -320,7 +315,7 @@ export const GitHubSecret = Resource(
  */
 async function encryptString(
   value: string,
-  publicKey: string
+  publicKey: string,
 ): Promise<string> {
   // Initialize libsodium
   await sodium.ready;

package/src/internal/docs/providers.ts

@@ -60,7 +60,7 @@ export async function Providers({
   ];
 
   // Get all folders in the alchemy/src directory
-  let providers = (
+  const providers = (
     await fs.readdir(srcDir, {
       withFileTypes: true,
     })
@@ -71,18 +71,17 @@ export async function Providers({
   if (parallel) {
     return await Promise.all(
       providers.map((provider) =>
-        generateProviderDocs({ provider, outDir, parallel })
-      )
+        generateProviderDocs({ provider, outDir, parallel }),
+      ),
+    );
+  }
+  const generatedProviders = [];
+  for (const provider of providers) {
+    generatedProviders.push(
+      await generateProviderDocs({ provider, outDir, parallel }),
     );
-  } else {
-    const generatedProviders = [];
-    for (const provider of providers) {
-      generatedProviders.push(
-        await generateProviderDocs({ provider, outDir, parallel })
-      );
-    }
-    return generatedProviders;
   }
+  return generatedProviders;
 }
 
 async function generateProviderDocs({
@@ -102,7 +101,7 @@ async function generateProviderDocs({
   )
     .filter((dirent) => dirent.isFile())
     .map((dirent) =>
-      path.relative(process.cwd(), path.resolve(provider, dirent.name))
+      path.relative(process.cwd(), path.resolve(provider, dirent.name)),
     )
     .filter((file) => file.endsWith(".ts") && !file.endsWith("index.ts"));
 
@@ -123,13 +122,13 @@ async function generateProviderDocs({
     schema: type({
       groups: type({
         identifier: type("string").describe(
-          "The identifier of the file's primary exported Resource/Function/Type, e.g. Bucket or StaticSite, AstroFile, TypeScriptFile"
+          "The identifier of the file's primary exported Resource/Function/Type, e.g. Bucket or StaticSite, AstroFile, TypeScriptFile",
         ),
         filename: type("string").describe(
-          "The filename of the Resource's Document, e.g. bucket.md or static-site.md"
+          "The filename of the Resource's Document, e.g. bucket.md or static-site.md",
         ),
         category: type("'Resource'|'Client'|'Utility'|'Types'").describe(
-          "The classification of the Resource's Document, one of: Resource, Client, Utility, or Types."
+          "The classification of the Resource's Document, one of: Resource, Client, Utility, or Types.",
         ),
       }).array(),
     }),
@@ -163,7 +162,7 @@ async function generateProviderDocs({
   let documents: Document[] = [];
   if (parallel) {
     documents = await Promise.all(
-      groups.filter((g) => g.category === "Resource").map(generateDocument)
+      groups.filter((g) => g.category === "Resource").map(generateDocument),
     );
   } else {
     for (const g of groups.filter((g) => g.category === "Resource")) {
@@ -176,7 +175,7 @@ async function generateProviderDocs({
       title: g.identifier,
       path: path.join(
         providerDocsDir,
-        `${g.filename.replace(".ts", "").replace(".md", "")}.md`
+        `${g.filename.replace(".ts", "").replace(".md", "")}.md`,
       ),
       freeze: false,
       model: {

package/src/neon/api-error.ts

@@ -46,7 +46,7 @@ export async function handleApiError(
   response: Response,
   action: "get" | "create" | "update" | "delete" | "list",
   resourceType: string,
-  resourceId?: string
+  resourceId?: string,
 ): Promise<never> {
   const resourceDisplay = resourceId ? `'${resourceId}'` : "";
   let errorData: any;

package/src/neon/api.ts

@@ -35,13 +35,13 @@ export function createNeonApi(options: Partial<NeonApiOptions> = {}): NeonApi {
  * @returns Headers for authentication
  */
 export async function getNeonAuthHeaders(
-  options: Partial<NeonApiOptions>
+  options: Partial<NeonApiOptions>,
 ): Promise<Record<string, string>> {
   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."
+      "Neon API key is required. Set NEON_API_KEY environment variable or provide apiKey option.",
     );
   }
 
@@ -114,7 +114,7 @@ export class NeonApi {
         return isNetworkError || error?.status?.toString().startsWith("5");
       },
       5, // Maximum 5 attempts (1 initial + 4 retries)
-      1000 // Start with 1s delay, will exponentially increase
+      1000, // Start with 1s delay, will exponentially increase
     );
   }
 
@@ -131,7 +131,7 @@ export class NeonApi {
   async post(
     path: string,
     body: any,
-    init: RequestInit = {}
+    init: RequestInit = {},
   ): Promise<Response> {
     const requestBody =
       body instanceof FormData
@@ -148,7 +148,7 @@ export class NeonApi {
   async put(
     path: string,
     body: any,
-    init: RequestInit = {}
+    init: RequestInit = {},
   ): Promise<Response> {
     const requestBody = body instanceof FormData ? body : JSON.stringify(body);
     return this.fetch(path, { ...init, method: "PUT", body: requestBody });
@@ -160,7 +160,7 @@ export class NeonApi {
   async patch(
     path: string,
     body: any,
-    init: RequestInit = {}
+    init: RequestInit = {},
   ): Promise<Response> {
     return this.fetch(path, {
       ...init,

package/src/neon/project.ts

@@ -510,7 +510,7 @@ export const NeonProject = Resource(
   async function (
     this: Context<NeonProject>,
     id: string,
-    props: NeonProjectProps
+    props: NeonProjectProps,
   ): Promise<NeonProject> {
     const api = createNeonApi(props);
     const projectId = props.existing_project_id || this.output?.id;
@@ -553,7 +553,7 @@ export const NeonProject = Resource(
         response = await getProject(
           api,
           projectId,
-          initialData as Partial<NeonApiResponse>
+          initialData as Partial<NeonApiResponse>,
         );
       } else {
         // Check if a project with this ID already exists
@@ -576,7 +576,7 @@ export const NeonProject = Resource(
             response = await getProject(
               api,
               projectId,
-              initialData as Partial<NeonApiResponse>
+              initialData as Partial<NeonApiResponse>,
             );
           } else if (getResponse.status !== 404) {
             // Unexpected error during GET check
@@ -631,7 +631,7 @@ export const NeonProject = Resource(
       console.error(`Error ${this.phase} Neon project '${id}':`, error);
       throw error;
     }
-  }
+  },
 );
 
 /**
@@ -639,7 +639,7 @@ export const NeonProject = Resource(
  */
 async function createNewProject(
   api: any,
-  props: NeonProjectProps
+  props: NeonProjectProps,
 ): Promise<NeonApiResponse> {
   const defaultEndpoint = props.default_endpoint ?? true;
   const projectResponse = await api.post("/projects", {
@@ -672,13 +672,13 @@ async function createNewProject(
 async function getProject(
   api: any,
   projectId: string,
-  initialData: Partial<NeonApiResponse> = {}
+  initialData: Partial<NeonApiResponse> = {},
 ): Promise<NeonApiResponse> {
   // Get the latest project details
   const updatedData = await getProjectDetails(api, projectId);
 
   // Start with a copy of the initial data
-  let responseData = { ...initialData };
+  const responseData = { ...initialData };
 
   // Check if we have a branch ID from the initial data
   const branchId = initialData.branch?.id;
@@ -736,10 +736,10 @@ async function waitForOperations(
     project_id: string;
     status: string;
     action: string;
-  }>
+  }>,
 ): Promise<void> {
   const pendingOperations = operations.filter(
-    (op) => op.status !== "finished" && op.status !== "failed"
+    (op) => op.status !== "finished" && op.status !== "failed",
   );
 
   if (pendingOperations.length === 0) {
@@ -774,7 +774,7 @@ async function waitForOperations(
 
       // Check operation status
       const operationResponse = await api.get(
-        `/projects/${operation.project_id}/operations/${operation.id}`
+        `/projects/${operation.project_id}/operations/${operation.id}`,
       );
 
       if (operationResponse.ok) {
@@ -782,16 +782,17 @@ async function waitForOperations(
         operationStatus = operationData.operation?.status;
       } else {
         throw new Error(
-          `Failed to check operation ${operation.id} status: HTTP ${operationResponse.status}`
+          `Failed to check operation ${operation.id} status: HTTP ${operationResponse.status}`,
         );
       }
     }
 
     if (operationStatus === "failed") {
       throw new Error(`Operation ${operation.id} (${operation.action}) failed`);
-    } else if (totalWaitTime >= maxWaitTime) {
+    }
+    if (totalWaitTime >= maxWaitTime) {
       throw new Error(
-        `Timeout waiting for operation ${operation.id} (${operation.action}) to complete`
+        `Timeout waiting for operation ${operation.id} (${operation.action}) to complete`,
       );
     }
   }
@@ -810,7 +811,7 @@ async function waitForOperations(
  */
 async function getProjectDetails(
   api: any,
-  projectId: string
+  projectId: string,
 ): Promise<NeonApiResponse> {
   const response = await api.get(`/projects/${projectId}`);
 
@@ -833,7 +834,7 @@ async function getProjectDetails(
 async function getBranchDetails(
   api: any,
   projectId: string,
-  branchId: string
+  branchId: string,
 ): Promise<{ branch: NeonBranch }> {
   const response = await api.get(`/projects/${projectId}/branches/${branchId}`);
 
@@ -856,10 +857,10 @@ async function getBranchDetails(
 async function getEndpointDetails(
   api: any,
   projectId: string,
-  branchId: string
+  branchId: string,
 ): Promise<{ endpoints: NeonEndpoint[] }> {
   const response = await api.get(
-    `/projects/${projectId}/branches/${branchId}/endpoints`
+    `/projects/${projectId}/branches/${branchId}/endpoints`,
   );
 
   if (!response.ok) {