@adtrackify/at-service-common 4.0.31 → 4.0.32

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/public-api-response-helper.spec.d.ts

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

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

@@ -1,61 +1,61 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const joi_1 = __importDefault(require("joi"));
-const public_api_response_helper_js_1 = require("../../helpers/public-api-response-helper.js");
-const http_error_js_1 = require("../../libs/http-error.js");
-const public_api_types_js_1 = require("../../types/public-api-types.js");
-const REQ = 'req_1';
-describe('public-api-response-helper - unit', () => {
-    it('apiSuccess returns 200 with requestId, body, and x-request-id header', () => {
-        const res = (0, public_api_response_helper_js_1.apiSuccess)(REQ, { eventsIngested: 3 });
-        expect(res.statusCode).toBe(200);
-        expect(JSON.parse(res.body)).toEqual({ requestId: REQ, eventsIngested: 3 });
-        expect(res.headers?.['x-request-id']).toBe(REQ);
-    });
-    it.each([
-        [public_api_types_js_1.API_ERROR_CODE.VALIDATION_ERROR, 400],
-        [public_api_types_js_1.API_ERROR_CODE.UNAUTHORIZED, 401],
-        [public_api_types_js_1.API_ERROR_CODE.FORBIDDEN, 403],
-        [public_api_types_js_1.API_ERROR_CODE.NOT_FOUND, 404],
-        [public_api_types_js_1.API_ERROR_CODE.PAYLOAD_TOO_LARGE, 413],
-        [public_api_types_js_1.API_ERROR_CODE.RATE_LIMITED, 429],
-        [public_api_types_js_1.API_ERROR_CODE.INTERNAL_ERROR, 500],
-    ])('apiError maps %s → HTTP %i with a uniform envelope', (code, status) => {
-        const res = (0, public_api_response_helper_js_1.apiError)(REQ, code, 'boom');
-        const body = JSON.parse(res.body);
-        expect(res.statusCode).toBe(status);
-        expect(body).toEqual({ requestId: REQ, message: 'boom', error: { code, message: 'boom' } });
-        expect(res.headers?.['x-request-id']).toBe(REQ);
-    });
-    it('apiError includes details only when provided', () => {
-        const details = [{ index: 0, field: 'name', message: 'required' }];
-        const body = JSON.parse((0, public_api_response_helper_js_1.apiError)(REQ, public_api_types_js_1.API_ERROR_CODE.VALIDATION_ERROR, 'bad', details).body);
-        expect(body.error.details).toEqual(details);
-    });
-    it('validationDetails flattens Joi errors to {index, field, message}', () => {
-        const schema = joi_1.default.object({ events: joi_1.default.array().items(joi_1.default.object({ name: joi_1.default.string().required() })) });
-        const { error } = schema.validate({ events: [{}, {}] }, { abortEarly: false });
-        const details = (0, public_api_response_helper_js_1.validationDetails)(error);
-        expect(details).toEqual(expect.arrayContaining([
-            expect.objectContaining({ index: 0, field: 'events.name' }),
-            expect.objectContaining({ index: 1, field: 'events.name' }),
-        ]));
-    });
-    it('apiErrorFromThrown maps an HttpError by status and exposes its message on 4xx', () => {
-        const res = (0, public_api_response_helper_js_1.apiErrorFromThrown)(REQ, http_error_js_1.HttpError.forbidden('no scope'));
-        const body = JSON.parse(res.body);
-        expect(res.statusCode).toBe(403);
-        expect(body.error.code).toBe(public_api_types_js_1.API_ERROR_CODE.FORBIDDEN);
-        expect(body.message).toBe('no scope');
-    });
-    it('apiErrorFromThrown never leaks internals on unknown errors', () => {
-        const res = (0, public_api_response_helper_js_1.apiErrorFromThrown)(REQ, new Error('secret stack detail'));
-        expect(res.statusCode).toBe(500);
-        expect(JSON.parse(res.body).error.code).toBe(public_api_types_js_1.API_ERROR_CODE.INTERNAL_ERROR);
-        expect(res.body).not.toContain('secret stack detail');
-    });
-});
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const joi_1 = __importDefault(require("joi"));
+const public_api_response_helper_js_1 = require("../../helpers/public-api-response-helper.js");
+const http_error_js_1 = require("../../libs/http-error.js");
+const public_api_types_js_1 = require("../../types/public-api-types.js");
+const REQ = 'req_1';
+describe('public-api-response-helper - unit', () => {
+    it('apiSuccess returns 200 with requestId, body, and x-request-id header', () => {
+        const res = (0, public_api_response_helper_js_1.apiSuccess)(REQ, { eventsIngested: 3 });
+        expect(res.statusCode).toBe(200);
+        expect(JSON.parse(res.body)).toEqual({ requestId: REQ, eventsIngested: 3 });
+        expect(res.headers?.['x-request-id']).toBe(REQ);
+    });
+    it.each([
+        [public_api_types_js_1.API_ERROR_CODE.VALIDATION_ERROR, 400],
+        [public_api_types_js_1.API_ERROR_CODE.UNAUTHORIZED, 401],
+        [public_api_types_js_1.API_ERROR_CODE.FORBIDDEN, 403],
+        [public_api_types_js_1.API_ERROR_CODE.NOT_FOUND, 404],
+        [public_api_types_js_1.API_ERROR_CODE.PAYLOAD_TOO_LARGE, 413],
+        [public_api_types_js_1.API_ERROR_CODE.RATE_LIMITED, 429],
+        [public_api_types_js_1.API_ERROR_CODE.INTERNAL_ERROR, 500],
+    ])('apiError maps %s → HTTP %i with a uniform envelope', (code, status) => {
+        const res = (0, public_api_response_helper_js_1.apiError)(REQ, code, 'boom');
+        const body = JSON.parse(res.body);
+        expect(res.statusCode).toBe(status);
+        expect(body).toEqual({ requestId: REQ, message: 'boom', error: { code, message: 'boom' } });
+        expect(res.headers?.['x-request-id']).toBe(REQ);
+    });
+    it('apiError includes details only when provided', () => {
+        const details = [{ index: 0, field: 'name', message: 'required' }];
+        const body = JSON.parse((0, public_api_response_helper_js_1.apiError)(REQ, public_api_types_js_1.API_ERROR_CODE.VALIDATION_ERROR, 'bad', details).body);
+        expect(body.error.details).toEqual(details);
+    });
+    it('validationDetails flattens Joi errors to {index, field, message}', () => {
+        const schema = joi_1.default.object({ events: joi_1.default.array().items(joi_1.default.object({ name: joi_1.default.string().required() })) });
+        const { error } = schema.validate({ events: [{}, {}] }, { abortEarly: false });
+        const details = (0, public_api_response_helper_js_1.validationDetails)(error);
+        expect(details).toEqual(expect.arrayContaining([
+            expect.objectContaining({ index: 0, field: 'events.name' }),
+            expect.objectContaining({ index: 1, field: 'events.name' }),
+        ]));
+    });
+    it('apiErrorFromThrown maps an HttpError by status and exposes its message on 4xx', () => {
+        const res = (0, public_api_response_helper_js_1.apiErrorFromThrown)(REQ, http_error_js_1.HttpError.forbidden('no scope'));
+        const body = JSON.parse(res.body);
+        expect(res.statusCode).toBe(403);
+        expect(body.error.code).toBe(public_api_types_js_1.API_ERROR_CODE.FORBIDDEN);
+        expect(body.message).toBe('no scope');
+    });
+    it('apiErrorFromThrown never leaks internals on unknown errors', () => {
+        const res = (0, public_api_response_helper_js_1.apiErrorFromThrown)(REQ, new Error('secret stack detail'));
+        expect(res.statusCode).toBe(500);
+        expect(JSON.parse(res.body).error.code).toBe(public_api_types_js_1.API_ERROR_CODE.INTERNAL_ERROR);
+        expect(res.body).not.toContain('secret stack detail');
+    });
+});
 //# sourceMappingURL=public-api-response-helper.spec.js.map

package/dist/cjs/__tests__/identity-cache/helpers.spec.d.ts

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