@bubblelab/bubble-core 0.1.49 → 0.1.51

package/dist/bubbles/service-bubble/stripe/stripe.utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Stripe Bubble Utility Functions
+ *
+ * Helper functions for Stripe API interactions and data formatting.
+ */
+/**
+ * Format amount from smallest currency unit to display format
+ * @param amount Amount in smallest currency unit (e.g., cents)
+ * @param currency Three-letter ISO currency code
+ * @returns Formatted currency string
+ */
+export declare function formatStripeAmount(amount: number, currency: string): string;
+/**
+ * Convert display amount to Stripe smallest currency unit
+ * @param displayAmount Amount in display format (e.g., 10.99)
+ * @param currency Three-letter ISO currency code
+ * @returns Amount in smallest currency unit
+ */
+export declare function toStripeAmount(displayAmount: number, currency: string): number;
+/**
+ * Format Unix timestamp to human-readable date
+ * @param timestamp Unix timestamp in seconds
+ * @returns Formatted date string
+ */
+export declare function formatStripeTimestamp(timestamp: number): string;
+/**
+ * Validate Stripe ID format
+ * @param id Stripe object ID
+ * @param prefix Expected prefix (e.g., 'cus', 'prod', 'price')
+ * @returns Whether the ID is valid
+ */
+export declare function isValidStripeId(id: string, prefix: string): boolean;
+/**
+ * Enhance Stripe API error messages with helpful hints
+ * @param error Original error message
+ * @param statusCode HTTP status code
+ * @returns Enhanced error message
+ */
+export declare function enhanceStripeErrorMessage(error: string, statusCode?: number): string;
+//# sourceMappingURL=stripe.utils.d.ts.map

package/dist/bubbles/service-bubble/stripe/stripe.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.utils.d.ts","sourceRoot":"","sources":["../../../../src/bubbles/service-bubble/stripe/stripe.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6B3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAuBR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAcR"}

package/dist/bubbles/service-bubble/stripe/stripe.utils.js

@@ -0,0 +1,111 @@
+/**
+ * Stripe Bubble Utility Functions
+ *
+ * Helper functions for Stripe API interactions and data formatting.
+ */
+/**
+ * Format amount from smallest currency unit to display format
+ * @param amount Amount in smallest currency unit (e.g., cents)
+ * @param currency Three-letter ISO currency code
+ * @returns Formatted currency string
+ */
+export function formatStripeAmount(amount, currency) {
+    const formatter = new Intl.NumberFormat('en-US', {
+        style: 'currency',
+        currency: currency.toUpperCase(),
+    });
+    // Most currencies use 2 decimal places (divide by 100)
+    // Some currencies like JPY use 0 decimal places
+    const zeroDecimalCurrencies = [
+        'BIF',
+        'CLP',
+        'DJF',
+        'GNF',
+        'JPY',
+        'KMF',
+        'KRW',
+        'MGA',
+        'PYG',
+        'RWF',
+        'UGX',
+        'VND',
+        'VUV',
+        'XAF',
+        'XOF',
+        'XPF',
+    ];
+    const divisor = zeroDecimalCurrencies.includes(currency.toUpperCase())
+        ? 1
+        : 100;
+    return formatter.format(amount / divisor);
+}
+/**
+ * Convert display amount to Stripe smallest currency unit
+ * @param displayAmount Amount in display format (e.g., 10.99)
+ * @param currency Three-letter ISO currency code
+ * @returns Amount in smallest currency unit
+ */
+export function toStripeAmount(displayAmount, currency) {
+    const zeroDecimalCurrencies = [
+        'BIF',
+        'CLP',
+        'DJF',
+        'GNF',
+        'JPY',
+        'KMF',
+        'KRW',
+        'MGA',
+        'PYG',
+        'RWF',
+        'UGX',
+        'VND',
+        'VUV',
+        'XAF',
+        'XOF',
+        'XPF',
+    ];
+    const multiplier = zeroDecimalCurrencies.includes(currency.toUpperCase())
+        ? 1
+        : 100;
+    return Math.round(displayAmount * multiplier);
+}
+/**
+ * Format Unix timestamp to human-readable date
+ * @param timestamp Unix timestamp in seconds
+ * @returns Formatted date string
+ */
+export function formatStripeTimestamp(timestamp) {
+    return new Date(timestamp * 1000).toISOString();
+}
+/**
+ * Validate Stripe ID format
+ * @param id Stripe object ID
+ * @param prefix Expected prefix (e.g., 'cus', 'prod', 'price')
+ * @returns Whether the ID is valid
+ */
+export function isValidStripeId(id, prefix) {
+    const pattern = new RegExp(`^${prefix}_[a-zA-Z0-9]+$`);
+    return pattern.test(id);
+}
+/**
+ * Enhance Stripe API error messages with helpful hints
+ * @param error Original error message
+ * @param statusCode HTTP status code
+ * @returns Enhanced error message
+ */
+export function enhanceStripeErrorMessage(error, statusCode) {
+    if (statusCode === 401) {
+        return `${error}\n\nHint: Your Stripe API key may be invalid or expired. Please check your credentials.`;
+    }
+    if (statusCode === 403) {
+        return `${error}\n\nHint: Your Stripe API key may not have permission for this operation. Check your key permissions.`;
+    }
+    if (statusCode === 404) {
+        return `${error}\n\nHint: The requested resource was not found. Check that the ID is correct.`;
+    }
+    if (statusCode === 429) {
+        return `${error}\n\nHint: Rate limit exceeded. Please wait a moment before retrying.`;
+    }
+    return error;
+}
+//# sourceMappingURL=stripe.utils.js.map

package/dist/bubbles/service-bubble/stripe/stripe.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.utils.js","sourceRoot":"","sources":["../../../../src/bubbles/service-bubble/stripe/stripe.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,QAAgB;IACjE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;QAC/C,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;KACjC,CAAC,CAAC;IACH,uDAAuD;IACvD,gDAAgD;IAChD,MAAM,qBAAqB,GAAG;QAC5B,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IACF,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACpE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC;IACR,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,QAAgB;IAEhB,MAAM,qBAAqB,GAAG;QAC5B,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IACF,MAAM,UAAU,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACvE,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,GAAG,CAAC;IACR,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,UAAU,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,MAAc;IACxD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,gBAAgB,CAAC,CAAC;IACvD,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAa,EACb,UAAmB;IAEnB,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,yFAAyF,CAAC;IAC3G,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,uGAAuG,CAAC;IACzH,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,+EAA+E,CAAC;IACjG,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,GAAG,KAAK,sEAAsE,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}