@modainteract/moda-interact-shared 0.9.0 → 0.10.0

package/dist/billing.d.ts

@@ -2,6 +2,10 @@ import { z } from 'zod';
 
 declare const ARCH007_BILLING_CONTRACT_SCHEMA_VERSION: 1;
 declare const WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION: 2;
+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";
+declare const APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS: 300000;
 declare const BILLING_PLAN_KINDS: readonly ["FREE", "PAID_METERED"];
 declare const BillingPlanKindSchema: z.ZodEnum<{
     FREE: "FREE";
@@ -19,6 +23,7 @@ type BillingUsageMetric = z.infer<typeof BillingUsageMetricSchema>;
 declare const BILLING_SYSTEM_MESSAGE_CODES: {
     readonly FREE_ALLOWANCE_WARNING: "BILLING_FREE_ALLOWANCE_WARNING";
     readonly FREE_ALLOWANCE_EXHAUSTED: "BILLING_FREE_ALLOWANCE_EXHAUSTED";
+    readonly RECOVERY_CAPACITY_EXHAUSTED: "BILLING_RECOVERY_CAPACITY_EXHAUSTED";
     readonly PLAN_UPGRADED: "BILLING_PLAN_UPGRADED";
     readonly PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED";
     readonly SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED";
@@ -34,6 +39,7 @@ declare const BILLING_SYSTEM_MESSAGE_CODES: {
 declare const BillingSystemMessageCodeSchema: z.ZodEnum<{
     BILLING_FREE_ALLOWANCE_WARNING: "BILLING_FREE_ALLOWANCE_WARNING";
     BILLING_FREE_ALLOWANCE_EXHAUSTED: "BILLING_FREE_ALLOWANCE_EXHAUSTED";
+    BILLING_RECOVERY_CAPACITY_EXHAUSTED: "BILLING_RECOVERY_CAPACITY_EXHAUSTED";
     BILLING_PLAN_UPGRADED: "BILLING_PLAN_UPGRADED";
     BILLING_PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED";
     BILLING_SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED";
@@ -97,6 +103,20 @@ declare const WhatsAppProviderStatusSchema: z.ZodEnum<{
     FAILED: "FAILED";
 }>;
 type WhatsAppProviderStatus = z.infer<typeof WhatsAppProviderStatusSchema>;
+declare const BillingSubscriptionReconcileJobSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    shopId: z.ZodString;
+    subscriptionId: z.ZodString;
+    expectedNextReconcileAt: z.ZodISODateTime;
+}, z.core.$strict>;
+type BillingSubscriptionReconcileJob = z.infer<typeof BillingSubscriptionReconcileJobSchema>;
+declare function parseBillingSubscriptionReconcileJob(input: unknown): BillingSubscriptionReconcileJob;
+declare function safeParseBillingSubscriptionReconcileJob(input: unknown): z.ZodSafeParseResult<{
+    schemaVersion: 1;
+    shopId: string;
+    subscriptionId: string;
+    expectedNextReconcileAt: string;
+}>;
 declare const WhatsAppProviderPricingMetadataSchema: z.ZodObject<{
     billable: z.ZodOptional<z.ZodBoolean>;
     category: z.ZodOptional<z.ZodString>;
@@ -136,8 +156,9 @@ declare function safeParseNormalizedWhatsAppStatus(input: unknown): z.ZodSafePar
         model?: string | undefined;
     } | undefined;
 }>;
+declare function createBillingSubscriptionReconcileJobId(subscriptionId: string, expectedNextReconcileAt: string): string;
 declare function createMerchantBillingSystemSourceKey(shopId: string, code: BillingSystemMessageCode, eventIdentity: string, version?: number): string;
 declare function createRecoveryIdempotencyKey(shopId: string, recoveryId: string): string;
 declare function createShopifyUsageIdempotencyKey(shopId: string, usageEventId: string): string;
 
-export { ARCH007_BILLING_CONTRACT_SCHEMA_VERSION, BILLING_PLAN_KINDS, BILLING_SYSTEM_MESSAGE_CODES, BILLING_USAGE_METRICS, type BillingPlanKind, BillingPlanKindSchema, type BillingSystemMessageCode, BillingSystemMessageCodeSchema, type BillingUsageMetric, BillingUsageMetricSchema, type NormalizedWhatsAppStatus, NormalizedWhatsAppStatusSchema, type PurchasedRecoveryCreditCounterSnapshot, SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS, SUBSCRIPTION_CANCELLATION_MODES, type ShopifySubscriptionCancellationArgs, type SubscriptionCancellationMode, SubscriptionCancellationModeSchema, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, type WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, type WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, parseNormalizedWhatsAppStatus, 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 PurchasedRecoveryCreditCounterSnapshot, SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS, SUBSCRIPTION_CANCELLATION_MODES, type ShopifySubscriptionCancellationArgs, type SubscriptionCancellationMode, SubscriptionCancellationModeSchema, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, type WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, type WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createBillingSubscriptionReconcileJobId, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, parseBillingSubscriptionReconcileJob, parseNormalizedWhatsAppStatus, safeParseBillingSubscriptionReconcileJob, safeParseNormalizedWhatsAppStatus };

package/dist/billing.js

@@ -1,9 +1,14 @@
 import {
+  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,
   BillingPlanKindSchema,
+  BillingSubscriptionReconcileJobSchema,
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
@@ -15,18 +20,26 @@ import {
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
   availablePurchasedRecoveryCredits,
+  createBillingSubscriptionReconcileJobId,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey,
+  parseBillingSubscriptionReconcileJob,
   parseNormalizedWhatsAppStatus,
+  safeParseBillingSubscriptionReconcileJob,
   safeParseNormalizedWhatsAppStatus
-} from "./chunk-YDKVCS3T.js";
+} from "./chunk-KO4LMZ66.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,
   BillingPlanKindSchema,
+  BillingSubscriptionReconcileJobSchema,
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
@@ -38,10 +51,13 @@ export {
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
   availablePurchasedRecoveryCredits,
+  createBillingSubscriptionReconcileJobId,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey,
+  parseBillingSubscriptionReconcileJob,
   parseNormalizedWhatsAppStatus,
+  safeParseBillingSubscriptionReconcileJob,
   safeParseNormalizedWhatsAppStatus
 };
 //# sourceMappingURL=billing.js.map

package/dist/{chunk-YDKVCS3T.js → chunk-KO4LMZ66.js}

@@ -2,6 +2,10 @@
 import { z } from "zod";
 var ARCH007_BILLING_CONTRACT_SCHEMA_VERSION = 1;
 var WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION = 2;
+var BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION = 1;
+var BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME = "billing-subscription-reconcile";
+var BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME = "reconcile-subscription";
+var APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS = 3e5;
 var BILLING_PLAN_KINDS = ["FREE", "PAID_METERED"];
 var BillingPlanKindSchema = z.enum(BILLING_PLAN_KINDS);
 var BILLING_USAGE_METRICS = [
@@ -14,6 +18,7 @@ var BillingUsageMetricSchema = z.enum(BILLING_USAGE_METRICS);
 var BILLING_SYSTEM_MESSAGE_CODES = {
   FREE_ALLOWANCE_WARNING: "BILLING_FREE_ALLOWANCE_WARNING",
   FREE_ALLOWANCE_EXHAUSTED: "BILLING_FREE_ALLOWANCE_EXHAUSTED",
+  RECOVERY_CAPACITY_EXHAUSTED: "BILLING_RECOVERY_CAPACITY_EXHAUSTED",
   PLAN_UPGRADED: "BILLING_PLAN_UPGRADED",
   PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED",
   SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED",
@@ -29,6 +34,7 @@ var BILLING_SYSTEM_MESSAGE_CODES = {
 var BILLING_SYSTEM_MESSAGE_CODE_VALUES = [
   BILLING_SYSTEM_MESSAGE_CODES.FREE_ALLOWANCE_WARNING,
   BILLING_SYSTEM_MESSAGE_CODES.FREE_ALLOWANCE_EXHAUSTED,
+  BILLING_SYSTEM_MESSAGE_CODES.RECOVERY_CAPACITY_EXHAUSTED,
   BILLING_SYSTEM_MESSAGE_CODES.PLAN_UPGRADED,
   BILLING_SYSTEM_MESSAGE_CODES.PLAN_DOWNGRADE_SCHEDULED,
   BILLING_SYSTEM_MESSAGE_CODES.SUBSCRIPTION_ENDED,
@@ -91,6 +97,18 @@ var WHATSAPP_PROVIDER_STATUSES = [
 var WhatsAppProviderStatusSchema = z.enum(WHATSAPP_PROVIDER_STATUSES);
 var MAX_ID_LENGTH = 128;
 var MAX_SHORT_TEXT_LENGTH = 128;
+var BillingSubscriptionReconcileJobSchema = z.object({
+  schemaVersion: z.literal(BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION),
+  shopId: z.string().trim().min(1).max(MAX_ID_LENGTH),
+  subscriptionId: z.string().trim().min(1).max(MAX_ID_LENGTH),
+  expectedNextReconcileAt: z.iso.datetime({ offset: true })
+}).strict();
+function parseBillingSubscriptionReconcileJob(input) {
+  return BillingSubscriptionReconcileJobSchema.parse(input);
+}
+function safeParseBillingSubscriptionReconcileJob(input) {
+  return BillingSubscriptionReconcileJobSchema.safeParse(input);
+}
 var WhatsAppProviderPricingMetadataSchema = z.object({
   billable: z.boolean().optional(),
   category: z.string().trim().min(1).max(MAX_SHORT_TEXT_LENGTH).optional(),
@@ -124,6 +142,14 @@ function fnv1a64(value) {
   }
   return hash.toString(16).padStart(16, "0");
 }
+function createBillingSubscriptionReconcileJobId(subscriptionId, expectedNextReconcileAt) {
+  assertKeyPart("subscriptionId", subscriptionId);
+  if (subscriptionId.trim().length > MAX_ID_LENGTH) {
+    throw new Error(`subscriptionId must be at most ${MAX_ID_LENGTH} characters`);
+  }
+  z.iso.datetime({ offset: true }).parse(expectedNextReconcileAt);
+  return `billing-subscription-reconcile-${fnv1a64(`${subscriptionId.trim()}\0${expectedNextReconcileAt}`)}`;
+}
 function boundedKey(prefix, parts, maxLength) {
   const canonical = parts.map((part) => part.trim()).join(":");
   const readable = `${prefix}:${canonical}`;
@@ -153,6 +179,10 @@ function createShopifyUsageIdempotencyKey(shopId, usageEventId) {
 export {
   ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  BILLING_SUBSCRIPTION_RECONCILE_SCHEMA_VERSION,
+  BILLING_SUBSCRIPTION_RECONCILE_QUEUE_NAME,
+  BILLING_SUBSCRIPTION_RECONCILE_JOB_NAME,
+  APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS,
   BILLING_PLAN_KINDS,
   BillingPlanKindSchema,
   BILLING_USAGE_METRICS,
@@ -165,12 +195,16 @@ export {
   availablePurchasedRecoveryCredits,
   WHATSAPP_PROVIDER_STATUSES,
   WhatsAppProviderStatusSchema,
+  BillingSubscriptionReconcileJobSchema,
+  parseBillingSubscriptionReconcileJob,
+  safeParseBillingSubscriptionReconcileJob,
   WhatsAppProviderPricingMetadataSchema,
   NormalizedWhatsAppStatusSchema,
   parseNormalizedWhatsAppStatus,
   safeParseNormalizedWhatsAppStatus,
+  createBillingSubscriptionReconcileJobId,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey
 };
-//# sourceMappingURL=chunk-YDKVCS3T.js.map
+//# sourceMappingURL=chunk-KO4LMZ66.js.map

package/dist/chunk-KO4LMZ66.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_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\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  FREE_ALLOWANCE_EXHAUSTED: \"BILLING_FREE_ALLOWANCE_EXHAUSTED\",\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  PLAN_CHANGE_ACTION_REQUIRED: \"BILLING_PLAN_CHANGE_ACTION_REQUIRED\",\n  CANCELLATION_REQUEST_RECEIVED: \"BILLING_CANCELLATION_REQUEST_RECEIVED\",\n  CANCELLATION_COMPLETED: \"BILLING_CANCELLATION_COMPLETED\",\n  CANCELLATION_REJECTED: \"BILLING_CANCELLATION_REJECTED\",\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.FREE_ALLOWANCE_EXHAUSTED,\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.PLAN_CHANGE_ACTION_REQUIRED,\n  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_REQUEST_RECEIVED,\n  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_COMPLETED,\n  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_REJECTED,\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 const SUBSCRIPTION_CANCELLATION_MODES = [\n  \"END_OF_CYCLE\",\n  \"IMMEDIATE_NO_PRORATION\",\n  \"IMMEDIATE_PRORATED\",\n  \"IMMEDIATE_SKIP_FINAL_USAGE\",\n] as const;\n\nexport const SubscriptionCancellationModeSchema = z.enum(SUBSCRIPTION_CANCELLATION_MODES);\nexport type SubscriptionCancellationMode = z.infer<typeof SubscriptionCancellationModeSchema>;\n\nexport type ShopifySubscriptionCancellationArgs = Readonly<{\n  deferCancellation: boolean;\n  prorate: boolean;\n  skipFinalUsageCharge: boolean;\n}>;\n\nexport const SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS = {\n  END_OF_CYCLE: {\n    deferCancellation: true,\n    prorate: false,\n    skipFinalUsageCharge: false,\n  },\n  IMMEDIATE_NO_PRORATION: {\n    deferCancellation: false,\n    prorate: false,\n    skipFinalUsageCharge: false,\n  },\n  IMMEDIATE_PRORATED: {\n    deferCancellation: false,\n    prorate: true,\n    skipFinalUsageCharge: false,\n  },\n  IMMEDIATE_SKIP_FINAL_USAGE: {\n    deferCancellation: false,\n    prorate: false,\n    skipFinalUsageCharge: true,\n  },\n} as const satisfies Readonly<\n  Record<SubscriptionCancellationMode, ShopifySubscriptionCancellationArgs>\n>;\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":[]}

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, TimeZoneId, TimeZoneIdSchema, canonicaliseLanguageTag, createInternationalizationRuntime, mergeInternationalContext, normalizeCountryCode, normalizeCurrencyCode, normalizeTimeZone, resolveLocaleDirection, validateIcuCatalogue } from './internationalization.js';
-export { ARCH007_BILLING_CONTRACT_SCHEMA_VERSION, BILLING_PLAN_KINDS, BILLING_SYSTEM_MESSAGE_CODES, BILLING_USAGE_METRICS, BillingPlanKind, BillingPlanKindSchema, BillingSystemMessageCode, BillingSystemMessageCodeSchema, BillingUsageMetric, BillingUsageMetricSchema, NormalizedWhatsAppStatus, NormalizedWhatsAppStatusSchema, PurchasedRecoveryCreditCounterSnapshot, SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS, SUBSCRIPTION_CANCELLATION_MODES, ShopifySubscriptionCancellationArgs, SubscriptionCancellationMode, SubscriptionCancellationModeSchema, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, parseNormalizedWhatsAppStatus, 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, PurchasedRecoveryCreditCounterSnapshot, SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS, SUBSCRIPTION_CANCELLATION_MODES, ShopifySubscriptionCancellationArgs, SubscriptionCancellationMode, SubscriptionCancellationModeSchema, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, WhatsAppProviderStatus, WhatsAppProviderStatusSchema, availablePurchasedRecoveryCredits, createBillingSubscriptionReconcileJobId, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, 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 { 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_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, ShopifyMoney, ShopifyMoneySchema, ShopifyOrderCompletedEvent, ShopifyOrderCompletedEventSchema, ShopifyOrderCompletedEventV2, ShopifyOrderCompletedEventV2Schema, ShopifyRecoveryEventTypeV2, ShopifyRecoveryEventV2, ShopifyRecoveryEventV2Schema, ShopifyTenant, ShopifyTenantSchema, createShopifyCartActivityOrderingKey, createShopifyCommerceOrderingKey, createShopifyOrderCorrelationOrderingKey, createShopifyOrderOrderingKey, createShopifyPendingRecoveryOrderingKey, isCartActivityEventV2, isCheckoutCreatedEventV2, isCheckoutObservedEvent, isCheckoutUpdatedEventV2, isOrderCompletedEvent, isOrderCompletedEventV2, parseShopifyCommerceEvent, parseShopifyRecoveryEventV2, safeParseShopifyCommerceEvent, safeParseShopifyRecoveryEventV2 } from './shopify/index.js';
 import 'zod';

package/dist/index.js

@@ -1,9 +1,14 @@
 import {
+  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,
   BillingPlanKindSchema,
+  BillingSubscriptionReconcileJobSchema,
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
@@ -15,12 +20,15 @@ import {
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
   availablePurchasedRecoveryCredits,
+  createBillingSubscriptionReconcileJobId,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey,
+  parseBillingSubscriptionReconcileJob,
   parseNormalizedWhatsAppStatus,
+  safeParseBillingSubscriptionReconcileJob,
   safeParseNormalizedWhatsAppStatus
-} from "./chunk-YDKVCS3T.js";
+} from "./chunk-KO4LMZ66.js";
 import {
   AuthoredSupportBodySchema,
   MERCHANT_COMMUNICATIONS_JOB_NAMES,
@@ -109,12 +117,17 @@ import {
   validateIcuCatalogue
 } from "./chunk-B6Y3QQLI.js";
 export {
+  APP_PRICING_BILLING_PERIOD_DRAIN_WINDOW_MS,
   ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
   AuthoredSupportBodySchema,
   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,
   BillingPlanKindSchema,
+  BillingSubscriptionReconcileJobSchema,
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   CheckoutCreatedPayloadV2Schema,
@@ -183,6 +196,7 @@ export {
   availablePurchasedRecoveryCredits,
   canonicaliseLanguageTag,
   countUnicodeGraphemes,
+  createBillingSubscriptionReconcileJobId,
   createInternationalizationRuntime,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
@@ -202,11 +216,13 @@ export {
   normalizeCountryCode,
   normalizeCurrencyCode,
   normalizeTimeZone,
+  parseBillingSubscriptionReconcileJob,
   parseNormalizedWhatsAppStatus,
   parseShopifyCommerceEvent,
   parseShopifyRecoveryEventV2,
   requiresMerchantTranslation,
   resolveLocaleDirection,
+  safeParseBillingSubscriptionReconcileJob,
   safeParseNormalizedWhatsAppStatus,
   safeParseShopifyCommerceEvent,
   safeParseShopifyRecoveryEventV2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -72,6 +72,7 @@
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "tsx --test \"src/**/*.test.ts\"",
+    "validate:billing-entrypoint": "npm run build && node scripts/validate-billing-entrypoint.mjs",
     "validate:internationalization-entrypoint": "npm run build && node scripts/validate-internationalization-entrypoint.mjs",
     "validate:merchant-communications-node": "npm run build && node scripts/validate-merchant-communications-node.mjs",
     "validate:testing-node": "npm run build && node scripts/validate-testing-node.mjs",

package/dist/chunk-YDKVCS3T.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;\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  FREE_ALLOWANCE_EXHAUSTED: \"BILLING_FREE_ALLOWANCE_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  PLAN_CHANGE_ACTION_REQUIRED: \"BILLING_PLAN_CHANGE_ACTION_REQUIRED\",\n  CANCELLATION_REQUEST_RECEIVED: \"BILLING_CANCELLATION_REQUEST_RECEIVED\",\n  CANCELLATION_COMPLETED: \"BILLING_CANCELLATION_COMPLETED\",\n  CANCELLATION_REJECTED: \"BILLING_CANCELLATION_REJECTED\",\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.FREE_ALLOWANCE_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.PLAN_CHANGE_ACTION_REQUIRED,\n  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_REQUEST_RECEIVED,\n  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_COMPLETED,\n  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_REJECTED,\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 const SUBSCRIPTION_CANCELLATION_MODES = [\n  \"END_OF_CYCLE\",\n  \"IMMEDIATE_NO_PRORATION\",\n  \"IMMEDIATE_PRORATED\",\n  \"IMMEDIATE_SKIP_FINAL_USAGE\",\n] as const;\n\nexport const SubscriptionCancellationModeSchema = z.enum(SUBSCRIPTION_CANCELLATION_MODES);\nexport type SubscriptionCancellationMode = z.infer<typeof SubscriptionCancellationModeSchema>;\n\nexport type ShopifySubscriptionCancellationArgs = Readonly<{\n  deferCancellation: boolean;\n  prorate: boolean;\n  skipFinalUsageCharge: boolean;\n}>;\n\nexport const SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS = {\n  END_OF_CYCLE: {\n    deferCancellation: true,\n    prorate: false,\n    skipFinalUsageCharge: false,\n  },\n  IMMEDIATE_NO_PRORATION: {\n    deferCancellation: false,\n    prorate: false,\n    skipFinalUsageCharge: false,\n  },\n  IMMEDIATE_PRORATED: {\n    deferCancellation: false,\n    prorate: true,\n    skipFinalUsageCharge: false,\n  },\n  IMMEDIATE_SKIP_FINAL_USAGE: {\n    deferCancellation: false,\n    prorate: false,\n    skipFinalUsageCharge: true,\n  },\n} as const satisfies Readonly<\n  Record<SubscriptionCancellationMode, ShopifySubscriptionCancellationArgs>\n>;\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 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\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":[]}