@carlonicora/nestjs-neo4jsonapi 8.15.1 → 8.16.0

package/dist/core/offline/offline.module.js

@@ -0,0 +1,42 @@
+"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 OfflineModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflineModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const offline_request_context_1 = require("./offline-request.context");
+const offline_request_interceptor_1 = require("./offline-request.interceptor");
+const offline_constants_1 = require("./offline.constants");
+const offline_change_set_module_1 = require("../../foundations/offline-change-set/offline-change-set.module");
+/**
+ * Offline support (opt-in through `bootstrap({ offline })`). Global: provides
+ * `OfflineRequestContext`, the `OFFLINE_OPTIONS` token, and the interceptor that marks
+ * offline replays in CLS. With `changeSets: true` it also loads and re-exports
+ * `OfflineChangeSetModule`, so the app's receiving route can inject `OfflineChangeSetService`.
+ */
+let OfflineModule = OfflineModule_1 = class OfflineModule {
+    static forRoot(options) {
+        return {
+            module: OfflineModule_1,
+            global: true,
+            imports: options.changeSets ? [offline_change_set_module_1.OfflineChangeSetModule] : [],
+            providers: [
+                { provide: offline_constants_1.OFFLINE_OPTIONS, useValue: options },
+                offline_request_context_1.OfflineRequestContext,
+                { provide: core_1.APP_INTERCEPTOR, useClass: offline_request_interceptor_1.OfflineRequestInterceptor },
+            ],
+            exports: [offline_constants_1.OFFLINE_OPTIONS, offline_request_context_1.OfflineRequestContext, ...(options.changeSets ? [offline_change_set_module_1.OfflineChangeSetModule] : [])],
+        };
+    }
+};
+exports.OfflineModule = OfflineModule;
+exports.OfflineModule = OfflineModule = OfflineModule_1 = __decorate([
+    (0, common_1.Module)({})
+], OfflineModule);
+//# sourceMappingURL=offline.module.js.map

package/dist/core/offline/offline.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.module.js","sourceRoot":"","sources":["../../../src/core/offline/offline.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,uCAA+C;AAC/C,uEAAkE;AAClE,+EAA0E;AAC1E,2DAAsE;AACtE,8GAAwG;AAExG;;;;;GAKG;AAEI,IAAM,aAAa,qBAAnB,MAAM,aAAa;IACxB,MAAM,CAAC,OAAO,CAAC,OAAuB;QACpC,OAAO;YACL,MAAM,EAAE,eAAa;YACrB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,kDAAsB,CAAC,CAAC,CAAC,CAAC,EAAE;YAC3D,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,mCAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAC/C,+CAAqB;gBACrB,EAAE,OAAO,EAAE,sBAAe,EAAE,QAAQ,EAAE,uDAAyB,EAAE;aAClE;YACD,OAAO,EAAE,CAAC,mCAAe,EAAE,+CAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,kDAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC3G,CAAC;IACJ,CAAC;CACF,CAAA;AAdY,sCAAa;wBAAb,aAAa;IADzB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,aAAa,CAczB"}

package/dist/foundations/offline-change-set/decorators/offline-replayable.decorator.d.ts

@@ -0,0 +1,7 @@
+export declare const OFFLINE_REPLAYABLE_METADATA = "offline:replayable";
+/**
+ * Marks a write route an offline change set may run. The offline route runner refuses
+ * every write whose route handler does not carry it (answered could-not-apply, never run).
+ */
+export declare const OfflineReplayable: () => MethodDecorator;
+//# sourceMappingURL=offline-replayable.decorator.d.ts.map

package/dist/foundations/offline-change-set/decorators/offline-replayable.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-replayable.decorator.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/decorators/offline-replayable.decorator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,2BAA2B,uBAAuB,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,eAAiE,CAAC"}

package/dist/foundations/offline-change-set/decorators/offline-replayable.decorator.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflineReplayable = exports.OFFLINE_REPLAYABLE_METADATA = void 0;
+const common_1 = require("@nestjs/common");
+exports.OFFLINE_REPLAYABLE_METADATA = "offline:replayable";
+/**
+ * Marks a write route an offline change set may run. The offline route runner refuses
+ * every write whose route handler does not carry it (answered could-not-apply, never run).
+ */
+const OfflineReplayable = () => (0, common_1.SetMetadata)(exports.OFFLINE_REPLAYABLE_METADATA, true);
+exports.OfflineReplayable = OfflineReplayable;
+//# sourceMappingURL=offline-replayable.decorator.js.map

package/dist/foundations/offline-change-set/decorators/offline-replayable.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-replayable.decorator.js","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/decorators/offline-replayable.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAEhC,QAAA,2BAA2B,GAAG,oBAAoB,CAAC;AAEhE;;;GAGG;AACI,MAAM,iBAAiB,GAAG,GAAoB,EAAE,CAAC,IAAA,oBAAW,EAAC,mCAA2B,EAAE,IAAI,CAAC,CAAC;AAA1F,QAAA,iBAAiB,qBAAyE"}

package/dist/foundations/offline-change-set/dtos/offline-change-set.post.dto.d.ts

@@ -0,0 +1,33 @@
+export declare const OFFLINE_CHANGE_METHODS: readonly ["POST", "PUT", "PATCH", "DELETE"];
+export declare const OFFLINE_FIELD_CHOICES: readonly ["mine", "theirs", "merged"];
+export declare class OfflineChangeResolutionDTO {
+    kind: "mine" | "merged";
+    /** Per conflicting field: whose value wins. */
+    choices?: Record<string, (typeof OFFLINE_FIELD_CHOICES)[number]>;
+    /** The model-built document holding only the fields chosen "merged". */
+    mergedBody?: Record<string, unknown>;
+}
+/** One queued change. */
+export declare class OfflineChangeDTO {
+    seq: number;
+    method: (typeof OFFLINE_CHANGE_METHODS)[number];
+    path: string;
+    body?: Record<string, unknown>;
+    recordType?: string;
+    recordId?: string;
+    base?: Record<string, unknown> | null;
+    resolution?: OfflineChangeResolutionDTO;
+}
+export declare class OfflineChangeSetPostAttributesDTO {
+    changes: OfflineChangeDTO[];
+}
+export declare class OfflineChangeSetPostDataDTO {
+    type: string;
+    id: string;
+    attributes: OfflineChangeSetPostAttributesDTO;
+}
+/** `POST /offline-change-sets`: every change the device queued, in one package. */
+export declare class OfflineChangeSetPostDTO {
+    data: OfflineChangeSetPostDataDTO;
+}
+//# sourceMappingURL=offline-change-set.post.dto.d.ts.map

package/dist/foundations/offline-change-set/dtos/offline-change-set.post.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.post.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/dtos/offline-change-set.post.dto.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,sBAAsB,6CAA8C,CAAC;AAElF,eAAO,MAAM,qBAAqB,uCAAwC,CAAC;AAoB3E,qBAAa,0BAA0B;IAGrC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IAExB,+CAA+C;IAG/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjE,wEAAwE;IAGxE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,yBAAyB;AACzB,qBAAa,gBAAgB;IAI3B,GAAG,EAAE,MAAM,CAAC;IAIZ,MAAM,EAAE,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;IAKhD,IAAI,EAAE,MAAM,CAAC;IAIb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/B,UAAU,CAAC,EAAE,MAAM,CAAC;IAIpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAIlB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAKtC,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC;AAED,qBAAa,iCAAiC;IAK5C,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,qBAAa,2BAA2B;IAEtC,IAAI,EAAE,MAAM,CAAC;IAGb,EAAE,EAAE,MAAM,CAAC;IAKX,UAAU,EAAE,iCAAiC,CAAC;CAC/C;AAED,mFAAmF;AACnF,qBAAa,uBAAuB;IAIlC,IAAI,EAAE,2BAA2B,CAAC;CACnC"}

package/dist/foundations/offline-change-set/dtos/offline-change-set.post.dto.js

@@ -0,0 +1,133 @@
+"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.OfflineChangeSetPostDTO = exports.OfflineChangeSetPostDataDTO = exports.OfflineChangeSetPostAttributesDTO = exports.OfflineChangeDTO = exports.OfflineChangeResolutionDTO = exports.OFFLINE_FIELD_CHOICES = exports.OFFLINE_CHANGE_METHODS = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const offline_change_set_meta_1 = require("../entities/offline-change-set.meta");
+exports.OFFLINE_CHANGE_METHODS = ["POST", "PUT", "PATCH", "DELETE"];
+exports.OFFLINE_FIELD_CHOICES = ["mine", "theirs", "merged"];
+/** An object whose every value is one of `OFFLINE_FIELD_CHOICES`. */
+function IsOfflineFieldChoices(options) {
+    return (0, class_validator_1.ValidateBy)({
+        name: "isOfflineFieldChoices",
+        validator: {
+            validate: (value) => !!value &&
+                typeof value === "object" &&
+                !Array.isArray(value) &&
+                Object.values(value).every((choice) => exports.OFFLINE_FIELD_CHOICES.includes(choice)),
+            defaultMessage: () => `each choice must be one of ${exports.OFFLINE_FIELD_CHOICES.join(", ")}`,
+        },
+    }, options);
+}
+class OfflineChangeResolutionDTO {
+}
+exports.OfflineChangeResolutionDTO = OfflineChangeResolutionDTO;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsIn)(["mine", "merged"]),
+    __metadata("design:type", String)
+], OfflineChangeResolutionDTO.prototype, "kind", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    IsOfflineFieldChoices(),
+    __metadata("design:type", Object)
+], OfflineChangeResolutionDTO.prototype, "choices", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], OfflineChangeResolutionDTO.prototype, "mergedBody", void 0);
+/** One queued change. */
+class OfflineChangeDTO {
+}
+exports.OfflineChangeDTO = OfflineChangeDTO;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], OfflineChangeDTO.prototype, "seq", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsIn)(exports.OFFLINE_CHANGE_METHODS),
+    __metadata("design:type", Object)
+], OfflineChangeDTO.prototype, "method", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OfflineChangeDTO.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], OfflineChangeDTO.prototype, "body", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OfflineChangeDTO.prototype, "recordType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OfflineChangeDTO.prototype, "recordId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], OfflineChangeDTO.prototype, "base", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => OfflineChangeResolutionDTO),
+    __metadata("design:type", OfflineChangeResolutionDTO)
+], OfflineChangeDTO.prototype, "resolution", void 0);
+class OfflineChangeSetPostAttributesDTO {
+}
+exports.OfflineChangeSetPostAttributesDTO = OfflineChangeSetPostAttributesDTO;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => OfflineChangeDTO),
+    __metadata("design:type", Array)
+], OfflineChangeSetPostAttributesDTO.prototype, "changes", void 0);
+class OfflineChangeSetPostDataDTO {
+}
+exports.OfflineChangeSetPostDataDTO = OfflineChangeSetPostDataDTO;
+__decorate([
+    (0, class_validator_1.Equals)(offline_change_set_meta_1.offlineChangeSetMeta.endpoint),
+    __metadata("design:type", String)
+], OfflineChangeSetPostDataDTO.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], OfflineChangeSetPostDataDTO.prototype, "id", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => OfflineChangeSetPostAttributesDTO),
+    __metadata("design:type", OfflineChangeSetPostAttributesDTO)
+], OfflineChangeSetPostDataDTO.prototype, "attributes", void 0);
+/** `POST /offline-change-sets`: every change the device queued, in one package. */
+class OfflineChangeSetPostDTO {
+}
+exports.OfflineChangeSetPostDTO = OfflineChangeSetPostDTO;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => OfflineChangeSetPostDataDTO),
+    __metadata("design:type", OfflineChangeSetPostDataDTO)
+], OfflineChangeSetPostDTO.prototype, "data", void 0);
+//# sourceMappingURL=offline-change-set.post.dto.js.map

package/dist/foundations/offline-change-set/dtos/offline-change-set.post.dto.js.map

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

package/dist/foundations/offline-change-set/entities/offline-change-set.d.ts

@@ -0,0 +1,66 @@
+import { type Entity } from "../../../common";
+/** One change the device queued while offline, as the request carries it. */
+export type OfflineChange = {
+    seq: number;
+    method: "POST" | "PUT" | "PATCH" | "DELETE";
+    /** Relative to the API base, as EndpointCreator built it. */
+    path: string;
+    /** The JSON:API document the model built when the GM saved. */
+    body?: Record<string, unknown>;
+    /** Set for an edit or delete of one record. */
+    recordType?: string;
+    recordId?: string;
+    /** The record's JSON:API resource as of the last sync. */
+    base?: Record<string, unknown> | null;
+    /**
+     * The GM's answer to an earlier conflict. The change keeps its original method, path, body
+     * and base; the server merges again and settles each conflicting field by its choice.
+     */
+    resolution?: OfflineChangeResolution;
+};
+/** Whose value a conflicting field takes: the device's, the server's, or the hand-merged one. */
+export type OfflineFieldChoice = "mine" | "theirs" | "merged";
+export type OfflineChangeResolution = {
+    /** "mine" = every conflicting field "mine"; "merged" = per field, from `choices`. */
+    kind: "mine" | "merged";
+    /** Per conflicting field (attribute or relationship name): whose value wins. */
+    choices?: Record<string, OfflineFieldChoice>;
+    /**
+     * The JSON:API document the record type's model built holding only the fields chosen
+     * "merged", with their hand-merged values (read from `data.attributes`).
+     */
+    mergedBody?: Record<string, unknown>;
+};
+/** What the server did with one change. */
+export type OfflineChangeResult = {
+    seq: number;
+    status: "applied" | "conflict" | "could-not-apply" | "waiting";
+    conflict?: "fields" | "deleted-on-server" | "changed-on-server";
+    /** JSON:API resource as it is now on the server. */
+    current?: Record<string, unknown> | null;
+    /** Attributes the merge settled (for the conflict screen). */
+    merged?: Record<string, unknown>;
+    conflictFields?: string[];
+    /** Rich-text field → conflicting block ids. */
+    conflictBlocks?: Record<string, string[]>;
+    /** The server's reason for could-not-apply. */
+    detail?: string;
+    /** JSON:API document the route answered, when applied. */
+    response?: Record<string, unknown>;
+};
+/**
+ * The answer to one offline change set (one package of every change the device queued).
+ *
+ * Stored as an `OfflineChangeSet` node of the caller's company once the package has been
+ * opened, so a package the device sends again (same id) is answered with the same results
+ * and never applied twice. The node keeps the results as the JSON string `resultsJson`, which
+ * never goes on the wire; `results` is derived from it (or taken as given for a package just
+ * opened) and is what the answer carries in `attributes`.
+ */
+export type OfflineChangeSet = Entity & {
+    results?: OfflineChangeResult[];
+    resultsJson?: string;
+};
+export declare const OfflineChangeSetDescriptor: import("../../../common").EntityDescriptor<OfflineChangeSet, {}>;
+export type OfflineChangeSetDescriptorType = typeof OfflineChangeSetDescriptor;
+//# sourceMappingURL=offline-change-set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/entities/offline-change-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG5D,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,qFAAqF;IACrF,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,EAAE,QAAQ,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;IAChE,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IACtC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,0BAA0B,kEA0BrC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,OAAO,0BAA0B,CAAC"}

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfflineChangeSetDescriptor = void 0;
+const common_1 = require("../../../common");
+const offline_change_set_meta_1 = require("./offline-change-set.meta");
+exports.OfflineChangeSetDescriptor = (0, common_1.defineEntity)()({
+    ...offline_change_set_meta_1.offlineChangeSetMeta,
+    isCompanyScoped: true,
+    fields: {
+        resultsJson: { type: "string", excludeFromJsonApi: true, excludeFromSearch: true },
+    },
+    // Derived, output-only: a virtual field, because the serialiser emits a `computed` value only
+    // into meta (`computedDef.meta`) or nowhere, and the answer carries `results` in attributes.
+    virtualFields: {
+        results: {
+            compute: ({ data }) => {
+                if (Array.isArray(data?.results))
+                    return data.results;
+                try {
+                    const parsed = JSON.parse(data?.resultsJson ?? "[]");
+                    return Array.isArray(parsed) ? parsed : [];
+                }
+                catch {
+                    return [];
+                }
+            },
+        },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=offline-change-set.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.js","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/entities/offline-change-set.ts"],"names":[],"mappings":";;;AAAA,4CAA4D;AAC5D,uEAAiE;AAqEpD,QAAA,0BAA0B,GAAG,IAAA,qBAAY,GAAoB,CAAC;IACzE,GAAG,8CAAoB;IAEvB,eAAe,EAAE,IAAI;IAErB,MAAM,EAAE;QACN,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;KACnF;IAED,8FAA8F;IAC9F,6FAA6F;IAC7F,aAAa,EAAE;QACb,OAAO,EAAE;YACP,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;gBACpB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;oBAAE,OAAO,IAAI,CAAC,OAAO,CAAC;gBACtD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC;oBACrD,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;SACF;KACF;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/offline-change-set/entities/offline-change-set.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common";
+export declare const offlineChangeSetMeta: DataMeta;
+//# sourceMappingURL=offline-change-set.meta.d.ts.map

package/dist/foundations/offline-change-set/entities/offline-change-set.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/entities/offline-change-set.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,eAAO,MAAM,oBAAoB,EAAE,QAKlC,CAAC"}

package/dist/foundations/offline-change-set/entities/offline-change-set.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.offlineChangeSetMeta = void 0;
+exports.offlineChangeSetMeta = {
+    type: "offline-change-sets",
+    endpoint: "offline-change-sets",
+    nodeName: "offlineChangeSet",
+    labelName: "OfflineChangeSet",
+};
+//# sourceMappingURL=offline-change-set.meta.js.map

package/dist/foundations/offline-change-set/entities/offline-change-set.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-change-set.meta.js","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/entities/offline-change-set.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAa;IAC5C,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ,EAAE,kBAAkB;IAC5B,SAAS,EAAE,kBAAkB;CAC9B,CAAC"}

package/dist/foundations/offline-change-set/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./decorators/offline-replayable.decorator";
+export * from "./dtos/offline-change-set.post.dto";
+export * from "./entities/offline-change-set";
+export * from "./entities/offline-change-set.meta";
+export * from "./merge/merge-blocks";
+export * from "./merge/three-way-merge";
+export * from "./offline-change-set.module";
+export * from "./repositories/offline-change-set.repository";
+export * from "./services/offline-change-set.service";
+export * from "./services/offline-route-runner.service";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/offline-change-set/index.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC"}

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

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./decorators/offline-replayable.decorator"), exports);
+__exportStar(require("./dtos/offline-change-set.post.dto"), exports);
+__exportStar(require("./entities/offline-change-set"), exports);
+__exportStar(require("./entities/offline-change-set.meta"), exports);
+__exportStar(require("./merge/merge-blocks"), exports);
+__exportStar(require("./merge/three-way-merge"), exports);
+__exportStar(require("./offline-change-set.module"), exports);
+__exportStar(require("./repositories/offline-change-set.repository"), exports);
+__exportStar(require("./services/offline-change-set.service"), exports);
+__exportStar(require("./services/offline-route-runner.service"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/offline-change-set/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4EAA0D;AAC1D,qEAAmD;AACnD,gEAA8C;AAC9C,qEAAmD;AACnD,uDAAqC;AACrC,0DAAwC;AACxC,8DAA4C;AAC5C,+EAA6D;AAC7D,wEAAsD;AACtD,0EAAwD"}

package/dist/foundations/offline-change-set/merge/deep-equal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Structural equality for JSON values: key order does not matter, array order does.
+ * `undefined` and `null` are equal (a missing attribute and a null one mean the same on the wire).
+ */
+export declare function jsonEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=deep-equal.d.ts.map

package/dist/foundations/offline-change-set/merge/deep-equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/merge/deep-equal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAgBzD"}

package/dist/foundations/offline-change-set/merge/deep-equal.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonEqual = jsonEqual;
+/**
+ * Structural equality for JSON values: key order does not matter, array order does.
+ * `undefined` and `null` are equal (a missing attribute and a null one mean the same on the wire).
+ */
+function jsonEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return a == null && b == null;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((item, index) => jsonEqual(item, b[index]));
+    }
+    if (typeof a === "object") {
+        const ao = a;
+        const bo = b;
+        const keys = new Set([...Object.keys(ao), ...Object.keys(bo)]);
+        for (const key of keys)
+            if (!jsonEqual(ao[key], bo[key]))
+                return false;
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=deep-equal.js.map

package/dist/foundations/offline-change-set/merge/deep-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal.js","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/merge/deep-equal.ts"],"names":[],"mappings":";;AAIA,8BAgBC;AApBD;;;GAGG;AACH,SAAgB,SAAS,CAAC,CAAU,EAAE,CAAU;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;IAC1D,IAAI,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAClF,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,CAA4B,CAAC;QACxC,MAAM,EAAE,GAAG,CAA4B,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/D,KAAK,MAAM,GAAG,IAAI,IAAI;YAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/foundations/offline-change-set/merge/merge-blocks.d.ts

@@ -0,0 +1,37 @@
+/** One top-level BlockNote block; its children are part of it. Only `id` is read. */
+export type Block = {
+    id: string;
+    [key: string]: unknown;
+};
+/** Which side wins a conflicting block (and a conflicting order) once the GM has chosen. */
+export type BlockPreference = "mine" | "theirs";
+/**
+ * Block-by-block three-way merge of one rich-text field (BlockNote document).
+ *
+ * Blocks are compared by id as objects, never turned into text. Starting from the
+ * server's blocks (theirs):
+ * - a block changed only on the device takes the device's version;
+ * - a block removed on one side and untouched on the other is removed;
+ * - a block added on the device lands after the block that precedes it on the device;
+ * - a block changed on both sides (differently), or removed on one side and changed on
+ *   the other, is a conflict: the merged document keeps the server's version and its
+ *   id is listed in `conflictBlockIds`;
+ * - order: when only one side moved blocks, the merged document follows that side's order
+ *   (the blocks' content still merges as above); when both sides moved blocks into different
+ *   orders, `orderConflict` is true and the server's order is kept.
+ *
+ * With `prefer: "mine"` (the GM chose this device's version of the field) every conflict
+ * resolves to the device's side instead (its block, its removal, its order) and nothing is
+ * reported; `prefer: "theirs"` resolves them to the server's side.
+ */
+export declare function mergeBlocks(p: {
+    base: Block[];
+    mine: Block[];
+    theirs: Block[];
+    prefer?: BlockPreference;
+}): {
+    merged: Block[];
+    conflictBlockIds: string[];
+    orderConflict: boolean;
+};
+//# sourceMappingURL=merge-blocks.d.ts.map

package/dist/foundations/offline-change-set/merge/merge-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-blocks.d.ts","sourceRoot":"","sources":["../../../../src/foundations/offline-change-set/merge/merge-blocks.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,MAAM,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE3D,4FAA4F;AAC5F,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE;IAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,GAAG;IAC3G,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB,CAoFA"}