@dotted-labs/ngx-supabase-stripe 0.6.4 → 0.7.0

package/i18n/messages.en.json

@@ -0,0 +1,98 @@
+{
+  "locale": "en",
+  "translations": {
+    "stripe.billing.daily": "Daily",
+    "stripe.billing.monthly": "Monthly",
+    "stripe.billing.weekly": "Weekly",
+    "stripe.billing.yearly": "Yearly",
+    "stripe.checkout.error_message": "The payment could not be processed. Please try again or contact support.",
+    "stripe.checkout.error_title": "An error occurred",
+    "stripe.checkout.payment_complete": "Payment completed successfully!",
+    "stripe.checkout.payment_processing": "Payment in processing",
+    "stripe.checkout.processing_message": "Your payment is being processed. You will receive an email confirmation when it is complete.",
+    "stripe.checkout.verifying_status": "Verifying your payment status...",
+    "stripe.common.back": "Back",
+    "stripe.common.close": "Close",
+    "stripe.common.error_label": "Error:",
+    "stripe.common.loading": "Loading...",
+    "stripe.common.not_available": "N/A",
+    "stripe.common.refresh": "Refresh",
+    "stripe.customer.payment_intents_description": "Payment intents history. Select a tab to see the list or table view.",
+    "stripe.customer.payment_intents_title": "Payment Intents",
+    "stripe.customer.tab_list": "List",
+    "stripe.customer.tab_table": "Table",
+    "stripe.errors.no_auth_session": "No Supabase Auth session. Sign in before checkout (e.g. signInWithPassword, signInWithOAuth, or magic link).",
+    "stripe.errors.no_stripe_instance": "No Stripe instance returned",
+    "stripe.errors.payment_method_not_found": "Payment method not found",
+    "stripe.errors.portal_session_failed": "Could not create portal session",
+    "stripe.errors.unknown": "Unknown error",
+    "stripe.payment_intents.additional_info": "Additional information",
+    "stripe.payment_intents.confirmation": "Confirmation:",
+    "stripe.payment_intents.count_label": "payment intents",
+    "stripe.payment_intents.details": "Details",
+    "stripe.payment_intents.dialog_title": "Payment intent details",
+    "stripe.payment_intents.empty_description": "No payment intents found in your history.",
+    "stripe.payment_intents.empty_title": "No recent payment intents",
+    "stripe.payment_intents.environment": "Environment",
+    "stripe.payment_intents.export_selected": "Export selected",
+    "stripe.payment_intents.invoice": "Invoice",
+    "stripe.payment_intents.mode.live": "Live",
+    "stripe.payment_intents.mode.test": "Test",
+    "stripe.payment_intents.payment_info": "Payment information",
+    "stripe.payment_intents.payment_method": "Payment method",
+    "stripe.payment_intents.reference": "Reference",
+    "stripe.payment_intents.table.amount": "Amount",
+    "stripe.payment_intents.table.mode": "Mode",
+    "stripe.payment_intents.table.payment_method": "Payment method",
+    "stripe.payment_intents.table.status": "Status",
+    "stripe.payment_intents.transaction_details": "Transaction details",
+    "stripe.payment_method.active": "Active",
+    "stripe.payment_method.added_on": "Payment method added:",
+    "stripe.payment_method.billing_address": "Billing address",
+    "stripe.payment_method.cardholder": "CARDHOLDER",
+    "stripe.payment_method.contact_info": "Contact information",
+    "stripe.payment_method.expired": "Expired",
+    "stripe.payment_method.valid_thru": "VALID THRU",
+    "stripe.product.buy_now": "Buy now",
+    "stripe.product.inactive": "Inactive",
+    "stripe.product.no_products": "No products available",
+    "stripe.product.per_month": "/mo",
+    "stripe.product.per_year": "/yr",
+    "stripe.status.active": "Active",
+    "stripe.status.canceled": "Canceled",
+    "stripe.status.failed": "Failed",
+    "stripe.status.incomplete": "Incomplete",
+    "stripe.status.incomplete_expired": "Incomplete expired",
+    "stripe.status.paid": "Paid",
+    "stripe.status.past_due": "Past due",
+    "stripe.status.paused": "Paused",
+    "stripe.status.pending": "Pending",
+    "stripe.status.processing": "Processing",
+    "stripe.status.requires_action": "Requires action",
+    "stripe.status.requires_capture": "Requires capture",
+    "stripe.status.requires_confirmation": "Requires confirmation",
+    "stripe.status.requires_payment_method": "Requires payment method",
+    "stripe.status.succeeded": "Succeeded",
+    "stripe.status.trialing": "Trialing",
+    "stripe.status.unpaid": "Unpaid",
+    "stripe.subscription.active_until": "Subscription active until:",
+    "stripe.subscription.canceled_badge": "Canceled",
+    "stripe.subscription.count_label": "subscriptions",
+    "stripe.subscription.description": "Manage your subscriptions and payments in one place",
+    "stripe.subscription.empty_description": "Browse our plans to start a subscription.",
+    "stripe.subscription.empty_title": "You have no active subscriptions",
+    "stripe.subscription.loading_details": "Loading subscription details...",
+    "stripe.subscription.manage": "Manage subscription",
+    "stripe.subscription.plan_fallback": "Subscription plan",
+    "stripe.subscription.product_alt": "Subscription product",
+    "stripe.subscription.return.active": "Your subscription is active and ready to use.",
+    "stripe.subscription.return.benefit_full_access": "Full access to all features",
+    "stripe.subscription.return.benefit_support": "24/7 priority support",
+    "stripe.subscription.return.benefit_updates": "Automatic updates",
+    "stripe.subscription.return.benefits_title": "Included benefits:",
+    "stripe.subscription.return.contact_support": "Contact support",
+    "stripe.subscription.return.go_dashboard": "Go to dashboard",
+    "stripe.subscription.return.need_help": "Need help?",
+    "stripe.subscription.title": "Subscriptions"
+  }
+}

package/i18n/messages.es.json

@@ -0,0 +1,98 @@
+{
+  "locale": "es",
+  "translations": {
+    "stripe.billing.daily": "Diario",
+    "stripe.billing.monthly": "Mensual",
+    "stripe.billing.weekly": "Semanal",
+    "stripe.billing.yearly": "Anual",
+    "stripe.checkout.error_message": "No se pudo procesar el pago. Inténtalo de nuevo o contacta con soporte.",
+    "stripe.checkout.error_title": "Se produjo un error",
+    "stripe.checkout.payment_complete": "¡Pago completado con éxito!",
+    "stripe.checkout.payment_processing": "Pago en procesamiento",
+    "stripe.checkout.processing_message": "Tu pago se está procesando. Recibirás un correo de confirmación cuando se complete.",
+    "stripe.checkout.verifying_status": "Verificando el estado de tu pago...",
+    "stripe.common.back": "Volver",
+    "stripe.common.close": "Cerrar",
+    "stripe.common.error_label": "Error:",
+    "stripe.common.loading": "Cargando...",
+    "stripe.common.not_available": "N/D",
+    "stripe.common.refresh": "Actualizar",
+    "stripe.customer.payment_intents_description": "Historial de payment intents. Selecciona una pestaña para ver la lista o la tabla.",
+    "stripe.customer.payment_intents_title": "Payment Intents",
+    "stripe.customer.tab_list": "Lista",
+    "stripe.customer.tab_table": "Tabla",
+    "stripe.errors.no_auth_session": "No hay sesión de Supabase Auth. Inicia sesión antes del checkout (p. ej. signInWithPassword, signInWithOAuth o magic link).",
+    "stripe.errors.no_stripe_instance": "No se devolvió una instancia de Stripe",
+    "stripe.errors.payment_method_not_found": "Método de pago no encontrado",
+    "stripe.errors.portal_session_failed": "No se pudo crear la sesión del portal",
+    "stripe.errors.unknown": "Error desconocido",
+    "stripe.payment_intents.additional_info": "Información adicional",
+    "stripe.payment_intents.confirmation": "Confirmación:",
+    "stripe.payment_intents.count_label": "payment intents",
+    "stripe.payment_intents.details": "Detalles",
+    "stripe.payment_intents.dialog_title": "Detalles del payment intent",
+    "stripe.payment_intents.empty_description": "No se encontraron payment intents en tu historial.",
+    "stripe.payment_intents.empty_title": "No hay payment intents recientes",
+    "stripe.payment_intents.environment": "Entorno",
+    "stripe.payment_intents.export_selected": "Exportar seleccionados",
+    "stripe.payment_intents.invoice": "Factura",
+    "stripe.payment_intents.mode.live": "Producción",
+    "stripe.payment_intents.mode.test": "Prueba",
+    "stripe.payment_intents.payment_info": "Información del pago",
+    "stripe.payment_intents.payment_method": "Método de pago",
+    "stripe.payment_intents.reference": "Referencia",
+    "stripe.payment_intents.table.amount": "Importe",
+    "stripe.payment_intents.table.mode": "Modo",
+    "stripe.payment_intents.table.payment_method": "Método de pago",
+    "stripe.payment_intents.table.status": "Estado",
+    "stripe.payment_intents.transaction_details": "Detalles de la transacción",
+    "stripe.payment_method.active": "Activa",
+    "stripe.payment_method.added_on": "Método agregado:",
+    "stripe.payment_method.billing_address": "Dirección de facturación",
+    "stripe.payment_method.cardholder": "TITULAR",
+    "stripe.payment_method.contact_info": "Información de contacto",
+    "stripe.payment_method.expired": "Expirada",
+    "stripe.payment_method.valid_thru": "VÁLIDA HASTA",
+    "stripe.product.buy_now": "Comprar ahora",
+    "stripe.product.inactive": "Inactivo",
+    "stripe.product.no_products": "No hay productos disponibles",
+    "stripe.product.per_month": "/mes",
+    "stripe.product.per_year": "/año",
+    "stripe.status.active": "Activa",
+    "stripe.status.canceled": "Cancelada",
+    "stripe.status.failed": "Fallida",
+    "stripe.status.incomplete": "Incompleta",
+    "stripe.status.incomplete_expired": "Incompleta expirada",
+    "stripe.status.paid": "Pagada",
+    "stripe.status.past_due": "Vencida",
+    "stripe.status.paused": "Pausada",
+    "stripe.status.pending": "Pendiente",
+    "stripe.status.processing": "Procesando",
+    "stripe.status.requires_action": "Requiere acción",
+    "stripe.status.requires_capture": "Requiere captura",
+    "stripe.status.requires_confirmation": "Requiere confirmación",
+    "stripe.status.requires_payment_method": "Requiere método de pago",
+    "stripe.status.succeeded": "Completada",
+    "stripe.status.trialing": "En prueba",
+    "stripe.status.unpaid": "Impagada",
+    "stripe.subscription.active_until": "Suscripción activa hasta:",
+    "stripe.subscription.canceled_badge": "Cancelada",
+    "stripe.subscription.count_label": "suscripciones",
+    "stripe.subscription.description": "Gestiona tus suscripciones y pagos en un solo lugar",
+    "stripe.subscription.empty_description": "Consulta nuestros planes para comenzar una suscripción.",
+    "stripe.subscription.empty_title": "No tienes suscripciones activas",
+    "stripe.subscription.loading_details": "Cargando detalles de la suscripción...",
+    "stripe.subscription.manage": "Gestionar suscripción",
+    "stripe.subscription.plan_fallback": "Plan de suscripción",
+    "stripe.subscription.product_alt": "Producto de suscripción",
+    "stripe.subscription.return.active": "Tu suscripción está activa y lista para usar.",
+    "stripe.subscription.return.benefit_full_access": "Acceso completo a todas las funciones",
+    "stripe.subscription.return.benefit_support": "Soporte prioritario 24/7",
+    "stripe.subscription.return.benefit_updates": "Actualizaciones automáticas",
+    "stripe.subscription.return.benefits_title": "Beneficios incluidos:",
+    "stripe.subscription.return.contact_support": "Contacta soporte",
+    "stripe.subscription.return.go_dashboard": "Ir al panel principal",
+    "stripe.subscription.return.need_help": "¿Necesitas ayuda?",
+    "stripe.subscription.title": "Suscripciones"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotted-labs/ngx-supabase-stripe",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "description": "An Angular library for integrating Supabase and Stripe into your applications, providing ready-to-use components that simplify the implementation of payments and subscriptions",
   "keywords": [
     "angular",
@@ -28,6 +28,7 @@
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
+    "@angular/localize": "^21.0.0",
     "@stripe/stripe-js": "^8.8.0",
     "@supabase/supabase-js": "^2.39.7"
   },
@@ -44,6 +45,11 @@
     ".": {
       "types": "./types/dotted-labs-ngx-supabase-stripe.d.ts",
       "default": "./fesm2022/dotted-labs-ngx-supabase-stripe.mjs"
+    },
+    "./i18n": {
+      "types": "./types/dotted-labs-ngx-supabase-stripe-i18n.d.ts",
+      "default": "./fesm2022/dotted-labs-ngx-supabase-stripe-i18n.mjs"
     }
-  }
+  },
+  "type": "module"
 }

package/types/dotted-labs-ngx-supabase-stripe-i18n.d.ts

@@ -0,0 +1,15 @@
+declare const STRIPE_LOCALES: readonly ["es", "en"];
+type StripeLocale = (typeof STRIPE_LOCALES)[number];
+type StripeMessagesFile = {
+    locale: string;
+    translations: Record<string, string>;
+};
+/**
+ * Loads stripe translation messages for the given locale.
+ * Falls back to English when the locale is not available.
+ * The app consumer must merge the result into `loadTranslations()` before bootstrap.
+ */
+declare const loadStripeMessages: (locale: string) => Promise<StripeMessagesFile>;
+
+export { STRIPE_LOCALES, loadStripeMessages };
+export type { StripeLocale, StripeMessagesFile };

package/types/dotted-labs-ngx-supabase-stripe.d.ts

@@ -1,12 +1,12 @@
 import * as _angular_core from '@angular/core';
 import { InjectionToken, Provider, EnvironmentProviders, OnInit } from '@angular/core';
+import { StripeConstructorOptions, Stripe as Stripe$1, StripeEmbeddedCheckout } from '@stripe/stripe-js';
 import * as _dotted_labs_ngx_supabase_stripe from '@dotted-labs/ngx-supabase-stripe';
 import { SupabaseClient } from '@supabase/supabase-js';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as stripe from 'stripe';
 import { Stripe } from 'stripe';
 import * as _ngrx_signals_entities from '@ngrx/signals/entities';
-import { Stripe as Stripe$1, StripeEmbeddedCheckout } from '@stripe/stripe-js';
 import * as _supabase_postgrest_js from '@supabase/postgrest-js';
 
 /**
@@ -23,6 +23,11 @@ interface StripeConfig {
      * When omitted, components use `window.location.origin`.
      */
     embeddedCheckoutBaseUrl?: string;
+    /**
+     * BCP 47 locale for Stripe.js (e.g. 'en', 'es'). Localizes Embedded Checkout UI only.
+     * Should match the locale passed to loadStripeMessages() in the consuming app.
+     */
+    locale?: StripeConstructorOptions['locale'];
 }
 declare const STRIPE_CONFIG: InjectionToken<StripeConfig>;
 /**
@@ -921,6 +926,16 @@ declare const CheckoutStore: _angular_core.Type<{
     sessionStatus: ICheckoutSessionStatus | null;
 }>>;
 
+declare enum Currency {
+    EUR = "eur",
+    USD = "usd",
+    GBP = "gbp",
+    JPY = "jpy",
+    KRW = "krw",
+    CNY = "cny",
+    INR = "inr"
+}
+
 type StripeSchemaType = Database['stripe'];
 type StripeRowType<T extends keyof StripeSchemaType['Tables']> = StripeSchemaType['Tables'][T]['Row'];
 type StripeUpdateType<T extends keyof StripeSchemaType['Tables']> = StripeSchemaType['Tables'][T]['Update'];
@@ -938,16 +953,7 @@ type StripeCustomerRow = StripeRowType<'customers'>;
 type StripeCustomer = Omit<StripeCustomerRow, 'created' | 'updated'>;
 type StripeTables = keyof StripeSchemaType['Tables'];
 
-declare enum Currency {
-    EUR = "eur",
-    USD = "usd",
-    GBP = "gbp",
-    JPY = "jpy",
-    KRW = "krw",
-    CNY = "cny",
-    INR = "inr"
-}
-
+type StripePricePublic = Omit<StripePrice, 'attrs'>;
 type StripeProductPublic = Omit<StripeProduct, 'attrs'> & {
     images: string[];
     prices: {
@@ -955,7 +961,7 @@ type StripeProductPublic = Omit<StripeProduct, 'attrs'> & {
         recurringInterval: string;
     }[];
 };
-type StripePricePublic = Omit<StripePrice, 'attrs'>;
+
 type ProductsStatus = 'idle' | 'loading' | 'success' | 'error';
 declare const ProductsStore: _angular_core.Type<{
     products: _angular_core.Signal<StripeProductPublic[] | null>;
@@ -984,7 +990,6 @@ declare const ProductsStore: _angular_core.Type<{
     error: string | null;
     currency: Currency;
 }>>;
-declare function parseProduct(product: StripeProduct, prices?: StripePrice[]): StripeProductPublic;
 
 type CustomerStatus = 'idle' | 'loading' | 'success' | 'error';
 type StripePaymentIntentsPublic = Omit<StripePaymentIntent, 'attrs'> & {
@@ -1924,7 +1929,7 @@ declare class SupabaseClientService {
         current_period_start: string;
         current_period_end: string;
         attrs: _dotted_labs_ngx_supabase_stripe.Json;
-    }[], "get_stripe_subscriptions", null, "RPC">;
+    }[], "get_stripe_subscriptions", null, "RPC", false>;
     /**
      * Stripe subscriptions for the JWT-authenticated Supabase user (empty if anonymous)
      */
@@ -2521,7 +2526,7 @@ declare class SupabaseClientService {
         current_period_start: string;
         current_period_end: string;
         attrs: _dotted_labs_ngx_supabase_stripe.Json;
-    }[], "get_stripe_subscriptions_for_authenticated_user", null, "RPC">;
+    }[], "get_stripe_subscriptions_for_authenticated_user", null, "RPC", false>;
     /**
      * Select a Stripe subscription
      * @param subscriptionId The subscription ID
@@ -3119,7 +3124,7 @@ declare class SupabaseClientService {
         current_period_start: string;
         current_period_end: string;
         attrs: _dotted_labs_ngx_supabase_stripe.Json;
-    }[], "get_stripe_subscription", null, "RPC">;
+    }[], "get_stripe_subscription", null, "RPC", false>;
     /**
      * STRIPE PRICES
      */
@@ -3302,6 +3307,42 @@ declare class SupabaseClientService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SupabaseClientService>;
 }
 
+type FetchCatalogResult = {
+    prices: StripePrice[];
+    products: StripeProductPublic[];
+};
+declare class ProductsService {
+    private readonly supabaseService;
+    /**
+     * Map a Stripe product row plus price rows to the public shape used by the UI.
+     */
+    toStripeProductPublic(product: StripeProduct, prices?: StripePrice[]): StripeProductPublic;
+    /**
+     * Load all Stripe prices and products, returning parsed public products.
+     */
+    fetchFullCatalog(): Promise<{
+        data: FetchCatalogResult | null;
+        error: Error | null;
+    }>;
+    /**
+     * Load prices and a single product by id, returning parsed public product(s).
+     */
+    fetchProductById(id: string): Promise<{
+        data: StripeProductPublic[];
+        error: Error | null;
+    }>;
+    /**
+     * Load prices and products for the given Stripe product ids.
+     */
+    fetchProductsByIds(ids: string[]): Promise<{
+        data: StripeProductPublic[];
+        error: Error | null;
+    }>;
+    private parseProduct;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ProductsService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ProductsService>;
+}
+
 declare class EmbeddedCheckoutComponent implements OnInit {
     readonly checkoutStore: {
         status: _angular_core.Signal<_dotted_labs_ngx_supabase_stripe.CheckoutStatus>;
@@ -3491,6 +3532,8 @@ declare class UtilsService {
     formatAmount(amount: number, currency?: string): string;
     formatDate(timestamp: number | string): string;
     getStatusBadgeClass(status: string): string;
+    translateStripeStatus(status: string): string;
+    translateBillingInterval(interval: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UtilsService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<UtilsService>;
 }
@@ -3708,6 +3751,8 @@ declare class PaymentIntentsTableComponent {
     readonly exportSelected: _angular_core.OutputEmitterRef<StripePaymentIntentsPublic[]>;
     readonly onRefresh: _angular_core.OutputEmitterRef<void>;
     readonly utils: UtilsService;
+    protected readonly liveModeLabel: string;
+    protected readonly testModeLabel: string;
     readonly hasPaymentIntents: _angular_core.Signal<boolean>;
     protected readonly trackByPaymentIntentId: (index: number, item: StripePaymentIntentsPublic) => string | null;
     refreshPaymentIntents(): void;
@@ -3836,5 +3881,5 @@ declare class CustomerDashboardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CustomerDashboardComponent, "lib-customer-dashboard", never, { "returnUrl": { "alias": "returnUrl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { CheckoutStore, Currency, CustomerDashboardComponent, CustomerStore, EmbeddedCheckoutComponent, EmbeddedSubscriptionComponent, PaymentIntentsListComponent, PaymentIntentsTableComponent, PortalAccountStore, ProductItemButtonComponent, ProductListComponent, ProductsStore, ReturnPageComponent, STRIPE_CONFIG, SUPABASE_BROWSER_CLIENT, SUPABASE_CONFIG, StripeClientService, SubscriptionCardComponent, SubscriptionReturnPageComponent, SubscriptionsListComponent, SubscriptionsStore, SupabaseClientService, parsePaymentIntent, parseProduct, parseSubscription, provideNgxSupabaseStripeConfig, provideStripeConfig, provideSupabaseConfig };
-export type { CheckoutStatus, CompositeTypes, CustomerState, CustomerStatus, Database, ICheckoutSessionStatus, Json, NgxSupabaseStripeConfig, PaymentMethodEntity, PortalSessionResponse, PortalState, PortalStatus, ProductsStatus, StripeConfig, StripeCustomerPublic, StripePaymentIntentsPublic, StripePricePublic, StripeProductPublic, StripeSubscriptionCancellationDetails, StripeSubscriptionPlan, StripeSubscriptionPublic, SubscriptionState, SubscriptionStatus, SupabaseConfig, Tables, TablesInsert, TablesUpdate };
+export { CheckoutStore, Currency, CustomerDashboardComponent, CustomerStore, EmbeddedCheckoutComponent, EmbeddedSubscriptionComponent, PaymentIntentsListComponent, PaymentIntentsTableComponent, PortalAccountStore, ProductItemButtonComponent, ProductListComponent, ProductsService, ProductsStore, ReturnPageComponent, STRIPE_CONFIG, SUPABASE_BROWSER_CLIENT, SUPABASE_CONFIG, StripeClientService, SubscriptionCardComponent, SubscriptionReturnPageComponent, SubscriptionsListComponent, SubscriptionsStore, SupabaseClientService, parsePaymentIntent, parseSubscription, provideNgxSupabaseStripeConfig, provideStripeConfig, provideSupabaseConfig };
+export type { CheckoutStatus, CompositeTypes, CustomerState, CustomerStatus, Database, FetchCatalogResult, ICheckoutSessionStatus, Json, NgxSupabaseStripeConfig, PaymentMethodEntity, PortalSessionResponse, PortalState, PortalStatus, ProductsStatus, StripeConfig, StripeCustomerPublic, StripePaymentIntentsPublic, StripePricePublic, StripeProductPublic, StripeSubscriptionCancellationDetails, StripeSubscriptionPlan, StripeSubscriptionPublic, SubscriptionState, SubscriptionStatus, SupabaseConfig, Tables, TablesInsert, TablesUpdate };