@carlonicora/nestjs-neo4jsonapi 8.15.1 → 8.16.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"offline-route-runner.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/services/offline-route-runner.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAG7C;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAO9F;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7E,+FAA+F;AAC/F,MAAM,MAAM,kBAAkB,GAAG;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAW3G;;;;;;;;;;;GAWG;AACH,qBACa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,MAAM,CAA2B;gBAGtB,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,SAAS;IAGjC,GAAG,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,kBAAkB,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+B/B;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,KAAK;IASb;;;OAGG;IACH,OAAO,CAAC,KAAK;IA0Bb,OAAO,CAAC,WAAW;CA4BpB"}

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

@@ -0,0 +1,192 @@
+"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.OfflineRouteRunner = void 0;
+exports.offlineInternalToken = offlineInternalToken;
+exports.isOfflineInternalRequest = isOfflineInternalRequest;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("@nestjs/common/constants");
+const core_1 = require("@nestjs/core");
+const crypto_1 = require("crypto");
+const offline_constants_1 = require("../../../core/offline/offline.constants");
+const offline_replayable_decorator_1 = require("../decorators/offline-replayable.decorator");
+let processToken;
+/**
+ * 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).
+ */
+function offlineInternalToken() {
+    if (!processToken)
+        processToken = (0, crypto_1.randomBytes)(32).toString("hex");
+    return processToken;
+}
+/** True when the headers carry this process's `x-offline-internal` token. */
+function isOfflineInternalRequest(headers) {
+    const raw = headers?.[offline_constants_1.OFFLINE_INTERNAL_HEADER];
+    const value = Array.isArray(raw) ? raw[0] : raw;
+    if (typeof value !== "string" || value.length === 0)
+        return false;
+    const expected = Buffer.from(offlineInternalToken());
+    const given = Buffer.from(value);
+    return given.length === expected.length && (0, crypto_1.timingSafeEqual)(given, expected);
+}
+/** Headers of the caller's request carried into every injected step. */
+const FORWARDED_HEADERS = ["authorization", "x-language", "x-companyid"];
+const splitPath = (path) => path.split("/").filter((s) => s.length > 0);
+const firstPath = (value) => (Array.isArray(value) ? String(value[0] ?? "") : String(value ?? ""));
+/**
+ * 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.
+ */
+let OfflineRouteRunner = class OfflineRouteRunner {
+    constructor(adapterHost, discovery, metadataScanner, reflector) {
+        this.adapterHost = adapterHost;
+        this.discovery = discovery;
+        this.metadataScanner = metadataScanner;
+        this.reflector = reflector;
+    }
+    async run(params) {
+        const url = this.normalise(params.path);
+        if (url === undefined)
+            return { ran: false, detail: `${params.method} ${params.path} is not a path an offline change set can run` };
+        if (params.method !== "GET") {
+            const route = this.match(params.method, url.split("?")[0]);
+            if (!route?.replayable)
+                return { ran: false, detail: `${params.method} ${url} cannot be run from an offline change set` };
+        }
+        const headers = {};
+        const source = (params.request?.headers ?? {});
+        for (const name of FORWARDED_HEADERS) {
+            const value = source[name];
+            if (typeof value === "string" && value.length > 0)
+                headers[name] = value;
+        }
+        headers[offline_constants_1.OFFLINE_REPLAY_HEADER] = "1";
+        headers[offline_constants_1.OFFLINE_INTERNAL_HEADER] = offlineInternalToken();
+        if (params.body !== undefined)
+            headers["content-type"] = "application/json";
+        const response = await this.adapterHost.httpAdapter.getInstance().inject({
+            method: params.method,
+            url,
+            headers,
+            ...(params.body !== undefined ? { payload: params.body } : {}),
+        });
+        return { ran: true, status: response.statusCode, body: this.parse(response.body) };
+    }
+    /**
+     * `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.
+     */
+    normalise(path) {
+        const absolute = /^https?:\/\//i.test(path);
+        // The path as sent (an absolute URL's pathname is already resolved by URL, so read it raw).
+        const raw = (absolute ? path.replace(/^https?:\/\/[^/?#]*/i, "") : path).split(/[?#]/)[0];
+        if (/%2e|%2f|%5c/i.test(raw))
+            return undefined;
+        let depth = 0;
+        for (const segment of raw.split(/[\/\\]/)) {
+            if (segment === "" || segment === ".")
+                continue;
+            depth += segment === ".." ? -1 : 1;
+            if (depth < 0)
+                return undefined;
+        }
+        const parsed = absolute ? new URL(path) : new URL(`/${path.replace(/^[\/\\]+/, "")}`, "http://internal");
+        const pathname = parsed.pathname.replace(/\/{2,}/g, "/");
+        return `${pathname}${parsed.search}`;
+    }
+    parse(body) {
+        if (body === undefined || body === "")
+            return undefined;
+        try {
+            return JSON.parse(body);
+        }
+        catch {
+            return body;
+        }
+    }
+    /**
+     * 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.
+     */
+    match(method, path) {
+        const segments = splitPath(path);
+        const rank = (segment) => (segment === "*" ? 0 : segment.startsWith(":") ? 1 : 2);
+        const candidates = this.knownRoutes().filter((route) => {
+            if (route.method !== method && route.method !== "ALL")
+                return false;
+            const wildcard = route.segments[route.segments.length - 1] === "*";
+            if (!wildcard && route.segments.length !== segments.length)
+                return false;
+            if (wildcard && segments.length < route.segments.length - 1)
+                return false;
+            return route.segments.every((segment, index) => segment === "*" || segment.startsWith(":") || segment === segments[index]);
+        });
+        candidates.sort((a, b) => {
+            const length = Math.max(a.segments.length, b.segments.length);
+            for (let index = 0; index < length; index++) {
+                const diff = rank(b.segments[index] ?? "*") - rank(a.segments[index] ?? "*");
+                if (diff !== 0)
+                    return diff;
+            }
+            return 0;
+        });
+        return candidates[0];
+    }
+    knownRoutes() {
+        if (this.routes)
+            return this.routes;
+        const routes = [];
+        for (const wrapper of this.discovery.getControllers()) {
+            const controller = wrapper.metatype;
+            if (typeof controller !== "function" || !controller.prototype)
+                continue;
+            const prototype = controller.prototype;
+            const controllerPath = firstPath(this.reflector.get(constants_1.PATH_METADATA, controller));
+            for (const methodName of this.metadataScanner.getAllMethodNames(prototype)) {
+                const handler = prototype[methodName];
+                if (typeof handler !== "function")
+                    continue;
+                const requestMethod = this.reflector.get(constants_1.METHOD_METADATA, handler);
+                const routePath = this.reflector.get(constants_1.PATH_METADATA, handler);
+                if (requestMethod === undefined || routePath === undefined)
+                    continue;
+                routes.push({
+                    method: common_1.RequestMethod[requestMethod] ?? String(requestMethod),
+                    segments: [...splitPath(controllerPath), ...splitPath(firstPath(routePath))],
+                    replayable: this.reflector.get(offline_replayable_decorator_1.OFFLINE_REPLAYABLE_METADATA, handler) === true,
+                });
+            }
+        }
+        this.routes = routes;
+        return routes;
+    }
+};
+exports.OfflineRouteRunner = OfflineRouteRunner;
+exports.OfflineRouteRunner = OfflineRouteRunner = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.HttpAdapterHost,
+        core_1.DiscoveryService,
+        core_1.MetadataScanner,
+        core_1.Reflector])
+], OfflineRouteRunner);
+//# sourceMappingURL=offline-route-runner.service.js.map

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

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

package/dist/index.d.ts

@@ -16,4 +16,6 @@ export * from "./openapi";
 export { RedisLockService } from "./core/redis/services/redis.lock.service";
 export { TRUSTED_ORIGINS_RESOLVER } from "./core/cors/interfaces/trusted-origins.resolver.interface";
 export type { TrustedOriginsResolver } from "./core/cors/interfaces/trusted-origins.resolver.interface";
+export * from "./core/offline";
+export * from "./foundations/offline-change-set";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,UAAU,CAAC;AAGzB,cAAc,OAAO,CAAC;AAGtB,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AACrG,YAAY,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,UAAU,CAAC;AAGzB,cAAc,OAAO,CAAC;AAGtB,cAAc,aAAa,CAAC;AAG5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AACrG,YAAY,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AAGxG,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kCAAkC,CAAC"}