@modainteract/moda-interact-shared 0.8.0 → 0.9.0

package/dist/billing.d.ts

@@ -23,6 +23,13 @@ declare const BILLING_SYSTEM_MESSAGE_CODES: {
     readonly PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED";
     readonly SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED";
     readonly SAFETY_LIMIT_REACHED: "BILLING_SAFETY_LIMIT_REACHED";
+    readonly PLAN_CHANGE_ACTION_REQUIRED: "BILLING_PLAN_CHANGE_ACTION_REQUIRED";
+    readonly CANCELLATION_REQUEST_RECEIVED: "BILLING_CANCELLATION_REQUEST_RECEIVED";
+    readonly CANCELLATION_COMPLETED: "BILLING_CANCELLATION_COMPLETED";
+    readonly CANCELLATION_REJECTED: "BILLING_CANCELLATION_REJECTED";
+    readonly REFUND_REQUEST_RECEIVED: "BILLING_REFUND_REQUEST_RECEIVED";
+    readonly REFUND_COMPLETED: "BILLING_REFUND_COMPLETED";
+    readonly REFUND_REJECTED: "BILLING_REFUND_REJECTED";
 };
 declare const BillingSystemMessageCodeSchema: z.ZodEnum<{
     BILLING_FREE_ALLOWANCE_WARNING: "BILLING_FREE_ALLOWANCE_WARNING";
@@ -31,8 +38,57 @@ declare const BillingSystemMessageCodeSchema: z.ZodEnum<{
     BILLING_PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED";
     BILLING_SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED";
     BILLING_SAFETY_LIMIT_REACHED: "BILLING_SAFETY_LIMIT_REACHED";
+    BILLING_PLAN_CHANGE_ACTION_REQUIRED: "BILLING_PLAN_CHANGE_ACTION_REQUIRED";
+    BILLING_CANCELLATION_REQUEST_RECEIVED: "BILLING_CANCELLATION_REQUEST_RECEIVED";
+    BILLING_CANCELLATION_COMPLETED: "BILLING_CANCELLATION_COMPLETED";
+    BILLING_CANCELLATION_REJECTED: "BILLING_CANCELLATION_REJECTED";
+    BILLING_REFUND_REQUEST_RECEIVED: "BILLING_REFUND_REQUEST_RECEIVED";
+    BILLING_REFUND_COMPLETED: "BILLING_REFUND_COMPLETED";
+    BILLING_REFUND_REJECTED: "BILLING_REFUND_REJECTED";
 }>;
 type BillingSystemMessageCode = z.infer<typeof BillingSystemMessageCodeSchema>;
+declare const SUBSCRIPTION_CANCELLATION_MODES: readonly ["END_OF_CYCLE", "IMMEDIATE_NO_PRORATION", "IMMEDIATE_PRORATED", "IMMEDIATE_SKIP_FINAL_USAGE"];
+declare const SubscriptionCancellationModeSchema: z.ZodEnum<{
+    END_OF_CYCLE: "END_OF_CYCLE";
+    IMMEDIATE_NO_PRORATION: "IMMEDIATE_NO_PRORATION";
+    IMMEDIATE_PRORATED: "IMMEDIATE_PRORATED";
+    IMMEDIATE_SKIP_FINAL_USAGE: "IMMEDIATE_SKIP_FINAL_USAGE";
+}>;
+type SubscriptionCancellationMode = z.infer<typeof SubscriptionCancellationModeSchema>;
+type ShopifySubscriptionCancellationArgs = Readonly<{
+    deferCancellation: boolean;
+    prorate: boolean;
+    skipFinalUsageCharge: boolean;
+}>;
+declare const SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS: {
+    readonly END_OF_CYCLE: {
+        readonly deferCancellation: true;
+        readonly prorate: false;
+        readonly skipFinalUsageCharge: false;
+    };
+    readonly IMMEDIATE_NO_PRORATION: {
+        readonly deferCancellation: false;
+        readonly prorate: false;
+        readonly skipFinalUsageCharge: false;
+    };
+    readonly IMMEDIATE_PRORATED: {
+        readonly deferCancellation: false;
+        readonly prorate: true;
+        readonly skipFinalUsageCharge: false;
+    };
+    readonly IMMEDIATE_SKIP_FINAL_USAGE: {
+        readonly deferCancellation: false;
+        readonly prorate: false;
+        readonly skipFinalUsageCharge: true;
+    };
+};
+type PurchasedRecoveryCreditCounterSnapshot = Readonly<{
+    grantedQuantity: number;
+    committedQuantity: number;
+    reservedQuantity: number;
+    refundingQuantity: number;
+}>;
+declare function availablePurchasedRecoveryCredits(counter: PurchasedRecoveryCreditCounterSnapshot): number;
 declare const WHATSAPP_PROVIDER_STATUSES: readonly ["SENT", "DELIVERED", "READ", "FAILED"];
 declare const WhatsAppProviderStatusSchema: z.ZodEnum<{
     SENT: "SENT";
@@ -84,4 +140,4 @@ declare function createMerchantBillingSystemSourceKey(shopId: string, code: Bill
 declare function createRecoveryIdempotencyKey(shopId: string, recoveryId: string): string;
 declare function createShopifyUsageIdempotencyKey(shopId: string, usageEventId: string): string;
 
-export { 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 };
+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 };

package/dist/billing.js

@@ -7,16 +7,20 @@ import {
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
+  SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS,
+  SUBSCRIPTION_CANCELLATION_MODES,
+  SubscriptionCancellationModeSchema,
   WHATSAPP_PROVIDER_STATUSES,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
+  availablePurchasedRecoveryCredits,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey,
   parseNormalizedWhatsAppStatus,
   safeParseNormalizedWhatsAppStatus
-} from "./chunk-RFTEH4ER.js";
+} from "./chunk-YDKVCS3T.js";
 export {
   ARCH007_BILLING_CONTRACT_SCHEMA_VERSION,
   BILLING_PLAN_KINDS,
@@ -26,10 +30,14 @@ export {
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
+  SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS,
+  SUBSCRIPTION_CANCELLATION_MODES,
+  SubscriptionCancellationModeSchema,
   WHATSAPP_PROVIDER_STATUSES,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
+  availablePurchasedRecoveryCredits,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey,

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

@@ -17,7 +17,14 @@ var BILLING_SYSTEM_MESSAGE_CODES = {
   PLAN_UPGRADED: "BILLING_PLAN_UPGRADED",
   PLAN_DOWNGRADE_SCHEDULED: "BILLING_PLAN_DOWNGRADE_SCHEDULED",
   SUBSCRIPTION_ENDED: "BILLING_SUBSCRIPTION_ENDED",
-  SAFETY_LIMIT_REACHED: "BILLING_SAFETY_LIMIT_REACHED"
+  SAFETY_LIMIT_REACHED: "BILLING_SAFETY_LIMIT_REACHED",
+  PLAN_CHANGE_ACTION_REQUIRED: "BILLING_PLAN_CHANGE_ACTION_REQUIRED",
+  CANCELLATION_REQUEST_RECEIVED: "BILLING_CANCELLATION_REQUEST_RECEIVED",
+  CANCELLATION_COMPLETED: "BILLING_CANCELLATION_COMPLETED",
+  CANCELLATION_REJECTED: "BILLING_CANCELLATION_REJECTED",
+  REFUND_REQUEST_RECEIVED: "BILLING_REFUND_REQUEST_RECEIVED",
+  REFUND_COMPLETED: "BILLING_REFUND_COMPLETED",
+  REFUND_REJECTED: "BILLING_REFUND_REJECTED"
 };
 var BILLING_SYSTEM_MESSAGE_CODE_VALUES = [
   BILLING_SYSTEM_MESSAGE_CODES.FREE_ALLOWANCE_WARNING,
@@ -25,9 +32,56 @@ var BILLING_SYSTEM_MESSAGE_CODE_VALUES = [
   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
+  BILLING_SYSTEM_MESSAGE_CODES.SAFETY_LIMIT_REACHED,
+  BILLING_SYSTEM_MESSAGE_CODES.PLAN_CHANGE_ACTION_REQUIRED,
+  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_REQUEST_RECEIVED,
+  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_COMPLETED,
+  BILLING_SYSTEM_MESSAGE_CODES.CANCELLATION_REJECTED,
+  BILLING_SYSTEM_MESSAGE_CODES.REFUND_REQUEST_RECEIVED,
+  BILLING_SYSTEM_MESSAGE_CODES.REFUND_COMPLETED,
+  BILLING_SYSTEM_MESSAGE_CODES.REFUND_REJECTED
 ];
 var BillingSystemMessageCodeSchema = z.enum(BILLING_SYSTEM_MESSAGE_CODE_VALUES);
+var SUBSCRIPTION_CANCELLATION_MODES = [
+  "END_OF_CYCLE",
+  "IMMEDIATE_NO_PRORATION",
+  "IMMEDIATE_PRORATED",
+  "IMMEDIATE_SKIP_FINAL_USAGE"
+];
+var SubscriptionCancellationModeSchema = z.enum(SUBSCRIPTION_CANCELLATION_MODES);
+var SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS = {
+  END_OF_CYCLE: {
+    deferCancellation: true,
+    prorate: false,
+    skipFinalUsageCharge: false
+  },
+  IMMEDIATE_NO_PRORATION: {
+    deferCancellation: false,
+    prorate: false,
+    skipFinalUsageCharge: false
+  },
+  IMMEDIATE_PRORATED: {
+    deferCancellation: false,
+    prorate: true,
+    skipFinalUsageCharge: false
+  },
+  IMMEDIATE_SKIP_FINAL_USAGE: {
+    deferCancellation: false,
+    prorate: false,
+    skipFinalUsageCharge: true
+  }
+};
+function availablePurchasedRecoveryCredits(counter) {
+  for (const [name, value] of Object.entries(counter)) {
+    if (!Number.isInteger(value) || value < 0) {
+      throw new Error(`${name} must be a non-negative integer`);
+    }
+  }
+  return Math.max(
+    counter.grantedQuantity - counter.committedQuantity - counter.reservedQuantity - counter.refundingQuantity,
+    0
+  );
+}
 var WHATSAPP_PROVIDER_STATUSES = [
   "SENT",
   "DELIVERED",
@@ -105,6 +159,10 @@ export {
   BillingUsageMetricSchema,
   BILLING_SYSTEM_MESSAGE_CODES,
   BillingSystemMessageCodeSchema,
+  SUBSCRIPTION_CANCELLATION_MODES,
+  SubscriptionCancellationModeSchema,
+  SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS,
+  availablePurchasedRecoveryCredits,
   WHATSAPP_PROVIDER_STATUSES,
   WhatsAppProviderStatusSchema,
   WhatsAppProviderPricingMetadataSchema,
@@ -115,4 +173,4 @@ export {
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey
 };
-//# sourceMappingURL=chunk-RFTEH4ER.js.map
+//# sourceMappingURL=chunk-YDKVCS3T.js.map

package/dist/chunk-YDKVCS3T.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;\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":[]}

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, WHATSAPP_PROVIDER_STATUSES, WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION, WhatsAppProviderPricingMetadata, WhatsAppProviderPricingMetadataSchema, WhatsAppProviderStatus, WhatsAppProviderStatusSchema, createMerchantBillingSystemSourceKey, createRecoveryIdempotencyKey, createShopifyUsageIdempotencyKey, parseNormalizedWhatsAppStatus, safeParseNormalizedWhatsAppStatus } from './billing.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 { 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

@@ -7,16 +7,20 @@ import {
   BillingSystemMessageCodeSchema,
   BillingUsageMetricSchema,
   NormalizedWhatsAppStatusSchema,
+  SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS,
+  SUBSCRIPTION_CANCELLATION_MODES,
+  SubscriptionCancellationModeSchema,
   WHATSAPP_PROVIDER_STATUSES,
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
+  availablePurchasedRecoveryCredits,
   createMerchantBillingSystemSourceKey,
   createRecoveryIdempotencyKey,
   createShopifyUsageIdempotencyKey,
   parseNormalizedWhatsAppStatus,
   safeParseNormalizedWhatsAppStatus
-} from "./chunk-RFTEH4ER.js";
+} from "./chunk-YDKVCS3T.js";
 import {
   AuthoredSupportBodySchema,
   MERCHANT_COMMUNICATIONS_JOB_NAMES,
@@ -146,8 +150,10 @@ export {
   SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V2,
   SHOPIFY_COMMERCE_EVENT_TYPES,
   SHOPIFY_RECOVERY_EVENT_TYPES_V2,
+  SHOPIFY_SUBSCRIPTION_CANCELLATION_ARGS,
   SHOPIFY_WEBHOOK_OUTBOX_DESTINATIONS,
   SHOPIFY_WEBHOOK_QUEUE_CONTRACTS,
+  SUBSCRIPTION_CANCELLATION_MODES,
   ShopifyCartActivityEventV2Schema,
   ShopifyCartActivityPayloadV2Schema,
   ShopifyCheckoutCreatedEventV2Schema,
@@ -162,6 +168,7 @@ export {
   ShopifyOrderCompletedEventV2Schema,
   ShopifyRecoveryEventV2Schema,
   ShopifyTenantSchema,
+  SubscriptionCancellationModeSchema,
   TimeZoneIdSchema,
   TranslatedSupportBodySchema,
   TranslationBatchPollJobSchema,
@@ -173,6 +180,7 @@ export {
   WHATSAPP_PROVIDER_STATUS_SCHEMA_VERSION,
   WhatsAppProviderPricingMetadataSchema,
   WhatsAppProviderStatusSchema,
+  availablePurchasedRecoveryCredits,
   canonicaliseLanguageTag,
   countUnicodeGraphemes,
   createInternationalizationRuntime,

package/package.json

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

package/dist/chunk-RFTEH4ER.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} 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    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":[]}