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

package/src/lib/plugin-manager/plugin-local-deliveries.d.ts

@@ -0,0 +1,161 @@
+/**
+ * @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 type { PluginShippingAddress } from './plugin-shipping-rates';
+/**
+ * A seller's local deliveries, as a courier service sees them (AGL-3695).
+ *
+ * A seller that delivers its own goods in town keeps a delivery on each such
+ * record: where it leaves from, where it goes, the window the buyer booked,
+ * and where it stands (`scheduled` → `out_for_delivery` → `delivered`, or
+ * `failed`). A plugin that books an outside courier for that drop needs to
+ * read those facts and to write back what the courier did — and must not
+ * read the seller's documents for either. The seller registers
+ * {@link PluginLocalDeliveryRecords}; the courier plugin asks it.
+ *
+ * Every write is the seller's own: its transition rule, its timeline, the
+ * buyer's "out for delivery" and "delivered" messages and the handover that
+ * fulfills the record all stay inside the seller, so a drop a courier makes
+ * and one the store's own driver makes land the same way.
+ *
+ * The words are a seller's and a courier's, never one catalog's: a record is
+ * anything with goods taken to a door — an order, a rental, a catering job.
+ *
+ * Import this module by its own subpath
+ * (`@aglyn/aglyn/plugin-manager/plugin-local-deliveries`); it is not in the
+ * barrel.
+ */
+/** Where the seller's delivery stands. `failed` is a missed drop that may go out again. */
+export type PluginLocalDeliveryStatus = 'scheduled' | 'out_for_delivery' | 'delivered' | 'failed';
+/**
+ * Where an outside courier's run stands, in a courier-neutral word.
+ * `returning` and `returned` are a drop that did not happen and is coming
+ * back to the store.
+ */
+export type PluginCourierState = 'requested' | 'assigned' | 'at_pickup' | 'picked_up' | 'at_dropoff' | 'delivered' | 'cancelled' | 'returning' | 'returned';
+export declare const PLUGIN_COURIER_STATES: readonly PluginCourierState[];
+/** One end of the drop. */
+export interface PluginLocalDeliveryPlace {
+    /** A business at the pickup end; the person at the drop-off end. */
+    name: string;
+    address: PluginShippingAddress;
+    /** E.164, when the seller knows one. */
+    phone?: string;
+    /** What the courier does on arrival, in the seller's or the buyer's words. */
+    instructions?: string;
+}
+/** An outside courier's run on a record, as the seller keeps it. */
+export interface PluginRecordCourier {
+    /** The courier plugin's provider id: `doordash`. */
+    provider: string;
+    /** What a person calls it: `DoorDash`. */
+    providerLabel: string;
+    /** The courier's reference for the run. */
+    deliveryRef: string;
+    state: PluginCourierState;
+    /** The courier's own live tracking page, https. */
+    trackingUrl?: string;
+    /** When the courier expects to reach the door, epoch ms. */
+    etaMs?: number;
+    /** When the courier expects to collect, epoch ms. */
+    pickupEtaMs?: number;
+    /** Why a run was canceled or came back, in the courier's words. */
+    reason?: string;
+    /** Whether the run is in the courier's test environment: nobody is coming. */
+    testMode?: boolean;
+    updatedAtMs: number;
+}
+/** A record with a local delivery on it. */
+export interface PluginLocalDeliveryRecord {
+    hostId: string;
+    recordId: string;
+    /** What a person calls it: `#1042`. */
+    displayRef: string;
+    /** The seller's own status word for the record, shown as is. */
+    sellerStatus: string;
+    status: PluginLocalDeliveryStatus;
+    /**
+     * Whether the seller would hand this drop to a courier now: paid, not
+     * canceled or refunded, and not already delivered.
+     */
+    dispatchable: boolean;
+    /** ISO-4217, lower case. */
+    currency: string;
+    /** What the goods are worth, for the courier's cover. */
+    valueCents: number;
+    /** Units in the drop. */
+    itemCount: number;
+    /** Where the drop leaves from; `null` when the seller has no full street address for it. */
+    pickup: PluginLocalDeliveryPlace | null;
+    /** Where it goes; `null` when the record has no street address. */
+    dropoff: PluginLocalDeliveryPlace | null;
+    /** The window the buyer booked, epoch ms. */
+    windowStartMs?: number;
+    windowEndMs?: number;
+    /** Whether the record was paid in a payment provider's test mode: no money moved. */
+    testMode: boolean;
+    /** The courier run the seller last recorded, or `null`. */
+    courier: PluginRecordCourier | null;
+}
+/** A courier run to record, and the delivery step it brings. */
+export interface PluginRecordCourierWrite {
+    hostId: string;
+    recordId: string;
+    /** The run as it now stands; `null` clears it (the merchant canceled it and will deliver). */
+    courier: PluginRecordCourier | null;
+    /**
+     * The step this run moves the delivery to, under the seller's rules —
+     * `failed` with {@link reason} when the courier canceled or brought it
+     * back. Absent writes the run and moves nothing.
+     */
+    move?: Exclude<PluginLocalDeliveryStatus, 'scheduled'>;
+    reason?: string;
+}
+export type PluginRecordCourierOutcome = {
+    outcome: 'recorded';
+    status: PluginLocalDeliveryStatus;
+}
+/** The record already said this, so nothing was written. */
+ | {
+    outcome: 'unchanged';
+    status: PluginLocalDeliveryStatus;
+} | {
+    outcome: 'no_such_record';
+}
+/** The record is not a local delivery. */
+ | {
+    outcome: 'not_local_delivery';
+}
+/** The seller's rules refused the step; the run itself was recorded. `from` is the status that refused. */
+ | {
+    outcome: 'blocked';
+    from: string;
+};
+export interface PluginLocalDeliveryRecords {
+    /** One record, or `null` when the site has none by that id or it is not a local delivery. */
+    read(hostId: string, recordId: string): Promise<PluginLocalDeliveryRecord | null>;
+    /** Writes a courier run, and the step it brings, under the seller's own rules. */
+    recordCourier(write: PluginRecordCourierWrite): Promise<PluginRecordCourierOutcome>;
+}
+export declare const PLUGIN_LOCAL_DELIVERY_RECORDS: import("./plugin-services").PluginServiceContract<PluginLocalDeliveryRecords>;
+/** Registers the seller. A second plugin is refused naming both. */
+export declare function registerPluginLocalDeliveryRecords(records: PluginLocalDeliveryRecords, options?: {
+    pluginId?: string;
+}): void;
+/** The seller, or `null` when no plugin registered one. */
+export declare function pluginLocalDeliveryRecords(): PluginLocalDeliveryRecords | null;
+/** Whether a courier run is over: nothing more will happen on it. */
+export declare function pluginCourierStateIsFinal(state: PluginCourierState): boolean;

package/src/lib/plugin-manager/plugin-local-deliveries.js

@@ -0,0 +1,46 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { definePluginServiceContract, registerPluginService, resolvePluginServices } from "./plugin-services.js";
+export const PLUGIN_COURIER_STATES = [
+    'requested',
+    'assigned',
+    'at_pickup',
+    'picked_up',
+    'at_dropoff',
+    'delivered',
+    'cancelled',
+    'returning',
+    'returned'
+];
+export const PLUGIN_LOCAL_DELIVERY_RECORDS = definePluginServiceContract('core.local-delivery-records', {
+    multiple: false
+});
+/** Registers the seller. A second plugin is refused naming both. */ export function registerPluginLocalDeliveryRecords(records, options) {
+    registerPluginService(PLUGIN_LOCAL_DELIVERY_RECORDS, records, _extends({}, (options == null ? void 0 : options.pluginId) ? {
+        pluginId: options.pluginId
+    } : {}));
+}
+/** The seller, or `null` when no plugin registered one. */ export function pluginLocalDeliveryRecords() {
+    var _ref;
+    var _resolvePluginServices_;
+    return (_ref = (_resolvePluginServices_ = resolvePluginServices(PLUGIN_LOCAL_DELIVERY_RECORDS)[0]) == null ? void 0 : _resolvePluginServices_.impl) != null ? _ref : null;
+}
+/** Whether a courier run is over: nothing more will happen on it. */ export function pluginCourierStateIsFinal(state) {
+    return state === 'delivered' || state === 'cancelled' || state === 'returned';
+}
+
+//# sourceMappingURL=plugin-local-deliveries.js.map

package/src/lib/plugin-manager/plugin-local-deliveries.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-local-deliveries.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 type { PluginShippingAddress } from './plugin-shipping-rates'\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginServices,\n} from './plugin-services'\n\n/**\n * A seller's local deliveries, as a courier service sees them (AGL-3695).\n *\n * A seller that delivers its own goods in town keeps a delivery on each such\n * record: where it leaves from, where it goes, the window the buyer booked,\n * and where it stands (`scheduled` → `out_for_delivery` → `delivered`, or\n * `failed`). A plugin that books an outside courier for that drop needs to\n * read those facts and to write back what the courier did — and must not\n * read the seller's documents for either. The seller registers\n * {@link PluginLocalDeliveryRecords}; the courier plugin asks it.\n *\n * Every write is the seller's own: its transition rule, its timeline, the\n * buyer's \"out for delivery\" and \"delivered\" messages and the handover that\n * fulfills the record all stay inside the seller, so a drop a courier makes\n * and one the store's own driver makes land the same way.\n *\n * The words are a seller's and a courier's, never one catalog's: a record is\n * anything with goods taken to a door — an order, a rental, a catering job.\n *\n * Import this module by its own subpath\n * (`@aglyn/aglyn/plugin-manager/plugin-local-deliveries`); it is not in the\n * barrel.\n */\n\n/** Where the seller's delivery stands. `failed` is a missed drop that may go out again. */\nexport type PluginLocalDeliveryStatus = 'scheduled' | 'out_for_delivery' | 'delivered' | 'failed'\n\n/**\n * Where an outside courier's run stands, in a courier-neutral word.\n * `returning` and `returned` are a drop that did not happen and is coming\n * back to the store.\n */\nexport type PluginCourierState =\n  | 'requested'\n  | 'assigned'\n  | 'at_pickup'\n  | 'picked_up'\n  | 'at_dropoff'\n  | 'delivered'\n  | 'cancelled'\n  | 'returning'\n  | 'returned'\n\nexport const PLUGIN_COURIER_STATES: readonly PluginCourierState[] = [\n  'requested',\n  'assigned',\n  'at_pickup',\n  'picked_up',\n  'at_dropoff',\n  'delivered',\n  'cancelled',\n  'returning',\n  'returned',\n]\n\n/** One end of the drop. */\nexport interface PluginLocalDeliveryPlace {\n  /** A business at the pickup end; the person at the drop-off end. */\n  name: string\n  address: PluginShippingAddress\n  /** E.164, when the seller knows one. */\n  phone?: string\n  /** What the courier does on arrival, in the seller's or the buyer's words. */\n  instructions?: string\n}\n\n/** An outside courier's run on a record, as the seller keeps it. */\nexport interface PluginRecordCourier {\n  /** The courier plugin's provider id: `doordash`. */\n  provider: string\n  /** What a person calls it: `DoorDash`. */\n  providerLabel: string\n  /** The courier's reference for the run. */\n  deliveryRef: string\n  state: PluginCourierState\n  /** The courier's own live tracking page, https. */\n  trackingUrl?: string\n  /** When the courier expects to reach the door, epoch ms. */\n  etaMs?: number\n  /** When the courier expects to collect, epoch ms. */\n  pickupEtaMs?: number\n  /** Why a run was canceled or came back, in the courier's words. */\n  reason?: string\n  /** Whether the run is in the courier's test environment: nobody is coming. */\n  testMode?: boolean\n  updatedAtMs: number\n}\n\n/** A record with a local delivery on it. */\nexport interface PluginLocalDeliveryRecord {\n  hostId: string\n  recordId: string\n  /** What a person calls it: `#1042`. */\n  displayRef: string\n  /** The seller's own status word for the record, shown as is. */\n  sellerStatus: string\n  status: PluginLocalDeliveryStatus\n  /**\n   * Whether the seller would hand this drop to a courier now: paid, not\n   * canceled or refunded, and not already delivered.\n   */\n  dispatchable: boolean\n  /** ISO-4217, lower case. */\n  currency: string\n  /** What the goods are worth, for the courier's cover. */\n  valueCents: number\n  /** Units in the drop. */\n  itemCount: number\n  /** Where the drop leaves from; `null` when the seller has no full street address for it. */\n  pickup: PluginLocalDeliveryPlace | null\n  /** Where it goes; `null` when the record has no street address. */\n  dropoff: PluginLocalDeliveryPlace | null\n  /** The window the buyer booked, epoch ms. */\n  windowStartMs?: number\n  windowEndMs?: number\n  /** Whether the record was paid in a payment provider's test mode: no money moved. */\n  testMode: boolean\n  /** The courier run the seller last recorded, or `null`. */\n  courier: PluginRecordCourier | null\n}\n\n/** A courier run to record, and the delivery step it brings. */\nexport interface PluginRecordCourierWrite {\n  hostId: string\n  recordId: string\n  /** The run as it now stands; `null` clears it (the merchant canceled it and will deliver). */\n  courier: PluginRecordCourier | null\n  /**\n   * The step this run moves the delivery to, under the seller's rules —\n   * `failed` with {@link reason} when the courier canceled or brought it\n   * back. Absent writes the run and moves nothing.\n   */\n  move?: Exclude<PluginLocalDeliveryStatus, 'scheduled'>\n  reason?: string\n}\n\nexport type PluginRecordCourierOutcome =\n  | { outcome: 'recorded'; status: PluginLocalDeliveryStatus }\n  /** The record already said this, so nothing was written. */\n  | { outcome: 'unchanged'; status: PluginLocalDeliveryStatus }\n  | { outcome: 'no_such_record' }\n  /** The record is not a local delivery. */\n  | { outcome: 'not_local_delivery' }\n  /** The seller's rules refused the step; the run itself was recorded. `from` is the status that refused. */\n  | { outcome: 'blocked'; from: string }\n\nexport interface PluginLocalDeliveryRecords {\n  /** One record, or `null` when the site has none by that id or it is not a local delivery. */\n  read(hostId: string, recordId: string): Promise<PluginLocalDeliveryRecord | null>\n  /** Writes a courier run, and the step it brings, under the seller's own rules. */\n  recordCourier(write: PluginRecordCourierWrite): Promise<PluginRecordCourierOutcome>\n}\n\nexport const PLUGIN_LOCAL_DELIVERY_RECORDS =\n  definePluginServiceContract<PluginLocalDeliveryRecords>('core.local-delivery-records', {\n    multiple: false,\n  })\n\n/** Registers the seller. A second plugin is refused naming both. */\nexport function registerPluginLocalDeliveryRecords(\n  records: PluginLocalDeliveryRecords,\n  options?: { pluginId?: string },\n): void {\n  registerPluginService(PLUGIN_LOCAL_DELIVERY_RECORDS, records, {\n    ...(options?.pluginId ? { pluginId: options.pluginId } : {}),\n  })\n}\n\n/** The seller, or `null` when no plugin registered one. */\nexport function pluginLocalDeliveryRecords(): PluginLocalDeliveryRecords | null {\n  return resolvePluginServices(PLUGIN_LOCAL_DELIVERY_RECORDS)[0]?.impl ?? null\n}\n\n/** Whether a courier run is over: nothing more will happen on it. */\nexport function pluginCourierStateIsFinal(state: PluginCourierState): boolean {\n  return state === 'delivered' || state === 'cancelled' || state === 'returned'\n}\n"],"names":["definePluginServiceContract","registerPluginService","resolvePluginServices","PLUGIN_COURIER_STATES","PLUGIN_LOCAL_DELIVERY_RECORDS","multiple","registerPluginLocalDeliveryRecords","records","options","pluginId","pluginLocalDeliveryRecords","impl","pluginCourierStateIsFinal","state"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SACEA,2BAA2B,EAC3BC,qBAAqB,EACrBC,qBAAqB,QAChB,uBAAmB;AA6C1B,OAAO,MAAMC,wBAAuD;IAClE;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;CACD,CAAA;AAoGD,OAAO,MAAMC,gCACXJ,4BAAwD,+BAA+B;IACrFK,UAAU;AACZ,GAAE;AAEJ,kEAAkE,GAClE,OAAO,SAASC,mCACdC,OAAmC,EACnCC,OAA+B;IAE/BP,sBAAsBG,+BAA+BG,SAAS,aACxDC,CAAAA,2BAAAA,QAASC,QAAQ,IAAG;QAAEA,UAAUD,QAAQC,QAAQ;IAAC,IAAI,CAAC;AAE9D;AAEA,yDAAyD,GACzD,OAAO,SAASC;;QACPR;IAAP,gBAAOA,0BAAAA,sBAAsBE,8BAA8B,CAAC,EAAE,qBAAvDF,wBAAyDS,IAAI,mBAAI;AAC1E;AAEA,mEAAmE,GACnE,OAAO,SAASC,0BAA0BC,KAAyB;IACjE,OAAOA,UAAU,eAAeA,UAAU,eAAeA,UAAU;AACrE"}

package/src/lib/plugin-manager/plugin-media-ingest.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @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 type { AglynHostMediaStockSource } from '../foundation/definitions/platform.types';
+/**
+ * A SERVER PROCESS STORES A PICTURE IN A SITE'S MEDIA LIBRARY (AGL-3660).
+ *
+ * The media library takes bytes through the console's own ingress — the
+ * upload routes and the v1 API — which check the caller, the site's
+ * lockdown, the bytes' structure, the takedown list, the plan and the
+ * storage band before anything is written. A plugin that holds a picture on
+ * the server with no browser request behind it (an AI job copying a stock
+ * photo) has no route to post to. This is that route's door for it: the
+ * console registers the one implementation at boot (`instrumentation.ts`),
+ * the same direction as `core.site-cache`, and it applies the ingress checks
+ * as the member named, so a plugin never writes a media document or a
+ * Storage object itself.
+ *
+ * Images only: a server-held video or document has no caller yet.
+ *
+ * A process with no implementation answers `null` from
+ * {@link pluginMediaIngest}, and a caller keeps its own fallback.
+ */
+export interface PluginMediaIngestRequest {
+    hostId: string;
+    /**
+     * The member the asset is stored as. Their access to the site, the site's
+     * lockdown and the workspace's plan and storage band are checked as for
+     * an upload they made themselves.
+     */
+    uid: string;
+    fileName: string;
+    /** A raster image type: `image/jpeg`, `image/png`, `image/webp` or `image/gif`. */
+    contentType: string;
+    bytes: Uint8Array;
+    alt?: string;
+    description?: string;
+    /** Where a photo copied from a stock library came from (`stockPhoto` on the asset). */
+    stockPhoto?: Omit<AglynHostMediaStockSource, 'importedAt'>;
+}
+/** A stored asset, as a page names it. */
+export interface PluginMediaAsset {
+    mediaId: string;
+    /** What an `image` node's `src` holds: the asset's media reference, else its URL. */
+    src: string;
+    width?: number;
+    height?: number;
+}
+export type PluginMediaIngestResult = ({
+    ok: true;
+} & PluginMediaAsset) | {
+    ok: false;
+    status: number;
+    reason: string;
+};
+export interface PluginMediaIngest {
+    /** Stores one picture in the site's own library. */
+    ingest(request: PluginMediaIngestRequest): Promise<PluginMediaIngestResult>;
+    /**
+     * The site's live, public asset copied from a stock photo with this source
+     * key (`{provider}:{id}`), so a photo is never stored twice in one library.
+     */
+    findStockPhoto(input: {
+        hostId: string;
+        sourceKey: string;
+    }): Promise<PluginMediaAsset | null>;
+}
+/** One implementation: the app that holds the media ingress. */
+export declare const PLUGIN_MEDIA_INGEST: import("./plugin-services").PluginServiceContract<PluginMediaIngest>;
+export declare function registerPluginMediaIngest(ingest: PluginMediaIngest, options?: {
+    pluginId?: string;
+}): void;
+/** The registered ingest, or `null` in a process that registered none. */
+export declare function pluginMediaIngest(): PluginMediaIngest | null;

package/src/lib/plugin-manager/plugin-media-ingest.js

@@ -0,0 +1,34 @@
+/**
+ * @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 { _ as _extends } from "@swc/helpers/_/_extends";
+import { definePluginServiceContract, registerPluginService, resolvePluginService } from "./plugin-services.js";
+/** One implementation: the app that holds the media ingress. */ export const PLUGIN_MEDIA_INGEST = definePluginServiceContract('core.media-ingest', {
+    multiple: false
+});
+export function registerPluginMediaIngest(ingest, options) {
+    if (typeof (ingest == null ? void 0 : ingest.ingest) !== 'function' || typeof (ingest == null ? void 0 : ingest.findStockPhoto) !== 'function') {
+        throw new Error('a media ingest needs ingest and findStockPhoto');
+    }
+    registerPluginService(PLUGIN_MEDIA_INGEST, ingest, _extends({}, (options == null ? void 0 : options.pluginId) ? {
+        pluginId: options.pluginId
+    } : {}));
+}
+/** The registered ingest, or `null` in a process that registered none. */ export function pluginMediaIngest() {
+    var _resolvePluginService;
+    return (_resolvePluginService = resolvePluginService(PLUGIN_MEDIA_INGEST)) != null ? _resolvePluginService : null;
+}
+
+//# sourceMappingURL=plugin-media-ingest.js.map

package/src/lib/plugin-manager/plugin-media-ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-media-ingest.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 type { AglynHostMediaStockSource } from '../foundation/definitions/platform.types'\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginService,\n} from './plugin-services'\n\n/**\n * A SERVER PROCESS STORES A PICTURE IN A SITE'S MEDIA LIBRARY (AGL-3660).\n *\n * The media library takes bytes through the console's own ingress — the\n * upload routes and the v1 API — which check the caller, the site's\n * lockdown, the bytes' structure, the takedown list, the plan and the\n * storage band before anything is written. A plugin that holds a picture on\n * the server with no browser request behind it (an AI job copying a stock\n * photo) has no route to post to. This is that route's door for it: the\n * console registers the one implementation at boot (`instrumentation.ts`),\n * the same direction as `core.site-cache`, and it applies the ingress checks\n * as the member named, so a plugin never writes a media document or a\n * Storage object itself.\n *\n * Images only: a server-held video or document has no caller yet.\n *\n * A process with no implementation answers `null` from\n * {@link pluginMediaIngest}, and a caller keeps its own fallback.\n */\n\nexport interface PluginMediaIngestRequest {\n  hostId: string\n  /**\n   * The member the asset is stored as. Their access to the site, the site's\n   * lockdown and the workspace's plan and storage band are checked as for\n   * an upload they made themselves.\n   */\n  uid: string\n  fileName: string\n  /** A raster image type: `image/jpeg`, `image/png`, `image/webp` or `image/gif`. */\n  contentType: string\n  bytes: Uint8Array\n  alt?: string\n  description?: string\n  /** Where a photo copied from a stock library came from (`stockPhoto` on the asset). */\n  stockPhoto?: Omit<AglynHostMediaStockSource, 'importedAt'>\n}\n\n/** A stored asset, as a page names it. */\nexport interface PluginMediaAsset {\n  mediaId: string\n  /** What an `image` node's `src` holds: the asset's media reference, else its URL. */\n  src: string\n  width?: number\n  height?: number\n}\n\nexport type PluginMediaIngestResult =\n  | ({ ok: true } & PluginMediaAsset)\n  | { ok: false; status: number; reason: string }\n\nexport interface PluginMediaIngest {\n  /** Stores one picture in the site's own library. */\n  ingest(request: PluginMediaIngestRequest): Promise<PluginMediaIngestResult>\n  /**\n   * The site's live, public asset copied from a stock photo with this source\n   * key (`{provider}:{id}`), so a photo is never stored twice in one library.\n   */\n  findStockPhoto(input: { hostId: string; sourceKey: string }): Promise<PluginMediaAsset | null>\n}\n\n/** One implementation: the app that holds the media ingress. */\nexport const PLUGIN_MEDIA_INGEST = definePluginServiceContract<PluginMediaIngest>(\n  'core.media-ingest',\n  { multiple: false },\n)\n\nexport function registerPluginMediaIngest(\n  ingest: PluginMediaIngest,\n  options?: { pluginId?: string },\n): void {\n  if (typeof ingest?.ingest !== 'function' || typeof ingest?.findStockPhoto !== 'function') {\n    throw new Error('a media ingest needs ingest and findStockPhoto')\n  }\n  registerPluginService(PLUGIN_MEDIA_INGEST, ingest, {\n    ...(options?.pluginId ? { pluginId: options.pluginId } : {}),\n  })\n}\n\n/** The registered ingest, or `null` in a process that registered none. */\nexport function pluginMediaIngest(): PluginMediaIngest | null {\n  return resolvePluginService(PLUGIN_MEDIA_INGEST) ?? null\n}\n"],"names":["definePluginServiceContract","registerPluginService","resolvePluginService","PLUGIN_MEDIA_INGEST","multiple","registerPluginMediaIngest","ingest","options","findStockPhoto","Error","pluginId","pluginMediaIngest"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SACEA,2BAA2B,EAC3BC,qBAAqB,EACrBC,oBAAoB,QACf,uBAAmB;AA+D1B,8DAA8D,GAC9D,OAAO,MAAMC,sBAAsBH,4BACjC,qBACA;IAAEI,UAAU;AAAM,GACnB;AAED,OAAO,SAASC,0BACdC,MAAyB,EACzBC,OAA+B;IAE/B,IAAI,QAAOD,0BAAAA,OAAQA,MAAM,MAAK,cAAc,QAAOA,0BAAAA,OAAQE,cAAc,MAAK,YAAY;QACxF,MAAM,IAAIC,MAAM;IAClB;IACAR,sBAAsBE,qBAAqBG,QAAQ,aAC7CC,CAAAA,2BAAAA,QAASG,QAAQ,IAAG;QAAEA,UAAUH,QAAQG,QAAQ;IAAC,IAAI,CAAC;AAE9D;AAEA,wEAAwE,GACxE,OAAO,SAASC;QACPT;IAAP,QAAOA,wBAAAA,qBAAqBC,gCAArBD,wBAA6C;AACtD"}

package/src/lib/plugin-manager/plugin-order-email-copies.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @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.
+ */
+/**
+ * Copies of a buyer's order email, asked for by another plugin (AGL-3699).
+ *
+ * Some services learn about a sale by being copied on the mail the buyer
+ * already gets: Trustpilot gives every business an invitation address, and
+ * an order email blind-copied to it — with a small structured-data block
+ * naming the buyer and the order — becomes a review invitation. A plugin
+ * that wants that registers here; the seller asks just before it sends a
+ * buyer email about an order, adds whatever blind copies and data blocks
+ * come back, and tells each provider whether the message left.
+ *
+ * The words are an order email's: a site, the record, which email (its
+ * designable key), which moment, the buyer's address, and the order as the
+ * seller's public API shapes it. A provider answers `null` to add nothing.
+ * Import this module by its own subpath
+ * (`@aglyn/aglyn/plugin-manager/plugin-order-email-copies`); it is not in the
+ * barrel.
+ */
+export interface PluginOrderEmailCopyRequest {
+    hostId: string;
+    recordId: string;
+    /** The designable email being sent, e.g. `order-shipped`. */
+    emailKey: string;
+    /** The moment in the order's life, e.g. `shipped`, `delivered`, `picked_up`. */
+    moment: string;
+    /** The buyer's address the email is to. */
+    recipient: string;
+    /** The order as the seller's public API returns it. */
+    order: Readonly<Record<string, unknown>>;
+    signal?: AbortSignal;
+}
+/** A structured-data block a copy's reader looks for in the HTML part. */
+export interface PluginOrderEmailDataBlock {
+    /** The `<script type>`: `application/json`, `application/ld+json` or `application/json+<name>`. */
+    type: string;
+    json: unknown;
+}
+export interface PluginOrderEmailCopy {
+    /** Addresses blind-copied on the message. */
+    bcc: string[];
+    /** Blocks added to the HTML part, where only a machine reads them. */
+    dataBlocks?: PluginOrderEmailDataBlock[];
+    /**
+     * Told once whether the message left with these copies on it, so a
+     * provider that claimed the order can keep or release its claim. Never
+     * throws into the seller.
+     */
+    settle?: (sent: boolean) => Promise<void>;
+}
+export type PluginOrderEmailCopyProvider = (request: PluginOrderEmailCopyRequest) => Promise<PluginOrderEmailCopy | null>;
+/** Joins the providers. Re-registering under the same plugin replaces its own. */
+export declare function registerPluginOrderEmailCopies(provider: PluginOrderEmailCopyProvider, options?: {
+    pluginId?: string;
+}): void;
+/** The copies every provider asked for on one email, joined. */
+export interface ResolvedOrderEmailCopies {
+    bcc: string[];
+    /** The data blocks as markup, ready to go before `</body>`; `''` when none. */
+    html: string;
+    /** Tells every provider that answered whether the message left. Never throws. */
+    settle: (sent: boolean) => Promise<void>;
+}
+/**
+ * A data block as a `<script>` element. The JSON is escaped so no value can
+ * close the element or open markup of its own.
+ */
+export declare function orderEmailDataBlockHtml(block: PluginOrderEmailDataBlock): string;
+/** Puts `markup` just before `</body>`, or at the end of a fragment with none. */
+export declare function withOrderEmailDataBlocks(html: string, markup: string): string;
+/**
+ * Asks every provider, together, and gives up on any that has not answered
+ * after `timeoutMs` — a late answer adds nothing and is told the message
+ * did not carry it. A provider that throws adds nothing. Never throws.
+ */
+export declare function resolvePluginOrderEmailCopies(request: Omit<PluginOrderEmailCopyRequest, 'signal'>, options: {
+    timeoutMs: number;
+}): Promise<ResolvedOrderEmailCopies>;

package/src/lib/plugin-manager/plugin-order-email-copies.js

@@ -0,0 +1,104 @@
+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 PLUGIN_ORDER_EMAIL_COPIES = definePluginServiceContract('core.order-email-copies', {
+    multiple: true
+});
+/** Joins the providers. Re-registering under the same plugin replaces its own. */ export function registerPluginOrderEmailCopies(provider, options) {
+    var _getRegisteringPluginId;
+    const pluginId = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId;
+    registerPluginService(PLUGIN_ORDER_EMAIL_COPIES, provider, _extends({}, pluginId ? {
+        pluginId
+    } : {}));
+}
+const EMAIL = /^[^\s@<>",;]+@[^\s@<>",;]+\.[^\s@<>",;]+$/;
+const DATA_TYPE = /^application\/(ld\+)?json(\+[a-z0-9-]{1,40})?$/;
+/**
+ * A data block as a `<script>` element. The JSON is escaped so no value can
+ * close the element or open markup of its own.
+ */ export function orderEmailDataBlockHtml(block) {
+    var _block_json;
+    const json = JSON.stringify((_block_json = block.json) != null ? _block_json : null).replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/&/g, '\\u0026').replace(/\u2028/g, '\\u2028').replace(/\u2029/g, '\\u2029');
+    return `<script type="${block.type}">${json}</script>`;
+}
+/** Puts `markup` just before `</body>`, or at the end of a fragment with none. */ export function withOrderEmailDataBlocks(html, markup) {
+    if (!markup) return html;
+    const close = html.toLowerCase().lastIndexOf('</body>');
+    return close === -1 ? `${html}${markup}` : `${html.slice(0, close)}${markup}${html.slice(close)}`;
+}
+/**
+ * Asks every provider, together, and gives up on any that has not answered
+ * after `timeoutMs` — a late answer adds nothing and is told the message
+ * did not carry it. A provider that throws adds nothing. Never throws.
+ */ export async function resolvePluginOrderEmailCopies(request, options) {
+    var _request_recipient;
+    const providers = resolvePluginServices(PLUGIN_ORDER_EMAIL_COPIES);
+    const empty = {
+        bcc: [],
+        html: '',
+        settle: async ()=>undefined
+    };
+    if (!providers.length || !EMAIL.test(String((_request_recipient = request.recipient) != null ? _request_recipient : '').trim())) return empty;
+    const controller = new AbortController();
+    const timer = setTimeout(()=>controller.abort(), Math.max(0, options.timeoutMs));
+    const late = new Promise((resolve)=>controller.signal.addEventListener('abort', ()=>resolve('late')));
+    const recipient = String(request.recipient).trim().toLowerCase();
+    try {
+        const answers = await Promise.all(providers.map(async (entry)=>{
+            const pending = entry.impl(_extends({}, request, {
+                signal: controller.signal
+            })).catch((error)=>{
+                console.error(`[order-email-copies] provider "${entry.pluginId}" failed for ${request.hostId}`, error);
+                return null;
+            });
+            const answer = await Promise.race([
+                pending,
+                late
+            ]);
+            if (answer === 'late') {
+                // It may still claim something after the deadline: tell it the
+                // message went without it once it does.
+                void pending.then((copy)=>{
+                    var _copy_settle;
+                    return void (copy == null ? void 0 : (_copy_settle = copy.settle) == null ? void 0 : _copy_settle.call(copy, false).catch(()=>undefined));
+                });
+                return null;
+            }
+            return answer;
+        }));
+        const copies = answers.filter((copy)=>Boolean(copy));
+        const bcc = [
+            ...new Set(copies.flatMap((copy)=>Array.isArray(copy.bcc) ? copy.bcc : []).map((address)=>String(address != null ? address : '').trim()).filter((address)=>EMAIL.test(address) && address.toLowerCase() !== recipient))
+        ];
+        const html = copies.flatMap((copy)=>Array.isArray(copy.dataBlocks) ? copy.dataBlocks : []).filter((block)=>{
+            var _block_type;
+            return block && DATA_TYPE.test(String((_block_type = block.type) != null ? _block_type : ''));
+        }).map(orderEmailDataBlockHtml).join('');
+        return {
+            bcc,
+            html,
+            settle: async (sent)=>{
+                await Promise.all(copies.map((copy)=>Promise.resolve().then(()=>copy.settle == null ? void 0 : copy.settle.call(copy, sent)).catch((error)=>console.error('[order-email-copies] settle failed', error))));
+            }
+        };
+    } finally{
+        clearTimeout(timer);
+    }
+}
+
+//# sourceMappingURL=plugin-order-email-copies.js.map

package/src/lib/plugin-manager/plugin-order-email-copies.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-order-email-copies.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 * Copies of a buyer's order email, asked for by another plugin (AGL-3699).\n *\n * Some services learn about a sale by being copied on the mail the buyer\n * already gets: Trustpilot gives every business an invitation address, and\n * an order email blind-copied to it — with a small structured-data block\n * naming the buyer and the order — becomes a review invitation. A plugin\n * that wants that registers here; the seller asks just before it sends a\n * buyer email about an order, adds whatever blind copies and data blocks\n * come back, and tells each provider whether the message left.\n *\n * The words are an order email's: a site, the record, which email (its\n * designable key), which moment, the buyer's address, and the order as the\n * seller's public API shapes it. A provider answers `null` to add nothing.\n * Import this module by its own subpath\n * (`@aglyn/aglyn/plugin-manager/plugin-order-email-copies`); it is not in the\n * barrel.\n */\n\nexport interface PluginOrderEmailCopyRequest {\n  hostId: string\n  recordId: string\n  /** The designable email being sent, e.g. `order-shipped`. */\n  emailKey: string\n  /** The moment in the order's life, e.g. `shipped`, `delivered`, `picked_up`. */\n  moment: string\n  /** The buyer's address the email is to. */\n  recipient: string\n  /** The order as the seller's public API returns it. */\n  order: Readonly<Record<string, unknown>>\n  signal?: AbortSignal\n}\n\n/** A structured-data block a copy's reader looks for in the HTML part. */\nexport interface PluginOrderEmailDataBlock {\n  /** The `<script type>`: `application/json`, `application/ld+json` or `application/json+<name>`. */\n  type: string\n  json: unknown\n}\n\nexport interface PluginOrderEmailCopy {\n  /** Addresses blind-copied on the message. */\n  bcc: string[]\n  /** Blocks added to the HTML part, where only a machine reads them. */\n  dataBlocks?: PluginOrderEmailDataBlock[]\n  /**\n   * Told once whether the message left with these copies on it, so a\n   * provider that claimed the order can keep or release its claim. Never\n   * throws into the seller.\n   */\n  settle?: (sent: boolean) => Promise<void>\n}\n\nexport type PluginOrderEmailCopyProvider = (\n  request: PluginOrderEmailCopyRequest,\n) => Promise<PluginOrderEmailCopy | null>\n\nconst PLUGIN_ORDER_EMAIL_COPIES = definePluginServiceContract<PluginOrderEmailCopyProvider>(\n  'core.order-email-copies',\n  { multiple: true },\n)\n\n/** Joins the providers. Re-registering under the same plugin replaces its own. */\nexport function registerPluginOrderEmailCopies(\n  provider: PluginOrderEmailCopyProvider,\n  options?: { pluginId?: string },\n): void {\n  const pluginId = getRegisteringPluginId() ?? options?.pluginId\n  registerPluginService(PLUGIN_ORDER_EMAIL_COPIES, provider, {\n    ...(pluginId ? { pluginId } : {}),\n  })\n}\n\nconst EMAIL = /^[^\\s@<>\",;]+@[^\\s@<>\",;]+\\.[^\\s@<>\",;]+$/\nconst DATA_TYPE = /^application\\/(ld\\+)?json(\\+[a-z0-9-]{1,40})?$/\n\n/** The copies every provider asked for on one email, joined. */\nexport interface ResolvedOrderEmailCopies {\n  bcc: string[]\n  /** The data blocks as markup, ready to go before `</body>`; `''` when none. */\n  html: string\n  /** Tells every provider that answered whether the message left. Never throws. */\n  settle: (sent: boolean) => Promise<void>\n}\n\n/**\n * A data block as a `<script>` element. The JSON is escaped so no value can\n * close the element or open markup of its own.\n */\nexport function orderEmailDataBlockHtml(block: PluginOrderEmailDataBlock): string {\n  const json = JSON.stringify(block.json ?? null)\n    .replace(/</g, '\\\\u003c')\n    .replace(/>/g, '\\\\u003e')\n    .replace(/&/g, '\\\\u0026')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029')\n  return `<script type=\"${block.type}\">${json}</script>`\n}\n\n/** Puts `markup` just before `</body>`, or at the end of a fragment with none. */\nexport function withOrderEmailDataBlocks(html: string, markup: string): string {\n  if (!markup) return html\n  const close = html.toLowerCase().lastIndexOf('</body>')\n  return close === -1 ? `${html}${markup}` : `${html.slice(0, close)}${markup}${html.slice(close)}`\n}\n\n/**\n * Asks every provider, together, and gives up on any that has not answered\n * after `timeoutMs` — a late answer adds nothing and is told the message\n * did not carry it. A provider that throws adds nothing. Never throws.\n */\nexport async function resolvePluginOrderEmailCopies(\n  request: Omit<PluginOrderEmailCopyRequest, 'signal'>,\n  options: { timeoutMs: number },\n): Promise<ResolvedOrderEmailCopies> {\n  const providers = resolvePluginServices(PLUGIN_ORDER_EMAIL_COPIES)\n  const empty: ResolvedOrderEmailCopies = { bcc: [], html: '', settle: async () => undefined }\n  if (!providers.length || !EMAIL.test(String(request.recipient ?? '').trim())) return empty\n  const controller = new AbortController()\n  const timer = setTimeout(() => controller.abort(), Math.max(0, options.timeoutMs))\n  const late = new Promise<'late'>((resolve) => controller.signal.addEventListener('abort', () => resolve('late')))\n  const recipient = String(request.recipient).trim().toLowerCase()\n  try {\n    const answers = await Promise.all(\n      providers.map(async (entry) => {\n        const pending = entry.impl({ ...request, signal: controller.signal }).catch((error: unknown): null => {\n          console.error(`[order-email-copies] provider \"${entry.pluginId}\" failed for ${request.hostId}`, error)\n          return null\n        })\n        const answer = await Promise.race([pending, late])\n        if (answer === 'late') {\n          // It may still claim something after the deadline: tell it the\n          // message went without it once it does.\n          void pending.then((copy): void => void copy?.settle?.(false).catch((): undefined => undefined))\n          return null\n        }\n        return answer\n      }),\n    )\n    const copies = answers.filter((copy): copy is PluginOrderEmailCopy => Boolean(copy))\n    const bcc = [\n      ...new Set(\n        copies\n          .flatMap((copy) => (Array.isArray(copy.bcc) ? copy.bcc : []))\n          .map((address) => String(address ?? '').trim())\n          .filter((address) => EMAIL.test(address) && address.toLowerCase() !== recipient),\n      ),\n    ]\n    const html = copies\n      .flatMap((copy) => (Array.isArray(copy.dataBlocks) ? copy.dataBlocks : []))\n      .filter((block) => block && DATA_TYPE.test(String(block.type ?? '')))\n      .map(orderEmailDataBlockHtml)\n      .join('')\n    return {\n      bcc,\n      html,\n      settle: async (sent) => {\n        await Promise.all(\n          copies.map((copy) =>\n            Promise.resolve()\n              .then(() => copy.settle?.(sent))\n              .catch((error: unknown) => console.error('[order-email-copies] settle failed', error)),\n          ),\n        )\n      },\n    }\n  } finally {\n    clearTimeout(timer)\n  }\n}\n"],"names":["getRegisteringPluginId","definePluginServiceContract","registerPluginService","resolvePluginServices","PLUGIN_ORDER_EMAIL_COPIES","multiple","registerPluginOrderEmailCopies","provider","options","pluginId","EMAIL","DATA_TYPE","orderEmailDataBlockHtml","block","json","JSON","stringify","replace","type","withOrderEmailDataBlocks","html","markup","close","toLowerCase","lastIndexOf","slice","resolvePluginOrderEmailCopies","request","providers","empty","bcc","settle","undefined","length","test","String","recipient","trim","controller","AbortController","timer","setTimeout","abort","Math","max","timeoutMs","late","Promise","resolve","signal","addEventListener","answers","all","map","entry","pending","impl","catch","error","console","hostId","answer","race","then","copy","copies","filter","Boolean","Set","flatMap","Array","isArray","address","dataBlocks","join","sent","clearTimeout"],"mappings":"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"}

package/src/lib/plugin-manager/plugin-shipment-records.d.ts

@@ -119,6 +119,13 @@ export interface PluginShipmentWrite {
     /** The label's file, an https URL the seller may show beside the shipment. */
     labelUrl?: string;
     labelRef?: string;
+    /**
+     * What the label cost the seller, in integer cents of the record's
+     * currency (AGL-3693); absent when the label was bought in another
+     * currency or the cost is not known. A marketplace that pays the seller
+     * back for shipping (Faire's `maker_cost_cents`) is told it.
+     */
+    labelCostCents?: number;
     /** The member who bought the label, for the record's timeline. */
     actorUid?: string;
 }