@adtrackify/at-service-common 4.0.31 → 4.0.33

package/dist/cjs/__tests__/helpers/acuity-helper.spec.js

@@ -1,70 +1,70 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const at_tracking_event_types_1 = require("@adtrackify/at-tracking-event-types");
-const acuity_helper_1 = require("../../helpers/acuity-helper");
-describe('splitMultipleEmailAcuityContacts', () => {
-    it('splits a contact with multiple emails into one contact per email', () => {
-        const contacts = [
-            { id: 1, firstName: 'Jane', emails: [{ email: 'a@example.com' }, { email: 'b@example.com' }] },
-        ];
-        const result = (0, acuity_helper_1.splitMultipleEmailAcuityContacts)(contacts);
-        expect(result).toHaveLength(2);
-        expect(result.map((c) => c.email)).toEqual(['a@example.com', 'b@example.com']);
-        expect(result.every((c) => c.emails === undefined)).toBe(true);
-        expect(result[0].firstName).toBe('Jane');
-    });
-    it('keeps a contact that only has a root-level email', () => {
-        const contacts = [{ id: 2, email: 'p@example.com' }];
-        const result = (0, acuity_helper_1.splitMultipleEmailAcuityContacts)(contacts);
-        expect(result).toEqual(contacts);
-    });
-    it('drops a contact that has neither an emails array nor a root email', () => {
-        const contacts = [{ id: 3 }];
-        const result = (0, acuity_helper_1.splitMultipleEmailAcuityContacts)(contacts);
-        expect(result).toEqual([]);
-    });
-});
-describe('buildThirdPartyAcuityContact', () => {
-    it('maps an Acuity contact to the platform ThirdPartyContact shape', () => {
-        const contact = {
-            id: 1,
-            firstName: 'Jane',
-            lastName: 'Doe',
-            address: '1 Main St',
-            city: 'Austin',
-            state: 'TX',
-            zip: '78701',
-            phones: [{ phone: 5125550100 }],
-            email: 'jane@example.com',
-            emailVerification: {
-                state: at_tracking_event_types_1.EMAIL_STATUS.DELIVERABLE,
-                email: 'jane@example.com',
-            },
-        };
-        const result = (0, acuity_helper_1.buildThirdPartyAcuityContact)('px', 'id', 'sess', contact);
-        expect(result).toMatchObject({
-            source: at_tracking_event_types_1.CONTACT_ACQUISITION_SOURCE.AUDIENCE_ACUITY,
-            sourceId: at_tracking_event_types_1.CONTACT_SOURCE_ID.AUDIENCE_ACUITY,
-            firstName: 'Jane',
-            lastName: 'Doe',
-            address1: '1 Main St',
-            city: 'Austin',
-            state: 'TX',
-            postalCode: '78701',
-            mobilePhone1: '5125550100',
-            emailAddress: 'jane@example.com',
-            emailStatus: at_tracking_event_types_1.EMAIL_STATUS.DELIVERABLE,
-            pixelId: 'px',
-            identityId: 'id',
-            sessionId: 'sess',
-        });
-        expect(result?.id).toBeTruthy();
-    });
-    it('leaves optional fields undefined when the Acuity contact is sparse', () => {
-        const result = (0, acuity_helper_1.buildThirdPartyAcuityContact)('px', 'id', 'sess', { id: 2, email: 'a@b.com' });
-        expect(result?.emailAddress).toBe('a@b.com');
-        expect(result?.mobilePhone1).toBeUndefined();
-        expect(result?.firstName).toBeUndefined();
-    });
-});
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const at_tracking_event_types_1 = require("@adtrackify/at-tracking-event-types");
+const acuity_helper_1 = require("../../helpers/acuity-helper");
+describe('splitMultipleEmailAcuityContacts', () => {
+    it('splits a contact with multiple emails into one contact per email', () => {
+        const contacts = [
+            { id: 1, firstName: 'Jane', emails: [{ email: 'a@example.com' }, { email: 'b@example.com' }] },
+        ];
+        const result = (0, acuity_helper_1.splitMultipleEmailAcuityContacts)(contacts);
+        expect(result).toHaveLength(2);
+        expect(result.map((c) => c.email)).toEqual(['a@example.com', 'b@example.com']);
+        expect(result.every((c) => c.emails === undefined)).toBe(true);
+        expect(result[0].firstName).toBe('Jane');
+    });
+    it('keeps a contact that only has a root-level email', () => {
+        const contacts = [{ id: 2, email: 'p@example.com' }];
+        const result = (0, acuity_helper_1.splitMultipleEmailAcuityContacts)(contacts);
+        expect(result).toEqual(contacts);
+    });
+    it('drops a contact that has neither an emails array nor a root email', () => {
+        const contacts = [{ id: 3 }];
+        const result = (0, acuity_helper_1.splitMultipleEmailAcuityContacts)(contacts);
+        expect(result).toEqual([]);
+    });
+});
+describe('buildThirdPartyAcuityContact', () => {
+    it('maps an Acuity contact to the platform ThirdPartyContact shape', () => {
+        const contact = {
+            id: 1,
+            firstName: 'Jane',
+            lastName: 'Doe',
+            address: '1 Main St',
+            city: 'Austin',
+            state: 'TX',
+            zip: '78701',
+            phones: [{ phone: 5125550100 }],
+            email: 'jane@example.com',
+            emailVerification: {
+                state: at_tracking_event_types_1.EMAIL_STATUS.DELIVERABLE,
+                email: 'jane@example.com',
+            },
+        };
+        const result = (0, acuity_helper_1.buildThirdPartyAcuityContact)('px', 'id', 'sess', contact);
+        expect(result).toMatchObject({
+            source: at_tracking_event_types_1.CONTACT_ACQUISITION_SOURCE.AUDIENCE_ACUITY,
+            sourceId: at_tracking_event_types_1.CONTACT_SOURCE_ID.AUDIENCE_ACUITY,
+            firstName: 'Jane',
+            lastName: 'Doe',
+            address1: '1 Main St',
+            city: 'Austin',
+            state: 'TX',
+            postalCode: '78701',
+            mobilePhone1: '5125550100',
+            emailAddress: 'jane@example.com',
+            emailStatus: at_tracking_event_types_1.EMAIL_STATUS.DELIVERABLE,
+            pixelId: 'px',
+            identityId: 'id',
+            sessionId: 'sess',
+        });
+        expect(result?.id).toBeTruthy();
+    });
+    it('leaves optional fields undefined when the Acuity contact is sparse', () => {
+        const result = (0, acuity_helper_1.buildThirdPartyAcuityContact)('px', 'id', 'sess', { id: 2, email: 'a@b.com' });
+        expect(result?.emailAddress).toBe('a@b.com');
+        expect(result?.mobilePhone1).toBeUndefined();
+        expect(result?.firstName).toBeUndefined();
+    });
+});
 //# sourceMappingURL=acuity-helper.spec.js.map

package/dist/cjs/__tests__/helpers/api-key-auth-helper.spec.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/dist/cjs/__tests__/helpers/api-key-auth-helper.spec.js

@@ -1,83 +1,83 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-jest.mock('../../helpers/logging-helper', () => ({
-    Logger: { info: jest.fn(), warn: jest.fn(), error: jest.fn(), debug: jest.fn() },
-}));
-jest.mock('../../libs/http-error', () => ({
-    HttpError: {
-        unauthorized: () => Object.assign(new Error('Unauthorized'), { statusCode: 401 }),
-        forbidden: (msg) => Object.assign(new Error(msg), { statusCode: 403 }),
-    },
-}));
-const at_tracking_event_types_1 = require("@adtrackify/at-tracking-event-types");
-const api_key_auth_helper_1 = require("../../helpers/api-key-auth-helper");
-const makeEvent = (authorizer) => ({ requestContext: { authorizer } });
-describe('extractApiKeyAuth', () => {
-    it('returns pixelId, accountId, scopes, and apiKeyPk from authorizer context', () => {
-        const event = makeEvent({
-            pixelId: 'px_1',
-            accountId: 'acc_1',
-            apiKeyPk: 'px_1_abc',
-            scopes: 'analytics:read,dashboards:write',
-        });
-        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event)).toEqual({
-            pixelId: 'px_1',
-            accountId: 'acc_1',
-            apiKeyPk: 'px_1_abc',
-            scopes: ['analytics:read', 'dashboards:write'],
-        });
-    });
-    it('expands legacy db_query scope to analytics:read', () => {
-        const event = makeEvent({
-            pixelId: 'px_1',
-            accountId: 'acc_1',
-            apiKeyPk: 'px_1_abc',
-            scopes: 'db_query',
-        });
-        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ]);
-    });
-    it('expands legacy attribution_query scope to analytics:read', () => {
-        const event = makeEvent({
-            pixelId: 'px_1',
-            accountId: 'acc_1',
-            apiKeyPk: 'px_1_abc',
-            scopes: 'attribution_query',
-        });
-        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ]);
-    });
-    it('deduplicates when both legacy values are present', () => {
-        const event = makeEvent({
-            pixelId: 'px_1',
-            accountId: 'acc_1',
-            apiKeyPk: 'px_1_abc',
-            scopes: 'db_query,attribution_query',
-        });
-        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ]);
-    });
-    it('passes modern scopes through unchanged', () => {
-        const event = makeEvent({
-            pixelId: 'px_1',
-            accountId: 'acc_1',
-            apiKeyPk: 'px_1_abc',
-            scopes: 'analytics:read,dashboards:read,dashboards:write',
-        });
-        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual(['analytics:read', 'dashboards:read', 'dashboards:write']);
-    });
-    it('returns empty scopes array when scopes header is missing', () => {
-        const event = makeEvent({ pixelId: 'px_1', accountId: 'acc_1', apiKeyPk: 'px_1_abc' });
-        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([]);
-    });
-    it('throws Unauthorized when pixelId is missing from authorizer context', () => {
-        const event = makeEvent({ accountId: 'acc_1' });
-        expect(() => (0, api_key_auth_helper_1.extractApiKeyAuth)(event)).toThrow('Unauthorized');
-    });
-});
-describe('requireScope', () => {
-    it('allows when the required scope is present', () => {
-        expect(() => (0, api_key_auth_helper_1.requireScope)(['analytics:read', 'dashboards:read'], at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ)).not.toThrow();
-    });
-    it('throws Forbidden when the required scope is missing', () => {
-        expect(() => (0, api_key_auth_helper_1.requireScope)(['analytics:read'], at_tracking_event_types_1.API_KEY_SCOPE.DASHBOARDS_WRITE)).toThrow('API key does not have the dashboards:write scope');
-    });
-});
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock('../../helpers/logging-helper', () => ({
+    Logger: { info: jest.fn(), warn: jest.fn(), error: jest.fn(), debug: jest.fn() },
+}));
+jest.mock('../../libs/http-error', () => ({
+    HttpError: {
+        unauthorized: () => Object.assign(new Error('Unauthorized'), { statusCode: 401 }),
+        forbidden: (msg) => Object.assign(new Error(msg), { statusCode: 403 }),
+    },
+}));
+const at_tracking_event_types_1 = require("@adtrackify/at-tracking-event-types");
+const api_key_auth_helper_1 = require("../../helpers/api-key-auth-helper");
+const makeEvent = (authorizer) => ({ requestContext: { authorizer } });
+describe('extractApiKeyAuth', () => {
+    it('returns pixelId, accountId, scopes, and apiKeyPk from authorizer context', () => {
+        const event = makeEvent({
+            pixelId: 'px_1',
+            accountId: 'acc_1',
+            apiKeyPk: 'px_1_abc',
+            scopes: 'analytics:read,dashboards:write',
+        });
+        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event)).toEqual({
+            pixelId: 'px_1',
+            accountId: 'acc_1',
+            apiKeyPk: 'px_1_abc',
+            scopes: ['analytics:read', 'dashboards:write'],
+        });
+    });
+    it('expands legacy db_query scope to analytics:read', () => {
+        const event = makeEvent({
+            pixelId: 'px_1',
+            accountId: 'acc_1',
+            apiKeyPk: 'px_1_abc',
+            scopes: 'db_query',
+        });
+        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ]);
+    });
+    it('expands legacy attribution_query scope to analytics:read', () => {
+        const event = makeEvent({
+            pixelId: 'px_1',
+            accountId: 'acc_1',
+            apiKeyPk: 'px_1_abc',
+            scopes: 'attribution_query',
+        });
+        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ]);
+    });
+    it('deduplicates when both legacy values are present', () => {
+        const event = makeEvent({
+            pixelId: 'px_1',
+            accountId: 'acc_1',
+            apiKeyPk: 'px_1_abc',
+            scopes: 'db_query,attribution_query',
+        });
+        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ]);
+    });
+    it('passes modern scopes through unchanged', () => {
+        const event = makeEvent({
+            pixelId: 'px_1',
+            accountId: 'acc_1',
+            apiKeyPk: 'px_1_abc',
+            scopes: 'analytics:read,dashboards:read,dashboards:write',
+        });
+        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual(['analytics:read', 'dashboards:read', 'dashboards:write']);
+    });
+    it('returns empty scopes array when scopes header is missing', () => {
+        const event = makeEvent({ pixelId: 'px_1', accountId: 'acc_1', apiKeyPk: 'px_1_abc' });
+        expect((0, api_key_auth_helper_1.extractApiKeyAuth)(event).scopes).toEqual([]);
+    });
+    it('throws Unauthorized when pixelId is missing from authorizer context', () => {
+        const event = makeEvent({ accountId: 'acc_1' });
+        expect(() => (0, api_key_auth_helper_1.extractApiKeyAuth)(event)).toThrow('Unauthorized');
+    });
+});
+describe('requireScope', () => {
+    it('allows when the required scope is present', () => {
+        expect(() => (0, api_key_auth_helper_1.requireScope)(['analytics:read', 'dashboards:read'], at_tracking_event_types_1.API_KEY_SCOPE.ANALYTICS_READ)).not.toThrow();
+    });
+    it('throws Forbidden when the required scope is missing', () => {
+        expect(() => (0, api_key_auth_helper_1.requireScope)(['analytics:read'], at_tracking_event_types_1.API_KEY_SCOPE.DASHBOARDS_WRITE)).toThrow('API key does not have the dashboards:write scope');
+    });
+});
 //# sourceMappingURL=api-key-auth-helper.spec.js.map

package/dist/cjs/__tests__/helpers/cognito-auth-helper.spec.d.ts

@@ -1 +1 @@
-export {};
+export {};

package/dist/cjs/__tests__/helpers/cognito-auth-helper.spec.js

@@ -1,47 +1,47 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-jest.mock('../../libs/http-error', () => ({
-    HttpError: {
-        unauthorized: () => Object.assign(new Error('Unauthorized'), { statusCode: 401 }),
-    },
-}));
-const cognito_auth_helper_1 = require("../../helpers/cognito-auth-helper");
-const makeEvent = (claims) => ({
-    requestContext: {
-        authorizer: claims === undefined ? {} : claims === null ? { claims: null } : { claims },
-    },
-});
-describe('extractCognitoAuth', () => {
-    it('returns userId and email when both are present', () => {
-        const event = makeEvent({ sub: 'user-123', email: 'user@example.com' });
-        expect((0, cognito_auth_helper_1.extractCognitoAuth)(event)).toEqual({
-            userId: 'user-123',
-            email: 'user@example.com',
-        });
-    });
-    it('returns userId only when email is missing', () => {
-        const event = makeEvent({ sub: 'user-123' });
-        expect((0, cognito_auth_helper_1.extractCognitoAuth)(event)).toEqual({ userId: 'user-123' });
-    });
-    it('throws Unauthorized when sub is missing from claims', () => {
-        const event = makeEvent({ email: 'user@example.com' });
-        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
-    });
-    it('throws Unauthorized when claims are absent', () => {
-        const event = makeEvent(undefined);
-        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
-    });
-    it('throws Unauthorized when claims is null', () => {
-        const event = makeEvent(null);
-        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
-    });
-    it('throws Unauthorized when sub is not a string', () => {
-        const event = makeEvent({ sub: 12345 });
-        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
-    });
-    it('omits email when it is an empty string', () => {
-        const event = makeEvent({ sub: 'user-123', email: '' });
-        expect((0, cognito_auth_helper_1.extractCognitoAuth)(event)).toEqual({ userId: 'user-123' });
-    });
-});
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock('../../libs/http-error', () => ({
+    HttpError: {
+        unauthorized: () => Object.assign(new Error('Unauthorized'), { statusCode: 401 }),
+    },
+}));
+const cognito_auth_helper_1 = require("../../helpers/cognito-auth-helper");
+const makeEvent = (claims) => ({
+    requestContext: {
+        authorizer: claims === undefined ? {} : claims === null ? { claims: null } : { claims },
+    },
+});
+describe('extractCognitoAuth', () => {
+    it('returns userId and email when both are present', () => {
+        const event = makeEvent({ sub: 'user-123', email: 'user@example.com' });
+        expect((0, cognito_auth_helper_1.extractCognitoAuth)(event)).toEqual({
+            userId: 'user-123',
+            email: 'user@example.com',
+        });
+    });
+    it('returns userId only when email is missing', () => {
+        const event = makeEvent({ sub: 'user-123' });
+        expect((0, cognito_auth_helper_1.extractCognitoAuth)(event)).toEqual({ userId: 'user-123' });
+    });
+    it('throws Unauthorized when sub is missing from claims', () => {
+        const event = makeEvent({ email: 'user@example.com' });
+        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
+    });
+    it('throws Unauthorized when claims are absent', () => {
+        const event = makeEvent(undefined);
+        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
+    });
+    it('throws Unauthorized when claims is null', () => {
+        const event = makeEvent(null);
+        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
+    });
+    it('throws Unauthorized when sub is not a string', () => {
+        const event = makeEvent({ sub: 12345 });
+        expect(() => (0, cognito_auth_helper_1.extractCognitoAuth)(event)).toThrow('Unauthorized');
+    });
+    it('omits email when it is an empty string', () => {
+        const event = makeEvent({ sub: 'user-123', email: '' });
+        expect((0, cognito_auth_helper_1.extractCognitoAuth)(event)).toEqual({ userId: 'user-123' });
+    });
+});
 //# sourceMappingURL=cognito-auth-helper.spec.js.map

package/dist/cjs/__tests__/helpers/order-calculation-helper.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/__tests__/helpers/order-calculation-helper.spec.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const order_calculation_helper_1 = require("../../helpers/order-calculation-helper");
+jest.mock('../../helpers/logging-helper', () => ({
+    Logger: { debug: jest.fn(), info: jest.fn(), warn: jest.fn(), error: jest.fn() },
+}));
+const createOrder = (overrides = {}) => ({
+    id: 111,
+    currency: 'USD',
+    source_name: 'web',
+    created_at: '2026-06-01T00:00:00Z',
+    line_items: [],
+    refunds: [],
+    ...overrides,
+});
+const lineItem = (over = {}) => ({
+    id: 1,
+    product_id: 10,
+    variant_id: 20,
+    price: '10.00',
+    quantity: 2,
+    ...over,
+});
+describe('OrderCalculationHelper', () => {
+    beforeEach(() => jest.clearAllMocks());
+    afterEach(() => jest.restoreAllMocks());
+    describe('getGrossSalePrice', () => {
+        it('sums price * quantity across line items', () => {
+            const order = createOrder({
+                line_items: [lineItem({ price: '10', quantity: 2 }), lineItem({ price: '5', quantity: 1 })],
+            });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getGrossSalePrice(order)).toBe(25);
+        });
+        it('returns 0 for no line items', () => {
+            expect(order_calculation_helper_1.OrderCalculationHelper.getGrossSalePrice(createOrder())).toBe(0);
+        });
+        it('handles missing price gracefully', () => {
+            const order = createOrder({ line_items: [lineItem({ price: undefined, quantity: 2 })] });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getGrossSalePrice(order)).toBe(0);
+        });
+        it('handles missing quantity gracefully', () => {
+            const order = createOrder({ line_items: [lineItem({ price: '10', quantity: undefined })] });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getGrossSalePrice(order)).toBe(0);
+        });
+    });
+    describe('getTotalRefundsFromOrder', () => {
+        it('sums successful transaction amounts', () => {
+            const order = createOrder({
+                refunds: [
+                    {
+                        transactions: [
+                            { status: 'success', amount: '10.00' },
+                            { status: 'success', amount: '5.00' },
+                        ],
+                    },
+                ],
+            });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getTotalRefundsFromOrder(order)).toBe(15);
+        });
+        it('ignores non-success transactions', () => {
+            const order = createOrder({ refunds: [{ transactions: [{ status: 'failure', amount: '10.00' }] }] });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getTotalRefundsFromOrder(order)).toBe(0);
+        });
+        it('applies receipt exchange_rate (amount * rate / 100)', () => {
+            const order = createOrder({
+                refunds: [
+                    {
+                        transactions: [
+                            { status: 'success', amount: '100', receipt: { balance_transaction: { exchange_rate: 50 } } },
+                        ],
+                    },
+                ],
+            });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getTotalRefundsFromOrder(order)).toBe(50);
+        });
+        it('returns 0 when no refunds exist', () => {
+            const order = createOrder({ refunds: [] });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getTotalRefundsFromOrder(order)).toBe(0);
+        });
+        it('handles undefined refunds gracefully', () => {
+            const order = createOrder({ refunds: undefined });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getTotalRefundsFromOrder(order)).toBe(0);
+        });
+    });
+    describe('getNetSalePrice', () => {
+        it('net = gross - (refunds + discounts)', () => {
+            const order = createOrder({
+                line_items: [lineItem({ price: '10', quantity: 2 })],
+                total_discounts_set: { shop_money: { amount: '5' } },
+                refunds: [{ transactions: [{ status: 'success', amount: '3' }] }],
+            });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getNetSalePrice(order)).toBe(12);
+        });
+        it('returns undefined when gross is 0', () => {
+            const order = createOrder({ line_items: [] });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getNetSalePrice(order)).toBeUndefined();
+        });
+        it('handles missing discount set gracefully', () => {
+            const order = createOrder({
+                line_items: [lineItem({ price: '10', quantity: 2 })],
+                total_discounts_set: undefined,
+            });
+            expect(order_calculation_helper_1.OrderCalculationHelper.getNetSalePrice(order)).toBe(20);
+        });
+    });
+    describe('getLineItemsRefundInfo', () => {
+        it('allocates refund quantity + amount (subtotal + total_tax) per line item', () => {
+            const order = createOrder({
+                line_items: [lineItem({ id: 1 })],
+                refunds: [
+                    {
+                        transactions: [{ status: 'success', amount: '11' }],
+                        refund_line_items: [{ line_item_id: 1, quantity: 1, subtotal: '10', total_tax: '1' }],
+                    },
+                ],
+            });
+            const info = order_calculation_helper_1.OrderCalculationHelper.getLineItemsRefundInfo(order);
+            expect(info[1]).toEqual({ hasRefund: true, refundQuantity: 1, refundAmount: 11 });
+        });
+        it('initializes all line items with zero refund info', () => {
+            const order = createOrder({
+                line_items: [lineItem({ id: 1 }), lineItem({ id: 2 })],
+                refunds: [],
+            });
+            const info = order_calculation_helper_1.OrderCalculationHelper.getLineItemsRefundInfo(order);
+            expect(info[1]).toEqual({ hasRefund: false, refundQuantity: 0, refundAmount: 0 });
+            expect(info[2]).toEqual({ hasRefund: false, refundQuantity: 0, refundAmount: 0 });
+        });
+        it('handles multiple refunds for the same line item', () => {
+            const order = createOrder({
+                line_items: [lineItem({ id: 1 })],
+                refunds: [
+                    {
+                        transactions: [{ status: 'success', amount: '5' }],
+                        refund_line_items: [{ line_item_id: 1, quantity: 1, subtotal: '5', total_tax: '0' }],
+                    },
+                    {
+                        transactions: [{ status: 'success', amount: '3' }],
+                        refund_line_items: [{ line_item_id: 1, quantity: 1, subtotal: '3', total_tax: '0' }],
+                    },
+                ],
+            });
+            const info = order_calculation_helper_1.OrderCalculationHelper.getLineItemsRefundInfo(order);
+            expect(info[1]).toEqual({ hasRefund: true, refundQuantity: 2, refundAmount: 8 });
+        });
+        it('returns empty object for order with no line items', () => {
+            const order = createOrder({ line_items: [] });
+            const info = order_calculation_helper_1.OrderCalculationHelper.getLineItemsRefundInfo(order);
+            expect(info).toEqual({});
+        });
+    });
+});
+//# sourceMappingURL=order-calculation-helper.spec.js.map

package/dist/cjs/__tests__/helpers/order-calculation-helper.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-calculation-helper.spec.js","sourceRoot":"","sources":["../../../../src/__tests__/helpers/order-calculation-helper.spec.ts"],"names":[],"mappings":"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"}

package/dist/cjs/__tests__/helpers/public-api-response-helper.spec.d.ts

@@ -1 +1 @@
-export {};
+export {};