@modainteract/moda-interact-shared 1.2.0 → 1.3.1

package/dist/billing.d.ts

@@ -1,7 +1,8 @@
 import { z } from 'zod';
 
 declare const ARCH007_BILLING_CONTRACT_SCHEMA_VERSION: 1;
-declare const WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION: 2;
+declare const WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION: 2;
+declare const WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION: 3;
 declare const BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION: 1;
 declare const BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME = "billing-subscription-reconcile";
 declare const BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME = "reconcile-subscription";
@@ -96,8 +97,33 @@ declare const WhatsAppProviderPricingMetadataSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type WhatsAppProviderPricingMetadata = z.infer<typeof WhatsAppProviderPricingMetadataSchema>;
-declare const NormalizedWhatsAppStatusSchema: z.ZodObject<{
+declare const WhatsAppProviderFailureEvidenceSchema: z.ZodObject<{
+    providerCode: z.ZodString;
+}, z.core.$strict>;
+type WhatsAppProviderFailureEvidence = z.infer<typeof WhatsAppProviderFailureEvidenceSchema>;
+declare const NormalizedWhatsAppStatusV2Schema: z.ZodObject<{
+    providerAccountId: z.ZodString;
+    providerPhoneNumberId: z.ZodString;
+    providerMessageId: z.ZodString;
+    status: z.ZodEnum<{
+        SENT: "SENT";
+        DELIVERED: "DELIVERED";
+        READ: "READ";
+        FAILED: "FAILED";
+    }>;
+    occurredAt: z.ZodISODateTime;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
     schemaVersion: z.ZodLiteral<2>;
+}, z.core.$strict>;
+type NormalizedWhatsAppStatusV2 = z.infer<typeof NormalizedWhatsAppStatusV2Schema>;
+declare const NormalizedWhatsAppStatusV3Schema: z.ZodObject<{
+    failure: z.ZodOptional<z.ZodObject<{
+        providerCode: z.ZodString;
+    }, z.core.$strict>>;
     providerAccountId: z.ZodString;
     providerPhoneNumberId: z.ZodString;
     providerMessageId: z.ZodString;
@@ -113,16 +139,71 @@ declare const NormalizedWhatsAppStatusSchema: z.ZodObject<{
         category: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    schemaVersion: z.ZodLiteral<3>;
 }, z.core.$strict>;
+type NormalizedWhatsAppStatusV3 = z.infer<typeof NormalizedWhatsAppStatusV3Schema>;
+declare const NormalizedWhatsAppStatusSchema: z.ZodUnion<readonly [z.ZodObject<{
+    providerAccountId: z.ZodString;
+    providerPhoneNumberId: z.ZodString;
+    providerMessageId: z.ZodString;
+    status: z.ZodEnum<{
+        SENT: "SENT";
+        DELIVERED: "DELIVERED";
+        READ: "READ";
+        FAILED: "FAILED";
+    }>;
+    occurredAt: z.ZodISODateTime;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    schemaVersion: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    failure: z.ZodOptional<z.ZodObject<{
+        providerCode: z.ZodString;
+    }, z.core.$strict>>;
+    providerAccountId: z.ZodString;
+    providerPhoneNumberId: z.ZodString;
+    providerMessageId: z.ZodString;
+    status: z.ZodEnum<{
+        SENT: "SENT";
+        DELIVERED: "DELIVERED";
+        READ: "READ";
+        FAILED: "FAILED";
+    }>;
+    occurredAt: z.ZodISODateTime;
+    pricing: z.ZodOptional<z.ZodObject<{
+        billable: z.ZodOptional<z.ZodBoolean>;
+        category: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    schemaVersion: z.ZodLiteral<3>;
+}, z.core.$strict>]>;
 type NormalizedWhatsAppStatus = z.infer<typeof NormalizedWhatsAppStatusSchema>;
 declare function parseNormalizedWhatsAppStatus(input: unknown): NormalizedWhatsAppStatus;
 declare function safeParseNormalizedWhatsAppStatus(input: unknown): z.ZodSafeParseResult<{
+    providerAccountId: string;
+    providerPhoneNumberId: string;
+    providerMessageId: string;
+    status: "SENT" | "DELIVERED" | "READ" | "FAILED";
+    occurredAt: string;
     schemaVersion: 2;
+    pricing?: {
+        billable?: boolean | undefined;
+        category?: string | undefined;
+        model?: string | undefined;
+    } | undefined;
+} | {
     providerAccountId: string;
     providerPhoneNumberId: string;
     providerMessageId: string;
     status: "SENT" | "DELIVERED" | "READ" | "FAILED";
     occurredAt: string;
+    schemaVersion: 3;
+    failure?: {
+        providerCode: string;
+    } | undefined;
     pricing?: {
         billable?: boolean | undefined;
         category?: string | undefined;
@@ -134,4 +215,4 @@ declare function createMerchantBillingSystemSourceKey(shopId: string, code: Bill
 declare function createRecoveryIdempotencyKey(shopId: string, recoveryId: string): string;
 declare function createShopifyUsageIdempotencyKey(shopId: string, usageEventId: string): string;
 
-export { APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS, ARCH007_BILLING_CONTRACT_SCHEMA_VERSION, BILLING_PLAN_KINDS, BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME, BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME, BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION, BILLING_SYSTEM_MESSAGE_CODES, BILLING_USAGE_METRICS, type BillingPlanKind, BillingPlanKindSchema, type BillingSubscriptionReconcileJob, BillingSubscriptionReconcileJobSchema, type BillingSystemMessageCode, BillingSystemMessageCodeSchema, type BillingUsageMetric, BillingUsageMetricSchema, type NormalizedWhatsAppStatus, NormalizedWhatsAppStatusSchema, type PurchasedRecoveryCreditCounterSnapshot, type ShopifyCurrentProviderContext, type ShopifyProviderContextIdentityInput, type ShopifyPurchaseProviderContext, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, type WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, type WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createBillingSubscriptionReconcileJobId, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, deriveShopifyProviderContextIdentity, isSameShopifyPurchaseProviderContext, parseBillingSubscriptionReconcileJob, parseNormalizedWhatsAppStatus, safeParseBillingSubscriptionReconcileJob, safeParseNormalizedWhatsAppStatus };
+export { APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS, ARCH007_BILLING_CONTRACT_SCHEMA_VERSION, BILLING_PLAN_KINDS, BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME, BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME, BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION, BILLING_SYSTEM_MESSAGE_CODES, BILLING_USAGE_METRICS, type BillingPlanKind, BillingPlanKindSchema, type BillingSubscriptionReconcileJob, BillingSubscriptionReconcileJobSchema, type BillingSystemMessageCode, BillingSystemMessageCodeSchema, type BillingUsageMetric, BillingUsageMetricSchema, type NormalizedWhatsAppStatus, NormalizedWhatsAppStatusSchema, type NormalizedWhatsAppStatusV2, NormalizedWhatsAppStatusV2Schema, type NormalizedWhatsAppStatusV3, NormalizedWhatsAppStatusV3Schema, type PurchasedRecoveryCreditCounterSnapshot, type ShopifyCurrentProviderContext, type ShopifyProviderContextIdentityInput, type ShopifyPurchaseProviderContext, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION, type WhatsAppProviderFailureEvidence, WhatsAppProviderFailureEvidenceSchema, type WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, type WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createBillingSubscriptionReconcileJobId, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, deriveShopifyProviderContextIdentity, isSameShopifyPurchaseProviderContext, parseBillingSubscriptionReconcileJob, parseNormalizedWhatsAppStatus, safeParseBillingSubscriptionReconcileJob, safeParseNormalizedWhatsAppStatus };

package/dist/billing.js

@@ -12,8 +12,12 @@ import {
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
+  NormalizedWhatsAppStatusV2Schema,
+  NormalizedWhatsAppStatusV3Schema,
   WHATSAPP_PROVIDER_STATUSES,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION,
+  WhatsAppProviderFailureEvidenceSchema,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
   availablePurchasedRecoveryCredits,
@@ -27,7 +31,7 @@ import {
   parseNormalizedWhatsAppStatus,
   safeParseBillingSubscriptionReconcileJob,
   safeParseNormalizedWhatsAppStatus
-} from "./chunk-ANBEH6NW.js";
+} from "./chunk-HIHWRUZH.js";
 export {
   APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS,
   ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
@@ -42,8 +46,12 @@ export {
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
+  NormalizedWhatsAppStatusV2Schema,
+  NormalizedWhatsAppStatusV3Schema,
   WHATSAPP_PROVIDER_STATUSES,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION,
+  WhatsAppProviderFailureEvidenceSchema,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
   availablePurchasedRecoveryCredits,

package/dist/{chunk-ANBEH6NW.js → chunk-HIHWRUZH.js}

@@ -1,7 +1,8 @@
 // src/billing.ts
 import { z } from "zod";
 var ARCH007_BILLING_CONTRACT_SCHEMA_VERSION = 1;
-var WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION = 2;
+var WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION = 2;
+var WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION = 3;
 var BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION = 1;
 var BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME = "billing-subscription-reconcile";
 var BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME = "reconcile-subscription";
@@ -111,15 +112,33 @@ var WhatsAppProviderPricingMetadataSchema = z.object({
   category: z.string().trim().min(1).max(MAX_SHORT_TEXT_LENGTH).optional(),
   model: z.string().trim().min(1).max(MAX_SHORT_TEXT_LENGTH).optional()
 }).strict().refine((value) => Object.keys(value).length > 0, "pricing metadata must not be empty");
-var NormalizedWhatsAppStatusSchema = z.object({
-  schemaVersion: z.literal(WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION),
+var WhatsAppProviderFailureEvidenceSchema = z.object({
+  providerCode: z.string().trim().min(1).max(64)
+}).strict();
+var NORMALIZED_WHATSAPP_STATUS_FIELDS = {
   providerAccountId: z.string().trim().min(1).max(MAX_ID_LENGTH),
   providerPhoneNumberId: z.string().trim().min(1).max(MAX_ID_LENGTH),
   providerMessageId: z.string().trim().min(1).max(MAX_ID_LENGTH),
   status: WhatsAppProviderStatusSchema,
   occurredAt: z.iso.datetime({ offset: true }),
   pricing: WhatsAppProviderPricingMetadataSchema.optional()
+};
+var NormalizedWhatsAppStatusV2Schema = z.object({
+  schemaVersion: z.literal(WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION),
+  ...NORMALIZED_WHATSAPP_STATUS_FIELDS
 }).strict();
+var NormalizedWhatsAppStatusV3Schema = z.object({
+  schemaVersion: z.literal(WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION),
+  ...NORMALIZED_WHATSAPP_STATUS_FIELDS,
+  failure: WhatsAppProviderFailureEvidenceSchema.optional()
+}).strict().refine((value) => value.status === "FAILED" || value.failure === void 0, {
+  message: "failure evidence is only valid for FAILED statuses",
+  path: ["failure"]
+});
+var NormalizedWhatsAppStatusSchema = z.union([
+  NormalizedWhatsAppStatusV2Schema,
+  NormalizedWhatsAppStatusV3Schema
+]);
 function parseNormalizedWhatsAppStatus(input) {
   return NormalizedWhatsAppStatusSchema.parse(input);
 }
@@ -175,6 +194,7 @@ function createShopifyUsageIdempotencyKey(shopId, usageEventId) {
 
 export {
   ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
+  WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
   BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION,
   BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME,
@@ -195,6 +215,9 @@ export {
   parseBillingSubscriptionReconcileJob,
   safeParseBillingSubscriptionReconcileJob,
   WhatsAppProviderPricingMetadataSchema,
+  WhatsAppProviderFailureEvidenceSchema,
+  NormalizedWhatsAppStatusV2Schema,
+  NormalizedWhatsAppStatusV3Schema,
   NormalizedWhatsAppStatusSchema,
   parseNormalizedWhatsAppStatus,
   safeParseNormalizedWhatsAppStatus,
@@ -203,4 +226,4 @@ export {
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey
 };
-//# sourceMappingURL=chunk-ANBEH6NW.js.map
+//# sourceMappingURL=chunk-HIHWRUZH.js.map

package/dist/chunk-HIHWRUZH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/billing.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const ARCH007_BILLING_CONTRACT_SCHEMA_VERSION = 1 as const;\nexport const WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION = 2 as const;\nexport const WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION = 3 as const;\nexport const BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION = 1 as const;\nexport const BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME = \"billing-subscription-reconcile\";\nexport const BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME = \"reconcile-subscription\";\nexport const APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS = 300000 as const;\n\nconst SHOPIFY_PROVIDER_CONTEXT_INVALID_PREFIX = \"SHOPIFY_PROVIDER_CONTEXT_INVALID:\";\n\nexport type ShopifyProviderContextIdentityInput = Readonly<{\n  providerSubscriptionId: string | null;\n  planHandle: string;\n  currentPeriodStart: Date | string | null;\n  currentPeriodEnd: Date | string | null;\n}>;\n\nexport type ShopifyPurchaseProviderContext = Readonly<{\n  providerContextIdentity: string;\n  shopifyPlanHandleSnapshot: string;\n  billingPeriodId: string;\n}>;\n\nexport type ShopifyCurrentProviderContext = Readonly<{\n  providerContextIdentity: string;\n  shopifyPlanHandle: string;\n  billingPeriodId: string;\n}>;\n\nfunction invalidShopifyProviderContext(reason: string): never {\n  throw new Error(`${SHOPIFY_PROVIDER_CONTEXT_INVALID_PREFIX}${reason}`);\n}\n\nfunction normalizeShopifyProviderContextDate(\n  name: string,\n  value: Date | string | null,\n): Date {\n  if (value === null || (typeof value !== \"string\" && !(value instanceof Date))) {\n    return invalidShopifyProviderContext(`${name} must be a valid date`);\n  }\n\n  const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    return invalidShopifyProviderContext(`${name} must be a valid date`);\n  }\n  return date;\n}\n\nexport function deriveShopifyProviderContextIdentity(\n  input: ShopifyProviderContextIdentityInput,\n): string {\n  const providerSubscriptionId = typeof input.providerSubscriptionId === \"string\"\n    ? input.providerSubscriptionId.trim()\n    : \"\";\n  if (providerSubscriptionId) return providerSubscriptionId;\n\n  if (typeof input.planHandle !== \"string\" || input.planHandle.trim().length === 0) {\n    return invalidShopifyProviderContext(\"planHandle must be a non-empty string\");\n  }\n\n  const start = normalizeShopifyProviderContextDate(\"currentPeriodStart\", input.currentPeriodStart);\n  const end = normalizeShopifyProviderContextDate(\"currentPeriodEnd\", input.currentPeriodEnd);\n  if (start >= end) {\n    return invalidShopifyProviderContext(\"currentPeriodStart must be before currentPeriodEnd\");\n  }\n\n  return `app-pricing:v1:${encodeURIComponent(input.planHandle.trim())}:${start.toISOString()}:${end.toISOString()}`;\n}\n\nexport function isSameShopifyPurchaseProviderContext(\n  purchase: ShopifyPurchaseProviderContext,\n  current: ShopifyCurrentProviderContext,\n): boolean {\n  return [\n    [purchase.providerContextIdentity, current.providerContextIdentity],\n    [purchase.shopifyPlanHandleSnapshot, current.shopifyPlanHandle],\n    [purchase.billingPeriodId, current.billingPeriodId],\n  ].every(([purchaseValue, currentValue]) =>\n    typeof purchaseValue === \"string\"\n      && typeof currentValue === \"string\"\n      && purchaseValue.trim().length > 0\n      && currentValue.trim().length > 0\n      && purchaseValue.trim() === currentValue.trim(),\n  );\n}\n\nexport const BILLING_PLAN_KINDS = [\"FREE\", \"PAID_METERED\"] as const;\nexport const BillingPlanKindSchema = z.enum(BILLING_PLAN_KINDS);\nexport type BillingPlanKind = z.infer<typeof BillingPlanKindSchema>;\n\nexport const BILLING_USAGE_METRICS = [\n  \"RECOVERY_CONVERSATION\",\n  \"OUTBOUND_AUTOMATED_MESSAGE\",\n  \"DELIVERED_WHATSAPP_MESSAGE\",\n  \"RECOVERY_CREDIT_PACK_PURCHASE\",\n] as const;\nexport const BillingUsageMetricSchema = z.enum(BILLING_USAGE_METRICS);\nexport type BillingUsageMetric = z.infer<typeof BillingUsageMetricSchema>;\n\nexport const BILLING_SYSTEM_MESSAGE_CODES = {\n  FREE_ALLOWANCE_WARNING: \"BILLING_FREE_ALLOWANCE_WARNING\",\n  RECOVERY_CAPACITY_EXHAUSTED: \"BILLING_RECOVERY_CAPACITY_EXHAUSTED\",\n  PLAN_UPGRADED: \"BILLING_PLAN_UPGRADED\",\n  PLAN_DOWNGRADE_SCHEDULED: \"BILLING_PLAN_DOWNGRADE_SCHEDULED\",\n  SUBSCRIPTION_ENDED: \"BILLING_SUBSCRIPTION_ENDED\",\n  SAFETY_LIMIT_REACHED: \"BILLING_SAFETY_LIMIT_REACHED\",\n  REFUND_REQUEST_RECEIVED: \"BILLING_REFUND_REQUEST_RECEIVED\",\n  REFUND_COMPLETED: \"BILLING_REFUND_COMPLETED\",\n  REFUND_REJECTED: \"BILLING_REFUND_REJECTED\",\n} as const;\n\nconst BILLING_SYSTEM_MESSAGE_CODE_VALUES = [\n  BILLING_SYSTEM_MESSAGE_CODES.FREE_ALLOWANCE_WARNING,\n  BILLING_SYSTEM_MESSAGE_CODES.RECOVERY_CAPACITY_EXHAUSTED,\n  BILLING_SYSTEM_MESSAGE_CODES.PLAN_UPGRADED,\n  BILLING_SYSTEM_MESSAGE_CODES.PLAN_DOWNGRADE_SCHEDULED,\n  BILLING_SYSTEM_MESSAGE_CODES.SUBSCRIPTION_ENDED,\n  BILLING_SYSTEM_MESSAGE_CODES.SAFETY_LIMIT_REACHED,\n  BILLING_SYSTEM_MESSAGE_CODES.REFUND_REQUEST_RECEIVED,\n  BILLING_SYSTEM_MESSAGE_CODES.REFUND_COMPLETED,\n  BILLING_SYSTEM_MESSAGE_CODES.REFUND_REJECTED,\n] as const;\n\nexport const BillingSystemMessageCodeSchema = z.enum(BILLING_SYSTEM_MESSAGE_CODE_VALUES);\nexport type BillingSystemMessageCode = z.infer<typeof BillingSystemMessageCodeSchema>;\n\nexport type PurchasedRecoveryCreditCounterSnapshot = Readonly<{\n  grantedQuantity: number;\n  committedQuantity: number;\n  reservedQuantity: number;\n  refundingQuantity: number;\n}>;\n\nexport function availablePurchasedRecoveryCredits(\n  counter: PurchasedRecoveryCreditCounterSnapshot,\n): number {\n  for (const [name, value] of Object.entries(counter)) {\n    if (!Number.isInteger(value) || value < 0) {\n      throw new Error(`${name} must be a non-negative integer`);\n    }\n  }\n\n  return Math.max(\n    counter.grantedQuantity\n      - counter.committedQuantity\n      - counter.reservedQuantity\n      - counter.refundingQuantity,\n    0,\n  );\n}\n\nexport const WHATSAPP_PROVIDER_STATUSES = [\n  \"SENT\",\n  \"DELIVERED\",\n  \"READ\",\n  \"FAILED\",\n] as const;\nexport const WhatsAppProviderStatusSchema = z.enum(WHATSAPP_PROVIDER_STATUSES);\nexport type WhatsAppProviderStatus = z.infer<typeof WhatsAppProviderStatusSchema>;\n\nconst MAX_ID_LENGTH = 128;\nconst MAX_SHORT_TEXT_LENGTH = 128;\n\nexport const BillingSubscriptionReconcileJobSchema = z\n  .object({\n    schemaVersion: z.literal(BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION),\n    shopId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    subscriptionId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    expectedNextReconcileAt: z.iso.datetime({ offset: true }),\n  })\n  .strict();\n\nexport type BillingSubscriptionReconcileJob = z.infer<\n  typeof BillingSubscriptionReconcileJobSchema\n>;\n\nexport function parseBillingSubscriptionReconcileJob(\n  input: unknown,\n): BillingSubscriptionReconcileJob {\n  return BillingSubscriptionReconcileJobSchema.parse(input);\n}\n\nexport function safeParseBillingSubscriptionReconcileJob(input: unknown) {\n  return BillingSubscriptionReconcileJobSchema.safeParse(input);\n}\n\nexport const WhatsAppProviderPricingMetadataSchema = z\n  .object({\n    billable: z.boolean().optional(),\n    category: z.string().trim().min(1).max(MAX_SHORT_TEXT_LENGTH).optional(),\n    model: z.string().trim().min(1).max(MAX_SHORT_TEXT_LENGTH).optional(),\n  })\n  .strict()\n  .refine((value) => Object.keys(value).length > 0, \"pricing metadata must not be empty\");\n\nexport type WhatsAppProviderPricingMetadata = z.infer<\n  typeof WhatsAppProviderPricingMetadataSchema\n>;\n\nexport const WhatsAppProviderFailureEvidenceSchema = z\n  .object({\n    providerCode: z.string().trim().min(1).max(64),\n  })\n  .strict();\n\nexport type WhatsAppProviderFailureEvidence = z.infer<\n  typeof WhatsAppProviderFailureEvidenceSchema\n>;\n\nconst NORMALIZED_WHATSAPP_STATUS_FIELDS = {\n  providerAccountId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n  providerPhoneNumberId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n  providerMessageId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n  status: WhatsAppProviderStatusSchema,\n  occurredAt: z.iso.datetime({ offset: true }),\n  pricing: WhatsAppProviderPricingMetadataSchema.optional(),\n};\n\nexport const NormalizedWhatsAppStatusV2Schema = z\n  .object({\n    schemaVersion: z.literal(WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION),\n    ...NORMALIZED_WHATSAPP_STATUS_FIELDS,\n  })\n  .strict();\n\nexport type NormalizedWhatsAppStatusV2 = z.infer<typeof NormalizedWhatsAppStatusV2Schema>;\n\nexport const NormalizedWhatsAppStatusV3Schema = z\n  .object({\n    schemaVersion: z.literal(WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION),\n    ...NORMALIZED_WHATSAPP_STATUS_FIELDS,\n    failure: WhatsAppProviderFailureEvidenceSchema.optional(),\n  })\n  .strict()\n  .refine((value) => value.status === \"FAILED\" || value.failure === undefined, {\n    message: \"failure evidence is only valid for FAILED statuses\",\n    path: [\"failure\"],\n  });\n\nexport type NormalizedWhatsAppStatusV3 = z.infer<typeof NormalizedWhatsAppStatusV3Schema>;\n\nexport const NormalizedWhatsAppStatusSchema = z.union([\n  NormalizedWhatsAppStatusV2Schema,\n  NormalizedWhatsAppStatusV3Schema,\n]);\n\nexport type NormalizedWhatsAppStatus = z.infer<typeof NormalizedWhatsAppStatusSchema>;\n\nexport function parseNormalizedWhatsAppStatus(input: unknown): NormalizedWhatsAppStatus {\n  return NormalizedWhatsAppStatusSchema.parse(input);\n}\n\nexport function safeParseNormalizedWhatsAppStatus(input: unknown) {\n  return NormalizedWhatsAppStatusSchema.safeParse(input);\n}\n\nfunction assertKeyPart(name: string, value: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new Error(`${name} must be a non-empty string`);\n  }\n}\n\nfunction fnv1a64(value: string): string {\n  let hash = 0xcbf29ce484222325n;\n  for (const character of value) {\n    hash ^= BigInt(character.codePointAt(0) ?? 0);\n    hash = BigInt.asUintN(64, hash * 0x100000001b3n);\n  }\n  return hash.toString(16).padStart(16, \"0\");\n}\n\nexport function createBillingSubscriptionReconcileJobId(\n  subscriptionId: string,\n  expectedNextReconcileAt: string,\n): string {\n  assertKeyPart(\"subscriptionId\", subscriptionId);\n  if (subscriptionId.trim().length > MAX_ID_LENGTH) {\n    throw new Error(`subscriptionId must be at most ${MAX_ID_LENGTH} characters`);\n  }\n  z.iso.datetime({ offset: true }).parse(expectedNextReconcileAt);\n  return `billing-subscription-reconcile-${fnv1a64(`${subscriptionId.trim()}\\u0000${expectedNextReconcileAt}`)}`;\n}\n\nfunction boundedKey(prefix: string, parts: string[], maxLength: number): string {\n  const canonical = parts.map((part) => part.trim()).join(\":\");\n  const readable = `${prefix}:${canonical}`;\n  if (readable.length <= maxLength) return readable;\n  return `${prefix}:h${fnv1a64(canonical)}`;\n}\n\nexport function createMerchantBillingSystemSourceKey(\n  shopId: string,\n  code: BillingSystemMessageCode,\n  eventIdentity: string,\n  version = 1,\n): string {\n  assertKeyPart(\"shopId\", shopId);\n  assertKeyPart(\"code\", code);\n  assertKeyPart(\"eventIdentity\", eventIdentity);\n  if (!Number.isInteger(version) || version < 1) {\n    throw new Error(\"version must be a positive integer\");\n  }\n  return boundedKey(\"billing-system\", [shopId, code, eventIdentity, String(version)], 255);\n}\n\nexport function createRecoveryIdempotencyKey(shopId: string, recoveryId: string): string {\n  assertKeyPart(\"shopId\", shopId);\n  assertKeyPart(\"recoveryId\", recoveryId);\n  return boundedKey(\"recovery\", [shopId, recoveryId], 255);\n}\n\nexport function createShopifyUsageIdempotencyKey(\n  shopId: string,\n  usageEventId: string,\n): string {\n  assertKeyPart(\"shopId\", shopId);\n  assertKeyPart(\"usageEventId\", usageEventId);\n  return boundedKey(\"shopify\", [shopId, usageEventId], 64);\n}"],"mappings":"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","names":[]}

package/dist/commerce/index.d.ts

@@ -380,6 +380,48 @@ type CodeResponseProcessorResult = {
     };
 };
 
+declare const STORE_CATEGORY_PROMPT_RUNTIME_VERSION: "store-category-prompt.v1";
+declare const MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS = 100000;
+declare const MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS = 100000;
+declare const MAX_STORE_CATEGORY_PROMPT_CONDITIONS = 256;
+declare const StoreCategoryPromptConditionKeySchema: z.ZodString;
+type StoreCategoryPromptConditionKey = z.infer<typeof StoreCategoryPromptConditionKeySchema>;
+declare const StoreCategoryPromptContextSchema: z.ZodObject<{
+    mappings: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+}, z.core.$strict>;
+type StoreCategoryPromptContext = z.infer<typeof StoreCategoryPromptContextSchema>;
+type StoreCategoryPromptTemplateIssue = {
+    path: "/promptText";
+    code: "invalid_prompt_source" | "unsupported_template_construct" | "invalid_template_structure" | "invalid_template_expression" | "invalid_mapping_condition" | "unknown_mapping_condition" | "template_too_complex" | "rendered_prompt_too_large";
+    message: string;
+};
+type StoreCategoryPromptTemplateValidation = {
+    valid: boolean;
+    issues: StoreCategoryPromptTemplateIssue[];
+    referencedConditionKeys: string[];
+};
+type StoreCategoryPromptRenderResult = {
+    ok: true;
+    promptText: string;
+    referencedConditionKeys: string[];
+} | {
+    ok: false;
+    issues: StoreCategoryPromptTemplateIssue[];
+};
+declare function validateStoreCategoryPromptTemplate(input: {
+    source: string;
+    availableConditionKeys: readonly string[];
+}): StoreCategoryPromptTemplateValidation;
+declare function createStoreCategoryPromptConditionBlock(conditionKey: string): string;
+declare function createStoreCategoryPromptContext(input: {
+    availableConditionKeys: readonly string[];
+    selectedConditionKeys: readonly string[];
+}): StoreCategoryPromptContext;
+declare function renderStoreCategoryPromptTemplate(input: {
+    source: string;
+    context: StoreCategoryPromptContext;
+}): StoreCategoryPromptRenderResult;
+
 /** Synthetic examples; no provider identity, schema artifact or publication claim. */
 
 declare const exampleTool: ToolDescriptor;
@@ -389,4 +431,4 @@ declare function exampleManifest(digest: Digest, withTool?: boolean): CommerceMa
 declare function exampleGrant(manifest: CommerceManifest): CommerceConversationGrant;
 declare const exampleFinal: CommerceFinalResponse;
 
-export { type CodeResponseProcessorInput, type CodeResponseProcessorResult, CommerceConversationGrant, CommerceFinalResponse, CommerceManifest, CommerceToolDefinition, CommerceTurnIdentity, type ConnectionCommand, ConnectionCommandSchema, ConnectionIssueSchema, type ConnectionResult, ConnectionResultSchema, type ConnectionRevisionView, ConnectionRevisionViewSchema, type ConnectionView, ConnectionViewSchema, ContractVersionSchema, type CredentialStatus, CredentialStatusSchema, CurrencySchema, DateSchema, Digest, type ExternalHttpResultData, ExternalHttpResultDataSchema, ExternalPathSchema, ExternalQueryMappingSchema, ExternalQueryMappingsSchema, ExternalQueryValueSchema, type ExternalResponseFormat, ExternalResponseFormatSchema, type FeatureFacts, type FieldProjection, FieldProjectionSchema, GrantedTool, HashSchema, IdSchema, LanguageSchema, MoneySchema, type ResponseFilter, ResponseFilterSchema, type ResponseProcessing, ResponseProcessingSchema, type RevisionInput, RevisionInputSchema, SemverSchema, SubsetSchema, ToolDescriptor, type TransformResponse, TransformResponseSchema, type TransformSample, TransformSampleSchema, type VisualResponseProcessing, VisualResponseProcessingSchema, type VisualResponseProcessorInput, type VisualResponseProcessorResult, boundedJson, currentlyGrantedTools, deduplicateTools, distinct, exampleDefinition, exampleFinal, exampleGrant, exampleManifest, exampleTool, exampleTurn, manifestMatchesGrant, parseCommerceManifest, selectCapabilities };
+export { type CodeResponseProcessorInput, type CodeResponseProcessorResult, CommerceConversationGrant, CommerceFinalResponse, CommerceManifest, CommerceToolDefinition, CommerceTurnIdentity, type ConnectionCommand, ConnectionCommandSchema, ConnectionIssueSchema, type ConnectionResult, ConnectionResultSchema, type ConnectionRevisionView, ConnectionRevisionViewSchema, type ConnectionView, ConnectionViewSchema, ContractVersionSchema, type CredentialStatus, CredentialStatusSchema, CurrencySchema, DateSchema, Digest, type ExternalHttpResultData, ExternalHttpResultDataSchema, ExternalPathSchema, ExternalQueryMappingSchema, ExternalQueryMappingsSchema, ExternalQueryValueSchema, type ExternalResponseFormat, ExternalResponseFormatSchema, type FeatureFacts, type FieldProjection, FieldProjectionSchema, GrantedTool, HashSchema, IdSchema, LanguageSchema, MAX_STORE_CATEGORY_PROMPT_CONDITIONS, MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS, MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS, MoneySchema, type ResponseFilter, ResponseFilterSchema, type ResponseProcessing, ResponseProcessingSchema, type RevisionInput, RevisionInputSchema, STORE_CATEGORY_PROMPT_RUNTIME_VERSION, SemverSchema, type StoreCategoryPromptConditionKey, StoreCategoryPromptConditionKeySchema, type StoreCategoryPromptContext, StoreCategoryPromptContextSchema, type StoreCategoryPromptRenderResult, type StoreCategoryPromptTemplateIssue, type StoreCategoryPromptTemplateValidation, SubsetSchema, ToolDescriptor, type TransformResponse, TransformResponseSchema, type TransformSample, TransformSampleSchema, type VisualResponseProcessing, VisualResponseProcessingSchema, type VisualResponseProcessorInput, type VisualResponseProcessorResult, boundedJson, createStoreCategoryPromptConditionBlock, createStoreCategoryPromptContext, currentlyGrantedTools, deduplicateTools, distinct, exampleDefinition, exampleFinal, exampleGrant, exampleManifest, exampleTool, exampleTurn, manifestMatchesGrant, parseCommerceManifest, renderStoreCategoryPromptTemplate, selectCapabilities, validateStoreCategoryPromptTemplate };

package/dist/commerce/index.js

@@ -95,6 +95,384 @@ import {
 } from "../chunk-AUS3WQIW.js";
 import "../chunk-4KSODB2R.js";
 
+// src/commerce/store-category-prompt.ts
+import { z } from "zod";
+var STORE_CATEGORY_PROMPT_RUNTIME_VERSION = "store-category-prompt.v1";
+var MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS = 1e5;
+var MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS = 1e5;
+var MAX_STORE_CATEGORY_PROMPT_CONDITIONS = 256;
+var MAX_CONTROL_TAGS = 512;
+var MAX_CONTROL_DEPTH = 8;
+var MAX_EXPRESSION_CHARS = 1024;
+var forbiddenConditionKeys = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+var conditionKeyPattern = /^[a-z][a-z0-9_]{0,127}$/;
+var StoreCategoryPromptConditionKeySchema = z.string().regex(conditionKeyPattern).refine((value) => !forbiddenConditionKeys.has(value));
+var StoreCategoryPromptContextSchema = z.strictObject({
+  mappings: z.record(StoreCategoryPromptConditionKeySchema, z.boolean()).refine((value) => Object.keys(value).length <= MAX_STORE_CATEGORY_PROMPT_CONDITIONS)
+});
+function issue(code, message) {
+  return { path: "/promptText", code, message };
+}
+function boundedIssues(issues) {
+  return issues.slice(0, 32).map((entry) => ({
+    path: entry.path,
+    code: entry.code,
+    message: entry.message.slice(0, 512)
+  }));
+}
+function sourceLength(value) {
+  return Array.from(value).length;
+}
+function findNextMarker(source, start) {
+  let best = null;
+  for (const marker of ["{%", "{{", "{#"]) {
+    const index = source.indexOf(marker, start);
+    if (index >= 0 && (!best || index < best.index)) best = { index, marker };
+  }
+  return best;
+}
+function tokenizeTemplate(source, issues) {
+  const tokens = [];
+  let cursor = 0;
+  while (cursor < source.length) {
+    const next = findNextMarker(source, cursor);
+    if (!next) {
+      tokens.push({ kind: "text", text: source.slice(cursor) });
+      break;
+    }
+    if (next.index > cursor) tokens.push({ kind: "text", text: source.slice(cursor, next.index) });
+    const closeMarker = next.marker === "{%" ? "%}" : next.marker === "{{" ? "}}" : "#}";
+    const close = source.indexOf(closeMarker, next.index + 2);
+    if (close < 0) {
+      issues.push(issue("invalid_template_structure", `Unclosed ${next.marker} template construct.`));
+      tokens.push({ kind: "text", text: source.slice(next.index) });
+      break;
+    }
+    const raw = source.slice(next.index + 2, close).trim();
+    if (next.marker === "{%") tokens.push({ kind: "control", source: raw });
+    else tokens.push({ kind: "unsupported", source: raw, marker: next.marker === "{{" ? "interpolation" : "comment" });
+    cursor = close + 2;
+  }
+  if (source.length === 0) tokens.push({ kind: "text", text: "" });
+  return tokens;
+}
+function lexExpression(source, issues) {
+  if (sourceLength(source) > MAX_EXPRESSION_CHARS) {
+    issues.push(issue("template_too_complex", `Conditional expressions must not exceed ${MAX_EXPRESSION_CHARS} characters.`));
+    return null;
+  }
+  const tokens = [];
+  let cursor = 0;
+  while (cursor < source.length) {
+    const char = source[cursor];
+    if (/\s/.test(char)) {
+      cursor += 1;
+      continue;
+    }
+    if (char === ".") {
+      tokens.push({ kind: "dot" });
+      cursor += 1;
+      continue;
+    }
+    if (char === "(") {
+      tokens.push({ kind: "lparen" });
+      cursor += 1;
+      continue;
+    }
+    if (char === ")") {
+      tokens.push({ kind: "rparen" });
+      cursor += 1;
+      continue;
+    }
+    const match = /^[A-Za-z_][A-Za-z0-9_]*/.exec(source.slice(cursor));
+    if (!match) {
+      issues.push(issue("invalid_template_expression", "Conditional expressions may only use mappings.<conditionKey>, not, and, or, and parentheses."));
+      return null;
+    }
+    tokens.push({ kind: "word", value: match[0] });
+    cursor += match[0].length;
+  }
+  return tokens;
+}
+function parseExpression(source, issues, referenced) {
+  const tokens = lexExpression(source, issues);
+  if (!tokens || tokens.length === 0) {
+    if (tokens?.length === 0) issues.push(issue("invalid_template_expression", "A conditional expression is required."));
+    return null;
+  }
+  let index = 0;
+  const peekWord = (word) => {
+    const token = tokens[index];
+    return token?.kind === "word" && token.value === word;
+  };
+  const parsePrimary = () => {
+    const token = tokens[index];
+    if (token?.kind === "lparen") {
+      index += 1;
+      const inner = parseOr();
+      if (tokens[index]?.kind !== "rparen") {
+        issues.push(issue("invalid_template_expression", "Conditional expression parentheses are unbalanced."));
+        return null;
+      }
+      index += 1;
+      return inner;
+    }
+    if (!peekWord("mappings")) {
+      issues.push(issue("invalid_template_expression", "Conditional expressions must reference mappings.<conditionKey>."));
+      return null;
+    }
+    index += 1;
+    if (tokens[index]?.kind !== "dot") {
+      issues.push(issue("invalid_template_expression", "Mapping conditions must use mappings.<conditionKey>."));
+      return null;
+    }
+    index += 1;
+    const keyToken = tokens[index];
+    if (keyToken?.kind !== "word") {
+      issues.push(issue("invalid_mapping_condition", "A valid mapping condition key is required after mappings."));
+      return null;
+    }
+    index += 1;
+    if (!StoreCategoryPromptConditionKeySchema.safeParse(keyToken.value).success) {
+      issues.push(issue("invalid_mapping_condition", `Invalid mapping condition key: ${keyToken.value}.`));
+      return null;
+    }
+    if (!referenced.includes(keyToken.value)) referenced.push(keyToken.value);
+    return { kind: "condition", key: keyToken.value };
+  };
+  const parseNot = () => {
+    if (peekWord("not")) {
+      index += 1;
+      const operand = parseNot();
+      return operand ? { kind: "not", operand } : null;
+    }
+    return parsePrimary();
+  };
+  const parseAnd = () => {
+    let left = parseNot();
+    while (left && peekWord("and")) {
+      index += 1;
+      const right = parseNot();
+      if (!right) return null;
+      left = { kind: "and", left, right };
+    }
+    return left;
+  };
+  const parseOr = () => {
+    let left = parseAnd();
+    while (left && peekWord("or")) {
+      index += 1;
+      const right = parseAnd();
+      if (!right) return null;
+      left = { kind: "or", left, right };
+    }
+    return left;
+  };
+  const expression = parseOr();
+  if (expression && index !== tokens.length) {
+    issues.push(issue("invalid_template_expression", "Conditional expression contains unsupported syntax."));
+    return null;
+  }
+  return expression;
+}
+function compileStoreCategoryPromptTemplate(source) {
+  const issues = [];
+  const referencedConditionKeys = [];
+  const nodes = [];
+  if (source.trim().length === 0) issues.push(issue("invalid_prompt_source", "Prompt template must not be blank."));
+  if (sourceLength(source) > MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS) {
+    issues.push(issue("invalid_prompt_source", `Prompt template must not exceed ${MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS.toLocaleString()} characters.`));
+  }
+  const tokens = tokenizeTemplate(source, issues);
+  const stack = [];
+  let currentBody = nodes;
+  let controlCount = 0;
+  for (const token of tokens) {
+    if (token.kind === "text") {
+      if (token.text) currentBody.push({ kind: "text", text: token.text });
+      continue;
+    }
+    if (token.kind === "unsupported") {
+      issues.push(issue(
+        "unsupported_template_construct",
+        token.marker === "interpolation" ? "Variable interpolation is not supported in Store Category prompt templates." : "Template comments are not supported in Store Category prompt templates."
+      ));
+      continue;
+    }
+    controlCount += 1;
+    if (controlCount > MAX_CONTROL_TAGS) {
+      issues.push(issue("template_too_complex", `Prompt template must not contain more than ${MAX_CONTROL_TAGS} control tags.`));
+      break;
+    }
+    const ifMatch = /^if\s+([\s\S]+)$/.exec(token.source);
+    if (ifMatch) {
+      if (stack.length >= MAX_CONTROL_DEPTH) {
+        issues.push(issue("template_too_complex", `Conditional nesting must not exceed ${MAX_CONTROL_DEPTH} levels.`));
+        continue;
+      }
+      const expression = parseExpression(ifMatch[1].trim(), issues, referencedConditionKeys);
+      if (!expression) continue;
+      const branchBody = [];
+      const node = {
+        kind: "if",
+        branches: [{ expression, body: branchBody }],
+        elseBody: null
+      };
+      currentBody.push(node);
+      const frame = { node, parentBody: currentBody, currentBody: branchBody, sawElse: false };
+      stack.push(frame);
+      currentBody = branchBody;
+      continue;
+    }
+    const elifMatch = /^elif\s+([\s\S]+)$/.exec(token.source);
+    if (elifMatch) {
+      const frame = stack.at(-1);
+      if (!frame || frame.sawElse) {
+        issues.push(issue("invalid_template_structure", "elif must appear inside an if block and before else."));
+        continue;
+      }
+      const expression = parseExpression(elifMatch[1].trim(), issues, referencedConditionKeys);
+      if (!expression) continue;
+      const branchBody = [];
+      frame.node.branches.push({ expression, body: branchBody });
+      frame.currentBody = branchBody;
+      currentBody = branchBody;
+      continue;
+    }
+    if (token.source === "else") {
+      const frame = stack.at(-1);
+      if (!frame || frame.sawElse) {
+        issues.push(issue("invalid_template_structure", "else must appear once inside an if block."));
+        continue;
+      }
+      const elseBody = [];
+      frame.node.elseBody = elseBody;
+      frame.currentBody = elseBody;
+      frame.sawElse = true;
+      currentBody = elseBody;
+      continue;
+    }
+    if (token.source === "endif") {
+      const frame = stack.pop();
+      if (!frame) {
+        issues.push(issue("invalid_template_structure", "endif does not have a matching if block."));
+        continue;
+      }
+      currentBody = frame.parentBody;
+      continue;
+    }
+    issues.push(issue(
+      "unsupported_template_construct",
+      "Only if, elif, else, and endif control tags are supported in Store Category prompt templates."
+    ));
+  }
+  if (stack.length) issues.push(issue("invalid_template_structure", "Every if block must end with endif."));
+  return { issues: boundedIssues(issues), nodes, referencedConditionKeys };
+}
+function validateAvailableConditionKeys(values, issues) {
+  if (values.length > MAX_STORE_CATEGORY_PROMPT_CONDITIONS) {
+    issues.push(issue("template_too_complex", `At most ${MAX_STORE_CATEGORY_PROMPT_CONDITIONS} mapping conditions are supported.`));
+  }
+  const keys = /* @__PURE__ */ new Set();
+  for (const value of values.slice(0, MAX_STORE_CATEGORY_PROMPT_CONDITIONS + 1)) {
+    if (!StoreCategoryPromptConditionKeySchema.safeParse(value).success) {
+      issues.push(issue("invalid_mapping_condition", `Invalid mapping condition key: ${value}.`));
+      continue;
+    }
+    if (keys.has(value)) {
+      issues.push(issue("invalid_mapping_condition", `Duplicate mapping condition key: ${value}.`));
+      continue;
+    }
+    keys.add(value);
+  }
+  return keys;
+}
+function validateStoreCategoryPromptTemplate(input) {
+  const compiled = compileStoreCategoryPromptTemplate(input.source);
+  const issues = [...compiled.issues];
+  const available = validateAvailableConditionKeys(input.availableConditionKeys, issues);
+  for (const key of compiled.referencedConditionKeys) {
+    if (!available.has(key)) issues.push(issue("unknown_mapping_condition", `Prompt template references unavailable mapping condition: mappings.${key}.`));
+  }
+  const bounded = boundedIssues(issues);
+  return { valid: bounded.length === 0, issues: bounded, referencedConditionKeys: compiled.referencedConditionKeys };
+}
+function createStoreCategoryPromptConditionBlock(conditionKey) {
+  const parsed = StoreCategoryPromptConditionKeySchema.safeParse(conditionKey);
+  if (!parsed.success) throw new TypeError(`Invalid mapping condition key: ${conditionKey}.`);
+  return `{% if mappings.${conditionKey} %}
+
+{% endif %}`;
+}
+function createStoreCategoryPromptContext(input) {
+  const issues = [];
+  const available = validateAvailableConditionKeys(input.availableConditionKeys, issues);
+  const selected = validateAvailableConditionKeys(input.selectedConditionKeys, issues);
+  for (const key of selected) {
+    if (!available.has(key)) issues.push(issue("unknown_mapping_condition", `Selected mapping condition is unavailable: ${key}.`));
+  }
+  if (issues.length) throw new TypeError(issues[0].message);
+  const mappings = /* @__PURE__ */ Object.create(null);
+  for (const key of available) mappings[key] = selected.has(key);
+  return { mappings };
+}
+function evaluateExpression(expression, mappings) {
+  switch (expression.kind) {
+    case "condition":
+      return mappings[expression.key] === true;
+    case "not":
+      return !evaluateExpression(expression.operand, mappings);
+    case "and":
+      return evaluateExpression(expression.left, mappings) && evaluateExpression(expression.right, mappings);
+    case "or":
+      return evaluateExpression(expression.left, mappings) || evaluateExpression(expression.right, mappings);
+  }
+}
+function renderNodes(nodes, mappings, append) {
+  for (const node of nodes) {
+    if (node.kind === "text") {
+      if (!append(node.text)) return false;
+      continue;
+    }
+    let renderedBranch = false;
+    for (const branch of node.branches) {
+      if (evaluateExpression(branch.expression, mappings)) {
+        if (!renderNodes(branch.body, mappings, append)) return false;
+        renderedBranch = true;
+        break;
+      }
+    }
+    if (!renderedBranch && node.elseBody && !renderNodes(node.elseBody, mappings, append)) return false;
+  }
+  return true;
+}
+function renderStoreCategoryPromptTemplate(input) {
+  const contextResult = StoreCategoryPromptContextSchema.safeParse(input.context);
+  if (!contextResult.success) {
+    return { ok: false, issues: [issue("invalid_mapping_condition", "Store Category prompt context contains invalid mapping conditions.")] };
+  }
+  const availableConditionKeys = Object.keys(contextResult.data.mappings);
+  const validation = validateStoreCategoryPromptTemplate({ source: input.source, availableConditionKeys });
+  if (!validation.valid) return { ok: false, issues: validation.issues };
+  const compiled = compileStoreCategoryPromptTemplate(input.source);
+  let output = "";
+  let outputChars = 0;
+  const append = (text) => {
+    outputChars += sourceLength(text);
+    if (outputChars > MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS) return false;
+    output += text;
+    return true;
+  };
+  const rendered = renderNodes(compiled.nodes, contextResult.data.mappings, append);
+  if (!rendered) {
+    return {
+      ok: false,
+      issues: [issue("rendered_prompt_too_large", `Rendered prompt must not exceed ${MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS.toLocaleString()} characters.`)]
+    };
+  }
+  return { ok: true, promptText: output, referencedConditionKeys: validation.referencedConditionKeys };
+}
+
 // src/commerce/fixtures.ts
 var exampleTool = {
   toolId: "tool-fixture",
@@ -240,6 +618,9 @@ export {
   IdSchema,
   InputSchemaSchema,
   LanguageSchema,
+  MAX_STORE_CATEGORY_PROMPT_CONDITIONS,
+  MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS,
+  MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS,
   MONEY_PATTERN,
   MoneySchema,
   POLICY_OPERATIONS,
@@ -249,7 +630,10 @@ export {
   ResponseProcessingSchema,
   ResponseTemplateSchema,
   RevisionInputSchema,
+  STORE_CATEGORY_PROMPT_RUNTIME_VERSION,
   SemverSchema,
+  StoreCategoryPromptConditionKeySchema,
+  StoreCategoryPromptContextSchema,
   ToolDescriptorSchema,
   ToolNameSchema,
   TransformResponseSchema,
@@ -259,6 +643,8 @@ export {
   canonicalJson,
   commerceToolResultSchema,
   compileSubset,
+  createStoreCategoryPromptConditionBlock,
+  createStoreCategoryPromptContext,
   currentlyGrantedTools,
   deduplicateTools,
   definitionToMcpDescriptor,
@@ -277,6 +663,7 @@ export {
   matchesSubset,
   parseCommerceManifest,
   productBelongsToDomain,
+  renderStoreCategoryPromptTemplate,
   responseContractCanonicalJson,
   safeName,
   safePath,
@@ -284,6 +671,7 @@ export {
   toolHashInput,
   validateDefinitionForPublication,
   validateDefinitionVersion,
+  validateStoreCategoryPromptTemplate,
   validateSubset,
   verifyResponseContract
 };

package/dist/commerce/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commerce/fixtures.ts"],"sourcesContent":["/** Synthetic examples; no provider identity, schema artifact or publication claim. */\nimport type {\n  CommerceManifest,\n  CommerceConversationGrant,\n  CommerceTurnIdentity,\n} from \"./schemas\";\nimport {\n  EMPTY_RESPONSE_CONTRACT,\n  type CommerceFinalResponse,\n} from \"./response\";\nimport type { Digest } from \"./canonical-json\";\nimport { responseContractCanonicalJson } from \"./canonical-json\";\nimport type { ToolDescriptor, CommerceToolDefinition } from \"./definitions\";\nexport const exampleTool: ToolDescriptor = {\n  toolId: \"tool-fixture\",\n  toolRevisionId: \"revision-fixture\",\n  name: \"never_seeded_catalogue_facts\",\n  definitionVersion: \"1.0.0\",\n  description: \"Read synthetic catalogue facts.\",\n  inputSchema: {\n    type: \"object\",\n    properties: { handle: { type: \"string\", minLength: 1, maxLength: 255 } },\n    required: [\"handle\"],\n    additionalProperties: false,\n  },\n};\nexport const exampleDefinition: CommerceToolDefinition = {\n  name: exampleTool.name,\n  definitionVersion: \"1.0.0\",\n  description: exampleTool.description,\n  inputSchema: exampleTool.inputSchema,\n  execution: {\n    kind: \"SHOPIFY_STOREFRONT_QUERY\",\n    executorVersion: \"1.0.0\",\n    apiVersion: \"2026-07\",\n    schemaHash: \"a\".repeat(64),\n    document:\n      \"query ProductDetails($handle: String!) { product(handle: $handle) { title description } }\",\n    operationName: \"ProductDetails\",\n    variables: { handle: { input: \"handle\" } },\n    resultPath: \"product\",\n  },\n  responseTemplate: {\n    kind: \"text\",\n    text: \"{{result.values.title}}: {{result.values.description}}\",\n    unavailable: \"Product details could not be verified.\",\n  },\n};\nexport const exampleTurn: CommerceTurnIdentity = {\n  contractVersion: \"commerce.v1\",\n  shopId: \"shop-fixture\",\n  checkoutRecoveryId: \"recovery-fixture\",\n  conversationId: \"conversation-fixture\",\n  inboundVersion: 1,\n};\nexport function exampleManifest(\n  digest: Digest,\n  withTool = false,\n): CommerceManifest {\n  const capabilities = withTool\n    ? [{\n        capabilityId: \"capability-fixture\",\n        key: \"feature_product_read\",\n        featureId: \"feature-fixture\",\n        position: 0,\n        toolDescriptor: structuredClone(exampleTool),\n      }]\n    : [];\n  return {\n    contractVersion: \"commerce.v1\",\n    releaseId: \"release-fixture\",\n    runnerCompatibility: \"^1.0.0\",\n    capabilities,\n    featureBehaviours: withTool\n      ? [{ featureId: \"feature-fixture\", behaviourPrompt: \"Synthetic Feature behavior.\" }]\n      : [],\n    selectedCapabilityKeys: capabilities.map((capability) => capability.key),\n    grantedTools: withTool\n      ? [\n          {\n            toolId: exampleTool.toolId,\n            toolRevisionId: exampleTool.toolRevisionId,\n            toolName: exampleTool.name,\n            definitionVersion: \"1.0.0\",\n            capabilityKeys: [\"feature_product_read\"],\n          },\n        ]\n      : [],\n    responseContract: structuredClone(EMPTY_RESPONSE_CONTRACT),\n    responseContractHash: digest(\n      responseContractCanonicalJson(EMPTY_RESPONSE_CONTRACT),\n    ),\n  };\n}\nexport function exampleGrant(\n  manifest: CommerceManifest,\n): CommerceConversationGrant {\n  return {\n    id: \"grant-fixture\",\n    shopId: exampleTurn.shopId,\n    conversationId: exampleTurn.conversationId,\n    initialInboundVersion: 1,\n    releaseId: manifest.releaseId,\n    selectedCapabilityKeys: [...manifest.selectedCapabilityKeys],\n    grantedTools: structuredClone(manifest.grantedTools),\n    runnerVersion: \"1.0.0\",\n    createdAt: \"2026-09-20T00:00:00.000Z\",\n    expiresAt: null,\n  };\n}\nexport const exampleFinal: CommerceFinalResponse = {\n  answerKind: \"REFER_TO_STORE\",\n  replyText:\n    \"I cannot verify that information. Please contact the store directly.\",\n  referralReason: \"INSUFFICIENT_TOOLS\",\n  detectedLanguageTag: null,\n  detectedLanguageConfidence: null,\n  evidenceIds: [],\n  details: {},\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaO,IAAM,cAA8B;AAAA,EACzC,QAAQ;AAAA,EACR,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,mBAAmB;AAAA,EACnB,aAAa;AAAA,EACb,aAAa;AAAA,IACX,MAAM;AAAA,IACN,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,WAAW,GAAG,WAAW,IAAI,EAAE;AAAA,IACvE,UAAU,CAAC,QAAQ;AAAA,IACnB,sBAAsB;AAAA,EACxB;AACF;AACO,IAAM,oBAA4C;AAAA,EACvD,MAAM,YAAY;AAAA,EAClB,mBAAmB;AAAA,EACnB,aAAa,YAAY;AAAA,EACzB,aAAa,YAAY;AAAA,EACzB,WAAW;AAAA,IACT,MAAM;AAAA,IACN,iBAAiB;AAAA,IACjB,YAAY;AAAA,IACZ,YAAY,IAAI,OAAO,EAAE;AAAA,IACzB,UACE;AAAA,IACF,eAAe;AAAA,IACf,WAAW,EAAE,QAAQ,EAAE,OAAO,SAAS,EAAE;AAAA,IACzC,YAAY;AAAA,EACd;AAAA,EACA,kBAAkB;AAAA,IAChB,MAAM;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AACF;AACO,IAAM,cAAoC;AAAA,EAC/C,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,gBAAgB;AAClB;AACO,SAAS,gBACd,QACA,WAAW,OACO;AAClB,QAAM,eAAe,WACjB,CAAC;AAAA,IACC,cAAc;AAAA,IACd,KAAK;AAAA,IACL,WAAW;AAAA,IACX,UAAU;AAAA,IACV,gBAAgB,gBAAgB,WAAW;AAAA,EAC7C,CAAC,IACD,CAAC;AACL,SAAO;AAAA,IACL,iBAAiB;AAAA,IACjB,WAAW;AAAA,IACX,qBAAqB;AAAA,IACrB;AAAA,IACA,mBAAmB,WACf,CAAC,EAAE,WAAW,mBAAmB,iBAAiB,8BAA8B,CAAC,IACjF,CAAC;AAAA,IACL,wBAAwB,aAAa,IAAI,CAAC,eAAe,WAAW,GAAG;AAAA,IACvE,cAAc,WACV;AAAA,MACE;AAAA,QACE,QAAQ,YAAY;AAAA,QACpB,gBAAgB,YAAY;AAAA,QAC5B,UAAU,YAAY;AAAA,QACtB,mBAAmB;AAAA,QACnB,gBAAgB,CAAC,sBAAsB;AAAA,MACzC;AAAA,IACF,IACA,CAAC;AAAA,IACL,kBAAkB,gBAAgB,uBAAuB;AAAA,IACzD,sBAAsB;AAAA,MACpB,8BAA8B,uBAAuB;AAAA,IACvD;AAAA,EACF;AACF;AACO,SAAS,aACd,UAC2B;AAC3B,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ,YAAY;AAAA,IACpB,gBAAgB,YAAY;AAAA,IAC5B,uBAAuB;AAAA,IACvB,WAAW,SAAS;AAAA,IACpB,wBAAwB,CAAC,GAAG,SAAS,sBAAsB;AAAA,IAC3D,cAAc,gBAAgB,SAAS,YAAY;AAAA,IACnD,eAAe;AAAA,IACf,WAAW;AAAA,IACX,WAAW;AAAA,EACb;AACF;AACO,IAAM,eAAsC;AAAA,EACjD,YAAY;AAAA,EACZ,WACE;AAAA,EACF,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,4BAA4B;AAAA,EAC5B,aAAa,CAAC;AAAA,EACd,SAAS,CAAC;AACZ;","names":[]}
+{"version":3,"sources":["../../src/commerce/store-category-prompt.ts","../../src/commerce/fixtures.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const STORE_CATEGORY_PROMPT_RUNTIME_VERSION = \"store-category-prompt.v1\" as const;\nexport const MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS = 100_000;\nexport const MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS = 100_000;\nexport const MAX_STORE_CATEGORY_PROMPT_CONDITIONS = 256;\nconst MAX_CONTROL_TAGS = 512;\nconst MAX_CONTROL_DEPTH = 8;\nconst MAX_EXPRESSION_CHARS = 1_024;\n\nconst forbiddenConditionKeys = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\nconst conditionKeyPattern = /^[a-z][a-z0-9_]{0,127}$/;\n\nexport const StoreCategoryPromptConditionKeySchema = z\n  .string()\n  .regex(conditionKeyPattern)\n  .refine((value) => !forbiddenConditionKeys.has(value));\n\nexport type StoreCategoryPromptConditionKey = z.infer<typeof StoreCategoryPromptConditionKeySchema>;\n\nexport const StoreCategoryPromptContextSchema = z.strictObject({\n  mappings: z\n    .record(StoreCategoryPromptConditionKeySchema, z.boolean())\n    .refine((value) => Object.keys(value).length <= MAX_STORE_CATEGORY_PROMPT_CONDITIONS),\n});\n\nexport type StoreCategoryPromptContext = z.infer<typeof StoreCategoryPromptContextSchema>;\n\nexport type StoreCategoryPromptTemplateIssue = {\n  path: \"/promptText\";\n  code:\n    | \"invalid_prompt_source\"\n    | \"unsupported_template_construct\"\n    | \"invalid_template_structure\"\n    | \"invalid_template_expression\"\n    | \"invalid_mapping_condition\"\n    | \"unknown_mapping_condition\"\n    | \"template_too_complex\"\n    | \"rendered_prompt_too_large\";\n  message: string;\n};\n\nexport type StoreCategoryPromptTemplateValidation = {\n  valid: boolean;\n  issues: StoreCategoryPromptTemplateIssue[];\n  referencedConditionKeys: string[];\n};\n\nexport type StoreCategoryPromptRenderResult =\n  | { ok: true; promptText: string; referencedConditionKeys: string[] }\n  | { ok: false; issues: StoreCategoryPromptTemplateIssue[] };\n\ntype ExpressionNode =\n  | { kind: \"condition\"; key: string }\n  | { kind: \"not\"; operand: ExpressionNode }\n  | { kind: \"and\"; left: ExpressionNode; right: ExpressionNode }\n  | { kind: \"or\"; left: ExpressionNode; right: ExpressionNode };\n\ntype TemplateNode =\n  | { kind: \"text\"; text: string }\n  | {\n      kind: \"if\";\n      branches: Array<{ expression: ExpressionNode; body: TemplateNode[] }>;\n      elseBody: TemplateNode[] | null;\n    };\n\ntype TemplateToken =\n  | { kind: \"text\"; text: string }\n  | { kind: \"control\"; source: string }\n  | { kind: \"unsupported\"; source: string; marker: \"interpolation\" | \"comment\" };\n\ntype CompileResult = {\n  issues: StoreCategoryPromptTemplateIssue[];\n  nodes: TemplateNode[];\n  referencedConditionKeys: string[];\n};\n\nfunction issue(code: StoreCategoryPromptTemplateIssue[\"code\"], message: string): StoreCategoryPromptTemplateIssue {\n  return { path: \"/promptText\", code, message };\n}\n\nfunction boundedIssues(issues: StoreCategoryPromptTemplateIssue[]): StoreCategoryPromptTemplateIssue[] {\n  return issues.slice(0, 32).map((entry) => ({\n    path: entry.path,\n    code: entry.code,\n    message: entry.message.slice(0, 512),\n  }));\n}\n\nfunction sourceLength(value: string): number {\n  return Array.from(value).length;\n}\n\nfunction findNextMarker(source: string, start: number): { index: number; marker: \"{%\" | \"{{\" | \"{#\" } | null {\n  let best: { index: number; marker: \"{%\" | \"{{\" | \"{#\" } | null = null;\n  for (const marker of [\"{%\", \"{{\", \"{#\"] as const) {\n    const index = source.indexOf(marker, start);\n    if (index >= 0 && (!best || index < best.index)) best = { index, marker };\n  }\n  return best;\n}\n\nfunction tokenizeTemplate(source: string, issues: StoreCategoryPromptTemplateIssue[]): TemplateToken[] {\n  const tokens: TemplateToken[] = [];\n  let cursor = 0;\n  while (cursor < source.length) {\n    const next = findNextMarker(source, cursor);\n    if (!next) {\n      tokens.push({ kind: \"text\", text: source.slice(cursor) });\n      break;\n    }\n    if (next.index > cursor) tokens.push({ kind: \"text\", text: source.slice(cursor, next.index) });\n    const closeMarker = next.marker === \"{%\" ? \"%}\" : next.marker === \"{{\" ? \"}}\" : \"#}\";\n    const close = source.indexOf(closeMarker, next.index + 2);\n    if (close < 0) {\n      issues.push(issue(\"invalid_template_structure\", `Unclosed ${next.marker} template construct.`));\n      tokens.push({ kind: \"text\", text: source.slice(next.index) });\n      break;\n    }\n    const raw = source.slice(next.index + 2, close).trim();\n    if (next.marker === \"{%\") tokens.push({ kind: \"control\", source: raw });\n    else tokens.push({ kind: \"unsupported\", source: raw, marker: next.marker === \"{{\" ? \"interpolation\" : \"comment\" });\n    cursor = close + 2;\n  }\n  if (source.length === 0) tokens.push({ kind: \"text\", text: \"\" });\n  return tokens;\n}\n\ntype ExprToken = { kind: \"word\"; value: string } | { kind: \"dot\" } | { kind: \"lparen\" } | { kind: \"rparen\" };\n\nfunction lexExpression(source: string, issues: StoreCategoryPromptTemplateIssue[]): ExprToken[] | null {\n  if (sourceLength(source) > MAX_EXPRESSION_CHARS) {\n    issues.push(issue(\"template_too_complex\", `Conditional expressions must not exceed ${MAX_EXPRESSION_CHARS} characters.`));\n    return null;\n  }\n  const tokens: ExprToken[] = [];\n  let cursor = 0;\n  while (cursor < source.length) {\n    const char = source[cursor];\n    if (/\\s/.test(char)) {\n      cursor += 1;\n      continue;\n    }\n    if (char === \".\") {\n      tokens.push({ kind: \"dot\" });\n      cursor += 1;\n      continue;\n    }\n    if (char === \"(\") {\n      tokens.push({ kind: \"lparen\" });\n      cursor += 1;\n      continue;\n    }\n    if (char === \")\") {\n      tokens.push({ kind: \"rparen\" });\n      cursor += 1;\n      continue;\n    }\n    const match = /^[A-Za-z_][A-Za-z0-9_]*/.exec(source.slice(cursor));\n    if (!match) {\n      issues.push(issue(\"invalid_template_expression\", \"Conditional expressions may only use mappings.<conditionKey>, not, and, or, and parentheses.\"));\n      return null;\n    }\n    tokens.push({ kind: \"word\", value: match[0] });\n    cursor += match[0].length;\n  }\n  return tokens;\n}\n\nfunction parseExpression(source: string, issues: StoreCategoryPromptTemplateIssue[], referenced: string[]): ExpressionNode | null {\n  const tokens = lexExpression(source, issues);\n  if (!tokens || tokens.length === 0) {\n    if (tokens?.length === 0) issues.push(issue(\"invalid_template_expression\", \"A conditional expression is required.\"));\n    return null;\n  }\n  let index = 0;\n  const peekWord = (word: string) => {\n    const token = tokens[index];\n    return token?.kind === \"word\" && token.value === word;\n  };\n\n  const parsePrimary = (): ExpressionNode | null => {\n    const token = tokens[index];\n    if (token?.kind === \"lparen\") {\n      index += 1;\n      const inner = parseOr();\n      if (tokens[index]?.kind !== \"rparen\") {\n        issues.push(issue(\"invalid_template_expression\", \"Conditional expression parentheses are unbalanced.\"));\n        return null;\n      }\n      index += 1;\n      return inner;\n    }\n    if (!peekWord(\"mappings\")) {\n      issues.push(issue(\"invalid_template_expression\", \"Conditional expressions must reference mappings.<conditionKey>.\"));\n      return null;\n    }\n    index += 1;\n    if (tokens[index]?.kind !== \"dot\") {\n      issues.push(issue(\"invalid_template_expression\", \"Mapping conditions must use mappings.<conditionKey>.\"));\n      return null;\n    }\n    index += 1;\n    const keyToken = tokens[index];\n    if (keyToken?.kind !== \"word\") {\n      issues.push(issue(\"invalid_mapping_condition\", \"A valid mapping condition key is required after mappings.\"));\n      return null;\n    }\n    index += 1;\n    if (!StoreCategoryPromptConditionKeySchema.safeParse(keyToken.value).success) {\n      issues.push(issue(\"invalid_mapping_condition\", `Invalid mapping condition key: ${keyToken.value}.`));\n      return null;\n    }\n    if (!referenced.includes(keyToken.value)) referenced.push(keyToken.value);\n    return { kind: \"condition\", key: keyToken.value };\n  };\n\n  const parseNot = (): ExpressionNode | null => {\n    if (peekWord(\"not\")) {\n      index += 1;\n      const operand = parseNot();\n      return operand ? { kind: \"not\", operand } : null;\n    }\n    return parsePrimary();\n  };\n\n  const parseAnd = (): ExpressionNode | null => {\n    let left = parseNot();\n    while (left && peekWord(\"and\")) {\n      index += 1;\n      const right = parseNot();\n      if (!right) return null;\n      left = { kind: \"and\", left, right };\n    }\n    return left;\n  };\n\n  const parseOr = (): ExpressionNode | null => {\n    let left = parseAnd();\n    while (left && peekWord(\"or\")) {\n      index += 1;\n      const right = parseAnd();\n      if (!right) return null;\n      left = { kind: \"or\", left, right };\n    }\n    return left;\n  };\n\n  const expression = parseOr();\n  if (expression && index !== tokens.length) {\n    issues.push(issue(\"invalid_template_expression\", \"Conditional expression contains unsupported syntax.\"));\n    return null;\n  }\n  return expression;\n}\n\nfunction compileStoreCategoryPromptTemplate(source: string): CompileResult {\n  const issues: StoreCategoryPromptTemplateIssue[] = [];\n  const referencedConditionKeys: string[] = [];\n  const nodes: TemplateNode[] = [];\n\n  if (source.trim().length === 0) issues.push(issue(\"invalid_prompt_source\", \"Prompt template must not be blank.\"));\n  if (sourceLength(source) > MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS) {\n    issues.push(issue(\"invalid_prompt_source\", `Prompt template must not exceed ${MAX_STORE_CATEGORY_PROMPT_SOURCE_CHARS.toLocaleString()} characters.`));\n  }\n\n  const tokens = tokenizeTemplate(source, issues);\n  type Frame = {\n    node: Extract<TemplateNode, { kind: \"if\" }>;\n    parentBody: TemplateNode[];\n    currentBody: TemplateNode[];\n    sawElse: boolean;\n  };\n  const stack: Frame[] = [];\n  let currentBody = nodes;\n  let controlCount = 0;\n\n  for (const token of tokens) {\n    if (token.kind === \"text\") {\n      if (token.text) currentBody.push({ kind: \"text\", text: token.text });\n      continue;\n    }\n    if (token.kind === \"unsupported\") {\n      issues.push(issue(\n        \"unsupported_template_construct\",\n        token.marker === \"interpolation\"\n          ? \"Variable interpolation is not supported in Store Category prompt templates.\"\n          : \"Template comments are not supported in Store Category prompt templates.\",\n      ));\n      continue;\n    }\n\n    controlCount += 1;\n    if (controlCount > MAX_CONTROL_TAGS) {\n      issues.push(issue(\"template_too_complex\", `Prompt template must not contain more than ${MAX_CONTROL_TAGS} control tags.`));\n      break;\n    }\n\n    const ifMatch = /^if\\s+([\\s\\S]+)$/.exec(token.source);\n    if (ifMatch) {\n      if (stack.length >= MAX_CONTROL_DEPTH) {\n        issues.push(issue(\"template_too_complex\", `Conditional nesting must not exceed ${MAX_CONTROL_DEPTH} levels.`));\n        continue;\n      }\n      const expression = parseExpression(ifMatch[1].trim(), issues, referencedConditionKeys);\n      if (!expression) continue;\n      const branchBody: TemplateNode[] = [];\n      const node: Extract<TemplateNode, { kind: \"if\" }> = {\n        kind: \"if\",\n        branches: [{ expression, body: branchBody }],\n        elseBody: null,\n      };\n      currentBody.push(node);\n      const frame: Frame = { node, parentBody: currentBody, currentBody: branchBody, sawElse: false };\n      stack.push(frame);\n      currentBody = branchBody;\n      continue;\n    }\n\n    const elifMatch = /^elif\\s+([\\s\\S]+)$/.exec(token.source);\n    if (elifMatch) {\n      const frame = stack.at(-1);\n      if (!frame || frame.sawElse) {\n        issues.push(issue(\"invalid_template_structure\", \"elif must appear inside an if block and before else.\"));\n        continue;\n      }\n      const expression = parseExpression(elifMatch[1].trim(), issues, referencedConditionKeys);\n      if (!expression) continue;\n      const branchBody: TemplateNode[] = [];\n      frame.node.branches.push({ expression, body: branchBody });\n      frame.currentBody = branchBody;\n      currentBody = branchBody;\n      continue;\n    }\n\n    if (token.source === \"else\") {\n      const frame = stack.at(-1);\n      if (!frame || frame.sawElse) {\n        issues.push(issue(\"invalid_template_structure\", \"else must appear once inside an if block.\"));\n        continue;\n      }\n      const elseBody: TemplateNode[] = [];\n      frame.node.elseBody = elseBody;\n      frame.currentBody = elseBody;\n      frame.sawElse = true;\n      currentBody = elseBody;\n      continue;\n    }\n\n    if (token.source === \"endif\") {\n      const frame = stack.pop();\n      if (!frame) {\n        issues.push(issue(\"invalid_template_structure\", \"endif does not have a matching if block.\"));\n        continue;\n      }\n      currentBody = frame.parentBody;\n      continue;\n    }\n\n    issues.push(issue(\n      \"unsupported_template_construct\",\n      \"Only if, elif, else, and endif control tags are supported in Store Category prompt templates.\",\n    ));\n  }\n\n  if (stack.length) issues.push(issue(\"invalid_template_structure\", \"Every if block must end with endif.\"));\n  return { issues: boundedIssues(issues), nodes, referencedConditionKeys };\n}\n\nfunction validateAvailableConditionKeys(values: readonly string[], issues: StoreCategoryPromptTemplateIssue[]): Set<string> {\n  if (values.length > MAX_STORE_CATEGORY_PROMPT_CONDITIONS) {\n    issues.push(issue(\"template_too_complex\", `At most ${MAX_STORE_CATEGORY_PROMPT_CONDITIONS} mapping conditions are supported.`));\n  }\n  const keys = new Set<string>();\n  for (const value of values.slice(0, MAX_STORE_CATEGORY_PROMPT_CONDITIONS + 1)) {\n    if (!StoreCategoryPromptConditionKeySchema.safeParse(value).success) {\n      issues.push(issue(\"invalid_mapping_condition\", `Invalid mapping condition key: ${value}.`));\n      continue;\n    }\n    if (keys.has(value)) {\n      issues.push(issue(\"invalid_mapping_condition\", `Duplicate mapping condition key: ${value}.`));\n      continue;\n    }\n    keys.add(value);\n  }\n  return keys;\n}\n\nexport function validateStoreCategoryPromptTemplate(input: {\n  source: string;\n  availableConditionKeys: readonly string[];\n}): StoreCategoryPromptTemplateValidation {\n  const compiled = compileStoreCategoryPromptTemplate(input.source);\n  const issues = [...compiled.issues];\n  const available = validateAvailableConditionKeys(input.availableConditionKeys, issues);\n  for (const key of compiled.referencedConditionKeys) {\n    if (!available.has(key)) issues.push(issue(\"unknown_mapping_condition\", `Prompt template references unavailable mapping condition: mappings.${key}.`));\n  }\n  const bounded = boundedIssues(issues);\n  return { valid: bounded.length === 0, issues: bounded, referencedConditionKeys: compiled.referencedConditionKeys };\n}\n\n\nexport function createStoreCategoryPromptConditionBlock(conditionKey: string): string {\n  const parsed = StoreCategoryPromptConditionKeySchema.safeParse(conditionKey);\n  if (!parsed.success) throw new TypeError(`Invalid mapping condition key: ${conditionKey}.`);\n  return `{% if mappings.${conditionKey} %}\\n\\n{% endif %}`;\n}\n\nexport function createStoreCategoryPromptContext(input: {\n  availableConditionKeys: readonly string[];\n  selectedConditionKeys: readonly string[];\n}): StoreCategoryPromptContext {\n  const issues: StoreCategoryPromptTemplateIssue[] = [];\n  const available = validateAvailableConditionKeys(input.availableConditionKeys, issues);\n  const selected = validateAvailableConditionKeys(input.selectedConditionKeys, issues);\n  for (const key of selected) {\n    if (!available.has(key)) issues.push(issue(\"unknown_mapping_condition\", `Selected mapping condition is unavailable: ${key}.`));\n  }\n  if (issues.length) throw new TypeError(issues[0].message);\n  const mappings = Object.create(null) as Record<string, boolean>;\n  for (const key of available) mappings[key] = selected.has(key);\n  return { mappings };\n}\n\nfunction evaluateExpression(expression: ExpressionNode, mappings: Record<string, boolean>): boolean {\n  switch (expression.kind) {\n    case \"condition\":\n      return mappings[expression.key] === true;\n    case \"not\":\n      return !evaluateExpression(expression.operand, mappings);\n    case \"and\":\n      return evaluateExpression(expression.left, mappings) && evaluateExpression(expression.right, mappings);\n    case \"or\":\n      return evaluateExpression(expression.left, mappings) || evaluateExpression(expression.right, mappings);\n  }\n}\n\nfunction renderNodes(nodes: TemplateNode[], mappings: Record<string, boolean>, append: (text: string) => boolean): boolean {\n  for (const node of nodes) {\n    if (node.kind === \"text\") {\n      if (!append(node.text)) return false;\n      continue;\n    }\n    let renderedBranch = false;\n    for (const branch of node.branches) {\n      if (evaluateExpression(branch.expression, mappings)) {\n        if (!renderNodes(branch.body, mappings, append)) return false;\n        renderedBranch = true;\n        break;\n      }\n    }\n    if (!renderedBranch && node.elseBody && !renderNodes(node.elseBody, mappings, append)) return false;\n  }\n  return true;\n}\n\nexport function renderStoreCategoryPromptTemplate(input: {\n  source: string;\n  context: StoreCategoryPromptContext;\n}): StoreCategoryPromptRenderResult {\n  const contextResult = StoreCategoryPromptContextSchema.safeParse(input.context);\n  if (!contextResult.success) {\n    return { ok: false, issues: [issue(\"invalid_mapping_condition\", \"Store Category prompt context contains invalid mapping conditions.\")] };\n  }\n  const availableConditionKeys = Object.keys(contextResult.data.mappings);\n  const validation = validateStoreCategoryPromptTemplate({ source: input.source, availableConditionKeys });\n  if (!validation.valid) return { ok: false, issues: validation.issues };\n\n  const compiled = compileStoreCategoryPromptTemplate(input.source);\n  let output = \"\";\n  let outputChars = 0;\n  const append = (text: string) => {\n    outputChars += sourceLength(text);\n    if (outputChars > MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS) return false;\n    output += text;\n    return true;\n  };\n  const rendered = renderNodes(compiled.nodes, contextResult.data.mappings, append);\n  if (!rendered) {\n    return {\n      ok: false,\n      issues: [issue(\"rendered_prompt_too_large\", `Rendered prompt must not exceed ${MAX_STORE_CATEGORY_PROMPT_RENDERED_CHARS.toLocaleString()} characters.`)],\n    };\n  }\n  return { ok: true, promptText: output, referencedConditionKeys: validation.referencedConditionKeys };\n}\n","/** Synthetic examples; no provider identity, schema artifact or publication claim. */\nimport type {\n  CommerceManifest,\n  CommerceConversationGrant,\n  CommerceTurnIdentity,\n} from \"./schemas\";\nimport {\n  EMPTY_RESPONSE_CONTRACT,\n  type CommerceFinalResponse,\n} from \"./response\";\nimport type { Digest } from \"./canonical-json\";\nimport { responseContractCanonicalJson } from \"./canonical-json\";\nimport type { ToolDescriptor, CommerceToolDefinition } from \"./definitions\";\nexport const exampleTool: ToolDescriptor = {\n  toolId: \"tool-fixture\",\n  toolRevisionId: \"revision-fixture\",\n  name: \"never_seeded_catalogue_facts\",\n  definitionVersion: \"1.0.0\",\n  description: \"Read synthetic catalogue facts.\",\n  inputSchema: {\n    type: \"object\",\n    properties: { handle: { type: \"string\", minLength: 1, maxLength: 255 } },\n    required: [\"handle\"],\n    additionalProperties: false,\n  },\n};\nexport const exampleDefinition: CommerceToolDefinition = {\n  name: exampleTool.name,\n  definitionVersion: \"1.0.0\",\n  description: exampleTool.description,\n  inputSchema: exampleTool.inputSchema,\n  execution: {\n    kind: \"SHOPIFY_STOREFRONT_QUERY\",\n    executorVersion: \"1.0.0\",\n    apiVersion: \"2026-07\",\n    schemaHash: \"a\".repeat(64),\n    document:\n      \"query ProductDetails($handle: String!) { product(handle: $handle) { title description } }\",\n    operationName: \"ProductDetails\",\n    variables: { handle: { input: \"handle\" } },\n    resultPath: \"product\",\n  },\n  responseTemplate: {\n    kind: \"text\",\n    text: \"{{result.values.title}}: {{result.values.description}}\",\n    unavailable: \"Product details could not be verified.\",\n  },\n};\nexport const exampleTurn: CommerceTurnIdentity = {\n  contractVersion: \"commerce.v1\",\n  shopId: \"shop-fixture\",\n  checkoutRecoveryId: \"recovery-fixture\",\n  conversationId: \"conversation-fixture\",\n  inboundVersion: 1,\n};\nexport function exampleManifest(\n  digest: Digest,\n  withTool = false,\n): CommerceManifest {\n  const capabilities = withTool\n    ? [{\n        capabilityId: \"capability-fixture\",\n        key: \"feature_product_read\",\n        featureId: \"feature-fixture\",\n        position: 0,\n        toolDescriptor: structuredClone(exampleTool),\n      }]\n    : [];\n  return {\n    contractVersion: \"commerce.v1\",\n    releaseId: \"release-fixture\",\n    runnerCompatibility: \"^1.0.0\",\n    capabilities,\n    featureBehaviours: withTool\n      ? [{ featureId: \"feature-fixture\", behaviourPrompt: \"Synthetic Feature behavior.\" }]\n      : [],\n    selectedCapabilityKeys: capabilities.map((capability) => capability.key),\n    grantedTools: withTool\n      ? [\n          {\n            toolId: exampleTool.toolId,\n            toolRevisionId: exampleTool.toolRevisionId,\n            toolName: exampleTool.name,\n            definitionVersion: \"1.0.0\",\n            capabilityKeys: [\"feature_product_read\"],\n          },\n        ]\n      : [],\n    responseContract: structuredClone(EMPTY_RESPONSE_CONTRACT),\n    responseContractHash: digest(\n      responseContractCanonicalJson(EMPTY_RESPONSE_CONTRACT),\n    ),\n  };\n}\nexport function exampleGrant(\n  manifest: CommerceManifest,\n): CommerceConversationGrant {\n  return {\n    id: \"grant-fixture\",\n    shopId: exampleTurn.shopId,\n    conversationId: exampleTurn.conversationId,\n    initialInboundVersion: 1,\n    releaseId: manifest.releaseId,\n    selectedCapabilityKeys: [...manifest.selectedCapabilityKeys],\n    grantedTools: structuredClone(manifest.grantedTools),\n    runnerVersion: \"1.0.0\",\n    createdAt: \"2026-09-20T00:00:00.000Z\",\n    expiresAt: null,\n  };\n}\nexport const exampleFinal: CommerceFinalResponse = {\n  answerKind: \"REFER_TO_STORE\",\n  replyText:\n    \"I cannot verify that information. Please contact the store directly.\",\n  referralReason: \"INSUFFICIENT_TOOLS\",\n  detectedLanguageTag: null,\n  detectedLanguageConfidence: null,\n  evidenceIds: [],\n  details: {},\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { CatalogueValidationOptions, CountryCode, CountryCodeSchema, CurrencyCode, CurrencyCodeSchema, IcuMessageCatalogue, IcuMessageValues, InternationalContext, InternationalContextSchema, InternationalizationRuntime, InternationalizationRuntimeOptions, LanguageSource, LanguageSourceSchema, LanguageTag, LanguageTagSchema, MODA_SUPPORTED_LANGUAGE_TAGS, ModaSupportedLanguageTag, ModaSupportedLanguageTagSchema, TimeZoneId, TimeZoneIdSchema, canonicaliseLanguageTag, createInternationalizationRuntime, mergeInternationalContext, normalizeCountryCode, normalizeCurrencyCode, normalizeTimeZone, resolveLocaleDirection, resolveModaConfigurationLocale, validateIcuCatalogue } from './internationalization.js';
-export { APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS, ARCH007_BILLING_CONTRACT_SCHEMA_VERSION, BILLING_PLAN_KINDS, BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME, BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME, BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION, BILLING_SYSTEM_MESSAGE_CODES, BILLING_USAGE_METRICS, BillingPlanKind, BillingPlanKindSchema, BillingSubscriptionReconcileJob, BillingSubscriptionReconcileJobSchema, BillingSystemMessageCode, BillingSystemMessageCodeSchema, BillingUsageMetric, BillingUsageMetricSchema, NormalizedWhatsAppStatus, NormalizedWhatsAppStatusSchema, PurchasedRecoveryCreditCounterSnapshot, ShopifyCurrentProviderContext, ShopifyProviderContextIdentityInput, ShopifyPurchaseProviderContext, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createBillingSubscriptionReconcileJobId, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, deriveShopifyProviderContextIdentity, isSameShopifyPurchaseProviderContext, parseBillingSubscriptionReconcileJob, parseNormalizedWhatsAppStatus, safeParseBillingSubscriptionReconcileJob, safeParseNormalizedWhatsAppStatus } from './billing.js';
+export { APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS, ARCH007_BILLING_CONTRACT_SCHEMA_VERSION, BILLING_PLAN_KINDS, BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME, BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME, BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION, BILLING_SYSTEM_MESSAGE_CODES, BILLING_USAGE_METRICS, BillingPlanKind, BillingPlanKindSchema, BillingSubscriptionReconcileJob, BillingSubscriptionReconcileJobSchema, BillingSystemMessageCode, BillingSystemMessageCodeSchema, BillingUsageMetric, BillingUsageMetricSchema, NormalizedWhatsAppStatus, NormalizedWhatsAppStatusSchema, NormalizedWhatsAppStatusV2, NormalizedWhatsAppStatusV2Schema, NormalizedWhatsAppStatusV3, NormalizedWhatsAppStatusV3Schema, PurchasedRecoveryCreditCounterSnapshot, ShopifyCurrentProviderContext, ShopifyProviderContextIdentityInput, ShopifyPurchaseProviderContext, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION, WhatsAppProviderFailureEvidence, WhatsAppProviderFailureEvidenceSchema, WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createBillingSubscriptionReconcileJobId, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, deriveShopifyProviderContextIdentity, isSameShopifyPurchaseProviderContext, parseBillingSubscriptionReconcileJob, parseNormalizedWhatsAppStatus, safeParseBillingSubscriptionReconcileJob, safeParseNormalizedWhatsAppStatus } from './billing.js';
 export { AuthoredSupportBodySchema, MERCHANT_COMMUNICATIONS_JOB_NAMES, MERCHANT_COMMUNICATIONS_QUEUE_NAME, MERCHANT_COMMUNICATIONS_SCHEMA_VERSION, MerchantMessageTranslationContract, MerchantMessageTranslationContractSchema, MerchantMessageTranslationStatus, MerchantMessageTranslationStatusSchema, MerchantSupportMessageContract, MerchantSupportMessageContractSchema, MerchantSupportMessageKind, MerchantSupportMessageKindSchema, MerchantSupportMessageState, MerchantSupportMessageStateSchema, MerchantTranslationBatchContract, MerchantTranslationBatchContractSchema, MerchantTranslationBatchStatus, MerchantTranslationBatchStatusSchema, MerchantTranslationDirection, MerchantTranslationDirectionSchema, MerchantTranslationReconciliationRequestContract, MerchantTranslationReconciliationRequestContractSchema, MerchantTranslationReconciliationScope, MerchantTranslationReconciliationScopeSchema, MerchantTranslationReconciliationStatus, MerchantTranslationReconciliationStatusSchema, PLATFORM_SUPPORT_LANGUAGE_TAG, TranslatedSupportBodySchema, TranslationBatchPollJob, TranslationBatchPollJobSchema, TranslationBatchResultsJob, TranslationBatchResultsJobSchema, TranslationBatchSubmitJob, TranslationBatchSubmitJobSchema, TranslationDispatchJob, TranslationDispatchJobSchema, TranslationReconcileJob, TranslationReconcileJobSchema, countUnicodeGraphemes, requiresMerchantTranslation } from './merchant-communications.js';
 export { EffectiveRecoveryPolicy, EffectiveRecoveryPolicySchema, RECOVERY_OFFER_MODES, RecoveryOfferMode, RecoveryOfferModeSchema, parseEffectiveRecoveryPolicy, safeParseEffectiveRecoveryPolicy } from './recovery-policy.js';
 export { CheckoutCreatedPayloadV2, CheckoutCreatedPayloadV2Schema, CheckoutObservedPayload, CheckoutObservedPayloadSchema, CheckoutUpdatedPayloadV2, CheckoutUpdatedPayloadV2Schema, MAX_LINE_ITEMS, MAX_URL_LENGTH, OrderCompletedPayload, OrderCompletedPayloadSchema, OrderCompletedPayloadV2, OrderCompletedPayloadV2Schema, SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION, SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V1, SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V2, SHOPIFY_COMMERCE_EVENT_TYPES, SHOPIFY_DISCOUNT_SYNC_REASONS, SHOPIFY_DISCOUNT_SYNC_WEBHOOK_TOPICS, SHOPIFY_RECOVERY_EVENT_TYPES_V2, SHOPIFY_WEBHOOK_OUTBOX_DESTINATIONS, SHOPIFY_WEBHOOK_QUEUE_CONTRACTS, ShopifyCartActivityEventV2, ShopifyCartActivityEventV2Schema, ShopifyCartActivityPayloadV2, ShopifyCartActivityPayloadV2Schema, ShopifyCheckoutCreatedEventV2, ShopifyCheckoutCreatedEventV2Schema, ShopifyCheckoutLineItem, ShopifyCheckoutLineItemSchema, ShopifyCheckoutLineItemsSchema, ShopifyCheckoutObservedEvent, ShopifyCheckoutObservedEventSchema, ShopifyCheckoutUpdatedEventV2, ShopifyCheckoutUpdatedEventV2Schema, ShopifyCommerceEvent, ShopifyCommerceEventSchema, ShopifyCommerceEventType, ShopifyCustomerReference, ShopifyCustomerReferenceSchema, ShopifyDiscountSyncJob, ShopifyDiscountSyncJobSchema, ShopifyDiscountSyncReasonSchema, ShopifyDiscountSyncWebhookTopicSchema, ShopifyMoney, ShopifyMoneySchema, ShopifyOrderCompletedEvent, ShopifyOrderCompletedEventSchema, ShopifyOrderCompletedEventV2, ShopifyOrderCompletedEventV2Schema, ShopifyRecoveryEventTypeV2, ShopifyRecoveryEventV2, ShopifyRecoveryEventV2Schema, ShopifyTenant, ShopifyTenantSchema, createShopifyCartActivityOrderingKey, createShopifyCommerceOrderingKey, createShopifyOrderCorrelationOrderingKey, createShopifyOrderOrderingKey, createShopifyPendingRecoveryOrderingKey, isCartActivityEventV2, isCheckoutCreatedEventV2, isCheckoutObservedEvent, isCheckoutUpdatedEventV2, isOrderCompletedEvent, isOrderCompletedEventV2, parseShopifyCommerceEvent, parseShopifyDiscountSyncJob, parseShopifyRecoveryEventV2, safeParseShopifyCommerceEvent, safeParseShopifyDiscountSyncJob, safeParseShopifyRecoveryEventV2 } from './shopify/index.js';

package/dist/index.js

@@ -12,8 +12,12 @@ import {
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
+  NormalizedWhatsAppStatusV2Schema,
+  NormalizedWhatsAppStatusV3Schema,
   WHATSAPP_PROVIDER_STATUSES,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION,
+  WhatsAppProviderFailureEvidenceSchema,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
   availablePurchasedRecoveryCredits,
@@ -27,7 +31,7 @@ import {
   parseNormalizedWhatsAppStatus,
   safeParseBillingSubscriptionReconcileJob,
   safeParseNormalizedWhatsAppStatus
-} from "./chunk-ANBEH6NW.js";
+} from "./chunk-HIHWRUZH.js";
 import {
   EffectiveRecoveryPolicySchema,
   RECOVERY_OFFER_MODES,
@@ -174,6 +178,8 @@ export {
   MerchantTranslationReconciliationStatusSchema,
   ModaSupportedLanguageTagSchema,
   NormalizedWhatsAppStatusSchema,
+  NormalizedWhatsAppStatusV2Schema,
+  NormalizedWhatsAppStatusV3Schema,
   OrderCompletedPayloadSchema,
   OrderCompletedPayloadV2Schema,
   PLATFORM_SUPPORT_LANGUAGE_TAG,
@@ -214,6 +220,8 @@ export {
   TranslationReconcileJobSchema,
   WHATSAPP_PROVIDER_STATUSES,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WHATSAPP_PROVIDER_STATUS_V2_SCHEMA_VERSION,
+  WhatsAppProviderFailureEvidenceSchema,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
   availablePurchasedRecoveryCredits,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/chunk-ANBEH6NW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/billing.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const ARCH007_BILLING_CONTRACT_SCHEMA_VERSION = 1 as const;\nexport const WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION = 2 as const;\nexport const BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION = 1 as const;\nexport const BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME = \"billing-subscription-reconcile\";\nexport const BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME = \"reconcile-subscription\";\nexport const APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS = 300000 as const;\n\nconst SHOPIFY_PROVIDER_CONTEXT_INVALID_PREFIX = \"SHOPIFY_PROVIDER_CONTEXT_INVALID:\";\n\nexport type ShopifyProviderContextIdentityInput = Readonly<{\n  providerSubscriptionId: string | null;\n  planHandle: string;\n  currentPeriodStart: Date | string | null;\n  currentPeriodEnd: Date | string | null;\n}>;\n\nexport type ShopifyPurchaseProviderContext = Readonly<{\n  providerContextIdentity: string;\n  shopifyPlanHandleSnapshot: string;\n  billingPeriodId: string;\n}>;\n\nexport type ShopifyCurrentProviderContext = Readonly<{\n  providerContextIdentity: string;\n  shopifyPlanHandle: string;\n  billingPeriodId: string;\n}>;\n\nfunction invalidShopifyProviderContext(reason: string): never {\n  throw new Error(`${SHOPIFY_PROVIDER_CONTEXT_INVALID_PREFIX}${reason}`);\n}\n\nfunction normalizeShopifyProviderContextDate(\n  name: string,\n  value: Date | string | null,\n): Date {\n  if (value === null || (typeof value !== \"string\" && !(value instanceof Date))) {\n    return invalidShopifyProviderContext(`${name} must be a valid date`);\n  }\n\n  const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    return invalidShopifyProviderContext(`${name} must be a valid date`);\n  }\n  return date;\n}\n\nexport function deriveShopifyProviderContextIdentity(\n  input: ShopifyProviderContextIdentityInput,\n): string {\n  const providerSubscriptionId = typeof input.providerSubscriptionId === \"string\"\n    ? input.providerSubscriptionId.trim()\n    : \"\";\n  if (providerSubscriptionId) return providerSubscriptionId;\n\n  if (typeof input.planHandle !== \"string\" || input.planHandle.trim().length === 0) {\n    return invalidShopifyProviderContext(\"planHandle must be a non-empty string\");\n  }\n\n  const start = normalizeShopifyProviderContextDate(\"currentPeriodStart\", input.currentPeriodStart);\n  const end = normalizeShopifyProviderContextDate(\"currentPeriodEnd\", input.currentPeriodEnd);\n  if (start >= end) {\n    return invalidShopifyProviderContext(\"currentPeriodStart must be before currentPeriodEnd\");\n  }\n\n  return `app-pricing:v1:${encodeURIComponent(input.planHandle.trim())}:${start.toISOString()}:${end.toISOString()}`;\n}\n\nexport function isSameShopifyPurchaseProviderContext(\n  purchase: ShopifyPurchaseProviderContext,\n  current: ShopifyCurrentProviderContext,\n): boolean {\n  return [\n    [purchase.providerContextIdentity, current.providerContextIdentity],\n    [purchase.shopifyPlanHandleSnapshot, current.shopifyPlanHandle],\n    [purchase.billingPeriodId, current.billingPeriodId],\n  ].every(([purchaseValue, currentValue]) =>\n    typeof purchaseValue === \"string\"\n      && typeof currentValue === \"string\"\n      && purchaseValue.trim().length > 0\n      && currentValue.trim().length > 0\n      && purchaseValue.trim() === currentValue.trim(),\n  );\n}\n\nexport const BILLING_PLAN_KINDS = [\"FREE\", \"PAID_METERED\"] as const;\nexport const BillingPlanKindSchema = z.enum(BILLING_PLAN_KINDS);\nexport type BillingPlanKind = z.infer<typeof BillingPlanKindSchema>;\n\nexport const BILLING_USAGE_METRICS = [\n  \"RECOVERY_CONVERSATION\",\n  \"OUTBOUND_AUTOMATED_MESSAGE\",\n  \"DELIVERED_WHATSAPP_MESSAGE\",\n  \"RECOVERY_CREDIT_PACK_PURCHASE\",\n] as const;\nexport const BillingUsageMetricSchema = z.enum(BILLING_USAGE_METRICS);\nexport type BillingUsageMetric = z.infer<typeof BillingUsageMetricSchema>;\n\nexport const BILLING_SYSTEM_MESSAGE_CODES = {\n  FREE_ALLOWANCE_WARNING: \"BILLING_FREE_ALLOWANCE_WARNING\",\n  RECOVERY_CAPACITY_EXHAUSTED: \"BILLING_RECOVERY_CAPACITY_EXHAUSTED\",\n  PLAN_UPGRADED: \"BILLING_PLAN_UPGRADED\",\n  PLAN_DOWNGRADE_SCHEDULED: \"BILLING_PLAN_DOWNGRADE_SCHEDULED\",\n  SUBSCRIPTION_ENDED: \"BILLING_SUBSCRIPTION_ENDED\",\n  SAFETY_LIMIT_REACHED: \"BILLING_SAFETY_LIMIT_REACHED\",\n  REFUND_REQUEST_RECEIVED: \"BILLING_REFUND_REQUEST_RECEIVED\",\n  REFUND_COMPLETED: \"BILLING_REFUND_COMPLETED\",\n  REFUND_REJECTED: \"BILLING_REFUND_REJECTED\",\n} as const;\n\nconst BILLING_SYSTEM_MESSAGE_CODE_VALUES = [\n  BILLING_SYSTEM_MESSAGE_CODES.FREE_ALLOWANCE_WARNING,\n  BILLING_SYSTEM_MESSAGE_CODES.RECOVERY_CAPACITY_EXHAUSTED,\n  BILLING_SYSTEM_MESSAGE_CODES.PLAN_UPGRADED,\n  BILLING_SYSTEM_MESSAGE_CODES.PLAN_DOWNGRADE_SCHEDULED,\n  BILLING_SYSTEM_MESSAGE_CODES.SUBSCRIPTION_ENDED,\n  BILLING_SYSTEM_MESSAGE_CODES.SAFETY_LIMIT_REACHED,\n  BILLING_SYSTEM_MESSAGE_CODES.REFUND_REQUEST_RECEIVED,\n  BILLING_SYSTEM_MESSAGE_CODES.REFUND_COMPLETED,\n  BILLING_SYSTEM_MESSAGE_CODES.REFUND_REJECTED,\n] as const;\n\nexport const BillingSystemMessageCodeSchema = z.enum(BILLING_SYSTEM_MESSAGE_CODE_VALUES);\nexport type BillingSystemMessageCode = z.infer<typeof BillingSystemMessageCodeSchema>;\n\nexport type PurchasedRecoveryCreditCounterSnapshot = Readonly<{\n  grantedQuantity: number;\n  committedQuantity: number;\n  reservedQuantity: number;\n  refundingQuantity: number;\n}>;\n\nexport function availablePurchasedRecoveryCredits(\n  counter: PurchasedRecoveryCreditCounterSnapshot,\n): number {\n  for (const [name, value] of Object.entries(counter)) {\n    if (!Number.isInteger(value) || value < 0) {\n      throw new Error(`${name} must be a non-negative integer`);\n    }\n  }\n\n  return Math.max(\n    counter.grantedQuantity\n      - counter.committedQuantity\n      - counter.reservedQuantity\n      - counter.refundingQuantity,\n    0,\n  );\n}\n\nexport const WHATSAPP_PROVIDER_STATUSES = [\n  \"SENT\",\n  \"DELIVERED\",\n  \"READ\",\n  \"FAILED\",\n] as const;\nexport const WhatsAppProviderStatusSchema = z.enum(WHATSAPP_PROVIDER_STATUSES);\nexport type WhatsAppProviderStatus = z.infer<typeof WhatsAppProviderStatusSchema>;\n\nconst MAX_ID_LENGTH = 128;\nconst MAX_SHORT_TEXT_LENGTH = 128;\n\nexport const BillingSubscriptionReconcileJobSchema = z\n  .object({\n    schemaVersion: z.literal(BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION),\n    shopId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    subscriptionId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    expectedNextReconcileAt: z.iso.datetime({ offset: true }),\n  })\n  .strict();\n\nexport type BillingSubscriptionReconcileJob = z.infer<\n  typeof BillingSubscriptionReconcileJobSchema\n>;\n\nexport function parseBillingSubscriptionReconcileJob(\n  input: unknown,\n): BillingSubscriptionReconcileJob {\n  return BillingSubscriptionReconcileJobSchema.parse(input);\n}\n\nexport function safeParseBillingSubscriptionReconcileJob(input: unknown) {\n  return BillingSubscriptionReconcileJobSchema.safeParse(input);\n}\n\nexport const WhatsAppProviderPricingMetadataSchema = z\n  .object({\n    billable: z.boolean().optional(),\n    category: z.string().trim().min(1).max(MAX_SHORT_TEXT_LENGTH).optional(),\n    model: z.string().trim().min(1).max(MAX_SHORT_TEXT_LENGTH).optional(),\n  })\n  .strict()\n  .refine((value) => Object.keys(value).length > 0, \"pricing metadata must not be empty\");\n\nexport type WhatsAppProviderPricingMetadata = z.infer<\n  typeof WhatsAppProviderPricingMetadataSchema\n>;\n\nexport const NormalizedWhatsAppStatusSchema = z\n  .object({\n    schemaVersion: z.literal(WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION),\n    providerAccountId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    providerPhoneNumberId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    providerMessageId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    status: WhatsAppProviderStatusSchema,\n    occurredAt: z.iso.datetime({ offset: true }),\n    pricing: WhatsAppProviderPricingMetadataSchema.optional(),\n  })\n  .strict();\n\nexport type NormalizedWhatsAppStatus = z.infer<typeof NormalizedWhatsAppStatusSchema>;\n\nexport function parseNormalizedWhatsAppStatus(input: unknown): NormalizedWhatsAppStatus {\n  return NormalizedWhatsAppStatusSchema.parse(input);\n}\n\nexport function safeParseNormalizedWhatsAppStatus(input: unknown) {\n  return NormalizedWhatsAppStatusSchema.safeParse(input);\n}\n\nfunction assertKeyPart(name: string, value: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new Error(`${name} must be a non-empty string`);\n  }\n}\n\nfunction fnv1a64(value: string): string {\n  let hash = 0xcbf29ce484222325n;\n  for (const character of value) {\n    hash ^= BigInt(character.codePointAt(0) ?? 0);\n    hash = BigInt.asUintN(64, hash * 0x100000001b3n);\n  }\n  return hash.toString(16).padStart(16, \"0\");\n}\n\nexport function createBillingSubscriptionReconcileJobId(\n  subscriptionId: string,\n  expectedNextReconcileAt: string,\n): string {\n  assertKeyPart(\"subscriptionId\", subscriptionId);\n  if (subscriptionId.trim().length > MAX_ID_LENGTH) {\n    throw new Error(`subscriptionId must be at most ${MAX_ID_LENGTH} characters`);\n  }\n  z.iso.datetime({ offset: true }).parse(expectedNextReconcileAt);\n  return `billing-subscription-reconcile-${fnv1a64(`${subscriptionId.trim()}\\u0000${expectedNextReconcileAt}`)}`;\n}\n\nfunction boundedKey(prefix: string, parts: string[], maxLength: number): string {\n  const canonical = parts.map((part) => part.trim()).join(\":\");\n  const readable = `${prefix}:${canonical}`;\n  if (readable.length <= maxLength) return readable;\n  return `${prefix}:h${fnv1a64(canonical)}`;\n}\n\nexport function createMerchantBillingSystemSourceKey(\n  shopId: string,\n  code: BillingSystemMessageCode,\n  eventIdentity: string,\n  version = 1,\n): string {\n  assertKeyPart(\"shopId\", shopId);\n  assertKeyPart(\"code\", code);\n  assertKeyPart(\"eventIdentity\", eventIdentity);\n  if (!Number.isInteger(version) || version < 1) {\n    throw new Error(\"version must be a positive integer\");\n  }\n  return boundedKey(\"billing-system\", [shopId, code, eventIdentity, String(version)], 255);\n}\n\nexport function createRecoveryIdempotencyKey(shopId: string, recoveryId: string): string {\n  assertKeyPart(\"shopId\", shopId);\n  assertKeyPart(\"recoveryId\", recoveryId);\n  return boundedKey(\"recovery\", [shopId, recoveryId], 255);\n}\n\nexport function createShopifyUsageIdempotencyKey(\n  shopId: string,\n  usageEventId: string,\n): string {\n  assertKeyPart(\"shopId\", shopId);\n  assertKeyPart(\"usageEventId\", usageEventId);\n  return boundedKey(\"shopify\", [shopId, usageEventId], 64);\n}"],"mappings":"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","names":[]}