@wipperoz/wipperoz-core 1.0.2 → 1.0.4

package/dist/billing/index.d.ts

@@ -1,3 +1,4 @@
 export * from './services/tokenFormatter';
 export * from './services/accountCreditManager.service';
+export * from './services/stripePaymentMapper';
 //# sourceMappingURL=index.d.ts.map

package/dist/billing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC"}

package/dist/billing/index.js

@@ -3,4 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./services/tokenFormatter"), exports);
 tslib_1.__exportStar(require("./services/accountCreditManager.service"), exports);
+tslib_1.__exportStar(require("./services/stripePaymentMapper"), exports);
 //# sourceMappingURL=index.js.map

package/dist/billing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":";;;AAAA,oEAA0C;AAC1C,kFAAwD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":";;;AAAA,oEAA0C;AAC1C,kFAAwD;AACxD,yEAA+C"}

package/dist/billing/services/stripePaymentMapper.d.ts

@@ -0,0 +1,84 @@
+import { CurrencyEnum } from '@wipperoz/common-entities-account/dist/src';
+import { StripePaymentStatusEnum } from '../enums';
+import { StripePaymentDetails } from '../interfaces/stripePayment.interface';
+/**
+ * Minimal "Stripe-like" types so wipperoz-core does not depend directly on the Stripe SDK.
+ */
+export interface StripeCustomerLike {
+    id: string;
+    invoice_settings?: {
+        default_payment_method?: string | null;
+    } | null;
+}
+export interface StripePaymentIntentLike {
+    id: string;
+    status: string;
+    amount: number;
+    currency: string;
+    last_payment_error?: {
+        message?: string | null;
+    } | null;
+}
+export interface StripeBalanceTransactionLike {
+    fee?: number | null;
+}
+export interface StripePaymentMeta {
+    /**
+     * Number of tokens that were added for this payment.
+     */
+    tokensAdded: number;
+    /**
+     * Whether this payment was triggered automatically by auto top-up.
+     */
+    isAutoTopUp: boolean;
+    /**
+     * ISO timestamp when the payment record was created in our system.
+     * If omitted, the caller should set this separately on the persistence layer.
+     */
+    createdAt?: string;
+    /**
+     * ISO timestamp when the payment completed. If omitted, this will be derived
+     * from the mapped status (null for non-succeeded payments).
+     */
+    completedAt?: string | null;
+}
+export interface StripePaymentMappingInput {
+    customer: StripeCustomerLike;
+    paymentIntent: StripePaymentIntentLike;
+    /**
+     * Optional balance transaction used to derive stripeFeeCents.
+     */
+    balanceTransaction?: StripeBalanceTransactionLike | null;
+    /**
+     * Business metadata required by our model.
+     */
+    meta: StripePaymentMeta;
+}
+/**
+ * Map Stripe currency codes (lowercase) to our CurrencyEnum.
+ * Currently supports AUD and USD.
+ */
+export declare const mapStripeCurrencyToCurrencyEnum: (currency: string) => CurrencyEnum;
+/**
+ * Map Stripe payment_intent.status to our StripePaymentStatusEnum.
+ *
+ * - 'succeeded'        -> SUCCEEDED
+ * - clearly failed states -> FAILED
+ * - everything else (processing, requires_payment_method, etc.) -> PENDING
+ */
+export declare const mapStripeStatusToStripePaymentStatus: (status: string) => StripePaymentStatusEnum;
+/**
+ * Create a StripePaymentDetails object from Stripe customer/payment intent
+ * plus optional balance transaction and our own business metadata.
+ *
+ * This encodes the canonical mapping between Stripe fields and our platform model:
+ * - stripe.customerId                <- customer.id
+ * - paymentIntentId                  <- payment_intent.id
+ * - status                           <- payment_intent.status (mapped to enum)
+ * - amountCents                      <- payment_intent.amount
+ * - currency                         <- payment_intent.currency
+ * - stripeFeeCents                   <- balance_transaction.fee
+ * - failureReason                    <- payment_intent.last_payment_error.message
+ */
+export declare const mapStripeToStripePaymentDetails: (input: StripePaymentMappingInput) => StripePaymentDetails;
+//# sourceMappingURL=stripePaymentMapper.d.ts.map

package/dist/billing/services/stripePaymentMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripePaymentMapper.d.ts","sourceRoot":"","sources":["../../../src/billing/services/stripePaymentMapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,4CAA4C,CAAC;AAExE,OAAO,EAAC,uBAAuB,EAAC,MAAM,UAAU,CAAC;AACjD,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,CAAC,EAAE;QACjB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxC,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE;QACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,aAAa,EAAE,uBAAuB,CAAC;IACvC;;OAEG;IACH,kBAAkB,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACzD;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GAAI,UAAU,MAAM,KAAG,YAWlE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,QAAQ,MAAM,KAAG,uBAgBrE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,+BAA+B,GAAI,OAAO,yBAAyB,KAAG,oBA8BlF,CAAC"}

package/dist/billing/services/stripePaymentMapper.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapStripeToStripePaymentDetails = exports.mapStripeStatusToStripePaymentStatus = exports.mapStripeCurrencyToCurrencyEnum = void 0;
+const src_1 = require("@wipperoz/common-entities-account/dist/src");
+const enums_1 = require("../enums");
+/**
+ * Map Stripe currency codes (lowercase) to our CurrencyEnum.
+ * Currently supports AUD and USD.
+ */
+const mapStripeCurrencyToCurrencyEnum = (currency) => {
+    const normalized = currency.toLowerCase();
+    switch (normalized) {
+        case 'aud':
+            return src_1.CurrencyEnum.AUD;
+        case 'usd':
+            return src_1.CurrencyEnum.USD;
+        default:
+            throw new Error(`Unsupported Stripe currency: ${currency}`);
+    }
+};
+exports.mapStripeCurrencyToCurrencyEnum = mapStripeCurrencyToCurrencyEnum;
+/**
+ * Map Stripe payment_intent.status to our StripePaymentStatusEnum.
+ *
+ * - 'succeeded'        -> SUCCEEDED
+ * - clearly failed states -> FAILED
+ * - everything else (processing, requires_payment_method, etc.) -> PENDING
+ */
+const mapStripeStatusToStripePaymentStatus = (status) => {
+    const normalized = status.toLowerCase();
+    if (normalized === 'succeeded') {
+        return enums_1.StripePaymentStatusEnum.SUCCEEDED;
+    }
+    // Common failure-like states from Stripe
+    const failedLikeStatuses = new Set(['canceled', 'requires_payment_method', 'requires_action', 'requires_capture']);
+    if (failedLikeStatuses.has(normalized)) {
+        return enums_1.StripePaymentStatusEnum.FAILED;
+    }
+    // Fallback: treat everything else as pending (e.g. 'processing', 'requires_confirmation')
+    return enums_1.StripePaymentStatusEnum.PENDING;
+};
+exports.mapStripeStatusToStripePaymentStatus = mapStripeStatusToStripePaymentStatus;
+/**
+ * Create a StripePaymentDetails object from Stripe customer/payment intent
+ * plus optional balance transaction and our own business metadata.
+ *
+ * This encodes the canonical mapping between Stripe fields and our platform model:
+ * - stripe.customerId                <- customer.id
+ * - paymentIntentId                  <- payment_intent.id
+ * - status                           <- payment_intent.status (mapped to enum)
+ * - amountCents                      <- payment_intent.amount
+ * - currency                         <- payment_intent.currency
+ * - stripeFeeCents                   <- balance_transaction.fee
+ * - failureReason                    <- payment_intent.last_payment_error.message
+ */
+const mapStripeToStripePaymentDetails = (input) => {
+    const { customer, paymentIntent, balanceTransaction, meta } = input;
+    const statusEnum = (0, exports.mapStripeStatusToStripePaymentStatus)(paymentIntent.status);
+    const currencyEnum = (0, exports.mapStripeCurrencyToCurrencyEnum)(paymentIntent.currency);
+    const stripeFeeCents = balanceTransaction?.fee ?? 0;
+    const createdAt = meta.createdAt ?? new Date().toISOString();
+    const completedAt = meta.completedAt !== undefined
+        ? meta.completedAt
+        : statusEnum === enums_1.StripePaymentStatusEnum.SUCCEEDED
+            ? new Date().toISOString()
+            : null;
+    const failureReason = paymentIntent.last_payment_error?.message ?? undefined;
+    return {
+        paymentIntentId: paymentIntent.id,
+        stripeCustomerId: customer.id,
+        status: statusEnum,
+        amountCents: paymentIntent.amount,
+        currency: currencyEnum,
+        tokensAdded: meta.tokensAdded,
+        stripeFeeCents,
+        isAutoTopUp: meta.isAutoTopUp,
+        createdAt,
+        completedAt,
+        failureReason,
+    };
+};
+exports.mapStripeToStripePaymentDetails = mapStripeToStripePaymentDetails;
+//# sourceMappingURL=stripePaymentMapper.js.map

package/dist/billing/services/stripePaymentMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripePaymentMapper.js","sourceRoot":"","sources":["../../../src/billing/services/stripePaymentMapper.ts"],"names":[],"mappings":";;;AAAA,oEAAwE;AAExE,oCAAiD;AA6DjD;;;GAGG;AACI,MAAM,+BAA+B,GAAG,CAAC,QAAgB,EAAgB,EAAE;IAChF,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE1C,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,kBAAY,CAAC,GAAG,CAAC;QAC1B,KAAK,KAAK;YACR,OAAO,kBAAY,CAAC,GAAG,CAAC;QAC1B;YACE,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,+BAA+B,mCAW1C;AAEF;;;;;;GAMG;AACI,MAAM,oCAAoC,GAAG,CAAC,MAAc,EAA2B,EAAE;IAC9F,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAExC,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO,+BAAuB,CAAC,SAAS,CAAC;IAC3C,CAAC;IAED,yCAAyC;IACzC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAEnH,IAAI,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,+BAAuB,CAAC,MAAM,CAAC;IACxC,CAAC;IAED,0FAA0F;IAC1F,OAAO,+BAAuB,CAAC,OAAO,CAAC;AACzC,CAAC,CAAC;AAhBW,QAAA,oCAAoC,wCAgB/C;AAEF;;;;;;;;;;;;GAYG;AACI,MAAM,+BAA+B,GAAG,CAAC,KAAgC,EAAwB,EAAE;IACxG,MAAM,EAAC,QAAQ,EAAE,aAAa,EAAE,kBAAkB,EAAE,IAAI,EAAC,GAAG,KAAK,CAAC;IAElE,MAAM,UAAU,GAAG,IAAA,4CAAoC,EAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,IAAA,uCAA+B,EAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE7E,MAAM,cAAc,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7D,MAAM,WAAW,GACf,IAAI,CAAC,WAAW,KAAK,SAAS;QAC5B,CAAC,CAAC,IAAI,CAAC,WAAW;QAClB,CAAC,CAAC,UAAU,KAAK,+BAAuB,CAAC,SAAS;YAChD,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC1B,CAAC,CAAC,IAAI,CAAC;IAEb,MAAM,aAAa,GAAG,aAAa,CAAC,kBAAkB,EAAE,OAAO,IAAI,SAAS,CAAC;IAE7E,OAAO;QACL,eAAe,EAAE,aAAa,CAAC,EAAE;QACjC,gBAAgB,EAAE,QAAQ,CAAC,EAAE;QAC7B,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,aAAa,CAAC,MAAM;QACjC,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,cAAc;QACd,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS;QACT,WAAW;QACX,aAAa;KACd,CAAC;AACJ,CAAC,CAAC;AA9BW,QAAA,+BAA+B,mCA8B1C"}