@modainteract/moda-interact-shared 0.1.0

package/README.md

@@ -0,0 +1,67 @@
+# @modainteract/moda-interact-shared
+
+Shared, runtime-validated TypeScript contracts used by more than one Moda
+Interact service. This package is a library, not a service: it has no
+transport, persistence, or framework code of its own.
+
+## What this package owns
+
+- Zod schemas for cross-service event contracts (currently: Shopify commerce
+  events).
+- TypeScript types inferred from those schemas (`z.infer`), so producers and
+  consumers share one source of truth.
+- Constants (queue/job names, schema version, event type strings).
+- Parsing helpers and small pure utilities (ordering-key and job-id
+  derivation) needed to construct or validate those contracts.
+
+This package does **not** define Prisma models, own migrations, or implement
+any queue/transport client. PostgreSQL and Redis store the *serialized*
+event envelope as JSON; the database layer does not enforce or duplicate its
+shape. Producers must construct and validate an event with the schemas in
+this package before persisting it. Consumers must parse the JSON read back
+from PostgreSQL/Redis with the same schemas before acting on it — never trust
+it as pre-validated.
+
+## Ownership boundary
+
+- **moda-interact** — authenticates Shopify webhooks, normalizes payloads,
+  constructs and validates a `ShopifyCommerceEvent`, and writes it to the
+  transactional outbox.
+- **moda-interact-background** — parses `ShopifyCommerceEvent` (via
+  `parseShopifyCommerceEvent` / `safeParseShopifyCommerceEvent`) before
+  processing, dispatches by `eventType`, and applies tenant-safe, idempotent
+  domain transitions.
+- **moda-interact-database** — stores receipt metadata and outbox JSON. It
+  does not own or duplicate the TypeScript event types defined here.
+
+## Schema versioning
+
+`schemaVersion` is embedded in every serialized event and is currently `1`.
+
+- Any breaking change to the serialized shape (removing/renaming a field,
+  changing a type, tightening validation in a way that rejects previously
+  valid data) requires bumping `SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION` and
+  updating the schema to branch on it.
+- Additive, optional-field changes do not require a version bump, but must
+  still be reviewed for old-consumer safety (an older consumer parsing a
+  newer envelope must not fail just because of a new optional field).
+
+## Exports
+
+- `@modainteract/moda-interact-shared` — re-exports everything from
+  `./shopify`.
+- `@modainteract/moda-interact-shared/shopify` — schemas, types, constants,
+  and the pure `createShopifyCommerceOrderingKey` helper. Safe for browser
+  bundles (no Node built-ins).
+- `@modainteract/moda-interact-shared/shopify/node` — `createShopifyWebhookJobId`,
+  which uses `node:crypto` and is therefore isolated in a Node-only subpath so
+  it isn't accidentally pulled into browser bundles that import the root or
+  `./shopify` entry points.
+
+## Building and testing
+
+```sh
+npm run typecheck
+npm run build
+npm test
+```

package/dist/chunk-NE5RMNXU.js

@@ -0,0 +1,142 @@
+// 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

package/dist/chunk-NE5RMNXU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shopify/constants.ts","../src/shopify/common.schema.ts","../src/shopify/checkout-observed.schema.ts","../src/shopify/order-completed.schema.ts","../src/shopify/commerce-event.schema.ts"],"sourcesContent":["export const SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION = 1 as const;\n\nexport const SHOPIFY_COMMERCE_QUEUE = \"commerce-events\" as const;\nexport const SHOPIFY_COMMERCE_JOB = \"shopify-commerce-event\" as const;\n\nexport const SHOPIFY_COMMERCE_EVENT_TYPES = {\n  CHECKOUT_OBSERVED: \"checkout.observed\",\n  ORDER_COMPLETED: \"order.completed\",\n} as const;\n","import { z } from \"zod\";\n\n/**\n * Reasonable upper bounds for externally controlled (Shopify-originated) strings.\n * These exist to keep queue messages small and predictable, not to validate business rules.\n */\nconst MAX_ID_LENGTH = 100;\nconst MAX_SHORT_TEXT_LENGTH = 320;\nconst MAX_TITLE_LENGTH = 500;\nconst MAX_URL_LENGTH = 2048;\nconst MAX_LINE_ITEMS = 250;\n\nconst decimalStringPattern = /^-?\\d+(\\.\\d+)?$/;\n\n/** Decimal amount encoded as a string; never a JS number to avoid float precision loss. */\nconst DecimalStringSchema = z\n  .string()\n  .min(1)\n  .max(32)\n  .regex(decimalStringPattern, \"must be a decimal string, e.g. \\\"12.34\\\"\");\n\nexport const ShopifyTenantSchema = z\n  .object({\n    shopId: z.string().min(1).max(MAX_ID_LENGTH),\n    shopDomain: z\n      .string()\n      .min(1)\n      .max(MAX_SHORT_TEXT_LENGTH)\n      .toLowerCase()\n      .trim(),\n  })\n  .strict();\n\nexport type ShopifyTenant = z.infer<typeof ShopifyTenantSchema>;\n\nexport const ShopifyCustomerReferenceSchema = z\n  .object({\n    shopifyCustomerId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),\n    email: z.string().email().max(MAX_SHORT_TEXT_LENGTH).nullable(),\n    phone: z.string().min(1).max(64).nullable(),\n    firstName: z.string().min(1).max(MAX_TITLE_LENGTH).nullable(),\n    lastName: z.string().min(1).max(MAX_TITLE_LENGTH).nullable(),\n  })\n  .strict();\n\nexport type ShopifyCustomerReference = z.infer<typeof ShopifyCustomerReferenceSchema>;\n\nexport const ShopifyMoneySchema = z\n  .object({\n    amount: DecimalStringSchema,\n    currencyCode: z\n      .string()\n      .regex(/^[A-Z]{3}$/, \"must be an uppercase three-letter currency code\"),\n  })\n  .strict();\n\nexport type ShopifyMoney = z.infer<typeof ShopifyMoneySchema>;\n\n/**\n * Fields limited to what checkout recovery and customer-facing basket context require.\n * Line-item arrays are bounded (see MAX_LINE_ITEMS) to prevent unexpectedly large queue messages.\n */\nexport const ShopifyCheckoutLineItemSchema = z\n  .object({\n    lineItemId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),\n    variantId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),\n    productId: z.string().min(1).max(MAX_ID_LENGTH).nullable(),\n    title: z.string().min(1).max(MAX_TITLE_LENGTH),\n    variantTitle: z.string().min(1).max(MAX_TITLE_LENGTH).nullable(),\n    quantity: z.number().int().positive(),\n    unitPrice: DecimalStringSchema.nullable(),\n    sku: z.string().min(1).max(MAX_ID_LENGTH).nullable(),\n  })\n  .strict();\n\nexport type ShopifyCheckoutLineItem = z.infer<typeof ShopifyCheckoutLineItemSchema>;\n\nexport const ShopifyCheckoutLineItemsSchema = z\n  .array(ShopifyCheckoutLineItemSchema)\n  .max(MAX_LINE_ITEMS);\n\nexport { MAX_URL_LENGTH, MAX_LINE_ITEMS };\n","import { z } from \"zod\";\nimport {\n  MAX_URL_LENGTH,\n  ShopifyCheckoutLineItemsSchema,\n  ShopifyCustomerReferenceSchema,\n  ShopifyMoneySchema,\n} from \"./common.schema.js\";\n\nexport const CheckoutObservedPayloadSchema = z\n  .object({\n    checkoutToken: z.string().min(1),\n    cartToken: z.string().min(1).nullable(),\n    checkoutUrl: z.url().max(MAX_URL_LENGTH).nullable(),\n    customer: ShopifyCustomerReferenceSchema.nullable(),\n    total: ShopifyMoneySchema.nullable(),\n    lineItems: ShopifyCheckoutLineItemsSchema,\n    checkoutCreatedAt: z.iso.datetime().nullable(),\n    checkoutUpdatedAt: z.iso.datetime().nullable(),\n    completedAt: z.iso.datetime().nullable(),\n  })\n  .strict();\n\nexport type CheckoutObservedPayload = z.infer<typeof CheckoutObservedPayloadSchema>;\n","import { z } from \"zod\";\nimport { ShopifyMoneySchema } from \"./common.schema.js\";\n\nexport const OrderCompletedPayloadSchema = z\n  .object({\n    orderId: z.string().min(1),\n    checkoutToken: z.string().min(1),\n    shopifyCustomerId: z.string().min(1).nullable(),\n    total: ShopifyMoneySchema.nullable(),\n    completedAt: z.iso.datetime(),\n  })\n  .strict();\n\nexport type OrderCompletedPayload = z.infer<typeof OrderCompletedPayloadSchema>;\n","import { z } from \"zod\";\nimport { SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION, SHOPIFY_COMMERCE_EVENT_TYPES } from \"./constants.js\";\nimport { ShopifyTenantSchema } from \"./common.schema.js\";\nimport { CheckoutObservedPayloadSchema } from \"./checkout-observed.schema.js\";\nimport { OrderCompletedPayloadSchema } from \"./order-completed.schema.js\";\n\nconst ShopifyCommerceEventBaseSchema = z.object({\n  schemaVersion: z.literal(SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION),\n  receiptId: z.string().min(1),\n  deliveryId: z.string().min(1),\n  eventId: z.string().min(1).nullable(),\n  source: z.literal(\"shopify\"),\n  providerTopic: z.string().min(1),\n  tenant: ShopifyTenantSchema,\n  occurredAt: z.iso.datetime().nullable(),\n  receivedAt: z.iso.datetime(),\n  traceId: z.string().min(1),\n  orderingKey: z.string().min(1),\n});\n\nexport const ShopifyCheckoutObservedEventSchema = ShopifyCommerceEventBaseSchema.extend({\n  eventType: z.literal(SHOPIFY_COMMERCE_EVENT_TYPES.CHECKOUT_OBSERVED),\n  payload: CheckoutObservedPayloadSchema,\n}).strict();\n\nexport type ShopifyCheckoutObservedEvent = z.infer<typeof ShopifyCheckoutObservedEventSchema>;\n\nexport const ShopifyOrderCompletedEventSchema = ShopifyCommerceEventBaseSchema.extend({\n  eventType: z.literal(SHOPIFY_COMMERCE_EVENT_TYPES.ORDER_COMPLETED),\n  payload: OrderCompletedPayloadSchema,\n}).strict();\n\nexport type ShopifyOrderCompletedEvent = z.infer<typeof ShopifyOrderCompletedEventSchema>;\n\nexport const ShopifyCommerceEventSchema = z.discriminatedUnion(\"eventType\", [\n  ShopifyCheckoutObservedEventSchema,\n  ShopifyOrderCompletedEventSchema,\n]);\n\nexport type ShopifyCommerceEvent = z.infer<typeof ShopifyCommerceEventSchema>;\nexport type ShopifyCommerceEventType = ShopifyCommerceEvent[\"eventType\"];\n\nexport function parseShopifyCommerceEvent(input: unknown): ShopifyCommerceEvent {\n  return ShopifyCommerceEventSchema.parse(input);\n}\n\nexport function safeParseShopifyCommerceEvent(input: unknown) {\n  return ShopifyCommerceEventSchema.safeParse(input);\n}\n\nexport function isCheckoutObservedEvent(\n  event: ShopifyCommerceEvent,\n): event is ShopifyCheckoutObservedEvent {\n  return event.eventType === SHOPIFY_COMMERCE_EVENT_TYPES.CHECKOUT_OBSERVED;\n}\n\nexport function isOrderCompletedEvent(\n  event: ShopifyCommerceEvent,\n): event is ShopifyOrderCompletedEvent {\n  return event.eventType === SHOPIFY_COMMERCE_EVENT_TYPES.ORDER_COMPLETED;\n}\n\n/**\n * Stable ordering key for a shop/checkout pair. Checkout and order events for the\n * same checkout must share this key, so deliveryId is intentionally excluded.\n * Values are length-prefixed to avoid ambiguous concatenation (e.g. \"1\" + \"23\" vs \"12\" + \"3\").\n */\nexport function createShopifyCommerceOrderingKey(shopId: string, checkoutToken: string): string {\n  if (typeof shopId !== \"string\" || shopId.length === 0) {\n    throw new Error(\"createShopifyCommerceOrderingKey: shopId must be a non-empty string\");\n  }\n  if (typeof checkoutToken !== \"string\" || checkoutToken.length === 0) {\n    throw new Error(\"createShopifyCommerceOrderingKey: checkoutToken must be a non-empty string\");\n  }\n\n  return `shopify:${shopId.length}:${shopId}:${checkoutToken.length}:${checkoutToken}`;\n}\n"],"mappings":"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","names":["z","z","z","z","z","z"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { CheckoutObservedPayload, CheckoutObservedPayloadSchema, MAX_LINE_ITEMS, MAX_URL_LENGTH, OrderCompletedPayload, OrderCompletedPayloadSchema, SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION, SHOPIFY_COMMERCE_EVENT_TYPES, SHOPIFY_COMMERCE_JOB, SHOPIFY_COMMERCE_QUEUE, ShopifyCheckoutLineItem, ShopifyCheckoutLineItemSchema, ShopifyCheckoutLineItemsSchema, ShopifyCheckoutObservedEvent, ShopifyCheckoutObservedEventSchema, ShopifyCommerceEvent, ShopifyCommerceEventSchema, ShopifyCommerceEventType, ShopifyCustomerReference, ShopifyCustomerReferenceSchema, ShopifyMoney, ShopifyMoneySchema, ShopifyOrderCompletedEvent, ShopifyOrderCompletedEventSchema, ShopifyTenant, ShopifyTenantSchema, createShopifyCommerceOrderingKey, isCheckoutObservedEvent, isOrderCompletedEvent, parseShopifyCommerceEvent, safeParseShopifyCommerceEvent } from './shopify/index.js';
+import 'zod';

package/dist/index.js

@@ -0,0 +1,47 @@
+import {
+  CheckoutObservedPayloadSchema,
+  MAX_LINE_ITEMS,
+  MAX_URL_LENGTH,
+  OrderCompletedPayloadSchema,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION,
+  SHOPIFY_COMMERCE_EVENT_TYPES,
+  SHOPIFY_COMMERCE_JOB,
+  SHOPIFY_COMMERCE_QUEUE,
+  ShopifyCheckoutLineItemSchema,
+  ShopifyCheckoutLineItemsSchema,
+  ShopifyCheckoutObservedEventSchema,
+  ShopifyCommerceEventSchema,
+  ShopifyCustomerReferenceSchema,
+  ShopifyMoneySchema,
+  ShopifyOrderCompletedEventSchema,
+  ShopifyTenantSchema,
+  createShopifyCommerceOrderingKey,
+  isCheckoutObservedEvent,
+  isOrderCompletedEvent,
+  parseShopifyCommerceEvent,
+  safeParseShopifyCommerceEvent
+} from "./chunk-NE5RMNXU.js";
+export {
+  CheckoutObservedPayloadSchema,
+  MAX_LINE_ITEMS,
+  MAX_URL_LENGTH,
+  OrderCompletedPayloadSchema,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION,
+  SHOPIFY_COMMERCE_EVENT_TYPES,
+  SHOPIFY_COMMERCE_JOB,
+  SHOPIFY_COMMERCE_QUEUE,
+  ShopifyCheckoutLineItemSchema,
+  ShopifyCheckoutLineItemsSchema,
+  ShopifyCheckoutObservedEventSchema,
+  ShopifyCommerceEventSchema,
+  ShopifyCustomerReferenceSchema,
+  ShopifyMoneySchema,
+  ShopifyOrderCompletedEventSchema,
+  ShopifyTenantSchema,
+  createShopifyCommerceOrderingKey,
+  isCheckoutObservedEvent,
+  isOrderCompletedEvent,
+  parseShopifyCommerceEvent,
+  safeParseShopifyCommerceEvent
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/shopify/index.d.ts

@@ -0,0 +1,331 @@
+import { z } from 'zod';
+
+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 MAX_URL_LENGTH = 2048;
+declare const MAX_LINE_ITEMS = 250;
+declare const ShopifyTenantSchema: z.ZodObject<{
+    shopId: z.ZodString;
+    shopDomain: z.ZodString;
+}, z.core.$strict>;
+type ShopifyTenant = z.infer<typeof ShopifyTenantSchema>;
+declare const ShopifyCustomerReferenceSchema: z.ZodObject<{
+    shopifyCustomerId: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+    phone: z.ZodNullable<z.ZodString>;
+    firstName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ShopifyCustomerReference = z.infer<typeof ShopifyCustomerReferenceSchema>;
+declare const ShopifyMoneySchema: z.ZodObject<{
+    amount: z.ZodString;
+    currencyCode: z.ZodString;
+}, z.core.$strict>;
+type ShopifyMoney = z.infer<typeof ShopifyMoneySchema>;
+/**
+ * Fields limited to what checkout recovery and customer-facing basket context require.
+ * Line-item arrays are bounded (see MAX_LINE_ITEMS) to prevent unexpectedly large queue messages.
+ */
+declare const ShopifyCheckoutLineItemSchema: z.ZodObject<{
+    lineItemId: z.ZodNullable<z.ZodString>;
+    variantId: z.ZodNullable<z.ZodString>;
+    productId: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    variantTitle: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNullable<z.ZodString>;
+    sku: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type ShopifyCheckoutLineItem = z.infer<typeof ShopifyCheckoutLineItemSchema>;
+declare const ShopifyCheckoutLineItemsSchema: z.ZodArray<z.ZodObject<{
+    lineItemId: z.ZodNullable<z.ZodString>;
+    variantId: z.ZodNullable<z.ZodString>;
+    productId: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    variantTitle: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNullable<z.ZodString>;
+    sku: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>>;
+
+declare const CheckoutObservedPayloadSchema: z.ZodObject<{
+    checkoutToken: z.ZodString;
+    cartToken: z.ZodNullable<z.ZodString>;
+    checkoutUrl: z.ZodNullable<z.ZodURL>;
+    customer: z.ZodNullable<z.ZodObject<{
+        shopifyCustomerId: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+        phone: z.ZodNullable<z.ZodString>;
+        firstName: z.ZodNullable<z.ZodString>;
+        lastName: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    total: z.ZodNullable<z.ZodObject<{
+        amount: z.ZodString;
+        currencyCode: z.ZodString;
+    }, z.core.$strict>>;
+    lineItems: z.ZodArray<z.ZodObject<{
+        lineItemId: z.ZodNullable<z.ZodString>;
+        variantId: z.ZodNullable<z.ZodString>;
+        productId: z.ZodNullable<z.ZodString>;
+        title: z.ZodString;
+        variantTitle: z.ZodNullable<z.ZodString>;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNullable<z.ZodString>;
+        sku: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    checkoutCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+    checkoutUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+    completedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+type CheckoutObservedPayload = z.infer<typeof CheckoutObservedPayloadSchema>;
+
+declare const OrderCompletedPayloadSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    checkoutToken: z.ZodString;
+    shopifyCustomerId: z.ZodNullable<z.ZodString>;
+    total: z.ZodNullable<z.ZodObject<{
+        amount: z.ZodString;
+        currencyCode: z.ZodString;
+    }, z.core.$strict>>;
+    completedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+type OrderCompletedPayload = z.infer<typeof OrderCompletedPayloadSchema>;
+
+declare const ShopifyCheckoutObservedEventSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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.observed">;
+    payload: z.ZodObject<{
+        checkoutToken: z.ZodString;
+        cartToken: z.ZodNullable<z.ZodString>;
+        checkoutUrl: z.ZodNullable<z.ZodURL>;
+        customer: z.ZodNullable<z.ZodObject<{
+            shopifyCustomerId: z.ZodNullable<z.ZodString>;
+            email: z.ZodNullable<z.ZodString>;
+            phone: z.ZodNullable<z.ZodString>;
+            firstName: z.ZodNullable<z.ZodString>;
+            lastName: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        total: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            currencyCode: z.ZodString;
+        }, z.core.$strict>>;
+        lineItems: z.ZodArray<z.ZodObject<{
+            lineItemId: z.ZodNullable<z.ZodString>;
+            variantId: z.ZodNullable<z.ZodString>;
+            productId: z.ZodNullable<z.ZodString>;
+            title: z.ZodString;
+            variantTitle: z.ZodNullable<z.ZodString>;
+            quantity: z.ZodNumber;
+            unitPrice: z.ZodNullable<z.ZodString>;
+            sku: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        checkoutCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+        checkoutUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+        completedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type ShopifyCheckoutObservedEvent = z.infer<typeof ShopifyCheckoutObservedEventSchema>;
+declare const ShopifyOrderCompletedEventSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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.ZodString;
+        shopifyCustomerId: z.ZodNullable<z.ZodString>;
+        total: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            currencyCode: z.ZodString;
+        }, z.core.$strict>>;
+        completedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+type ShopifyOrderCompletedEvent = z.infer<typeof ShopifyOrderCompletedEventSchema>;
+declare const ShopifyCommerceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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.observed">;
+    payload: z.ZodObject<{
+        checkoutToken: z.ZodString;
+        cartToken: z.ZodNullable<z.ZodString>;
+        checkoutUrl: z.ZodNullable<z.ZodURL>;
+        customer: z.ZodNullable<z.ZodObject<{
+            shopifyCustomerId: z.ZodNullable<z.ZodString>;
+            email: z.ZodNullable<z.ZodString>;
+            phone: z.ZodNullable<z.ZodString>;
+            firstName: z.ZodNullable<z.ZodString>;
+            lastName: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        total: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            currencyCode: z.ZodString;
+        }, z.core.$strict>>;
+        lineItems: z.ZodArray<z.ZodObject<{
+            lineItemId: z.ZodNullable<z.ZodString>;
+            variantId: z.ZodNullable<z.ZodString>;
+            productId: z.ZodNullable<z.ZodString>;
+            title: z.ZodString;
+            variantTitle: z.ZodNullable<z.ZodString>;
+            quantity: z.ZodNumber;
+            unitPrice: z.ZodNullable<z.ZodString>;
+            sku: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>>;
+        checkoutCreatedAt: z.ZodNullable<z.ZodISODateTime>;
+        checkoutUpdatedAt: z.ZodNullable<z.ZodISODateTime>;
+        completedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    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.ZodString;
+        shopifyCustomerId: z.ZodNullable<z.ZodString>;
+        total: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            currencyCode: z.ZodString;
+        }, z.core.$strict>>;
+        completedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>], "eventType">;
+type ShopifyCommerceEvent = z.infer<typeof ShopifyCommerceEventSchema>;
+type ShopifyCommerceEventType = ShopifyCommerceEvent["eventType"];
+declare function parseShopifyCommerceEvent(input: unknown): ShopifyCommerceEvent;
+declare function safeParseShopifyCommerceEvent(input: unknown): z.ZodSafeParseResult<{
+    schemaVersion: 1;
+    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.observed";
+    payload: {
+        checkoutToken: string;
+        cartToken: string | null;
+        checkoutUrl: string | null;
+        customer: {
+            shopifyCustomerId: string | null;
+            email: string | null;
+            phone: string | null;
+            firstName: string | null;
+            lastName: string | null;
+        } | null;
+        total: {
+            amount: string;
+            currencyCode: string;
+        } | null;
+        lineItems: {
+            lineItemId: string | null;
+            variantId: string | null;
+            productId: string | null;
+            title: string;
+            variantTitle: string | null;
+            quantity: number;
+            unitPrice: string | null;
+            sku: string | null;
+        }[];
+        checkoutCreatedAt: string | null;
+        checkoutUpdatedAt: string | null;
+        completedAt: string | null;
+    };
+} | {
+    schemaVersion: 1;
+    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;
+        shopifyCustomerId: string | null;
+        total: {
+            amount: string;
+            currencyCode: string;
+        } | null;
+        completedAt: string;
+    };
+}>;
+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").
+ */
+declare function createShopifyCommerceOrderingKey(shopId: string, checkoutToken: string): string;
+
+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 };

package/dist/shopify/index.js

@@ -0,0 +1,47 @@
+import {
+  CheckoutObservedPayloadSchema,
+  MAX_LINE_ITEMS,
+  MAX_URL_LENGTH,
+  OrderCompletedPayloadSchema,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION,
+  SHOPIFY_COMMERCE_EVENT_TYPES,
+  SHOPIFY_COMMERCE_JOB,
+  SHOPIFY_COMMERCE_QUEUE,
+  ShopifyCheckoutLineItemSchema,
+  ShopifyCheckoutLineItemsSchema,
+  ShopifyCheckoutObservedEventSchema,
+  ShopifyCommerceEventSchema,
+  ShopifyCustomerReferenceSchema,
+  ShopifyMoneySchema,
+  ShopifyOrderCompletedEventSchema,
+  ShopifyTenantSchema,
+  createShopifyCommerceOrderingKey,
+  isCheckoutObservedEvent,
+  isOrderCompletedEvent,
+  parseShopifyCommerceEvent,
+  safeParseShopifyCommerceEvent
+} from "../chunk-NE5RMNXU.js";
+export {
+  CheckoutObservedPayloadSchema,
+  MAX_LINE_ITEMS,
+  MAX_URL_LENGTH,
+  OrderCompletedPayloadSchema,
+  SHOPIFY_COMMERCE_EVENT_SCHEMA_VERSION,
+  SHOPIFY_COMMERCE_EVENT_TYPES,
+  SHOPIFY_COMMERCE_JOB,
+  SHOPIFY_COMMERCE_QUEUE,
+  ShopifyCheckoutLineItemSchema,
+  ShopifyCheckoutLineItemsSchema,
+  ShopifyCheckoutObservedEventSchema,
+  ShopifyCommerceEventSchema,
+  ShopifyCustomerReferenceSchema,
+  ShopifyMoneySchema,
+  ShopifyOrderCompletedEventSchema,
+  ShopifyTenantSchema,
+  createShopifyCommerceOrderingKey,
+  isCheckoutObservedEvent,
+  isOrderCompletedEvent,
+  parseShopifyCommerceEvent,
+  safeParseShopifyCommerceEvent
+};
+//# sourceMappingURL=index.js.map

package/dist/shopify/index.js.map

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

package/dist/shopify/node.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Deterministic, BullMQ-safe job ID: "shopify-<sha256(appKey + ":" + deliveryId)>".
+ * The hex digest contains no colons and no secret material, only a one-way hash.
+ */
+declare function createShopifyWebhookJobId(appKey: string, deliveryId: string): string;
+
+export { createShopifyWebhookJobId };

package/dist/shopify/node.js

@@ -0,0 +1,16 @@
+// 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");
+  }
+  if (typeof deliveryId !== "string" || deliveryId.length === 0) {
+    throw new Error("createShopifyWebhookJobId: deliveryId must be a non-empty string");
+  }
+  const digest = createHash("sha256").update(`${appKey}:${deliveryId}`).digest("hex");
+  return `shopify-${digest}`;
+}
+export {
+  createShopifyWebhookJobId
+};
+//# sourceMappingURL=node.js.map

package/dist/shopify/node.js.map

@@ -0,0 +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":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@modainteract/moda-interact-shared",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./shopify": {
+      "types": "./dist/shopify/index.d.ts",
+      "import": "./dist/shopify/index.js"
+    },
+    "./shopify/node": {
+      "types": "./dist/shopify/node.d.ts",
+      "import": "./dist/shopify/node.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test src/**/*.test.ts",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.23.12",
+    "typescript": "^5.0.0"
+  }
+}