rerobe-js-orm 4.9.5 → 4.9.7

package/lib/helpers/OrderHelpers.js

@@ -693,11 +693,12 @@ class OrderHelpers {
         }
         let info = additionalInfo;
         // Derive the return-policy line from the structured policy for the order's
-        // sales channel (legacy free-text policies pass through unchanged). Never
-        // shown on refund receipts.
+        // sales channel, localized to the receipt's presentment locale (legacy
+        // free-text policies pass through unchanged). Never shown on refund receipts.
+        const returnPolicyTemplate = translations_1.returnPolicyReceiptTranslations[presentmentLocale] || translations_1.returnPolicyReceiptTranslations['en-US'];
         const returnPolicyText = isRefund
             ? ''
-            : ReturnPolicyHelpers_1.default.returnPolicyReceiptText(returnPolicy, (_d = order.salesChannel) !== null && _d !== void 0 ? _d : undefined);
+            : ReturnPolicyHelpers_1.default.returnPolicyReceiptText(returnPolicy, (_d = order.salesChannel) !== null && _d !== void 0 ? _d : undefined, returnPolicyTemplate);
         if (returnPolicyText) {
             info = returnPolicyText;
             if (additionalInfo) {

package/lib/helpers/ReturnPolicyHelpers.d.ts

@@ -17,20 +17,23 @@ export default class ReturnPolicyHelpers {
         withinWindow: string;
     };
     private static normChannel;
+    private static effectiveWindowDays;
     static parse(raw: any): ReturnPolicy | null;
     static isConfigured(raw: any): boolean;
     static defaultPolicy(): ReturnPolicy;
     static channelKeyForSalesChannel(salesChannel: string): string | null;
     static getChannelPolicy(raw: any, salesChannel: string): ReturnPolicyChannel | null;
     static resolveSoldState(raw: any, salesChannel: string): string;
+    static getEffectiveWindowDays(raw: any, salesChannel: string): number;
     static getReturnWindowEndMillis(raw: any, salesChannel: string, soldAtMillis: number): number | null;
+    static getPayoutClearanceMillis(raw: any, salesChannel: string, soldAtMillis: number): number | null;
     static evaluateReturn({ raw, salesChannel, soldAtMillis, nowMillis, }: {
         raw: any;
         salesChannel: string;
         soldAtMillis?: number;
         nowMillis?: number;
     }): ReturnEvaluation;
-    static returnPolicyReceiptText(raw: any, salesChannel?: string): string;
+    static returnPolicyReceiptText(raw: any, salesChannel?: string, template?: string): string;
     static resolveEffectiveReturnPolicy({ ownPolicyRaw, marketplaceDefaultRaw, isManaged, }: {
         ownPolicyRaw?: any;
         marketplaceDefaultRaw?: any;

package/lib/helpers/ReturnPolicyHelpers.js

@@ -36,10 +36,20 @@ class ReturnPolicyHelpers {
             return { allowed: false, returnPeriodDays: 0 };
         }
         const days = Number(ch.returnPeriodDays);
-        return {
+        const buffer = Number(ch.bufferDays);
+        const out = {
             allowed: ch.allowed !== false,
             returnPeriodDays: days > 0 ? Math.floor(days) : 0,
         };
+        // Only persist a buffer when set, so existing no-buffer policies serialize
+        // (and compare) unchanged.
+        if (buffer > 0)
+            out.bufferDays = Math.floor(buffer);
+        return out;
+    }
+    // Total payout-hold days for a channel = nominal return period + buffer.
+    static effectiveWindowDays(channel) {
+        return (channel.returnPeriodDays || 0) + (channel.bufferDays || 0);
     }
     // Parse a raw stored value into a structured ReturnPolicy, or null when the
     // merchant has not configured a (structured) policy. Returns null for:
@@ -102,6 +112,14 @@ class ReturnPolicyHelpers {
     }
     // The instant (ms) a return window closes for a sale, or null when there's no
     // applicable window (no policy / not allowed / 0-day / no sale time).
+    // Effective window length (days) for a sale's channel, including the buffer.
+    // 0 when the channel has no allowed window.
+    static getEffectiveWindowDays(raw, salesChannel) {
+        const channel = this.getChannelPolicy(raw, salesChannel);
+        if (!channel || !channel.allowed || channel.returnPeriodDays <= 0)
+            return 0;
+        return this.effectiveWindowDays(channel);
+    }
     static getReturnWindowEndMillis(raw, salesChannel, soldAtMillis) {
         const channel = this.getChannelPolicy(raw, salesChannel);
         if (!channel || !channel.allowed || channel.returnPeriodDays <= 0)
@@ -109,7 +127,13 @@ class ReturnPolicyHelpers {
         const soldAt = Number(soldAtMillis);
         if (!(soldAt > 0))
             return null;
-        return soldAt + channel.returnPeriodDays * MS_PER_DAY;
+        return soldAt + this.effectiveWindowDays(channel) * MS_PER_DAY;
+    }
+    // The instant (ms) the seller payout becomes safe to release for a windowed
+    // SOLD item — return period + buffer from the sale. Same value as the window
+    // end; named for the payout-clearance caller. Null when there's no window.
+    static getPayoutClearanceMillis(raw, salesChannel, soldAtMillis) {
+        return this.getReturnWindowEndMillis(raw, salesChannel, soldAtMillis);
     }
     // Evaluate whether a return/refund should be permitted under the policy.
     // Conservative by design: when nothing is configured (no policy, unmapped
@@ -133,7 +157,7 @@ class ReturnPolicyHelpers {
         const soldAt = Number(soldAtMillis);
         if (!(soldAt > 0))
             return { allowed: true, reason: REASONS.noSoldTimestamp };
-        const windowEndMillis = soldAt + channel.returnPeriodDays * MS_PER_DAY;
+        const windowEndMillis = soldAt + this.effectiveWindowDays(channel) * MS_PER_DAY;
         const now = Number(nowMillis) > 0 ? Number(nowMillis) : Date.now();
         if (now <= windowEndMillis)
             return { allowed: true, reason: REASONS.withinWindow, windowEndMillis };
@@ -143,7 +167,12 @@ class ReturnPolicyHelpers {
     // unchanged. For a structured policy, prefer the sale's channel; without a
     // channel, summarize whichever channel(s) accept returns. Returns '' when
     // there's nothing meaningful to print (no policy, or returns not accepted).
-    static returnPolicyReceiptText(raw, salesChannel) {
+    // `template` is a per-locale format string with a `{days}` placeholder, e.g.
+    // "{days} day return policy" / "{days} dagars öppet köp". Defaults to English
+    // so non-receipt callers (admin preview) need not pass one; the receipt
+    // builder passes the localized template. Legacy free-text policies pass
+    // through unchanged (can't be localized).
+    static returnPolicyReceiptText(raw, salesChannel, template = '{days} day return policy') {
         if (typeof raw === 'string')
             return raw.trim();
         const policy = this.parse(raw);
@@ -152,7 +181,7 @@ class ReturnPolicyHelpers {
         const lineFor = (ch) => {
             if (!ch || !ch.allowed || ch.returnPeriodDays <= 0)
                 return '';
-            return `${ch.returnPeriodDays} day return policy`;
+            return template.replace('{days}', String(ch.returnPeriodDays));
         };
         if (salesChannel) {
             const key = this.channelKeyForSalesChannel(salesChannel);

package/lib/translations.d.ts

@@ -1,6 +1,9 @@
 export declare const receiptTranslations: {
     [key: string]: string;
 };
+export declare const returnPolicyReceiptTranslations: {
+    [key: string]: string;
+};
 export declare const totalTranslations: {
     [key: string]: string;
 };

package/lib/translations.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.originalReceiptTranslations = exports.refundPurchaseTranslations = exports.refundReceiptTranslations = exports.referenceTranslations = exports.contactlessTranslations = exports.authorizationCodeTranslations = exports.mobilePaymentTranslations = exports.cardPaymentTranslations = exports.cashTranslations = exports.purchaseTranslations = exports.taxTranslations = exports.totalTranslations = exports.receiptTranslations = void 0;
+exports.originalReceiptTranslations = exports.refundPurchaseTranslations = exports.refundReceiptTranslations = exports.referenceTranslations = exports.contactlessTranslations = exports.authorizationCodeTranslations = exports.mobilePaymentTranslations = exports.cardPaymentTranslations = exports.cashTranslations = exports.purchaseTranslations = exports.taxTranslations = exports.totalTranslations = exports.returnPolicyReceiptTranslations = exports.receiptTranslations = void 0;
 exports.receiptTranslations = {
     'sv-SE': 'Kvitto',
     'nb-NO': 'Kvittering',
@@ -8,6 +8,16 @@ exports.receiptTranslations = {
     'en-UK': 'Receipt',
     'en-DE': 'Quittung',
 };
+// Return-policy line on the receipt. `{days}` is replaced with the channel's
+// returnPeriodDays. Localized per presentment locale (en-DE renders German,
+// matching the other dicts).
+exports.returnPolicyReceiptTranslations = {
+    'sv-SE': '{days} dagars öppet köp',
+    'nb-NO': '{days} dagers åpent kjøp',
+    'en-US': '{days} day return policy',
+    'en-UK': '{days} day return policy',
+    'en-DE': '{days} Tage Rückgaberecht',
+};
 exports.totalTranslations = {
     'sv-SE': 'Totalt',
     'nb-NO': 'Total',

package/lib/types/merchant-types.d.ts

@@ -9,6 +9,7 @@ type SocialLinksType = {
 type ReturnPolicyChannel = {
     allowed: boolean;
     returnPeriodDays: number;
+    bufferDays?: number;
 };
 type ReturnPolicy = {
     IN_STORE: ReturnPolicyChannel;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rerobe-js-orm",
-  "version": "4.9.5",
+  "version": "4.9.7",
   "description": "ReRobe's Javascript ORM Framework",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",