@adtrackify/at-service-common 4.0.23 → 4.0.24

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

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

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

@@ -0,0 +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');
+    });
+});
+//# sourceMappingURL=public-api-response-helper.spec.js.map

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

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

package/dist/cjs/helpers/index.d.ts

@@ -1,6 +1,7 @@
 export * from './input-validation-helper.js';
 export * from './logging-helper.js';
 export * from './response-helper.js';
+export * from './public-api-response-helper.js';
 export * from './shopify-helper.js';
 export * from './account-users-helper.js';
 export * from './sqs-utils.js';

package/dist/cjs/helpers/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./input-validation-helper.js"), exports);
 __exportStar(require("./logging-helper.js"), exports);
 __exportStar(require("./response-helper.js"), exports);
+__exportStar(require("./public-api-response-helper.js"), exports);
 __exportStar(require("./shopify-helper.js"), exports);
 __exportStar(require("./account-users-helper.js"), exports);
 __exportStar(require("./sqs-utils.js"), exports);

package/dist/cjs/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,sDAAoC;AACpC,uDAAqC;AACrC,sDAAoC;AACpC,4DAA0C;AAC1C,iDAA+B;AAC/B,2DAAyC;AACzC,iEAA+C;AAC/C,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,sDAAoC;AACpC,uDAAqC;AACrC,kEAAgD;AAChD,sDAAoC;AACpC,4DAA0C;AAC1C,iDAA+B;AAC/B,2DAAyC;AACzC,iEAA+C;AAC/C,qDAAmC"}

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

@@ -0,0 +1,21 @@
+import type { ValidationError } from 'joi';
+import { API_ERROR_CODE, ApiErrorDetail } from '../types/public-api-types.js';
+export declare const apiSuccess: <T extends object>(requestId: string, body: T) => {
+    statusCode: number;
+    headers: any;
+    multiValueHeaders: {};
+    body: string;
+};
+export declare const apiError: (requestId: string, code: API_ERROR_CODE, message: string, details?: ApiErrorDetail[]) => {
+    statusCode: number;
+    headers: any;
+    multiValueHeaders: {};
+    body: string;
+};
+export declare const validationDetails: (error: ValidationError) => ApiErrorDetail[];
+export declare const apiErrorFromThrown: (requestId: string, error: unknown) => {
+    statusCode: number;
+    headers: any;
+    multiValueHeaders: {};
+    body: string;
+};

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

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiErrorFromThrown = exports.validationDetails = exports.apiError = exports.apiSuccess = void 0;
+const http_error_js_1 = require("../libs/http-error.js");
+const public_api_types_js_1 = require("../types/public-api-types.js");
+const response_helper_js_1 = require("./response-helper.js");
+const STATUS_BY_CODE = {
+    [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,
+};
+const CODE_BY_STATUS = {
+    400: public_api_types_js_1.API_ERROR_CODE.VALIDATION_ERROR,
+    401: public_api_types_js_1.API_ERROR_CODE.UNAUTHORIZED,
+    403: public_api_types_js_1.API_ERROR_CODE.FORBIDDEN,
+    404: public_api_types_js_1.API_ERROR_CODE.NOT_FOUND,
+    413: public_api_types_js_1.API_ERROR_CODE.PAYLOAD_TOO_LARGE,
+    429: public_api_types_js_1.API_ERROR_CODE.RATE_LIMITED,
+};
+const apiSuccess = (requestId, body) => (0, response_helper_js_1.buildResponse)(200, { requestId, ...body }, { 'x-request-id': requestId });
+exports.apiSuccess = apiSuccess;
+const apiError = (requestId, code, message, details) => {
+    const error = details?.length ? { code, message, details } : { code, message };
+    return (0, response_helper_js_1.buildResponse)(STATUS_BY_CODE[code], { requestId, message, error }, { 'x-request-id': requestId });
+};
+exports.apiError = apiError;
+const validationDetails = (error) => error.details.map((detail) => {
+    const index = detail.path.find((segment) => typeof segment === 'number');
+    const field = detail.path.filter((segment) => typeof segment === 'string').join('.') || undefined;
+    return { index, field, message: detail.message };
+});
+exports.validationDetails = validationDetails;
+const apiErrorFromThrown = (requestId, error) => {
+    if (error instanceof http_error_js_1.HttpError) {
+        const code = CODE_BY_STATUS[error.statusCode] ?? public_api_types_js_1.API_ERROR_CODE.INTERNAL_ERROR;
+        const message = code === public_api_types_js_1.API_ERROR_CODE.INTERNAL_ERROR ? 'Internal server error.' : error.message;
+        return (0, exports.apiError)(requestId, code, message);
+    }
+    return (0, exports.apiError)(requestId, public_api_types_js_1.API_ERROR_CODE.INTERNAL_ERROR, 'Internal server error.');
+};
+exports.apiErrorFromThrown = apiErrorFromThrown;
+//# sourceMappingURL=public-api-response-helper.js.map

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

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

package/dist/cjs/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from './internal-events/index.js';
 export * from './acuity-types.js';
+export * from './public-api-types.js';
 import * as ShopifyRest from './shopify-rest-types.js';
 export { ShopifyRest };

package/dist/cjs/types/index.js

@@ -29,6 +29,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ShopifyRest = void 0;
 __exportStar(require("./internal-events/index.js"), exports);
 __exportStar(require("./acuity-types.js"), exports);
+__exportStar(require("./public-api-types.js"), exports);
 const ShopifyRest = __importStar(require("./shopify-rest-types.js"));
 exports.ShopifyRest = ShopifyRest;
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,oDAAkC;AAGlC,qEAAuD;AAC9C,kCAAW"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,oDAAkC;AAClC,wDAAsC;AAGtC,qEAAuD;AAC9C,kCAAW"}

package/dist/cjs/types/public-api-types.d.ts

@@ -0,0 +1,24 @@
+export declare enum API_ERROR_CODE {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    NOT_FOUND = "NOT_FOUND",
+    PAYLOAD_TOO_LARGE = "PAYLOAD_TOO_LARGE",
+    RATE_LIMITED = "RATE_LIMITED",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+export interface ApiErrorDetail {
+    index?: number;
+    field?: string;
+    message: string;
+}
+export interface ApiError {
+    code: API_ERROR_CODE;
+    message: string;
+    details?: ApiErrorDetail[];
+}
+export interface ApiErrorResponse {
+    requestId: string;
+    message: string;
+    error: ApiError;
+}

package/dist/cjs/types/public-api-types.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.API_ERROR_CODE = void 0;
+var API_ERROR_CODE;
+(function (API_ERROR_CODE) {
+    API_ERROR_CODE["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    API_ERROR_CODE["UNAUTHORIZED"] = "UNAUTHORIZED";
+    API_ERROR_CODE["FORBIDDEN"] = "FORBIDDEN";
+    API_ERROR_CODE["NOT_FOUND"] = "NOT_FOUND";
+    API_ERROR_CODE["PAYLOAD_TOO_LARGE"] = "PAYLOAD_TOO_LARGE";
+    API_ERROR_CODE["RATE_LIMITED"] = "RATE_LIMITED";
+    API_ERROR_CODE["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(API_ERROR_CODE = exports.API_ERROR_CODE || (exports.API_ERROR_CODE = {}));
+//# sourceMappingURL=public-api-types.js.map

package/dist/cjs/types/public-api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-types.js","sourceRoot":"","sources":["../../../src/types/public-api-types.ts"],"names":[],"mappings":";;;AAAA,IAAY,cAQX;AARD,WAAY,cAAc;IACxB,uDAAqC,CAAA;IACrC,+CAA6B,CAAA;IAC7B,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,yDAAuC,CAAA;IACvC,+CAA6B,CAAA;IAC7B,mDAAiC,CAAA;AACnC,CAAC,EARW,cAAc,GAAd,sBAAc,KAAd,sBAAc,QAQzB"}

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

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

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

@@ -0,0 +1,56 @@
+import Joi from 'joi';
+import { apiError, apiErrorFromThrown, apiSuccess, validationDetails } from '../../helpers/public-api-response-helper.js';
+import { HttpError } from '../../libs/http-error.js';
+import { API_ERROR_CODE } from '../../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 = 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([
+        [API_ERROR_CODE.VALIDATION_ERROR, 400],
+        [API_ERROR_CODE.UNAUTHORIZED, 401],
+        [API_ERROR_CODE.FORBIDDEN, 403],
+        [API_ERROR_CODE.NOT_FOUND, 404],
+        [API_ERROR_CODE.PAYLOAD_TOO_LARGE, 413],
+        [API_ERROR_CODE.RATE_LIMITED, 429],
+        [API_ERROR_CODE.INTERNAL_ERROR, 500],
+    ])('apiError maps %s → HTTP %i with a uniform envelope', (code, status) => {
+        const res = 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(apiError(REQ, 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.object({ events: Joi.array().items(Joi.object({ name: Joi.string().required() })) });
+        const { error } = schema.validate({ events: [{}, {}] }, { abortEarly: false });
+        const details = 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 = apiErrorFromThrown(REQ, HttpError.forbidden('no scope'));
+        const body = JSON.parse(res.body);
+        expect(res.statusCode).toBe(403);
+        expect(body.error.code).toBe(API_ERROR_CODE.FORBIDDEN);
+        expect(body.message).toBe('no scope');
+    });
+    it('apiErrorFromThrown never leaks internals on unknown errors', () => {
+        const res = apiErrorFromThrown(REQ, new Error('secret stack detail'));
+        expect(res.statusCode).toBe(500);
+        expect(JSON.parse(res.body).error.code).toBe(API_ERROR_CODE.INTERNAL_ERROR);
+        expect(res.body).not.toContain('secret stack detail');
+    });
+});
+//# sourceMappingURL=public-api-response-helper.spec.js.map

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

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

package/dist/esm/helpers/index.d.ts

@@ -1,6 +1,7 @@
 export * from './input-validation-helper.js';
 export * from './logging-helper.js';
 export * from './response-helper.js';
+export * from './public-api-response-helper.js';
 export * from './shopify-helper.js';
 export * from './account-users-helper.js';
 export * from './sqs-utils.js';

package/dist/esm/helpers/index.js

@@ -1,6 +1,7 @@
 export * from './input-validation-helper.js';
 export * from './logging-helper.js';
 export * from './response-helper.js';
+export * from './public-api-response-helper.js';
 export * from './shopify-helper.js';
 export * from './account-users-helper.js';
 export * from './sqs-utils.js';

package/dist/esm/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC"}

package/dist/esm/helpers/public-api-response-helper.d.ts

@@ -0,0 +1,21 @@
+import type { ValidationError } from 'joi';
+import { API_ERROR_CODE, ApiErrorDetail } from '../types/public-api-types.js';
+export declare const apiSuccess: <T extends object>(requestId: string, body: T) => {
+    statusCode: number;
+    headers: any;
+    multiValueHeaders: {};
+    body: string;
+};
+export declare const apiError: (requestId: string, code: API_ERROR_CODE, message: string, details?: ApiErrorDetail[]) => {
+    statusCode: number;
+    headers: any;
+    multiValueHeaders: {};
+    body: string;
+};
+export declare const validationDetails: (error: ValidationError) => ApiErrorDetail[];
+export declare const apiErrorFromThrown: (requestId: string, error: unknown) => {
+    statusCode: number;
+    headers: any;
+    multiValueHeaders: {};
+    body: string;
+};

package/dist/esm/helpers/public-api-response-helper.js

@@ -0,0 +1,39 @@
+import { HttpError } from '../libs/http-error.js';
+import { API_ERROR_CODE } from '../types/public-api-types.js';
+import { buildResponse } from './response-helper.js';
+const STATUS_BY_CODE = {
+    [API_ERROR_CODE.VALIDATION_ERROR]: 400,
+    [API_ERROR_CODE.UNAUTHORIZED]: 401,
+    [API_ERROR_CODE.FORBIDDEN]: 403,
+    [API_ERROR_CODE.NOT_FOUND]: 404,
+    [API_ERROR_CODE.PAYLOAD_TOO_LARGE]: 413,
+    [API_ERROR_CODE.RATE_LIMITED]: 429,
+    [API_ERROR_CODE.INTERNAL_ERROR]: 500,
+};
+const CODE_BY_STATUS = {
+    400: API_ERROR_CODE.VALIDATION_ERROR,
+    401: API_ERROR_CODE.UNAUTHORIZED,
+    403: API_ERROR_CODE.FORBIDDEN,
+    404: API_ERROR_CODE.NOT_FOUND,
+    413: API_ERROR_CODE.PAYLOAD_TOO_LARGE,
+    429: API_ERROR_CODE.RATE_LIMITED,
+};
+export const apiSuccess = (requestId, body) => buildResponse(200, { requestId, ...body }, { 'x-request-id': requestId });
+export const apiError = (requestId, code, message, details) => {
+    const error = details?.length ? { code, message, details } : { code, message };
+    return buildResponse(STATUS_BY_CODE[code], { requestId, message, error }, { 'x-request-id': requestId });
+};
+export const validationDetails = (error) => error.details.map((detail) => {
+    const index = detail.path.find((segment) => typeof segment === 'number');
+    const field = detail.path.filter((segment) => typeof segment === 'string').join('.') || undefined;
+    return { index, field, message: detail.message };
+});
+export const apiErrorFromThrown = (requestId, error) => {
+    if (error instanceof HttpError) {
+        const code = CODE_BY_STATUS[error.statusCode] ?? API_ERROR_CODE.INTERNAL_ERROR;
+        const message = code === API_ERROR_CODE.INTERNAL_ERROR ? 'Internal server error.' : error.message;
+        return apiError(requestId, code, message);
+    }
+    return apiError(requestId, API_ERROR_CODE.INTERNAL_ERROR, 'Internal server error.');
+};
+//# sourceMappingURL=public-api-response-helper.js.map

package/dist/esm/helpers/public-api-response-helper.js.map

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

package/dist/esm/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from './internal-events/index.js';
 export * from './acuity-types.js';
+export * from './public-api-types.js';
 import * as ShopifyRest from './shopify-rest-types.js';
 export { ShopifyRest };

package/dist/esm/types/index.js

@@ -1,5 +1,6 @@
 export * from './internal-events/index.js';
 export * from './acuity-types.js';
+export * from './public-api-types.js';
 import * as ShopifyRest from './shopify-rest-types.js';
 export { ShopifyRest };
 //# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAGlC,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/esm/types/public-api-types.d.ts

@@ -0,0 +1,24 @@
+export declare enum API_ERROR_CODE {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    NOT_FOUND = "NOT_FOUND",
+    PAYLOAD_TOO_LARGE = "PAYLOAD_TOO_LARGE",
+    RATE_LIMITED = "RATE_LIMITED",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+export interface ApiErrorDetail {
+    index?: number;
+    field?: string;
+    message: string;
+}
+export interface ApiError {
+    code: API_ERROR_CODE;
+    message: string;
+    details?: ApiErrorDetail[];
+}
+export interface ApiErrorResponse {
+    requestId: string;
+    message: string;
+    error: ApiError;
+}

package/dist/esm/types/public-api-types.js

@@ -0,0 +1,11 @@
+export var API_ERROR_CODE;
+(function (API_ERROR_CODE) {
+    API_ERROR_CODE["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    API_ERROR_CODE["UNAUTHORIZED"] = "UNAUTHORIZED";
+    API_ERROR_CODE["FORBIDDEN"] = "FORBIDDEN";
+    API_ERROR_CODE["NOT_FOUND"] = "NOT_FOUND";
+    API_ERROR_CODE["PAYLOAD_TOO_LARGE"] = "PAYLOAD_TOO_LARGE";
+    API_ERROR_CODE["RATE_LIMITED"] = "RATE_LIMITED";
+    API_ERROR_CODE["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(API_ERROR_CODE || (API_ERROR_CODE = {}));
+//# sourceMappingURL=public-api-types.js.map

package/dist/esm/types/public-api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-types.js","sourceRoot":"","sources":["../../../src/types/public-api-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAQX;AARD,WAAY,cAAc;IACxB,uDAAqC,CAAA;IACrC,+CAA6B,CAAA;IAC7B,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,yDAAuC,CAAA;IACvC,+CAA6B,CAAA;IAC7B,mDAAiC,CAAA;AACnC,CAAC,EARW,cAAc,KAAd,cAAc,QAQzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adtrackify/at-service-common",
-  "version": "4.0.23",
+  "version": "4.0.24",
   "description": "",
   "files": [
     "dist/*"