alchemy 0.24.0 → 0.24.1

package/lib/stripe/card.js

@@ -0,0 +1,148 @@
+import { Resource } from "../resource.js";
+import { createStripeClient, handleStripeDeleteError, isStripeConflictError, } from "./client.js";
+/**
+ * Create and manage Stripe cards attached to customers
+ *
+ * @example
+ * // Create a card using raw card details
+ * const customerCard = await Card("customer-card", {
+ *   customer: "cus_xyz123",
+ *   number: "4242424242424242",
+ *   expMonth: 12,
+ *   expYear: 2025,
+ *   cvc: "123",
+ *   name: "John Doe",
+ *   addressLine1: "123 Main St",
+ *   addressCity: "San Francisco",
+ *   addressState: "CA",
+ *   addressZip: "94105",
+ *   addressCountry: "US"
+ * });
+ *
+ * @example
+ * // Create a card using a token
+ * const tokenCard = await Card("token-card", {
+ *   customer: "cus_xyz123",
+ *   source: "tok_visa",
+ *   metadata: {
+ *     type: "primary",
+ *     source: "mobile_app"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a card for international customer
+ * const internationalCard = await Card("international-card", {
+ *   customer: "cus_international456",
+ *   number: "4000000000000002",
+ *   expMonth: 6,
+ *   expYear: 2026,
+ *   name: "Maria Garcia",
+ *   addressLine1: "Calle Principal 123",
+ *   addressCity: "Madrid",
+ *   addressCountry: "ES",
+ *   addressZip: "28001",
+ *   metadata: {
+ *     region: "europe",
+ *     currency_preference: "eur"
+ *   }
+ * });
+ */
+export const Card = Resource("stripe::Card", async function (_id, props) {
+    const stripe = createStripeClient({ apiKey: props.apiKey });
+    if (this.phase === "delete") {
+        try {
+            if (this.output?.id && this.output?.customer) {
+                await stripe.customers.deleteSource(this.output.customer, this.output.id);
+            }
+        }
+        catch (error) {
+            handleStripeDeleteError(error, "Card", this.output?.id);
+        }
+        return this.destroy();
+    }
+    try {
+        let card;
+        if (this.phase === "update" && this.output?.id) {
+            const updateParams = {
+                name: props.name,
+                address_city: props.addressCity,
+                address_country: props.addressCountry,
+                address_line1: props.addressLine1,
+                address_line2: props.addressLine2,
+                address_state: props.addressState,
+                address_zip: props.addressZip,
+                exp_month: props.expMonth?.toString(),
+                exp_year: props.expYear?.toString(),
+                metadata: props.metadata,
+            };
+            card = (await stripe.customers.updateSource(props.customer, this.output.id, updateParams));
+        }
+        else {
+            const createParams = {
+                metadata: props.metadata,
+            };
+            if (props.source) {
+                createParams.source = props.source;
+            }
+            else if (props.number) {
+                createParams.source = {
+                    object: "card",
+                    number: props.number,
+                    exp_month: props.expMonth,
+                    exp_year: props.expYear,
+                    cvc: props.cvc,
+                    name: props.name,
+                    address_city: props.addressCity,
+                    address_country: props.addressCountry,
+                    address_line1: props.addressLine1,
+                    address_line2: props.addressLine2,
+                    address_state: props.addressState,
+                    address_zip: props.addressZip,
+                    currency: props.currency,
+                    default_for_currency: props.defaultForCurrency,
+                };
+            }
+            try {
+                card = (await stripe.customers.createSource(props.customer, createParams));
+            }
+            catch (error) {
+                if (isStripeConflictError(error) && props.adopt) {
+                    throw new Error("Card adoption is not supported - cards cannot be uniquely identified for adoption");
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return this({
+            id: card.id,
+            object: card.object,
+            customer: props.customer,
+            brand: card.brand,
+            country: card.country || undefined,
+            dynamicLast4: card.dynamic_last4 || undefined,
+            expMonth: card.exp_month,
+            expYear: card.exp_year,
+            fingerprint: card.fingerprint || undefined,
+            funding: card.funding,
+            last4: card.last4,
+            name: card.name || undefined,
+            addressCity: card.address_city || undefined,
+            addressCountry: card.address_country || undefined,
+            addressLine1: card.address_line1 || undefined,
+            addressLine2: card.address_line2 || undefined,
+            addressState: card.address_state || undefined,
+            addressZip: card.address_zip || undefined,
+            currency: card.currency || undefined,
+            defaultForCurrency: card.default_for_currency || undefined,
+            metadata: card.metadata || undefined,
+            tokenizationMethod: card.tokenization_method || undefined,
+        });
+    }
+    catch (error) {
+        console.error("Error creating/updating card:", error);
+        throw error;
+    }
+});
+//# sourceMappingURL=card.js.map

package/lib/stripe/card.js.map

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

package/lib/stripe/client.d.ts

@@ -0,0 +1,9 @@
+import Stripe from "stripe";
+import type { Secret } from "../secret.ts";
+export interface StripeClientOptions {
+    apiKey?: Secret | string;
+}
+export declare function createStripeClient(options?: StripeClientOptions): Stripe;
+export declare function handleStripeDeleteError(error: any, resourceType: string, resourceId?: string): void;
+export declare function isStripeConflictError(error: any): boolean;
+//# sourceMappingURL=client.d.ts.map

package/lib/stripe/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/stripe/client.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAoB5E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,GAAG,EACV,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAaN;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAEzD"}

package/lib/stripe/client.js

@@ -0,0 +1,94 @@
+import Stripe from "stripe";
+import { withExponentialBackoff } from "../util/retry.js";
+export function createStripeClient(options = {}) {
+    let apiKey;
+    if (options.apiKey) {
+        apiKey =
+            typeof options.apiKey === "string"
+                ? options.apiKey
+                : options.apiKey.unencrypted;
+    }
+    else {
+        const envApiKey = process.env.STRIPE_API_KEY;
+        if (!envApiKey) {
+            throw new Error("Stripe API key is required. Provide it via the apiKey parameter or set the STRIPE_API_KEY environment variable.");
+        }
+        apiKey = envApiKey;
+    }
+    const stripe = new Stripe(apiKey);
+    return createStripeProxy(stripe);
+}
+export function handleStripeDeleteError(error, resourceType, resourceId) {
+    if (error?.code === "resource_missing" || error?.status === 404) {
+        console.log(`${resourceType} ${resourceId || "unknown"} not found during deletion (already deleted)`);
+        return;
+    }
+    console.error(`Error deleting ${resourceType} ${resourceId || "unknown"}:`, error);
+    throw error;
+}
+export function isStripeConflictError(error) {
+    return error?.status === 409 || error?.statusCode === 409;
+}
+/**
+ * Creates a proxy that wraps Stripe API calls with retry logic
+ */
+function createStripeProxy(stripe) {
+    // Cache for proxied resources to avoid creating new proxies for the same resource
+    const resourceProxyCache = new Map();
+    return new Proxy(stripe, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            // If it's not a property we want to proxy, return as-is
+            if (typeof prop !== "string" ||
+                typeof value !== "object" ||
+                value === null) {
+                return value;
+            }
+            // Check if this looks like a Stripe resource (has methods like create, retrieve, etc.)
+            const hasStripeResourceMethods = value &&
+                typeof value === "object" &&
+                (typeof value.create === "function" ||
+                    typeof value.retrieve === "function" ||
+                    typeof value.list === "function" ||
+                    typeof value.update === "function" ||
+                    typeof value.del === "function");
+            if (!hasStripeResourceMethods) {
+                return value;
+            }
+            // Return cached proxy if it exists
+            if (resourceProxyCache.has(prop)) {
+                return resourceProxyCache.get(prop);
+            }
+            // Create a new proxy for this resource
+            const resourceProxy = new Proxy(value, {
+                get(resourceTarget, methodName, resourceReceiver) {
+                    const method = Reflect.get(resourceTarget, methodName, resourceReceiver);
+                    // If it's not a function, return as-is
+                    if (typeof method !== "function") {
+                        return method;
+                    }
+                    // Wrap the method with retry logic
+                    return (...args) => withStripeRetry(() => method.apply(resourceTarget, args));
+                },
+            });
+            // Cache the proxy
+            resourceProxyCache.set(prop, resourceProxy);
+            return resourceProxy;
+        },
+    });
+}
+/**
+ * Determines if a Stripe error should trigger a retry
+ */
+function isStripeRetryableError(error) {
+    return (error?.raw?.statusCode === 429 ||
+        error?.code === "rate_limit" ||
+        error?.type === "rate_limit_error");
+}
+/**
+ * Wraps a Stripe API operation with retry logic for rate limiting
+ */
+async function withStripeRetry(operation, maxAttempts = 5, initialDelayMs = 1000) {
+    return withExponentialBackoff(operation, isStripeRetryableError, maxAttempts, initialDelayMs);
+}
+//# sourceMappingURL=client.js.map

package/lib/stripe/client.js.map

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

package/lib/stripe/coupon.d.ts

@@ -0,0 +1,135 @@
+import type Stripe from "stripe";
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import type { Secret } from "../secret.ts";
+type CouponDuration = Stripe.CouponCreateParams.Duration;
+/**
+ * Properties for creating a Stripe coupon
+ */
+export interface CouponProps {
+    /**
+     * Unique string of your choice that will be used to identify this coupon when applying it to a customer
+     */
+    id?: string;
+    /**
+     * Specifies how long the discount will be in effect
+     */
+    duration: CouponDuration;
+    /**
+     * A positive integer representing the amount to subtract from an invoice total (required if percent_off is not passed)
+     */
+    amountOff?: number;
+    /**
+     * Three-letter ISO code for the currency of the amount_off parameter (required if amount_off is passed)
+     */
+    currency?: string;
+    /**
+     * Required only if duration is repeating, in which case it must be a positive integer that specifies the number of months the discount will be in effect
+     */
+    durationInMonths?: number;
+    /**
+     * A positive integer specifying the number of times the coupon can be redeemed before it's no longer valid
+     */
+    maxRedemptions?: number;
+    /**
+     * Name of the coupon displayed to customers on, for instance invoices, or receipts
+     */
+    name?: string;
+    /**
+     * A positive float larger than 0, and smaller or equal to 100, that represents the discount the coupon will apply (required if amount_off is not passed)
+     */
+    percentOff?: number;
+    /**
+     * Unix timestamp specifying the last time at which the coupon can be redeemed
+     */
+    redeemBy?: number;
+    /**
+     * Number of times this coupon has been applied to a customer
+     */
+    timesRedeemed?: number;
+    /**
+     * Taking account of the above properties, whether this coupon can still be applied to a customer
+     */
+    valid?: boolean;
+    /**
+     * Set of key-value pairs that you can attach to an object
+     */
+    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 coupon
+ */
+export interface Coupon extends Resource<"stripe::Coupon">, CouponProps {
+    /**
+     * The ID of the coupon
+     */
+    id: string;
+    /**
+     * String representing the object's type
+     */
+    object: "coupon";
+    /**
+     * Time at which the object was created
+     */
+    created: number;
+    /**
+     * 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 coupons for discounts
+ *
+ * @example
+ * // Create a percentage-based coupon
+ * const percentageCoupon = await Coupon("summer-sale", {
+ *   id: "SUMMER25",
+ *   duration: "once",
+ *   percentOff: 25,
+ *   name: "Summer Sale 25% Off",
+ *   maxRedemptions: 1000,
+ *   metadata: {
+ *     campaign: "summer_2024",
+ *     type: "seasonal"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a fixed amount coupon
+ * const fixedAmountCoupon = await Coupon("new-customer", {
+ *   id: "WELCOME10",
+ *   duration: "once",
+ *   amountOff: 1000,
+ *   currency: "usd",
+ *   name: "Welcome $10 Off",
+ *   metadata: {
+ *     type: "welcome",
+ *     target: "new_customers"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a repeating coupon for subscriptions
+ * const subscriptionCoupon = await Coupon("loyal-customer", {
+ *   id: "LOYAL15",
+ *   duration: "repeating",
+ *   durationInMonths: 6,
+ *   percentOff: 15,
+ *   name: "Loyal Customer 15% Off",
+ *   metadata: {
+ *     type: "loyalty",
+ *     tier: "premium"
+ *   }
+ * });
+ */
+export declare const Coupon: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<Coupon>, _id: string, props: CouponProps) => Promise<Coupon>);
+export {};
+//# sourceMappingURL=coupon.d.ts.map

package/lib/stripe/coupon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupon.d.ts","sourceRoot":"","sources":["../../src/stripe/coupon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAO3C,KAAK,cAAc,GAAG,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,MAAO,SAAQ,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW;IACrE;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,MAAM,yFAGT,OAAO,CAAC,MAAM,CAAC,OAChB,MAAM,SACJ,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,CAoHnB,CAAC"}

package/lib/stripe/coupon.js

@@ -0,0 +1,161 @@
+import { Resource } from "../resource.js";
+import { createStripeClient, handleStripeDeleteError, isStripeConflictError, } from "./client.js";
+/**
+ * Create and manage Stripe coupons for discounts
+ *
+ * @example
+ * // Create a percentage-based coupon
+ * const percentageCoupon = await Coupon("summer-sale", {
+ *   id: "SUMMER25",
+ *   duration: "once",
+ *   percentOff: 25,
+ *   name: "Summer Sale 25% Off",
+ *   maxRedemptions: 1000,
+ *   metadata: {
+ *     campaign: "summer_2024",
+ *     type: "seasonal"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a fixed amount coupon
+ * const fixedAmountCoupon = await Coupon("new-customer", {
+ *   id: "WELCOME10",
+ *   duration: "once",
+ *   amountOff: 1000,
+ *   currency: "usd",
+ *   name: "Welcome $10 Off",
+ *   metadata: {
+ *     type: "welcome",
+ *     target: "new_customers"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a repeating coupon for subscriptions
+ * const subscriptionCoupon = await Coupon("loyal-customer", {
+ *   id: "LOYAL15",
+ *   duration: "repeating",
+ *   durationInMonths: 6,
+ *   percentOff: 15,
+ *   name: "Loyal Customer 15% Off",
+ *   metadata: {
+ *     type: "loyalty",
+ *     tier: "premium"
+ *   }
+ * });
+ */
+export const Coupon = Resource("stripe::Coupon", async function (_id, props) {
+    const stripe = createStripeClient({ apiKey: props.apiKey });
+    if (this.phase === "delete") {
+        try {
+            if (this.output?.id) {
+                await stripe.coupons.del(this.output.id);
+            }
+        }
+        catch (error) {
+            handleStripeDeleteError(error, "Coupon", this.output?.id);
+        }
+        return this.destroy();
+    }
+    try {
+        let coupon;
+        if (this.phase === "update" && this.output?.id) {
+            coupon = await stripe.coupons.update(this.output.id, {
+                name: props.name,
+                metadata: props.metadata,
+            });
+        }
+        else {
+            const createParams = {
+                duration: props.duration,
+                name: props.name,
+                metadata: props.metadata,
+            };
+            if (props.id) {
+                createParams.id = props.id;
+            }
+            if (props.amountOff !== undefined) {
+                createParams.amount_off = props.amountOff;
+            }
+            if (props.currency) {
+                createParams.currency = props.currency;
+            }
+            if (props.durationInMonths !== undefined) {
+                createParams.duration_in_months = props.durationInMonths;
+            }
+            if (props.maxRedemptions !== undefined) {
+                createParams.max_redemptions = props.maxRedemptions;
+            }
+            if (props.percentOff !== undefined) {
+                createParams.percent_off = props.percentOff;
+            }
+            if (props.redeemBy !== undefined) {
+                createParams.redeem_by = props.redeemBy;
+            }
+            try {
+                try {
+                    coupon = await stripe.coupons.create(createParams);
+                }
+                catch (error) {
+                    if (isStripeConflictError(error) && props.adopt) {
+                        if (props.id) {
+                            const existingCoupon = await stripe.coupons.retrieve(props.id);
+                            const updateParams = {
+                                metadata: props.metadata,
+                                name: props.name,
+                            };
+                            coupon = await stripe.coupons.update(existingCoupon.id, updateParams);
+                        }
+                        else {
+                            throw error;
+                        }
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+            }
+            catch (error) {
+                if (isStripeConflictError(error) && props.adopt) {
+                    if (props.id) {
+                        const existingCoupon = await stripe.coupons.retrieve(props.id);
+                        const updateParams = {
+                            metadata: props.metadata,
+                            name: props.name,
+                        };
+                        coupon = await stripe.coupons.update(existingCoupon.id, updateParams);
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return this({
+            id: coupon.id,
+            object: coupon.object,
+            duration: coupon.duration,
+            amountOff: coupon.amount_off || undefined,
+            currency: coupon.currency || undefined,
+            durationInMonths: coupon.duration_in_months || undefined,
+            maxRedemptions: coupon.max_redemptions || undefined,
+            name: coupon.name || undefined,
+            percentOff: coupon.percent_off || undefined,
+            redeemBy: coupon.redeem_by || undefined,
+            timesRedeemed: coupon.times_redeemed || undefined,
+            valid: coupon.valid,
+            metadata: coupon.metadata || undefined,
+            created: coupon.created,
+            livemode: coupon.livemode,
+        });
+    }
+    catch (error) {
+        console.error("Error creating/updating coupon:", error);
+        throw error;
+    }
+});
+//# sourceMappingURL=coupon.js.map

package/lib/stripe/coupon.js.map

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