@openlup/platform 0.17.0 → 0.19.0

package/dist/shipping/deliverySelectionPort.d.ts

@@ -0,0 +1,8 @@
+import type { DeliveryCarrierKind, DeliveryOption, PickupPoint } from "./contracts/index.js";
+export interface DeliverySelectionPort {
+    listOptions(): Promise<DeliveryOption[]>;
+    validatePickupPoint(input: {
+        pointId: string;
+        carrierKind: DeliveryCarrierKind;
+    }): Promise<PickupPoint | null>;
+}

package/dist/shipping/deliverySelectionPort.js

@@ -0,0 +1 @@
+export {};

package/dist/shipping/deliverySelectionSummary.d.ts

@@ -0,0 +1,2 @@
+import type { DeliverySelectionSummary } from "./contracts/delivery.js";
+export declare function summarizeDeliverySelection(selection: Record<string, unknown> | null | undefined, source?: string | null): DeliverySelectionSummary | null;

package/dist/shipping/deliverySelectionSummary.js

@@ -0,0 +1,53 @@
+export function summarizeDeliverySelection(selection, source = null) {
+    if (!selection)
+        return null;
+    const deliveryKind = readDeliveryKind(selection.deliveryKind ?? selection.kind);
+    if (!deliveryKind)
+        return null;
+    return {
+        deliveryKind,
+        providerKind: text(selection.providerKind),
+        carrierKind: text(selection.carrierKind),
+        carrierCode: text(selection.carrierCode),
+        serviceCode: text(selection.serviceCode ?? selection.service),
+        pickupPoint: deliveryKind === "parcel-locker" ? readPickupPoint(selection.pickupPoint) : null,
+        ...(source ? { source } : {}),
+    };
+}
+function readDeliveryKind(value) {
+    if (value === "courier" || value === "parcel-locker")
+        return value;
+    return null;
+}
+function readPickupPoint(value) {
+    const point = record(value);
+    if (!point)
+        return null;
+    const id = text(point.id ?? point.pointId);
+    const name = text(point.name);
+    if (!id || !name)
+        return null;
+    return {
+        id,
+        name,
+        address: readPickupPointAddress(point.address),
+    };
+}
+function readPickupPointAddress(value) {
+    const address = record(value);
+    if (!address)
+        return null;
+    const line1 = text(address.line1);
+    const postalCode = text(address.postalCode);
+    const city = text(address.city);
+    const country = text(address.country);
+    if (!line1 || !postalCode || !city || !country)
+        return null;
+    return { line1, postalCode, city, country };
+}
+function text(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}

package/dist/shipping/handlerSchemas.d.ts

@@ -0,0 +1,21 @@
+import type { DeliveryOptionsResponse, PickupPointSearchRequest, PickupPointSearchResponse, PickupPointValidationRequest, PickupPointValidationResponse } from "./contracts/index.js";
+type Schema<T> = {
+    safeParse(input: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: {
+            flatten(): unknown;
+        };
+    };
+};
+/** The host supplies its existing validators, including provider policy and errors. */
+export interface DeliverySelectionSchemas {
+    deliveryOptionsResponseSchema: Schema<DeliveryOptionsResponse>;
+    pickupPointValidationRequestSchema: Schema<PickupPointValidationRequest>;
+    pickupPointValidationResponseSchema: Schema<PickupPointValidationResponse>;
+    pickupPointSearchRequestSchema: Schema<PickupPointSearchRequest>;
+    pickupPointSearchResponseSchema: Schema<PickupPointSearchResponse>;
+}
+export {};

package/dist/shipping/handlerSchemas.js

@@ -0,0 +1 @@
+export {};

package/dist/shipping/index.d.ts

@@ -0,0 +1,20 @@
+export type { DeliverySelectionSummaryKind, DeliverySelectionSummary, DeliverySelectionSourceKey, DeliverySelectionSources, DeliverySelectionEvidence, } from "./contracts/delivery.js";
+export type { DeliverySelectionPort } from "./deliverySelectionPort.js";
+export type { PickupPointSearchPort } from "./pickupPointSearchPort.js";
+export type { DeliverySelectionSchemas } from "./handlerSchemas.js";
+export { createDeliveryOptionsHandler, createPickupPointSearchHandler, createPickupPointValidationHandler, DELIVERY_SELECTION_CONTRACT_VERSION, PICKUP_POINT_SEARCH_CONTRACT_VERSION, } from "./deliverySelectionHandler.js";
+export { summarizeDeliverySelection } from "./deliverySelectionSummary.js";
+export { resolveDeliverySelectionEvidence } from "./readDeliverySelectionEvidence.js";
+export type { CanonicalAddressInput } from "./contracts/address.js";
+export type { AddressCanonLookupPort, AddressCanonLookupDeps, CustomerAddressesDeps, CustomerAddressBookPort, CustomerAddressMutationPort, CustomerAddressReadStore } from "./addressPorts.js";
+export type { AddressLookupSchemas, CustomerAddressSchemas } from "./addressSchemas.js";
+export { createAddressCanonPostalCodeHandler, createAddressCanonLocalitiesHandler, createAddressCanonStreetsHandler } from "./addressCanonLookupHandler.js";
+export { createCustomerAddressesHandler } from "./customerAddressesHandler.js";
+export { canonicalAddressKey } from "./addressCanonical.js";
+export { readAddresses, readOrdererProfiles, addressUsedByActiveSubscription, addressRow, findCanonicalAddressId, clearDefaultAddress } from "./customerSelfServiceAddressModels.js";
+export type { AdminShippingRateResponse, AdminSetShippingRateRequest, AdminSetShippingRateResponse } from "./contracts/shippingRate.js";
+export { createAdminShippingRateHandler } from "./adminShippingRateHandler.js";
+export type { AdminShippingRateHandlerDeps, ShippingRateDataPort, ShippingRateHandlerSchemas } from "./shippingRatePorts.js";
+export { createShippingBindings, type ShippingBindingDependencies, type ShippingBindings } from "./bindings.js";
+export type { ShippingTerms, ShippingPolicyEntry, ShippingPolicy, ShippingSettings } from "./contracts/threshold.js";
+export { shippingTermsSchema, shippingPolicySchema, parseShippingTerms, hasShippingTerms, normalizeShippingPolicy, resolveShippingPolicy, resolveThresholdShipping } from "./thresholdPolicy.js";

package/dist/shipping/index.js

@@ -0,0 +1,10 @@
+export { createDeliveryOptionsHandler, createPickupPointSearchHandler, createPickupPointValidationHandler, DELIVERY_SELECTION_CONTRACT_VERSION, PICKUP_POINT_SEARCH_CONTRACT_VERSION, } from "./deliverySelectionHandler.js";
+export { summarizeDeliverySelection } from "./deliverySelectionSummary.js";
+export { resolveDeliverySelectionEvidence } from "./readDeliverySelectionEvidence.js";
+export { createAddressCanonPostalCodeHandler, createAddressCanonLocalitiesHandler, createAddressCanonStreetsHandler } from "./addressCanonLookupHandler.js";
+export { createCustomerAddressesHandler } from "./customerAddressesHandler.js";
+export { canonicalAddressKey } from "./addressCanonical.js";
+export { readAddresses, readOrdererProfiles, addressUsedByActiveSubscription, addressRow, findCanonicalAddressId, clearDefaultAddress } from "./customerSelfServiceAddressModels.js";
+export { createAdminShippingRateHandler } from "./adminShippingRateHandler.js";
+export { createShippingBindings } from "./bindings.js";
+export { shippingTermsSchema, shippingPolicySchema, parseShippingTerms, hasShippingTerms, normalizeShippingPolicy, resolveShippingPolicy, resolveThresholdShipping } from "./thresholdPolicy.js";

package/dist/shipping/pickupPointSearchPort.d.ts

@@ -0,0 +1,4 @@
+import type { PickupPointSearchRequest, PickupPointSearchResult } from "./contracts/index.js";
+export interface PickupPointSearchPort {
+    searchPickupPoints(request: PickupPointSearchRequest): Promise<PickupPointSearchResult[]>;
+}

package/dist/shipping/pickupPointSearchPort.js

@@ -0,0 +1 @@
+export {};

package/dist/shipping/readDeliverySelectionEvidence.d.ts

@@ -0,0 +1,2 @@
+import type { DeliverySelectionEvidence, DeliverySelectionSources } from "./contracts/delivery.js";
+export declare function resolveDeliverySelectionEvidence(sources: DeliverySelectionSources): DeliverySelectionEvidence;

package/dist/shipping/readDeliverySelectionEvidence.js

@@ -0,0 +1,44 @@
+function asRecord(value) {
+    if (Array.isArray(value))
+        return asRecord(value[0]);
+    return value && typeof value === "object" ? value : null;
+}
+function normalizeProviderKind(selection) {
+    const providerKind = selection?.providerKind;
+    return typeof providerKind === "string" && providerKind.trim()
+        ? providerKind.trim().toLowerCase()
+        : null;
+}
+// New-format order/parcel contacts are authoritative. The wider historical
+// ladder remains below them so old rows stay readable without letting a mutable
+// address-book selection replace a frozen provider request.
+export function resolveDeliverySelectionEvidence(sources) {
+    const orderMetadata = asRecord(sources.orderMetadata);
+    const runtimeFinalize = asRecord(orderMetadata?.runtimeFinalize);
+    const shippingSnapshot = asRecord(sources.shippingAddressSnapshot);
+    const canonical = [
+        ["shippingDeliveryContact", shippingSnapshot?.deliveryContact],
+        ["orderDeliveryContactOverride", orderMetadata?.deliveryContactOverride],
+        ["orderDeliveryContact", runtimeFinalize?.deliveryContact],
+    ];
+    for (const [source, contactValue] of canonical) {
+        if (contactValue === undefined || contactValue === null)
+            continue;
+        const selection = asRecord(asRecord(contactValue)?.selectedDelivery);
+        return { selection, providerKind: normalizeProviderKind(selection), source };
+    }
+    const legacy = [
+        ["fulfillmentMetadata", asRecord(sources.fulfillmentMetadata)?.selectedDelivery],
+        ["orderMetadata", orderMetadata?.selectedDelivery],
+        ["orderRuntimeFinalize", runtimeFinalize?.selectedDelivery],
+        ["shippingAddressSnapshot", shippingSnapshot?.selectedDelivery],
+        ["addressMetadata", asRecord(sources.addressMetadata)?.selectedDelivery],
+    ];
+    for (const [source, candidate] of legacy) {
+        const selection = asRecord(candidate);
+        if (selection) {
+            return { selection, providerKind: normalizeProviderKind(selection), source };
+        }
+    }
+    return { selection: null, providerKind: null, source: null };
+}

package/dist/shipping/shippingRatePorts.d.ts

@@ -0,0 +1,52 @@
+import type { HttpResponse } from "../http/index.js";
+import type { AdminShippingRateResponse, AdminSetShippingRateRequest, AdminSetShippingRateResponse } from "./contracts/shippingRate.js";
+/** Only the incumbent flat-rate reads, writes and best-effort audit. */
+export interface ShippingRateDataPort {
+    getShippingFlatMinor(): Promise<number>;
+    setShippingFlatMinor(minor: number): Promise<void>;
+    recordPromotionAudit(entry: {
+        actorId: string;
+        actorEmail: string | null;
+        action: "shipping_rate_change";
+        promotionId: string;
+        newValue: Record<string, unknown>;
+    }): Promise<void>;
+}
+type Authorization = {
+    ok: true;
+    userId: string;
+    role: "admin" | "distributor";
+    isMachineActor: boolean;
+} | {
+    ok: false;
+    code: "UNAUTHORIZED" | "FORBIDDEN";
+    message: string;
+    identityCode?: string;
+};
+export interface AdminShippingRateHandlerDeps {
+    dataPort: ShippingRateDataPort;
+    authorizeAdmin: () => Promise<Authorization>;
+    /** The host retains its authorization/error response context. */
+    resolveAdmin: (authorizeAdmin: () => Promise<Authorization>, res: HttpResponse) => Promise<{
+        userId: string;
+    } | null>;
+}
+type Schema<T> = {
+    safeParse(input: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: {
+            flatten(): unknown;
+        };
+    };
+};
+/** Required host validation; there is no default amount policy. */
+export interface ShippingRateHandlerSchemas {
+    contractVersion: AdminShippingRateResponse["contractVersion"];
+    adminShippingRateResponseSchema: Schema<AdminShippingRateResponse>;
+    adminSetShippingRateRequestSchema: Schema<AdminSetShippingRateRequest>;
+    adminSetShippingRateResponseSchema: Schema<AdminSetShippingRateResponse>;
+}
+export {};

package/dist/shipping/shippingRatePorts.js

@@ -0,0 +1 @@
+export {};

package/dist/shipping/thresholdPolicy.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import type { ShippingPolicy, ShippingSettings, ShippingTerms } from "./contracts/threshold.js";
+export declare const shippingTermsSchema: z.ZodObject<{
+    version: z.ZodLiteral<"shipping-threshold.v1">;
+    currency: z.ZodString;
+    flatMinor: z.ZodNumber;
+    freeThresholdMinor: z.ZodNumber;
+}, z.core.$strict>;
+export declare const shippingPolicySchema: z.ZodObject<{
+    version: z.ZodLiteral<"shipping-policy.v1">;
+    current: z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        flatMinor: z.ZodNumber;
+        freeThresholdMinor: z.ZodNumber;
+        effectiveFrom: z.ZodString;
+    }, z.core.$strict>>;
+    scheduled: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        flatMinor: z.ZodNumber;
+        freeThresholdMinor: z.ZodNumber;
+        effectiveFrom: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/** Absence selects legacy behavior; malformed retained promises refuse. */
+export declare function parseShippingTerms(value: unknown): ShippingTerms | undefined;
+export declare function hasShippingTerms(quote: {
+    context?: {
+        shippingTerms?: unknown;
+    };
+}): boolean;
+/** Resolve effective entries on read, without a scheduled write. */
+export declare function normalizeShippingPolicy(policy: ShippingPolicy, asOf: Date | string): ShippingPolicy;
+export declare function resolveShippingPolicy(settings: ShippingSettings, asOf: Date | string, currency: string): {
+    configured: boolean;
+    flatMinor: number;
+    terms?: ShippingTerms;
+};
+/** Only product payable after discounts counts; equality receives free delivery. */
+export declare function resolveThresholdShipping(terms: ShippingTerms, productPayableMinor: number): {
+    grossMinor: number;
+    remainingMinor: number;
+};

package/dist/shipping/thresholdPolicy.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+const minorSchema = z.number().int().nonnegative().max(2_147_483_647);
+const instantSchema = z.string().datetime({ offset: true }).refine((value) => {
+    const [year, month, day] = value.slice(0, 10).split("-").map(Number);
+    const days = new Date(Date.UTC(year, month, 0)).getUTCDate();
+    return day <= days && Number.isFinite(Date.parse(value));
+}, "Invalid calendar date");
+export const shippingTermsSchema = z.object({
+    version: z.literal("shipping-threshold.v1"),
+    currency: z.string().regex(/^[A-Z]{3}$/),
+    flatMinor: minorSchema,
+    freeThresholdMinor: minorSchema,
+}).strict();
+const entrySchema = z.object({
+    enabled: z.boolean(), flatMinor: minorSchema, freeThresholdMinor: minorSchema,
+    effectiveFrom: instantSchema,
+}).strict();
+export const shippingPolicySchema = z.object({
+    version: z.literal("shipping-policy.v1"),
+    current: entrySchema.nullable(), scheduled: entrySchema.nullable().optional(),
+}).strict().refine((policy) => !policy.current || !policy.scheduled ||
+    Date.parse(policy.current.effectiveFrom) < Date.parse(policy.scheduled.effectiveFrom), "Scheduled policy must follow current policy");
+/** Absence selects legacy behavior; malformed retained promises refuse. */
+export function parseShippingTerms(value) {
+    return value === undefined ? undefined : shippingTermsSchema.parse(value);
+}
+export function hasShippingTerms(quote) {
+    return quote.context?.shippingTerms !== undefined;
+}
+/** Resolve effective entries on read, without a scheduled write. */
+export function normalizeShippingPolicy(policy, asOf) {
+    const parsed = shippingPolicySchema.parse(policy);
+    const now = new Date(asOf).getTime();
+    if (!Number.isFinite(now))
+        throw new Error("shipping_policy_invalid_as_of");
+    const entries = [parsed.current, parsed.scheduled].filter((entry) => !!entry);
+    const effective = entries.filter((entry) => Date.parse(entry.effectiveFrom) <= now);
+    const future = entries.filter((entry) => Date.parse(entry.effectiveFrom) > now);
+    if (future.length > 1)
+        throw new Error("shipping_policy_multiple_scheduled_changes");
+    return { version: parsed.version, current: effective[effective.length - 1] ?? null, scheduled: future[0] ?? null };
+}
+export function resolveShippingPolicy(settings, asOf, currency) {
+    if (settings.policy === null)
+        return { configured: false, flatMinor: minorSchema.parse(settings.legacyFlatMinor) };
+    const { current } = normalizeShippingPolicy(settings.policy, asOf);
+    if (!current?.enabled)
+        return { configured: true, flatMinor: 0 };
+    const terms = shippingTermsSchema.parse({
+        version: "shipping-threshold.v1", currency,
+        flatMinor: current.flatMinor, freeThresholdMinor: current.freeThresholdMinor,
+    });
+    return { configured: true, flatMinor: terms.flatMinor, terms };
+}
+/** Only product payable after discounts counts; equality receives free delivery. */
+export function resolveThresholdShipping(terms, productPayableMinor) {
+    const payable = minorSchema.parse(productPayableMinor);
+    const remainingMinor = Math.max(0, terms.freeThresholdMinor - payable);
+    return { grossMinor: remainingMinor > 0 ? terms.flatMinor : 0, remainingMinor };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlup/platform",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "private": false,
   "description": "Runnable server substrate: Node HTTP runtime, BFF dispatch, scheduler, storage, data gateways and bundle composition; development preview.",
   "license": "Apache-2.0",
@@ -31,7 +31,7 @@
     "api:update": "npm run build && node --experimental-strip-types ./scripts/api-contract.ts --update"
   },
   "peerDependencies": {
-    "@openlup/core": "0.17.0",
+    "@openlup/core": "0.19.0",
     "pg": "^8.22.0",
     "@aws-sdk/client-s3": "^3.1144.0",
     "@types/pg": "^8.20.0"
@@ -115,6 +115,66 @@
       "types": "./dist/communications/contracts/index.d.ts",
       "import": "./dist/communications/contracts/index.js",
       "default": "./dist/communications/contracts/index.js"
+    },
+    "./catalog": {
+      "types": "./dist/catalog/index.d.ts",
+      "import": "./dist/catalog/index.js",
+      "default": "./dist/catalog/index.js"
+    },
+    "./catalog/contracts": {
+      "types": "./dist/catalog/contracts/index.d.ts",
+      "import": "./dist/catalog/contracts/index.js",
+      "default": "./dist/catalog/contracts/index.js"
+    },
+    "./pricing": {
+      "types": "./dist/pricing/index.d.ts",
+      "import": "./dist/pricing/index.js",
+      "default": "./dist/pricing/index.js"
+    },
+    "./pricing/contracts": {
+      "types": "./dist/pricing/contracts/index.d.ts",
+      "import": "./dist/pricing/contracts/index.js",
+      "default": "./dist/pricing/contracts/index.js"
+    },
+    "./promotions": {
+      "types": "./dist/promotions/index.d.ts",
+      "import": "./dist/promotions/index.js",
+      "default": "./dist/promotions/index.js"
+    },
+    "./promotions/contracts": {
+      "types": "./dist/promotions/contracts/index.d.ts",
+      "import": "./dist/promotions/contracts/index.js",
+      "default": "./dist/promotions/contracts/index.js"
+    },
+    "./communications/resend": {
+      "types": "./dist/communications/resend/index.d.ts",
+      "import": "./dist/communications/resend/index.js",
+      "default": "./dist/communications/resend/index.js"
+    },
+    "./communications/klaviyo": {
+      "types": "./dist/communications/klaviyo/index.d.ts",
+      "import": "./dist/communications/klaviyo/index.js",
+      "default": "./dist/communications/klaviyo/index.js"
+    },
+    "./inventory": {
+      "types": "./dist/inventory/index.d.ts",
+      "import": "./dist/inventory/index.js",
+      "default": "./dist/inventory/index.js"
+    },
+    "./inventory/contracts": {
+      "types": "./dist/inventory/contracts/index.d.ts",
+      "import": "./dist/inventory/contracts/index.js",
+      "default": "./dist/inventory/contracts/index.js"
+    },
+    "./shipping": {
+      "types": "./dist/shipping/index.d.ts",
+      "import": "./dist/shipping/index.js",
+      "default": "./dist/shipping/index.js"
+    },
+    "./shipping/contracts": {
+      "types": "./dist/shipping/contracts/index.d.ts",
+      "import": "./dist/shipping/contracts/index.js",
+      "default": "./dist/shipping/contracts/index.js"
     }
   },
   "repository": {