alchemy 0.24.0 → 0.24.1

package/lib/stripe/promotion-code.js

@@ -0,0 +1,150 @@
+import { Resource } from "../resource.js";
+import { createStripeClient, handleStripeDeleteError, isStripeConflictError, } from "./client.js";
+/**
+ * Create and manage Stripe promotion codes for coupons
+ *
+ * @example
+ * // Create a basic promotion code
+ * const basicPromoCode = await PromotionCode("summer-promo", {
+ *   coupon: "SUMMER25",
+ *   code: "SAVE25NOW",
+ *   active: true,
+ *   metadata: {
+ *     campaign: "summer_sale",
+ *     channel: "email"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a customer-specific promotion code
+ * const customerPromoCode = await PromotionCode("vip-discount", {
+ *   coupon: "VIP15",
+ *   code: "VIP15OFF",
+ *   customer: "cus_xyz123",
+ *   maxRedemptions: 1,
+ *   expiresAt: Math.floor(Date.now() / 1000) + 86400 * 30,
+ *   metadata: {
+ *     type: "vip_exclusive",
+ *     tier: "gold"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a promotion code with restrictions
+ * const restrictedPromoCode = await PromotionCode("first-time-buyer", {
+ *   coupon: "WELCOME10",
+ *   code: "FIRSTTIME10",
+ *   restrictions: {
+ *     firstTimeTransaction: true,
+ *     minimumAmount: 5000,
+ *     minimumAmountCurrency: "usd"
+ *   },
+ *   maxRedemptions: 1000,
+ *   metadata: {
+ *     campaign: "new_customer_acquisition",
+ *     minimum_order: "50_usd"
+ *   }
+ * });
+ */
+export const PromotionCode = Resource("stripe::PromotionCode", async function (_id, props) {
+    const stripe = createStripeClient({ apiKey: props.apiKey });
+    if (this.phase === "delete") {
+        try {
+            if (this.output?.id) {
+                await stripe.promotionCodes.update(this.output.id, { active: false });
+            }
+        }
+        catch (error) {
+            handleStripeDeleteError(error, "PromotionCode", this.output?.id);
+        }
+        return this.destroy();
+    }
+    try {
+        let promotionCode;
+        if (this.phase === "update" && this.output?.id) {
+            const updateParams = {
+                active: props.active,
+                metadata: props.metadata,
+            };
+            promotionCode = await stripe.promotionCodes.update(this.output.id, updateParams);
+        }
+        else {
+            const createParams = {
+                coupon: props.coupon,
+                code: props.code,
+                active: props.active,
+                customer: props.customer,
+                expires_at: props.expiresAt,
+                max_redemptions: props.maxRedemptions,
+                metadata: props.metadata,
+            };
+            if (props.restrictions) {
+                createParams.restrictions = {
+                    first_time_transaction: props.restrictions.firstTimeTransaction,
+                    minimum_amount: props.restrictions.minimumAmount,
+                    minimum_amount_currency: props.restrictions.minimumAmountCurrency,
+                };
+            }
+            try {
+                promotionCode = await stripe.promotionCodes.create(createParams);
+            }
+            catch (error) {
+                if (isStripeConflictError(error) && props.adopt) {
+                    if (props.code) {
+                        const existingPromotionCodes = await stripe.promotionCodes.list({
+                            code: props.code,
+                            limit: 1,
+                        });
+                        if (existingPromotionCodes.data.length > 0) {
+                            const existingPromotionCode = existingPromotionCodes.data[0];
+                            const updateParams = {
+                                active: props.active,
+                                metadata: props.metadata,
+                            };
+                            promotionCode = await stripe.promotionCodes.update(existingPromotionCode.id, updateParams);
+                        }
+                        else {
+                            throw error;
+                        }
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return this({
+            id: promotionCode.id,
+            object: promotionCode.object,
+            coupon: typeof promotionCode.coupon === "string"
+                ? promotionCode.coupon
+                : promotionCode.coupon.id,
+            code: promotionCode.code,
+            active: promotionCode.active,
+            customer: typeof promotionCode.customer === "string"
+                ? promotionCode.customer
+                : promotionCode.customer?.id,
+            expiresAt: promotionCode.expires_at || undefined,
+            maxRedemptions: promotionCode.max_redemptions || undefined,
+            metadata: promotionCode.metadata || undefined,
+            restrictions: promotionCode.restrictions
+                ? {
+                    firstTimeTransaction: promotionCode.restrictions.first_time_transaction || undefined,
+                    minimumAmount: promotionCode.restrictions.minimum_amount || undefined,
+                    minimumAmountCurrency: promotionCode.restrictions.minimum_amount_currency || undefined,
+                }
+                : undefined,
+            created: promotionCode.created,
+            livemode: promotionCode.livemode,
+            timesRedeemed: promotionCode.times_redeemed,
+        });
+    }
+    catch (error) {
+        console.error("Error creating/updating promotion code:", error);
+        throw error;
+    }
+});
+//# sourceMappingURL=promotion-code.js.map

package/lib/stripe/promotion-code.js.map

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

package/lib/stripe/shipping-rate.d.ts

@@ -0,0 +1,188 @@
+import type Stripe from "stripe";
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import type { Secret } from "../secret.ts";
+/**
+ * Delivery estimate for shipping rate
+ */
+export interface ShippingRateDeliveryEstimate {
+    /**
+     * The lower bound of the estimated range
+     */
+    minimum?: {
+        /**
+         * A unit of time
+         */
+        unit: Stripe.ShippingRateCreateParams.DeliveryEstimate.Minimum.Unit;
+        /**
+         * Must be greater than 0
+         */
+        value: number;
+    };
+    /**
+     * The upper bound of the estimated range
+     */
+    maximum?: {
+        /**
+         * A unit of time
+         */
+        unit: Stripe.ShippingRateCreateParams.DeliveryEstimate.Maximum.Unit;
+        /**
+         * Must be greater than 0
+         */
+        value: number;
+    };
+}
+/**
+ * Fixed amount configuration for shipping rate
+ */
+export interface ShippingRateFixedAmount {
+    /**
+     * A non-negative integer in cents representing how much to charge
+     */
+    amount: number;
+    /**
+     * Three-letter ISO currency code, in lowercase
+     */
+    currency: string;
+    /**
+     * Shipping rates defined in each available currency option
+     */
+    currencyOptions?: Record<string, {
+        /**
+         * A non-negative integer in cents representing how much to charge
+         */
+        amount: number;
+        /**
+         * Specifies whether the rate is considered inclusive or exclusive of taxes
+         */
+        taxBehavior?: Stripe.ShippingRateCreateParams.FixedAmount.CurrencyOptions.TaxBehavior;
+    }>;
+}
+/**
+ * Properties for creating a Stripe shipping rate
+ */
+export interface ShippingRateProps {
+    /**
+     * The name of the shipping rate, meant to be displayable to the customer
+     */
+    displayName: string;
+    /**
+     * Describes a fixed amount to charge for shipping
+     */
+    fixedAmount?: ShippingRateFixedAmount;
+    /**
+     * The estimated range for how long shipping will take
+     */
+    deliveryEstimate?: ShippingRateDeliveryEstimate;
+    /**
+     * Set of key-value pairs that you can attach to an object
+     */
+    metadata?: Record<string, string>;
+    /**
+     * Whether the shipping rate can be used for new purchases
+     */
+    active?: boolean;
+    /**
+     * Specifies whether the rate is considered inclusive or exclusive of taxes
+     */
+    taxBehavior?: Stripe.ShippingRateCreateParams.TaxBehavior;
+    /**
+     * A tax code ID
+     */
+    taxCode?: string;
+    /**
+     * The type of calculation to use on the shipping rate
+     */
+    type?: "fixed_amount";
+    /**
+     * 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 shipping rate
+ */
+export interface ShippingRate extends Resource<"stripe::ShippingRate">, ShippingRateProps {
+    /**
+     * The ID of the shipping rate
+     */
+    id: string;
+    /**
+     * String representing the object's type
+     */
+    object: "shipping_rate";
+    /**
+     * 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 shipping rates
+ *
+ * @example
+ * // Create a standard shipping rate
+ * const standardShipping = await ShippingRate("standard-shipping", {
+ *   displayName: "Standard Shipping",
+ *   type: "fixed_amount",
+ *   fixedAmount: {
+ *     amount: 500,
+ *     currency: "usd"
+ *   },
+ *   deliveryEstimate: {
+ *     minimum: { unit: "business_day", value: 5 },
+ *     maximum: { unit: "business_day", value: 7 }
+ *   },
+ *   taxBehavior: "exclusive"
+ * });
+ *
+ * @example
+ * // Create an express shipping rate
+ * const expressShipping = await ShippingRate("express-shipping", {
+ *   displayName: "Express Shipping",
+ *   type: "fixed_amount",
+ *   fixedAmount: {
+ *     amount: 1500,
+ *     currency: "usd"
+ *   },
+ *   deliveryEstimate: {
+ *     minimum: { unit: "business_day", value: 1 },
+ *     maximum: { unit: "business_day", value: 2 }
+ *   },
+ *   taxBehavior: "exclusive",
+ *   metadata: {
+ *     priority: "high",
+ *     service_level: "express"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a free shipping rate
+ * const freeShipping = await ShippingRate("free-shipping", {
+ *   displayName: "Free Shipping",
+ *   type: "fixed_amount",
+ *   fixedAmount: {
+ *     amount: 0,
+ *     currency: "usd"
+ *   },
+ *   deliveryEstimate: {
+ *     minimum: { unit: "business_day", value: 7 },
+ *     maximum: { unit: "business_day", value: 10 }
+ *   },
+ *   taxBehavior: "unspecified",
+ *   metadata: {
+ *     promotion: "free_shipping_over_50",
+ *     cost_center: "marketing"
+ *   }
+ * });
+ */
+export declare const ShippingRate: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<ShippingRate>, _id: string, props: ShippingRateProps) => Promise<ShippingRate>);
+//# sourceMappingURL=shipping-rate.d.ts.map

package/lib/stripe/shipping-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipping-rate.d.ts","sourceRoot":"","sources":["../../src/stripe/shipping-rate.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;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC;QACpE;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC,wBAAwB,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC;QACpE;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CACtB,MAAM,EACN;QACE;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QACf;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC;KACvF,CACF,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC;;OAEG;IACH,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,wBAAwB,CAAC,WAAW,CAAC;IAC1D;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YACf,SAAQ,QAAQ,CAAC,sBAAsB,CAAC,EACtC,iBAAiB;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,MAAM,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,YAAY,yFAGf,OAAO,CAAC,YAAY,CAAC,OACtB,MAAM,SACJ,iBAAiB,KACvB,OAAO,CAAC,YAAY,CAAC,CAwJzB,CAAC"}

package/lib/stripe/shipping-rate.js

@@ -0,0 +1,198 @@
+import { Resource } from "../resource.js";
+import { createStripeClient, handleStripeDeleteError, isStripeConflictError, } from "./client.js";
+/**
+ * Create and manage Stripe shipping rates
+ *
+ * @example
+ * // Create a standard shipping rate
+ * const standardShipping = await ShippingRate("standard-shipping", {
+ *   displayName: "Standard Shipping",
+ *   type: "fixed_amount",
+ *   fixedAmount: {
+ *     amount: 500,
+ *     currency: "usd"
+ *   },
+ *   deliveryEstimate: {
+ *     minimum: { unit: "business_day", value: 5 },
+ *     maximum: { unit: "business_day", value: 7 }
+ *   },
+ *   taxBehavior: "exclusive"
+ * });
+ *
+ * @example
+ * // Create an express shipping rate
+ * const expressShipping = await ShippingRate("express-shipping", {
+ *   displayName: "Express Shipping",
+ *   type: "fixed_amount",
+ *   fixedAmount: {
+ *     amount: 1500,
+ *     currency: "usd"
+ *   },
+ *   deliveryEstimate: {
+ *     minimum: { unit: "business_day", value: 1 },
+ *     maximum: { unit: "business_day", value: 2 }
+ *   },
+ *   taxBehavior: "exclusive",
+ *   metadata: {
+ *     priority: "high",
+ *     service_level: "express"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a free shipping rate
+ * const freeShipping = await ShippingRate("free-shipping", {
+ *   displayName: "Free Shipping",
+ *   type: "fixed_amount",
+ *   fixedAmount: {
+ *     amount: 0,
+ *     currency: "usd"
+ *   },
+ *   deliveryEstimate: {
+ *     minimum: { unit: "business_day", value: 7 },
+ *     maximum: { unit: "business_day", value: 10 }
+ *   },
+ *   taxBehavior: "unspecified",
+ *   metadata: {
+ *     promotion: "free_shipping_over_50",
+ *     cost_center: "marketing"
+ *   }
+ * });
+ */
+export const ShippingRate = Resource("stripe::ShippingRate", async function (_id, props) {
+    const stripe = createStripeClient({ apiKey: props.apiKey });
+    if (this.phase === "delete") {
+        try {
+            if (this.output?.id) {
+                await stripe.shippingRates.update(this.output.id, { active: false });
+            }
+        }
+        catch (error) {
+            handleStripeDeleteError(error, "ShippingRate", this.output?.id);
+        }
+        return this.destroy();
+    }
+    try {
+        let shippingRate;
+        if (this.phase === "update" && this.output?.id) {
+            const updateParams = {
+                metadata: props.metadata,
+                tax_behavior: props.taxBehavior,
+            };
+            if (props.active !== undefined)
+                updateParams.active = props.active;
+            shippingRate = await stripe.shippingRates.update(this.output.id, updateParams);
+        }
+        else {
+            const createParams = {
+                display_name: props.displayName,
+                metadata: props.metadata,
+                tax_behavior: props.taxBehavior,
+                tax_code: props.taxCode,
+                type: props.type,
+            };
+            if (props.fixedAmount) {
+                createParams.fixed_amount = {
+                    amount: props.fixedAmount.amount,
+                    currency: props.fixedAmount.currency,
+                    currency_options: props.fixedAmount.currencyOptions
+                        ? Object.fromEntries(Object.entries(props.fixedAmount.currencyOptions).map(([key, value]) => [
+                            key,
+                            {
+                                amount: value.amount,
+                                tax_behavior: value.taxBehavior,
+                            },
+                        ]))
+                        : undefined,
+                };
+            }
+            if (props.deliveryEstimate) {
+                createParams.delivery_estimate = {
+                    minimum: props.deliveryEstimate.minimum
+                        ? {
+                            unit: props.deliveryEstimate.minimum.unit,
+                            value: props.deliveryEstimate.minimum.value,
+                        }
+                        : undefined,
+                    maximum: props.deliveryEstimate.maximum
+                        ? {
+                            unit: props.deliveryEstimate.maximum.unit,
+                            value: props.deliveryEstimate.maximum.value,
+                        }
+                        : undefined,
+                };
+            }
+            try {
+                try {
+                    shippingRate = await stripe.shippingRates.create(createParams);
+                }
+                catch (error) {
+                    if (isStripeConflictError(error) && props.adopt) {
+                        throw new Error("ShippingRate adoption is not supported - shipping rates cannot be uniquely identified for adoption");
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+            }
+            catch (error) {
+                if (isStripeConflictError(error) && props.adopt) {
+                    throw new Error("ShippingRate adoption is not supported - shipping rates cannot be uniquely identified for adoption");
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return this({
+            id: shippingRate.id,
+            object: shippingRate.object,
+            displayName: shippingRate.display_name || "",
+            fixedAmount: shippingRate.fixed_amount
+                ? {
+                    amount: shippingRate.fixed_amount.amount,
+                    currency: shippingRate.fixed_amount.currency,
+                    currencyOptions: shippingRate.fixed_amount.currency_options
+                        ? Object.fromEntries(Object.entries(shippingRate.fixed_amount.currency_options).map(([key, value]) => [
+                            key,
+                            {
+                                amount: value.amount,
+                                taxBehavior: value.tax_behavior,
+                            },
+                        ]))
+                        : undefined,
+                }
+                : undefined,
+            deliveryEstimate: shippingRate.delivery_estimate
+                ? {
+                    minimum: shippingRate.delivery_estimate.minimum
+                        ? {
+                            unit: shippingRate.delivery_estimate.minimum.unit,
+                            value: shippingRate.delivery_estimate.minimum.value,
+                        }
+                        : undefined,
+                    maximum: shippingRate.delivery_estimate.maximum
+                        ? {
+                            unit: shippingRate.delivery_estimate.maximum.unit,
+                            value: shippingRate.delivery_estimate.maximum.value,
+                        }
+                        : undefined,
+                }
+                : undefined,
+            metadata: shippingRate.metadata || undefined,
+            active: shippingRate.active,
+            taxBehavior: shippingRate.tax_behavior || undefined,
+            taxCode: typeof shippingRate.tax_code === "string"
+                ? shippingRate.tax_code
+                : undefined,
+            type: shippingRate.type || undefined,
+            created: shippingRate.created,
+            livemode: shippingRate.livemode,
+        });
+    }
+    catch (error) {
+        console.error("Error creating/updating shipping rate:", error);
+        throw error;
+    }
+});
+//# sourceMappingURL=shipping-rate.js.map

package/lib/stripe/shipping-rate.js.map

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

package/lib/stripe/tax-rate.d.ts

@@ -0,0 +1,130 @@
+import type Stripe from "stripe";
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import type { Secret } from "../secret.ts";
+/**
+ * Properties for creating a Stripe tax rate
+ */
+export interface TaxRateProps {
+    /**
+     * The display name of the tax rate, which will be shown to users
+     */
+    displayName: string;
+    /**
+     * This represents the tax rate percent out of 100
+     */
+    percentage: number;
+    /**
+     * This specifies if the tax rate is inclusive or exclusive
+     */
+    inclusive: boolean;
+    /**
+     * Flag determining whether the tax rate is active or inactive
+     */
+    active?: boolean;
+    /**
+     * Two-letter country code (ISO 3166-1 alpha-2)
+     */
+    country?: string;
+    /**
+     * An arbitrary string attached to the tax rate for your internal use only
+     */
+    description?: string;
+    /**
+     * The jurisdiction for the tax rate
+     */
+    jurisdiction?: string;
+    /**
+     * Set of key-value pairs that you can attach to an object
+     */
+    metadata?: Record<string, string>;
+    /**
+     * ISO 3166-2 subdivision code, without country prefix
+     */
+    state?: string;
+    /**
+     * The high-level tax type, such as vat or sales_tax
+     */
+    taxType?: Stripe.TaxRateCreateParams.TaxType;
+    /**
+     * 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 tax rate
+ */
+export interface TaxRate extends Resource<"stripe::TaxRate">, TaxRateProps {
+    /**
+     * The ID of the tax rate
+     */
+    id: string;
+    /**
+     * String representing the object's type
+     */
+    object: "tax_rate";
+    /**
+     * 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 tax rates
+ *
+ * @example
+ * // Create a basic sales tax rate
+ * const salesTax = await TaxRate("ca-sales-tax", {
+ *   displayName: "CA Sales Tax",
+ *   percentage: 8.5,
+ *   inclusive: false,
+ *   active: true,
+ *   country: "US",
+ *   state: "CA",
+ *   description: "California sales tax",
+ *   taxType: "sales_tax"
+ * });
+ *
+ * @example
+ * // Create a VAT tax rate
+ * const vatTax = await TaxRate("uk-vat", {
+ *   displayName: "UK VAT",
+ *   percentage: 20.0,
+ *   inclusive: true,
+ *   active: true,
+ *   country: "GB",
+ *   description: "United Kingdom Value Added Tax",
+ *   taxType: "vat",
+ *   metadata: {
+ *     region: "europe",
+ *     tax_authority: "hmrc"
+ *   }
+ * });
+ *
+ * @example
+ * // Create a city tax rate
+ * const cityTax = await TaxRate("nyc-tax", {
+ *   displayName: "NYC Local Tax",
+ *   percentage: 4.5,
+ *   inclusive: false,
+ *   active: true,
+ *   country: "US",
+ *   state: "NY",
+ *   jurisdiction: "New York City",
+ *   description: "New York City local sales tax",
+ *   taxType: "sales_tax",
+ *   metadata: {
+ *     locality: "nyc",
+ *     tax_level: "city"
+ *   }
+ * });
+ */
+export declare const TaxRate: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<TaxRate>, _id: string, props: TaxRateProps) => Promise<TaxRate>);
+//# sourceMappingURL=tax-rate.d.ts.map