@openlup/platform 0.26.0 → 0.28.0

package/dist/communications/newsletterIntegrationContracts.d.ts

@@ -15,21 +15,21 @@ export declare const newsletterMarketingPurposeSchema: z.ZodEnum<{
     marketing_newsletter: "marketing_newsletter";
 }>;
 export declare const newsletterSyncEventTypeSchema: z.ZodEnum<{
+    suppress: "suppress";
     update: "update";
     subscribe: "subscribe";
     unsubscribe: "unsubscribe";
-    suppress: "suppress";
 }>;
 export declare const newsletterWebhookEventTypeSchema: z.ZodEnum<{
+    ignored: "ignored";
+    suppress: "suppress";
     update: "update";
     email_change: "email_change";
     subscribe: "subscribe";
     unsubscribe: "unsubscribe";
-    suppress: "suppress";
     complaint: "complaint";
     bounce: "bounce";
     profile_update: "profile_update";
-    ignored: "ignored";
 }>;
 export declare const newsletterProviderCapabilitiesSchema: z.ZodObject<{
     subscribe: z.ZodBoolean;
@@ -46,15 +46,15 @@ export declare const canonicalNewsletterWebhookEventSchema: z.ZodObject<{
     providerKind: z.ZodString;
     providerEventId: z.ZodString;
     eventType: z.ZodEnum<{
+        ignored: "ignored";
+        suppress: "suppress";
         update: "update";
         email_change: "email_change";
         subscribe: "subscribe";
         unsubscribe: "unsubscribe";
-        suppress: "suppress";
         complaint: "complaint";
         bounce: "bounce";
         profile_update: "profile_update";
-        ignored: "ignored";
     }>;
     email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     remoteProfileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -66,8 +66,8 @@ export declare const canonicalNewsletterWebhookEventSchema: z.ZodObject<{
     explicitOptInEvidence: z.ZodOptional<z.ZodBoolean>;
     doubleOptInStatus: z.ZodOptional<z.ZodEnum<{
         unknown: "unknown";
-        confirmed: "confirmed";
         pending: "pending";
+        confirmed: "confirmed";
     }>>;
     occurredAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -85,15 +85,15 @@ export declare function createNewsletterIntegrationSchemas<Purpose extends strin
         providerKind: z.ZodString;
         providerEventId: z.ZodString;
         eventType: z.ZodEnum<{
+            ignored: "ignored";
+            suppress: "suppress";
             update: "update";
             email_change: "email_change";
             subscribe: "subscribe";
             unsubscribe: "unsubscribe";
-            suppress: "suppress";
             complaint: "complaint";
             bounce: "bounce";
             profile_update: "profile_update";
-            ignored: "ignored";
         }>;
         email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         remoteProfileId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -101,8 +101,8 @@ export declare function createNewsletterIntegrationSchemas<Purpose extends strin
         explicitOptInEvidence: z.ZodOptional<z.ZodBoolean>;
         doubleOptInStatus: z.ZodOptional<z.ZodEnum<{
             unknown: "unknown";
-            confirmed: "confirmed";
             pending: "pending";
+            confirmed: "confirmed";
         }>>;
         occurredAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -114,10 +114,10 @@ export declare function createNewsletterIntegrationSchemas<Purpose extends strin
         contactId: z.ZodString;
         normalizedEmail: z.ZodString;
         eventType: z.ZodEnum<{
+            suppress: "suppress";
             update: "update";
             subscribe: "subscribe";
             unsubscribe: "unsubscribe";
-            suppress: "suppress";
         }>;
         purpose: z.ZodCustom<Purpose, Purpose>;
         payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;

package/dist/composition/accountSupportContribution.d.ts

@@ -0,0 +1,18 @@
+import type { Contribution, RequiredSchema } from "@openlup/core/readiness";
+/** Descriptors only: owner messages, workers and schedules stay with their owners. */
+export declare function createAccountSupportContribution(input: {
+    version: string;
+    requiredSchema: RequiredSchema;
+    accountSupport: Readonly<Record<string, ((...args: never[]) => unknown) | null>>;
+    dependsOn: NonNullable<Contribution["manifest"]["module"]>["dependsOn"];
+    routes?: Contribution["routes"];
+}): {
+    contributions: Contribution[];
+    ports: {
+        [k: string]: ((...args: never[]) => unknown) | null;
+    };
+    routes: {
+        [k: string]: (...args: never[]) => unknown;
+    };
+    triggers: {};
+};

package/dist/composition/accountSupportContribution.js

@@ -0,0 +1,21 @@
+/** Descriptors only: owner messages, workers and schedules stay with their owners. */
+export function createAccountSupportContribution(input) {
+    const routes = [...input.routes ?? []];
+    if (new Set(routes.map(route => route.id)).size !== routes.length)
+        throw new Error("account_support_duplicate_route");
+    const contribution = {
+        manifest: {
+            name: "@openlup/platform", version: input.version, kind: "rail",
+            module: { id: "account-support", kind: "capability", provides: ["./account-support", "./account-support/contracts"], dependsOn: input.dependsOn },
+            emits: [], handles: [], schedules: [], env: [], requiredPorts: Object.keys(input.accountSupport),
+            routes: routes.map(route => route.id), requiredSchema: input.requiredSchema,
+        }, handlers: [], schedules: [], routes,
+    };
+    return {
+        contributions: [contribution],
+        ports: Object.fromEntries(Object.entries(input.accountSupport).filter(([, operation]) => operation !== null)
+            .map(([key, operation]) => [`@openlup/platform/account-support:${key}`, operation])),
+        routes: Object.fromEntries(routes.map(route => [`@openlup/platform/account-support:${route.id}`, route.handle])),
+        triggers: {},
+    };
+}

package/dist/composition/commerceContribution.d.ts

@@ -0,0 +1,21 @@
+import type { Contribution, RequiredSchema } from "@openlup/core/readiness";
+/** Describe existing selected commerce callables; never install another executor. */
+export declare function createCommerceContribution(input: {
+    version: string;
+    requiredSchema: RequiredSchema;
+    commerce: Readonly<Record<string, ((...args: never[]) => unknown) | null>>;
+    handlers: Contribution["handlers"];
+    schedules: Contribution["schedules"];
+    routes: Contribution["routes"];
+}): {
+    contributions: Contribution[];
+    ports: {
+        [k: string]: ((...args: never[]) => unknown) | null;
+    };
+    routes: {
+        [k: string]: (...args: never[]) => unknown;
+    };
+    triggers: {
+        [k: string]: (...args: never[]) => unknown;
+    };
+};

package/dist/composition/commerceContribution.js

@@ -0,0 +1,27 @@
+/** Describe existing selected commerce callables; never install another executor. */
+export function createCommerceContribution(input) {
+    for (const [kind, names] of [
+        ["handler", input.handlers.map(handler => handler.eventType)],
+        ["schedule", input.schedules.map(schedule => schedule.id)],
+        ["route", input.routes.map(route => route.id)],
+    ]) {
+        if (new Set(names).size !== names.length)
+            throw new Error(`commerce_duplicate_${kind}`);
+    }
+    const contribution = {
+        manifest: {
+            name: "@openlup/platform", version: input.version, kind: "rail",
+            module: { id: "commerce", kind: "capability", provides: ["./commerce", "./commerce/contracts", "./commerce/server"], dependsOn: [] },
+            emits: [], handles: input.handlers.map(handler => handler.eventType),
+            schedules: input.schedules.map(({ id, cadenceSeconds }) => ({ id, cadenceSeconds })), env: [],
+            requiredPorts: Object.keys(input.commerce), routes: input.routes.map(route => route.id), requiredSchema: input.requiredSchema,
+        },
+        handlers: input.handlers.map(({ eventType, timeoutMs }) => Object.freeze({ eventType, timeoutMs })), schedules: input.schedules, routes: input.routes,
+    };
+    return {
+        contributions: [contribution],
+        ports: Object.fromEntries(Object.entries(input.commerce).filter(([, fn]) => typeof fn === "function").map(([name, fn]) => [`@openlup/platform/commerce:${name}`, fn])),
+        routes: Object.fromEntries(input.routes.map(route => [`@openlup/platform/commerce:${route.id}`, route.handle])),
+        triggers: Object.fromEntries(input.schedules.map(schedule => [`@openlup/platform/commerce:${schedule.id}`, schedule.run])),
+    };
+}

package/dist/composition/index.d.ts

@@ -6,3 +6,5 @@ export { createInventoryContribution } from "./inventoryContribution.js";
 export { createShippingContribution } from "./shippingContribution.js";
 export { createFulfillmentContribution } from "./fulfillmentContribution.js";
 export { createSubscriptionContribution } from "./subscriptionContribution.js";
+export { createCommerceContribution } from "./commerceContribution.js";
+export { createAccountSupportContribution } from "./accountSupportContribution.js";

package/dist/composition/index.js

@@ -7,3 +7,5 @@ export { createInventoryContribution } from "./inventoryContribution.js";
 export { createShippingContribution } from "./shippingContribution.js";
 export { createFulfillmentContribution } from "./fulfillmentContribution.js";
 export { createSubscriptionContribution } from "./subscriptionContribution.js";
+export { createCommerceContribution } from "./commerceContribution.js";
+export { createAccountSupportContribution } from "./accountSupportContribution.js";

package/dist/fulfillment/handlerSchemas.d.ts

@@ -4,19 +4,19 @@ export declare const COMMERCE_FULFILLMENT_STATUSES: readonly ["created", "packed
 export declare const COMMERCE_FULFILLMENT_OPERATION_TYPES: readonly ["created", "packed", "provider_attempt_recorded", "label_created", "handed_over", "tracking_event_recorded", "cancelled"];
 export declare const COMMERCE_FULFILLMENT_PROVIDER_ATTEMPT_STATUSES: readonly ["recorded", "succeeded", "failed"];
 export declare const commerceFulfillmentStatusSchema: z.ZodEnum<{
-    created: "created";
-    exception: "exception";
-    delivered: "delivered";
     cancelled: "cancelled";
+    delivered: "delivered";
+    exception: "exception";
+    created: "created";
     packed: "packed";
-    in_transit: "in_transit";
     label_pending: "label_pending";
     label_created: "label_created";
     handed_over: "handed_over";
+    in_transit: "in_transit";
 }>;
 export declare const commerceFulfillmentOperationTypeSchema: z.ZodEnum<{
-    created: "created";
     cancelled: "cancelled";
+    created: "created";
     packed: "packed";
     label_created: "label_created";
     handed_over: "handed_over";
@@ -25,27 +25,27 @@ export declare const commerceFulfillmentOperationTypeSchema: z.ZodEnum<{
 }>;
 export declare const commerceFulfillmentProviderAttemptStatusSchema: z.ZodEnum<{
     failed: "failed";
-    recorded: "recorded";
     succeeded: "succeeded";
+    recorded: "recorded";
 }>;
 export declare const commerceFulfillmentPaymentStatusSchema: z.ZodEnum<{
-    expired: "expired";
-    created: "created";
+    requires_action: "requires_action";
     failed: "failed";
     cancelled: "cancelled";
-    succeeded: "succeeded";
+    created: "created";
+    expired: "expired";
     refunded: "refunded";
-    requires_action: "requires_action";
+    not_started: "not_started";
     processing: "processing";
     partially_refunded: "partially_refunded";
     disputed: "disputed";
-    not_started: "not_started";
+    succeeded: "succeeded";
 }>;
 export declare const commerceFulfillmentInventoryStatusSchema: z.ZodEnum<{
-    expired: "expired";
     missing: "missing";
-    reserved: "reserved";
+    expired: "expired";
     not_checked: "not_checked";
+    reserved: "reserved";
     released: "released";
     consumed: "consumed";
     review_required: "review_required";
@@ -82,26 +82,26 @@ export declare const commerceFulfillmentLineSchema: z.ZodObject<{
 export declare const commerceFulfillmentPaymentSummarySchema: z.ZodObject<{
     paymentIntentId: z.ZodGUID;
     paymentStatus: z.ZodEnum<{
-        expired: "expired";
-        created: "created";
+        requires_action: "requires_action";
         failed: "failed";
         cancelled: "cancelled";
-        succeeded: "succeeded";
+        created: "created";
+        expired: "expired";
         refunded: "refunded";
-        requires_action: "requires_action";
+        not_started: "not_started";
         processing: "processing";
         partially_refunded: "partially_refunded";
         disputed: "disputed";
-        not_started: "not_started";
+        succeeded: "succeeded";
     }>;
     providerPaymentId: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export declare const commerceFulfillmentInventorySummarySchema: z.ZodObject<{
     status: z.ZodEnum<{
-        expired: "expired";
         missing: "missing";
-        reserved: "reserved";
+        expired: "expired";
         not_checked: "not_checked";
+        reserved: "reserved";
         released: "released";
         consumed: "consumed";
         review_required: "review_required";
@@ -132,8 +132,8 @@ export declare const commerceFulfillmentOmsEligibilitySchema: z.ZodObject<{
 export declare const commerceFulfillmentOperationSchema: z.ZodObject<{
     id: z.ZodGUID;
     type: z.ZodEnum<{
-        created: "created";
         cancelled: "cancelled";
+        created: "created";
         packed: "packed";
         label_created: "label_created";
         handed_over: "handed_over";
@@ -149,15 +149,15 @@ export declare const commerceFulfillmentOrderSchema: z.ZodObject<{
     orderId: z.ZodGUID;
     clientId: z.ZodNullable<z.ZodGUID>;
     status: z.ZodEnum<{
-        created: "created";
-        exception: "exception";
-        delivered: "delivered";
         cancelled: "cancelled";
+        delivered: "delivered";
+        exception: "exception";
+        created: "created";
         packed: "packed";
-        in_transit: "in_transit";
         label_pending: "label_pending";
         label_created: "label_created";
         handed_over: "handed_over";
+        in_transit: "in_transit";
     }>;
     providerKind: z.ZodNullable<z.ZodString>;
     providerTrackingId: z.ZodNullable<z.ZodString>;
@@ -184,26 +184,26 @@ export declare const commerceFulfillmentOrderSchema: z.ZodObject<{
     payment: z.ZodObject<{
         paymentIntentId: z.ZodGUID;
         paymentStatus: z.ZodEnum<{
-            expired: "expired";
-            created: "created";
+            requires_action: "requires_action";
             failed: "failed";
             cancelled: "cancelled";
-            succeeded: "succeeded";
+            created: "created";
+            expired: "expired";
             refunded: "refunded";
-            requires_action: "requires_action";
+            not_started: "not_started";
             processing: "processing";
             partially_refunded: "partially_refunded";
             disputed: "disputed";
-            not_started: "not_started";
+            succeeded: "succeeded";
         }>;
         providerPaymentId: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     inventory: z.ZodObject<{
         status: z.ZodEnum<{
-            expired: "expired";
             missing: "missing";
-            reserved: "reserved";
+            expired: "expired";
             not_checked: "not_checked";
+            reserved: "reserved";
             released: "released";
             consumed: "consumed";
             review_required: "review_required";
@@ -234,8 +234,8 @@ export declare const commerceFulfillmentOrderSchema: z.ZodObject<{
     latestOperation: z.ZodNullable<z.ZodObject<{
         id: z.ZodGUID;
         type: z.ZodEnum<{
-            created: "created";
             cancelled: "cancelled";
+            created: "created";
             packed: "packed";
             label_created: "label_created";
             handed_over: "handed_over";
@@ -253,15 +253,15 @@ export declare const adminCommerceFulfillmentOrdersListRequestSchema: z.ZodObjec
     page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     status: z.ZodOptional<z.ZodEnum<{
-        created: "created";
-        exception: "exception";
-        delivered: "delivered";
         cancelled: "cancelled";
+        delivered: "delivered";
+        exception: "exception";
+        created: "created";
         packed: "packed";
-        in_transit: "in_transit";
         label_pending: "label_pending";
         label_created: "label_created";
         handed_over: "handed_over";
+        in_transit: "in_transit";
     }>>;
 }, z.core.$strict>;
 export declare const adminCommerceFulfillmentOrderDetailRequestSchema: z.ZodObject<{
@@ -279,8 +279,8 @@ export declare const adminCommerceFulfillmentRecordProviderAttemptRequestSchema:
     providerKind: z.ZodString;
     status: z.ZodEnum<{
         failed: "failed";
-        recorded: "recorded";
         succeeded: "succeeded";
+        recorded: "recorded";
     }>;
     requestPayload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     responsePayload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -306,8 +306,8 @@ export declare const adminCommerceFulfillmentTrackingEventRequestSchema: z.ZodOb
     idempotencyKey: z.ZodString;
     fulfillmentOrderId: z.ZodGUID;
     status: z.ZodEnum<{
-        exception: "exception";
         delivered: "delivered";
+        exception: "exception";
         in_transit: "in_transit";
     }>;
     providerTrackingId: z.ZodOptional<z.ZodString>;
@@ -327,15 +327,15 @@ export declare const adminCommerceFulfillmentOrdersListResponseSchema: z.ZodObje
         orderId: z.ZodGUID;
         clientId: z.ZodNullable<z.ZodGUID>;
         status: z.ZodEnum<{
-            created: "created";
-            exception: "exception";
-            delivered: "delivered";
             cancelled: "cancelled";
+            delivered: "delivered";
+            exception: "exception";
+            created: "created";
             packed: "packed";
-            in_transit: "in_transit";
             label_pending: "label_pending";
             label_created: "label_created";
             handed_over: "handed_over";
+            in_transit: "in_transit";
         }>;
         providerKind: z.ZodNullable<z.ZodString>;
         providerTrackingId: z.ZodNullable<z.ZodString>;
@@ -362,26 +362,26 @@ export declare const adminCommerceFulfillmentOrdersListResponseSchema: z.ZodObje
         payment: z.ZodObject<{
             paymentIntentId: z.ZodGUID;
             paymentStatus: z.ZodEnum<{
-                expired: "expired";
-                created: "created";
+                requires_action: "requires_action";
                 failed: "failed";
                 cancelled: "cancelled";
-                succeeded: "succeeded";
+                created: "created";
+                expired: "expired";
                 refunded: "refunded";
-                requires_action: "requires_action";
+                not_started: "not_started";
                 processing: "processing";
                 partially_refunded: "partially_refunded";
                 disputed: "disputed";
-                not_started: "not_started";
+                succeeded: "succeeded";
             }>;
             providerPaymentId: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
         inventory: z.ZodObject<{
             status: z.ZodEnum<{
-                expired: "expired";
                 missing: "missing";
-                reserved: "reserved";
+                expired: "expired";
                 not_checked: "not_checked";
+                reserved: "reserved";
                 released: "released";
                 consumed: "consumed";
                 review_required: "review_required";
@@ -412,8 +412,8 @@ export declare const adminCommerceFulfillmentOrdersListResponseSchema: z.ZodObje
         latestOperation: z.ZodNullable<z.ZodObject<{
             id: z.ZodGUID;
             type: z.ZodEnum<{
-                created: "created";
                 cancelled: "cancelled";
+                created: "created";
                 packed: "packed";
                 label_created: "label_created";
                 handed_over: "handed_over";
@@ -438,15 +438,15 @@ export declare const adminCommerceFulfillmentOrderDetailResponseSchema: z.ZodObj
         orderId: z.ZodGUID;
         clientId: z.ZodNullable<z.ZodGUID>;
         status: z.ZodEnum<{
-            created: "created";
-            exception: "exception";
-            delivered: "delivered";
             cancelled: "cancelled";
+            delivered: "delivered";
+            exception: "exception";
+            created: "created";
             packed: "packed";
-            in_transit: "in_transit";
             label_pending: "label_pending";
             label_created: "label_created";
             handed_over: "handed_over";
+            in_transit: "in_transit";
         }>;
         providerKind: z.ZodNullable<z.ZodString>;
         providerTrackingId: z.ZodNullable<z.ZodString>;
@@ -473,26 +473,26 @@ export declare const adminCommerceFulfillmentOrderDetailResponseSchema: z.ZodObj
         payment: z.ZodObject<{
             paymentIntentId: z.ZodGUID;
             paymentStatus: z.ZodEnum<{
-                expired: "expired";
-                created: "created";
+                requires_action: "requires_action";
                 failed: "failed";
                 cancelled: "cancelled";
-                succeeded: "succeeded";
+                created: "created";
+                expired: "expired";
                 refunded: "refunded";
-                requires_action: "requires_action";
+                not_started: "not_started";
                 processing: "processing";
                 partially_refunded: "partially_refunded";
                 disputed: "disputed";
-                not_started: "not_started";
+                succeeded: "succeeded";
             }>;
             providerPaymentId: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
         inventory: z.ZodObject<{
             status: z.ZodEnum<{
-                expired: "expired";
                 missing: "missing";
-                reserved: "reserved";
+                expired: "expired";
                 not_checked: "not_checked";
+                reserved: "reserved";
                 released: "released";
                 consumed: "consumed";
                 review_required: "review_required";
@@ -523,8 +523,8 @@ export declare const adminCommerceFulfillmentOrderDetailResponseSchema: z.ZodObj
         latestOperation: z.ZodNullable<z.ZodObject<{
             id: z.ZodGUID;
             type: z.ZodEnum<{
-                created: "created";
                 cancelled: "cancelled";
+                created: "created";
                 packed: "packed";
                 label_created: "label_created";
                 handed_over: "handed_over";
@@ -544,15 +544,15 @@ export declare const adminCommerceFulfillmentMutationResponseSchema: z.ZodObject
     fulfillmentOrderId: z.ZodGUID;
     orderId: z.ZodGUID;
     status: z.ZodEnum<{
-        created: "created";
-        exception: "exception";
-        delivered: "delivered";
         cancelled: "cancelled";
+        delivered: "delivered";
+        exception: "exception";
+        created: "created";
         packed: "packed";
-        in_transit: "in_transit";
         label_pending: "label_pending";
         label_created: "label_created";
         handed_over: "handed_over";
+        in_transit: "in_transit";
     }>;
     replayed: z.ZodBoolean;
 }, z.core.$strict>;
@@ -574,10 +574,10 @@ export declare const adminCommerceOrderRequestReplacementShipmentRequestSchema:
     idempotencyKey: z.ZodString;
     orderId: z.ZodGUID;
     reason: z.ZodEnum<{
-        other: "other";
         damaged: "damaged";
         lost: "lost";
         returned_undelivered: "returned_undelivered";
+        other: "other";
     }>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
@@ -635,10 +635,10 @@ export declare const adminCommerceOrderRequestReplacementShipmentResponseSchema:
         sequenceNo: z.ZodNumber;
         replacesFulfillmentOrderId: z.ZodString;
         reason: z.ZodEnum<{
-            other: "other";
             damaged: "damaged";
             lost: "lost";
             returned_undelivered: "returned_undelivered";
+            other: "other";
         }>;
         status: z.ZodString;
     }, z.core.$strip>;

package/dist/fulfillment/index.d.ts

@@ -1,7 +1,7 @@
 export { FULFILLMENT_STATUS_MAP, CANONICAL_LOCAL_FULFILLMENT_STATUSES, CUSTOMER_STEP_SEQUENCE, canonicalStatusToken, stepForToken, customerStepFromSignals, phaseIndexForStep, stepLabelKey, timelineLabelForStep, trackingPhaseKeyForStep, stepUsesTruckIcon } from "./statusMap.js";
 export { parseFulfillmentFact, parseFulfillmentTransitionConflict } from "./normalizedFulfillmentFacts.js";
 export { readFulfillmentCapabilities } from "./providerCapabilities.js";
-export { createOutboxOrderPaidFulfillmentHandler } from "./paidHandoff.js";
+export { createOutboxOrderPaidFulfillmentHandler, outboxOrderPaidFulfillmentDescriptor, parseOutboxPayload } from "./paidHandoff.js";
 export { collectPaidFulfillmentRecoveryCandidates } from "./paidFulfillmentRecovery.js";
 export { runFulfillmentDispatchWorker } from "./providerDispatchWorker.js";
 export { createFulfillmentCommandLedger } from "./providerCommandLedger.js";

package/dist/fulfillment/index.js

@@ -1,7 +1,7 @@
 export { FULFILLMENT_STATUS_MAP, CANONICAL_LOCAL_FULFILLMENT_STATUSES, CUSTOMER_STEP_SEQUENCE, canonicalStatusToken, stepForToken, customerStepFromSignals, phaseIndexForStep, stepLabelKey, timelineLabelForStep, trackingPhaseKeyForStep, stepUsesTruckIcon } from "./statusMap.js";
 export { parseFulfillmentFact, parseFulfillmentTransitionConflict } from "./normalizedFulfillmentFacts.js";
 export { readFulfillmentCapabilities } from "./providerCapabilities.js";
-export { createOutboxOrderPaidFulfillmentHandler } from "./paidHandoff.js";
+export { createOutboxOrderPaidFulfillmentHandler, outboxOrderPaidFulfillmentDescriptor, parseOutboxPayload } from "./paidHandoff.js";
 export { collectPaidFulfillmentRecoveryCandidates } from "./paidFulfillmentRecovery.js";
 export { runFulfillmentDispatchWorker } from "./providerDispatchWorker.js";
 export { createFulfillmentCommandLedger } from "./providerCommandLedger.js";

package/dist/fulfillment/paidHandoff.d.ts

@@ -1,5 +1,9 @@
-import type { OutboxHandler } from "@openlup/core/outbox";
+import type { OutboxHandler, OutboxHandlerOutcome } from "@openlup/core/outbox";
 import type { OrderPaidFulfillmentPort } from "./paidHandoffPorts.js";
+export declare const outboxOrderPaidFulfillmentDescriptor: Readonly<{
+    eventType: "commerce.order.paid";
+    timeoutMs: 15000;
+}>;
 interface OrderPaidRiskAssessmentPort {
     assessPaidOrder(input: {
         orderUuid: string;
@@ -24,4 +28,11 @@ export declare function createOutboxOrderPaidFulfillmentHandler(deps: {
     riskPort?: OrderPaidRiskAssessmentPort;
     isRiskEnabled?: () => boolean;
 }): OutboxHandler<AbortSignal>;
+export declare function parseOutboxPayload<T>(schema: import("zod").ZodType<T>, payload: unknown): {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    outcome: OutboxHandlerOutcome;
+};
 export {};

package/dist/fulfillment/paidHandoff.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 const COMMERCE_ORDER_PAID_EVENT_TYPE = "commerce.order.paid";
 const HANDLER_TIMEOUT_MS = 15_000;
-const outboxOrderPaidFulfillmentDescriptor = Object.freeze({
+export const outboxOrderPaidFulfillmentDescriptor = Object.freeze({
     eventType: COMMERCE_ORDER_PAID_EVENT_TYPE, timeoutMs: HANDLER_TIMEOUT_MS,
 });
 // Frozen minimal parse: validate only the orderUuid forwarded to the fulfillment
@@ -77,7 +77,7 @@ export function createOutboxOrderPaidFulfillmentHandler(deps) {
     };
 }
 function truncateReason(value) { return value.length <= 300 ? value : `${value.slice(0, 300)}…`; }
-function parseOutboxPayload(schema, payload) {
+export function parseOutboxPayload(schema, payload) {
     const parsed = schema.safeParse(payload);
     if (parsed.success)
         return { ok: true, data: parsed.data };