@endora-commerce/mod-shipments 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-shipments
+
+Shipment record and the order_created / shipment_created / receive_shipment lifecycle.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `shipments` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-shipments` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-shipments/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-shipments/migrations` | the module’s own schema migrations, in the order the platform runs them |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/contracts`
+- `@endora-commerce/email-components`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-shipments
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/backend/email-templates/transactional-defaults.d.ts

@@ -0,0 +1,6 @@
+export declare const SHIPMENT_CREATED_DEFAULT: {
+    defaultSubject: Record<string, string>;
+    defaultContent: Record<string, unknown>;
+    languages: string[];
+};
+//# sourceMappingURL=transactional-defaults.d.ts.map

package/dist/backend/email-templates/transactional-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-defaults.d.ts","sourceRoot":"","sources":["../../../src/backend/email-templates/transactional-defaults.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,wBAAwB;oBAI9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;oBAetB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;CAE7B,CAAC"}

package/dist/backend/email-templates/transactional-defaults.js

@@ -0,0 +1,27 @@
+// Default subject + content for the shipment_created transactional email
+// (feature 047). Simple layout via shared header/footer embeds.
+import { simpleEmailBodyTree } from '@endora-commerce/email-components/defaults/simple-email-body';
+const LANGS = ['en-US', 'pl-PL'];
+export const SHIPMENT_CREATED_DEFAULT = {
+    defaultSubject: {
+        'en-US': 'Your order {{var order.businessId}} has shipped',
+        'pl-PL': 'Twoje zamówienie {{var order.businessId}} zostało wysłane',
+    },
+    defaultContent: {
+        schema_version: 1,
+        languages: {
+            'en-US': simpleEmailBodyTree({
+                idPrefix: 'shipment',
+                heading: 'Your order has shipped',
+                text: 'Good news — a shipment has been created for your order {{var order.businessId}}. You will receive tracking details soon.',
+            }),
+            'pl-PL': simpleEmailBodyTree({
+                idPrefix: 'shipment',
+                heading: 'Zamówienie wysłane',
+                text: 'Dobra wiadomość — utworzono przesyłkę dla Twojego zamówienia {{var order.businessId}}. Wkrótce otrzymasz dane do śledzenia.',
+            }),
+        },
+    },
+    languages: LANGS,
+};
+//# sourceMappingURL=transactional-defaults.js.map

package/dist/backend/email-templates/transactional-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-defaults.js","sourceRoot":"","sources":["../../../src/backend/email-templates/transactional-defaults.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,gEAAgE;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8DAA8D,CAAC;AAEnG,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEjC,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,cAAc,EAAE;QACd,OAAO,EAAE,iDAAiD;QAC1D,OAAO,EAAE,2DAA2D;KAC3C;IAC3B,cAAc,EAAE;QACd,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE;YACT,OAAO,EAAE,mBAAmB,CAAC;gBAC3B,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,wBAAwB;gBACjC,IAAI,EAAE,0HAA0H;aACjI,CAAC;YACF,OAAO,EAAE,mBAAmB,CAAC;gBAC3B,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,oBAAoB;gBAC7B,IAAI,EAAE,6HAA6H;aACpI,CAAC;SACH;KACyB;IAC5B,SAAS,EAAE,KAAK;CACjB,CAAC"}

package/dist/backend/entities/shipment.entity.d.ts

@@ -0,0 +1,40 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * Shipment (`Przesyłka` / `Paczka`) — a first-class record of one
+ * shipment-generation attempt against an Order (feature 035). An Order may
+ * have several: a failed generation followed by a successful retry, or a
+ * future split into multiple parcels. The delivery-side twin of `Payment`.
+ *
+ * `status` is the shipment-process status (pending → success | failure),
+ * distinct from the Order status the method maps to on a `receive_shipment`
+ * outcome.
+ */
+export declare class Shipment {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'status' | 'externalReference' | 'providerDetails' | 'failureReason' | 'attemptNo';
+    id: string;
+    orderId: string;
+    deliveryMethodId: string;
+    /**
+     * `pending` → `success` | `failure` is the carrier's path. `pending_manual`
+     * is the path where there was no carrier: the adapter that would have been
+     * asked belongs to a module that is not present, so the row was opened
+     * without a request ever leaving the platform and a person has to finish it
+     * (issue #250). Same word as the refund settlement state, on purpose.
+     */
+    status: 'pending' | 'pending_manual' | 'success' | 'failure';
+    /** Carrier/adapter reference (e.g. tracking number) for idempotent matching. */
+    externalReference?: string | null;
+    /** Adapter/carrier payload captured on receive_shipment. */
+    providerDetails?: Record<string, unknown> | null;
+    /**
+     * Populated on a failure outcome, and on `pending_manual` with the sentence
+     * naming the module that was not asked — the two cases where a row needs to
+     * say why it is not a plain success.
+     */
+    failureReason?: string | null;
+    /** Retry sequence per order: 1 = first attempt. */
+    attemptNo: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=shipment.entity.d.ts.map

package/dist/backend/entities/shipment.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipment.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/shipment.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAIrF;;;;;;;;;GASG;AACH,qBAEa,QAAQ;IACnB,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,WAAW,GACX,QAAQ,GACR,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,WAAW,CAAC;IAGhB,EAAE,EAAE,MAAM,CAAgB;IAI1B,OAAO,EAAG,MAAM,CAAC;IAGjB,gBAAgB,EAAG,MAAM,CAAC;IAE1B;;;;;;OAMG;IAGH,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAa;IAEzE,gFAAgF;IAEhF,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,4DAA4D;IAE5D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEjD;;;;OAIG;IAEH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,mDAAmD;IAEnD,SAAS,EAAE,MAAM,CAAK;IAGtB,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/shipment.entity.js

@@ -0,0 +1,98 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * Shipment (`Przesyłka` / `Paczka`) — a first-class record of one
+ * shipment-generation attempt against an Order (feature 035). An Order may
+ * have several: a failed generation followed by a successful retry, or a
+ * future split into multiple parcels. The delivery-side twin of `Payment`.
+ *
+ * `status` is the shipment-process status (pending → success | failure),
+ * distinct from the Order status the method maps to on a `receive_shipment`
+ * outcome.
+ */
+let Shipment = class Shipment {
+    [OptionalProps];
+    id = randomUUID();
+    orderId;
+    deliveryMethodId;
+    /**
+     * `pending` → `success` | `failure` is the carrier's path. `pending_manual`
+     * is the path where there was no carrier: the adapter that would have been
+     * asked belongs to a module that is not present, so the row was opened
+     * without a request ever leaving the platform and a person has to finish it
+     * (issue #250). Same word as the refund settlement state, on purpose.
+     */
+    status = 'pending';
+    /** Carrier/adapter reference (e.g. tracking number) for idempotent matching. */
+    externalReference;
+    /** Adapter/carrier payload captured on receive_shipment. */
+    providerDetails;
+    /**
+     * Populated on a failure outcome, and on `pending_manual` with the sentence
+     * naming the module that was not asked — the two cases where a row needs to
+     * say why it is not a plain success.
+     */
+    failureReason;
+    /** Retry sequence per order: 1 = first attempt. */
+    attemptNo = 1;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Shipment.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], Shipment.prototype, "orderId", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Shipment.prototype, "deliveryMethodId", void 0);
+__decorate([
+    Property({ type: 'string', length: 32 }),
+    Index(),
+    __metadata("design:type", String)
+], Shipment.prototype, "status", void 0);
+__decorate([
+    Property({ type: 'string', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], Shipment.prototype, "externalReference", void 0);
+__decorate([
+    Property({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], Shipment.prototype, "providerDetails", void 0);
+__decorate([
+    Property({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], Shipment.prototype, "failureReason", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], Shipment.prototype, "attemptNo", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], Shipment.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], Shipment.prototype, "updatedAt", void 0);
+Shipment = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'shipments' })
+], Shipment);
+export { Shipment };
+//# sourceMappingURL=shipment.entity.js.map

package/dist/backend/entities/shipment.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipment.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/shipment.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;;;;;GASG;AAGI,IAAM,QAAQ,GAAd,MAAM,QAAQ;IACnB,CAAC,aAAa,CAAC,CAQC;IAGhB,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,OAAO,CAAU;IAGjB,gBAAgB,CAAU;IAE1B;;;;;;OAMG;IAGH,MAAM,GAAyD,SAAS,CAAC;IAEzE,gFAAgF;IAEhF,iBAAiB,CAAiB;IAElC,4DAA4D;IAE5D,eAAe,CAAkC;IAEjD;;;;OAIG;IAEH,aAAa,CAAiB;IAE9B,mDAAmD;IAEnD,SAAS,GAAW,CAAC,CAAC;IAGtB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AA7CC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;oCACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;yCACS;AAGjB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;kDACD;AAW1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,KAAK,EAAE;;wCACiE;AAIzE;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACxB;AAIlC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDACM;AAQjD;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;+CACb;AAI9B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;2CACR;AAGtB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;2CAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;2CAAc;AAxDlB,QAAQ;IAFpB,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;GACtB,QAAQ,CAyDpB"}

package/dist/backend/index.d.ts

@@ -0,0 +1,71 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { EventBus } from '@endora-commerce/platform/events';
+import type { ShippingAdapterRegistryPort } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { ShipmentService } from './services/shipment-service.js';
+import { ReceiveShipmentHandler } from './services/receive-shipment-handler.js';
+import { ShipmentEmailNotifier } from './services/shipment-email-notifier.js';
+import type { ShipmentEmailNotifierDeps } from './services/shipment-email-notifier.js';
+import { AutoShipmentOnPaidNotifier } from './services/auto-shipment-on-paid.js';
+import { Shipment } from './entities/shipment.entity.js';
+/**
+ * `shipments` — a module that owned everything except its own registration
+ * (feature 072, wave 2, T124).
+ *
+ * It has a manifest, an entity, two services, a route file, a transactional
+ * email and a migration — and none of it was wired by the module. `orders`
+ * imported both services and the route file, constructed them inside its own
+ * plugin and mounted them there, which its own manifest comment recorded as
+ * "routes are wired through the commerce composition root". So the shipment
+ * lifecycle existed for exactly as long as `orders` happened to be composed,
+ * and Principle I's "design every module so it can be detached" was false for
+ * it in the same literal way it was for `audit_logs` before T084.
+ *
+ * Nothing in the split needed inventing: both registries the services take are
+ * already ports `delivery_methods` provides, and the manifest already declares
+ * that dependency. What changes is who registers the routes — and therefore
+ * what switching `shipments` off does. Before, nothing: the module had no gate
+ * of its own and its routes answered whenever `orders` was on.
+ *
+ * The `shipment.created.v1` notifier moves in for the same reason. Both roots
+ * built it and called `attach(eventBus)` directly, so it subscribed to the raw
+ * bus rather than through `subscribeForModule` — a shipment-created e-mail went
+ * out whether or not this module was on. `ctx.subscribe` gates it.
+ *
+ * The transactional-email *sender* stays contributed: it is announced by
+ * `transactional_emails` through a callback a root holds, so a port would point
+ * the dependency at a module that does not yet have the value. Absent, the
+ * notifier is silent — which is exactly what it already did when the sender had
+ * not been exposed.
+ */
+/** What `shipments` resolves from the container, and the names it owns. */
+export interface ShipmentsCradle {
+    readonly emFactory: () => EntityManager;
+    readonly eventBus: EventBus;
+    /** Platform-owned name — the sink for the `pending_manual` audit row. */
+    readonly auditLogService: AuditPort;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly shippingAdapterRegistry: ShippingAdapterRegistryPort;
+    readonly shipmentService: ShipmentService;
+    readonly receiveShipmentHandler: ReceiveShipmentHandler;
+    /** Contribution point: absent means a shipment-created e-mail is not sent. */
+    readonly shipmentEmailSender: ShipmentEmailNotifierDeps['getTransactionalEmailSender'];
+    readonly shipmentEmailNotifier: ShipmentEmailNotifier;
+    readonly autoShipmentOnPaid: AutoShipmentOnPaidNotifier;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export declare const entities: (typeof Shipment)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAUV,2BAA2B,EAE5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAIjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAGhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,uBAAuB,EAAE,2BAA2B,CAAC;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,8EAA8E;IAC9E,QAAQ,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,6BAA6B,CAAC,CAAC;IACvF,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACtD,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;CACzD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA+LvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,qBAEpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,151 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { ShipmentService } from './services/shipment-service.js';
+import { ShipmentUsageService } from './services/shipment-usage.service.js';
+import { ShipmentReadService } from './services/shipment-read.service.js';
+import { resolveShippingEmailRenderer } from './services/shipping-email-renderer.js';
+import { ReceiveShipmentHandler } from './services/receive-shipment-handler.js';
+import { registerShipmentsRoutes } from './routes.js';
+import { ShipmentEmailNotifier } from './services/shipment-email-notifier.js';
+import { AutoShipmentOnPaidNotifier } from './services/auto-shipment-on-paid.js';
+import { SHIPMENT_CREATED_DEFAULT } from './email-templates/transactional-defaults.js';
+import { Shipment } from './entities/shipment.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        // Contribution point, defaulted to no sender: a deployment without a
+        // transactional-email surface sends nothing rather than failing to ship.
+        shipmentEmailSender: ctx
+            .asFunction(() => () => undefined)
+            .singleton(),
+        shipmentEmailNotifier: ctx
+            .asFunction(({ emFactory }) => new ShipmentEmailNotifier({
+            emFactory,
+            orderRead: lazyPort(ctx, 'orderReadPort'),
+            customerAccountRead: lazyPort(ctx, 'customerAccountReadPort'),
+            // Read per call: a root contributes the sender after
+            // `transactional_emails` announces it, which is later than this.
+            getTransactionalEmailSender: () => ctx.cradle().shipmentEmailSender(),
+        }))
+            .singleton(),
+        autoShipmentOnPaid: ctx
+            .asFunction(({ emFactory }) => new AutoShipmentOnPaidNotifier(emFactory, lazyPort(ctx, 'shippingAdapterRegistry'), lazyPort(ctx, 'orderReadPort'), lazyPort(ctx, 'deliveryMethodReadPort'), lazyPort(ctx, 'shipmentService')))
+            .singleton(),
+    });
+    ctx.di.providePort('shipmentService', ctx
+        .asFunction(({ emFactory, eventBus, auditLogService }) => new ShipmentService(emFactory, lazyPort(ctx, 'shippingAdapterRegistry'), lazyPort(ctx, 'orderReadPort'), lazyPort(ctx, 'deliveryMethodReadPort'), auditLogService, eventBus))
+        .singleton());
+    /**
+     * Feature 075 — the delete guard `delivery_methods` used to write itself.
+     *
+     * That module counted this one's table in raw SQL, which names no import
+     * specifier and so crossed the boundary invisibly until D-87 gave
+     * `check:module-boundary` a second predicate. The count is a question about
+     * shipment rows, so it is answered here.
+     *
+     * A port and not a contribution into a registry `delivery_methods` owns:
+     * a contributed edge is filtered by contributor at enumeration, so switching
+     * this module off would silently withdraw the guard — and with no foreign key
+     * on `shipments.delivery_method_id` that means orphaned history rather than a
+     * refused delete. The consumer decides this module's presence itself and
+     * refuses; see its manifest's `nonBindingDependencies` entry.
+     */
+    ctx.di.providePort('shipmentUsagePort', ctx
+        .asFunction(({ emFactory }) => new ShipmentUsageService(emFactory))
+        .singleton());
+    /**
+     * Feature 068 — "what state is this shipment in?", asked by a carrier module.
+     *
+     * `inpost` loaded this module's `Shipment` entity for it: once to correlate an
+     * inbound ShipX webhook that names only the carrier's own id, and once for the
+     * admin label route. Both are reads of a row the caller does not write, so
+     * they are a port rather than an apply seam, and both are on this module's own
+     * `EntityManager`.
+     */
+    ctx.di.providePort('shipmentReadPort', ctx
+        .asFunction(({ emFactory }) => new ShipmentReadService(emFactory))
+        .singleton());
+    /**
+     * Feature 075, Phase P — the shipping line of the order-confirmation e-mail.
+     *
+     * The delivery-side twin of `payments`' `paymentEmailRendererPort`, and the
+     * same collapse: `orders` reaches this module's resolver and then calls the
+     * function it gets back. Doing both behind one call is what keeps the
+     * default text on this side — a consumer that resolved a renderer and got
+     * `undefined` would have to hold a copy of it, and two copies of a default
+     * are how a default stops being one.
+     */
+    ctx.di.providePort('shippingEmailRendererPort', ctx
+        .asFunction(() => ({
+        render: (rendererKey, emailContext) => resolveShippingEmailRenderer(rendererKey)(emailContext),
+    }))
+        .singleton());
+    /**
+     * The carrier callback ingress.
+     *
+     * **`orderTransitionPort` replaces two of the names this took** (feature 085
+     * Phase D). `orderStatusAnnouncePort` goes because the transition seam emits
+     * the templated `.after` events itself, so announcing beside it would double
+     * every subscriber's reaction; `shippingOrderStatusRegistry` goes because "is
+     * this a status code" was never the question a carrier callback needed
+     * answered, and the port answers the real one — may this order go there —
+     * against the configured graph.
+     */
+    ctx.di.providePort('receiveShipmentHandler', ctx
+        .asFunction(({ emFactory, eventBus }) => new ReceiveShipmentHandler(emFactory, lazyPort(ctx, 'deliveryMethodReadPort'), lazyPort(ctx, 'orderTransitionPort'), ctx.log, eventBus))
+        .singleton());
+    ctx.subscribe('shipment.created.v1', async (payload) => {
+        const { orderId, shipmentId, status } = payload;
+        // The state travels with the event because the notifier's decision depends
+        // on it: a shipment no carrier was asked for sends no "your order has
+        // shipped" (issue #250).
+        await ctx.cradle().shipmentEmailNotifier.notify(orderId, shipmentId, status);
+    });
+    ctx.subscribe('payment.received.v1', async (payload) => {
+        const { orderId } = payload;
+        await ctx.cradle().autoShipmentOnPaid.maybeCreate(orderId);
+    });
+    ctx.routes(async (app) => {
+        const { requireAdmin } = ctx.cradle();
+        await registerShipmentsRoutes(app, {
+            requireAdmin,
+            // Lazily, even though the module owns both ports: route *registration*
+            // runs inside `buildServer` whatever the module's effective state is, so
+            // destructuring the gates here would stop the next start instead of
+            // stopping the routes (D-40).
+            receiveHandler: lazyPort(ctx, 'receiveShipmentHandler'),
+            shipmentService: lazyPort(ctx, 'shipmentService'),
+        });
+    });
+    /**
+     * The default subject and content for the 1 transactional email this
+     * module declares in its manifest (T143a).
+     *
+     * These were fourteen `emailDefaultsRegistry.register(...)` calls in
+     * `composition.ts`, each importing a template constant out of the module that
+     * owns it — a root reaching into seven modules to hand their own content to
+     * an eighth. Each module registers its own now.
+     *
+     * `ctx.onBoot` rather than a registration: the registry is *read* once, by
+     * `transactional_emails`' boot reconciler inside its plugin body. Boot hooks
+     * run during composition and plugin bodies only when the Fastify app is
+     * built, so this always lands first — by construction, not by ordering luck.
+     */
+    ctx.onBoot(async () => {
+        const defaults = lazyPort(ctx, 'emailDefaultsPort');
+        defaults.register('shipment_created', SHIPMENT_CREATED_DEFAULT, 'shipments');
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export const entities = [
+    Shipment,
+];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"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"}

package/dist/backend/routes.d.ts

@@ -0,0 +1,29 @@
+import type { FastifyInstance } from 'fastify';
+import type { ReceiveShipmentHandler } from './services/receive-shipment-handler.js';
+import type { ShipmentService } from './services/shipment-service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+/**
+ * Shipments routes (feature 035).
+ *
+ *   POST /api/v1/admin/orders/:id/shipments  — shipment_created (FR-021),
+ *                                              and the retry path (FR-024)
+ *   GET  /api/v1/admin/orders/:id/shipments  — full shipment history (FR-026)
+ *   POST /api/v1/shipments/receive           — receive_shipment ingress (FR-022)
+ *
+ * The ingress is admin-guarded for the MVP; a signed carrier-webhook auth path
+ * is a follow-up (the offline reference adapters are settled by an admin anyway).
+ *
+ * `POST .../shipments/retry` was removed by issue #257. It opened attempt n+1
+ * and contacted no carrier, which is exactly the silence issue #250 removed
+ * from the generate path; its own contract called it "equivalent to calling the
+ * generate route again", and the generate route is what every caller used —
+ * including the recovery button #250 added, which was pointed at generate
+ * precisely because retry asked nobody. Retrying is generating again.
+ */
+export interface ShipmentsRoutesDeps {
+    requireAdmin: RequireAdminFactory;
+    receiveHandler: ReceiveShipmentHandler;
+    shipmentService: ShipmentService;
+}
+export declare function registerShipmentsRoutes(app: FastifyInstance, deps: ShipmentsRoutesDeps): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/backend/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,mBAAmB,CAAC;IAClC,cAAc,EAAE,sBAAsB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/backend/routes.js

@@ -0,0 +1,35 @@
+import { receiveShipmentSchema } from '@endora-commerce/contracts';
+export async function registerShipmentsRoutes(app, deps) {
+    app.post('/api/v1/admin/orders/:id/shipments', { preHandler: deps.requireAdmin('orders:write') }, async (request, reply) => {
+        const shipment = await deps.shipmentService.createShipment(request.params.id);
+        reply.status(201);
+        return { data: serializeShipment(shipment) };
+    });
+    app.get('/api/v1/admin/orders/:id/shipments', { preHandler: deps.requireAdmin('orders:read') }, async (request) => {
+        const shipments = await deps.shipmentService.listForOrder(request.params.id);
+        return { data: shipments.map(serializeShipment) };
+    });
+    app.post('/api/v1/shipments/receive', {
+        preHandler: deps.requireAdmin('orders:write'),
+        schema: { body: receiveShipmentSchema },
+    }, async (request) => {
+        const body = receiveShipmentSchema.parse(request.body);
+        const result = await deps.receiveHandler.receive(body);
+        return { data: result };
+    });
+}
+function serializeShipment(s) {
+    return {
+        id: s.id,
+        orderId: s.orderId,
+        deliveryMethodId: s.deliveryMethodId,
+        status: s.status,
+        externalReference: s.externalReference ?? null,
+        providerDetails: s.providerDetails ?? null,
+        failureReason: s.failureReason ?? null,
+        attemptNo: s.attemptNo,
+        createdAt: s.createdAt.toISOString(),
+        updatedAt: s.updatedAt.toISOString(),
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/backend/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AA8BnE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAoB,EACpB,IAAyB;IAEzB,GAAG,CAAC,IAAI,CACN,oCAAoC,EACpC,EAAE,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,EACjD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9E,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC/C,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,oCAAoC,EACpC,EAAE,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,EAChD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACpD,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,IAAI,CACN,2BAA2B,EAC3B;QACE,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC;QAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE;KACxC,EACD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAW;IACpC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;QACpC,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,IAAI;QAC9C,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,IAAI;QAC1C,aAAa,EAAE,CAAC,CAAC,aAAa,IAAI,IAAI;QACtC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;QACpC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC"}

package/dist/backend/services/auto-shipment-on-paid.d.ts

@@ -0,0 +1,28 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { DeliveryMethodReadPort, OrderReadPort, ShippingAdapterRegistryPort } from '@endora-commerce/contracts';
+import type { ShipmentService } from './shipment-service.js';
+/**
+ * Creates a shipment when payment settles and the order's shipping adapter
+ * opts in via `shouldAutoCreateOnPaid()` (feature 068).
+ *
+ * Wired from `shipments/backend.ts` through `ctx.subscribe('payment.received.v1')`
+ * — never via a bare `eventBus.on` (issue #107). Best-effort: ordinary failures
+ * are swallowed so payment settlement is never blocked; `ModuleDisabledError`
+ * is re-thrown so fail-closed stays fail-closed.
+ *
+ * The order and the delivery method are read over their owners' ports, exactly
+ * as `ShipmentService` reads them (feature 075 Phase C): both rows are ones this
+ * operation does not modify, so nothing is lost by leaving them on the owner's
+ * EntityManager, and both fail closed when their owner is off.
+ */
+export declare class AutoShipmentOnPaidNotifier {
+    private readonly emFactory;
+    private readonly registry;
+    private readonly orderRead;
+    private readonly deliveryMethodRead;
+    private readonly shipmentService;
+    constructor(emFactory: () => EntityManager, registry: ShippingAdapterRegistryPort, orderRead: OrderReadPort, deliveryMethodRead: DeliveryMethodReadPort, shipmentService: ShipmentService);
+    /** Exposed for unit tests. */
+    maybeCreate(orderId: string): Promise<void>;
+}
+//# sourceMappingURL=auto-shipment-on-paid.d.ts.map

package/dist/backend/services/auto-shipment-on-paid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-shipment-on-paid.d.ts","sourceRoot":"","sources":["../../../src/backend/services/auto-shipment-on-paid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACb,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAJf,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,2BAA2B,EACrC,SAAS,EAAE,aAAa,EACxB,kBAAkB,EAAE,sBAAsB,EAC1C,eAAe,EAAE,eAAe;IAGnD,8BAA8B;IACxB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BlD"}