@lenne.tech/nest-server 12.1.1 → 12.2.0

package/dist/core/modules/migrate/sql-migration.helper.js

@@ -1,6 +1,10 @@
 import { withMysqlSchemaLock } from '../../common/persistence/sql/mysql/mysql-schema.migrator.js';
+import { MYSQL_SYNC_COUNTERS } from '../../common/persistence/sql/mysql/mysql-schema.compiler.js';
+import { syncSequenceName } from '../../common/persistence/sql/postgres/postgres-schema.compiler.js';
 import { SCHEMA_LOCK_SQL } from '../../common/persistence/sql/postgres/postgres-schema.migrator.js';
 import { createSqlExecutor } from '../../common/persistence/sql/sql-executor.factory.js';
+import { quoteIdentifier, quoteMysqlIdentifier } from '../../common/persistence/sql/sql-naming.js';
+const SYNC_UPDATE_CHUNK = 500;
 export async function runSqlMigration(ownerUrl, statements, options = {}) {
     if (!ownerUrl) {
         throw new Error('runSqlMigration() needs the connection URL of the table owner (database.ownerUrl)');
@@ -14,16 +18,21 @@ export async function runSqlMigration(ownerUrl, statements, options = {}) {
     try {
         if (/^(mysql|mariadb):/i.test(ownerUrl)) {
             await withMysqlSchemaLock(executor, async (run) => {
-                for (const text of statements) {
-                    await run({ params: [], text });
+                for (const statement of statements) {
+                    await (typeof statement === 'string'
+                        ? run({ params: [], text: statement })
+                        : applySqlSyncUpdate(run, 'mysql', statement.syncUpdate));
                 }
             });
             return;
         }
         await executor.transaction(async (tx) => {
-            await tx.run({ params: [], text: SCHEMA_LOCK_SQL }, { kind: 'system' });
-            for (const text of statements) {
-                await tx.run({ params: [], text }, { kind: 'system' });
+            const run = (statement) => tx.run(statement, { kind: 'system' });
+            await run({ params: [], text: SCHEMA_LOCK_SQL });
+            for (const statement of statements) {
+                await (typeof statement === 'string'
+                    ? run({ params: [], text: statement })
+                    : applySqlSyncUpdate(run, 'postgres', statement.syncUpdate));
             }
         });
     }
@@ -31,4 +40,80 @@ export async function runSqlMigration(ownerUrl, statements, options = {}) {
         await executor.close();
     }
 }
+export async function applySqlSyncUpdate(run, dialect, update) {
+    if (dialect === 'postgres') {
+        return writeSyncUpdate(run, dialect, update);
+    }
+    await run({ params: [], text: 'START TRANSACTION' });
+    try {
+        const written = await writeSyncUpdate(run, dialect, update);
+        await run({ params: [], text: 'COMMIT' });
+        return written;
+    }
+    catch (error) {
+        await run({ params: [], text: 'ROLLBACK' }).catch(() => undefined);
+        throw error;
+    }
+}
+async function writeSyncUpdate(run, dialect, update) {
+    const quote = dialect === 'mysql' ? quoteMysqlIdentifier : quoteIdentifier;
+    const table = quote(update.table);
+    const id = quote('id');
+    const { rows } = await run({
+        params: [],
+        text: `SELECT ${id} AS id FROM ${table} WHERE ${update.where} ORDER BY ${id} FOR UPDATE`,
+    });
+    const ids = rows.map((row) => String(row.id));
+    if (!ids.length) {
+        return 0;
+    }
+    const numbers = dialect === 'mysql'
+        ? await mysqlNumbers(run, update.table, ids.length)
+        : await postgresNumbers(run, update.table, ids.length);
+    const bigint = dialect === 'mysql' ? '' : '::bigint';
+    for (let start = 0; start < ids.length; start += SYNC_UPDATE_CHUNK) {
+        const chunk = ids.slice(start, start + SYNC_UPDATE_CHUNK);
+        const params = [];
+        const param = (value) => {
+            params.push(value);
+            return `$${params.length}`;
+        };
+        const cases = chunk
+            .map((row, index) => `WHEN ${param(row)} THEN ${param(numbers[start + index])}${bigint}`)
+            .join(' ');
+        const list = chunk.map((row) => param(row)).join(', ');
+        await run({
+            params,
+            text: `UPDATE ${table} SET ${update.set}, ${quote('version')} = ${quote('version')} + 1, ` +
+                `${quote('sync_seq')} = CASE ${id} ${cases} END WHERE ${id} IN (${list})`,
+        });
+    }
+    return ids.length;
+}
+async function postgresNumbers(run, table, count) {
+    await run({
+        params: [table],
+        text: `SELECT pg_advisory_xact_lock(hashtext('lenne.tech:sync:' || current_schema() || '.' || $1))`,
+    });
+    const { rows } = await run({
+        params: [syncSequenceName(table), count],
+        text: `SELECT nextval(format('%I.%I', current_schema(), $1::text)::regclass)::text AS n FROM generate_series(1, $2::int)`,
+    });
+    return rows.map((row) => String(row.n)).sort((a, b) => (BigInt(a) < BigInt(b) ? -1 : 1));
+}
+async function mysqlNumbers(run, table, count) {
+    await run({
+        params: [count, table],
+        text: `UPDATE ${quoteMysqlIdentifier(MYSQL_SYNC_COUNTERS)} SET \`seq\` = \`seq\` + $1 WHERE \`model\` = $2`,
+    });
+    const { rows } = await run({
+        params: [table],
+        text: `SELECT \`seq\` FROM ${quoteMysqlIdentifier(MYSQL_SYNC_COUNTERS)} WHERE \`model\` = $1`,
+    });
+    if (!rows.length) {
+        throw new Error(`runSqlMigration(): ${table} is not the table of a synchronized model (no change counter)`);
+    }
+    const last = BigInt(rows[0].seq);
+    return Array.from({ length: count }, (_, index) => (last - BigInt(count - 1 - index)).toString());
+}
 //# sourceMappingURL=sql-migration.helper.js.map

package/dist/core/modules/migrate/sql-migration.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"sql-migration.helper.js","sourceRoot":"","sources":["../../../../src/core/modules/migrate/sql-migration.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,mEAAmE,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,sDAAsD,CAAC;AAYzF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,UAA6B,EAC7B,UAA0C,EAAE;IAE5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC;QACvC,eAAe,EAAE,uBAAuB;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;QACnC,cAAc,EAAE,CAAC;QACjB,GAAG,EAAE,QAAQ;KACd,CAAC,CAAC;IACH,IAAI,CAAC;QACH,IAAI,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBAChD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;oBAC9B,MAAM,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YACtC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}
+{"version":3,"file":"sql-migration.helper.js","sourceRoot":"","sources":["../../../../src/core/modules/migrate/sql-migration.helper.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,7 @@
+import { CoreSyncService } from './core-sync.service.js';
+export declare abstract class CoreSyncBaseController {
+    protected readonly syncService: CoreSyncService;
+    constructor(syncService: CoreSyncService);
+    protected scopeTenants(req: any, currentUser: any): Promise<void>;
+    protected limit(kind: 'pull' | 'push', currentUser: any, res: any): Promise<void>;
+}

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

@@ -0,0 +1,44 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { HttpException, HttpStatus, Injectable } from '@nestjs/common';
+import { getTenantContextResolver } from '../../common/services/core-tenant-context.registry.js';
+import { ErrorCode } from '../error-code/error-codes.js';
+import { CoreSyncService } from './core-sync.service.js';
+let CoreSyncBaseController = class CoreSyncBaseController {
+    syncService;
+    constructor(syncService) {
+        this.syncService = syncService;
+    }
+    async scopeTenants(req, currentUser) {
+        if (!req || !currentUser?.id || req.tenantId || req.tenantIds || req.isAdminBypass) {
+            return;
+        }
+        const resolved = await getTenantContextResolver()?.resolve(currentUser, undefined);
+        if (resolved?.isAdminBypass) {
+            req.isAdminBypass = true;
+        }
+        else if (resolved?.tenantIds) {
+            req.tenantIds = resolved.tenantIds;
+        }
+    }
+    async limit(kind, currentUser, res) {
+        const retryAfter = await this.syncService.rateLimit(kind, currentUser);
+        if (retryAfter !== undefined) {
+            res?.setHeader?.('Retry-After', String(retryAfter));
+            throw new HttpException(ErrorCode.RATE_LIMIT_EXCEEDED, HttpStatus.TOO_MANY_REQUESTS);
+        }
+    }
+};
+CoreSyncBaseController = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [CoreSyncService])
+], CoreSyncBaseController);
+export { CoreSyncBaseController };
+//# sourceMappingURL=core-sync-base.controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-sync-base.controller.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync-base.controller.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AACjG,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AASlD,IAAe,sBAAsB,GAArC,MAAe,sBAAsB;IACX;IAA/B,YAA+B,WAA4B;QAA5B,gBAAW,GAAX,WAAW,CAAiB;IAAG,CAAC;IAQrD,KAAK,CAAC,YAAY,CAAC,GAAQ,EAAE,WAAgB;QACrD,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACnF,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,wBAAwB,EAAE,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACnF,IAAI,QAAQ,EAAE,aAAa,EAAE,CAAC;YAC5B,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC;QAC3B,CAAC;aAAM,IAAI,QAAQ,EAAE,SAAS,EAAE,CAAC;YAC/B,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACrC,CAAC;IACH,CAAC;IAGS,KAAK,CAAC,KAAK,CAAC,IAAqB,EAAE,WAAgB,EAAE,GAAQ;QACrE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACvE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,GAAG,EAAE,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACpD,MAAM,IAAI,aAAa,CAAC,SAAS,CAAC,mBAAmB,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;CACF,CAAA;AA7BqB,sBAAsB;IAD3C,UAAU,EAAE;qCAEiC,eAAe;GADvC,sBAAsB,CA6B3C"}

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

@@ -0,0 +1,19 @@
+export type SyncCursorPosition = {
+    seq: number;
+} | {
+    at: number;
+    id: string;
+};
+export interface SyncCursorState {
+    epochs: string;
+    fingerprint: string;
+    model: string;
+    position: SyncCursorPosition;
+    runStart?: number;
+    since: number;
+    user: string;
+}
+export declare function deriveCursorKey(secret: string): Buffer;
+export declare function encodeSyncCursor(state: SyncCursorState, key: Buffer): string;
+export declare function decodeSyncCursor(cursor: unknown, key: Buffer): SyncCursorState | undefined;
+export declare function stableHash(value: unknown): string;

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

@@ -0,0 +1,77 @@
+import { createHash, createHmac, hkdfSync, timingSafeEqual } from 'node:crypto';
+const MAX_CURSOR_LENGTH = 2048;
+export function deriveCursorKey(secret) {
+    return Buffer.from(hkdfSync('sha256', secret, 'lenne.tech', 'nest-server:sync-cursor:v1', 32));
+}
+export function encodeSyncCursor(state, key) {
+    const payload = Buffer.from(JSON.stringify({
+        e: state.epochs,
+        f: state.fingerprint,
+        k: state.since,
+        m: state.model,
+        p: 'seq' in state.position ? { s: state.position.seq } : { a: state.position.at, i: state.position.id },
+        ...(state.runStart === undefined ? {} : { r: state.runStart }),
+        u: state.user,
+        v: 1,
+    })).toString('base64url');
+    return `${payload}.${sign(payload, key)}`;
+}
+export function decodeSyncCursor(cursor, key) {
+    if (typeof cursor !== 'string' || !cursor || cursor.length > MAX_CURSOR_LENGTH) {
+        return undefined;
+    }
+    const [payload, signature, rest] = cursor.split('.');
+    if (!payload || !signature || rest !== undefined) {
+        return undefined;
+    }
+    const expected = Buffer.from(sign(payload, key));
+    const given = Buffer.from(signature);
+    if (expected.length !== given.length || !timingSafeEqual(expected, given)) {
+        return undefined;
+    }
+    let raw;
+    try {
+        raw = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (!raw ||
+        raw.v !== 1 ||
+        typeof raw.m !== 'string' ||
+        typeof raw.u !== 'string' ||
+        typeof raw.f !== 'string' ||
+        typeof raw.e !== 'string' ||
+        !Number.isFinite(raw.k) ||
+        (raw.r !== undefined && !Number.isFinite(raw.r)) ||
+        !raw.p ||
+        typeof raw.p !== 'object') {
+        return undefined;
+    }
+    let position;
+    if (Number.isFinite(raw.p.s)) {
+        position = { seq: raw.p.s };
+    }
+    else if (Number.isFinite(raw.p.a) && typeof raw.p.i === 'string') {
+        position = { at: raw.p.a, id: raw.p.i };
+    }
+    else {
+        return undefined;
+    }
+    return {
+        epochs: raw.e,
+        fingerprint: raw.f,
+        model: raw.m,
+        position,
+        ...(raw.r === undefined ? {} : { runStart: raw.r }),
+        since: raw.k,
+        user: raw.u,
+    };
+}
+export function stableHash(value) {
+    return createHash('sha256').update(JSON.stringify(value)).digest('base64url').slice(0, 32);
+}
+function sign(payload, key) {
+    return createHmac('sha256', key).update(payload).digest('base64url');
+}
+//# sourceMappingURL=core-sync-cursor.js.map

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

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

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

@@ -0,0 +1,4 @@
+import { CoreSyncBaseController } from './core-sync-base.controller.js';
+export declare class CoreSyncHintsController extends CoreSyncBaseController {
+    hints(models: string, currentUser: any, req: any, res: any): Promise<void>;
+}

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

@@ -0,0 +1,55 @@
+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 { Controller, Get, NotFoundException, 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 { ErrorCode } from '../error-code/error-codes.js';
+import { CoreSyncBaseController } from './core-sync-base.controller.js';
+import { SYNC_DEFAULTS } from './core-sync.constants.js';
+let CoreSyncHintsController = class CoreSyncHintsController extends CoreSyncBaseController {
+    async hints(models, currentUser, req, res) {
+        if (!this.syncService.hintsEnabled('sse')) {
+            throw new NotFoundException(ErrorCode.SYNC_MODEL_NOT_FOUND);
+        }
+        await this.limit('pull', currentUser, res);
+        await this.scopeTenants(req, currentUser);
+        const named = typeof models === 'string' ? models.split(',').map((model) => model.trim()) : [];
+        await this.syncService.openHintStream(req, res, currentUser, named.filter(Boolean));
+    }
+};
+__decorate([
+    ApiBearerAuth(),
+    ApiOperation({
+        description: 'Server-sent events: `event: change` with `{ model, at }` whenever a model the caller may pull changes; ' +
+            '`models` (comma-separated) narrows the stream',
+        summary: 'Change hints (SSE)',
+    }),
+    Get('hints'),
+    Roles(RoleEnum.S_USER),
+    __param(0, Query('models')),
+    __param(1, CurrentUser()),
+    __param(2, Req()),
+    __param(3, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], CoreSyncHintsController.prototype, "hints", null);
+CoreSyncHintsController = __decorate([
+    ApiTags('sync'),
+    Controller(SYNC_DEFAULTS.path),
+    Roles(RoleEnum.S_USER)
+], CoreSyncHintsController);
+export { CoreSyncHintsController };
+//# sourceMappingURL=core-sync-hints.controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-sync-hints.controller.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync-hints.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrF,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,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAgBlD,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,sBAAsB;IAW3D,AAAN,KAAK,CAAC,KAAK,CACQ,MAAc,EAChB,WAAgB,EACxB,GAAQ,EACR,GAAQ;QAEf,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAE3C,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,CAAC;CACF,CAAA;AAhBO;IATL,aAAa,EAAE;IACf,YAAY,CAAC;QACZ,WAAW,EACT,yGAAyG;YACzG,+CAA+C;QACjD,OAAO,EAAE,oBAAoB;KAC9B,CAAC;IACD,GAAG,CAAC,OAAO,CAAC;IACZ,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;IAEpB,WAAA,KAAK,CAAC,QAAQ,CAAC,CAAA;IACf,WAAA,WAAW,EAAE,CAAA;IACb,WAAA,GAAG,EAAE,CAAA;IACL,WAAA,GAAG,EAAE,CAAA;;;;oDAWP;AA1BU,uBAAuB;IAHnC,OAAO,CAAC,MAAM,CAAC;IACf,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC;IAC9B,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;GACV,uBAAuB,CA2BnC"}

package/dist/core/modules/sync/core-sync-hints.service.d.ts

@@ -0,0 +1,28 @@
+import { Logger, OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import type { ISync } from '../../common/interfaces/server-options.interface.js';
+import { CoreRedisService } from '../../common/services/core-redis.service.js';
+export interface SyncHintEvent {
+    at: number;
+    model: string;
+    tenantId?: string;
+}
+export declare class CoreSyncHintService implements OnApplicationBootstrap, OnModuleDestroy {
+    protected readonly redisService?: CoreRedisService;
+    protected readonly logger: Logger;
+    protected readonly origin: `${string}-${string}-${string}-${string}-${string}`;
+    protected readonly subscribers: Set<(hint: SyncHintEvent) => void>;
+    protected readonly pending: Map<string, NodeJS.Timeout>;
+    protected channel?: string;
+    protected redisListener?: (channel: string, message: string) => void;
+    constructor(redisService?: CoreRedisService);
+    protected get config(): Exclude<ISync['hints'], boolean | undefined>;
+    get enabled(): boolean;
+    protected get debounceMs(): number;
+    onApplicationBootstrap(): Promise<void>;
+    onModuleDestroy(): void;
+    notify(model: string, tenantIds?: readonly (string | undefined)[]): void;
+    subscribe(handler: (hint: SyncHintEvent) => void): () => void;
+    protected send(hint: SyncHintEvent): void;
+    protected receive(message: string): void;
+    protected deliver(hint: SyncHintEvent): void;
+}

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 {};