@modainteract/moda-interact-shared 0.1.0 → 0.3.0

package/dist/shopify/index.d.ts

@@ -1,12 +1,21 @@
 import { z } from 'zod';
 
+declare const SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V1: 1;
+declare const SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V2: 2;
 declare const SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION: 1;
-declare const SHOPIFY_COMMERCE_QUEUE: "commerce-events";
-declare const SHOPIFY_COMMERCE_JOB: "shopify-commerce-event";
 declare const SHOPIFY_COMMERCE_EVENT_TYPES: {
     readonly CHECKOUT_OBSERVED: "checkout.observed";
     readonly ORDER_COMPLETED: "order.completed";
 };
+declare const SHOPIFY_RECOVERY_EVENT_TYPES_V2: {
+    readonly CHECKOUT_CREATED: "checkout.created";
+    readonly CHECKOUT_UPDATED: "checkout.updated";
+    readonly ORDER_COMPLETED: "order.completed";
+};
+declare const SHOPIFY_WEBHOOK_OUTBOX_DESTINATIONS: {
+    readonly CHECKOUT_EVENTS: "CHECKOUT_EVENTS";
+    readonly ORDER_EVENTS: "ORDER_EVENTS";
+};
 
 declare const MAX_URL_LENGTH = 2048;
 declare const MAX_LINE_ITEMS = 250;
@@ -87,7 +96,7 @@ type CheckoutObservedPayload = z.infer<typeof CheckoutObservedPayloadSchema>;
 
 declare const OrderCompletedPayloadSchema: z.ZodObject<{
     orderId: z.ZodString;
-    checkoutToken: z.ZodString;
+    checkoutToken: z.ZodNullable<z.ZodString>;
     shopifyCustomerId: z.ZodNullable<z.ZodString>;
     total: z.ZodNullable<z.ZodObject<{
         amount: z.ZodString;
@@ -162,7 +171,7 @@ declare const ShopifyOrderCompletedEventSchema: z.ZodObject<{
     eventType: z.ZodLiteral<"order.completed">;
     payload: z.ZodObject<{
         orderId: z.ZodString;
-        checkoutToken: z.ZodString;
+        checkoutToken: z.ZodNullable<z.ZodString>;
         shopifyCustomerId: z.ZodNullable<z.ZodString>;
         total: z.ZodNullable<z.ZodObject<{
             amount: z.ZodString;
@@ -235,7 +244,7 @@ declare const ShopifyCommerceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     eventType: z.ZodLiteral<"order.completed">;
     payload: z.ZodObject<{
         orderId: z.ZodString;
-        checkoutToken: z.ZodString;
+        checkoutToken: z.ZodNullable<z.ZodString>;
         shopifyCustomerId: z.ZodNullable<z.ZodString>;
         total: z.ZodNullable<z.ZodObject<{
             amount: z.ZodString;
@@ -310,7 +319,7 @@ declare function safeParseShopifyCommerceEvent(input: unknown): z.ZodSafeParseRe
     eventType: "order.completed";
     payload: {
         orderId: string;
-        checkoutToken: string;
+        checkoutToken: string | null;
         shopifyCustomerId: string | null;
         total: {
             amount: string;
@@ -322,10 +331,257 @@ declare function safeParseShopifyCommerceEvent(input: unknown): z.ZodSafeParseRe
 declare function isCheckoutObservedEvent(event: ShopifyCommerceEvent): event is ShopifyCheckoutObservedEvent;
 declare function isOrderCompletedEvent(event: ShopifyCommerceEvent): event is ShopifyOrderCompletedEvent;
 /**
- * Stable ordering key for a shop/checkout pair. Checkout and order events for the
- * same checkout must share this key, so deliveryId is intentionally excluded.
- * Values are length-prefixed to avoid ambiguous concatenation (e.g. "1" + "23" vs "12" + "3").
+ * Stable ordering key for a shop/checkout pair.
+ * Checkout and order events for the same checkout must share this key, so
+ * deliveryId is intentionally excluded.
  */
 declare function createShopifyCommerceOrderingKey(shopId: string, checkoutToken: string): string;
+declare function createShopifyOrderOrderingKey(shopId: string, orderId: string): string;
+
+declare const CheckoutCreatedPayloadV2Schema: z.ZodObject<{
+    checkoutToken: z.ZodString;
+    cartToken: z.ZodNullable<z.ZodString>;
+    abandonedCheckoutUrl: z.ZodNullable<z.ZodURL>;
+    checkoutCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+type CheckoutCreatedPayloadV2 = z.infer<typeof CheckoutCreatedPayloadV2Schema>;
+
+declare const CheckoutUpdatedPayloadV2Schema: z.ZodObject<{
+    checkoutToken: z.ZodString;
+}, z.core.$strict>;
+type CheckoutUpdatedPayloadV2 = z.infer<typeof CheckoutUpdatedPayloadV2Schema>;
+
+declare const OrderCompletedPayloadV2Schema: z.ZodObject<{
+    orderId: z.ZodString;
+    checkoutToken: z.ZodNullable<z.ZodString>;
+    cartToken: z.ZodNullable<z.ZodString>;
+    completedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+type OrderCompletedPayloadV2 = z.infer<typeof OrderCompletedPayloadV2Schema>;
+
+declare const ShopifyCheckoutCreatedEventV2Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    receiptId: z.ZodString;
+    deliveryId: z.ZodString;
+    eventId: z.ZodNullable<z.ZodString>;
+    source: z.ZodLiteral<"shopify">;
+    providerTopic: z.ZodString;
+    tenant: z.ZodObject<{
+        shopId: z.ZodString;
+        shopDomain: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodNullable<z.ZodISODateTime>;
+    receivedAt: z.ZodISODateTime;
+    traceId: z.ZodString;
+    orderingKey: z.ZodString;
+    eventType: z.ZodLiteral<"checkout.created">;
+    payload: z.ZodObject<{
+        checkoutToken: z.ZodString;
+        cartToken: z.ZodNullable<z.ZodString>;
+        abandonedCheckoutUrl: z.ZodNullable<z.ZodURL>;
+        checkoutCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type ShopifyCheckoutCreatedEventV2 = z.infer<typeof ShopifyCheckoutCreatedEventV2Schema>;
+declare const ShopifyCheckoutUpdatedEventV2Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    receiptId: z.ZodString;
+    deliveryId: z.ZodString;
+    eventId: z.ZodNullable<z.ZodString>;
+    source: z.ZodLiteral<"shopify">;
+    providerTopic: z.ZodString;
+    tenant: z.ZodObject<{
+        shopId: z.ZodString;
+        shopDomain: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodNullable<z.ZodISODateTime>;
+    receivedAt: z.ZodISODateTime;
+    traceId: z.ZodString;
+    orderingKey: z.ZodString;
+    eventType: z.ZodLiteral<"checkout.updated">;
+    payload: z.ZodObject<{
+        checkoutToken: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type ShopifyCheckoutUpdatedEventV2 = z.infer<typeof ShopifyCheckoutUpdatedEventV2Schema>;
+declare const ShopifyOrderCompletedEventV2Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    receiptId: z.ZodString;
+    deliveryId: z.ZodString;
+    eventId: z.ZodNullable<z.ZodString>;
+    source: z.ZodLiteral<"shopify">;
+    providerTopic: z.ZodString;
+    tenant: z.ZodObject<{
+        shopId: z.ZodString;
+        shopDomain: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodNullable<z.ZodISODateTime>;
+    receivedAt: z.ZodISODateTime;
+    traceId: z.ZodString;
+    orderingKey: z.ZodString;
+    eventType: z.ZodLiteral<"order.completed">;
+    payload: z.ZodObject<{
+        orderId: z.ZodString;
+        checkoutToken: z.ZodNullable<z.ZodString>;
+        cartToken: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type ShopifyOrderCompletedEventV2 = z.infer<typeof ShopifyOrderCompletedEventV2Schema>;
+declare const ShopifyRecoveryEventV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    receiptId: z.ZodString;
+    deliveryId: z.ZodString;
+    eventId: z.ZodNullable<z.ZodString>;
+    source: z.ZodLiteral<"shopify">;
+    providerTopic: z.ZodString;
+    tenant: z.ZodObject<{
+        shopId: z.ZodString;
+        shopDomain: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodNullable<z.ZodISODateTime>;
+    receivedAt: z.ZodISODateTime;
+    traceId: z.ZodString;
+    orderingKey: z.ZodString;
+    eventType: z.ZodLiteral<"checkout.created">;
+    payload: z.ZodObject<{
+        checkoutToken: z.ZodString;
+        cartToken: z.ZodNullable<z.ZodString>;
+        abandonedCheckoutUrl: z.ZodNullable<z.ZodURL>;
+        checkoutCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    receiptId: z.ZodString;
+    deliveryId: z.ZodString;
+    eventId: z.ZodNullable<z.ZodString>;
+    source: z.ZodLiteral<"shopify">;
+    providerTopic: z.ZodString;
+    tenant: z.ZodObject<{
+        shopId: z.ZodString;
+        shopDomain: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodNullable<z.ZodISODateTime>;
+    receivedAt: z.ZodISODateTime;
+    traceId: z.ZodString;
+    orderingKey: z.ZodString;
+    eventType: z.ZodLiteral<"checkout.updated">;
+    payload: z.ZodObject<{
+        checkoutToken: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    receiptId: z.ZodString;
+    deliveryId: z.ZodString;
+    eventId: z.ZodNullable<z.ZodString>;
+    source: z.ZodLiteral<"shopify">;
+    providerTopic: z.ZodString;
+    tenant: z.ZodObject<{
+        shopId: z.ZodString;
+        shopDomain: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodNullable<z.ZodISODateTime>;
+    receivedAt: z.ZodISODateTime;
+    traceId: z.ZodString;
+    orderingKey: z.ZodString;
+    eventType: z.ZodLiteral<"order.completed">;
+    payload: z.ZodObject<{
+        orderId: z.ZodString;
+        checkoutToken: z.ZodNullable<z.ZodString>;
+        cartToken: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>], "eventType">;
+type ShopifyRecoveryEventV2 = z.infer<typeof ShopifyRecoveryEventV2Schema>;
+type ShopifyRecoveryEventTypeV2 = ShopifyRecoveryEventV2["eventType"];
+declare function parseShopifyRecoveryEventV2(input: unknown): ShopifyRecoveryEventV2;
+declare function safeParseShopifyRecoveryEventV2(input: unknown): z.ZodSafeParseResult<{
+    schemaVersion: 2;
+    receiptId: string;
+    deliveryId: string;
+    eventId: string | null;
+    source: "shopify";
+    providerTopic: string;
+    tenant: {
+        shopId: string;
+        shopDomain: string;
+    };
+    occurredAt: string | null;
+    receivedAt: string;
+    traceId: string;
+    orderingKey: string;
+    eventType: "checkout.created";
+    payload: {
+        checkoutToken: string;
+        cartToken: string | null;
+        abandonedCheckoutUrl: string | null;
+        checkoutCreatedAt: string | null;
+    };
+} | {
+    schemaVersion: 2;
+    receiptId: string;
+    deliveryId: string;
+    eventId: string | null;
+    source: "shopify";
+    providerTopic: string;
+    tenant: {
+        shopId: string;
+        shopDomain: string;
+    };
+    occurredAt: string | null;
+    receivedAt: string;
+    traceId: string;
+    orderingKey: string;
+    eventType: "checkout.updated";
+    payload: {
+        checkoutToken: string;
+    };
+} | {
+    schemaVersion: 2;
+    receiptId: string;
+    deliveryId: string;
+    eventId: string | null;
+    source: "shopify";
+    providerTopic: string;
+    tenant: {
+        shopId: string;
+        shopDomain: string;
+    };
+    occurredAt: string | null;
+    receivedAt: string;
+    traceId: string;
+    orderingKey: string;
+    eventType: "order.completed";
+    payload: {
+        orderId: string;
+        checkoutToken: string | null;
+        cartToken: string | null;
+        completedAt: string;
+    };
+}>;
+declare function isCheckoutCreatedEventV2(event: ShopifyRecoveryEventV2): event is ShopifyCheckoutCreatedEventV2;
+declare function isCheckoutUpdatedEventV2(event: ShopifyRecoveryEventV2): event is ShopifyCheckoutUpdatedEventV2;
+declare function isOrderCompletedEventV2(event: ShopifyRecoveryEventV2): event is ShopifyOrderCompletedEventV2;
+declare function createShopifyPendingRecoveryOrderingKey(shopId: string, checkoutToken: string): string;
+declare function createShopifyOrderCorrelationOrderingKey(input: {
+    shopId: string;
+    orderId: string;
+    checkoutToken: string | null;
+}): string;
+
+declare const SHOPIFY_WEBHOOK_QUEUE_CONTRACTS: {
+    readonly CHECKOUT_EVENTS: {
+        readonly queueName: "checkout-events";
+        readonly jobName: "checkout-created";
+    };
+    readonly CHECKOUT_UPDATED_EVENTS: {
+        readonly queueName: "checkout-events";
+        readonly jobName: "checkout-updated";
+    };
+    readonly ORDER_EVENTS: {
+        readonly queueName: "order-events";
+        readonly jobName: "order-completed";
+    };
+};
 
-export { type CheckoutObservedPayload, CheckoutObservedPayloadSchema, MAX_LINE_ITEMS, MAX_URL_LENGTH, type OrderCompletedPayload, OrderCompletedPayloadSchema, SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION, SHOPIFY_COMMERCE_EVENT_TYPES, SHOPIFY_COMMERCE_JOB, SHOPIFY_COMMERCE_QUEUE, type ShopifyCheckoutLineItem, ShopifyCheckoutLineItemSchema, ShopifyCheckoutLineItemsSchema, type ShopifyCheckoutObservedEvent, ShopifyCheckoutObservedEventSchema, type ShopifyCommerceEvent, ShopifyCommerceEventSchema, type ShopifyCommerceEventType, type ShopifyCustomerReference, ShopifyCustomerReferenceSchema, type ShopifyMoney, ShopifyMoneySchema, type ShopifyOrderCompletedEvent, ShopifyOrderCompletedEventSchema, type ShopifyTenant, ShopifyTenantSchema, createShopifyCommerceOrderingKey, isCheckoutObservedEvent, isOrderCompletedEvent, parseShopifyCommerceEvent, safeParseShopifyCommerceEvent };
+export { type CheckoutCreatedPayloadV2, CheckoutCreatedPayloadV2Schema, type CheckoutObservedPayload, CheckoutObservedPayloadSchema, type CheckoutUpdatedPayloadV2, CheckoutUpdatedPayloadV2Schema, MAX_LINE_ITEMS, MAX_URL_LENGTH, type OrderCompletedPayload, OrderCompletedPayloadSchema, type 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, type ShopifyCheckoutCreatedEventV2, ShopifyCheckoutCreatedEventV2Schema, type ShopifyCheckoutLineItem, ShopifyCheckoutLineItemSchema, ShopifyCheckoutLineItemsSchema, type ShopifyCheckoutObservedEvent, ShopifyCheckoutObservedEventSchema, type ShopifyCheckoutUpdatedEventV2, ShopifyCheckoutUpdatedEventV2Schema, type ShopifyCommerceEvent, ShopifyCommerceEventSchema, type ShopifyCommerceEventType, type ShopifyCustomerReference, ShopifyCustomerReferenceSchema, type ShopifyMoney, ShopifyMoneySchema, type ShopifyOrderCompletedEvent, ShopifyOrderCompletedEventSchema, type ShopifyOrderCompletedEventV2, ShopifyOrderCompletedEventV2Schema, type ShopifyRecoveryEventTypeV2, type ShopifyRecoveryEventV2, ShopifyRecoveryEventV2Schema, type ShopifyTenant, ShopifyTenantSchema, createShopifyCommerceOrderingKey, createShopifyOrderCorrelationOrderingKey, createShopifyOrderOrderingKey, createShopifyPendingRecoveryOrderingKey, isCheckoutCreatedEventV2, isCheckoutObservedEvent, isCheckoutUpdatedEventV2, isOrderCompletedEvent, isOrderCompletedEventV2, parseShopifyCommerceEvent, parseShopifyRecoveryEventV2, safeParseShopifyCommerceEvent, safeParseShopifyRecoveryEventV2 };

package/dist/shopify/index.js

@@ -1,47 +1,83 @@
 import {
+  CheckoutCreatedPayloadV2Schema,
   CheckoutObservedPayloadSchema,
+  CheckoutUpdatedPayloadV2Schema,
   MAX_LINE_ITEMS,
   MAX_URL_LENGTH,
   OrderCompletedPayloadSchema,
+  OrderCompletedPayloadV2Schema,
   SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V1,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V2,
   SHOPIFY_COMMERCE_EVENT_TYPES,
-  SHOPIFY_COMMERCE_JOB,
-  SHOPIFY_COMMERCE_QUEUE,
+  SHOPIFY_RECOVERY_EVENT_TYPES_V2,
+  SHOPIFY_WEBHOOK_OUTBOX_DESTINATIONS,
+  SHOPIFY_WEBHOOK_QUEUE_CONTRACTS,
+  ShopifyCheckoutCreatedEventV2Schema,
   ShopifyCheckoutLineItemSchema,
   ShopifyCheckoutLineItemsSchema,
   ShopifyCheckoutObservedEventSchema,
+  ShopifyCheckoutUpdatedEventV2Schema,
   ShopifyCommerceEventSchema,
   ShopifyCustomerReferenceSchema,
   ShopifyMoneySchema,
   ShopifyOrderCompletedEventSchema,
+  ShopifyOrderCompletedEventV2Schema,
+  ShopifyRecoveryEventV2Schema,
   ShopifyTenantSchema,
   createShopifyCommerceOrderingKey,
+  createShopifyOrderCorrelationOrderingKey,
+  createShopifyOrderOrderingKey,
+  createShopifyPendingRecoveryOrderingKey,
+  isCheckoutCreatedEventV2,
   isCheckoutObservedEvent,
+  isCheckoutUpdatedEventV2,
   isOrderCompletedEvent,
+  isOrderCompletedEventV2,
   parseShopifyCommerceEvent,
-  safeParseShopifyCommerceEvent
-} from "../chunk-NE5RMNXU.js";
+  parseShopifyRecoveryEventV2,
+  safeParseShopifyCommerceEvent,
+  safeParseShopifyRecoveryEventV2
+} from "../chunk-T6DNWLWW.js";
 export {
+  CheckoutCreatedPayloadV2Schema,
   CheckoutObservedPayloadSchema,
+  CheckoutUpdatedPayloadV2Schema,
   MAX_LINE_ITEMS,
   MAX_URL_LENGTH,
   OrderCompletedPayloadSchema,
+  OrderCompletedPayloadV2Schema,
   SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V1,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION_V2,
   SHOPIFY_COMMERCE_EVENT_TYPES,
-  SHOPIFY_COMMERCE_JOB,
-  SHOPIFY_COMMERCE_QUEUE,
+  SHOPIFY_RECOVERY_EVENT_TYPES_V2,
+  SHOPIFY_WEBHOOK_OUTBOX_DESTINATIONS,
+  SHOPIFY_WEBHOOK_QUEUE_CONTRACTS,
+  ShopifyCheckoutCreatedEventV2Schema,
   ShopifyCheckoutLineItemSchema,
   ShopifyCheckoutLineItemsSchema,
   ShopifyCheckoutObservedEventSchema,
+  ShopifyCheckoutUpdatedEventV2Schema,
   ShopifyCommerceEventSchema,
   ShopifyCustomerReferenceSchema,
   ShopifyMoneySchema,
   ShopifyOrderCompletedEventSchema,
+  ShopifyOrderCompletedEventV2Schema,
+  ShopifyRecoveryEventV2Schema,
   ShopifyTenantSchema,
   createShopifyCommerceOrderingKey,
+  createShopifyOrderCorrelationOrderingKey,
+  createShopifyOrderOrderingKey,
+  createShopifyPendingRecoveryOrderingKey,
+  isCheckoutCreatedEventV2,
   isCheckoutObservedEvent,
+  isCheckoutUpdatedEventV2,
   isOrderCompletedEvent,
+  isOrderCompletedEventV2,
   parseShopifyCommerceEvent,
-  safeParseShopifyCommerceEvent
+  parseShopifyRecoveryEventV2,
+  safeParseShopifyCommerceEvent,
+  safeParseShopifyRecoveryEventV2
 };
 //# sourceMappingURL=index.js.map

package/dist/shopify/node.d.ts

@@ -1,7 +1,10 @@
 /**
- * Deterministic, BullMQ-safe job ID: "shopify-<sha256(appKey + ":" + deliveryId)>".
- * The hex digest contains no colons and no secret material, only a one-way hash.
+ * Legacy webhook delivery job id used by earlier receipt/outbox flows.
+ * Prefer the resource-scoped helpers below for current queue publication.
  */
 declare function createShopifyWebhookJobId(appKey: string, deliveryId: string): string;
+declare function createShopifyCheckoutJobId(shopId: string, checkoutToken: string): string;
+declare function createShopifyOrderJobId(shopId: string, orderGid: string): string;
+declare function createPendingRecoveryCandidateJobId(shopId: string, checkoutToken: string): string;
 
-export { createShopifyWebhookJobId };
+export { createPendingRecoveryCandidateJobId, createShopifyCheckoutJobId, createShopifyOrderJobId, createShopifyWebhookJobId };

package/dist/shopify/node.js

@@ -1,16 +1,31 @@
 // src/shopify/node.ts
 import { createHash } from "crypto";
-function createShopifyWebhookJobId(appKey, deliveryId) {
-  if (typeof appKey !== "string" || appKey.length === 0) {
-    throw new Error("createShopifyWebhookJobId: appKey must be a non-empty string");
+function createShopifyWebhookJobDigest(prefix, first, second) {
+  if (typeof first !== "string" || first.length === 0) {
+    throw new Error(`${prefix}: first input must be a non-empty string`);
   }
-  if (typeof deliveryId !== "string" || deliveryId.length === 0) {
-    throw new Error("createShopifyWebhookJobId: deliveryId must be a non-empty string");
+  if (typeof second !== "string" || second.length === 0) {
+    throw new Error(`${prefix}: second input must be a non-empty string`);
   }
-  const digest = createHash("sha256").update(`${appKey}:${deliveryId}`).digest("hex");
-  return `shopify-${digest}`;
+  const digest = createHash("sha256").update(`${first}:${second}`).digest("hex");
+  return `${prefix}-${digest}`;
+}
+function createShopifyWebhookJobId(appKey, deliveryId) {
+  return createShopifyWebhookJobDigest("shopify", appKey, deliveryId);
+}
+function createShopifyCheckoutJobId(shopId, checkoutToken) {
+  return createShopifyWebhookJobDigest("checkout", shopId, checkoutToken);
+}
+function createShopifyOrderJobId(shopId, orderGid) {
+  return createShopifyWebhookJobDigest("order-created", shopId, orderGid);
+}
+function createPendingRecoveryCandidateJobId(shopId, checkoutToken) {
+  return createShopifyWebhookJobDigest("pending-recovery", shopId, checkoutToken);
 }
 export {
+  createPendingRecoveryCandidateJobId,
+  createShopifyCheckoutJobId,
+  createShopifyOrderJobId,
   createShopifyWebhookJobId
 };
 //# sourceMappingURL=node.js.map

package/dist/shopify/node.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shopify/node.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\n/**\n * Deterministic, BullMQ-safe job ID: \"shopify-<sha256(appKey + \":\" + deliveryId)>\".\n * The hex digest contains no colons and no secret material, only a one-way hash.\n */\nexport function createShopifyWebhookJobId(appKey: string, deliveryId: string): string {\n  if (typeof appKey !== \"string\" || appKey.length === 0) {\n    throw new Error(\"createShopifyWebhookJobId: appKey must be a non-empty string\");\n  }\n  if (typeof deliveryId !== \"string\" || deliveryId.length === 0) {\n    throw new Error(\"createShopifyWebhookJobId: deliveryId must be a non-empty string\");\n  }\n\n  const digest = createHash(\"sha256\").update(`${appKey}:${deliveryId}`).digest(\"hex\");\n  return `shopify-${digest}`;\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAMpB,SAAS,0BAA0B,QAAgB,YAA4B;AACpF,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,GAAG;AACrD,UAAM,IAAI,MAAM,8DAA8D;AAAA,EAChF;AACA,MAAI,OAAO,eAAe,YAAY,WAAW,WAAW,GAAG;AAC7D,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AAEA,QAAM,SAAS,WAAW,QAAQ,EAAE,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,EAAE,OAAO,KAAK;AAClF,SAAO,WAAW,MAAM;AAC1B;","names":[]}
+{"version":3,"sources":["../../src/shopify/node.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nfunction createShopifyWebhookJobDigest(prefix: string, first: string, second: string): string {\n  if (typeof first !== \"string\" || first.length === 0) {\n    throw new Error(`${prefix}: first input must be a non-empty string`);\n  }\n\n  if (typeof second !== \"string\" || second.length === 0) {\n    throw new Error(`${prefix}: second input must be a non-empty string`);\n  }\n\n  const digest = createHash(\"sha256\").update(`${first}:${second}`).digest(\"hex\");\n  return `${prefix}-${digest}`;\n}\n\n/**\n * Legacy webhook delivery job id used by earlier receipt/outbox flows.\n * Prefer the resource-scoped helpers below for current queue publication.\n */\nexport function createShopifyWebhookJobId(appKey: string, deliveryId: string): string {\n  return createShopifyWebhookJobDigest(\"shopify\", appKey, deliveryId);\n}\n\nexport function createShopifyCheckoutJobId(shopId: string, checkoutToken: string): string {\n  return createShopifyWebhookJobDigest(\"checkout\", shopId, checkoutToken);\n}\n\nexport function createShopifyOrderJobId(shopId: string, orderGid: string): string {\n  return createShopifyWebhookJobDigest(\"order-created\", shopId, orderGid);\n}\n\nexport function createPendingRecoveryCandidateJobId(\n  shopId: string,\n  checkoutToken: string,\n): string {\n  return createShopifyWebhookJobDigest(\"pending-recovery\", shopId, checkoutToken);\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAE3B,SAAS,8BAA8B,QAAgB,OAAe,QAAwB;AAC5F,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG;AACnD,UAAM,IAAI,MAAM,GAAG,MAAM,0CAA0C;AAAA,EACrE;AAEA,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,GAAG;AACrD,UAAM,IAAI,MAAM,GAAG,MAAM,2CAA2C;AAAA,EACtE;AAEA,QAAM,SAAS,WAAW,QAAQ,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,EAAE,OAAO,KAAK;AAC7E,SAAO,GAAG,MAAM,IAAI,MAAM;AAC5B;AAMO,SAAS,0BAA0B,QAAgB,YAA4B;AACpF,SAAO,8BAA8B,WAAW,QAAQ,UAAU;AACpE;AAEO,SAAS,2BAA2B,QAAgB,eAA+B;AACxF,SAAO,8BAA8B,YAAY,QAAQ,aAAa;AACxE;AAEO,SAAS,wBAAwB,QAAgB,UAA0B;AAChF,SAAO,8BAA8B,iBAAiB,QAAQ,QAAQ;AACxE;AAEO,SAAS,oCACd,QACA,eACQ;AACR,SAAO,8BAA8B,oBAAoB,QAAQ,aAAa;AAChF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modainteract/moda-interact-shared",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -19,6 +19,14 @@
     "./shopify/node": {
       "types": "./dist/shopify/node.d.ts",
       "import": "./dist/shopify/node.js"
+    },
+    "./logging": {
+      "types": "./dist/logging/index.d.ts",
+      "import": "./dist/logging/index.js"
+    },
+    "./logging/node": {
+      "types": "./dist/logging/node.d.ts",
+      "import": "./dist/logging/node.js"
     }
   },
   "files": [
@@ -27,10 +35,17 @@
   "scripts": {
     "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "test": "tsx --test src/**/*.test.ts",
+    "test": "tsx --test \"src/**/*.test.ts\"",
     "prepack": "npm run build"
   },
   "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api-logs": "0.221.0",
+    "@opentelemetry/exporter-logs-otlp-http": "0.221.0",
+    "@opentelemetry/resources": "^2.10.0",
+    "@opentelemetry/sdk-logs": "0.221.0",
+    "winston": "3.19.0",
+    "winston-loki": "6.1.7",
     "zod": "^4.0.0"
   },
   "devDependencies": {

package/dist/chunk-NE5RMNXU.js

@@ -1,142 +0,0 @@
-// src/shopify/constants.ts
-var SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION = 1;
-var SHOPIFY_COMMERCE_QUEUE = "commerce-events";
-var SHOPIFY_COMMERCE_JOB = "shopify-commerce-event";
-var SHOPIFY_COMMERCE_EVENT_TYPES = {
-  CHECKOUT_OBSERVED: "checkout.observed",
-  ORDER_COMPLETED: "order.completed"
-};
-
-// src/shopify/common.schema.ts
-import { z } from "zod";
-var MAX_ID_LENGTH = 100;
-var MAX_SHORT_TEXT_LENGTH = 320;
-var MAX_TITLE_LENGTH = 500;
-var MAX_URL_LENGTH = 2048;
-var MAX_LINE_ITEMS = 250;
-var decimalStringPattern = /^-?\d+(\.\d+)?$/;
-var DecimalStringSchema = z.string().min(1).max(32).regex(decimalStringPattern, 'must be a decimal string, e.g. "12.34"');
-var ShopifyTenantSchema = z.object({
-  shopId: z.string().min(1).max(MAX_ID_LENGTH),
-  shopDomain: z.string().min(1).max(MAX_SHORT_TEXT_LENGTH).toLowerCase().trim()
-}).strict();
-var ShopifyCustomerReferenceSchema = z.object({
-  shopifyCustomerId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),
-  email: z.string().email().max(MAX_SHORT_TEXT_LENGTH).nullable(),
-  phone: z.string().min(1).max(64).nullable(),
-  firstName: z.string().min(1).max(MAX_TITLE_LENGTH).nullable(),
-  lastName: z.string().min(1).max(MAX_TITLE_LENGTH).nullable()
-}).strict();
-var ShopifyMoneySchema = z.object({
-  amount: DecimalStringSchema,
-  currencyCode: z.string().regex(/^[A-Z]{3}$/, "must be an uppercase three-letter currency code")
-}).strict();
-var ShopifyCheckoutLineItemSchema = z.object({
-  lineItemId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),
-  variantId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),
-  productId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),
-  title: z.string().min(1).max(MAX_TITLE_LENGTH),
-  variantTitle: z.string().min(1).max(MAX_TITLE_LENGTH).nullable(),
-  quantity: z.number().int().positive(),
-  unitPrice: DecimalStringSchema.nullable(),
-  sku: z.string().min(1).max(MAX_ID_LENGTH).nullable()
-}).strict();
-var ShopifyCheckoutLineItemsSchema = z.array(ShopifyCheckoutLineItemSchema).max(MAX_LINE_ITEMS);
-
-// src/shopify/checkout-observed.schema.ts
-import { z as z2 } from "zod";
-var CheckoutObservedPayloadSchema = z2.object({
-  checkoutToken: z2.string().min(1),
-  cartToken: z2.string().min(1).nullable(),
-  checkoutUrl: z2.url().max(MAX_URL_LENGTH).nullable(),
-  customer: ShopifyCustomerReferenceSchema.nullable(),
-  total: ShopifyMoneySchema.nullable(),
-  lineItems: ShopifyCheckoutLineItemsSchema,
-  checkoutCreatedAt: z2.iso.datetime().nullable(),
-  checkoutUpdatedAt: z2.iso.datetime().nullable(),
-  completedAt: z2.iso.datetime().nullable()
-}).strict();
-
-// src/shopify/order-completed.schema.ts
-import { z as z3 } from "zod";
-var OrderCompletedPayloadSchema = z3.object({
-  orderId: z3.string().min(1),
-  checkoutToken: z3.string().min(1),
-  shopifyCustomerId: z3.string().min(1).nullable(),
-  total: ShopifyMoneySchema.nullable(),
-  completedAt: z3.iso.datetime()
-}).strict();
-
-// src/shopify/commerce-event.schema.ts
-import { z as z4 } from "zod";
-var ShopifyCommerceEventBaseSchema = z4.object({
-  schemaVersion: z4.literal(SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION),
-  receiptId: z4.string().min(1),
-  deliveryId: z4.string().min(1),
-  eventId: z4.string().min(1).nullable(),
-  source: z4.literal("shopify"),
-  providerTopic: z4.string().min(1),
-  tenant: ShopifyTenantSchema,
-  occurredAt: z4.iso.datetime().nullable(),
-  receivedAt: z4.iso.datetime(),
-  traceId: z4.string().min(1),
-  orderingKey: z4.string().min(1)
-});
-var ShopifyCheckoutObservedEventSchema = ShopifyCommerceEventBaseSchema.extend({
-  eventType: z4.literal(SHOPIFY_COMMERCE_EVENT_TYPES.CHECKOUT_OBSERVED),
-  payload: CheckoutObservedPayloadSchema
-}).strict();
-var ShopifyOrderCompletedEventSchema = ShopifyCommerceEventBaseSchema.extend({
-  eventType: z4.literal(SHOPIFY_COMMERCE_EVENT_TYPES.ORDER_COMPLETED),
-  payload: OrderCompletedPayloadSchema
-}).strict();
-var ShopifyCommerceEventSchema = z4.discriminatedUnion("eventType", [
-  ShopifyCheckoutObservedEventSchema,
-  ShopifyOrderCompletedEventSchema
-]);
-function parseShopifyCommerceEvent(input) {
-  return ShopifyCommerceEventSchema.parse(input);
-}
-function safeParseShopifyCommerceEvent(input) {
-  return ShopifyCommerceEventSchema.safeParse(input);
-}
-function isCheckoutObservedEvent(event) {
-  return event.eventType === SHOPIFY_COMMERCE_EVENT_TYPES.CHECKOUT_OBSERVED;
-}
-function isOrderCompletedEvent(event) {
-  return event.eventType === SHOPIFY_COMMERCE_EVENT_TYPES.ORDER_COMPLETED;
-}
-function createShopifyCommerceOrderingKey(shopId, checkoutToken) {
-  if (typeof shopId !== "string" || shopId.length === 0) {
-    throw new Error("createShopifyCommerceOrderingKey: shopId must be a non-empty string");
-  }
-  if (typeof checkoutToken !== "string" || checkoutToken.length === 0) {
-    throw new Error("createShopifyCommerceOrderingKey: checkoutToken must be a non-empty string");
-  }
-  return `shopify:${shopId.length}:${shopId}:${checkoutToken.length}:${checkoutToken}`;
-}
-
-export {
-  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION,
-  SHOPIFY_COMMERCE_QUEUE,
-  SHOPIFY_COMMERCE_JOB,
-  SHOPIFY_COMMERCE_EVENT_TYPES,
-  MAX_URL_LENGTH,
-  MAX_LINE_ITEMS,
-  ShopifyTenantSchema,
-  ShopifyCustomerReferenceSchema,
-  ShopifyMoneySchema,
-  ShopifyCheckoutLineItemSchema,
-  ShopifyCheckoutLineItemsSchema,
-  CheckoutObservedPayloadSchema,
-  OrderCompletedPayloadSchema,
-  ShopifyCheckoutObservedEventSchema,
-  ShopifyOrderCompletedEventSchema,
-  ShopifyCommerceEventSchema,
-  parseShopifyCommerceEvent,
-  safeParseShopifyCommerceEvent,
-  isCheckoutObservedEvent,
-  isOrderCompletedEvent,
-  createShopifyCommerceOrderingKey
-};
-//# sourceMappingURL=chunk-NE5RMNXU.js.map