alchemy 0.24.0 → 0.25.0

package/src/stripe/file.ts

@@ -0,0 +1,219 @@
+import type Stripe from "stripe";
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import type { Secret } from "../secret.ts";
+import { createStripeClient, isStripeConflictError } from "./client.ts";
+
+/**
+ * Properties for creating a Stripe file
+ */
+export interface FileProps {
+  /**
+   * A file to upload. The file should follow the specifications of RFC 2388
+   */
+  file: any;
+  /**
+   * The purpose of the uploaded file
+   */
+  purpose: Stripe.FileCreateParams.Purpose;
+  /**
+   * Optional parameters for the file link data
+   */
+  fileLink?: {
+    /**
+     * Whether to create a file link for the uploaded file
+     */
+    create: boolean;
+    /**
+     * The time at which the file link expires
+     */
+    expiresAt?: number;
+    /**
+     * Set of key-value pairs that you can attach to the file link
+     */
+    metadata?: Record<string, string>;
+  };
+
+  /**
+   * API key to use (overrides environment variable)
+   */
+  apiKey?: Secret;
+
+  /**
+   * If true, adopt existing resource if creation fails due to conflict
+   */
+  adopt?: boolean;
+}
+
+/**
+ * Output from the Stripe file
+ */
+export interface File extends Resource<"stripe::File"> {
+  /**
+   * The ID of the file
+   */
+  id: string;
+  /**
+   * String representing the object's type
+   */
+  object: "file";
+  /**
+   * Time at which the object was created
+   */
+  created: number;
+  /**
+   * The time at which the file expires and is no longer available
+   */
+  expiresAt?: number;
+  /**
+   * A filename for the file, suitable for saving to a filesystem
+   */
+  filename?: string;
+  /**
+   * Any links that have been created for the file
+   */
+  links?: {
+    object: "list";
+    data: Array<{
+      id: string;
+      object: "file_link";
+      created: number;
+      expired: boolean;
+      expiresAt?: number;
+      file: string;
+      livemode: boolean;
+      metadata: Record<string, string>;
+      url?: string;
+    }>;
+    hasMore: boolean;
+    url: string;
+  };
+  /**
+   * The purpose of the uploaded file
+   */
+  purpose: Stripe.File.Purpose;
+  /**
+   * The size in bytes of the file object
+   */
+  size: number;
+  /**
+   * A user friendly title for the document
+   */
+  title?: string;
+  /**
+   * The type of the file returned
+   */
+  type?: string;
+  /**
+   * The URL from which the file can be downloaded
+   */
+  url?: string;
+  /**
+   * Has the value true if the object exists in live mode or the value false if the object exists in test mode
+   */
+  livemode: boolean;
+}
+
+/**
+ * Create and manage Stripe files for uploads
+ *
+ * @example
+ * // Upload a dispute evidence file
+ * const disputeEvidence = await File("dispute-evidence", {
+ *   file: fs.readFileSync("./evidence.pdf"),
+ *   purpose: "dispute_evidence"
+ * });
+ *
+ * @example
+ * // Upload an identity document
+ * const identityDocument = await File("identity-doc", {
+ *   file: fs.readFileSync("./passport.jpg"),
+ *   purpose: "identity_document"
+ * });
+ *
+ * @example
+ * // Upload a business logo with file link
+ * const businessLogo = await File("business-logo", {
+ *   file: fs.readFileSync("./logo.png"),
+ *   purpose: "business_logo",
+ *   fileLink: {
+ *     create: true,
+ *     expiresAt: Math.floor(Date.now() / 1000) + 86400,
+ *     metadata: {
+ *       brand: "company_logo"
+ *     }
+ *   }
+ * });
+ */
+export const File = Resource(
+  "stripe::File",
+  async function (
+    this: Context<File>,
+    _id: string,
+    props: FileProps,
+  ): Promise<File> {
+    const stripe = createStripeClient({ apiKey: props.apiKey });
+
+    if (this.phase === "delete") {
+      return this.destroy();
+    }
+
+    try {
+      let file: Stripe.File;
+
+      if (this.phase === "update" && this.output?.id) {
+        file = await stripe.files.retrieve(this.output.id);
+      } else {
+        try {
+          file = await stripe.files.create({
+            file: props.file,
+            purpose: props.purpose,
+          });
+        } catch (error) {
+          if (isStripeConflictError(error) && props.adopt) {
+            throw new Error(
+              "File adoption is not supported - files are immutable and cannot be adopted",
+            );
+          } else {
+            throw error;
+          }
+        }
+      }
+
+      return this({
+        id: file.id,
+        object: file.object,
+        created: file.created,
+        expiresAt: file.expires_at || undefined,
+        filename: file.filename || undefined,
+        links: file.links
+          ? {
+              object: file.links.object,
+              data: file.links.data.map((link) => ({
+                id: link.id,
+                object: link.object,
+                created: link.created,
+                expired: link.expired,
+                expiresAt: link.expires_at || undefined,
+                file: typeof link.file === "string" ? link.file : link.file.id,
+                livemode: link.livemode,
+                metadata: link.metadata,
+                url: link.url || undefined,
+              })),
+              hasMore: file.links.has_more,
+              url: file.links.url,
+            }
+          : undefined,
+        purpose: file.purpose as Stripe.File.Purpose,
+        size: file.size,
+        title: file.title || undefined,
+        type: file.type || undefined,
+        url: file.url || undefined,
+        livemode: true,
+      });
+    } catch (error) {
+      console.error("Error creating/retrieving file:", error);
+      throw error;
+    }
+  },
+);

package/src/stripe/index.ts

@@ -1,4 +1,15 @@
+export * from "./card.ts";
+export * from "./client.ts";
+export * from "./coupon.ts";
+export * from "./customer.ts";
+export * from "./entitlements-feature.ts";
+export * from "./file.ts";
 export * from "./meter.ts";
+export * from "./portal-configuration.ts";
 export * from "./price.ts";
 export * from "./product.ts";
+export * from "./product-feature.ts";
+export * from "./promotion-code.ts";
+export * from "./shipping-rate.ts";
+export * from "./tax-rate.ts";
 export * from "./webhook.ts";

package/src/stripe/meter.ts

@@ -1,6 +1,8 @@
-import Stripe from "stripe";
+import type Stripe from "stripe";
 import type { Context } from "../context.ts";
 import { Resource } from "../resource.ts";
+import type { Secret } from "../secret.ts";
+import { createStripeClient, isStripeConflictError } from "./client.ts";
 
 /**
  * Properties for creating or updating a Stripe Meter.
@@ -22,6 +24,14 @@ export interface MeterProps {
   valueSettings: {
     eventPayloadKey: string;
   };
+  /**
+   * API key to use (overrides environment variable)
+   */
+  apiKey?: Secret;
+  /**
+   * If true, adopt existing resource if creation fails due to conflict
+   */
+  adopt?: boolean;
 }
 
 /**
@@ -144,11 +154,7 @@ export const Meter = Resource(
     _logicalId: string,
     props: MeterProps,
   ): Promise<Meter> {
-    const apiKey = process.env.STRIPE_API_KEY;
-    if (!apiKey) {
-      throw new Error("STRIPE_API_KEY environment variable is required");
-    }
-    const stripe = new Stripe(apiKey);
+    const stripe = createStripeClient({ apiKey: props.apiKey });
 
     const currentOutputId = this.output?.id;
 
@@ -292,7 +298,17 @@ export const Meter = Resource(
       }
 
       const createParams = mapPropsToStripeParams(props);
-      stripeAPIResponse = await stripe.billing.meters.create(createParams);
+      try {
+        stripeAPIResponse = await stripe.billing.meters.create(createParams);
+      } catch (error) {
+        if (isStripeConflictError(error) && props.adopt) {
+          throw new Error(
+            "Meter adoption is not supported - meters cannot be uniquely identified for adoption",
+          );
+        } else {
+          throw error;
+        }
+      }
 
       // If status 'inactive' is requested during creation, and Stripe created it as 'active'
       if (