@lenne.tech/nest-server 12.1.0 → 12.2.0

package/dist/core/modules/sync/core-sync-hints.service.js

@@ -0,0 +1,155 @@
+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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CoreSyncHintService_1;
+import { Injectable, Logger, Optional } from '@nestjs/common';
+import { randomUUID } from 'node:crypto';
+import { ConfigService } from '../../common/services/config.service.js';
+import { CoreRedisService } from '../../common/services/core-redis.service.js';
+import { SYNC_DEFAULTS } from './core-sync.constants.js';
+let CoreSyncHintService = CoreSyncHintService_1 = class CoreSyncHintService {
+    redisService;
+    logger = new Logger(CoreSyncHintService_1.name);
+    origin = randomUUID();
+    subscribers = new Set();
+    pending = new Map();
+    channel;
+    redisListener;
+    constructor(redisService) {
+        this.redisService = redisService;
+    }
+    get config() {
+        const sync = ConfigService.configFastButReadOnly?.sync;
+        const hints = sync && typeof sync === 'object' ? sync.hints : undefined;
+        if (hints === false) {
+            return { enabled: false };
+        }
+        return hints && typeof hints === 'object' ? hints : {};
+    }
+    get enabled() {
+        return this.config.enabled !== false;
+    }
+    get debounceMs() {
+        const value = this.config.debounceMs;
+        return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : SYNC_DEFAULTS.hintDebounceMs;
+    }
+    async onApplicationBootstrap() {
+        if (!this.enabled || !this.redisService?.enabled) {
+            return;
+        }
+        const channel = this.redisService.key('sync', 'hints');
+        try {
+            this.channel = channel;
+            this.redisListener = (incoming, message) => {
+                if (incoming === channel) {
+                    this.receive(message);
+                }
+            };
+            this.redisService.getSubscriber().on('message', this.redisListener);
+            await this.redisService.subscribeChannel(channel);
+        }
+        catch (error) {
+            this.logger.warn(`Sync hints: Redis subscribe failed (${error?.message ?? error}) — retried when the connection is ` +
+                "up; until then this replica's subscribers receive only its own hints");
+        }
+    }
+    onModuleDestroy() {
+        for (const timer of this.pending.values()) {
+            clearTimeout(timer);
+        }
+        this.pending.clear();
+        this.subscribers.clear();
+        if (this.redisListener) {
+            try {
+                this.redisService?.getSubscriber().off('message', this.redisListener);
+                if (this.channel) {
+                    void this.redisService?.releaseChannel(this.channel).catch(() => undefined);
+                }
+            }
+            catch {
+            }
+            this.redisListener = undefined;
+        }
+    }
+    notify(model, tenantIds = [undefined]) {
+        if (!this.enabled) {
+            return;
+        }
+        for (const tenantId of tenantIds.length ? new Set(tenantIds) : [undefined]) {
+            const key = `${model}\u0000${tenantId ?? ''}`;
+            if (this.pending.has(key)) {
+                continue;
+            }
+            const timer = setTimeout(() => {
+                this.pending.delete(key);
+                this.send({ at: Date.now(), model, ...(tenantId ? { tenantId } : {}) });
+            }, this.debounceMs);
+            timer.unref?.();
+            this.pending.set(key, timer);
+        }
+    }
+    subscribe(handler) {
+        this.subscribers.add(handler);
+        return () => {
+            this.subscribers.delete(handler);
+        };
+    }
+    send(hint) {
+        this.deliver(hint);
+        if (!this.channel || !this.redisService?.enabled) {
+            return;
+        }
+        try {
+            void this.redisService
+                .getClient()
+                .publish(this.channel, JSON.stringify({ ...hint, origin: this.origin }))
+                .catch((error) => this.logger.debug(`Sync hint publish failed: ${error.message}`));
+        }
+        catch (error) {
+            this.logger.debug(`Sync hint publish failed: ${error?.message ?? error}`);
+        }
+    }
+    receive(message) {
+        let parsed;
+        try {
+            parsed = JSON.parse(message);
+        }
+        catch {
+            return;
+        }
+        if (!parsed || parsed.origin === this.origin || typeof parsed.model !== 'string' || !Number.isFinite(parsed.at)) {
+            return;
+        }
+        this.deliver({
+            at: Number(parsed.at),
+            model: parsed.model,
+            ...(typeof parsed.tenantId === 'string' && parsed.tenantId ? { tenantId: parsed.tenantId } : {}),
+        });
+    }
+    deliver(hint) {
+        for (const handler of this.subscribers) {
+            try {
+                handler(hint);
+            }
+            catch (error) {
+                this.logger.warn(`Sync hint subscriber failed: ${error?.message ?? error}`);
+            }
+        }
+    }
+};
+CoreSyncHintService = CoreSyncHintService_1 = __decorate([
+    Injectable(),
+    __param(0, Optional()),
+    __metadata("design:paramtypes", [CoreRedisService])
+], CoreSyncHintService);
+export { CoreSyncHintService };
+//# sourceMappingURL=core-sync-hints.service.js.map

package/dist/core/modules/sync/core-sync-hints.service.js.map

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

package/dist/core/modules/sync/core-sync-infrastructure.models.d.ts

@@ -0,0 +1,2 @@
+export declare const SyncMutationSchema: any;
+export declare const SyncStateSchema: any;

package/dist/core/modules/sync/core-sync-infrastructure.models.js

@@ -0,0 +1,17 @@
+import { createSchema } from '../../common/persistence/mongo/mongoose-compat.js';
+export const SyncMutationSchema = createSchema({
+    attempt: { type: Number },
+    claimedAt: { type: Date },
+    code: { type: String },
+    expiresAt: { index: { expireAfterSeconds: 0 }, type: Date },
+    key: { index: { unique: true }, type: String },
+    state: { type: String },
+    status: { type: String },
+    version: { type: Number },
+}, { collection: 'syncMutations', versionKey: false });
+export const SyncStateSchema = createSchema({
+    epoch: { type: Number },
+    horizon: { type: Date },
+    key: { index: { unique: true }, type: String },
+}, { collection: 'syncStates', versionKey: false });
+//# sourceMappingURL=core-sync-infrastructure.models.js.map

package/dist/core/modules/sync/core-sync-infrastructure.models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-sync-infrastructure.models.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync-infrastructure.models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAcjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAC5C;IACE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACzB,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACzB,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACtB,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC3D,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IAC9C,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACvB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACxB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;CAC1B,EACD,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,CACnD,CAAC;AAMF,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CACzC;IACE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACvB,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACvB,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;CAC/C,EACD,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,CAChD,CAAC"}

package/dist/core/modules/sync/core-sync-mutation.store.d.ts

@@ -0,0 +1,43 @@
+import type { DataStore, StoredRecord } from '../../common/persistence/data-store.interface.js';
+export interface SyncMutationOutcome {
+    code?: string;
+    status: string;
+    version?: number;
+}
+export type SyncMutationClaim = {
+    kind: 'busy';
+} | {
+    kind: 'claimed';
+} | {
+    kind: 'done';
+    outcome: SyncMutationOutcome;
+};
+interface MutationRecord {
+    attempt?: number;
+    claimedAt?: Date;
+    code?: null | string;
+    expiresAt?: Date;
+    key: string;
+    state?: string;
+    status?: null | string;
+    version?: null | number;
+}
+export declare class CoreSyncMutationStore {
+    protected readonly store: DataStore<MutationRecord>;
+    protected readonly options: {
+        claimTimeoutMs: number;
+        retentionMs: number;
+    };
+    constructor(store: DataStore<MutationRecord>, options: {
+        claimTimeoutMs: number;
+        retentionMs: number;
+    });
+    static key(model: string, userId: string, recordId: string, mutationId: string): string;
+    claim(key: string, now?: Date): Promise<SyncMutationClaim>;
+    complete(key: string, outcome: SyncMutationOutcome, now?: Date): Promise<void>;
+    release(key: string): Promise<void>;
+    protected pending(now: Date, attempt: number): Omit<MutationRecord, 'key'>;
+    protected takeOver(existing: StoredRecord<MutationRecord>, now: Date): Promise<boolean>;
+}
+export declare function isDuplicateKey(error: unknown): boolean;
+export {};

package/dist/core/modules/sync/core-sync-mutation.store.js

@@ -0,0 +1,88 @@
+import { createHash } from 'node:crypto';
+export class CoreSyncMutationStore {
+    store;
+    options;
+    constructor(store, options) {
+        this.store = store;
+        this.options = options;
+    }
+    static key(model, userId, recordId, mutationId) {
+        return createHash('sha256').update([model, userId, recordId, mutationId].join('\u0000')).digest('hex');
+    }
+    async claim(key, now = new Date()) {
+        for (let round = 0; round < 3; round++) {
+            const existing = await this.store.findOne({ key });
+            if (!existing) {
+                try {
+                    await this.store.insert({ key, ...this.pending(now, 1) });
+                    return { kind: 'claimed' };
+                }
+                catch (error) {
+                    if (!isDuplicateKey(error)) {
+                        throw error;
+                    }
+                    continue;
+                }
+            }
+            if (isExpired(existing, now)) {
+                if (await this.takeOver(existing, now)) {
+                    return { kind: 'claimed' };
+                }
+                continue;
+            }
+            if (existing.state === 'done' && existing.status) {
+                return { kind: 'done', outcome: outcomeOf(existing) };
+            }
+            const claimedAt = existing.claimedAt ? new Date(existing.claimedAt).getTime() : 0;
+            if (now.getTime() - claimedAt < this.options.claimTimeoutMs) {
+                return { kind: 'busy' };
+            }
+            return (await this.takeOver(existing, now)) ? { kind: 'claimed' } : { kind: 'busy' };
+        }
+        return { kind: 'busy' };
+    }
+    async complete(key, outcome, now = new Date()) {
+        await this.store.updateOne({ key }, {
+            $set: {
+                code: outcome.code ?? null,
+                expiresAt: new Date(now.getTime() + this.options.retentionMs),
+                state: 'done',
+                status: outcome.status,
+                version: outcome.version ?? null,
+            },
+        });
+    }
+    async release(key) {
+        await this.store.deleteOne({ key, state: 'pending' });
+    }
+    pending(now, attempt) {
+        return {
+            attempt,
+            claimedAt: now,
+            code: null,
+            expiresAt: new Date(now.getTime() + this.options.retentionMs),
+            state: 'pending',
+            status: null,
+            version: null,
+        };
+    }
+    async takeOver(existing, now) {
+        const attempt = existing.attempt ?? 0;
+        const taken = await this.store.updateOne({ attempt: existing.attempt ?? null, id: existing.id }, { $set: this.pending(now, attempt + 1) });
+        return !!taken;
+    }
+}
+function isExpired(record, now) {
+    return !!record.expiresAt && new Date(record.expiresAt).getTime() <= now.getTime();
+}
+function outcomeOf(record) {
+    return {
+        ...(record.code ? { code: record.code } : {}),
+        status: record.status,
+        ...(typeof record.version === 'number' ? { version: record.version } : {}),
+    };
+}
+export function isDuplicateKey(error) {
+    return error?.code === 11000;
+}
+//# sourceMappingURL=core-sync-mutation.store.js.map

package/dist/core/modules/sync/core-sync-mutation.store.js.map

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

package/dist/core/modules/sync/core-sync-state.store.d.ts

@@ -0,0 +1,18 @@
+import type { DataStore } from '../../common/persistence/data-store.interface.js';
+interface StateRecord {
+    epoch?: null | number;
+    horizon?: Date | null;
+    key: string;
+}
+export declare class CoreSyncStateStore {
+    protected readonly store: DataStore<StateRecord>;
+    constructor(store: DataStore<StateRecord>);
+    static tenantEpochKey(model: string, tenantId: string): string;
+    static userEpochKey(model: string, tenantId: string, userId: string): string;
+    static horizonKey(model: string): string;
+    epochs(keys: readonly string[]): Promise<Map<string, number>>;
+    bump(key: string): Promise<void>;
+    horizon(model: string): Promise<Date | undefined>;
+    advanceHorizon(model: string, at: Date): Promise<void>;
+}
+export {};

package/dist/core/modules/sync/core-sync-state.store.js

@@ -0,0 +1,64 @@
+import { isDuplicateKey } from './core-sync-mutation.store.js';
+export class CoreSyncStateStore {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    static tenantEpochKey(model, tenantId) {
+        return `epoch:t:${model}:${tenantId}`;
+    }
+    static userEpochKey(model, tenantId, userId) {
+        return `epoch:u:${model}:${tenantId}:${userId}`;
+    }
+    static horizonKey(model) {
+        return `horizon:${model}`;
+    }
+    async epochs(keys) {
+        const result = new Map(keys.map((key) => [key, 0]));
+        if (!keys.length) {
+            return result;
+        }
+        for (const row of await this.store.find({ key: { $in: [...keys] } }, { select: ['epoch', 'key'] })) {
+            result.set(row.key, typeof row.epoch === 'number' ? row.epoch : 0);
+        }
+        return result;
+    }
+    async bump(key) {
+        if (await this.store.updateOne({ key }, { $inc: { epoch: 1 } })) {
+            return;
+        }
+        try {
+            await this.store.insert({ epoch: 1, key });
+        }
+        catch (error) {
+            if (!isDuplicateKey(error)) {
+                throw error;
+            }
+            await this.store.updateOne({ key }, { $inc: { epoch: 1 } });
+        }
+    }
+    async horizon(model) {
+        const row = await this.store.findOne({ key: CoreSyncStateStore.horizonKey(model) });
+        return row?.horizon ? new Date(row.horizon) : undefined;
+    }
+    async advanceHorizon(model, at) {
+        const key = CoreSyncStateStore.horizonKey(model);
+        const behind = { $or: [{ horizon: null }, { horizon: { $lt: at } }], key };
+        if (await this.store.updateOne(behind, { $set: { horizon: at } })) {
+            return;
+        }
+        if (await this.store.findOne({ key })) {
+            return;
+        }
+        try {
+            await this.store.insert({ horizon: at, key });
+        }
+        catch (error) {
+            if (!isDuplicateKey(error)) {
+                throw error;
+            }
+            await this.store.updateOne(behind, { $set: { horizon: at } });
+        }
+    }
+}
+//# sourceMappingURL=core-sync-state.store.js.map

package/dist/core/modules/sync/core-sync-state.store.js.map

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

package/dist/core/modules/sync/core-sync.constants.d.ts

@@ -0,0 +1,28 @@
+export declare const SYNC_MUTATION_MODEL = "SyncMutation";
+export declare const SYNC_STATE_MODEL = "SyncState";
+export declare const SYNC_SERVICE_METADATA = "lt:sync:service";
+export declare const SYNC_FIELD_METADATA = "lt:sync:fields";
+export declare const SYNC_CLAIM_TIMEOUT_MS = 30000;
+export declare const SYNC_REAPPLY_ATTEMPTS = 3;
+export declare const SYNC_DEFAULTS: Readonly<{
+    hintDebounceMs: 250;
+    maxBytes: 1048576;
+    maxItems: 100;
+    maxLimit: 1000;
+    mutationsDays: 30;
+    path: "sync";
+    pullLimit: 200;
+    rateLimitPull: {
+        max: number;
+        windowSeconds: number;
+    };
+    rateLimitPush: {
+        max: number;
+        windowSeconds: number;
+    };
+    tombstonesDays: 90;
+}>;
+export declare const SYNC_PURGE_BATCH = 1000;
+export declare const SYNC_PURGE_INTERVAL_MS: number;
+export declare const SYNC_HINT_KEEPALIVE_MS = 25000;
+export declare const SYNC_PULL_LIMIT_CEILING = 1000;

package/dist/core/modules/sync/core-sync.constants.js

@@ -0,0 +1,23 @@
+export const SYNC_MUTATION_MODEL = 'SyncMutation';
+export const SYNC_STATE_MODEL = 'SyncState';
+export const SYNC_SERVICE_METADATA = 'lt:sync:service';
+export const SYNC_FIELD_METADATA = 'lt:sync:fields';
+export const SYNC_CLAIM_TIMEOUT_MS = 30_000;
+export const SYNC_REAPPLY_ATTEMPTS = 3;
+export const SYNC_DEFAULTS = Object.freeze({
+    hintDebounceMs: 250,
+    maxBytes: 1_048_576,
+    maxItems: 100,
+    maxLimit: 1000,
+    mutationsDays: 30,
+    path: 'sync',
+    pullLimit: 200,
+    rateLimitPull: { max: 120, windowSeconds: 60 },
+    rateLimitPush: { max: 60, windowSeconds: 60 },
+    tombstonesDays: 90,
+});
+export const SYNC_PURGE_BATCH = 1000;
+export const SYNC_PURGE_INTERVAL_MS = 60 * 60_000;
+export const SYNC_HINT_KEEPALIVE_MS = 25_000;
+export const SYNC_PULL_LIMIT_CEILING = 1000;
+//# sourceMappingURL=core-sync.constants.js.map

package/dist/core/modules/sync/core-sync.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-sync.constants.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync.constants.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAGlD,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAG5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAGvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAMpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAG5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAGvC,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,cAAc,EAAE,GAAG;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,IAAI;IACd,aAAa,EAAE,EAAE;IACjB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,GAAG;IACd,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE;IAC9C,aAAa,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE;IAC7C,cAAc,EAAE,EAAE;CACnB,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,GAAG,MAAM,CAAC;AAGlD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAG7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC"}

package/dist/core/modules/sync/core-sync.controller.d.ts

@@ -0,0 +1,8 @@
+import { CoreSyncBaseController } from './core-sync-base.controller.js';
+import type { ISyncPullResult, ISyncPushResult } from './interfaces/core-sync.interfaces.js';
+export declare class CoreSyncController extends CoreSyncBaseController {
+    pull(model: string, cursor: string, limit: string, currentUser: any, req: any, res: any): Promise<ISyncPullResult | object>;
+    push(model: string, body: any, currentUser: any, req: any, res: any): Promise<{
+        results: ISyncPushResult[];
+    }>;
+}

package/dist/core/modules/sync/core-sync.controller.js

@@ -0,0 +1,79 @@
+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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Body, Controller, Get, HttpCode, HttpStatus, Param, Post, Query, Req, Res } from '@nestjs/common';
+import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger';
+import { CurrentUser } from '../../common/decorators/current-user.decorator.js';
+import { Roles } from '../../common/decorators/roles.decorator.js';
+import { RoleEnum } from '../../common/enums/role.enum.js';
+import { CoreSyncBaseController } from './core-sync-base.controller.js';
+import { SYNC_DEFAULTS } from './core-sync.constants.js';
+import { SyncResyncRequiredException } from './core-sync.service.js';
+let CoreSyncController = class CoreSyncController extends CoreSyncBaseController {
+    async pull(model, cursor, limit, currentUser, req, res) {
+        await this.limit('pull', currentUser, res);
+        await this.scopeTenants(req, currentUser);
+        try {
+            return await this.syncService.pull(model, { cursor, limit }, currentUser);
+        }
+        catch (error) {
+            if (error instanceof SyncResyncRequiredException) {
+                res?.status?.(error.getStatus());
+                return error.getResponse();
+            }
+            throw error;
+        }
+    }
+    async push(model, body, currentUser, req, res) {
+        this.syncService.assertPushRequest(req);
+        await this.limit('push', currentUser, res);
+        await this.scopeTenants(req, currentUser);
+        return this.syncService.push(model, body, currentUser);
+    }
+};
+__decorate([
+    ApiBearerAuth(),
+    ApiOperation({ description: 'One page of changes after the cursor (protocol §5)', summary: 'Pull changes' }),
+    Get(':model'),
+    Roles(RoleEnum.S_USER),
+    __param(0, Param('model')),
+    __param(1, Query('cursor')),
+    __param(2, Query('limit')),
+    __param(3, CurrentUser()),
+    __param(4, Req()),
+    __param(5, Res({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], CoreSyncController.prototype, "pull", null);
+__decorate([
+    ApiBearerAuth(),
+    ApiOperation({ description: 'Apply pushed changes item by item (protocol §6)', summary: 'Push changes' }),
+    HttpCode(HttpStatus.OK),
+    Post(':model'),
+    Roles(RoleEnum.S_USER),
+    __param(0, Param('model')),
+    __param(1, Body()),
+    __param(2, CurrentUser()),
+    __param(3, Req()),
+    __param(4, Res({ passthrough: true })),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], CoreSyncController.prototype, "push", null);
+CoreSyncController = __decorate([
+    ApiTags('sync'),
+    Controller(SYNC_DEFAULTS.path),
+    Roles(RoleEnum.S_USER)
+], CoreSyncController);
+export { CoreSyncController };
+//# sourceMappingURL=core-sync.controller.js.map

package/dist/core/modules/sync/core-sync.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-sync.controller.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC3G,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,MAAM,4CAA4C,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAe9D,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,sBAAsB;IAKtD,AAAN,KAAK,CAAC,IAAI,CACQ,KAAa,EACZ,MAAc,EACf,KAAa,EACd,WAAgB,EACxB,GAAQ,EACa,GAAQ;QAEpC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,2BAA2B,EAAE,CAAC;gBAEjD,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;gBACjC,OAAO,KAAK,CAAC,WAAW,EAAY,CAAC;YACvC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAOK,AAAN,KAAK,CAAC,IAAI,CACQ,KAAa,EACrB,IAAS,EACF,WAAgB,EACxB,GAAQ,EACa,GAAQ;QAEpC,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AAvCO;IAJL,aAAa,EAAE;IACf,YAAY,CAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC5G,GAAG,CAAC,QAAQ,CAAC;IACb,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;IAEpB,WAAA,KAAK,CAAC,OAAO,CAAC,CAAA;IACd,WAAA,KAAK,CAAC,QAAQ,CAAC,CAAA;IACf,WAAA,KAAK,CAAC,OAAO,CAAC,CAAA;IACd,WAAA,WAAW,EAAE,CAAA;IACb,WAAA,GAAG,EAAE,CAAA;IACL,WAAA,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;;;;8CAc5B;AAOK;IALL,aAAa,EAAE;IACf,YAAY,CAAC,EAAE,WAAW,EAAE,iDAAiD,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACzG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;IACvB,IAAI,CAAC,QAAQ,CAAC;IACd,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;IAEpB,WAAA,KAAK,CAAC,OAAO,CAAC,CAAA;IACd,WAAA,IAAI,EAAE,CAAA;IACN,WAAA,WAAW,EAAE,CAAA;IACb,WAAA,GAAG,EAAE,CAAA;IACL,WAAA,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;;;;8CAM5B;AA3CU,kBAAkB;IAH9B,OAAO,CAAC,MAAM,CAAC;IACf,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC;IAC9B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;GACV,kBAAkB,CA4C9B"}

package/dist/core/modules/sync/core-sync.decorators.d.ts

@@ -0,0 +1,12 @@
+import type { Type } from '@nestjs/common';
+export interface SyncServiceOptions {
+    createInput: Type<any>;
+    model: Type<any>;
+    modelName?: string;
+    updateInput: Type<any>;
+}
+export declare function SyncService(options: SyncServiceOptions): ClassDecorator;
+export declare function getSyncServiceOptions(target: Function): SyncServiceOptions | undefined;
+export type SyncFieldStrategy = 'lww' | 'reject';
+export declare function SyncField(strategy: SyncFieldStrategy): PropertyDecorator;
+export declare function getSyncFieldStrategies(modelClass: Function): Record<string, SyncFieldStrategy>;

package/dist/core/modules/sync/core-sync.decorators.js

@@ -0,0 +1,28 @@
+import { SYNC_FIELD_METADATA, SYNC_SERVICE_METADATA } from './core-sync.constants.js';
+export function SyncService(options) {
+    return (target) => {
+        Reflect.defineMetadata(SYNC_SERVICE_METADATA, { ...options }, target);
+    };
+}
+export function getSyncServiceOptions(target) {
+    return Reflect.getMetadata(SYNC_SERVICE_METADATA, target);
+}
+export function SyncField(strategy) {
+    if (strategy !== 'lww' && strategy !== 'reject') {
+        throw new Error(`@SyncField: strategy must be 'lww' or 'reject', got ${JSON.stringify(strategy)}`);
+    }
+    return (target, property) => {
+        const own = Reflect.hasOwnMetadata(SYNC_FIELD_METADATA, target.constructor)
+            ? Reflect.getOwnMetadata(SYNC_FIELD_METADATA, target.constructor)
+            : {};
+        Reflect.defineMetadata(SYNC_FIELD_METADATA, { ...own, [String(property)]: strategy }, target.constructor);
+    };
+}
+export function getSyncFieldStrategies(modelClass) {
+    const chain = [];
+    for (let current = modelClass; current && current !== Function.prototype; current = Object.getPrototypeOf(current)) {
+        chain.unshift(current);
+    }
+    return Object.assign({}, ...chain.map((current) => Reflect.hasOwnMetadata(SYNC_FIELD_METADATA, current) ? Reflect.getOwnMetadata(SYNC_FIELD_METADATA, current) : {}));
+}
+//# sourceMappingURL=core-sync.decorators.js.map

package/dist/core/modules/sync/core-sync.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-sync.decorators.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync.decorators.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA8BtF,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,qBAAqB,CAAC,MAAgB;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAkBD,MAAM,UAAU,SAAS,CAAC,QAA2B;IACnD,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,uDAAuD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QAC1B,MAAM,GAAG,GAAsC,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,MAAM,CAAC,WAAW,CAAC;YAC5G,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,MAAM,CAAC,WAAW,CAAC;YACjE,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5G,CAAC,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,sBAAsB,CAAC,UAAoB;IACzD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,IAAI,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,OAAO,KAAK,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACnH,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAClB,EAAE,EACF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CACjH,CACF,CAAC;AACJ,CAAC"}

package/dist/core/modules/sync/core-sync.module.d.ts

@@ -0,0 +1,16 @@
+import { DynamicModule, Type } from '@nestjs/common';
+import { CoreSyncController } from './core-sync.controller.js';
+import { CoreSyncHintsController } from './core-sync-hints.controller.js';
+import { CoreSyncResolver } from './core-sync.resolver.js';
+import { CoreSyncService } from './core-sync.service.js';
+export interface CoreSyncModuleOptions {
+    controller?: Type<CoreSyncController>;
+    graphQlHints?: boolean;
+    hintsController?: Type<CoreSyncHintsController>;
+    path?: string;
+    resolver?: Type<CoreSyncResolver>;
+    service?: Type<CoreSyncService>;
+}
+export declare class CoreSyncModule {
+    static forRoot(options?: CoreSyncModuleOptions): DynamicModule;
+}