@openlup/platform 0.25.0 → 0.27.0

package/dist/communications/newsletterIntegrationContracts.d.ts

@@ -22,6 +22,7 @@ export declare const newsletterSyncEventTypeSchema: z.ZodEnum<{
 }>;
 export declare const newsletterWebhookEventTypeSchema: z.ZodEnum<{
     update: "update";
+    ignored: "ignored";
     email_change: "email_change";
     subscribe: "subscribe";
     unsubscribe: "unsubscribe";
@@ -29,7 +30,6 @@ export declare const newsletterWebhookEventTypeSchema: z.ZodEnum<{
     complaint: "complaint";
     bounce: "bounce";
     profile_update: "profile_update";
-    ignored: "ignored";
 }>;
 export declare const newsletterProviderCapabilitiesSchema: z.ZodObject<{
     subscribe: z.ZodBoolean;
@@ -47,6 +47,7 @@ export declare const canonicalNewsletterWebhookEventSchema: z.ZodObject<{
     providerEventId: z.ZodString;
     eventType: z.ZodEnum<{
         update: "update";
+        ignored: "ignored";
         email_change: "email_change";
         subscribe: "subscribe";
         unsubscribe: "unsubscribe";
@@ -54,7 +55,6 @@ export declare const canonicalNewsletterWebhookEventSchema: z.ZodObject<{
         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>>;
@@ -86,6 +86,7 @@ export declare function createNewsletterIntegrationSchemas<Purpose extends strin
         providerEventId: z.ZodString;
         eventType: z.ZodEnum<{
             update: "update";
+            ignored: "ignored";
             email_change: "email_change";
             subscribe: "subscribe";
             unsubscribe: "unsubscribe";
@@ -93,7 +94,6 @@ export declare function createNewsletterIntegrationSchemas<Purpose extends strin
             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>>;

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,4 @@ 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";

package/dist/composition/index.js

@@ -7,3 +7,4 @@ 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";

package/dist/fulfillment/handlerSchemas.d.ts

@@ -5,14 +5,14 @@ export declare const COMMERCE_FULFILLMENT_OPERATION_TYPES: readonly ["created",
 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";
     packed: "packed";
-    in_transit: "in_transit";
     label_pending: "label_pending";
     label_created: "label_created";
     handed_over: "handed_over";
+    in_transit: "in_transit";
+    exception: "exception";
 }>;
 export declare const commerceFulfillmentOperationTypeSchema: z.ZodEnum<{
     created: "created";
@@ -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";
     failed: "failed";
     cancelled: "cancelled";
-    succeeded: "succeeded";
     refunded: "refunded";
+    not_started: "not_started";
     requires_action: "requires_action";
     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";
     not_checked: "not_checked";
+    reserved: "reserved";
+    missing: "missing";
     released: "released";
     consumed: "consumed";
     review_required: "review_required";
@@ -86,22 +86,22 @@ export declare const commerceFulfillmentPaymentSummarySchema: z.ZodObject<{
         created: "created";
         failed: "failed";
         cancelled: "cancelled";
-        succeeded: "succeeded";
         refunded: "refunded";
+        not_started: "not_started";
         requires_action: "requires_action";
         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";
         not_checked: "not_checked";
+        reserved: "reserved";
+        missing: "missing";
         released: "released";
         consumed: "consumed";
         review_required: "review_required";
@@ -150,14 +150,14 @@ export declare const commerceFulfillmentOrderSchema: z.ZodObject<{
     clientId: z.ZodNullable<z.ZodGUID>;
     status: z.ZodEnum<{
         created: "created";
-        exception: "exception";
-        delivered: "delivered";
         cancelled: "cancelled";
+        delivered: "delivered";
         packed: "packed";
-        in_transit: "in_transit";
         label_pending: "label_pending";
         label_created: "label_created";
         handed_over: "handed_over";
+        in_transit: "in_transit";
+        exception: "exception";
     }>;
     providerKind: z.ZodNullable<z.ZodString>;
     providerTrackingId: z.ZodNullable<z.ZodString>;
@@ -188,22 +188,22 @@ export declare const commerceFulfillmentOrderSchema: z.ZodObject<{
             created: "created";
             failed: "failed";
             cancelled: "cancelled";
-            succeeded: "succeeded";
             refunded: "refunded";
+            not_started: "not_started";
             requires_action: "requires_action";
             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";
             not_checked: "not_checked";
+            reserved: "reserved";
+            missing: "missing";
             released: "released";
             consumed: "consumed";
             review_required: "review_required";
@@ -254,14 +254,14 @@ export declare const adminCommerceFulfillmentOrdersListRequestSchema: z.ZodObjec
     pageSize: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     status: z.ZodOptional<z.ZodEnum<{
         created: "created";
-        exception: "exception";
-        delivered: "delivered";
         cancelled: "cancelled";
+        delivered: "delivered";
         packed: "packed";
-        in_transit: "in_transit";
         label_pending: "label_pending";
         label_created: "label_created";
         handed_over: "handed_over";
+        in_transit: "in_transit";
+        exception: "exception";
     }>>;
 }, 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,9 +306,9 @@ export declare const adminCommerceFulfillmentTrackingEventRequestSchema: z.ZodOb
     idempotencyKey: z.ZodString;
     fulfillmentOrderId: z.ZodGUID;
     status: z.ZodEnum<{
-        exception: "exception";
         delivered: "delivered";
         in_transit: "in_transit";
+        exception: "exception";
     }>;
     providerTrackingId: z.ZodOptional<z.ZodString>;
     rawEvent: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -328,14 +328,14 @@ export declare const adminCommerceFulfillmentOrdersListResponseSchema: z.ZodObje
         clientId: z.ZodNullable<z.ZodGUID>;
         status: z.ZodEnum<{
             created: "created";
-            exception: "exception";
-            delivered: "delivered";
             cancelled: "cancelled";
+            delivered: "delivered";
             packed: "packed";
-            in_transit: "in_transit";
             label_pending: "label_pending";
             label_created: "label_created";
             handed_over: "handed_over";
+            in_transit: "in_transit";
+            exception: "exception";
         }>;
         providerKind: z.ZodNullable<z.ZodString>;
         providerTrackingId: z.ZodNullable<z.ZodString>;
@@ -366,22 +366,22 @@ export declare const adminCommerceFulfillmentOrdersListResponseSchema: z.ZodObje
                 created: "created";
                 failed: "failed";
                 cancelled: "cancelled";
-                succeeded: "succeeded";
                 refunded: "refunded";
+                not_started: "not_started";
                 requires_action: "requires_action";
                 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";
                 not_checked: "not_checked";
+                reserved: "reserved";
+                missing: "missing";
                 released: "released";
                 consumed: "consumed";
                 review_required: "review_required";
@@ -439,14 +439,14 @@ export declare const adminCommerceFulfillmentOrderDetailResponseSchema: z.ZodObj
         clientId: z.ZodNullable<z.ZodGUID>;
         status: z.ZodEnum<{
             created: "created";
-            exception: "exception";
-            delivered: "delivered";
             cancelled: "cancelled";
+            delivered: "delivered";
             packed: "packed";
-            in_transit: "in_transit";
             label_pending: "label_pending";
             label_created: "label_created";
             handed_over: "handed_over";
+            in_transit: "in_transit";
+            exception: "exception";
         }>;
         providerKind: z.ZodNullable<z.ZodString>;
         providerTrackingId: z.ZodNullable<z.ZodString>;
@@ -477,22 +477,22 @@ export declare const adminCommerceFulfillmentOrderDetailResponseSchema: z.ZodObj
                 created: "created";
                 failed: "failed";
                 cancelled: "cancelled";
-                succeeded: "succeeded";
                 refunded: "refunded";
+                not_started: "not_started";
                 requires_action: "requires_action";
                 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";
                 not_checked: "not_checked";
+                reserved: "reserved";
+                missing: "missing";
                 released: "released";
                 consumed: "consumed";
                 review_required: "review_required";
@@ -545,14 +545,14 @@ export declare const adminCommerceFulfillmentMutationResponseSchema: z.ZodObject
     orderId: z.ZodGUID;
     status: z.ZodEnum<{
         created: "created";
-        exception: "exception";
-        delivered: "delivered";
         cancelled: "cancelled";
+        delivered: "delivered";
         packed: "packed";
-        in_transit: "in_transit";
         label_pending: "label_pending";
         label_created: "label_created";
         handed_over: "handed_over";
+        in_transit: "in_transit";
+        exception: "exception";
     }>;
     replayed: z.ZodBoolean;
 }, z.core.$strict>;

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

package/dist/fulfillment/providerDispatchWorker.d.ts

@@ -33,7 +33,7 @@ export declare function runFulfillmentDispatchWorker(input: {
     skipped: boolean;
     checked: number;
     updated: number;
-    mode: "shadow" | "stage" | "live";
+    mode: "stage" | "shadow" | "live";
     replayed: number;
     providerCalls: number;
     readBacks: number;
@@ -51,7 +51,7 @@ export declare function runFulfillmentDispatchWorker(input: {
     skipped: boolean;
     checked: number;
     updated: number;
-    mode: "shadow" | "stage" | "live";
+    mode: "stage" | "shadow" | "live";
     replayed: number;
     providerCalls: number;
     readBacks: number;
@@ -62,7 +62,7 @@ export declare function runFulfillmentDispatchWorker(input: {
     checked: number;
     updated: number;
     failures: number;
-    mode: "shadow" | "stage" | "live";
+    mode: "stage" | "shadow" | "live";
     replayed: number;
     providerCalls: number;
     readBacks: number;
@@ -74,7 +74,7 @@ export declare function runFulfillmentDispatchWorker(input: {
     checked: number;
     updated: number;
     failures: number;
-    mode: "shadow" | "stage" | "live";
+    mode: "stage" | "shadow" | "live";
     replayed: number;
     providerCalls: number;
     readBacks: number;

package/dist/identity/customerContracts.d.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 export declare const customerLifecycleStageSchema: z.ZodEnum<{
     inactive: "inactive";
+    customer: "customer";
     lead: "lead";
     tester: "tester";
-    customer: "customer";
 }>;
 export declare const customerMeRequestSchema: z.ZodObject<{}, z.core.$strict>;
 export declare const customerMeResponseSchema: z.ZodObject<{
@@ -13,9 +13,9 @@ export declare const customerMeResponseSchema: z.ZodObject<{
     lastName: z.ZodNullable<z.ZodString>;
     lifecycleStage: z.ZodEnum<{
         inactive: "inactive";
+        customer: "customer";
         lead: "lead";
         tester: "tester";
-        customer: "customer";
     }>;
     subscriptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         subscriptionId: z.ZodGUID;

package/dist/inventory/bindings.d.ts

@@ -1,3 +1,4 @@
+import { type ManagedStockRpc } from "./managedStockAvailability.js";
 import type { z } from "zod";
 import type { InventoryMutationPort, InventoryReadPort } from "./ports.js";
 import type { NewPurchaseStockReadPort } from "./newPurchaseStockAvailability.js";
@@ -17,6 +18,8 @@ export interface InventoryBindingDependencies {
         mutationPort: InventoryMutationPort;
     } | null;
     newPurchaseStockReadPort?: NewPurchaseStockReadPort | null;
+    stockSourceKey?: string;
+    stockRpc?: ManagedStockRpc;
     now?: () => string;
 }
 export interface InventoryBindings {

package/dist/inventory/bindings.js

@@ -1,4 +1,6 @@
+import { createManagedStockAvailability } from "./managedStockAvailability.js";
 import { createPostgresAdminInventoryPort } from "./adminInventory.js";
+import { createPostgresStockAvailability } from "./postgresStockAvailability.js";
 import { createInventorySubscriptionForecastResponseSchema } from "./schemas.js";
 /** Select one store only. Factories declare bindings, never discover or activate a host. */
 export function createInventoryBindings(deps) {
@@ -9,24 +11,28 @@ export function createInventoryBindings(deps) {
     if (!deps.provider?.providerSchema?.safeParse(deps.provider.stockMasterProvider).success)
         return refused("inventory_provider_mismatch");
     let readPort, mutationPort;
+    let stockRead;
     if (deps.dataKind === "postgres") {
         if (!deps.executor || typeof deps.executor.query !== "function")
             return refused("inventory_executor_required");
         readPort = mutationPort = createPostgresAdminInventoryPort(deps.executor, deps.provider, deps.now);
+        stockRead = deps.stockSourceKey?.trim()
+            ? createPostgresStockAvailability(deps.executor, { sourceKey: deps.stockSourceKey, now: deps.now ?? (() => new Date().toISOString()) }).readPort
+            : null;
     }
     else if (deps.dataKind === "supabase") {
         const store = deps.createManagedStore?.(deps.provider);
         if (!store)
             return refused("inventory_managed_store_required");
         ({ readPort, mutationPort } = store);
+        stockRead = deps.newPurchaseStockReadPort ?? (deps.stockRpc
+            ? createManagedStockAvailability(deps.stockRpc, { now: deps.now ?? (() => new Date().toISOString()) }) : null);
     }
     else
         return refused("inventory_store_incompatible");
     if (![readPort?.listStock, readPort?.listReservations, readPort?.checkAtp, readPort?.forecastSubscriptions, mutationPort?.adjustStock].every(fn => typeof fn === "function"))
         return refused("inventory_store_incompatible");
     const responseSchema = createInventorySubscriptionForecastResponseSchema(deps.provider.providerSchema);
-    const native = deps.dataKind === "postgres";
-    const stockRead = native ? null : deps.newPurchaseStockReadPort;
     const newPurchaseStockReadPort = typeof stockRead?.read === "function" ? stockRead : null;
     return {
         readPort: {
@@ -38,8 +44,8 @@ export function createInventoryBindings(deps) {
         mutationPort, newPurchaseStockReadPort,
         readiness: { ready: true, reason: null },
         unsupported: {
-            newPurchaseStockRead: native ? "inventory_native_new_purchase_stock_read_unsupported"
-                : newPurchaseStockReadPort ? null : "inventory_new_purchase_stock_reader_required",
+            newPurchaseStockRead: newPurchaseStockReadPort ? null : deps.dataKind === "postgres"
+                ? "inventory_stock_source_key_required" : "inventory_new_purchase_stock_reader_required",
         },
     };
 }

package/dist/inventory/index.d.ts

@@ -14,3 +14,4 @@ export { INVENTORY_MIGRATIONS } from "./sql.js";
 export { createInventoryBindings, type InventoryBindingDependencies, type InventoryBindings } from "./bindings.js";
 export { createPostgresStockAvailability } from "./postgresStockAvailability.js";
 export type { NativeStockPromise } from "./postgresStockAvailability.js";
+export { createManagedStockAvailability, type ManagedStockRpc } from "./managedStockAvailability.js";

package/dist/inventory/index.js

@@ -10,3 +10,4 @@ export { calculateSubscriptionForecastSkus, calculateSubscriptionForecastTotals
 export { INVENTORY_MIGRATIONS } from "./sql.js";
 export { createInventoryBindings } from "./bindings.js";
 export { createPostgresStockAvailability } from "./postgresStockAvailability.js";
+export { createManagedStockAvailability } from "./managedStockAvailability.js";

package/dist/inventory/managedStockAvailability.d.ts

@@ -0,0 +1,15 @@
+import type { NewPurchaseStockReadPort } from "./newPurchaseStockAvailability.js";
+/** Minimal service-role RPC seam; transport and credentials remain host-owned. */
+export interface ManagedStockRpc {
+    rpc(name: string, args: Record<string, unknown>): PromiseLike<{
+        data: unknown;
+        error: {
+            message: string;
+            code?: string;
+        } | null;
+    }>;
+}
+/** Read-only managed ATP preview with fixed subscription priority. */
+export declare function createManagedStockAvailability(client: ManagedStockRpc, options: {
+    now: () => string;
+}): NewPurchaseStockReadPort;

package/dist/inventory/managedStockAvailability.js

@@ -0,0 +1,16 @@
+import { parseStockReadResponse } from "./stockReadResponse.js";
+/** Read-only managed ATP preview with fixed subscription priority. */
+export function createManagedStockAvailability(client, options) {
+    return {
+        async read(input) {
+            if (input.horizonDays !== 14 || input.excludeOrderId !== null)
+                throw new Error("managed_stock_read_options_unsupported");
+            if (!input.skus.length)
+                return new Map();
+            const { data, error } = await client.rpc("inventory_new_purchase_stock_read", { p_skus: input.skus, p_as_of: options.now() });
+            if (error)
+                throw error;
+            return parseStockReadResponse(data);
+        },
+    };
+}