@modainteract/moda-interact-shared 2.5.0 → 2.5.1

package/README.md

@@ -31,6 +31,8 @@ necessarily a supported package subpath. Type-only exports require `import type`
 | `/billing` | Billing plan/usage contracts, provider-status normalization, subscription-reconciliation jobs, purchased-credit counters and deterministic billing identifiers. |
 | `/recovery-policy` | Recovery offer modes and validation of an already-resolved effective recovery policy. Does not retrieve or decide merchant entitlements. |
 | `/whatsapp` | Normalized inbound WhatsApp content/message schemas and parsers. Provider delivery statuses are in `/billing`. |
+| `/whatsapp-template-events` | ARCH-047 v2 Meta template-status observations: strict nine-field schema and pure occurrence UUID v4 event/job ID formatters. |
+| `/whatsapp-template-events/fixtures` | Portable JSON golden vectors for v2 status observations and expected BullMQ job IDs. |
 | `/merchant-communications` | Merchant communication and translation job contracts, constants and validation. |
 | `/merchant-communications/node` | Node-only deterministic translation queue-job identifiers. |
 | `/shopify` | Shopify commerce/recovery event schemas, parsers, event versions and shared queue contracts. |
@@ -1659,6 +1661,40 @@ Type-only exports:
 
 </details>
 
+<details>
+<summary>/whatsapp-template-events — 6 runtime exports, 1 type</summary>
+
+Import: `@modainteract/moda-interact-shared/whatsapp-template-events`.
+
+From [src/whatsapp-template-events.ts](src/whatsapp-template-events.ts):
+
+Runtime exports:
+
+- `META_TEMPLATE_STATUS_QUEUE`
+- `META_TEMPLATE_STATUS_JOB`
+- `META_TEMPLATE_STATUS_SCHEMA_VERSION`
+- `MetaTemplateStatusObservationV2Schema`
+- `formatMetaTemplateStatusEventIdentity`
+- `formatMetaTemplateStatusJobId`
+
+Type-only export:
+
+- `MetaTemplateStatusObservationV2`
+
+Messaging must verify the complete webhook batch **before** generating a fresh
+cryptographically random UUID v4 for every matching observation. Shared formats
+that UUID without generating randomness. Both ingress and Background must parse
+events with `MetaTemplateStatusObservationV2Schema`; it checks the exact nine own
+fields and the 4096-byte UTF-8 JSON limit. Neither event UUID nor `receivedAt`
+orders provider statuses, which remain Background-owned policy. Repeated Meta
+status values can correspond to separate event occurrences.
+
+Compatibility vectors: [fixtures/meta-template-status-v2.json](fixtures/meta-template-status-v2.json),
+published at `/whatsapp-template-events/fixtures`. The fixture is test data,
+not a provider webhook payload.
+
+</details>
+
 <details>
 <summary>/merchant-communications — 40 exports</summary>
 

package/dist/whatsapp-template-events.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+
+/** The existing WhatsApp event queue; this observation is a distinct job type. */
+declare const META_TEMPLATE_STATUS_QUEUE: "whatsapp-events";
+declare const META_TEMPLATE_STATUS_JOB: "meta-template-status-update";
+declare const META_TEMPLATE_STATUS_SCHEMA_VERSION: 2;
+/**
+ * Consumer and producer boundary schema. Preflight checks the *actual* UTF-8
+ * JSON encoding and exact own-key set before the typed, non-coercing Zod parse.
+ * It does not log rejected payloads or parse Meta business status semantics.
+ */
+declare const MetaTemplateStatusObservationV2Schema: z.ZodPipe<z.ZodUnknown, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    eventIdentity: z.ZodString;
+    wabaId: z.ZodString;
+    providerTemplateId: z.ZodNullable<z.ZodString>;
+    providerTemplateName: z.ZodString;
+    providerLanguageCode: z.ZodString;
+    providerStatus: z.ZodString;
+    reasonCode: z.ZodNullable<z.ZodString>;
+    receivedAt: z.ZodString;
+}, z.core.$strict>>;
+type MetaTemplateStatusObservationV2 = z.infer<typeof MetaTemplateStatusObservationV2Schema>;
+/** Identity of one authenticated observation; never a content fingerprint. */
+declare function formatMetaTemplateStatusEventIdentity(observationId: string): string;
+/** BullMQ-compatible job ID: the same UUID, without ':' separators. */
+declare function formatMetaTemplateStatusJobId(observationId: string): string;
+
+export { META_TEMPLATE_STATUS_JOB, META_TEMPLATE_STATUS_QUEUE, META_TEMPLATE_STATUS_SCHEMA_VERSION, type MetaTemplateStatusObservationV2, MetaTemplateStatusObservationV2Schema, formatMetaTemplateStatusEventIdentity, formatMetaTemplateStatusJobId };

package/dist/whatsapp-template-events.js

@@ -0,0 +1,93 @@
+// src/whatsapp-template-events.ts
+import { z } from "zod";
+var META_TEMPLATE_STATUS_QUEUE = "whatsapp-events";
+var META_TEMPLATE_STATUS_JOB = "meta-template-status-update";
+var META_TEMPLATE_STATUS_SCHEMA_VERSION = 2;
+var MAX_JSON_BYTES = 4096;
+var REQUIRED_JSON_KEYS = [
+  "schemaVersion",
+  "eventIdentity",
+  "wabaId",
+  "providerTemplateId",
+  "providerTemplateName",
+  "providerLanguageCode",
+  "providerStatus",
+  "reasonCode",
+  "receivedAt"
+];
+var UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+var EVENT_IDENTITY_PREFIX = "meta-template-status:v2:";
+var JOB_ID_PREFIX = "meta-template-status-v2-";
+var EVENT_IDENTITY = /^meta-template-status:v2:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+var DECIMAL_PROVIDER_ID = /^[0-9]{1,32}$/;
+var CANONICAL_UTC_RECEIPT = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d\.\d{3}Z$/;
+var CONTROL_CHARACTERS = /[\u0000-\u001f\u007f]/;
+function providerText(maxLength) {
+  return z.string().min(1).max(maxLength).refine(
+    (value) => value.trim().length > 0 && !CONTROL_CHARACTERS.test(value),
+    { message: "Invalid Meta provider text" }
+  );
+}
+var canonicalReceivedAt = z.string().regex(CANONICAL_UTC_RECEIPT).refine(
+  (value) => {
+    const date = new Date(value);
+    return !Number.isNaN(date.getTime()) && date.toISOString() === value;
+  },
+  { message: "receivedAt must be a valid canonical UTC millisecond timestamp" }
+);
+var observationFields = z.object({
+  schemaVersion: z.literal(META_TEMPLATE_STATUS_SCHEMA_VERSION),
+  eventIdentity: z.string().regex(EVENT_IDENTITY),
+  wabaId: z.string().regex(DECIMAL_PROVIDER_ID),
+  providerTemplateId: z.string().regex(DECIMAL_PROVIDER_ID).nullable(),
+  providerTemplateName: providerText(255),
+  providerLanguageCode: providerText(16),
+  // Unknown but well-formed provider statuses remain text. The Background
+  // consumer, not this transport contract, interprets provider state.
+  providerStatus: providerText(32),
+  reasonCode: providerText(128).nullable(),
+  // Receipt time is diagnostic, never a provider-status ordering authority.
+  receivedAt: canonicalReceivedAt
+}).strict();
+var MetaTemplateStatusObservationV2Schema = z.unknown().superRefine(
+  (input, ctx) => {
+    let json;
+    try {
+      json = JSON.stringify(input);
+    } catch {
+    }
+    if (typeof json !== "string") {
+      ctx.addIssue({ code: "custom", message: "Meta template-status observation must be JSON-serializable" });
+      return;
+    }
+    if (new TextEncoder().encode(json).byteLength > MAX_JSON_BYTES) {
+      ctx.addIssue({ code: "custom", message: "Meta template-status observation exceeds 4096 UTF-8 bytes" });
+      return;
+    }
+    if (input === null || typeof input !== "object" || Array.isArray(input) || Object.keys(input).length !== REQUIRED_JSON_KEYS.length || !REQUIRED_JSON_KEYS.every((key) => Object.prototype.hasOwnProperty.call(input, key))) {
+      ctx.addIssue({ code: "custom", message: "Meta template-status observation requires exactly nine own JSON fields" });
+    }
+  }
+).pipe(observationFields);
+function validateObservationId(observationId) {
+  if (typeof observationId !== "string" || !UUID_V4.test(observationId)) {
+    throw new TypeError("observationId must be a lowercase UUID v4");
+  }
+}
+function formatMetaTemplateStatusEventIdentity(observationId) {
+  validateObservationId(observationId);
+  return `${EVENT_IDENTITY_PREFIX}${observationId}`;
+}
+function formatMetaTemplateStatusJobId(observationId) {
+  validateObservationId(observationId);
+  return `${JOB_ID_PREFIX}${observationId}`;
+}
+export {
+  META_TEMPLATE_STATUS_JOB,
+  META_TEMPLATE_STATUS_QUEUE,
+  META_TEMPLATE_STATUS_SCHEMA_VERSION,
+  MetaTemplateStatusObservationV2Schema,
+  formatMetaTemplateStatusEventIdentity,
+  formatMetaTemplateStatusJobId
+};
+//# sourceMappingURL=whatsapp-template-events.js.map

package/dist/whatsapp-template-events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/whatsapp-template-events.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** The existing WhatsApp event queue; this observation is a distinct job type. */\nexport const META_TEMPLATE_STATUS_QUEUE = \"whatsapp-events\" as const;\nexport const META_TEMPLATE_STATUS_JOB = \"meta-template-status-update\" as const;\nexport const META_TEMPLATE_STATUS_SCHEMA_VERSION = 2 as const;\n\nconst MAX_JSON_BYTES = 4096;\nconst REQUIRED_JSON_KEYS = [\n  \"schemaVersion\",\n  \"eventIdentity\",\n  \"wabaId\",\n  \"providerTemplateId\",\n  \"providerTemplateName\",\n  \"providerLanguageCode\",\n  \"providerStatus\",\n  \"reasonCode\",\n  \"receivedAt\",\n] as const;\n\n// Explicitly require a lowercase, RFC 4122 / RFC 9562 variant UUID *version 4*.\n// Meta does not supply an occurrence ID for this webhook: the authenticated\n// Messaging producer creates a fresh random UUID v4, not Shared.\nconst UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\nconst EVENT_IDENTITY_PREFIX = \"meta-template-status:v2:\";\nconst JOB_ID_PREFIX = \"meta-template-status-v2-\";\nconst EVENT_IDENTITY = /^meta-template-status:v2:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\nconst DECIMAL_PROVIDER_ID = /^[0-9]{1,32}$/;\nconst CANONICAL_UTC_RECEIPT = /^\\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d\\.\\d{3}Z$/;\nconst CONTROL_CHARACTERS = /[\\u0000-\\u001f\\u007f]/;\n\nfunction providerText(maxLength: number) {\n  return z.string().min(1).max(maxLength).refine(\n    (value) => value.trim().length > 0 && !CONTROL_CHARACTERS.test(value),\n    { message: \"Invalid Meta provider text\" },\n  );\n}\n\nconst canonicalReceivedAt = z.string().regex(CANONICAL_UTC_RECEIPT).refine(\n  (value) => {\n    const date = new Date(value);\n    return !Number.isNaN(date.getTime()) && date.toISOString() === value;\n  },\n  { message: \"receivedAt must be a valid canonical UTC millisecond timestamp\" },\n);\n\nconst observationFields = z.object({\n  schemaVersion: z.literal(META_TEMPLATE_STATUS_SCHEMA_VERSION),\n  eventIdentity: z.string().regex(EVENT_IDENTITY),\n  wabaId: z.string().regex(DECIMAL_PROVIDER_ID),\n  providerTemplateId: z.string().regex(DECIMAL_PROVIDER_ID).nullable(),\n  providerTemplateName: providerText(255),\n  providerLanguageCode: providerText(16),\n  // Unknown but well-formed provider statuses remain text. The Background\n  // consumer, not this transport contract, interprets provider state.\n  providerStatus: providerText(32),\n  reasonCode: providerText(128).nullable(),\n  // Receipt time is diagnostic, never a provider-status ordering authority.\n  receivedAt: canonicalReceivedAt,\n}).strict();\n\n/**\n * Consumer and producer boundary schema. Preflight checks the *actual* UTF-8\n * JSON encoding and exact own-key set before the typed, non-coercing Zod parse.\n * It does not log rejected payloads or parse Meta business status semantics.\n */\nexport const MetaTemplateStatusObservationV2Schema = z.unknown().superRefine(\n  (input, ctx) => {\n    let json: string | undefined;\n    try {\n      json = JSON.stringify(input);\n    } catch {\n      // A circular / non-JSON payload is not a valid BullMQ wire observation.\n    }\n    if (typeof json !== \"string\") {\n      ctx.addIssue({ code: \"custom\", message: \"Meta template-status observation must be JSON-serializable\" });\n      return;\n    }\n    if (new TextEncoder().encode(json).byteLength > MAX_JSON_BYTES) {\n      ctx.addIssue({ code: \"custom\", message: \"Meta template-status observation exceeds 4096 UTF-8 bytes\" });\n      return;\n    }\n    if (input === null || typeof input !== \"object\" || Array.isArray(input)\n      || Object.keys(input).length !== REQUIRED_JSON_KEYS.length\n      || !REQUIRED_JSON_KEYS.every((key) => Object.prototype.hasOwnProperty.call(input, key))) {\n      ctx.addIssue({ code: \"custom\", message: \"Meta template-status observation requires exactly nine own JSON fields\" });\n    }\n  },\n).pipe(observationFields);\n\nexport type MetaTemplateStatusObservationV2 = z.infer<typeof MetaTemplateStatusObservationV2Schema>;\n\nfunction validateObservationId(observationId: string): void {\n  if (typeof observationId !== \"string\" || !UUID_V4.test(observationId)) {\n    // Do not interpolate potentially untrusted identifiers into exceptions.\n    throw new TypeError(\"observationId must be a lowercase UUID v4\");\n  }\n}\n\n/** Identity of one authenticated observation; never a content fingerprint. */\nexport function formatMetaTemplateStatusEventIdentity(observationId: string): string {\n  validateObservationId(observationId);\n  return `${EVENT_IDENTITY_PREFIX}${observationId}`;\n}\n\n/** BullMQ-compatible job ID: the same UUID, without ':' separators. */\nexport function formatMetaTemplateStatusJobId(observationId: string): string {\n  validateObservationId(observationId);\n  return `${JOB_ID_PREFIX}${observationId}`;\n}\n"],"mappings":";AAAA,SAAS,SAAS;AAGX,IAAM,6BAA6B;AACnC,IAAM,2BAA2B;AACjC,IAAM,sCAAsC;AAEnD,IAAM,iBAAiB;AACvB,IAAM,qBAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAKA,IAAM,UAAU;AAChB,IAAM,wBAAwB;AAC9B,IAAM,gBAAgB;AACtB,IAAM,iBAAiB;AACvB,IAAM,sBAAsB;AAC5B,IAAM,wBAAwB;AAC9B,IAAM,qBAAqB;AAE3B,SAAS,aAAa,WAAmB;AACvC,SAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,SAAS,EAAE;AAAA,IACtC,CAAC,UAAU,MAAM,KAAK,EAAE,SAAS,KAAK,CAAC,mBAAmB,KAAK,KAAK;AAAA,IACpE,EAAE,SAAS,6BAA6B;AAAA,EAC1C;AACF;AAEA,IAAM,sBAAsB,EAAE,OAAO,EAAE,MAAM,qBAAqB,EAAE;AAAA,EAClE,CAAC,UAAU;AACT,UAAM,OAAO,IAAI,KAAK,KAAK;AAC3B,WAAO,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,KAAK,KAAK,YAAY,MAAM;AAAA,EACjE;AAAA,EACA,EAAE,SAAS,iEAAiE;AAC9E;AAEA,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACjC,eAAe,EAAE,QAAQ,mCAAmC;AAAA,EAC5D,eAAe,EAAE,OAAO,EAAE,MAAM,cAAc;AAAA,EAC9C,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB;AAAA,EAC5C,oBAAoB,EAAE,OAAO,EAAE,MAAM,mBAAmB,EAAE,SAAS;AAAA,EACnE,sBAAsB,aAAa,GAAG;AAAA,EACtC,sBAAsB,aAAa,EAAE;AAAA;AAAA;AAAA,EAGrC,gBAAgB,aAAa,EAAE;AAAA,EAC/B,YAAY,aAAa,GAAG,EAAE,SAAS;AAAA;AAAA,EAEvC,YAAY;AACd,CAAC,EAAE,OAAO;AAOH,IAAM,wCAAwC,EAAE,QAAQ,EAAE;AAAA,EAC/D,CAAC,OAAO,QAAQ;AACd,QAAI;AACJ,QAAI;AACF,aAAO,KAAK,UAAU,KAAK;AAAA,IAC7B,QAAQ;AAAA,IAER;AACA,QAAI,OAAO,SAAS,UAAU;AAC5B,UAAI,SAAS,EAAE,MAAM,UAAU,SAAS,6DAA6D,CAAC;AACtG;AAAA,IACF;AACA,QAAI,IAAI,YAAY,EAAE,OAAO,IAAI,EAAE,aAAa,gBAAgB;AAC9D,UAAI,SAAS,EAAE,MAAM,UAAU,SAAS,4DAA4D,CAAC;AACrG;AAAA,IACF;AACA,QAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,KACjE,OAAO,KAAK,KAAK,EAAE,WAAW,mBAAmB,UACjD,CAAC,mBAAmB,MAAM,CAAC,QAAQ,OAAO,UAAU,eAAe,KAAK,OAAO,GAAG,CAAC,GAAG;AACzF,UAAI,SAAS,EAAE,MAAM,UAAU,SAAS,yEAAyE,CAAC;AAAA,IACpH;AAAA,EACF;AACF,EAAE,KAAK,iBAAiB;AAIxB,SAAS,sBAAsB,eAA6B;AAC1D,MAAI,OAAO,kBAAkB,YAAY,CAAC,QAAQ,KAAK,aAAa,GAAG;AAErE,UAAM,IAAI,UAAU,2CAA2C;AAAA,EACjE;AACF;AAGO,SAAS,sCAAsC,eAA+B;AACnF,wBAAsB,aAAa;AACnC,SAAO,GAAG,qBAAqB,GAAG,aAAa;AACjD;AAGO,SAAS,8BAA8B,eAA+B;AAC3E,wBAAsB,aAAa;AACnC,SAAO,GAAG,aAAa,GAAG,aAAa;AACzC;","names":[]}

package/fixtures/meta-template-status-v2.json

@@ -0,0 +1,91 @@
+{
+  "observation": {
+    "schemaVersion": 2,
+    "eventIdentity": "meta-template-status:v2:550e8400-e29b-41d4-a716-446655440000",
+    "wabaId": "123456789",
+    "providerTemplateId": "987654321",
+    "providerTemplateName": "checkout_recovery_initial_v2",
+    "providerLanguageCode": "en_GB",
+    "providerStatus": "APPROVED",
+    "reasonCode": "NONE",
+    "receivedAt": "2026-10-25T19:00:00.000Z"
+  },
+  "expectedJobId": "meta-template-status-v2-550e8400-e29b-41d4-a716-446655440000",
+  "additionalObservations": [
+    {
+      "case": "identical-content-other-occurrence",
+      "observation": {
+        "schemaVersion": 2,
+        "eventIdentity": "meta-template-status:v2:550e8400-e29b-41d4-a716-446655440001",
+        "wabaId": "123456789",
+        "providerTemplateId": "987654321",
+        "providerTemplateName": "checkout_recovery_initial_v2",
+        "providerLanguageCode": "en_GB",
+        "providerStatus": "APPROVED",
+        "reasonCode": "NONE",
+        "receivedAt": "2026-10-25T19:00:00.000Z"
+      },
+      "expectedJobId": "meta-template-status-v2-550e8400-e29b-41d4-a716-446655440001"
+    },
+    {
+      "case": "transition-paused",
+      "observation": {
+        "schemaVersion": 2,
+        "eventIdentity": "meta-template-status:v2:550e8400-e29b-41d4-a716-446655440002",
+        "wabaId": "123456789",
+        "providerTemplateId": "987654321",
+        "providerTemplateName": "checkout_recovery_initial_v2",
+        "providerLanguageCode": "en_GB",
+        "providerStatus": "PAUSED",
+        "reasonCode": "NONE",
+        "receivedAt": "2026-10-25T19:01:00.000Z"
+      },
+      "expectedJobId": "meta-template-status-v2-550e8400-e29b-41d4-a716-446655440002"
+    },
+    {
+      "case": "transition-approved-again",
+      "observation": {
+        "schemaVersion": 2,
+        "eventIdentity": "meta-template-status:v2:550e8400-e29b-41d4-a716-446655440003",
+        "wabaId": "123456789",
+        "providerTemplateId": "987654321",
+        "providerTemplateName": "checkout_recovery_initial_v2",
+        "providerLanguageCode": "en_GB",
+        "providerStatus": "APPROVED",
+        "reasonCode": "NONE",
+        "receivedAt": "2026-10-25T19:02:00.000Z"
+      },
+      "expectedJobId": "meta-template-status-v2-550e8400-e29b-41d4-a716-446655440003"
+    },
+    {
+      "case": "identical-delivery-first",
+      "observation": {
+        "schemaVersion": 2,
+        "eventIdentity": "meta-template-status:v2:550e8400-e29b-41d4-a716-446655440004",
+        "wabaId": "123456789",
+        "providerTemplateId": "987654321",
+        "providerTemplateName": "checkout_recovery_initial_v2",
+        "providerLanguageCode": "en_GB",
+        "providerStatus": "APPROVED",
+        "reasonCode": "NONE",
+        "receivedAt": "2026-10-25T19:00:00.000Z"
+      },
+      "expectedJobId": "meta-template-status-v2-550e8400-e29b-41d4-a716-446655440004"
+    },
+    {
+      "case": "identical-delivery-second",
+      "observation": {
+        "schemaVersion": 2,
+        "eventIdentity": "meta-template-status:v2:550e8400-e29b-41d4-a716-446655440005",
+        "wabaId": "123456789",
+        "providerTemplateId": "987654321",
+        "providerTemplateName": "checkout_recovery_initial_v2",
+        "providerLanguageCode": "en_GB",
+        "providerStatus": "APPROVED",
+        "reasonCode": "NONE",
+        "receivedAt": "2026-10-25T19:00:00.000Z"
+      },
+      "expectedJobId": "meta-template-status-v2-550e8400-e29b-41d4-a716-446655440005"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,6 +28,11 @@
       "types": "./dist/whatsapp.d.ts",
       "import": "./dist/whatsapp.js"
     },
+    "./whatsapp-template-events": {
+      "types": "./dist/whatsapp-template-events.d.ts",
+      "import": "./dist/whatsapp-template-events.js"
+    },
+    "./whatsapp-template-events/fixtures": "./fixtures/meta-template-status-v2.json",
     "./merchant-communications": {
       "types": "./dist/merchant-communications.d.ts",
       "import": "./dist/merchant-communications.js"
@@ -112,7 +117,8 @@
   },
   "files": [
     "dist",
-    "fixtures/identity-v1.json"
+    "fixtures/identity-v1.json",
+    "fixtures/meta-template-status-v2.json"
   ],
   "scripts": {
     "build": "tsup",
@@ -129,7 +135,8 @@
     "validate:commerce-entrypoints": "node scripts/validate-commerce-entrypoints.mjs",
     "validate:arch023-shared-entrypoints": "npm run build && node scripts/validate-arch023-shared-entrypoints.mjs",
     "validate:arch024-model-entrypoints": "npm run build && node scripts/validate-arch024-model-entrypoints.mjs",
-    "test:arch033-incidents:postgres": "node scripts/test-arch033-incidents-postgres.mjs"
+    "test:arch033-incidents:postgres": "node scripts/test-arch033-incidents-postgres.mjs",
+    "validate:arch047-whatsapp-template-events": "node scripts/validate-whatsapp-template-events-entrypoint.mjs"
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",