@modainteract/moda-interact-shared 0.1.0 → 0.2.0

package/dist/logging/index.js

@@ -0,0 +1,199 @@
+// src/logging/redaction.ts
+var REDACTED = "[REDACTED]";
+var CIRCULAR = "[Circular]";
+var MAX_DEPTH_REACHED = "[MaxDepth]";
+var TRUNCATED = "[Truncated]";
+var LOG_VALUE_LIMITS = Object.freeze({
+  maxDepth: 6,
+  maxArrayItems: 50,
+  maxObjectKeys: 100,
+  maxStringLength: 4096
+});
+var SENSITIVE_EXACT_KEYS = /* @__PURE__ */ new Set([
+  "authorization",
+  "cookie",
+  "setcookie",
+  "password",
+  "passwd",
+  "apikey",
+  "privatekey",
+  "cvv",
+  "cvc",
+  "cardnumber",
+  "creditcard",
+  "firstname",
+  "lastname"
+]);
+function normalizeKey(key) {
+  return key.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function isSensitiveLogKey(key) {
+  const normalized = normalizeKey(key);
+  return SENSITIVE_EXACT_KEYS.has(normalized) || normalized.includes("secret") || normalized.endsWith("token") || normalized.includes("email") || normalized.includes("phone") || normalized.endsWith("address");
+}
+function sanitizeString(value) {
+  const scrubbed = value.replace(/\bBearer\s+[^\s,;]+/gi, `Bearer ${REDACTED}`).replace(
+    /([?&](?:access_token|refresh_token|verify_token|client_secret|api_key|token|password)=)[^&#\s]*/gi,
+    `$1${REDACTED}`
+  );
+  if (scrubbed.length <= LOG_VALUE_LIMITS.maxStringLength) {
+    return scrubbed;
+  }
+  return `${scrubbed.slice(0, LOG_VALUE_LIMITS.maxStringLength)}\u2026${TRUNCATED}`;
+}
+function sanitizeError(error) {
+  return {
+    name: sanitizeString(error.name),
+    message: sanitizeString(error.message)
+  };
+}
+function sanitizeValue(value, depth, activeObjects) {
+  if (value === null || value === void 0) {
+    return value ?? null;
+  }
+  if (typeof value === "string") {
+    return sanitizeString(value);
+  }
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : String(value);
+  }
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (typeof value === "symbol" || typeof value === "function") {
+    return `[${typeof value}]`;
+  }
+  if (value instanceof Date) {
+    return Number.isNaN(value.getTime()) ? "Invalid Date" : value.toISOString();
+  }
+  if (value instanceof Error) {
+    return sanitizeError(value);
+  }
+  if (depth >= LOG_VALUE_LIMITS.maxDepth) {
+    return MAX_DEPTH_REACHED;
+  }
+  if (typeof value !== "object") {
+    return String(value);
+  }
+  if (activeObjects.has(value)) {
+    return CIRCULAR;
+  }
+  activeObjects.add(value);
+  try {
+    if (Array.isArray(value)) {
+      const result2 = value.slice(0, LOG_VALUE_LIMITS.maxArrayItems).map((item) => sanitizeValue(item, depth + 1, activeObjects));
+      if (value.length > LOG_VALUE_LIMITS.maxArrayItems) {
+        result2.push(TRUNCATED);
+      }
+      return result2;
+    }
+    const result = {};
+    const entries = Object.entries(value).slice(0, LOG_VALUE_LIMITS.maxObjectKeys);
+    for (const [key, item] of entries) {
+      result[key] = isSensitiveLogKey(key) ? REDACTED : sanitizeValue(item, depth + 1, activeObjects);
+    }
+    if (Object.keys(value).length > LOG_VALUE_LIMITS.maxObjectKeys) {
+      result.__truncated__ = true;
+    }
+    return result;
+  } finally {
+    activeObjects.delete(value);
+  }
+}
+function sanitizeLogFields(fields) {
+  return sanitizeValue(fields, 0, /* @__PURE__ */ new WeakSet());
+}
+
+// src/logging/logger.ts
+var DEFAULT_SERVICE_NAMESPACE = "moda-interact";
+function requireNonEmpty(value, field) {
+  const normalized = value.trim();
+  if (!normalized) {
+    throw new Error(`${field} must be a non-empty string`);
+  }
+  return normalized;
+}
+function defaultSink(record) {
+  const line = JSON.stringify(record);
+  switch (record.level) {
+    case "debug":
+      console.debug(line);
+      break;
+    case "warn":
+      console.warn(line);
+      break;
+    case "error":
+      console.error(line);
+      break;
+    case "info":
+    default:
+      console.info(line);
+      break;
+  }
+}
+function safeTimestamp(now) {
+  try {
+    const value = now();
+    if (value instanceof Date && !Number.isNaN(value.getTime())) {
+      return value.toISOString();
+    }
+  } catch {
+  }
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function createLogger(options) {
+  const serviceName = requireNonEmpty(options.serviceName, "serviceName");
+  const environment = requireNonEmpty(options.environment, "environment");
+  const serviceNamespace = requireNonEmpty(
+    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,
+    "serviceNamespace"
+  );
+  const sink = options.sink ?? defaultSink;
+  const now = options.now ?? (() => /* @__PURE__ */ new Date());
+  const initialBaseFields = { ...options.baseFields ?? {} };
+  function buildLogger(baseFields) {
+    function emit(level, event, fields = {}) {
+      try {
+        const eventName = event.trim() || "unknown";
+        const sanitizedData = sanitizeLogFields({ ...baseFields, ...fields });
+        const record = Object.freeze({
+          timestamp: safeTimestamp(now),
+          level,
+          event: eventName,
+          "service.namespace": serviceNamespace,
+          "service.name": serviceName,
+          "deployment.environment.name": environment,
+          ...Object.keys(sanitizedData).length > 0 ? { data: sanitizedData } : {}
+        });
+        sink(record);
+      } catch {
+      }
+    }
+    return Object.freeze({
+      debug: (event, fields) => emit("debug", event, fields),
+      info: (event, fields) => emit("info", event, fields),
+      warn: (event, fields) => emit("warn", event, fields),
+      error: (event, fields) => emit("error", event, fields),
+      child: (fields) => buildLogger({ ...baseFields, ...fields })
+    });
+  }
+  return buildLogger(initialBaseFields);
+}
+
+// src/logging/types.ts
+var LOG_LEVELS = ["debug", "info", "warn", "error"];
+export {
+  CIRCULAR,
+  LOG_LEVELS,
+  LOG_VALUE_LIMITS,
+  MAX_DEPTH_REACHED,
+  REDACTED,
+  TRUNCATED,
+  createLogger,
+  isSensitiveLogKey,
+  sanitizeLogFields
+};
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logging/redaction.ts","../../src/logging/logger.ts","../../src/logging/types.ts"],"sourcesContent":["export const REDACTED = \"[REDACTED]\";\nexport const CIRCULAR = \"[Circular]\";\nexport const MAX_DEPTH_REACHED = \"[MaxDepth]\";\nexport const TRUNCATED = \"[Truncated]\";\n\nexport const LOG_VALUE_LIMITS = Object.freeze({\n  maxDepth: 6,\n  maxArrayItems: 50,\n  maxObjectKeys: 100,\n  maxStringLength: 4096,\n});\n\nconst SENSITIVE_EXACT_KEYS = new Set([\n  \"authorization\",\n  \"cookie\",\n  \"setcookie\",\n  \"password\",\n  \"passwd\",\n  \"apikey\",\n  \"privatekey\",\n  \"cvv\",\n  \"cvc\",\n  \"cardnumber\",\n  \"creditcard\",\n  \"firstname\",\n  \"lastname\",\n]);\n\nfunction normalizeKey(key: string): string {\n  return key.toLowerCase().replace(/[^a-z0-9]/g, \"\");\n}\n\nexport function isSensitiveLogKey(key: string): boolean {\n  const normalized = normalizeKey(key);\n\n  return (\n    SENSITIVE_EXACT_KEYS.has(normalized) ||\n    normalized.includes(\"secret\") ||\n    normalized.endsWith(\"token\") ||\n    normalized.includes(\"email\") ||\n    normalized.includes(\"phone\") ||\n    normalized.endsWith(\"address\")\n  );\n}\n\nfunction sanitizeString(value: string): string {\n  const scrubbed = value\n    .replace(/\\bBearer\\s+[^\\s,;]+/gi, `Bearer ${REDACTED}`)\n    .replace(\n      /([?&](?:access_token|refresh_token|verify_token|client_secret|api_key|token|password)=)[^&#\\s]*/gi,\n      `$1${REDACTED}`,\n    );\n\n  if (scrubbed.length <= LOG_VALUE_LIMITS.maxStringLength) {\n    return scrubbed;\n  }\n\n  return `${scrubbed.slice(0, LOG_VALUE_LIMITS.maxStringLength)}…${TRUNCATED}`;\n}\n\nfunction sanitizeError(error: Error): Record<string, unknown> {\n  return {\n    name: sanitizeString(error.name),\n    message: sanitizeString(error.message),\n  };\n}\n\nfunction sanitizeValue(\n  value: unknown,\n  depth: number,\n  activeObjects: WeakSet<object>,\n): unknown {\n  if (value === null || value === undefined) {\n    return value ?? null;\n  }\n\n  if (typeof value === \"string\") {\n    return sanitizeString(value);\n  }\n\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : String(value);\n  }\n\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n\n  if (typeof value === \"bigint\") {\n    return value.toString();\n  }\n\n  if (typeof value === \"symbol\" || typeof value === \"function\") {\n    return `[${typeof value}]`;\n  }\n\n  if (value instanceof Date) {\n    return Number.isNaN(value.getTime()) ? \"Invalid Date\" : value.toISOString();\n  }\n\n  if (value instanceof Error) {\n    return sanitizeError(value);\n  }\n\n  if (depth >= LOG_VALUE_LIMITS.maxDepth) {\n    return MAX_DEPTH_REACHED;\n  }\n\n  if (typeof value !== \"object\") {\n    return String(value);\n  }\n\n  if (activeObjects.has(value)) {\n    return CIRCULAR;\n  }\n\n  activeObjects.add(value);\n\n  try {\n    if (Array.isArray(value)) {\n      const result = value\n        .slice(0, LOG_VALUE_LIMITS.maxArrayItems)\n        .map((item) => sanitizeValue(item, depth + 1, activeObjects));\n\n      if (value.length > LOG_VALUE_LIMITS.maxArrayItems) {\n        result.push(TRUNCATED);\n      }\n\n      return result;\n    }\n\n    const result: Record<string, unknown> = {};\n    const entries = Object.entries(value).slice(0, LOG_VALUE_LIMITS.maxObjectKeys);\n\n    for (const [key, item] of entries) {\n      result[key] = isSensitiveLogKey(key)\n        ? REDACTED\n        : sanitizeValue(item, depth + 1, activeObjects);\n    }\n\n    if (Object.keys(value).length > LOG_VALUE_LIMITS.maxObjectKeys) {\n      result.__truncated__ = true;\n    }\n\n    return result;\n  } finally {\n    activeObjects.delete(value);\n  }\n}\n\nexport function sanitizeLogFields(\n  fields: Readonly<Record<string, unknown>>,\n): Record<string, unknown> {\n  return sanitizeValue(fields, 0, new WeakSet<object>()) as Record<string, unknown>;\n}\n","import { sanitizeLogFields } from \"./redaction.js\";\nimport type {\n  LogFields,\n  LogLevel,\n  LogRecord,\n  LogSink,\n  LoggerOptions,\n  StructuredLogger,\n} from \"./types.js\";\n\nconst DEFAULT_SERVICE_NAMESPACE = \"moda-interact\";\n\nfunction requireNonEmpty(value: string, field: string): string {\n  const normalized = value.trim();\n  if (!normalized) {\n    throw new Error(`${field} must be a non-empty string`);\n  }\n  return normalized;\n}\n\nfunction defaultSink(record: LogRecord): void {\n  const line = JSON.stringify(record);\n\n  switch (record.level) {\n    case \"debug\":\n      console.debug(line);\n      break;\n    case \"warn\":\n      console.warn(line);\n      break;\n    case \"error\":\n      console.error(line);\n      break;\n    case \"info\":\n    default:\n      console.info(line);\n      break;\n  }\n}\n\nfunction safeTimestamp(now: () => Date): string {\n  try {\n    const value = now();\n    if (value instanceof Date && !Number.isNaN(value.getTime())) {\n      return value.toISOString();\n    }\n  } catch {\n    // Logging must not become a correctness dependency.\n  }\n\n  return new Date().toISOString();\n}\n\nexport function createLogger(options: LoggerOptions): StructuredLogger {\n  const serviceName = requireNonEmpty(options.serviceName, \"serviceName\");\n  const environment = requireNonEmpty(options.environment, \"environment\");\n  const serviceNamespace = requireNonEmpty(\n    options.serviceNamespace ?? DEFAULT_SERVICE_NAMESPACE,\n    \"serviceNamespace\",\n  );\n  const sink: LogSink = options.sink ?? defaultSink;\n  const now = options.now ?? (() => new Date());\n  const initialBaseFields = { ...(options.baseFields ?? {}) };\n\n  function buildLogger(baseFields: Record<string, unknown>): StructuredLogger {\n    function emit(level: LogLevel, event: string, fields: LogFields = {}): void {\n      try {\n        const eventName = event.trim() || \"unknown\";\n        const sanitizedData = sanitizeLogFields({ ...baseFields, ...fields });\n\n        const record: LogRecord = Object.freeze({\n          timestamp: safeTimestamp(now),\n          level,\n          event: eventName,\n          \"service.namespace\": serviceNamespace,\n          \"service.name\": serviceName,\n          \"deployment.environment.name\": environment,\n          ...(Object.keys(sanitizedData).length > 0 ? { data: sanitizedData } : {}),\n        });\n\n        sink(record);\n      } catch {\n        // Logging is best-effort and must never alter business correctness.\n      }\n    }\n\n    return Object.freeze({\n      debug: (event: string, fields?: LogFields) => emit(\"debug\", event, fields),\n      info: (event: string, fields?: LogFields) => emit(\"info\", event, fields),\n      warn: (event: string, fields?: LogFields) => emit(\"warn\", event, fields),\n      error: (event: string, fields?: LogFields) => emit(\"error\", event, fields),\n      child: (fields: LogFields) => buildLogger({ ...baseFields, ...fields }),\n    });\n  }\n\n  return buildLogger(initialBaseFields);\n}\n","export const LOG_LEVELS = [\"debug\", \"info\", \"warn\", \"error\"] as const;\n\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\nexport type LogFields = Readonly<Record<string, unknown>>;\n\nexport type LogRecord = Readonly<{\n  timestamp: string;\n  level: LogLevel;\n  event: string;\n  \"service.namespace\": string;\n  \"service.name\": string;\n  \"deployment.environment.name\": string;\n  data?: Readonly<Record<string, unknown>>;\n}>;\n\nexport type LogSink = (record: LogRecord) => void;\n\nexport type LoggerOptions = {\n  serviceName: string;\n  environment: string;\n  serviceNamespace?: string;\n  baseFields?: LogFields;\n  sink?: LogSink;\n  now?: () => Date;\n};\n\nexport interface StructuredLogger {\n  debug(event: string, fields?: LogFields): void;\n  info(event: string, fields?: LogFields): void;\n  warn(event: string, fields?: LogFields): void;\n  error(event: string, fields?: LogFields): void;\n  child(fields: LogFields): StructuredLogger;\n}\n"],"mappings":";AAAO,IAAM,WAAW;AACjB,IAAM,WAAW;AACjB,IAAM,oBAAoB;AAC1B,IAAM,YAAY;AAElB,IAAM,mBAAmB,OAAO,OAAO;AAAA,EAC5C,UAAU;AAAA,EACV,eAAe;AAAA,EACf,eAAe;AAAA,EACf,iBAAiB;AACnB,CAAC;AAED,IAAM,uBAAuB,oBAAI,IAAI;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,aAAa,KAAqB;AACzC,SAAO,IAAI,YAAY,EAAE,QAAQ,cAAc,EAAE;AACnD;AAEO,SAAS,kBAAkB,KAAsB;AACtD,QAAM,aAAa,aAAa,GAAG;AAEnC,SACE,qBAAqB,IAAI,UAAU,KACnC,WAAW,SAAS,QAAQ,KAC5B,WAAW,SAAS,OAAO,KAC3B,WAAW,SAAS,OAAO,KAC3B,WAAW,SAAS,OAAO,KAC3B,WAAW,SAAS,SAAS;AAEjC;AAEA,SAAS,eAAe,OAAuB;AAC7C,QAAM,WAAW,MACd,QAAQ,yBAAyB,UAAU,QAAQ,EAAE,EACrD;AAAA,IACC;AAAA,IACA,KAAK,QAAQ;AAAA,EACf;AAEF,MAAI,SAAS,UAAU,iBAAiB,iBAAiB;AACvD,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,SAAS,MAAM,GAAG,iBAAiB,eAAe,CAAC,SAAI,SAAS;AAC5E;AAEA,SAAS,cAAc,OAAuC;AAC5D,SAAO;AAAA,IACL,MAAM,eAAe,MAAM,IAAI;AAAA,IAC/B,SAAS,eAAe,MAAM,OAAO;AAAA,EACvC;AACF;AAEA,SAAS,cACP,OACA,OACA,eACS;AACT,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,WAAO,SAAS;AAAA,EAClB;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,eAAe,KAAK;AAAA,EAC7B;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ,OAAO,KAAK;AAAA,EACtD;AAEA,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MAAM,SAAS;AAAA,EACxB;AAEA,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY;AAC5D,WAAO,IAAI,OAAO,KAAK;AAAA,EACzB;AAEA,MAAI,iBAAiB,MAAM;AACzB,WAAO,OAAO,MAAM,MAAM,QAAQ,CAAC,IAAI,iBAAiB,MAAM,YAAY;AAAA,EAC5E;AAEA,MAAI,iBAAiB,OAAO;AAC1B,WAAO,cAAc,KAAK;AAAA,EAC5B;AAEA,MAAI,SAAS,iBAAiB,UAAU;AACtC,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,KAAK;AAAA,EACrB;AAEA,MAAI,cAAc,IAAI,KAAK,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,gBAAc,IAAI,KAAK;AAEvB,MAAI;AACF,QAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,YAAMA,UAAS,MACZ,MAAM,GAAG,iBAAiB,aAAa,EACvC,IAAI,CAAC,SAAS,cAAc,MAAM,QAAQ,GAAG,aAAa,CAAC;AAE9D,UAAI,MAAM,SAAS,iBAAiB,eAAe;AACjD,QAAAA,QAAO,KAAK,SAAS;AAAA,MACvB;AAEA,aAAOA;AAAA,IACT;AAEA,UAAM,SAAkC,CAAC;AACzC,UAAM,UAAU,OAAO,QAAQ,KAAK,EAAE,MAAM,GAAG,iBAAiB,aAAa;AAE7E,eAAW,CAAC,KAAK,IAAI,KAAK,SAAS;AACjC,aAAO,GAAG,IAAI,kBAAkB,GAAG,IAC/B,WACA,cAAc,MAAM,QAAQ,GAAG,aAAa;AAAA,IAClD;AAEA,QAAI,OAAO,KAAK,KAAK,EAAE,SAAS,iBAAiB,eAAe;AAC9D,aAAO,gBAAgB;AAAA,IACzB;AAEA,WAAO;AAAA,EACT,UAAE;AACA,kBAAc,OAAO,KAAK;AAAA,EAC5B;AACF;AAEO,SAAS,kBACd,QACyB;AACzB,SAAO,cAAc,QAAQ,GAAG,oBAAI,QAAgB,CAAC;AACvD;;;AChJA,IAAM,4BAA4B;AAElC,SAAS,gBAAgB,OAAe,OAAuB;AAC7D,QAAM,aAAa,MAAM,KAAK;AAC9B,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,GAAG,KAAK,6BAA6B;AAAA,EACvD;AACA,SAAO;AACT;AAEA,SAAS,YAAY,QAAyB;AAC5C,QAAM,OAAO,KAAK,UAAU,MAAM;AAElC,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK;AACH,cAAQ,MAAM,IAAI;AAClB;AAAA,IACF,KAAK;AACH,cAAQ,KAAK,IAAI;AACjB;AAAA,IACF,KAAK;AACH,cAAQ,MAAM,IAAI;AAClB;AAAA,IACF,KAAK;AAAA,IACL;AACE,cAAQ,KAAK,IAAI;AACjB;AAAA,EACJ;AACF;AAEA,SAAS,cAAc,KAAyB;AAC9C,MAAI;AACF,UAAM,QAAQ,IAAI;AAClB,QAAI,iBAAiB,QAAQ,CAAC,OAAO,MAAM,MAAM,QAAQ,CAAC,GAAG;AAC3D,aAAO,MAAM,YAAY;AAAA,IAC3B;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,UAAO,oBAAI,KAAK,GAAE,YAAY;AAChC;AAEO,SAAS,aAAa,SAA0C;AACrE,QAAM,cAAc,gBAAgB,QAAQ,aAAa,aAAa;AACtE,QAAM,cAAc,gBAAgB,QAAQ,aAAa,aAAa;AACtE,QAAM,mBAAmB;AAAA,IACvB,QAAQ,oBAAoB;AAAA,IAC5B;AAAA,EACF;AACA,QAAM,OAAgB,QAAQ,QAAQ;AACtC,QAAM,MAAM,QAAQ,QAAQ,MAAM,oBAAI,KAAK;AAC3C,QAAM,oBAAoB,EAAE,GAAI,QAAQ,cAAc,CAAC,EAAG;AAE1D,WAAS,YAAY,YAAuD;AAC1E,aAAS,KAAK,OAAiB,OAAe,SAAoB,CAAC,GAAS;AAC1E,UAAI;AACF,cAAM,YAAY,MAAM,KAAK,KAAK;AAClC,cAAM,gBAAgB,kBAAkB,EAAE,GAAG,YAAY,GAAG,OAAO,CAAC;AAEpE,cAAM,SAAoB,OAAO,OAAO;AAAA,UACtC,WAAW,cAAc,GAAG;AAAA,UAC5B;AAAA,UACA,OAAO;AAAA,UACP,qBAAqB;AAAA,UACrB,gBAAgB;AAAA,UAChB,+BAA+B;AAAA,UAC/B,GAAI,OAAO,KAAK,aAAa,EAAE,SAAS,IAAI,EAAE,MAAM,cAAc,IAAI,CAAC;AAAA,QACzE,CAAC;AAED,aAAK,MAAM;AAAA,MACb,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,WAAO,OAAO,OAAO;AAAA,MACnB,OAAO,CAAC,OAAe,WAAuB,KAAK,SAAS,OAAO,MAAM;AAAA,MACzE,MAAM,CAAC,OAAe,WAAuB,KAAK,QAAQ,OAAO,MAAM;AAAA,MACvE,MAAM,CAAC,OAAe,WAAuB,KAAK,QAAQ,OAAO,MAAM;AAAA,MACvE,OAAO,CAAC,OAAe,WAAuB,KAAK,SAAS,OAAO,MAAM;AAAA,MACzE,OAAO,CAAC,WAAsB,YAAY,EAAE,GAAG,YAAY,GAAG,OAAO,CAAC;AAAA,IACxE,CAAC;AAAA,EACH;AAEA,SAAO,YAAY,iBAAiB;AACtC;;;AChGO,IAAM,aAAa,CAAC,SAAS,QAAQ,QAAQ,OAAO;","names":["result"]}

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 };