@aglyn/aglyn 1.0.0-beta.232 → 1.0.0-beta.233

package/src/lib/plugin-manager/plugin-checkout-credits.d.ts

@@ -0,0 +1,288 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Money another plugin honors at checkout and at the register (AGL-3640).
+ *
+ * A rewards balance, store credit and a friend's referral credit are all the
+ * same thing to a seller: a code the buyer brings that pays part of the sale
+ * from an account the SELLER does not keep. The plugin that keeps the account
+ * registers a provider here; the seller asks it, by code, how much the account
+ * can give, reserves that much while an online buyer pays, and takes it in the
+ * same transaction that writes the sale. The seller never reads the provider's
+ * documents and the provider never reads the seller's: the sale records which
+ * provider paid what, under the provider's own opaque `reference`, and the
+ * seller's order events carry that onward.
+ *
+ * ## Money
+ *
+ * Integer cents in the sale's currency, always. A provider answers what it
+ * CAN give and the seller never takes more than that.
+ *
+ *   - Online, the seller {@link PluginCheckoutCreditProvider.hold | holds}
+ *     before the payment processor is asked, so a shortfall is a refusal and
+ *     not an apology. The hold is keyed by the checkout attempt, so a retry
+ *     re-places the same hold rather than a second one, and it lapses on its
+ *     own if the checkout is abandoned and nobody releases it.
+ *   - When the sale is written, the seller {@link PluginCheckoutCreditProvider.stage | stages}
+ *     the account INSIDE its own transaction: the provider reads (and only
+ *     reads) what it needs, and the stage's `debit` writes the redemption in
+ *     the same commit as the sale. A sale that is not written takes nothing;
+ *     a redemption is never written without its sale.
+ *   - A refund gives back through {@link PluginCheckoutCreditProvider.restore | restore},
+ *     idempotent per key, so a retried refund restores once.
+ *
+ * ## Nobody home
+ *
+ * With no provider registered, or none offered on a site, the seller shows no
+ * field and sells exactly as it did before. Every reader here that a seller
+ * calls on a sale path is safe to call with nothing registered.
+ *
+ * Import this module by its own subpath
+ * (`@aglyn/aglyn/plugin-manager/plugin-checkout-credits`); it is not in the
+ * barrel.
+ */
+/** Where the sale happens. */
+export type CheckoutCreditChannel = 'online' | 'pos';
+/**
+ * A server transaction as a provider uses it: the Admin SDK's shape, typed
+ * structurally so the platform names no database SDK. Every `get` happens
+ * before any write, as the database requires.
+ */
+export interface CheckoutCreditTransaction {
+    get(ref: any): Promise<any>;
+    set(ref: any, data: any, options?: any): unknown;
+    update(ref: any, data: any): unknown;
+    create(ref: any, data: any): unknown;
+}
+/** A provider's refusal, in words the buyer or the cashier can read. */
+export interface CheckoutCreditRefusal {
+    ok: false;
+    /** 400 for a bad code, 404 for an unknown one, 409 for an empty or busy one. */
+    status: number;
+    error: string;
+}
+/** The account a code names. */
+export interface CheckoutCreditAccount {
+    ok: true;
+    /**
+     * The provider's own handle on the account, stored on the sale and handed
+     * back to it later. Never shown to a buyer and never a bearer secret.
+     * {@link CHECKOUT_CREDIT_REFERENCE} holds its shape.
+     */
+    reference: string;
+    /** What the buyer and the receipt call it: `Rewards`, `Referral credit`. */
+    label: string;
+    /** The last characters of the code, for the register and the receipt. */
+    last4: string;
+    /** What the account could give right now, integer cents. */
+    availableCents: number;
+    /** One line for the cashier: `1,250 points and $5.00 store credit`. */
+    detail?: string;
+}
+/**
+ * The account as the seller's transaction read it. The provider builds it in
+ * {@link PluginCheckoutCreditProvider.stage}, which reads; its methods only
+ * WRITE, through the same transaction, so the redemption commits with the sale
+ * or not at all.
+ */
+export interface CheckoutCreditStage {
+    /**
+     * What the account may give now, honoring every live hold except the one
+     * the stage was opened for (that one is this sale's own).
+     */
+    availableCents: number;
+    /**
+     * Takes up to `cents` and returns what was taken: never more than
+     * `availableCents` plus this sale's own hold. `key` names this redemption
+     * (the attempt, or the register payment) and is what a void reverses.
+     */
+    debit(input: {
+        cents: number;
+        key: string;
+        orderId: string;
+        channel: CheckoutCreditChannel;
+    }): number;
+    /** Gives back exactly what the redemption named by `key` took: a voided register payment. */
+    reverse(input: {
+        key: string;
+        orderId: string;
+    }): number;
+}
+export interface CheckoutCreditHoldRequest {
+    hostId: string;
+    reference: string;
+    /** The checkout attempt: the same key re-places the same hold. */
+    holdKey: string;
+    /** The most the sale can take: what is left to pay on the goods. */
+    maxCents: number;
+    /** ISO-4217, lower case. */
+    currency: string;
+    customerEmail: string | null;
+    nowMs: number;
+}
+export interface PluginCheckoutCreditProvider {
+    /** Stable within the plugin: lower-case words and dashes. */
+    key: string;
+    /** What the field and the register's tender button say: `Rewards`. */
+    label: string;
+    /** Whether a code is one this provider issues. Syntax only: no reads. */
+    recognizes(code: string): boolean;
+    /** Whether the site offers it at all: plugin on, program on, plan carries it. */
+    offered(input: {
+        hostId: string;
+        channel: CheckoutCreditChannel;
+    }): Promise<boolean>;
+    /**
+     * A buyer's code — or, at the register only, a `reference` a staff
+     * {@link lookup} returned — to the account it names. `staff` is true only
+     * when the seller has authenticated a staff member for this site; a
+     * provider honors a bare `reference` only then.
+     */
+    resolve(input: {
+        hostId: string;
+        code?: string;
+        reference?: string;
+        channel: CheckoutCreditChannel;
+        customerEmail: string | null;
+        staff: boolean;
+    }): Promise<CheckoutCreditAccount | CheckoutCreditRefusal>;
+    /** Reserves up to `maxCents` for one online checkout attempt. */
+    hold(input: CheckoutCreditHoldRequest): Promise<{
+        ok: true;
+        cents: number;
+    } | CheckoutCreditRefusal>;
+    /** Lets a hold go: an abandoned or refused checkout. Never throws. */
+    release(input: {
+        hostId: string;
+        reference: string;
+        holdKey: string;
+    }): Promise<void>;
+    /**
+     * Reads the account inside the seller's transaction. `null` when it no
+     * longer exists. `holdKey` is this sale's own online hold, when it has one.
+     */
+    stage(input: {
+        transaction: CheckoutCreditTransaction;
+        hostId: string;
+        reference: string;
+        orderId: string;
+        nowMs: number;
+        holdKey?: string;
+    }): Promise<CheckoutCreditStage | null>;
+    /**
+     * Gives back up to `cents` of what the sale took from the account, for a
+     * refund. Idempotent per `key`; returns the cents given back (0 for a key
+     * already restored, or an account that is gone).
+     */
+    restore(input: {
+        hostId: string;
+        reference: string;
+        orderId: string;
+        cents: number;
+        key: string;
+    }): Promise<number>;
+    /** Staff search at the register by email or code. Optional. */
+    lookup?(input: {
+        hostId: string;
+        query: string;
+    }): Promise<CheckoutCreditAccount[]>;
+}
+/** A provider as the seller resolves it. */
+export interface ResolvedCheckoutCreditProvider {
+    /** `{pluginId}.{key}`: what a sale records. */
+    providerId: string;
+    pluginId: string;
+    provider: PluginCheckoutCreditProvider;
+}
+/**
+ * What a sale records of one redemption, on the sale and in the events the
+ * seller raises about it, so the provider learns what was taken from the
+ * seller's own facts. `appliedAs` says how the seller counted it: online it
+ * comes off the goods like a discount, at the register it is one of the
+ * sale's payments.
+ */
+export interface PluginCheckoutCreditSold {
+    providerId: string;
+    pluginId: string;
+    key: string;
+    reference: string;
+    label: string;
+    last4: string;
+    amountCents: number;
+    appliedAs: 'discount' | 'tender';
+}
+/** The shape of a provider's `reference`: short, and safe in a document path segment. */
+export declare const CHECKOUT_CREDIT_REFERENCE: RegExp;
+/** Joins the providers. A plugin re-registering a key replaces its own. */
+export declare function registerPluginCheckoutCredit(provider: PluginCheckoutCreditProvider, options?: {
+    pluginId?: string;
+}): void;
+/** Whether any plugin registered a provider: a seller with none skips the field. */
+export declare function hasPluginCheckoutCredits(): boolean;
+/**
+ * A code as typed — any case, spaces and dashes — in the one form providers
+ * see: upper case, letters, digits and single dashes, at most 40 characters.
+ * Empty when nothing usable was typed.
+ */
+export declare function normalizeCheckoutCreditCode(value: unknown): string;
+/** The provider that issues a code, or `null`. The first to recognize it answers. */
+export declare function checkoutCreditProviderForCode(code: string): ResolvedCheckoutCreditProvider | null;
+/** One provider by the id a sale recorded, or `null` when it is gone. */
+export declare function checkoutCreditProvider(providerId: string): ResolvedCheckoutCreditProvider | null;
+/**
+ * The providers a site offers on a channel, for the cart's field and the
+ * register's tender. Never throws: a provider that fails is not offered.
+ */
+export declare function offeredCheckoutCredits(input: {
+    hostId: string;
+    channel: CheckoutCreditChannel;
+}): Promise<Array<{
+    providerId: string;
+    label: string;
+    lookup: boolean;
+}>>;
+/** An account answer held to the contract, or a refusal in its place. */
+export declare function normalizeCheckoutCreditAccount(answer: CheckoutCreditAccount | CheckoutCreditRefusal | null | undefined): CheckoutCreditAccount | CheckoutCreditRefusal;
+/** Cents a provider says it held or took, as whole non-negative cents no larger than `ceiling`. */
+export declare function boundedCreditCents(value: unknown, ceiling: number): number;
+/** The metadata key an online redemption rides under on the payment processor. */
+export declare const CHECKOUT_CREDIT_METADATA_KEY = "credit0";
+/** What an online checkout carries to its webhook: the hold to settle. */
+export interface CheckoutCreditHeld {
+    providerId: string;
+    reference: string;
+    holdKey: string;
+    amountCents: number;
+    label: string;
+    last4: string;
+}
+/**
+ * The hold an online checkout placed, packed for a payment processor's
+ * metadata: one key holding `[providerId, reference, holdKey, cents, label, last4]`
+ * as JSON, inside a 500-character value. Never the code itself: metadata is
+ * readable on the merchant's dashboard, and a code is a bearer secret.
+ */
+export declare function encodeCheckoutCreditMetadata(held: CheckoutCreditHeld): Record<string, string>;
+/** Reads {@link encodeCheckoutCreditMetadata} back. Anything unreadable is `null`, never guessed. */
+export declare function decodeCheckoutCreditMetadata(metadata: Record<string, unknown> | null | undefined): CheckoutCreditHeld | null;
+/** The plugin id and key of a provider id. */
+export declare function splitCheckoutCreditProviderId(providerId: string): {
+    pluginId: string;
+    key: string;
+} | null;
+/** A recorded redemption, as a seller stores it and its events carry it. */
+export declare function checkoutCreditSold(input: Omit<PluginCheckoutCreditSold, 'pluginId' | 'key'>): PluginCheckoutCreditSold | null;

package/src/lib/plugin-manager/plugin-checkout-credits.js

@@ -0,0 +1,196 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
+import { definePluginServiceContract, registerPluginService, resolvePluginServices } from "./plugin-services.js";
+const KEY = /^[a-z][a-z0-9-]{1,39}$/;
+const PROVIDER_ID = /^([a-z][a-z0-9-]{0,63})\.([a-z][a-z0-9-]{1,39})$/;
+/** The shape of a provider's `reference`: short, and safe in a document path segment. */ export const CHECKOUT_CREDIT_REFERENCE = /^[A-Za-z0-9:_-]{1,128}$/;
+const PLUGIN_CHECKOUT_CREDITS = definePluginServiceContract('core.checkout-credits', {
+    multiple: true
+});
+/** Joins the providers. A plugin re-registering a key replaces its own. */ export function registerPluginCheckoutCredit(provider, options) {
+    var _ref, _getRegisteringPluginId;
+    if (!KEY.test(String((_ref = provider == null ? void 0 : provider.key) != null ? _ref : ''))) {
+        throw new Error(`checkout credit provider key "${provider == null ? void 0 : provider.key}" must be lower-case words and dashes`);
+    }
+    const pluginId = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId;
+    registerPluginService(PLUGIN_CHECKOUT_CREDITS, provider, _extends({}, pluginId ? {
+        pluginId
+    } : {}, {
+        key: provider.key
+    }));
+}
+function resolved() {
+    return resolvePluginServices(PLUGIN_CHECKOUT_CREDITS).map((entry)=>({
+            providerId: `${entry.pluginId}.${entry.impl.key}`,
+            pluginId: entry.pluginId,
+            provider: entry.impl
+        }));
+}
+/** Whether any plugin registered a provider: a seller with none skips the field. */ export function hasPluginCheckoutCredits() {
+    return resolvePluginServices(PLUGIN_CHECKOUT_CREDITS).length > 0;
+}
+/**
+ * A code as typed — any case, spaces and dashes — in the one form providers
+ * see: upper case, letters, digits and single dashes, at most 40 characters.
+ * Empty when nothing usable was typed.
+ */ export function normalizeCheckoutCreditCode(value) {
+    return String(value != null ? value : '').toUpperCase().replace(/[^A-Z0-9-]/g, '').replace(/-+/g, '-').replace(/^-|-$/g, '').slice(0, 40);
+}
+/** The provider that issues a code, or `null`. The first to recognize it answers. */ export function checkoutCreditProviderForCode(code) {
+    const normalized = normalizeCheckoutCreditCode(code);
+    if (!normalized) return null;
+    for (const entry of resolved()){
+        try {
+            if (entry.provider.recognizes(normalized)) return entry;
+        } catch (error) {
+            console.error(`[checkout-credits] "${entry.providerId}" failed to read a code`, error);
+        }
+    }
+    return null;
+}
+/** One provider by the id a sale recorded, or `null` when it is gone. */ export function checkoutCreditProvider(providerId) {
+    var _resolved_find;
+    return (_resolved_find = resolved().find((entry)=>entry.providerId === providerId)) != null ? _resolved_find : null;
+}
+/**
+ * The providers a site offers on a channel, for the cart's field and the
+ * register's tender. Never throws: a provider that fails is not offered.
+ */ export async function offeredCheckoutCredits(input) {
+    const answers = await Promise.all(resolved().map(async (entry)=>{
+        const offered = await entry.provider.offered(input).catch((error)=>{
+            console.error(`[checkout-credits] "${entry.providerId}" offered() failed for ${input.hostId}`, error);
+            return false;
+        });
+        return offered ? {
+            providerId: entry.providerId,
+            label: entry.provider.label,
+            lookup: typeof entry.provider.lookup === 'function'
+        } : null;
+    }));
+    return answers.filter((answer)=>Boolean(answer));
+}
+/** An account answer held to the contract, or a refusal in its place. */ export function normalizeCheckoutCreditAccount(answer) {
+    var _answer_reference;
+    if (!answer || typeof answer !== 'object') {
+        return {
+            ok: false,
+            status: 404,
+            error: 'That code is not valid.'
+        };
+    }
+    if (answer.ok !== true) {
+        const status = Number.isInteger(answer.status) && answer.status >= 400 && answer.status < 500 ? answer.status : 409;
+        return {
+            ok: false,
+            status,
+            error: cleanText(answer.error, 160) || 'That code cannot be used.'
+        };
+    }
+    if (!CHECKOUT_CREDIT_REFERENCE.test(String((_answer_reference = answer.reference) != null ? _answer_reference : ''))) {
+        return {
+            ok: false,
+            status: 404,
+            error: 'That code is not valid.'
+        };
+    }
+    const available = answer.availableCents;
+    return _extends({
+        ok: true,
+        reference: answer.reference,
+        label: cleanText(answer.label, 40) || 'Store credit',
+        last4: cleanText(answer.last4, 4).toUpperCase(),
+        availableCents: Number.isSafeInteger(available) && available > 0 ? available : 0
+    }, answer.detail ? {
+        detail: cleanText(answer.detail, 120)
+    } : {});
+}
+/** Cents a provider says it held or took, as whole non-negative cents no larger than `ceiling`. */ export function boundedCreditCents(value, ceiling) {
+    const cents = typeof value === 'number' && Number.isSafeInteger(value) && value > 0 ? value : 0;
+    const max = Number.isSafeInteger(ceiling) && ceiling > 0 ? ceiling : 0;
+    return Math.min(cents, max);
+}
+function cleanText(value, max) {
+    return Array.from(String(value != null ? value : ''), (char)=>char.charCodeAt(0) < 32 || char.charCodeAt(0) === 127 ? ' ' : char).join('').replace(/\s+/g, ' ').trim().slice(0, max);
+}
+/** The metadata key an online redemption rides under on the payment processor. */ export const CHECKOUT_CREDIT_METADATA_KEY = 'credit0';
+/**
+ * The hold an online checkout placed, packed for a payment processor's
+ * metadata: one key holding `[providerId, reference, holdKey, cents, label, last4]`
+ * as JSON, inside a 500-character value. Never the code itself: metadata is
+ * readable on the merchant's dashboard, and a code is a bearer secret.
+ */ export function encodeCheckoutCreditMetadata(held) {
+    const entry = [
+        held.providerId,
+        held.reference,
+        held.holdKey.slice(0, 200),
+        held.amountCents,
+        cleanText(held.label, 40),
+        cleanText(held.last4, 4)
+    ];
+    return {
+        [CHECKOUT_CREDIT_METADATA_KEY]: JSON.stringify(entry)
+    };
+}
+/** Reads {@link encodeCheckoutCreditMetadata} back. Anything unreadable is `null`, never guessed. */ export function decodeCheckoutCreditMetadata(metadata) {
+    const raw = metadata == null ? void 0 : metadata[CHECKOUT_CREDIT_METADATA_KEY];
+    if (raw === undefined || raw === null || raw === '') return null;
+    let entry;
+    try {
+        entry = JSON.parse(String(raw));
+    } catch (unused) {
+        return null;
+    }
+    if (!Array.isArray(entry)) return null;
+    const [providerId, reference, holdKey, cents, label, last4] = entry;
+    if (!PROVIDER_ID.test(String(providerId != null ? providerId : ''))) return null;
+    if (!CHECKOUT_CREDIT_REFERENCE.test(String(reference != null ? reference : ''))) return null;
+    if (typeof holdKey !== 'string' || !holdKey) return null;
+    if (typeof cents !== 'number' || !Number.isSafeInteger(cents) || cents <= 0) return null;
+    return {
+        providerId: String(providerId),
+        reference: String(reference),
+        holdKey,
+        amountCents: cents,
+        label: cleanText(label, 40) || 'Store credit',
+        last4: cleanText(last4, 4)
+    };
+}
+/** The plugin id and key of a provider id. */ export function splitCheckoutCreditProviderId(providerId) {
+    const match = PROVIDER_ID.exec(String(providerId != null ? providerId : ''));
+    return match ? {
+        pluginId: match[1],
+        key: match[2]
+    } : null;
+}
+/** A recorded redemption, as a seller stores it and its events carry it. */ export function checkoutCreditSold(input) {
+    const parts = splitCheckoutCreditProviderId(input.providerId);
+    if (!parts || !CHECKOUT_CREDIT_REFERENCE.test(input.reference)) return null;
+    if (!Number.isSafeInteger(input.amountCents) || input.amountCents <= 0) return null;
+    return {
+        providerId: input.providerId,
+        pluginId: parts.pluginId,
+        key: parts.key,
+        reference: input.reference,
+        label: cleanText(input.label, 40) || 'Store credit',
+        last4: cleanText(input.last4, 4),
+        amountCents: input.amountCents,
+        appliedAs: input.appliedAs === 'tender' ? 'tender' : 'discount'
+    };
+}
+
+//# sourceMappingURL=plugin-checkout-credits.js.map

package/src/lib/plugin-manager/plugin-checkout-credits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-checkout-credits.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginServices,\n} from './plugin-services'\n\n/**\n * Money another plugin honors at checkout and at the register (AGL-3640).\n *\n * A rewards balance, store credit and a friend's referral credit are all the\n * same thing to a seller: a code the buyer brings that pays part of the sale\n * from an account the SELLER does not keep. The plugin that keeps the account\n * registers a provider here; the seller asks it, by code, how much the account\n * can give, reserves that much while an online buyer pays, and takes it in the\n * same transaction that writes the sale. The seller never reads the provider's\n * documents and the provider never reads the seller's: the sale records which\n * provider paid what, under the provider's own opaque `reference`, and the\n * seller's order events carry that onward.\n *\n * ## Money\n *\n * Integer cents in the sale's currency, always. A provider answers what it\n * CAN give and the seller never takes more than that.\n *\n *   - Online, the seller {@link PluginCheckoutCreditProvider.hold | holds}\n *     before the payment processor is asked, so a shortfall is a refusal and\n *     not an apology. The hold is keyed by the checkout attempt, so a retry\n *     re-places the same hold rather than a second one, and it lapses on its\n *     own if the checkout is abandoned and nobody releases it.\n *   - When the sale is written, the seller {@link PluginCheckoutCreditProvider.stage | stages}\n *     the account INSIDE its own transaction: the provider reads (and only\n *     reads) what it needs, and the stage's `debit` writes the redemption in\n *     the same commit as the sale. A sale that is not written takes nothing;\n *     a redemption is never written without its sale.\n *   - A refund gives back through {@link PluginCheckoutCreditProvider.restore | restore},\n *     idempotent per key, so a retried refund restores once.\n *\n * ## Nobody home\n *\n * With no provider registered, or none offered on a site, the seller shows no\n * field and sells exactly as it did before. Every reader here that a seller\n * calls on a sale path is safe to call with nothing registered.\n *\n * Import this module by its own subpath\n * (`@aglyn/aglyn/plugin-manager/plugin-checkout-credits`); it is not in the\n * barrel.\n */\n\n/** Where the sale happens. */\nexport type CheckoutCreditChannel = 'online' | 'pos'\n\n/**\n * A server transaction as a provider uses it: the Admin SDK's shape, typed\n * structurally so the platform names no database SDK. Every `get` happens\n * before any write, as the database requires.\n */\nexport interface CheckoutCreditTransaction {\n  get(ref: any): Promise<any>\n  set(ref: any, data: any, options?: any): unknown\n  update(ref: any, data: any): unknown\n  create(ref: any, data: any): unknown\n}\n\n/** A provider's refusal, in words the buyer or the cashier can read. */\nexport interface CheckoutCreditRefusal {\n  ok: false\n  /** 400 for a bad code, 404 for an unknown one, 409 for an empty or busy one. */\n  status: number\n  error: string\n}\n\n/** The account a code names. */\nexport interface CheckoutCreditAccount {\n  ok: true\n  /**\n   * The provider's own handle on the account, stored on the sale and handed\n   * back to it later. Never shown to a buyer and never a bearer secret.\n   * {@link CHECKOUT_CREDIT_REFERENCE} holds its shape.\n   */\n  reference: string\n  /** What the buyer and the receipt call it: `Rewards`, `Referral credit`. */\n  label: string\n  /** The last characters of the code, for the register and the receipt. */\n  last4: string\n  /** What the account could give right now, integer cents. */\n  availableCents: number\n  /** One line for the cashier: `1,250 points and $5.00 store credit`. */\n  detail?: string\n}\n\n/**\n * The account as the seller's transaction read it. The provider builds it in\n * {@link PluginCheckoutCreditProvider.stage}, which reads; its methods only\n * WRITE, through the same transaction, so the redemption commits with the sale\n * or not at all.\n */\nexport interface CheckoutCreditStage {\n  /**\n   * What the account may give now, honoring every live hold except the one\n   * the stage was opened for (that one is this sale's own).\n   */\n  availableCents: number\n  /**\n   * Takes up to `cents` and returns what was taken: never more than\n   * `availableCents` plus this sale's own hold. `key` names this redemption\n   * (the attempt, or the register payment) and is what a void reverses.\n   */\n  debit(input: { cents: number; key: string; orderId: string; channel: CheckoutCreditChannel }): number\n  /** Gives back exactly what the redemption named by `key` took: a voided register payment. */\n  reverse(input: { key: string; orderId: string }): number\n}\n\nexport interface CheckoutCreditHoldRequest {\n  hostId: string\n  reference: string\n  /** The checkout attempt: the same key re-places the same hold. */\n  holdKey: string\n  /** The most the sale can take: what is left to pay on the goods. */\n  maxCents: number\n  /** ISO-4217, lower case. */\n  currency: string\n  customerEmail: string | null\n  nowMs: number\n}\n\nexport interface PluginCheckoutCreditProvider {\n  /** Stable within the plugin: lower-case words and dashes. */\n  key: string\n  /** What the field and the register's tender button say: `Rewards`. */\n  label: string\n  /** Whether a code is one this provider issues. Syntax only: no reads. */\n  recognizes(code: string): boolean\n  /** Whether the site offers it at all: plugin on, program on, plan carries it. */\n  offered(input: { hostId: string; channel: CheckoutCreditChannel }): Promise<boolean>\n  /**\n   * A buyer's code — or, at the register only, a `reference` a staff\n   * {@link lookup} returned — to the account it names. `staff` is true only\n   * when the seller has authenticated a staff member for this site; a\n   * provider honors a bare `reference` only then.\n   */\n  resolve(input: {\n    hostId: string\n    code?: string\n    reference?: string\n    channel: CheckoutCreditChannel\n    customerEmail: string | null\n    staff: boolean\n  }): Promise<CheckoutCreditAccount | CheckoutCreditRefusal>\n  /** Reserves up to `maxCents` for one online checkout attempt. */\n  hold(input: CheckoutCreditHoldRequest): Promise<{ ok: true; cents: number } | CheckoutCreditRefusal>\n  /** Lets a hold go: an abandoned or refused checkout. Never throws. */\n  release(input: { hostId: string; reference: string; holdKey: string }): Promise<void>\n  /**\n   * Reads the account inside the seller's transaction. `null` when it no\n   * longer exists. `holdKey` is this sale's own online hold, when it has one.\n   */\n  stage(input: {\n    transaction: CheckoutCreditTransaction\n    hostId: string\n    reference: string\n    orderId: string\n    nowMs: number\n    holdKey?: string\n  }): Promise<CheckoutCreditStage | null>\n  /**\n   * Gives back up to `cents` of what the sale took from the account, for a\n   * refund. Idempotent per `key`; returns the cents given back (0 for a key\n   * already restored, or an account that is gone).\n   */\n  restore(input: { hostId: string; reference: string; orderId: string; cents: number; key: string }): Promise<number>\n  /** Staff search at the register by email or code. Optional. */\n  lookup?(input: { hostId: string; query: string }): Promise<CheckoutCreditAccount[]>\n}\n\n/** A provider as the seller resolves it. */\nexport interface ResolvedCheckoutCreditProvider {\n  /** `{pluginId}.{key}`: what a sale records. */\n  providerId: string\n  pluginId: string\n  provider: PluginCheckoutCreditProvider\n}\n\n/**\n * What a sale records of one redemption, on the sale and in the events the\n * seller raises about it, so the provider learns what was taken from the\n * seller's own facts. `appliedAs` says how the seller counted it: online it\n * comes off the goods like a discount, at the register it is one of the\n * sale's payments.\n */\nexport interface PluginCheckoutCreditSold {\n  providerId: string\n  pluginId: string\n  key: string\n  reference: string\n  label: string\n  last4: string\n  amountCents: number\n  appliedAs: 'discount' | 'tender'\n}\n\nconst KEY = /^[a-z][a-z0-9-]{1,39}$/\nconst PROVIDER_ID = /^([a-z][a-z0-9-]{0,63})\\.([a-z][a-z0-9-]{1,39})$/\n\n/** The shape of a provider's `reference`: short, and safe in a document path segment. */\nexport const CHECKOUT_CREDIT_REFERENCE = /^[A-Za-z0-9:_-]{1,128}$/\n\nconst PLUGIN_CHECKOUT_CREDITS = definePluginServiceContract<PluginCheckoutCreditProvider>(\n  'core.checkout-credits',\n  { multiple: true },\n)\n\n/** Joins the providers. A plugin re-registering a key replaces its own. */\nexport function registerPluginCheckoutCredit(\n  provider: PluginCheckoutCreditProvider,\n  options?: { pluginId?: string },\n): void {\n  if (!KEY.test(String(provider?.key ?? ''))) {\n    throw new Error(`checkout credit provider key \"${provider?.key}\" must be lower-case words and dashes`)\n  }\n  const pluginId = getRegisteringPluginId() ?? options?.pluginId\n  registerPluginService(PLUGIN_CHECKOUT_CREDITS, provider, {\n    ...(pluginId ? { pluginId } : {}),\n    key: provider.key,\n  })\n}\n\nfunction resolved(): ResolvedCheckoutCreditProvider[] {\n  return resolvePluginServices(PLUGIN_CHECKOUT_CREDITS).map((entry) => ({\n    providerId: `${entry.pluginId}.${entry.impl.key}`,\n    pluginId: entry.pluginId,\n    provider: entry.impl,\n  }))\n}\n\n/** Whether any plugin registered a provider: a seller with none skips the field. */\nexport function hasPluginCheckoutCredits(): boolean {\n  return resolvePluginServices(PLUGIN_CHECKOUT_CREDITS).length > 0\n}\n\n/**\n * A code as typed — any case, spaces and dashes — in the one form providers\n * see: upper case, letters, digits and single dashes, at most 40 characters.\n * Empty when nothing usable was typed.\n */\nexport function normalizeCheckoutCreditCode(value: unknown): string {\n  return String(value ?? '')\n    .toUpperCase()\n    .replace(/[^A-Z0-9-]/g, '')\n    .replace(/-+/g, '-')\n    .replace(/^-|-$/g, '')\n    .slice(0, 40)\n}\n\n/** The provider that issues a code, or `null`. The first to recognize it answers. */\nexport function checkoutCreditProviderForCode(code: string): ResolvedCheckoutCreditProvider | null {\n  const normalized = normalizeCheckoutCreditCode(code)\n  if (!normalized) return null\n  for (const entry of resolved()) {\n    try {\n      if (entry.provider.recognizes(normalized)) return entry\n    } catch (error) {\n      console.error(`[checkout-credits] \"${entry.providerId}\" failed to read a code`, error)\n    }\n  }\n  return null\n}\n\n/** One provider by the id a sale recorded, or `null` when it is gone. */\nexport function checkoutCreditProvider(providerId: string): ResolvedCheckoutCreditProvider | null {\n  return resolved().find((entry) => entry.providerId === providerId) ?? null\n}\n\n/**\n * The providers a site offers on a channel, for the cart's field and the\n * register's tender. Never throws: a provider that fails is not offered.\n */\nexport async function offeredCheckoutCredits(input: {\n  hostId: string\n  channel: CheckoutCreditChannel\n}): Promise<Array<{ providerId: string; label: string; lookup: boolean }>> {\n  const answers = await Promise.all(\n    resolved().map(async (entry) => {\n      const offered = await entry.provider.offered(input).catch((error: unknown) => {\n        console.error(`[checkout-credits] \"${entry.providerId}\" offered() failed for ${input.hostId}`, error)\n        return false\n      })\n      return offered\n        ? { providerId: entry.providerId, label: entry.provider.label, lookup: typeof entry.provider.lookup === 'function' }\n        : null\n    }),\n  )\n  return answers.filter((answer): answer is { providerId: string; label: string; lookup: boolean } => Boolean(answer))\n}\n\n/** An account answer held to the contract, or a refusal in its place. */\nexport function normalizeCheckoutCreditAccount(\n  answer: CheckoutCreditAccount | CheckoutCreditRefusal | null | undefined,\n): CheckoutCreditAccount | CheckoutCreditRefusal {\n  if (!answer || typeof answer !== 'object') {\n    return { ok: false, status: 404, error: 'That code is not valid.' }\n  }\n  if (answer.ok !== true) {\n    const status = Number.isInteger(answer.status) && answer.status >= 400 && answer.status < 500 ? answer.status : 409\n    return { ok: false, status, error: cleanText(answer.error, 160) || 'That code cannot be used.' }\n  }\n  if (!CHECKOUT_CREDIT_REFERENCE.test(String(answer.reference ?? ''))) {\n    return { ok: false, status: 404, error: 'That code is not valid.' }\n  }\n  const available = answer.availableCents\n  return {\n    ok: true,\n    reference: answer.reference,\n    label: cleanText(answer.label, 40) || 'Store credit',\n    last4: cleanText(answer.last4, 4).toUpperCase(),\n    availableCents: Number.isSafeInteger(available) && available > 0 ? available : 0,\n    ...(answer.detail ? { detail: cleanText(answer.detail, 120) } : {}),\n  }\n}\n\n/** Cents a provider says it held or took, as whole non-negative cents no larger than `ceiling`. */\nexport function boundedCreditCents(value: unknown, ceiling: number): number {\n  const cents = typeof value === 'number' && Number.isSafeInteger(value) && value > 0 ? value : 0\n  const max = Number.isSafeInteger(ceiling) && ceiling > 0 ? ceiling : 0\n  return Math.min(cents, max)\n}\n\nfunction cleanText(value: unknown, max: number): string {\n  return Array.from(String(value ?? ''), (char) =>\n    char.charCodeAt(0) < 32 || char.charCodeAt(0) === 127 ? ' ' : char,\n  )\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim()\n    .slice(0, max)\n}\n\n/** The metadata key an online redemption rides under on the payment processor. */\nexport const CHECKOUT_CREDIT_METADATA_KEY = 'credit0'\n\n/** What an online checkout carries to its webhook: the hold to settle. */\nexport interface CheckoutCreditHeld {\n  providerId: string\n  reference: string\n  holdKey: string\n  amountCents: number\n  label: string\n  last4: string\n}\n\n/**\n * The hold an online checkout placed, packed for a payment processor's\n * metadata: one key holding `[providerId, reference, holdKey, cents, label, last4]`\n * as JSON, inside a 500-character value. Never the code itself: metadata is\n * readable on the merchant's dashboard, and a code is a bearer secret.\n */\nexport function encodeCheckoutCreditMetadata(held: CheckoutCreditHeld): Record<string, string> {\n  const entry = [\n    held.providerId,\n    held.reference,\n    held.holdKey.slice(0, 200),\n    held.amountCents,\n    cleanText(held.label, 40),\n    cleanText(held.last4, 4),\n  ]\n  return { [CHECKOUT_CREDIT_METADATA_KEY]: JSON.stringify(entry) }\n}\n\n/** Reads {@link encodeCheckoutCreditMetadata} back. Anything unreadable is `null`, never guessed. */\nexport function decodeCheckoutCreditMetadata(\n  metadata: Record<string, unknown> | null | undefined,\n): CheckoutCreditHeld | null {\n  const raw = metadata?.[CHECKOUT_CREDIT_METADATA_KEY]\n  if (raw === undefined || raw === null || raw === '') return null\n  let entry: unknown\n  try {\n    entry = JSON.parse(String(raw))\n  } catch {\n    return null\n  }\n  if (!Array.isArray(entry)) return null\n  const [providerId, reference, holdKey, cents, label, last4] = entry\n  if (!PROVIDER_ID.test(String(providerId ?? ''))) return null\n  if (!CHECKOUT_CREDIT_REFERENCE.test(String(reference ?? ''))) return null\n  if (typeof holdKey !== 'string' || !holdKey) return null\n  if (typeof cents !== 'number' || !Number.isSafeInteger(cents) || cents <= 0) return null\n  return {\n    providerId: String(providerId),\n    reference: String(reference),\n    holdKey,\n    amountCents: cents,\n    label: cleanText(label, 40) || 'Store credit',\n    last4: cleanText(last4, 4),\n  }\n}\n\n/** The plugin id and key of a provider id. */\nexport function splitCheckoutCreditProviderId(providerId: string): { pluginId: string; key: string } | null {\n  const match = PROVIDER_ID.exec(String(providerId ?? ''))\n  return match ? { pluginId: match[1], key: match[2] } : null\n}\n\n/** A recorded redemption, as a seller stores it and its events carry it. */\nexport function checkoutCreditSold(\n  input: Omit<PluginCheckoutCreditSold, 'pluginId' | 'key'>,\n): PluginCheckoutCreditSold | null {\n  const parts = splitCheckoutCreditProviderId(input.providerId)\n  if (!parts || !CHECKOUT_CREDIT_REFERENCE.test(input.reference)) return null\n  if (!Number.isSafeInteger(input.amountCents) || input.amountCents <= 0) return null\n  return {\n    providerId: input.providerId,\n    pluginId: parts.pluginId,\n    key: parts.key,\n    reference: input.reference,\n    label: cleanText(input.label, 40) || 'Store credit',\n    last4: cleanText(input.last4, 4),\n    amountCents: input.amountCents,\n    appliedAs: input.appliedAs === 'tender' ? 'tender' : 'discount',\n  }\n}\n"],"names":["getRegisteringPluginId","definePluginServiceContract","registerPluginService","resolvePluginServices","KEY","PROVIDER_ID","CHECKOUT_CREDIT_REFERENCE","PLUGIN_CHECKOUT_CREDITS","multiple","registerPluginCheckoutCredit","provider","options","test","String","key","Error","pluginId","resolved","map","entry","providerId","impl","hasPluginCheckoutCredits","length","normalizeCheckoutCreditCode","value","toUpperCase","replace","slice","checkoutCreditProviderForCode","code","normalized","recognizes","error","console","checkoutCreditProvider","find","offeredCheckoutCredits","input","answers","Promise","all","offered","catch","hostId","label","lookup","filter","answer","Boolean","normalizeCheckoutCreditAccount","ok","status","Number","isInteger","cleanText","reference","available","availableCents","last4","isSafeInteger","detail","boundedCreditCents","ceiling","cents","max","Math","min","Array","from","char","charCodeAt","join","trim","CHECKOUT_CREDIT_METADATA_KEY","encodeCheckoutCreditMetadata","held","holdKey","amountCents","JSON","stringify","decodeCheckoutCreditMetadata","metadata","raw","undefined","parse","isArray","splitCheckoutCreditProviderId","match","exec","checkoutCreditSold","parts","appliedAs"],"mappings":"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"}

package/src/lib/plugin-manager/plugin-shipping-rates.d.ts

@@ -119,6 +119,16 @@ export interface PluginShippingAddressCheck {
     suggested?: PluginShippingAddress;
     /** Why it is not deliverable, in the carrier's words. */
     messages: string[];
+    /**
+     * Where the address is on a map, when the provider placed it. Optional:
+     * only some providers return it, and only for addresses they verified. A
+     * caller measuring distance (local delivery radius zones) treats its
+     * absence as "cannot measure", never as zero.
+     */
+    coordinates?: {
+        lat: number;
+        lng: number;
+    };
 }
 export interface PluginShippingRateQuoter {
     /** Whether quotes can be asked for this site now: configured and switched on. */

package/src/lib/plugin-manager/plugin-shipping-rates.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-shipping-rates.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginServices,\n} from './plugin-services'\n\n/**\n * Live parcel rates, answered by the one plugin that talks to carriers\n * (AGL-3612).\n *\n * A plugin that sells goods prices delivery from its own table until the\n * merchant asks for live rates; then it needs a carrier's quote for an\n * address and a parcel, and it must not learn which carrier network, which\n * account or which vendor answers. A plugin that buys labels registers here;\n * a plugin that sells asks here, and neither imports the other.\n *\n * ## The shape is a parcel and an address, nothing more\n *\n * Every type below is postal: where it goes, what it weighs, how big it is,\n * and what it is worth for insurance and customs. Nothing names a catalog, an\n * order or a store, so a booking plugin shipping a rental kit asks the same\n * question in the same words.\n *\n * ## Nobody home is `null`, never a refusal\n *\n * Unlike the tax profile, an absent quoter is a perfectly good answer: the\n * seller falls back to its own rates, which is what it did before anyone\n * registered. {@link pluginShippingRateQuoter} answers `null`, and a quoter\n * whose deployment is not configured answers `available() === false`, which\n * a caller must read the same way.\n *\n * ## A quote is advisory until a label is bought\n *\n * `amountCents` is what the carrier quoted the platform for that parcel at\n * that moment, BEFORE any markup or handling the seller adds. The seller\n * decides what the shopper pays; the quoter never does.\n *\n * Import this module by its own subpath\n * (`@aglyn/aglyn/plugin-manager/plugin-shipping-rates`); it is not in the\n * barrel.\n */\n\n/** A postal address. `country` is ISO-3166 alpha-2; everything else is optional. */\nexport interface PluginShippingAddress {\n  name?: string\n  company?: string\n  line1?: string\n  line2?: string\n  city?: string\n  /** State, province or region code, as the destination writes it. */\n  state?: string\n  postalCode?: string\n  country: string\n  phone?: string\n  email?: string\n  /** Whether the address is a home, when the caller knows; carriers price it. */\n  residential?: boolean\n}\n\n/** One parcel. Metric throughout; an adapter converts to its vendor's units. */\nexport interface PluginShippingParcel {\n  weightGrams: number\n  lengthCm?: number\n  widthCm?: number\n  heightCm?: number\n}\n\n/** What a seller asks: one shipment's rates to one address. */\nexport interface PluginShippingQuoteRequest {\n  /** The site the shipment leaves from; the quoter resolves its ship-from address. */\n  hostId: string\n  to: PluginShippingAddress\n  parcels: PluginShippingParcel[]\n  /** ISO-4217, lower case, of the amounts the caller will charge in. */\n  currency: string\n  /** The goods' value, for insurance and customs; 0 when unknown. */\n  valueCents: number\n  /**\n   * Service keys the seller offers (`'usps:priority'`), as\n   * {@link PluginShippingRateQuoter.listServices} names them. Empty or\n   * absent means every service the quoter can price.\n   */\n  services?: string[]\n  /** Aborted when the caller stops waiting; a quoter passes it to its fetches. */\n  signal?: AbortSignal\n}\n\n/** One carrier service's price for the shipment. */\nexport interface PluginShippingQuote {\n  /** Stable across quotes: `carrier:service`, the key a seller stores. */\n  serviceKey: string\n  carrier: string\n  service: string\n  /** What a shopper reads: `'USPS Priority Mail'`. */\n  label: string\n  /** The carrier's price to the platform, before any markup or handling. */\n  amountCents: number\n  currency: string\n  /** Transit estimate in business days, when the carrier gives one. */\n  estimatedDays?: number\n}\n\n/** A service a seller may choose to offer. */\nexport interface PluginShippingService {\n  serviceKey: string\n  carrier: string\n  label: string\n}\n\n/** What address validation answers. */\nexport interface PluginShippingAddressCheck {\n  /** `valid` deliverable as written; `corrected` deliverable as `suggested`; `invalid` not deliverable. */\n  verdict: 'valid' | 'corrected' | 'invalid' | 'unknown'\n  /** The address the carrier would deliver to, when it differs. */\n  suggested?: PluginShippingAddress\n  /** Why it is not deliverable, in the carrier's words. */\n  messages: string[]\n}\n\nexport interface PluginShippingRateQuoter {\n  /** Whether quotes can be asked for this site now: configured and switched on. */\n  available(hostId: string): Promise<boolean>\n  /**\n   * The rates. Throws on a provider failure; a caller that cannot wait\n   * aborts `signal` and falls back to its own rates.\n   */\n  quote(request: PluginShippingQuoteRequest): Promise<PluginShippingQuote[]>\n  /** The services a seller can pick from for this site. */\n  listServices(hostId: string): Promise<PluginShippingService[]>\n  /** Whether an address is deliverable, and the carrier's correction. */\n  validateAddress?(\n    hostId: string,\n    address: PluginShippingAddress,\n  ): Promise<PluginShippingAddressCheck>\n}\n\nexport const PLUGIN_SHIPPING_RATE_QUOTER =\n  definePluginServiceContract<PluginShippingRateQuoter>('core.shipping-rate-quoter', {\n    multiple: false,\n  })\n\n/** Registers the plugin that quotes carrier rates. A second plugin is refused. */\nexport function registerPluginShippingRateQuoter(\n  quoter: PluginShippingRateQuoter,\n  options?: { pluginId?: string },\n): void {\n  registerPluginService(PLUGIN_SHIPPING_RATE_QUOTER, quoter, {\n    ...(options?.pluginId ? { pluginId: options.pluginId } : {}),\n  })\n}\n\n/** The quoter, or `null` when no plugin registered one. */\nexport function pluginShippingRateQuoter(): PluginShippingRateQuoter | null {\n  return resolvePluginServices(PLUGIN_SHIPPING_RATE_QUOTER)[0]?.impl ?? null\n}\n\n/**\n * Asks the quoter and gives up after `timeoutMs`: `null` when nobody is\n * registered, the site is not available, the provider failed, or the wait\n * ran out. Never throws. The caller's fallback is its own rates, so every\n * failure reads the same.\n */\nexport async function quotePluginShippingRates(\n  request: Omit<PluginShippingQuoteRequest, 'signal'>,\n  options: { timeoutMs: number },\n): Promise<PluginShippingQuote[] | null> {\n  const quoter = pluginShippingRateQuoter()\n  if (!quoter) return null\n  const controller = new AbortController()\n  let timer: ReturnType<typeof setTimeout> | undefined\n  const deadline = new Promise<null>((resolve) => {\n    timer = setTimeout(() => {\n      controller.abort()\n      resolve(null)\n    }, Math.max(0, options.timeoutMs))\n  })\n  try {\n    return await Promise.race([\n      (async (): Promise<PluginShippingQuote[] | null> => {\n        if (!(await quoter.available(request.hostId))) return null\n        return quoter.quote({ ...request, signal: controller.signal })\n      })().catch((): null => null),\n      deadline,\n    ])\n  } finally {\n    if (timer) clearTimeout(timer)\n  }\n}\n"],"names":["definePluginServiceContract","registerPluginService","resolvePluginServices","PLUGIN_SHIPPING_RATE_QUOTER","multiple","registerPluginShippingRateQuoter","quoter","options","pluginId","pluginShippingRateQuoter","impl","quotePluginShippingRates","request","controller","AbortController","timer","deadline","Promise","resolve","setTimeout","abort","Math","max","timeoutMs","race","available","hostId","quote","signal","catch","clearTimeout"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,2BAA2B,EAC3BC,qBAAqB,EACrBC,qBAAqB,QAChB,uBAAmB;AAoI1B,OAAO,MAAMC,8BACXH,4BAAsD,6BAA6B;IACjFI,UAAU;AACZ,GAAE;AAEJ,gFAAgF,GAChF,OAAO,SAASC,iCACdC,MAAgC,EAChCC,OAA+B;IAE/BN,sBAAsBE,6BAA6BG,QAAQ,aACrDC,CAAAA,2BAAAA,QAASC,QAAQ,IAAG;QAAEA,UAAUD,QAAQC,QAAQ;IAAC,IAAI,CAAC;AAE9D;AAEA,yDAAyD,GACzD,OAAO,SAASC;;QACPP;IAAP,gBAAOA,0BAAAA,sBAAsBC,4BAA4B,CAAC,EAAE,qBAArDD,wBAAuDQ,IAAI,mBAAI;AACxE;AAEA;;;;;CAKC,GACD,OAAO,eAAeC,yBACpBC,OAAmD,EACnDL,OAA8B;IAE9B,MAAMD,SAASG;IACf,IAAI,CAACH,QAAQ,OAAO;IACpB,MAAMO,aAAa,IAAIC;IACvB,IAAIC;IACJ,MAAMC,WAAW,IAAIC,QAAc,CAACC;QAClCH,QAAQI,WAAW;YACjBN,WAAWO,KAAK;YAChBF,QAAQ;QACV,GAAGG,KAAKC,GAAG,CAAC,GAAGf,QAAQgB,SAAS;IAClC;IACA,IAAI;QACF,OAAO,MAAMN,QAAQO,IAAI,CAAC;YACvB,CAAA;gBACC,IAAI,CAAE,MAAMlB,OAAOmB,SAAS,CAACb,QAAQc,MAAM,GAAI,OAAO;gBACtD,OAAOpB,OAAOqB,KAAK,CAAC,aAAKf;oBAASgB,QAAQf,WAAWe,MAAM;;YAC7D,CAAA,IAAKC,KAAK,CAAC,IAAY;YACvBb;SACD;IACH,SAAU;QACR,IAAID,OAAOe,aAAaf;IAC1B;AACF"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-shipping-rates.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginServices,\n} from './plugin-services'\n\n/**\n * Live parcel rates, answered by the one plugin that talks to carriers\n * (AGL-3612).\n *\n * A plugin that sells goods prices delivery from its own table until the\n * merchant asks for live rates; then it needs a carrier's quote for an\n * address and a parcel, and it must not learn which carrier network, which\n * account or which vendor answers. A plugin that buys labels registers here;\n * a plugin that sells asks here, and neither imports the other.\n *\n * ## The shape is a parcel and an address, nothing more\n *\n * Every type below is postal: where it goes, what it weighs, how big it is,\n * and what it is worth for insurance and customs. Nothing names a catalog, an\n * order or a store, so a booking plugin shipping a rental kit asks the same\n * question in the same words.\n *\n * ## Nobody home is `null`, never a refusal\n *\n * Unlike the tax profile, an absent quoter is a perfectly good answer: the\n * seller falls back to its own rates, which is what it did before anyone\n * registered. {@link pluginShippingRateQuoter} answers `null`, and a quoter\n * whose deployment is not configured answers `available() === false`, which\n * a caller must read the same way.\n *\n * ## A quote is advisory until a label is bought\n *\n * `amountCents` is what the carrier quoted the platform for that parcel at\n * that moment, BEFORE any markup or handling the seller adds. The seller\n * decides what the shopper pays; the quoter never does.\n *\n * Import this module by its own subpath\n * (`@aglyn/aglyn/plugin-manager/plugin-shipping-rates`); it is not in the\n * barrel.\n */\n\n/** A postal address. `country` is ISO-3166 alpha-2; everything else is optional. */\nexport interface PluginShippingAddress {\n  name?: string\n  company?: string\n  line1?: string\n  line2?: string\n  city?: string\n  /** State, province or region code, as the destination writes it. */\n  state?: string\n  postalCode?: string\n  country: string\n  phone?: string\n  email?: string\n  /** Whether the address is a home, when the caller knows; carriers price it. */\n  residential?: boolean\n}\n\n/** One parcel. Metric throughout; an adapter converts to its vendor's units. */\nexport interface PluginShippingParcel {\n  weightGrams: number\n  lengthCm?: number\n  widthCm?: number\n  heightCm?: number\n}\n\n/** What a seller asks: one shipment's rates to one address. */\nexport interface PluginShippingQuoteRequest {\n  /** The site the shipment leaves from; the quoter resolves its ship-from address. */\n  hostId: string\n  to: PluginShippingAddress\n  parcels: PluginShippingParcel[]\n  /** ISO-4217, lower case, of the amounts the caller will charge in. */\n  currency: string\n  /** The goods' value, for insurance and customs; 0 when unknown. */\n  valueCents: number\n  /**\n   * Service keys the seller offers (`'usps:priority'`), as\n   * {@link PluginShippingRateQuoter.listServices} names them. Empty or\n   * absent means every service the quoter can price.\n   */\n  services?: string[]\n  /** Aborted when the caller stops waiting; a quoter passes it to its fetches. */\n  signal?: AbortSignal\n}\n\n/** One carrier service's price for the shipment. */\nexport interface PluginShippingQuote {\n  /** Stable across quotes: `carrier:service`, the key a seller stores. */\n  serviceKey: string\n  carrier: string\n  service: string\n  /** What a shopper reads: `'USPS Priority Mail'`. */\n  label: string\n  /** The carrier's price to the platform, before any markup or handling. */\n  amountCents: number\n  currency: string\n  /** Transit estimate in business days, when the carrier gives one. */\n  estimatedDays?: number\n}\n\n/** A service a seller may choose to offer. */\nexport interface PluginShippingService {\n  serviceKey: string\n  carrier: string\n  label: string\n}\n\n/** What address validation answers. */\nexport interface PluginShippingAddressCheck {\n  /** `valid` deliverable as written; `corrected` deliverable as `suggested`; `invalid` not deliverable. */\n  verdict: 'valid' | 'corrected' | 'invalid' | 'unknown'\n  /** The address the carrier would deliver to, when it differs. */\n  suggested?: PluginShippingAddress\n  /** Why it is not deliverable, in the carrier's words. */\n  messages: string[]\n  /**\n   * Where the address is on a map, when the provider placed it. Optional:\n   * only some providers return it, and only for addresses they verified. A\n   * caller measuring distance (local delivery radius zones) treats its\n   * absence as \"cannot measure\", never as zero.\n   */\n  coordinates?: { lat: number; lng: number }\n}\n\nexport interface PluginShippingRateQuoter {\n  /** Whether quotes can be asked for this site now: configured and switched on. */\n  available(hostId: string): Promise<boolean>\n  /**\n   * The rates. Throws on a provider failure; a caller that cannot wait\n   * aborts `signal` and falls back to its own rates.\n   */\n  quote(request: PluginShippingQuoteRequest): Promise<PluginShippingQuote[]>\n  /** The services a seller can pick from for this site. */\n  listServices(hostId: string): Promise<PluginShippingService[]>\n  /** Whether an address is deliverable, and the carrier's correction. */\n  validateAddress?(\n    hostId: string,\n    address: PluginShippingAddress,\n  ): Promise<PluginShippingAddressCheck>\n}\n\nexport const PLUGIN_SHIPPING_RATE_QUOTER =\n  definePluginServiceContract<PluginShippingRateQuoter>('core.shipping-rate-quoter', {\n    multiple: false,\n  })\n\n/** Registers the plugin that quotes carrier rates. A second plugin is refused. */\nexport function registerPluginShippingRateQuoter(\n  quoter: PluginShippingRateQuoter,\n  options?: { pluginId?: string },\n): void {\n  registerPluginService(PLUGIN_SHIPPING_RATE_QUOTER, quoter, {\n    ...(options?.pluginId ? { pluginId: options.pluginId } : {}),\n  })\n}\n\n/** The quoter, or `null` when no plugin registered one. */\nexport function pluginShippingRateQuoter(): PluginShippingRateQuoter | null {\n  return resolvePluginServices(PLUGIN_SHIPPING_RATE_QUOTER)[0]?.impl ?? null\n}\n\n/**\n * Asks the quoter and gives up after `timeoutMs`: `null` when nobody is\n * registered, the site is not available, the provider failed, or the wait\n * ran out. Never throws. The caller's fallback is its own rates, so every\n * failure reads the same.\n */\nexport async function quotePluginShippingRates(\n  request: Omit<PluginShippingQuoteRequest, 'signal'>,\n  options: { timeoutMs: number },\n): Promise<PluginShippingQuote[] | null> {\n  const quoter = pluginShippingRateQuoter()\n  if (!quoter) return null\n  const controller = new AbortController()\n  let timer: ReturnType<typeof setTimeout> | undefined\n  const deadline = new Promise<null>((resolve) => {\n    timer = setTimeout(() => {\n      controller.abort()\n      resolve(null)\n    }, Math.max(0, options.timeoutMs))\n  })\n  try {\n    return await Promise.race([\n      (async (): Promise<PluginShippingQuote[] | null> => {\n        if (!(await quoter.available(request.hostId))) return null\n        return quoter.quote({ ...request, signal: controller.signal })\n      })().catch((): null => null),\n      deadline,\n    ])\n  } finally {\n    if (timer) clearTimeout(timer)\n  }\n}\n"],"names":["definePluginServiceContract","registerPluginService","resolvePluginServices","PLUGIN_SHIPPING_RATE_QUOTER","multiple","registerPluginShippingRateQuoter","quoter","options","pluginId","pluginShippingRateQuoter","impl","quotePluginShippingRates","request","controller","AbortController","timer","deadline","Promise","resolve","setTimeout","abort","Math","max","timeoutMs","race","available","hostId","quote","signal","catch","clearTimeout"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,2BAA2B,EAC3BC,qBAAqB,EACrBC,qBAAqB,QAChB,uBAAmB;AA2I1B,OAAO,MAAMC,8BACXH,4BAAsD,6BAA6B;IACjFI,UAAU;AACZ,GAAE;AAEJ,gFAAgF,GAChF,OAAO,SAASC,iCACdC,MAAgC,EAChCC,OAA+B;IAE/BN,sBAAsBE,6BAA6BG,QAAQ,aACrDC,CAAAA,2BAAAA,QAASC,QAAQ,IAAG;QAAEA,UAAUD,QAAQC,QAAQ;IAAC,IAAI,CAAC;AAE9D;AAEA,yDAAyD,GACzD,OAAO,SAASC;;QACPP;IAAP,gBAAOA,0BAAAA,sBAAsBC,4BAA4B,CAAC,EAAE,qBAArDD,wBAAuDQ,IAAI,mBAAI;AACxE;AAEA;;;;;CAKC,GACD,OAAO,eAAeC,yBACpBC,OAAmD,EACnDL,OAA8B;IAE9B,MAAMD,SAASG;IACf,IAAI,CAACH,QAAQ,OAAO;IACpB,MAAMO,aAAa,IAAIC;IACvB,IAAIC;IACJ,MAAMC,WAAW,IAAIC,QAAc,CAACC;QAClCH,QAAQI,WAAW;YACjBN,WAAWO,KAAK;YAChBF,QAAQ;QACV,GAAGG,KAAKC,GAAG,CAAC,GAAGf,QAAQgB,SAAS;IAClC;IACA,IAAI;QACF,OAAO,MAAMN,QAAQO,IAAI,CAAC;YACvB,CAAA;gBACC,IAAI,CAAE,MAAMlB,OAAOmB,SAAS,CAACb,QAAQc,MAAM,GAAI,OAAO;gBACtD,OAAOpB,OAAOqB,KAAK,CAAC,aAAKf;oBAASgB,QAAQf,WAAWe,MAAM;;YAC7D,CAAA,IAAKC,KAAK,CAAC,IAAY;YACvBb;SACD;IACH,SAAU;QACR,IAAID,OAAOe,aAAaf;IAC1B;AACF"}