@carlonicora/nestjs-neo4jsonapi 8.15.0 → 8.16.0

package/dist/foundations/offline-change-set/offline-change-set.module.js

@@ -0,0 +1,41 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflineChangeSetModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const registry_1 = require("../../common/registries/registry");
+const offline_change_set_1 = require("./entities/offline-change-set");
+const offline_change_set_repository_1 = require("./repositories/offline-change-set.repository");
+const offline_change_set_service_1 = require("./services/offline-change-set.service");
+const offline_route_runner_service_1 = require("./services/offline-route-runner.service");
+/**
+ * Offline change sets: opens a package of every change a device queued while offline and runs
+ * each one through the app's own routes. Loaded by `OfflineModule` when
+ * `bootstrap({ offline: { changeSets: true } })`. Declares no controller: the receiving route
+ * (`POST /offline-change-sets`) belongs to the app, which calls `OfflineChangeSetService.apply`.
+ */
+let OfflineChangeSetModule = class OfflineChangeSetModule {
+    onModuleInit() {
+        registry_1.modelRegistry.register(offline_change_set_1.OfflineChangeSetDescriptor.model);
+    }
+};
+exports.OfflineChangeSetModule = OfflineChangeSetModule;
+exports.OfflineChangeSetModule = OfflineChangeSetModule = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.DiscoveryModule],
+        providers: [
+            offline_change_set_1.OfflineChangeSetDescriptor.model.serialiser,
+            offline_change_set_repository_1.OfflineChangeSetRepository,
+            offline_change_set_service_1.OfflineChangeSetService,
+            offline_route_runner_service_1.OfflineRouteRunner,
+        ],
+        exports: [offline_change_set_service_1.OfflineChangeSetService],
+    })
+], OfflineChangeSetModule);
+//# sourceMappingURL=offline-change-set.module.js.map

package/dist/foundations/offline-change-set/offline-change-set.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.module.js","sourceRoot":"","sources":["../../../src/foundations/offline-change-set/offline-change-set.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AACtD,uCAA+C;AAC/C,+DAAiE;AACjE,sEAA2E;AAC3E,gGAA0F;AAC1F,sFAAgF;AAChF,0FAA6E;AAE7E;;;;;GAKG;AAWI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,+CAA0B,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;CACF,CAAA;AAJY,wDAAsB;iCAAtB,sBAAsB;IAVlC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAe,CAAC;QAC1B,SAAS,EAAE;YACT,+CAA0B,CAAC,KAAK,CAAC,UAAU;YAC3C,0DAA0B;YAC1B,oDAAuB;YACvB,iDAAkB;SACnB;QACD,OAAO,EAAE,CAAC,oDAAuB,CAAC;KACnC,CAAC;GACW,sBAAsB,CAIlC"}

package/dist/foundations/offline-change-set/repositories/offline-change-set.repository.d.ts

@@ -0,0 +1,26 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { OfflineChangeSet, OfflineChangeSetDescriptor } from "../entities/offline-change-set";
+/**
+ * Repository of the stored offline change sets (one `OfflineChangeSet` node of the caller's
+ * company per package opened, holding its results). The service uses the inherited,
+ * company-scoped `findById` (a package sent again) and `create` (a package just opened), and
+ * `deleteOlderThan` (clean-up of old ones); every read and write of a change itself runs
+ * through the app's own routes (`OfflineRouteRunner`).
+ * The inherited `onModuleInit` creates the id constraint.
+ */
+export declare class OfflineChangeSetRepository extends AbstractRepository<OfflineChangeSet, typeof OfflineChangeSetDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<OfflineChangeSet, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Deletes the request company's stored change sets created before `before`. Without a company
+     * in the request it deletes nothing: `buildDefaultMatch()` matches every company's nodes when
+     * `$companyId` is null.
+     */
+    deleteOlderThan(params: {
+        before: Date;
+    }): Promise<void>;
+}
+//# sourceMappingURL=offline-change-set.repository.d.ts.map

package/dist/foundations/offline-change-set/repositories/offline-change-set.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/repositories/offline-change-set.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE9F;;;;;;;GAOG;AACH,qBACa,0BAA2B,SAAQ,kBAAkB,CAChE,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU,4DAA8B;gBAE/C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAe/D"}

package/dist/foundations/offline-change-set/repositories/offline-change-set.repository.js

@@ -0,0 +1,56 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflineChangeSetRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const offline_change_set_1 = require("../entities/offline-change-set");
+/**
+ * Repository of the stored offline change sets (one `OfflineChangeSet` node of the caller's
+ * company per package opened, holding its results). The service uses the inherited,
+ * company-scoped `findById` (a package sent again) and `create` (a package just opened), and
+ * `deleteOlderThan` (clean-up of old ones); every read and write of a change itself runs
+ * through the app's own routes (`OfflineRouteRunner`).
+ * The inherited `onModuleInit` creates the id constraint.
+ */
+let OfflineChangeSetRepository = class OfflineChangeSetRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = offline_change_set_1.OfflineChangeSetDescriptor;
+    }
+    /**
+     * Deletes the request company's stored change sets created before `before`. Without a company
+     * in the request it deletes nothing: `buildDefaultMatch()` matches every company's nodes when
+     * `$companyId` is null.
+     */
+    async deleteOlderThan(params) {
+        const { nodeName } = this.descriptor.model;
+        const query = this.neo4j.initQuery({ serialiser: this.descriptor.model });
+        if (!query.queryParams.companyId)
+            return;
+        query.queryParams = { ...query.queryParams, before: params.before.toISOString() };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${nodeName}.createdAt < datetime($before)
+      DETACH DELETE ${nodeName}
+    `;
+        await this.neo4j.writeOne(query);
+    }
+};
+exports.OfflineChangeSetRepository = OfflineChangeSetRepository;
+exports.OfflineChangeSetRepository = OfflineChangeSetRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], OfflineChangeSetRepository);
+//# sourceMappingURL=offline-change-set.repository.js.map

package/dist/foundations/offline-change-set/repositories/offline-change-set.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.repository.js","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/repositories/offline-change-set.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,uEAA8F;AAE9F;;;;;;;GAOG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,wCAG/C;IAGC,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,+CAA0B,CAAC;IAI3D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,MAAwB;QAC5C,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS;YAAE,OAAO;QAEzC,KAAK,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAElF,KAAK,CAAC,KAAK,IAAI;QACX,IAAI,CAAC,iBAAiB,EAAE;cAClB,QAAQ;sBACA,QAAQ;KACzB,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AA9BY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;qCAOQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAN9E,0BAA0B,CA8BtC"}

package/dist/foundations/offline-change-set/services/offline-change-set.service.d.ts

@@ -0,0 +1,72 @@
+import type { FastifyRequest } from "fastify";
+import { ClsService } from "nestjs-cls";
+import { JsonApiSingleDocument } from "../../../core/jsonapi/interfaces/jsonapi.document.interface";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService, JsonApiDTOData } from "../../../core/neo4j/abstracts/abstract.service";
+import { OfflineChangeSet, OfflineChangeSetDescriptor } from "../entities/offline-change-set";
+import { OfflineChangeSetRepository } from "../repositories/offline-change-set.repository";
+import { OfflineRouteRunner } from "./offline-route-runner.service";
+/**
+ * Opens one offline change set (every change the device queued, in one request) and handles
+ * each change in `seq` order through the app's own routes, as the caller (`OfflineRouteRunner`).
+ *
+ * - POST, and any write that names no record, runs as sent.
+ * - PUT/PATCH of a record: the current record is read (GET on the record's own path,
+ *   `<endpoint>/<id>`) and merged with `base` and the device's document (`threeWayMerge`);
+ *   only the changed fields are written, as a PATCH of the device's document trimmed to them
+ *   (merged rich text in place). A change carrying `resolution` merges the same way, and each
+ *   conflicting field takes the GM's choice.
+ * - DELETE of a record: refused as "changed on the server" when a descriptor field or a
+ *   linked id changed since `base`; with `resolution` (delete anyway) it runs without that check.
+ * - After a conflict or a could-not-apply, later changes to the same record wait (a custom
+ *   write `<endpoint>/<id>/...` counts as a change of that record).
+ * - A package is opened once: its results are stored under its id (company-scoped) and a
+ *   package sent again with the same id is answered with them, without running anything.
+ *
+ * The package is never paged, batched or capped.
+ */
+export declare class OfflineChangeSetService extends AbstractService<OfflineChangeSet, typeof OfflineChangeSetDescriptor.relationships> {
+    private readonly offlineChangeSetRepository;
+    private readonly runner;
+    protected readonly descriptor: import("../../..").EntityDescriptor<OfflineChangeSet, {}>;
+    private readonly logger;
+    constructor(jsonApiService: JsonApiService, offlineChangeSetRepository: OfflineChangeSetRepository, clsService: ClsService, runner: OfflineRouteRunner);
+    apply(params: {
+        data: JsonApiDTOData;
+        request: FastifyRequest;
+    }): Promise<JsonApiSingleDocument>;
+    /**
+     * Removes the company's stored change sets older than `STORED_CHANGE_SET_DAYS`: a device sends a
+     * package again only right after a failed answer, never days later. A failed clean-up is
+     * logged and never stops the package.
+     */
+    private removeExpired;
+    /** The JSON:API type answering on an endpoint (the type is the endpoint unless a descriptor says otherwise). */
+    private typeOfEndpoint;
+    /** The record's own path: `<its type's endpoint>/<id>`. */
+    private recordPath;
+    /** The record a change touches: its record fields, the resource a create posts, or the `<endpoint>/<id>` its path targets. */
+    private recordKey;
+    private applyChange;
+    private runAsSent;
+    private toResult;
+    private readCurrent;
+    /**
+     * Relationship names the record's GET always answers when it has a link (the serialiser
+     * emits every descriptor relationship and omits only an empty one), so an omitted one is empty.
+     */
+    private knownRelationships;
+    private mergeResolution;
+    private applyEdit;
+    private applyDelete;
+    /**
+     * The attributes a change could have touched: the descriptor's fields that go on the wire as
+     * stored (no transform, such as a signed URL; not meta; not excluded), minus createdAt/updatedAt
+     * and the fields only the server writes (`SERVER_WRITTEN_ATTRIBUTES`, `immutable` fields).
+     * `undefined` for an unknown type (every attribute base holds is compared, minus those names).
+     */
+    private comparableAttributes;
+    /** A descriptor field or a linked id of the record differs from `base`. */
+    private changedSince;
+}
+//# sourceMappingURL=offline-change-set.service.d.ts.map

package/dist/foundations/offline-change-set/services/offline-change-set.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/services/offline-change-set.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACjG,OAAO,EAGL,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAsB,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AA+CxF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,uBAAwB,SAAQ,eAAe,CAC1D,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IAMG,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAE3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,SAAS,CAAC,QAAQ,CAAC,UAAU,4DAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;gBAGjE,cAAc,EAAE,cAAc,EACb,0BAA0B,EAAE,0BAA0B,EACvE,UAAU,EAAE,UAAU,EACL,MAAM,EAAE,kBAAkB;IAKvC,KAAK,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2CtG;;;;OAIG;YACW,aAAa;IAS3B,gHAAgH;IAChH,OAAO,CAAC,cAAc;IAItB,2DAA2D;IAC3D,OAAO,CAAC,UAAU;IAMlB,8HAA8H;IAC9H,OAAO,CAAC,SAAS;YAUH,WAAW;YAOX,SAAS;IAKvB,OAAO,CAAC,QAAQ;YASF,WAAW;IAUzB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,eAAe;YAWT,SAAS;YAqDT,WAAW;IAgBzB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAkB5B,2EAA2E;IAC3E,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/foundations/offline-change-set/services/offline-change-set.service.js

@@ -0,0 +1,333 @@
+"use strict";
+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);
+};
+var OfflineChangeSetService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflineChangeSetService = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const entity_descriptor_registry_1 = require("../../../common/registries/entity-descriptor.registry");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const offline_change_set_1 = require("../entities/offline-change-set");
+const deep_equal_1 = require("../merge/deep-equal");
+const three_way_merge_1 = require("../merge/three-way-merge");
+const offline_change_set_repository_1 = require("../repositories/offline-change-set.repository");
+const offline_route_runner_service_1 = require("./offline-route-runner.service");
+const isOk = (status) => status >= 200 && status < 300;
+/** The reason an app route gave for refusing a step (JSON:API errors, Nest's error body, or the status). */
+function errorDetail(status, body) {
+    const error = Array.isArray(body?.errors) ? body.errors[0] : undefined;
+    if (error?.detail)
+        return String(error.detail);
+    if (error?.title)
+        return String(error.title);
+    if (Array.isArray(body?.message))
+        return body.message.join("; ");
+    if (typeof body?.message === "string" && body.message)
+        return body.message;
+    if (typeof body === "string" && body)
+        return body;
+    return `HTTP ${status}`;
+}
+/** Values the server sets on every write or recomputes on every read: never a change by anyone. */
+const VOLATILE_ATTRIBUTES = new Set(["createdAt", "updatedAt"]);
+/**
+ * Attributes only the server (the AI workers) writes. Descriptors carry no marker for them (the
+ * app declares them as plain fields), so they are named here; a field marked `immutable` (never
+ * written by a client save) counts too. A change to them is never "changed on the server".
+ */
+const SERVER_WRITTEN_ATTRIBUTES = new Set(["aiStatus", "summary", "tldr"]);
+/** How long a stored change set (a package's results, kept for a resend) is kept. */
+const STORED_CHANGE_SET_DAYS = 7;
+/** `npcs/n1?x`, `/npcs/n1` or an absolute URL → `["npcs", "n1"]`. */
+function pathSegments(path) {
+    let pathname = path.split("?")[0];
+    if (/^https?:\/\//i.test(pathname))
+        pathname = new URL(pathname).pathname;
+    return pathname.split("/").filter((s) => s.length > 0);
+}
+const linkageIds = (rel) => {
+    if (!rel || typeof rel !== "object" || !("data" in rel))
+        return undefined;
+    const data = rel.data;
+    if (data == null)
+        return [];
+    return (Array.isArray(data) ? data : [data]).map((d) => d.id).sort();
+};
+/**
+ * Opens one offline change set (every change the device queued, in one request) and handles
+ * each change in `seq` order through the app's own routes, as the caller (`OfflineRouteRunner`).
+ *
+ * - POST, and any write that names no record, runs as sent.
+ * - PUT/PATCH of a record: the current record is read (GET on the record's own path,
+ *   `<endpoint>/<id>`) and merged with `base` and the device's document (`threeWayMerge`);
+ *   only the changed fields are written, as a PATCH of the device's document trimmed to them
+ *   (merged rich text in place). A change carrying `resolution` merges the same way, and each
+ *   conflicting field takes the GM's choice.
+ * - DELETE of a record: refused as "changed on the server" when a descriptor field or a
+ *   linked id changed since `base`; with `resolution` (delete anyway) it runs without that check.
+ * - After a conflict or a could-not-apply, later changes to the same record wait (a custom
+ *   write `<endpoint>/<id>/...` counts as a change of that record).
+ * - A package is opened once: its results are stored under its id (company-scoped) and a
+ *   package sent again with the same id is answered with them, without running anything.
+ *
+ * The package is never paged, batched or capped.
+ */
+let OfflineChangeSetService = OfflineChangeSetService_1 = class OfflineChangeSetService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, offlineChangeSetRepository, clsService, runner) {
+        super(jsonApiService, offlineChangeSetRepository, clsService, offline_change_set_1.OfflineChangeSetDescriptor.model);
+        this.offlineChangeSetRepository = offlineChangeSetRepository;
+        this.runner = runner;
+        this.descriptor = offline_change_set_1.OfflineChangeSetDescriptor;
+        this.logger = new common_1.Logger(OfflineChangeSetService_1.name);
+    }
+    async apply(params) {
+        const id = params.data.id;
+        await this.removeExpired();
+        const stored = await this.repository.findById({ id });
+        if (stored)
+            return this.jsonApiService.buildSingle(offline_change_set_1.OfflineChangeSetDescriptor.model, stored);
+        const changes = [...(params.data.attributes?.changes ?? [])].sort((a, b) => a.seq - b.seq);
+        const blocked = new Set();
+        const results = [];
+        for (const change of changes) {
+            const key = this.recordKey(change);
+            if (key && blocked.has(key)) {
+                results.push({ seq: change.seq, status: "waiting" });
+                continue;
+            }
+            let result;
+            try {
+                result = await this.applyChange(change, params.request);
+            }
+            catch (error) {
+                result = { seq: change.seq, status: "could-not-apply", detail: error?.message ?? String(error) };
+            }
+            if (key && (result.status === "conflict" || result.status === "could-not-apply"))
+                blocked.add(key);
+            results.push(result);
+        }
+        try {
+            await this.repository.create({ id, resultsJson: JSON.stringify(results) });
+        }
+        catch (error) {
+            // The changes ran: answer them. A package sent again would run once more, as before this store existed.
+            this.logger.error(`offline change set ${id}: results not stored: ${error?.message ?? error}`);
+        }
+        return this.jsonApiService.buildSingle(offline_change_set_1.OfflineChangeSetDescriptor.model, { id, results });
+    }
+    /**
+     * Removes the company's stored change sets older than `STORED_CHANGE_SET_DAYS`: a device sends a
+     * package again only right after a failed answer, never days later. A failed clean-up is
+     * logged and never stops the package.
+     */
+    async removeExpired() {
+        const before = new Date(Date.now() - STORED_CHANGE_SET_DAYS * 24 * 60 * 60 * 1000);
+        try {
+            await this.offlineChangeSetRepository.deleteOlderThan({ before });
+        }
+        catch (error) {
+            this.logger.error(`offline change sets: clean-up failed: ${error?.message ?? error}`);
+        }
+    }
+    /** The JSON:API type answering on an endpoint (the type is the endpoint unless a descriptor says otherwise). */
+    typeOfEndpoint(endpoint) {
+        return entity_descriptor_registry_1.entityDescriptorRegistry.getByEndpoint(endpoint)?.model?.type ?? endpoint;
+    }
+    /** The record's own path: `<its type's endpoint>/<id>`. */
+    recordPath(change) {
+        const type = change.recordType;
+        const endpoint = entity_descriptor_registry_1.entityDescriptorRegistry.get(type)?.model?.endpoint ?? type;
+        return `${endpoint}/${change.recordId}`;
+    }
+    /** The record a change touches: its record fields, the resource a create posts, or the `<endpoint>/<id>` its path targets. */
+    recordKey(change) {
+        if (change.recordType && change.recordId)
+            return `${change.recordType}:${change.recordId}`;
+        const data = change.body?.data;
+        if (change.method === "POST" && typeof data?.type === "string" && typeof data?.id === "string")
+            return `${data.type}:${data.id}`;
+        const [endpoint, recordId] = pathSegments(change.path);
+        if (endpoint && recordId)
+            return `${this.typeOfEndpoint(endpoint)}:${recordId}`;
+        return undefined;
+    }
+    async applyChange(change, request) {
+        const namesRecord = !!change.recordType && !!change.recordId;
+        if (!namesRecord || change.method === "POST")
+            return this.runAsSent(change, request);
+        if (change.method === "DELETE")
+            return this.applyDelete(change, request);
+        return this.applyEdit(change, request);
+    }
+    async runAsSent(change, request) {
+        const answer = await this.runner.run({ method: change.method, path: change.path, body: change.body, request });
+        return this.toResult(change.seq, answer);
+    }
+    toResult(seq, answer) {
+        if (answer.ran === false)
+            return { seq, status: "could-not-apply", detail: answer.detail };
+        if (!isOk(answer.status))
+            return { seq, status: "could-not-apply", detail: errorDetail(answer.status, answer.body) };
+        return answer.body && typeof answer.body === "object"
+            ? { seq, status: "applied", response: answer.body }
+            : { seq, status: "applied" };
+    }
+    async readCurrent(change, request) {
+        const answer = await this.runner.run({ method: "GET", path: this.recordPath(change), request });
+        if (answer.ran === false)
+            return { kind: "failed", detail: answer.detail };
+        if (answer.status === 404)
+            return { kind: "deleted" };
+        if (!isOk(answer.status))
+            return { kind: "failed", detail: errorDetail(answer.status, answer.body) };
+        const resource = answer.body?.data;
+        if (!resource || typeof resource !== "object" || Array.isArray(resource))
+            return { kind: "deleted" };
+        return { kind: "found", resource, document: answer.body };
+    }
+    /**
+     * Relationship names the record's GET always answers when it has a link (the serialiser
+     * emits every descriptor relationship and omits only an empty one), so an omitted one is empty.
+     */
+    knownRelationships(type) {
+        const descriptor = type ? entity_descriptor_registry_1.entityDescriptorRegistry.get(type) : undefined;
+        return Object.entries(descriptor?.relationships ?? {}).map(([name, rel]) => rel?.dtoKey ?? name);
+    }
+    mergeResolution(change) {
+        const resolution = change.resolution;
+        if (!resolution)
+            return undefined;
+        const merged = resolution.mergedBody?.data;
+        return {
+            choices: resolution.choices,
+            all: resolution.kind === "mine" ? "mine" : undefined,
+            merged: merged && typeof merged === "object" ? merged : undefined,
+        };
+    }
+    async applyEdit(change, request) {
+        const current = await this.readCurrent(change, request);
+        if (current.kind === "deleted")
+            return { seq: change.seq, status: "conflict", conflict: "deleted-on-server", current: null };
+        if (current.kind === "failed")
+            return { seq: change.seq, status: "could-not-apply", detail: current.detail };
+        const body = (change.body ?? {});
+        const mine = body.data ?? {};
+        const theirs = current.resource;
+        const base = change.base ?? theirs;
+        const merge = (0, three_way_merge_1.threeWayMerge)({
+            base,
+            mine,
+            theirs,
+            richTextFields: entity_descriptor_registry_1.entityDescriptorRegistry.richTextFields(change.recordType),
+            knownRelationships: this.knownRelationships(change.recordType),
+            resolution: this.mergeResolution(change),
+        });
+        if (merge.conflictFields.length > 0)
+            return {
+                seq: change.seq,
+                status: "conflict",
+                conflict: "fields",
+                current: theirs,
+                merged: merge.attributes,
+                conflictFields: merge.conflictFields,
+                conflictBlocks: merge.conflictBlocks,
+            };
+        if (merge.changed.length === 0)
+            return { seq: change.seq, status: "applied", response: current.document };
+        // The device's model-built document (decision "1a"), trimmed in place: fields the merge says
+        // nobody needs to write are removed, merged values (rich text included) replace the device's.
+        // Nothing is rebuilt: type, id and every other member stay as the device's model wrote them.
+        const trimmed = structuredClone(body);
+        const data = trimmed.data;
+        for (const name of Object.keys(data.attributes ?? {})) {
+            if (merge.changed.includes(name))
+                data.attributes[name] = merge.attributes[name];
+            else
+                delete data.attributes[name];
+        }
+        for (const name of Object.keys(data.relationships ?? {})) {
+            if (merge.changed.includes(name) && name in merge.relationships)
+                data.relationships[name] = merge.relationships[name];
+            else
+                delete data.relationships[name];
+        }
+        if (data.relationships && Object.keys(data.relationships).length === 0)
+            delete data.relationships;
+        const answer = await this.runner.run({ method: "PATCH", path: change.path, body: trimmed, request });
+        return this.toResult(change.seq, answer);
+    }
+    async applyDelete(change, request) {
+        if (!change.resolution) {
+            const current = await this.readCurrent(change, request);
+            if (current.kind === "deleted")
+                return { seq: change.seq, status: "applied" };
+            if (current.kind === "failed")
+                return { seq: change.seq, status: "could-not-apply", detail: current.detail };
+            if (change.base && this.changedSince(change.recordType, change.base, current.resource))
+                return { seq: change.seq, status: "conflict", conflict: "changed-on-server", current: current.resource };
+        }
+        const answer = await this.runner.run({ method: "DELETE", path: change.path, body: change.body, request });
+        // Already gone: what the GM asked for holds.
+        if (answer.ran === true && answer.status === 404)
+            return { seq: change.seq, status: "applied" };
+        return this.toResult(change.seq, answer);
+    }
+    /**
+     * The attributes a change could have touched: the descriptor's fields that go on the wire as
+     * stored (no transform, such as a signed URL; not meta; not excluded), minus createdAt/updatedAt
+     * and the fields only the server writes (`SERVER_WRITTEN_ATTRIBUTES`, `immutable` fields).
+     * `undefined` for an unknown type (every attribute base holds is compared, minus those names).
+     */
+    comparableAttributes(type) {
+        const descriptor = entity_descriptor_registry_1.entityDescriptorRegistry.get(type);
+        if (!descriptor)
+            return undefined;
+        const names = Object.entries(descriptor.fields ?? {})
+            .filter(([name, def]) => !VOLATILE_ATTRIBUTES.has(name) &&
+            !SERVER_WRITTEN_ATTRIBUTES.has(name) &&
+            !def?.immutable &&
+            !def?.transform &&
+            !def?.meta &&
+            !def?.excludeFromJsonApi &&
+            def?.serialise !== false)
+            .map(([name]) => name);
+        return new Set(names);
+    }
+    /** A descriptor field or a linked id of the record differs from `base`. */
+    changedSince(type, base, theirs) {
+        const comparable = this.comparableAttributes(type);
+        for (const [name, value] of Object.entries(base.attributes ?? {})) {
+            if (comparable ? !comparable.has(name) : VOLATILE_ATTRIBUTES.has(name) || SERVER_WRITTEN_ATTRIBUTES.has(name))
+                continue;
+            if (!(0, deep_equal_1.jsonEqual)(value, theirs.attributes?.[name]))
+                return true;
+        }
+        const known = new Set(this.knownRelationships(type));
+        for (const [name, rel] of Object.entries(base.relationships ?? {})) {
+            const baseIds = linkageIds(rel);
+            const theirsRel = theirs.relationships?.[name] ?? (known.has(name) ? { data: null } : undefined);
+            const theirsIds = linkageIds(theirsRel);
+            if (baseIds !== undefined && theirsIds !== undefined && !(0, deep_equal_1.jsonEqual)(baseIds, theirsIds))
+                return true;
+        }
+        return false;
+    }
+};
+exports.OfflineChangeSetService = OfflineChangeSetService;
+exports.OfflineChangeSetService = OfflineChangeSetService = OfflineChangeSetService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        offline_change_set_repository_1.OfflineChangeSetRepository,
+        nestjs_cls_1.ClsService,
+        offline_route_runner_service_1.OfflineRouteRunner])
+], OfflineChangeSetService);
+//# sourceMappingURL=offline-change-set.service.js.map

package/dist/foundations/offline-change-set/services/offline-change-set.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.service.js","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/services/offline-change-set.service.ts"],"names":[],"mappings":"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"}

package/dist/foundations/offline-change-set/services/offline-route-runner.service.d.ts

@@ -0,0 +1,61 @@
+import { DiscoveryService, HttpAdapterHost, MetadataScanner, Reflector } from "@nestjs/core";
+import type { FastifyRequest } from "fastify";
+/**
+ * The per-process token every step of an offline change set carries in `x-offline-internal`.
+ * Random, generated on first use, never leaves the process: only requests this runner injects
+ * carry it, so the throttler can tell them from client requests (one package = one request).
+ */
+export declare function offlineInternalToken(): string;
+/** True when the headers carry this process's `x-offline-internal` token. */
+export declare function isOfflineInternalRequest(headers: Record<string, unknown> | undefined): boolean;
+export type OfflineRouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+/** `ran: false` = refused without running (the route is not marked `@OfflineReplayable()`). */
+export type OfflineRouteAnswer = {
+    ran: true;
+    status: number;
+    body: any;
+} | {
+    ran: false;
+    detail: string;
+};
+/**
+ * Runs one step of an offline change set through the app's own route with Fastify `inject`,
+ * as the caller: the caller's `Authorization`, `x-language` and `x-companyid` headers, plus
+ * `x-offline-replay: 1` and the process token. Every read and write therefore goes through
+ * the app's controller → service → repository, with its guards, validation and checks.
+ *
+ * A write (POST/PUT/PATCH/DELETE) runs only when the route that would answer it carries
+ * `@OfflineReplayable()`; any other write is refused without running. A GET (reading the
+ * current record before a merge) needs no marker: it changes nothing.
+ *
+ * Infrastructure provider: it owns no entity and touches no Neo4j itself.
+ */
+export declare class OfflineRouteRunner {
+    private readonly adapterHost;
+    private readonly discovery;
+    private readonly metadataScanner;
+    private readonly reflector;
+    private routes;
+    constructor(adapterHost: HttpAdapterHost, discovery: DiscoveryService, metadataScanner: MetadataScanner, reflector: Reflector);
+    run(params: {
+        method: OfflineRouteMethod;
+        path: string;
+        body?: unknown;
+        request: FastifyRequest;
+    }): Promise<OfflineRouteAnswer>;
+    /**
+     * `npcs/n1`, `/npcs/n1` or an absolute URL → `/npcs/n1` (query string kept), with dot segments
+     * resolved the way the router resolves them, so the route checked is the route that runs.
+     * `undefined` (refused) for a path that climbs above the root, or that carries an encoded dot
+     * or separator (`%2e`, `%2f`, `%5c`), which a later decode could turn into another path.
+     */
+    private normalise;
+    private parse;
+    /**
+     * The route that answers `method path`, with the router's precedence: a static segment
+     * beats a parameter, a parameter beats a wildcard, compared from the first segment.
+     */
+    private match;
+    private knownRoutes;
+}
+//# sourceMappingURL=offline-route-runner.service.d.ts.map