alchemy 0.16.4 → 0.16.6

package/lib/sentry/team.js

@@ -0,0 +1,109 @@
+import { Resource } from "../resource.js";
+import { SentryApi } from "./api.js";
+/**
+ * Create and manage Sentry teams
+ *
+ * @example
+ * // Create a basic Sentry team:
+ * const team = await Team("my-team", {
+ *   name: "My Team",
+ *   organization: "my-org"
+ * });
+ *
+ * @example
+ * // Create a team with a custom slug:
+ * const team = await Team("custom-team", {
+ *   name: "Custom Team",
+ *   organization: "my-org",
+ *   slug: "custom-team-slug"
+ * });
+ *
+ * @example
+ * // Create or adopt an existing team with the same slug:
+ * const team = await Team("existing-team", {
+ *   name: "Existing Team",
+ *   organization: "my-org",
+ *   adopt: true
+ * });
+ */
+export const Team = Resource("sentry::Team", async function (id, props) {
+    const api = new SentryApi({ authToken: props.authToken });
+    if (this.phase === "delete") {
+        try {
+            if (this.output?.id) {
+                const response = await api.delete(`/teams/${props.organization}/${this.output.slug || this.output.id}/`);
+                if (!response.ok && response.status !== 404) {
+                    console.error("Error deleting team:", response.statusText);
+                }
+            }
+        }
+        catch (error) {
+            console.error("Error deleting team:", error);
+        }
+        return this.destroy();
+    }
+    else {
+        try {
+            let response;
+            if (this.phase === "update" && this.output?.id) {
+                response = await api.put(`/teams/${props.organization}/${this.output.slug || this.output.id}/`, props);
+            }
+            else {
+                try {
+                    response = await api.post(`/organizations/${props.organization}/teams/`, props);
+                }
+                catch (error) {
+                    // Check if this is a "team already exists" error and adopt is enabled
+                    if (props.adopt &&
+                        error instanceof Error &&
+                        error.message.includes("already exists")) {
+                        console.log(`Team '${props.slug || props.name}' already exists, adopting it`);
+                        // Find the existing team by slug
+                        const existingTeam = await findTeamBySlug(api, props.organization, props.slug || props.name);
+                        if (!existingTeam) {
+                            throw new Error(`Failed to find existing team '${props.slug || props.name}' for adoption`);
+                        }
+                        response = await api.get(`/organizations/${props.organization}/teams/${existingTeam.slug}/`);
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+            }
+            if (!response.ok) {
+                throw new Error(`API error: ${response.statusText}`);
+            }
+            const data = (await response.json());
+            return this({
+                ...props,
+                id: data.id,
+                dateCreated: data.dateCreated,
+                isMember: data.isMember,
+                teamRole: data.teamRole,
+                flags: data.flags,
+                access: data.access,
+                hasAccess: data.hasAccess,
+                isPending: data.isPending,
+                memberCount: data.memberCount,
+                avatar: data.avatar,
+            });
+        }
+        catch (error) {
+            console.error("Error creating/updating team:", error);
+            throw error;
+        }
+    }
+});
+/**
+ * Find a team by slug
+ */
+async function findTeamBySlug(api, organization, slug) {
+    const response = await api.get(`/teams/${organization}/${slug}/`);
+    if (!response.ok) {
+        throw new Error(`API error: ${response.statusText}`);
+    }
+    const teams = (await response.json());
+    const team = teams.find((t) => t.slug === slug);
+    return team ? { id: team.id, slug: team.slug } : null;
+}
+//# sourceMappingURL=team.js.map

package/lib/sentry/team.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.16.4",
+  "version": "0.16.6",
   "type": "module",
   "module": "./lib/index.js",
   "scripts": {
@@ -23,6 +23,7 @@
     "./github": "./lib/github/index.js",
     "./neon": "./lib/neon/index.js",
     "./os": "./lib/os/index.js",
+    "./sentry": "./lib/sentry/index.js",
     "./shadcn": "./lib/shadcn/index.js",
     "./stripe": "./lib/stripe/index.js",
     "./test/bun": "./lib/test/bun.js",

package/src/cloudflare/bindings.ts

@@ -41,6 +41,10 @@ export type Binding =
   | DurableObjectNamespace
   | Hyperdrive
   | KVNamespace
+  | {
+      type: "kv_namespace";
+      id: string;
+    }
   | Pipeline
   | Queue
   | R2Bucket

package/src/cloudflare/bound.ts

@@ -9,7 +9,6 @@ import type { R2Bucket as _R2Bucket } from "./bucket.js";
 import type { D1Database as _D1Database } from "./d1-database.js";
 import type { DurableObjectNamespace as _DurableObjectNamespace } from "./durable-object-namespace.js";
 import type { Hyperdrive as _Hyperdrive } from "./hyperdrive.js";
-import type { KVNamespace as _KVNamespace } from "./kv-namespace.js";
 import type { Pipeline as _Pipeline } from "./pipeline.js";
 import type { Queue as _Queue } from "./queue.js";
 import type { VectorizeIndex as _VectorizeIndex } from "./vectorize-index.js";
@@ -18,7 +17,7 @@ import type { Workflow as _Workflow } from "./workflow.js";
 
 export type Bound<T extends Binding> = T extends _DurableObjectNamespace
   ? DurableObjectNamespace
-  : T extends _KVNamespace
+  : T extends { type: "kv_namespace" }
     ? KVNamespace
     : T extends _Worker
       ? Worker

package/src/cloudflare/kv-namespace.ts

@@ -218,7 +218,7 @@ export const KVNamespace = Resource(
 
     return this({
       type: "kv_namespace",
-      namespaceId: namespaceId,
+      namespaceId,
       title: props.title,
       values: props.values,
       createdAt: createdAt,

package/src/cloudflare/worker.ts

@@ -808,7 +808,8 @@ async function prepareWorkerMetadata<B extends Bindings>(
       meta.bindings.push({
         type: "kv_namespace",
         name: bindingName,
-        namespace_id: binding.namespaceId,
+        namespace_id:
+          "namespaceId" in binding ? binding.namespaceId : binding.id,
       });
     } else if (binding.type === "service") {
       meta.bindings.push({

package/src/cloudflare/wrangler.json.ts

@@ -381,7 +381,7 @@ function processBindings(
       // KV Namespace binding
       kvNamespaces.push({
         binding: bindingName,
-        id: binding.namespaceId,
+        id: "namespaceId" in binding ? binding.namespaceId : binding.id,
       });
     } else if (
       typeof binding === "object" &&

package/src/sentry/api.ts

@@ -0,0 +1,106 @@
+import { alchemy } from "../alchemy.js";
+import type { Secret } from "../secret.js";
+
+/**
+ * Options for Sentry API requests
+ */
+export interface SentryApiOptions {
+  /**
+   * Auth token to use (overrides environment variable)
+   */
+  authToken?: Secret;
+}
+
+/**
+ * Minimal API client using raw fetch
+ */
+export class SentryApi {
+  /** Base URL for API */
+  readonly baseUrl: string;
+
+  /** Auth token */
+  readonly authToken: Secret;
+
+  /**
+   * Create a new API client
+   *
+   * @param options API options
+   */
+  constructor(options: SentryApiOptions = {}) {
+    this.baseUrl = "https://sentry.io/api/0";
+    this.authToken =
+      options.authToken ?? alchemy.secret(process.env.SENTRY_AUTH_TOKEN || "");
+
+    if (!this.authToken.unencrypted) {
+      throw new Error("SENTRY_AUTH_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
+   */
+  async fetch(path: string, init: RequestInit = {}): Promise<Response> {
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${this.authToken.unencrypted}`,
+    };
+
+    if (init.headers) {
+      const initHeaders = init.headers as Record<string, string>;
+      Object.keys(initHeaders).forEach((key) => {
+        headers[key] = initHeaders[key];
+      });
+    }
+
+    if (init.body instanceof FormData) {
+      delete headers["Content-Type"];
+    }
+
+    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> {
+    const requestBody = body instanceof FormData ? body : JSON.stringify(body);
+    return this.fetch(path, { ...init, method: "POST", body: requestBody });
+  }
+
+  /**
+   * Helper for PUT requests
+   */
+  async put(
+    path: string,
+    body: any,
+    init: RequestInit = {},
+  ): Promise<Response> {
+    const requestBody = body instanceof FormData ? body : JSON.stringify(body);
+    return this.fetch(path, { ...init, method: "PUT", body: requestBody });
+  }
+
+  /**
+   * Helper for DELETE requests
+   */
+  async delete(path: string, init: RequestInit = {}): Promise<Response> {
+    return this.fetch(path, { ...init, method: "DELETE" });
+  }
+}

package/src/sentry/client-key.ts

@@ -0,0 +1,295 @@
+import type { Context } from "../context.js";
+import { Resource } from "../resource.js";
+import type { Secret } from "../secret.js";
+import { SentryApi } from "./api.js";
+
+/**
+ * Properties for creating or updating a ClientKey
+ */
+export interface ClientKeyProps {
+  /**
+   * The name of the key
+   */
+  name?: string;
+
+  /**
+   * Rate limit configuration
+   */
+  rateLimit?: {
+    /**
+     * Time window in seconds
+     */
+    window: number;
+
+    /**
+     * Maximum number of events allowed in the window
+     */
+    count: number;
+  };
+
+  /**
+   * The use case for the key
+   */
+  useCase?: "user" | "profiling" | "escalating_issues" | "tempest" | "demo";
+
+  /**
+   * The project slug that owns the key
+   */
+  project: string;
+
+  /**
+   * The organization ID or slug that owns the key
+   */
+  organization: string;
+
+  /**
+   * Auth token to use (overrides environment variable)
+   */
+  authToken?: Secret;
+
+  /**
+   * Whether to adopt an existing key with the same name if it exists
+   * If true and a key with the same name exists, it will be adopted rather than creating a new one
+   *
+   * @default false
+   */
+  adopt?: boolean;
+}
+
+/**
+ * Output returned after ClientKey creation/update
+ */
+export interface ClientKey
+  extends Resource<"sentry::ClientKey">,
+    ClientKeyProps {
+  /**
+   * The ID of the key
+   */
+  id: string;
+
+  /**
+   * The label of the key
+   */
+  label: string;
+
+  /**
+   * The public key
+   */
+  public: string;
+
+  /**
+   * The secret key
+   */
+  secret: string;
+
+  /**
+   * The project ID
+   */
+  projectId: number;
+
+  /**
+   * Whether the key is active
+   */
+  isActive: boolean;
+
+  /**
+   * DSN configuration
+   */
+  dsn: {
+    secret: string;
+    public: string;
+    csp: string;
+    security: string;
+    minidump: string;
+    nel: string;
+    unreal: string;
+    cdn: string;
+    crons: string;
+  };
+
+  /**
+   * Browser SDK version
+   */
+  browserSdkVersion: string;
+
+  /**
+   * Browser SDK choices
+   */
+  browserSdk: {
+    choices: Array<[string, string]>;
+  };
+
+  /**
+   * Time at which the key was created
+   */
+  dateCreated: string;
+
+  /**
+   * Dynamic SDK loader options
+   */
+  dynamicSdkLoaderOptions: {
+    hasReplay: boolean;
+    hasPerformance: boolean;
+    hasDebug: boolean;
+  };
+}
+
+/**
+ * Create and manage Sentry client keys
+ *
+ * @example
+ * // Create a basic Sentry client key:
+ * const key = await ClientKey("my-key", {
+ *   name: "My Key",
+ *   project: "my-project",
+ *   organization: "my-org"
+ * });
+ *
+ * @example
+ * // Create a client key with rate limiting:
+ * const key = await ClientKey("rate-limited-key", {
+ *   name: "Rate Limited Key",
+ *   project: "my-project",
+ *   organization: "my-org",
+ *   rateLimit: {
+ *     window: 3600, // 1 hour
+ *     count: 1000   // 1000 events per hour
+ *   }
+ * });
+ *
+ * @example
+ * // Create a client key for a specific use case:
+ * const key = await ClientKey("profiling-key", {
+ *   name: "Profiling Key",
+ *   project: "my-project",
+ *   organization: "my-org",
+ *   useCase: "profiling"
+ * });
+ *
+ * @example
+ * // Create or adopt an existing key with the same name:
+ * const key = await ClientKey("existing-key", {
+ *   name: "Existing Key",
+ *   project: "my-project",
+ *   organization: "my-org",
+ *   adopt: true
+ * });
+ */
+export const ClientKey = Resource(
+  "sentry::ClientKey",
+  async function (
+    this: Context<ClientKey>,
+    id: string,
+    props: ClientKeyProps,
+  ): Promise<ClientKey> {
+    const api = new SentryApi({ authToken: props.authToken });
+
+    if (this.phase === "delete") {
+      try {
+        if (this.output?.id) {
+          const response = await api.delete(
+            `/projects/${props.organization}/${props.project}/keys/${this.output.id}/`,
+          );
+          if (!response.ok && response.status !== 404) {
+            console.error("Error deleting client key:", response.statusText);
+          }
+        }
+      } catch (error) {
+        console.error("Error deleting client key:", error);
+      }
+      return this.destroy();
+    } else {
+      try {
+        let response;
+
+        if (this.phase === "update" && this.output?.id) {
+          response = await api.put(
+            `/projects/${props.organization}/${props.project}/keys/${this.output.id}/`,
+            props,
+          );
+        } else {
+          try {
+            response = await api.post(
+              `/projects/${props.organization}/${props.project}/keys/`,
+              props,
+            );
+          } catch (error) {
+            // Check if this is a "key already exists" error and adopt is enabled
+            if (
+              props.adopt &&
+              error instanceof Error &&
+              error.message.includes("already exists") &&
+              props.name
+            ) {
+              console.log(
+                `Client key '${props.name}' already exists, adopting it`,
+              );
+              // Find the existing key by name
+              const existingKey = await findClientKeyByName(
+                api,
+                props.organization,
+                props.project,
+                props.name,
+              );
+              if (!existingKey) {
+                throw new Error(
+                  `Failed to find existing client key '${props.name}' for adoption`,
+                );
+              }
+              response = await api.get(
+                `/projects/${props.organization}/${props.project}/keys/${existingKey.id}/`,
+              );
+            } else {
+              throw error;
+            }
+          }
+        }
+
+        if (!response.ok) {
+          throw new Error(`API error: ${response.statusText}`);
+        }
+
+        const data = (await response.json()) as Omit<
+          ClientKey,
+          keyof ClientKeyProps
+        >;
+        return this({
+          ...props,
+          id: data.id,
+          label: data.label,
+          public: data.public,
+          secret: data.secret,
+          projectId: data.projectId,
+          isActive: data.isActive,
+          dsn: data.dsn,
+          browserSdkVersion: data.browserSdkVersion,
+          browserSdk: data.browserSdk,
+          dateCreated: data.dateCreated,
+          dynamicSdkLoaderOptions: data.dynamicSdkLoaderOptions,
+        });
+      } catch (error) {
+        console.error("Error creating/updating client key:", error);
+        throw error;
+      }
+    }
+  },
+);
+
+/**
+ * Find a client key by name
+ */
+async function findClientKeyByName(
+  api: SentryApi,
+  organization: string,
+  project: string,
+  name: string,
+): Promise<{ id: string } | null> {
+  const response = await api.get(`/projects/${organization}/${project}/keys/`);
+  if (!response.ok) {
+    throw new Error(`API error: ${response.statusText}`);
+  }
+
+  const keys = (await response.json()) as Array<{ id: string; name: string }>;
+  const key = keys.find((k) => k.name === name);
+  return key ? { id: key.id } : null;
+}

package/src/sentry/index.ts

@@ -0,0 +1,4 @@
+export * from "./api.js";
+export * from "./client-key.js";
+export * from "./project.js";
+export * from "./team.js";