@modainteract/moda-interact-shared 0.7.1 → 0.7.3

package/dist/billing.d.ts

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+
+declare const ARCH007_BILLING_CONTRACT_SCHEMA_VERSION: 1;
+declare const WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION: 1;
+declare const BILLING_PLAN_KINDS: readonly ["FREE", "PAID_METERED"];
+declare const BillingPlanKindSchema: z.ZodEnum<{
+    FREE: "FREE";
+    PAID_METERED: "PAID_METERED";
+}>;
+type BillingPlanKind = z.infer<typeof BillingPlanKindSchema>;
+declare const BILLING_USAGE_METRICS: readonly ["RECOVERY_CONVERSATION", "OUTBOUND_AUTOMATED_MESSAGE", "DELIVERED_WHATSAPP_MESSAGE"];
+declare const BillingUsageMetricSchema: z.ZodEnum<{
+    RECOVERY_CONVERSATION: "RECOVERY_CONVERSATION";
+    OUTBOUND_AUTOMATED_MESSAGE: "OUTBOUND_AUTOMATED_MESSAGE";
+    DELIVERED_WHATSAPP_MESSAGE: "DELIVERED_WHATSAPP_MESSAGE";
+}>;
+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 PLAN_UPGRADED: "BILLING_PLAN_UPGRADED";
+    readonly PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED";
+    readonly SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED";
+    readonly SAFETY_LIMIT_REACHED: "BILLING_SAFETY_LIMIT_REACHED";
+};
+declare const BillingSystemMessageCodeSchema: z.ZodEnum<{
+    BILLING_FREE_ALLOWANCE_WARNING: "BILLING_FREE_ALLOWANCE_WARNING";
+    BILLING_FREE_ALLOWANCE_EXHAUSTED: "BILLING_FREE_ALLOWANCE_EXHAUSTED";
+    BILLING_PLAN_UPGRADED: "BILLING_PLAN_UPGRADED";
+    BILLING_PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED";
+    BILLING_SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED";
+    BILLING_SAFETY_LIMIT_REACHED: "BILLING_SAFETY_LIMIT_REACHED";
+}>;
+type BillingSystemMessageCode = z.infer<typeof BillingSystemMessageCodeSchema>;
+declare const WHATSAPP_PROVIDER_STATUSES: readonly ["SENT", "DELIVERED", "READ", "FAILED"];
+declare const WhatsAppProviderStatusSchema: z.ZodEnum<{
+    SENT: "SENT";
+    DELIVERED: "DELIVERED";
+    READ: "READ";
+    FAILED: "FAILED";
+}>;
+type WhatsAppProviderStatus = z.infer<typeof WhatsAppProviderStatusSchema>;
+declare const WhatsAppProviderPricingMetadataSchema: z.ZodObject<{
+    billable: z.ZodOptional<z.ZodBoolean>;
+    category: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+type WhatsAppProviderPricingMetadata = z.infer<typeof WhatsAppProviderPricingMetadataSchema>;
+declare const NormalizedWhatsAppStatusSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    shopId: z.ZodString;
+    providerAccountId: 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>>;
+}, z.core.$strict>;
+type NormalizedWhatsAppStatus = z.infer<typeof NormalizedWhatsAppStatusSchema>;
+declare function parseNormalizedWhatsAppStatus(input: unknown): NormalizedWhatsAppStatus;
+declare function safeParseNormalizedWhatsAppStatus(input: unknown): z.ZodSafeParseResult<{
+    schemaVersion: 1;
+    shopId: string;
+    providerAccountId: string;
+    providerMessageId: string;
+    status: "SENT" | "DELIVERED" | "READ" | "FAILED";
+    occurredAt: string;
+    pricing?: {
+        billable?: boolean | undefined;
+        category?: string | undefined;
+        model?: string | undefined;
+    } | undefined;
+}>;
+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, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, type WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, type WhatsAppProviderStatus, WhatsAppProviderStatusSchema, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, parseNormalizedWhatsAppStatus, safeParseNormalizedWhatsAppStatus };

package/dist/billing.js

@@ -0,0 +1,39 @@
+import {
+  ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
+  BILLING_PLAN_KINDS,
+  BILLING_SYSTEM_MESSAGE_CODES,
+  BILLING_USAGE_METRICS,
+  BillingPlanKindSchema,
+  BillingSystemMessageCodeSchema,
+  BillingUsageMetricSchema,
+  NormalizedWhatsAppStatusSchema,
+  WHATSAPP_PROVIDER_STATUSES,
+  WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WhatsAppProviderPricingMetadataSchema,
+  WhatsAppProviderStatusSchema,
+  createMerchantBillingSystemSourceKey,
+  createRecoveryIdempotencyKey,
+  createShopifyUsageIdempotencyKey,
+  parseNormalizedWhatsAppStatus,
+  safeParseNormalizedWhatsAppStatus
+} from "./chunk-WVVP7IUY.js";
+export {
+  ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
+  BILLING_PLAN_KINDS,
+  BILLING_SYSTEM_MESSAGE_CODES,
+  BILLING_USAGE_METRICS,
+  BillingPlanKindSchema,
+  BillingSystemMessageCodeSchema,
+  BillingUsageMetricSchema,
+  NormalizedWhatsAppStatusSchema,
+  WHATSAPP_PROVIDER_STATUSES,
+  WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WhatsAppProviderPricingMetadataSchema,
+  WhatsAppProviderStatusSchema,
+  createMerchantBillingSystemSourceKey,
+  createRecoveryIdempotencyKey,
+  createShopifyUsageIdempotencyKey,
+  parseNormalizedWhatsAppStatus,
+  safeParseNormalizedWhatsAppStatus
+};
+//# sourceMappingURL=billing.js.map

package/dist/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-WVVP7IUY.js

@@ -0,0 +1,117 @@
+// src/billing.ts
+import { z } from "zod";
+var ARCH007_BILLING_CONTRACT_SCHEMA_VERSION = 1;
+var WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION = 1;
+var BILLING_PLAN_KINDS = ["FREE", "PAID_METERED"];
+var BillingPlanKindSchema = z.enum(BILLING_PLAN_KINDS);
+var BILLING_USAGE_METRICS = [
+  "RECOVERY_CONVERSATION",
+  "OUTBOUND_AUTOMATED_MESSAGE",
+  "DELIVERED_WHATSAPP_MESSAGE"
+];
+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",
+  PLAN_UPGRADED: "BILLING_PLAN_UPGRADED",
+  PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED",
+  SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED",
+  SAFETY_LIMIT_REACHED: "BILLING_SAFETY_LIMIT_REACHED"
+};
+var BILLING_SYSTEM_MESSAGE_CODE_VALUES = [
+  BILLING_SYSTEM_MESSAGE_CODES.FREE_ALLOWANCE_WARNING,
+  BILLING_SYSTEM_MESSAGE_CODES.FREE_ALLOWANCE_EXHAUSTED,
+  BILLING_SYSTEM_MESSAGE_CODES.PLAN_UPGRADED,
+  BILLING_SYSTEM_MESSAGE_CODES.PLAN_DOWNGRADE_SCHEDULED,
+  BILLING_SYSTEM_MESSAGE_CODES.SUBSCRIPTION_ENDED,
+  BILLING_SYSTEM_MESSAGE_CODES.SAFETY_LIMIT_REACHED
+];
+var BillingSystemMessageCodeSchema = z.enum(BILLING_SYSTEM_MESSAGE_CODE_VALUES);
+var WHATSAPP_PROVIDER_STATUSES = [
+  "SENT",
+  "DELIVERED",
+  "READ",
+  "FAILED"
+];
+var WhatsAppProviderStatusSchema = z.enum(WHATSAPP_PROVIDER_STATUSES);
+var MAX_ID_LENGTH = 128;
+var MAX_SHORT_TEXT_LENGTH = 128;
+var WhatsAppProviderPricingMetadataSchema = z.object({
+  billable: z.boolean().optional(),
+  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),
+  shopId: z.string().trim().min(1).max(MAX_ID_LENGTH),
+  providerAccountId: 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()
+}).strict();
+function parseNormalizedWhatsAppStatus(input) {
+  return NormalizedWhatsAppStatusSchema.parse(input);
+}
+function safeParseNormalizedWhatsAppStatus(input) {
+  return NormalizedWhatsAppStatusSchema.safeParse(input);
+}
+function assertKeyPart(name, value) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${name} must be a non-empty string`);
+  }
+}
+function fnv1a64(value) {
+  let hash = 0xcbf29ce484222325n;
+  for (const character of value) {
+    hash ^= BigInt(character.codePointAt(0) ?? 0);
+    hash = BigInt.asUintN(64, hash * 0x100000001b3n);
+  }
+  return hash.toString(16).padStart(16, "0");
+}
+function boundedKey(prefix, parts, maxLength) {
+  const canonical = parts.map((part) => part.trim()).join(":");
+  const readable = `${prefix}:${canonical}`;
+  if (readable.length <= maxLength) return readable;
+  return `${prefix}:h${fnv1a64(canonical)}`;
+}
+function createMerchantBillingSystemSourceKey(shopId, code, eventIdentity, version = 1) {
+  assertKeyPart("shopId", shopId);
+  assertKeyPart("code", code);
+  assertKeyPart("eventIdentity", eventIdentity);
+  if (!Number.isInteger(version) || version < 1) {
+    throw new Error("version must be a positive integer");
+  }
+  return boundedKey("billing-system", [shopId, code, eventIdentity, String(version)], 255);
+}
+function createRecoveryIdempotencyKey(shopId, recoveryId) {
+  assertKeyPart("shopId", shopId);
+  assertKeyPart("recoveryId", recoveryId);
+  return boundedKey("recovery", [shopId, recoveryId], 255);
+}
+function createShopifyUsageIdempotencyKey(shopId, usageEventId) {
+  assertKeyPart("shopId", shopId);
+  assertKeyPart("usageEventId", usageEventId);
+  return boundedKey("shopify", [shopId, usageEventId], 64);
+}
+
+export {
+  ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
+  WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  BILLING_PLAN_KINDS,
+  BillingPlanKindSchema,
+  BILLING_USAGE_METRICS,
+  BillingUsageMetricSchema,
+  BILLING_SYSTEM_MESSAGE_CODES,
+  BillingSystemMessageCodeSchema,
+  WHATSAPP_PROVIDER_STATUSES,
+  WhatsAppProviderStatusSchema,
+  WhatsAppProviderPricingMetadataSchema,
+  NormalizedWhatsAppStatusSchema,
+  parseNormalizedWhatsAppStatus,
+  safeParseNormalizedWhatsAppStatus,
+  createMerchantBillingSystemSourceKey,
+  createRecoveryIdempotencyKey,
+  createShopifyUsageIdempotencyKey
+};
+//# sourceMappingURL=chunk-WVVP7IUY.js.map

package/dist/chunk-WVVP7IUY.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 = 1 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] 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} 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] as const;\n\nexport const BillingSystemMessageCodeSchema = z.enum(BILLING_SYSTEM_MESSAGE_CODE_VALUES);\nexport type BillingSystemMessageCode = z.infer<typeof BillingSystemMessageCodeSchema>;\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    shopId: z.string().trim().min(1).max(MAX_ID_LENGTH),\n    providerAccountId: 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":[]}

package/dist/index.d.ts

@@ -1,4 +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, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, WhatsAppProviderStatus, WhatsAppProviderStatusSchema, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, parseNormalizedWhatsAppStatus, 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,3 +1,22 @@
+import {
+  ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
+  BILLING_PLAN_KINDS,
+  BILLING_SYSTEM_MESSAGE_CODES,
+  BILLING_USAGE_METRICS,
+  BillingPlanKindSchema,
+  BillingSystemMessageCodeSchema,
+  BillingUsageMetricSchema,
+  NormalizedWhatsAppStatusSchema,
+  WHATSAPP_PROVIDER_STATUSES,
+  WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WhatsAppProviderPricingMetadataSchema,
+  WhatsAppProviderStatusSchema,
+  createMerchantBillingSystemSourceKey,
+  createRecoveryIdempotencyKey,
+  createShopifyUsageIdempotencyKey,
+  parseNormalizedWhatsAppStatus,
+  safeParseNormalizedWhatsAppStatus
+} from "./chunk-WVVP7IUY.js";
 import {
   AuthoredSupportBodySchema,
   MERCHANT_COMMUNICATIONS_JOB_NAMES,
@@ -86,7 +105,14 @@ import {
   validateIcuCatalogue
 } from "./chunk-B6Y3QQLI.js";
 export {
+  ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
   AuthoredSupportBodySchema,
+  BILLING_PLAN_KINDS,
+  BILLING_SYSTEM_MESSAGE_CODES,
+  BILLING_USAGE_METRICS,
+  BillingPlanKindSchema,
+  BillingSystemMessageCodeSchema,
+  BillingUsageMetricSchema,
   CheckoutCreatedPayloadV2Schema,
   CheckoutObservedPayloadSchema,
   CheckoutUpdatedPayloadV2Schema,
@@ -111,6 +137,7 @@ export {
   MerchantTranslationReconciliationRequestContractSchema,
   MerchantTranslationReconciliationScopeSchema,
   MerchantTranslationReconciliationStatusSchema,
+  NormalizedWhatsAppStatusSchema,
   OrderCompletedPayloadSchema,
   OrderCompletedPayloadV2Schema,
   PLATFORM_SUPPORT_LANGUAGE_TAG,
@@ -142,14 +169,21 @@ export {
   TranslationBatchSubmitJobSchema,
   TranslationDispatchJobSchema,
   TranslationReconcileJobSchema,
+  WHATSAPP_PROVIDER_STATUSES,
+  WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
+  WhatsAppProviderPricingMetadataSchema,
+  WhatsAppProviderStatusSchema,
   canonicaliseLanguageTag,
   countUnicodeGraphemes,
   createInternationalizationRuntime,
+  createMerchantBillingSystemSourceKey,
+  createRecoveryIdempotencyKey,
   createShopifyCartActivityOrderingKey,
   createShopifyCommerceOrderingKey,
   createShopifyOrderCorrelationOrderingKey,
   createShopifyOrderOrderingKey,
   createShopifyPendingRecoveryOrderingKey,
+  createShopifyUsageIdempotencyKey,
   isCartActivityEventV2,
   isCheckoutCreatedEventV2,
   isCheckoutObservedEvent,
@@ -160,10 +194,12 @@ export {
   normalizeCountryCode,
   normalizeCurrencyCode,
   normalizeTimeZone,
+  parseNormalizedWhatsAppStatus,
   parseShopifyCommerceEvent,
   parseShopifyRecoveryEventV2,
   requiresMerchantTranslation,
   resolveLocaleDirection,
+  safeParseNormalizedWhatsAppStatus,
   safeParseShopifyCommerceEvent,
   safeParseShopifyRecoveryEventV2,
   validateIcuCatalogue

package/dist/internationalization.d.ts

@@ -2,9 +2,9 @@ import { z } from 'zod';
 import { PrimitiveType } from 'intl-messageformat';
 
 declare const LanguageSourceSchema: z.ZodEnum<{
+    shopify: "shopify";
     "customer-explicit": "customer-explicit";
     detected: "detected";
-    shopify: "shopify";
     "merchant-default": "merchant-default";
     "platform-default": "platform-default";
 }>;
@@ -20,9 +20,9 @@ declare const TimeZoneIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, st
 declare const InternationalContextSchema: z.ZodObject<{
     languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
     languageSource: z.ZodNullable<z.ZodEnum<{
+        shopify: "shopify";
         "customer-explicit": "customer-explicit";
         detected: "detected";
-        shopify: "shopify";
         "merchant-default": "merchant-default";
         "platform-default": "platform-default";
     }>>;

package/dist/merchant-communications.d.ts

@@ -9,9 +9,9 @@ declare const MerchantSupportMessageKindSchema: z.ZodEnum<{
     MERCHANT: "MERCHANT";
 }>;
 declare const MerchantSupportMessageStateSchema: z.ZodEnum<{
+    FAILED: "FAILED";
     PROCESSING: "PROCESSING";
     AVAILABLE: "AVAILABLE";
-    FAILED: "FAILED";
 }>;
 declare const MerchantTranslationDirectionSchema: z.ZodEnum<{
     MERCHANT_TO_ADMIN: "MERCHANT_TO_ADMIN";
@@ -19,8 +19,8 @@ declare const MerchantTranslationDirectionSchema: z.ZodEnum<{
     SYSTEM_TO_MERCHANT: "SYSTEM_TO_MERCHANT";
 }>;
 declare const MerchantMessageTranslationStatusSchema: z.ZodEnum<{
-    AVAILABLE: "AVAILABLE";
     FAILED: "FAILED";
+    AVAILABLE: "AVAILABLE";
     PENDING: "PENDING";
 }>;
 declare const MerchantTranslationBatchStatusSchema: z.ZodEnum<{
@@ -39,8 +39,8 @@ declare const MerchantTranslationReconciliationScopeSchema: z.ZodEnum<{
     FAILED_TRANSLATIONS: "FAILED_TRANSLATIONS";
 }>;
 declare const MerchantTranslationReconciliationStatusSchema: z.ZodEnum<{
-    PROCESSING: "PROCESSING";
     FAILED: "FAILED";
+    PROCESSING: "PROCESSING";
     PENDING: "PENDING";
     COMPLETED: "COMPLETED";
 }>;
@@ -61,9 +61,9 @@ declare const MerchantSupportMessageContractSchema: z.ZodObject<{
         MERCHANT: "MERCHANT";
     }>;
     state: z.ZodEnum<{
+        FAILED: "FAILED";
         PROCESSING: "PROCESSING";
         AVAILABLE: "AVAILABLE";
-        FAILED: "FAILED";
     }>;
     originalBody: z.ZodString;
     sourceLanguageTag: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
@@ -78,8 +78,8 @@ declare const MerchantMessageTranslationContractSchema: z.ZodObject<{
     sourceLanguageTag: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     targetLanguageTag: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
     status: z.ZodEnum<{
-        AVAILABLE: "AVAILABLE";
         FAILED: "FAILED";
+        AVAILABLE: "AVAILABLE";
         PENDING: "PENDING";
     }>;
     translatedBody: z.ZodNullable<z.ZodString>;
@@ -110,8 +110,8 @@ declare const MerchantTranslationReconciliationRequestContractSchema: z.ZodObjec
     }>;
     translationId: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
-        PROCESSING: "PROCESSING";
         FAILED: "FAILED";
+        PROCESSING: "PROCESSING";
         PENDING: "PENDING";
         COMPLETED: "COMPLETED";
     }>;

package/dist/shopify/index.d.ts

@@ -384,9 +384,9 @@ declare const ShopifyCheckoutCreatedEventV2Schema: z.ZodObject<{
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -421,9 +421,9 @@ declare const ShopifyCartActivityEventV2Schema: z.ZodObject<{
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -456,9 +456,9 @@ declare const ShopifyCheckoutUpdatedEventV2Schema: z.ZodObject<{
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -490,9 +490,9 @@ declare const ShopifyOrderCompletedEventV2Schema: z.ZodObject<{
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -527,9 +527,9 @@ declare const ShopifyRecoveryEventV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -560,9 +560,9 @@ declare const ShopifyRecoveryEventV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -595,9 +595,9 @@ declare const ShopifyRecoveryEventV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -627,9 +627,9 @@ declare const ShopifyRecoveryEventV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject
     internationalContext: z.ZodOptional<z.ZodObject<{
         languageTag: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         languageSource: z.ZodNullable<z.ZodEnum<{
+            shopify: "shopify";
             "customer-explicit": "customer-explicit";
             detected: "detected";
-            shopify: "shopify";
             "merchant-default": "merchant-default";
             "platform-default": "platform-default";
         }>>;
@@ -672,7 +672,7 @@ declare function safeParseShopifyRecoveryEventV2(input: unknown): z.ZodSafeParse
     };
     internationalContext?: {
         languageTag: string | null;
-        languageSource: "customer-explicit" | "detected" | "shopify" | "merchant-default" | "platform-default" | null;
+        languageSource: "shopify" | "customer-explicit" | "detected" | "merchant-default" | "platform-default" | null;
         countryCode: string | null;
         currencyCode: string | null;
         timeZone: string | null;
@@ -699,7 +699,7 @@ declare function safeParseShopifyRecoveryEventV2(input: unknown): z.ZodSafeParse
     };
     internationalContext?: {
         languageTag: string | null;
-        languageSource: "customer-explicit" | "detected" | "shopify" | "merchant-default" | "platform-default" | null;
+        languageSource: "shopify" | "customer-explicit" | "detected" | "merchant-default" | "platform-default" | null;
         countryCode: string | null;
         currencyCode: string | null;
         timeZone: string | null;
@@ -725,7 +725,7 @@ declare function safeParseShopifyRecoveryEventV2(input: unknown): z.ZodSafeParse
     };
     internationalContext?: {
         languageTag: string | null;
-        languageSource: "customer-explicit" | "detected" | "shopify" | "merchant-default" | "platform-default" | null;
+        languageSource: "shopify" | "customer-explicit" | "detected" | "merchant-default" | "platform-default" | null;
         countryCode: string | null;
         currencyCode: string | null;
         timeZone: string | null;
@@ -754,7 +754,7 @@ declare function safeParseShopifyRecoveryEventV2(input: unknown): z.ZodSafeParse
     };
     internationalContext?: {
         languageTag: string | null;
-        languageSource: "customer-explicit" | "detected" | "shopify" | "merchant-default" | "platform-default" | null;
+        languageSource: "shopify" | "customer-explicit" | "detected" | "merchant-default" | "platform-default" | null;
         countryCode: string | null;
         currencyCode: string | null;
         timeZone: string | null;

package/dist/testing/node.d.ts

@@ -0,0 +1,127 @@
+declare const DEFAULT_POSTGRES_IMAGE = "postgres:17.6-alpine";
+declare const DEFAULT_REDIS_IMAGE = "redis:7.4.2-alpine";
+declare const DEFAULT_HOST = "127.0.0.1";
+declare const DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS = 30000;
+declare const DEFAULT_REDIS_STARTUP_TIMEOUT_MS = 15000;
+declare const DEFAULT_POLL_INTERVAL_MS = 200;
+declare const DEFAULT_COMMAND_TIMEOUT_MS = 120000;
+declare const DEFAULT_DOCKER_COMMAND_TIMEOUT_MS = 30000;
+type CommandResult = {
+    stdout: string;
+    stderr: string;
+};
+type CommandOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeout?: number;
+    killSignal?: NodeJS.Signals;
+};
+type CommandRunner = (command: string, args: readonly string[], options?: CommandOptions) => Promise<CommandResult>;
+type DockerRunner = (args: readonly string[], options?: CommandOptions) => Promise<CommandResult>;
+type DisposableEnvironment = {
+    DATABASE_URL: string;
+    TEST_DATABASE_URL: string;
+    REDIS_URL: string;
+    TEST_REDIS_URL: string;
+};
+type PostgresConnectionDetails = {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    databaseUrl: string;
+    containerName: string;
+};
+type RedisConnectionDetails = {
+    host: string;
+    port: number;
+    url: string;
+    containerName: string;
+};
+type EphemeralPostgresOptions = {
+    image?: string;
+    host?: string;
+    database?: string;
+    user?: string;
+    password?: string;
+    containerName?: string;
+    startupTimeoutMs?: number;
+    pollIntervalMs?: number;
+    dockerBinary?: string;
+    runDocker?: DockerRunner;
+};
+type EphemeralRedisOptions = {
+    image?: string;
+    host?: string;
+    containerName?: string;
+    startupTimeoutMs?: number;
+    pollIntervalMs?: number;
+    dockerBinary?: string;
+    runDocker?: DockerRunner;
+};
+type MigrationDeployOptions = {
+    databaseUrl: string;
+    prismaSchemaPath: string;
+    cwd?: string;
+    prismaBinary?: string;
+    runCommand?: CommandRunner;
+};
+type DisposableIntegrationInfrastructureOptions = {
+    prismaSchemaPath: string;
+    cwd?: string;
+    prismaBinary?: string;
+    postgres?: EphemeralPostgresOptions;
+    redis?: EphemeralRedisOptions;
+    runCommand?: CommandRunner;
+    deployMigrations?: (options: MigrationDeployOptions) => Promise<void>;
+};
+type DisposableIntegrationInfrastructure = {
+    postgres: PostgresConnectionDetails;
+    redis: RedisConnectionDetails;
+    databaseUrl: string;
+    redisUrl: string;
+    environment: DisposableEnvironment;
+};
+type DisposableIntegrationCallback<T> = (infrastructure: DisposableIntegrationInfrastructure) => Promise<T> | T;
+declare function createCommandRunner(binary?: string): CommandRunner;
+declare function createDockerRunner(dockerBinary?: string): DockerRunner;
+declare class EphemeralPostgres {
+    private readonly image;
+    private readonly host;
+    private readonly database;
+    private readonly user;
+    private readonly password;
+    private readonly containerName;
+    private readonly startupTimeoutMs;
+    private readonly pollIntervalMs;
+    private readonly runDocker;
+    private port;
+    private started;
+    constructor(options?: EphemeralPostgresOptions);
+    get databaseUrl(): string;
+    get connectionDetails(): PostgresConnectionDetails;
+    start(): Promise<PostgresConnectionDetails>;
+    waitForReady(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+declare class EphemeralRedis {
+    private readonly image;
+    private readonly host;
+    private readonly containerName;
+    private readonly startupTimeoutMs;
+    private readonly pollIntervalMs;
+    private readonly runDocker;
+    private port;
+    private started;
+    constructor(options?: EphemeralRedisOptions);
+    get url(): string;
+    get connectionDetails(): RedisConnectionDetails;
+    start(): Promise<RedisConnectionDetails>;
+    waitForReady(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+declare function deployPrismaMigrations(options: MigrationDeployOptions): Promise<void>;
+declare function withDisposableIntegrationInfrastructure<T>(options: DisposableIntegrationInfrastructureOptions, callback: DisposableIntegrationCallback<T>): Promise<T>;
+
+export { type CommandOptions, type CommandResult, type CommandRunner, DEFAULT_COMMAND_TIMEOUT_MS, DEFAULT_DOCKER_COMMAND_TIMEOUT_MS, DEFAULT_HOST, DEFAULT_POLL_INTERVAL_MS, DEFAULT_POSTGRES_IMAGE, DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS, DEFAULT_REDIS_IMAGE, DEFAULT_REDIS_STARTUP_TIMEOUT_MS, type DisposableEnvironment, type DisposableIntegrationCallback, type DisposableIntegrationInfrastructure, type DisposableIntegrationInfrastructureOptions, type DockerRunner, EphemeralPostgres, type EphemeralPostgresOptions, EphemeralRedis, type EphemeralRedisOptions, type MigrationDeployOptions, type PostgresConnectionDetails, type RedisConnectionDetails, createCommandRunner, createDockerRunner, deployPrismaMigrations, withDisposableIntegrationInfrastructure };

package/dist/testing/node.js

@@ -0,0 +1,296 @@
+// src/testing/node.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { randomUUID } from "crypto";
+var execFileAsync = promisify(execFile);
+var DEFAULT_POSTGRES_IMAGE = "postgres:17.6-alpine";
+var DEFAULT_REDIS_IMAGE = "redis:7.4.2-alpine";
+var DEFAULT_HOST = "127.0.0.1";
+var DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS = 3e4;
+var DEFAULT_REDIS_STARTUP_TIMEOUT_MS = 15e3;
+var DEFAULT_POLL_INTERVAL_MS = 200;
+var DEFAULT_COMMAND_TIMEOUT_MS = 12e4;
+var DEFAULT_DOCKER_COMMAND_TIMEOUT_MS = 3e4;
+function createCommandRunner(binary = "") {
+  return async (command, args, options = {}) => {
+    const executable = binary || command;
+    const commandArgs = binary ? [command, ...args] : args;
+    const result = await execFileAsync(executable, commandArgs, {
+      encoding: "utf8",
+      maxBuffer: 1024 * 1024,
+      timeout: DEFAULT_COMMAND_TIMEOUT_MS,
+      ...options
+    });
+    return {
+      stdout: result.stdout.trim(),
+      stderr: result.stderr.trim()
+    };
+  };
+}
+function createDockerRunner(dockerBinary = "docker") {
+  const runCommand = createCommandRunner();
+  return (args, options = {}) => runCommand(dockerBinary, args, {
+    ...options,
+    timeout: options.timeout ?? DEFAULT_DOCKER_COMMAND_TIMEOUT_MS
+  });
+}
+function parseMappedPort(output, serviceName) {
+  const match = output.match(/:(\d+)\s*$/m);
+  if (!match) {
+    throw new Error(`Docker did not return a mapped ${serviceName} port: ${output}`);
+  }
+  return Number(match[1]);
+}
+function sleep(milliseconds) {
+  return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+function createSuffix() {
+  return randomUUID().replaceAll("-", "");
+}
+function requireStarted(value, serviceName) {
+  if (value === null) {
+    throw new Error(`Ephemeral ${serviceName} has not been started`);
+  }
+  return value;
+}
+var EphemeralPostgres = class {
+  image;
+  host;
+  database;
+  user;
+  password;
+  containerName;
+  startupTimeoutMs;
+  pollIntervalMs;
+  runDocker;
+  port = null;
+  started = false;
+  constructor(options = {}) {
+    const suffix = createSuffix();
+    this.image = options.image ?? DEFAULT_POSTGRES_IMAGE;
+    this.host = options.host ?? DEFAULT_HOST;
+    this.database = options.database ?? `moda_test_${suffix.slice(0, 12)}`;
+    this.user = options.user ?? `moda_test_${suffix.slice(0, 12)}`;
+    this.password = options.password ?? `test_${suffix}`;
+    this.containerName = options.containerName ?? `moda-test-postgres-${suffix}`;
+    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS;
+    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);
+  }
+  get databaseUrl() {
+    const port = requireStarted(this.port, "PostgreSQL");
+    return `postgresql://${this.user}:${this.password}@${this.host}:${port}/${this.database}`;
+  }
+  get connectionDetails() {
+    return {
+      host: this.host,
+      port: requireStarted(this.port, "PostgreSQL"),
+      database: this.database,
+      user: this.user,
+      password: this.password,
+      databaseUrl: this.databaseUrl,
+      containerName: this.containerName
+    };
+  }
+  async start() {
+    if (this.started) return this.connectionDetails;
+    try {
+      await this.runDocker([
+        "run",
+        "--detach",
+        "--name",
+        this.containerName,
+        "--env",
+        `POSTGRES_DB=${this.database}`,
+        "--env",
+        `POSTGRES_USER=${this.user}`,
+        "--env",
+        `POSTGRES_PASSWORD=${this.password}`,
+        "--publish",
+        "0:5432",
+        this.image
+      ]);
+      const portResult = await this.runDocker(["port", this.containerName, "5432/tcp"]);
+      this.port = parseMappedPort(portResult.stdout, "PostgreSQL");
+      await this.waitForReady();
+      this.started = true;
+      return this.connectionDetails;
+    } catch (error) {
+      await this.cleanup();
+      throw new Error(
+        `Unable to start ephemeral PostgreSQL (${this.image}): ${errorMessage(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async waitForReady() {
+    const deadline = Date.now() + this.startupTimeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+      try {
+        const result = await this.runDocker([
+          "exec",
+          this.containerName,
+          "pg_isready",
+          "--username",
+          this.user,
+          "--dbname",
+          this.database
+        ]);
+        if (/accepting connections/i.test(result.stdout)) return;
+        lastError = new Error(`Unexpected PostgreSQL readiness response: ${result.stdout}`);
+      } catch (error) {
+        lastError = error;
+      }
+      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));
+    }
+    throw new Error(
+      `PostgreSQL readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : ""}`
+    );
+  }
+  async cleanup() {
+    this.port = null;
+    this.started = false;
+    await this.runDocker(["rm", "--force", "--volumes", this.containerName]).catch(() => void 0);
+  }
+};
+var EphemeralRedis = class {
+  image;
+  host;
+  containerName;
+  startupTimeoutMs;
+  pollIntervalMs;
+  runDocker;
+  port = null;
+  started = false;
+  constructor(options = {}) {
+    const suffix = createSuffix();
+    this.image = options.image ?? DEFAULT_REDIS_IMAGE;
+    this.host = options.host ?? DEFAULT_HOST;
+    this.containerName = options.containerName ?? `moda-test-redis-${suffix}`;
+    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_REDIS_STARTUP_TIMEOUT_MS;
+    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);
+  }
+  get url() {
+    const port = requireStarted(this.port, "Redis");
+    return `redis://${this.host}:${port}`;
+  }
+  get connectionDetails() {
+    return {
+      host: this.host,
+      port: requireStarted(this.port, "Redis"),
+      url: this.url,
+      containerName: this.containerName
+    };
+  }
+  async start() {
+    if (this.started) return this.connectionDetails;
+    try {
+      await this.runDocker([
+        "run",
+        "--detach",
+        "--name",
+        this.containerName,
+        "--publish",
+        "0:6379",
+        this.image
+      ]);
+      const portResult = await this.runDocker(["port", this.containerName, "6379/tcp"]);
+      this.port = parseMappedPort(portResult.stdout, "Redis");
+      await this.waitForReady();
+      this.started = true;
+      return this.connectionDetails;
+    } catch (error) {
+      await this.cleanup();
+      throw new Error(
+        `Unable to start ephemeral Redis (${this.image}): ${errorMessage(error)}`,
+        { cause: error }
+      );
+    }
+  }
+  async waitForReady() {
+    const deadline = Date.now() + this.startupTimeoutMs;
+    let lastError;
+    while (Date.now() < deadline) {
+      try {
+        const result = await this.runDocker(["exec", this.containerName, "redis-cli", "ping"]);
+        if (result.stdout === "PONG") return;
+        lastError = new Error(`Unexpected Redis readiness response: ${result.stdout}`);
+      } catch (error) {
+        lastError = error;
+      }
+      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));
+    }
+    throw new Error(
+      `Redis readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : ""}`
+    );
+  }
+  async cleanup() {
+    this.port = null;
+    this.started = false;
+    await this.runDocker(["rm", "--force", "--volumes", this.containerName]).catch(() => void 0);
+  }
+};
+async function deployPrismaMigrations(options) {
+  const runCommand = options.runCommand ?? createCommandRunner();
+  await runCommand(
+    options.prismaBinary ?? "prisma",
+    ["migrate", "deploy", "--schema", options.prismaSchemaPath],
+    {
+      cwd: options.cwd,
+      env: { ...process.env, DATABASE_URL: options.databaseUrl }
+    }
+  );
+}
+async function withDisposableIntegrationInfrastructure(options, callback) {
+  const postgres = new EphemeralPostgres(options.postgres);
+  const redis = new EphemeralRedis(options.redis);
+  try {
+    const postgresDetails = await postgres.start();
+    const redisDetails = await redis.start();
+    const environment = {
+      DATABASE_URL: postgresDetails.databaseUrl,
+      TEST_DATABASE_URL: postgresDetails.databaseUrl,
+      REDIS_URL: redisDetails.url,
+      TEST_REDIS_URL: redisDetails.url
+    };
+    const deployMigrations = options.deployMigrations ?? deployPrismaMigrations;
+    await deployMigrations({
+      databaseUrl: postgresDetails.databaseUrl,
+      prismaSchemaPath: options.prismaSchemaPath,
+      cwd: options.cwd,
+      prismaBinary: options.prismaBinary,
+      runCommand: options.runCommand
+    });
+    return await callback({
+      postgres: postgresDetails,
+      redis: redisDetails,
+      databaseUrl: postgresDetails.databaseUrl,
+      redisUrl: redisDetails.url,
+      environment
+    });
+  } finally {
+    await Promise.all([postgres.cleanup(), redis.cleanup()]);
+  }
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export {
+  DEFAULT_COMMAND_TIMEOUT_MS,
+  DEFAULT_DOCKER_COMMAND_TIMEOUT_MS,
+  DEFAULT_HOST,
+  DEFAULT_POLL_INTERVAL_MS,
+  DEFAULT_POSTGRES_IMAGE,
+  DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS,
+  DEFAULT_REDIS_IMAGE,
+  DEFAULT_REDIS_STARTUP_TIMEOUT_MS,
+  EphemeralPostgres,
+  EphemeralRedis,
+  createCommandRunner,
+  createDockerRunner,
+  deployPrismaMigrations,
+  withDisposableIntegrationInfrastructure
+};
+//# sourceMappingURL=node.js.map

package/dist/testing/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/node.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { randomUUID } from \"node:crypto\";\n\nconst execFileAsync = promisify(execFile);\n\nexport const DEFAULT_POSTGRES_IMAGE = \"postgres:17.6-alpine\";\nexport const DEFAULT_REDIS_IMAGE = \"redis:7.4.2-alpine\";\nexport const DEFAULT_HOST = \"127.0.0.1\";\nexport const DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS = 30_000;\nexport const DEFAULT_REDIS_STARTUP_TIMEOUT_MS = 15_000;\nexport const DEFAULT_POLL_INTERVAL_MS = 200;\nexport const DEFAULT_COMMAND_TIMEOUT_MS = 120_000;\nexport const DEFAULT_DOCKER_COMMAND_TIMEOUT_MS = 30_000;\n\nexport type CommandResult = {\n  stdout: string;\n  stderr: string;\n};\n\nexport type CommandOptions = {\n  cwd?: string;\n  env?: NodeJS.ProcessEnv;\n  timeout?: number;\n  killSignal?: NodeJS.Signals;\n};\n\nexport type CommandRunner = (\n  command: string,\n  args: readonly string[],\n  options?: CommandOptions,\n) => Promise<CommandResult>;\n\nexport type DockerRunner = (\n  args: readonly string[],\n  options?: CommandOptions,\n) => Promise<CommandResult>;\n\nexport type DisposableEnvironment = {\n  DATABASE_URL: string;\n  TEST_DATABASE_URL: string;\n  REDIS_URL: string;\n  TEST_REDIS_URL: string;\n};\n\nexport type PostgresConnectionDetails = {\n  host: string;\n  port: number;\n  database: string;\n  user: string;\n  password: string;\n  databaseUrl: string;\n  containerName: string;\n};\n\nexport type RedisConnectionDetails = {\n  host: string;\n  port: number;\n  url: string;\n  containerName: string;\n};\n\nexport type EphemeralPostgresOptions = {\n  image?: string;\n  host?: string;\n  database?: string;\n  user?: string;\n  password?: string;\n  containerName?: string;\n  startupTimeoutMs?: number;\n  pollIntervalMs?: number;\n  dockerBinary?: string;\n  runDocker?: DockerRunner;\n};\n\nexport type EphemeralRedisOptions = {\n  image?: string;\n  host?: string;\n  containerName?: string;\n  startupTimeoutMs?: number;\n  pollIntervalMs?: number;\n  dockerBinary?: string;\n  runDocker?: DockerRunner;\n};\n\nexport type MigrationDeployOptions = {\n  databaseUrl: string;\n  prismaSchemaPath: string;\n  cwd?: string;\n  prismaBinary?: string;\n  runCommand?: CommandRunner;\n};\n\nexport type DisposableIntegrationInfrastructureOptions = {\n  prismaSchemaPath: string;\n  cwd?: string;\n  prismaBinary?: string;\n  postgres?: EphemeralPostgresOptions;\n  redis?: EphemeralRedisOptions;\n  runCommand?: CommandRunner;\n  deployMigrations?: (options: MigrationDeployOptions) => Promise<void>;\n};\n\nexport type DisposableIntegrationInfrastructure = {\n  postgres: PostgresConnectionDetails;\n  redis: RedisConnectionDetails;\n  databaseUrl: string;\n  redisUrl: string;\n  environment: DisposableEnvironment;\n};\n\nexport type DisposableIntegrationCallback<T> = (\n  infrastructure: DisposableIntegrationInfrastructure,\n) => Promise<T> | T;\n\nexport function createCommandRunner(binary = \"\"): CommandRunner {\n  return async (command, args, options = {}) => {\n    const executable = binary || command;\n    const commandArgs = binary ? [command, ...args] : args;\n    const result = await execFileAsync(executable, commandArgs, {\n      encoding: \"utf8\",\n      maxBuffer: 1024 * 1024,\n      timeout: DEFAULT_COMMAND_TIMEOUT_MS,\n      ...options,\n    });\n    return {\n      stdout: result.stdout.trim(),\n      stderr: result.stderr.trim(),\n    };\n  };\n}\n\nexport function createDockerRunner(dockerBinary = \"docker\"): DockerRunner {\n  const runCommand = createCommandRunner();\n  return (args, options = {}) =>\n    runCommand(dockerBinary, args, {\n      ...options,\n      timeout: options.timeout ?? DEFAULT_DOCKER_COMMAND_TIMEOUT_MS,\n    });\n}\n\nfunction parseMappedPort(output: string, serviceName: string): number {\n  const match = output.match(/:(\\d+)\\s*$/m);\n  if (!match) {\n    throw new Error(`Docker did not return a mapped ${serviceName} port: ${output}`);\n  }\n  return Number(match[1]);\n}\n\nfunction sleep(milliseconds: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, milliseconds));\n}\n\nfunction createSuffix(): string {\n  return randomUUID().replaceAll(\"-\", \"\");\n}\n\nfunction requireStarted<T>(value: T | null, serviceName: string): T {\n  if (value === null) {\n    throw new Error(`Ephemeral ${serviceName} has not been started`);\n  }\n  return value;\n}\n\nexport class EphemeralPostgres {\n  private readonly image: string;\n  private readonly host: string;\n  private readonly database: string;\n  private readonly user: string;\n  private readonly password: string;\n  private readonly containerName: string;\n  private readonly startupTimeoutMs: number;\n  private readonly pollIntervalMs: number;\n  private readonly runDocker: DockerRunner;\n  private port: number | null = null;\n  private started = false;\n\n  constructor(options: EphemeralPostgresOptions = {}) {\n    const suffix = createSuffix();\n    this.image = options.image ?? DEFAULT_POSTGRES_IMAGE;\n    this.host = options.host ?? DEFAULT_HOST;\n    this.database = options.database ?? `moda_test_${suffix.slice(0, 12)}`;\n    this.user = options.user ?? `moda_test_${suffix.slice(0, 12)}`;\n    this.password = options.password ?? `test_${suffix}`;\n    this.containerName = options.containerName ?? `moda-test-postgres-${suffix}`;\n    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_POSTGRES_STARTUP_TIMEOUT_MS;\n    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);\n  }\n\n  get databaseUrl(): string {\n    const port = requireStarted(this.port, \"PostgreSQL\");\n    return `postgresql://${this.user}:${this.password}@${this.host}:${port}/${this.database}`;\n  }\n\n  get connectionDetails(): PostgresConnectionDetails {\n    return {\n      host: this.host,\n      port: requireStarted(this.port, \"PostgreSQL\"),\n      database: this.database,\n      user: this.user,\n      password: this.password,\n      databaseUrl: this.databaseUrl,\n      containerName: this.containerName,\n    };\n  }\n\n  async start(): Promise<PostgresConnectionDetails> {\n    if (this.started) return this.connectionDetails;\n\n    try {\n      await this.runDocker([\n        \"run\",\n        \"--detach\",\n        \"--name\",\n        this.containerName,\n        \"--env\",\n        `POSTGRES_DB=${this.database}`,\n        \"--env\",\n        `POSTGRES_USER=${this.user}`,\n        \"--env\",\n        `POSTGRES_PASSWORD=${this.password}`,\n        \"--publish\",\n        \"0:5432\",\n        this.image,\n      ]);\n      const portResult = await this.runDocker([\"port\", this.containerName, \"5432/tcp\"]);\n      this.port = parseMappedPort(portResult.stdout, \"PostgreSQL\");\n      await this.waitForReady();\n      this.started = true;\n      return this.connectionDetails;\n    } catch (error) {\n      await this.cleanup();\n      throw new Error(\n        `Unable to start ephemeral PostgreSQL (${this.image}): ${errorMessage(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  async waitForReady(): Promise<void> {\n    const deadline = Date.now() + this.startupTimeoutMs;\n    let lastError: unknown;\n\n    while (Date.now() < deadline) {\n      try {\n        const result = await this.runDocker([\n          \"exec\",\n          this.containerName,\n          \"pg_isready\",\n          \"--username\",\n          this.user,\n          \"--dbname\",\n          this.database,\n        ]);\n        if (/accepting connections/i.test(result.stdout)) return;\n        lastError = new Error(`Unexpected PostgreSQL readiness response: ${result.stdout}`);\n      } catch (error) {\n        lastError = error;\n      }\n      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));\n    }\n\n    throw new Error(\n      `PostgreSQL readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : \"\"}`,\n    );\n  }\n\n  async cleanup(): Promise<void> {\n    this.port = null;\n    this.started = false;\n    await this.runDocker([\"rm\", \"--force\", \"--volumes\", this.containerName]).catch(() => undefined);\n  }\n}\n\nexport class EphemeralRedis {\n  private readonly image: string;\n  private readonly host: string;\n  private readonly containerName: string;\n  private readonly startupTimeoutMs: number;\n  private readonly pollIntervalMs: number;\n  private readonly runDocker: DockerRunner;\n  private port: number | null = null;\n  private started = false;\n\n  constructor(options: EphemeralRedisOptions = {}) {\n    const suffix = createSuffix();\n    this.image = options.image ?? DEFAULT_REDIS_IMAGE;\n    this.host = options.host ?? DEFAULT_HOST;\n    this.containerName = options.containerName ?? `moda-test-redis-${suffix}`;\n    this.startupTimeoutMs = options.startupTimeoutMs ?? DEFAULT_REDIS_STARTUP_TIMEOUT_MS;\n    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    this.runDocker = options.runDocker ?? createDockerRunner(options.dockerBinary);\n  }\n\n  get url(): string {\n    const port = requireStarted(this.port, \"Redis\");\n    return `redis://${this.host}:${port}`;\n  }\n\n  get connectionDetails(): RedisConnectionDetails {\n    return {\n      host: this.host,\n      port: requireStarted(this.port, \"Redis\"),\n      url: this.url,\n      containerName: this.containerName,\n    };\n  }\n\n  async start(): Promise<RedisConnectionDetails> {\n    if (this.started) return this.connectionDetails;\n\n    try {\n      await this.runDocker([\n        \"run\",\n        \"--detach\",\n        \"--name\",\n        this.containerName,\n        \"--publish\",\n        \"0:6379\",\n        this.image,\n      ]);\n      const portResult = await this.runDocker([\"port\", this.containerName, \"6379/tcp\"]);\n      this.port = parseMappedPort(portResult.stdout, \"Redis\");\n      await this.waitForReady();\n      this.started = true;\n      return this.connectionDetails;\n    } catch (error) {\n      await this.cleanup();\n      throw new Error(\n        `Unable to start ephemeral Redis (${this.image}): ${errorMessage(error)}`,\n        { cause: error },\n      );\n    }\n  }\n\n  async waitForReady(): Promise<void> {\n    const deadline = Date.now() + this.startupTimeoutMs;\n    let lastError: unknown;\n\n    while (Date.now() < deadline) {\n      try {\n        const result = await this.runDocker([\"exec\", this.containerName, \"redis-cli\", \"ping\"]);\n        if (result.stdout === \"PONG\") return;\n        lastError = new Error(`Unexpected Redis readiness response: ${result.stdout}`);\n      } catch (error) {\n        lastError = error;\n      }\n      await sleep(Math.min(this.pollIntervalMs, Math.max(0, deadline - Date.now())));\n    }\n\n    throw new Error(\n      `Redis readiness timed out after ${this.startupTimeoutMs}ms${lastError ? `: ${errorMessage(lastError)}` : \"\"}`,\n    );\n  }\n\n  async cleanup(): Promise<void> {\n    this.port = null;\n    this.started = false;\n    await this.runDocker([\"rm\", \"--force\", \"--volumes\", this.containerName]).catch(() => undefined);\n  }\n}\n\nexport async function deployPrismaMigrations(options: MigrationDeployOptions): Promise<void> {\n  const runCommand = options.runCommand ?? createCommandRunner();\n  await runCommand(\n    options.prismaBinary ?? \"prisma\",\n    [\"migrate\", \"deploy\", \"--schema\", options.prismaSchemaPath],\n    {\n      cwd: options.cwd,\n      env: { ...process.env, DATABASE_URL: options.databaseUrl },\n    },\n  );\n}\n\nexport async function withDisposableIntegrationInfrastructure<T>(\n  options: DisposableIntegrationInfrastructureOptions,\n  callback: DisposableIntegrationCallback<T>,\n): Promise<T> {\n  const postgres = new EphemeralPostgres(options.postgres);\n  const redis = new EphemeralRedis(options.redis);\n\n  try {\n    const postgresDetails = await postgres.start();\n    const redisDetails = await redis.start();\n    const environment: DisposableEnvironment = {\n      DATABASE_URL: postgresDetails.databaseUrl,\n      TEST_DATABASE_URL: postgresDetails.databaseUrl,\n      REDIS_URL: redisDetails.url,\n      TEST_REDIS_URL: redisDetails.url,\n    };\n    const deployMigrations = options.deployMigrations ?? deployPrismaMigrations;\n    await deployMigrations({\n      databaseUrl: postgresDetails.databaseUrl,\n      prismaSchemaPath: options.prismaSchemaPath,\n      cwd: options.cwd,\n      prismaBinary: options.prismaBinary,\n      runCommand: options.runCommand,\n    });\n    return await callback({\n      postgres: postgresDetails,\n      redis: redisDetails,\n      databaseUrl: postgresDetails.databaseUrl,\n      redisUrl: redisDetails.url,\n      environment,\n    });\n  } finally {\n    await Promise.all([postgres.cleanup(), redis.cleanup()]);\n  }\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAE3B,IAAM,gBAAgB,UAAU,QAAQ;AAEjC,IAAM,yBAAyB;AAC/B,IAAM,sBAAsB;AAC5B,IAAM,eAAe;AACrB,IAAM,sCAAsC;AAC5C,IAAM,mCAAmC;AACzC,IAAM,2BAA2B;AACjC,IAAM,6BAA6B;AACnC,IAAM,oCAAoC;AAsG1C,SAAS,oBAAoB,SAAS,IAAmB;AAC9D,SAAO,OAAO,SAAS,MAAM,UAAU,CAAC,MAAM;AAC5C,UAAM,aAAa,UAAU;AAC7B,UAAM,cAAc,SAAS,CAAC,SAAS,GAAG,IAAI,IAAI;AAClD,UAAM,SAAS,MAAM,cAAc,YAAY,aAAa;AAAA,MAC1D,UAAU;AAAA,MACV,WAAW,OAAO;AAAA,MAClB,SAAS;AAAA,MACT,GAAG;AAAA,IACL,CAAC;AACD,WAAO;AAAA,MACL,QAAQ,OAAO,OAAO,KAAK;AAAA,MAC3B,QAAQ,OAAO,OAAO,KAAK;AAAA,IAC7B;AAAA,EACF;AACF;AAEO,SAAS,mBAAmB,eAAe,UAAwB;AACxE,QAAM,aAAa,oBAAoB;AACvC,SAAO,CAAC,MAAM,UAAU,CAAC,MACvB,WAAW,cAAc,MAAM;AAAA,IAC7B,GAAG;AAAA,IACH,SAAS,QAAQ,WAAW;AAAA,EAC9B,CAAC;AACL;AAEA,SAAS,gBAAgB,QAAgB,aAA6B;AACpE,QAAM,QAAQ,OAAO,MAAM,aAAa;AACxC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,kCAAkC,WAAW,UAAU,MAAM,EAAE;AAAA,EACjF;AACA,SAAO,OAAO,MAAM,CAAC,CAAC;AACxB;AAEA,SAAS,MAAM,cAAqC;AAClD,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,YAAY,CAAC;AACnE;AAEA,SAAS,eAAuB;AAC9B,SAAO,WAAW,EAAE,WAAW,KAAK,EAAE;AACxC;AAEA,SAAS,eAAkB,OAAiB,aAAwB;AAClE,MAAI,UAAU,MAAM;AAClB,UAAM,IAAI,MAAM,aAAa,WAAW,uBAAuB;AAAA,EACjE;AACA,SAAO;AACT;AAEO,IAAM,oBAAN,MAAwB;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACT,OAAsB;AAAA,EACtB,UAAU;AAAA,EAElB,YAAY,UAAoC,CAAC,GAAG;AAClD,UAAM,SAAS,aAAa;AAC5B,SAAK,QAAQ,QAAQ,SAAS;AAC9B,SAAK,OAAO,QAAQ,QAAQ;AAC5B,SAAK,WAAW,QAAQ,YAAY,aAAa,OAAO,MAAM,GAAG,EAAE,CAAC;AACpE,SAAK,OAAO,QAAQ,QAAQ,aAAa,OAAO,MAAM,GAAG,EAAE,CAAC;AAC5D,SAAK,WAAW,QAAQ,YAAY,QAAQ,MAAM;AAClD,SAAK,gBAAgB,QAAQ,iBAAiB,sBAAsB,MAAM;AAC1E,SAAK,mBAAmB,QAAQ,oBAAoB;AACpD,SAAK,iBAAiB,QAAQ,kBAAkB;AAChD,SAAK,YAAY,QAAQ,aAAa,mBAAmB,QAAQ,YAAY;AAAA,EAC/E;AAAA,EAEA,IAAI,cAAsB;AACxB,UAAM,OAAO,eAAe,KAAK,MAAM,YAAY;AACnD,WAAO,gBAAgB,KAAK,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK,QAAQ;AAAA,EACzF;AAAA,EAEA,IAAI,oBAA+C;AACjD,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,eAAe,KAAK,MAAM,YAAY;AAAA,MAC5C,UAAU,KAAK;AAAA,MACf,MAAM,KAAK;AAAA,MACX,UAAU,KAAK;AAAA,MACf,aAAa,KAAK;AAAA,MAClB,eAAe,KAAK;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,MAAM,QAA4C;AAChD,QAAI,KAAK,QAAS,QAAO,KAAK;AAE9B,QAAI;AACF,YAAM,KAAK,UAAU;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK;AAAA,QACL;AAAA,QACA,eAAe,KAAK,QAAQ;AAAA,QAC5B;AAAA,QACA,iBAAiB,KAAK,IAAI;AAAA,QAC1B;AAAA,QACA,qBAAqB,KAAK,QAAQ;AAAA,QAClC;AAAA,QACA;AAAA,QACA,KAAK;AAAA,MACP,CAAC;AACD,YAAM,aAAa,MAAM,KAAK,UAAU,CAAC,QAAQ,KAAK,eAAe,UAAU,CAAC;AAChF,WAAK,OAAO,gBAAgB,WAAW,QAAQ,YAAY;AAC3D,YAAM,KAAK,aAAa;AACxB,WAAK,UAAU;AACf,aAAO,KAAK;AAAA,IACd,SAAS,OAAO;AACd,YAAM,KAAK,QAAQ;AACnB,YAAM,IAAI;AAAA,QACR,yCAAyC,KAAK,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,QAC5E,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,eAA8B;AAClC,UAAM,WAAW,KAAK,IAAI,IAAI,KAAK;AACnC,QAAI;AAEJ,WAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,UAAI;AACF,cAAM,SAAS,MAAM,KAAK,UAAU;AAAA,UAClC;AAAA,UACA,KAAK;AAAA,UACL;AAAA,UACA;AAAA,UACA,KAAK;AAAA,UACL;AAAA,UACA,KAAK;AAAA,QACP,CAAC;AACD,YAAI,yBAAyB,KAAK,OAAO,MAAM,EAAG;AAClD,oBAAY,IAAI,MAAM,6CAA6C,OAAO,MAAM,EAAE;AAAA,MACpF,SAAS,OAAO;AACd,oBAAY;AAAA,MACd;AACA,YAAM,MAAM,KAAK,IAAI,KAAK,gBAAgB,KAAK,IAAI,GAAG,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC;AAAA,IAC/E;AAEA,UAAM,IAAI;AAAA,MACR,wCAAwC,KAAK,gBAAgB,KAAK,YAAY,KAAK,aAAa,SAAS,CAAC,KAAK,EAAE;AAAA,IACnH;AAAA,EACF;AAAA,EAEA,MAAM,UAAyB;AAC7B,SAAK,OAAO;AACZ,SAAK,UAAU;AACf,UAAM,KAAK,UAAU,CAAC,MAAM,WAAW,aAAa,KAAK,aAAa,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,EAChG;AACF;AAEO,IAAM,iBAAN,MAAqB;AAAA,EACT;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACT,OAAsB;AAAA,EACtB,UAAU;AAAA,EAElB,YAAY,UAAiC,CAAC,GAAG;AAC/C,UAAM,SAAS,aAAa;AAC5B,SAAK,QAAQ,QAAQ,SAAS;AAC9B,SAAK,OAAO,QAAQ,QAAQ;AAC5B,SAAK,gBAAgB,QAAQ,iBAAiB,mBAAmB,MAAM;AACvE,SAAK,mBAAmB,QAAQ,oBAAoB;AACpD,SAAK,iBAAiB,QAAQ,kBAAkB;AAChD,SAAK,YAAY,QAAQ,aAAa,mBAAmB,QAAQ,YAAY;AAAA,EAC/E;AAAA,EAEA,IAAI,MAAc;AAChB,UAAM,OAAO,eAAe,KAAK,MAAM,OAAO;AAC9C,WAAO,WAAW,KAAK,IAAI,IAAI,IAAI;AAAA,EACrC;AAAA,EAEA,IAAI,oBAA4C;AAC9C,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,eAAe,KAAK,MAAM,OAAO;AAAA,MACvC,KAAK,KAAK;AAAA,MACV,eAAe,KAAK;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,MAAM,QAAyC;AAC7C,QAAI,KAAK,QAAS,QAAO,KAAK;AAE9B,QAAI;AACF,YAAM,KAAK,UAAU;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,QACA,KAAK;AAAA,QACL;AAAA,QACA;AAAA,QACA,KAAK;AAAA,MACP,CAAC;AACD,YAAM,aAAa,MAAM,KAAK,UAAU,CAAC,QAAQ,KAAK,eAAe,UAAU,CAAC;AAChF,WAAK,OAAO,gBAAgB,WAAW,QAAQ,OAAO;AACtD,YAAM,KAAK,aAAa;AACxB,WAAK,UAAU;AACf,aAAO,KAAK;AAAA,IACd,SAAS,OAAO;AACd,YAAM,KAAK,QAAQ;AACnB,YAAM,IAAI;AAAA,QACR,oCAAoC,KAAK,KAAK,MAAM,aAAa,KAAK,CAAC;AAAA,QACvE,EAAE,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,eAA8B;AAClC,UAAM,WAAW,KAAK,IAAI,IAAI,KAAK;AACnC,QAAI;AAEJ,WAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,UAAI;AACF,cAAM,SAAS,MAAM,KAAK,UAAU,CAAC,QAAQ,KAAK,eAAe,aAAa,MAAM,CAAC;AACrF,YAAI,OAAO,WAAW,OAAQ;AAC9B,oBAAY,IAAI,MAAM,wCAAwC,OAAO,MAAM,EAAE;AAAA,MAC/E,SAAS,OAAO;AACd,oBAAY;AAAA,MACd;AACA,YAAM,MAAM,KAAK,IAAI,KAAK,gBAAgB,KAAK,IAAI,GAAG,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC;AAAA,IAC/E;AAEA,UAAM,IAAI;AAAA,MACR,mCAAmC,KAAK,gBAAgB,KAAK,YAAY,KAAK,aAAa,SAAS,CAAC,KAAK,EAAE;AAAA,IAC9G;AAAA,EACF;AAAA,EAEA,MAAM,UAAyB;AAC7B,SAAK,OAAO;AACZ,SAAK,UAAU;AACf,UAAM,KAAK,UAAU,CAAC,MAAM,WAAW,aAAa,KAAK,aAAa,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,EAChG;AACF;AAEA,eAAsB,uBAAuB,SAAgD;AAC3F,QAAM,aAAa,QAAQ,cAAc,oBAAoB;AAC7D,QAAM;AAAA,IACJ,QAAQ,gBAAgB;AAAA,IACxB,CAAC,WAAW,UAAU,YAAY,QAAQ,gBAAgB;AAAA,IAC1D;AAAA,MACE,KAAK,QAAQ;AAAA,MACb,KAAK,EAAE,GAAG,QAAQ,KAAK,cAAc,QAAQ,YAAY;AAAA,IAC3D;AAAA,EACF;AACF;AAEA,eAAsB,wCACpB,SACA,UACY;AACZ,QAAM,WAAW,IAAI,kBAAkB,QAAQ,QAAQ;AACvD,QAAM,QAAQ,IAAI,eAAe,QAAQ,KAAK;AAE9C,MAAI;AACF,UAAM,kBAAkB,MAAM,SAAS,MAAM;AAC7C,UAAM,eAAe,MAAM,MAAM,MAAM;AACvC,UAAM,cAAqC;AAAA,MACzC,cAAc,gBAAgB;AAAA,MAC9B,mBAAmB,gBAAgB;AAAA,MACnC,WAAW,aAAa;AAAA,MACxB,gBAAgB,aAAa;AAAA,IAC/B;AACA,UAAM,mBAAmB,QAAQ,oBAAoB;AACrD,UAAM,iBAAiB;AAAA,MACrB,aAAa,gBAAgB;AAAA,MAC7B,kBAAkB,QAAQ;AAAA,MAC1B,KAAK,QAAQ;AAAA,MACb,cAAc,QAAQ;AAAA,MACtB,YAAY,QAAQ;AAAA,IACtB,CAAC;AACD,WAAO,MAAM,SAAS;AAAA,MACpB,UAAU;AAAA,MACV,OAAO;AAAA,MACP,aAAa,gBAAgB;AAAA,MAC7B,UAAU,aAAa;AAAA,MACvB;AAAA,IACF,CAAC;AAAA,EACH,UAAE;AACA,UAAM,QAAQ,IAAI,CAAC,SAAS,QAAQ,GAAG,MAAM,QAAQ,CAAC,CAAC;AAAA,EACzD;AACF;AAEA,SAAS,aAAa,OAAwB;AAC5C,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,6 +16,10 @@
       "types": "./dist/internationalization.d.ts",
       "import": "./dist/internationalization.js"
     },
+    "./billing": {
+      "types": "./dist/billing.d.ts",
+      "import": "./dist/billing.js"
+    },
     "./merchant-communications": {
       "types": "./dist/merchant-communications.d.ts",
       "import": "./dist/merchant-communications.js"
@@ -24,6 +28,10 @@
       "types": "./dist/merchant-communications/node.d.ts",
       "import": "./dist/merchant-communications/node.js"
     },
+    "./testing/node": {
+      "types": "./dist/testing/node.d.ts",
+      "import": "./dist/testing/node.js"
+    },
     "./shopify": {
       "types": "./dist/shopify/index.d.ts",
       "import": "./dist/shopify/index.js"
@@ -66,6 +74,8 @@
     "test": "tsx --test \"src/**/*.test.ts\"",
     "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",
+    "validate:testing-node-live": "npm run build && node scripts/validate-testing-node-live.mjs",
     "prepack": "npm run build"
   },
   "dependencies": {