alchemy 0.24.0 → 0.25.0

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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"}

package/lib/stripe/customer.d.ts

@@ -0,0 +1,269 @@
+import type Stripe from "stripe";
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import type { Secret } from "../secret.ts";
+/**
+ * Customer address information
+ */
+export interface CustomerAddress {
+    /**
+     * City, district, suburb, town, or village
+     */
+    city?: string;
+    /**
+     * Two-letter country code (ISO 3166-1 alpha-2)
+     */
+    country?: string;
+    /**
+     * Address line 1 (e.g., street, PO Box, or company name)
+     */
+    line1?: string;
+    /**
+     * Address line 2 (e.g., apartment, suite, unit, or building)
+     */
+    line2?: string;
+    /**
+     * ZIP or postal code
+     */
+    postalCode?: string;
+    /**
+     * State, county, province, or region
+     */
+    state?: string;
+}
+/**
+ * Customer shipping information
+ */
+export interface CustomerShipping {
+    /**
+     * Customer's shipping address
+     */
+    address?: CustomerAddress;
+    /**
+     * Customer name
+     */
+    name?: string;
+    /**
+     * Customer phone number
+     */
+    phone?: string;
+}
+/**
+ * Customer invoice settings
+ */
+export interface CustomerInvoiceSettings {
+    /**
+     * Default custom fields to be displayed on invoices for this customer
+     */
+    customFields?: Array<{
+        name: string;
+        value: string;
+    }>;
+    /**
+     * ID of a payment method that's attached to the customer, to be used as the customer's default payment method for subscriptions and invoices
+     */
+    defaultPaymentMethod?: string;
+    /**
+     * Default footer to be displayed on invoices for this customer
+     */
+    footer?: string;
+    /**
+     * Default options for invoice PDF rendering for this customer
+     */
+    renderingOptions?: {
+        amountTaxDisplay?: Stripe.CustomerCreateParams.InvoiceSettings.RenderingOptions.AmountTaxDisplay;
+    };
+}
+/**
+ * Properties for creating a Stripe customer
+ */
+export interface CustomerProps {
+    /**
+     * The customer's address
+     */
+    address?: CustomerAddress;
+    /**
+     * An integer amount in cents that represents the customer's current balance
+     */
+    balance?: number;
+    /**
+     * If you provide a coupon code, the customer will have a discount applied on all recurring charges
+     */
+    coupon?: string;
+    /**
+     * An arbitrary string attached to the object
+     */
+    description?: string;
+    /**
+     * Customer's email address
+     */
+    email?: string;
+    /**
+     * The prefix for the customer used to generate unique invoice numbers
+     */
+    invoicePrefix?: string;
+    /**
+     * Default invoice settings for this customer
+     */
+    invoiceSettings?: CustomerInvoiceSettings;
+    /**
+     * Set of key-value pairs that you can attach to an object
+     */
+    metadata?: Record<string, string>;
+    /**
+     * The customer's full name or business name
+     */
+    name?: string;
+    /**
+     * The sequence to be used on the customer's next invoice
+     */
+    nextInvoiceSequence?: number;
+    /**
+     * The ID of the PaymentMethod to attach to the customer
+     */
+    paymentMethod?: string;
+    /**
+     * The customer's phone number
+     */
+    phone?: string;
+    /**
+     * Customer's preferred languages, ordered by preference
+     */
+    preferredLocales?: string[];
+    /**
+     * The ID of a promotion code to apply to the customer
+     */
+    promotionCode?: string;
+    /**
+     * The customer's shipping information
+     */
+    shipping?: CustomerShipping;
+    /**
+     * When using a card as a source, you can pass the card information
+     */
+    source?: string;
+    /**
+     * The customer's tax exemption status
+     */
+    taxExempt?: Stripe.CustomerCreateParams.TaxExempt;
+    /**
+     * ID of the test clock to attach to the customer
+     */
+    testClock?: 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 customer
+ */
+export interface Customer extends Resource<"stripe::Customer">, CustomerProps {
+    /**
+     * The ID of the customer
+     */
+    id: string;
+    /**
+     * String representing the object's type
+     */
+    object: "customer";
+    /**
+     * Time at which the object was created
+     */
+    created: number;
+    /**
+     * Three-letter ISO code for the currency the customer can be charged in for recurring billing purposes
+     */
+    currency?: string;
+    /**
+     * ID of the default payment source for the customer
+     */
+    defaultSource?: string;
+    /**
+     * Whether or not the customer is currently delinquent
+     */
+    delinquent?: boolean;
+    /**
+     * Describes the current discount active on the customer, if there is one
+     */
+    discount?: any;
+    /**
+     * Has the value true if the object exists in live mode or the value false if the object exists in test mode
+     */
+    livemode: boolean;
+    /**
+     * The customer's payment sources, if any
+     */
+    sources?: any;
+    /**
+     * The customer's current subscriptions, if any
+     */
+    subscriptions?: any;
+    /**
+     * The customer's tax IDs, if any
+     */
+    taxIds?: any;
+}
+/**
+ * Create and manage Stripe customers
+ *
+ * @example
+ * // Create a basic customer
+ * const basicCustomer = await Customer("basic-customer", {
+ *   email: "john@example.com",
+ *   name: "John Doe",
+ *   description: "Premium customer",
+ *   metadata: {
+ *     tier: "premium",
+ *     source: "website"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a customer with full address information
+ * const customerWithAddress = await Customer("customer-with-address", {
+ *   email: "jane@example.com",
+ *   name: "Jane Smith",
+ *   phone: "+1-555-123-4567",
+ *   address: {
+ *     line1: "123 Main St",
+ *     line2: "Apt 4B",
+ *     city: "San Francisco",
+ *     state: "CA",
+ *     postalCode: "94105",
+ *     country: "US"
+ *   },
+ *   shipping: {
+ *     name: "Jane Smith",
+ *     address: {
+ *       line1: "456 Oak Ave",
+ *       city: "Oakland",
+ *       state: "CA",
+ *       postalCode: "94612",
+ *       country: "US"
+ *     }
+ *   }
+ * });
+ *
+ * @example
+ * // Create a business customer with tax exemption
+ * const businessCustomer = await Customer("business-customer", {
+ *   email: "billing@acmecorp.com",
+ *   name: "Acme Corporation",
+ *   description: "Enterprise customer",
+ *   taxExempt: "exempt",
+ *   invoicePrefix: "ACME",
+ *   preferredLocales: ["en"],
+ *   metadata: {
+ *     type: "business",
+ *     industry: "technology",
+ *     employees: "500+"
+ *   }
+ * });
+ */
+export declare const Customer: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<Customer>, _id: string, props: CustomerProps) => Promise<Customer>);
+//# sourceMappingURL=customer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customer.d.ts","sourceRoot":"","sources":["../../src/stripe/customer.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;AAG3C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,gBAAgB,CAAC,EAAE;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC,oBAAoB,CAAC,eAAe,CAAC,gBAAgB,CAAC,gBAAgB,CAAC;KAClG,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC;IAClD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa;IAC3E;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC;IACd;;OAEG;IACH,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,QAAQ,yFAGX,OAAO,CAAC,QAAQ,CAAC,OAClB,MAAM,SACJ,aAAa,KACnB,OAAO,CAAC,QAAQ,CAAC,CAqPrB,CAAC"}