@lenne.tech/nest-server 12.1.1 → 12.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. package/.claude/rules/architecture.md +1 -0
  2. package/.claude/rules/configurable-features.md +1 -0
  3. package/.claude/rules/package-management.md +16 -1
  4. package/.claude/rules/persistence.md +26 -0
  5. package/.claude/rules/testing.md +79 -14
  6. package/CLAUDE.md +2 -1
  7. package/FRAMEWORK-API.md +17 -2
  8. package/README.md +18 -0
  9. package/dist/core/common/interfaces/server-options.interface.d.ts +41 -0
  10. package/dist/core/common/interfaces/service-options.interface.d.ts +3 -0
  11. package/dist/core/common/persistence/core-persistence.module.js +12 -2
  12. package/dist/core/common/persistence/core-persistence.module.js.map +1 -1
  13. package/dist/core/common/persistence/data-source.runtime.js +4 -2
  14. package/dist/core/common/persistence/data-source.runtime.js.map +1 -1
  15. package/dist/core/common/persistence/data-store.interface.d.ts +24 -9
  16. package/dist/core/common/persistence/id-format.d.ts +2 -0
  17. package/dist/core/common/persistence/id-format.js +14 -0
  18. package/dist/core/common/persistence/id-format.js.map +1 -1
  19. package/dist/core/common/persistence/model-descriptor.interface.d.ts +6 -0
  20. package/dist/core/common/persistence/model-metadata.registry.d.ts +2 -1
  21. package/dist/core/common/persistence/model-metadata.registry.js +20 -2
  22. package/dist/core/common/persistence/model-metadata.registry.js.map +1 -1
  23. package/dist/core/common/persistence/mongo/sync-schema.plugin.d.ts +18 -0
  24. package/dist/core/common/persistence/mongo/sync-schema.plugin.js +368 -0
  25. package/dist/core/common/persistence/mongo/sync-schema.plugin.js.map +1 -0
  26. package/dist/core/common/persistence/mongoose-data-store.d.ts +19 -9
  27. package/dist/core/common/persistence/mongoose-data-store.js +107 -31
  28. package/dist/core/common/persistence/mongoose-data-store.js.map +1 -1
  29. package/dist/core/common/persistence/persisted-model.decorator.d.ts +3 -0
  30. package/dist/core/common/persistence/persisted-model.decorator.js +9 -0
  31. package/dist/core/common/persistence/persisted-model.decorator.js.map +1 -1
  32. package/dist/core/common/persistence/policies/sync.policy.d.ts +17 -0
  33. package/dist/core/common/persistence/policies/sync.policy.js +77 -0
  34. package/dist/core/common/persistence/policies/sync.policy.js.map +1 -0
  35. package/dist/core/common/persistence/sql/mysql/mysql-data-store.d.ts +12 -8
  36. package/dist/core/common/persistence/sql/mysql/mysql-data-store.js +82 -29
  37. package/dist/core/common/persistence/sql/mysql/mysql-data-store.js.map +1 -1
  38. package/dist/core/common/persistence/sql/mysql/mysql-schema.compiler.d.ts +10 -0
  39. package/dist/core/common/persistence/sql/mysql/mysql-schema.compiler.js +61 -4
  40. package/dist/core/common/persistence/sql/mysql/mysql-schema.compiler.js.map +1 -1
  41. package/dist/core/common/persistence/sql/mysql/mysql-schema.migrator.js +101 -4
  42. package/dist/core/common/persistence/sql/mysql/mysql-schema.migrator.js.map +1 -1
  43. package/dist/core/common/persistence/sql/postgres/postgres-schema.compiler.d.ts +10 -0
  44. package/dist/core/common/persistence/sql/postgres/postgres-schema.compiler.js +41 -2
  45. package/dist/core/common/persistence/sql/postgres/postgres-schema.compiler.js.map +1 -1
  46. package/dist/core/common/persistence/sql/postgres/postgres-schema.migrator.js +98 -10
  47. package/dist/core/common/persistence/sql/postgres/postgres-schema.migrator.js.map +1 -1
  48. package/dist/core/common/persistence/sql/sql-data-store.d.ts +38 -14
  49. package/dist/core/common/persistence/sql/sql-data-store.js +212 -38
  50. package/dist/core/common/persistence/sql/sql-data-store.js.map +1 -1
  51. package/dist/core/common/persistence/sql/sql-errors.d.ts +2 -1
  52. package/dist/core/common/persistence/sql/sql-errors.js +3 -1
  53. package/dist/core/common/persistence/sql/sql-errors.js.map +1 -1
  54. package/dist/core/common/persistence/sync-access.registry.d.ts +17 -0
  55. package/dist/core/common/persistence/sync-access.registry.js +8 -0
  56. package/dist/core/common/persistence/sync-access.registry.js.map +1 -0
  57. package/dist/core/common/persistence/sync-model.d.ts +29 -0
  58. package/dist/core/common/persistence/sync-model.js +138 -0
  59. package/dist/core/common/persistence/sync-model.js.map +1 -0
  60. package/dist/core/common/services/crud.service.d.ts +13 -1
  61. package/dist/core/common/services/crud.service.js +174 -16
  62. package/dist/core/common/services/crud.service.js.map +1 -1
  63. package/dist/core/modules/error-code/error-codes.d.ts +54 -0
  64. package/dist/core/modules/error-code/error-codes.js +48 -0
  65. package/dist/core/modules/error-code/error-codes.js.map +1 -1
  66. package/dist/core/modules/migrate/sql-migration.helper.d.ts +15 -1
  67. package/dist/core/modules/migrate/sql-migration.helper.js +90 -5
  68. package/dist/core/modules/migrate/sql-migration.helper.js.map +1 -1
  69. package/dist/core/modules/sync/core-sync-base.controller.d.ts +7 -0
  70. package/dist/core/modules/sync/core-sync-base.controller.js +44 -0
  71. package/dist/core/modules/sync/core-sync-base.controller.js.map +1 -0
  72. package/dist/core/modules/sync/core-sync-cursor.d.ts +19 -0
  73. package/dist/core/modules/sync/core-sync-cursor.js +77 -0
  74. package/dist/core/modules/sync/core-sync-cursor.js.map +1 -0
  75. package/dist/core/modules/sync/core-sync-hints.controller.d.ts +4 -0
  76. package/dist/core/modules/sync/core-sync-hints.controller.js +55 -0
  77. package/dist/core/modules/sync/core-sync-hints.controller.js.map +1 -0
  78. package/dist/core/modules/sync/core-sync-hints.service.d.ts +28 -0
  79. package/dist/core/modules/sync/core-sync-hints.service.js +155 -0
  80. package/dist/core/modules/sync/core-sync-hints.service.js.map +1 -0
  81. package/dist/core/modules/sync/core-sync-infrastructure.models.d.ts +2 -0
  82. package/dist/core/modules/sync/core-sync-infrastructure.models.js +17 -0
  83. package/dist/core/modules/sync/core-sync-infrastructure.models.js.map +1 -0
  84. package/dist/core/modules/sync/core-sync-mutation.store.d.ts +43 -0
  85. package/dist/core/modules/sync/core-sync-mutation.store.js +88 -0
  86. package/dist/core/modules/sync/core-sync-mutation.store.js.map +1 -0
  87. package/dist/core/modules/sync/core-sync-state.store.d.ts +18 -0
  88. package/dist/core/modules/sync/core-sync-state.store.js +64 -0
  89. package/dist/core/modules/sync/core-sync-state.store.js.map +1 -0
  90. package/dist/core/modules/sync/core-sync.constants.d.ts +28 -0
  91. package/dist/core/modules/sync/core-sync.constants.js +23 -0
  92. package/dist/core/modules/sync/core-sync.constants.js.map +1 -0
  93. package/dist/core/modules/sync/core-sync.controller.d.ts +8 -0
  94. package/dist/core/modules/sync/core-sync.controller.js +79 -0
  95. package/dist/core/modules/sync/core-sync.controller.js.map +1 -0
  96. package/dist/core/modules/sync/core-sync.decorators.d.ts +12 -0
  97. package/dist/core/modules/sync/core-sync.decorators.js +28 -0
  98. package/dist/core/modules/sync/core-sync.decorators.js.map +1 -0
  99. package/dist/core/modules/sync/core-sync.module.d.ts +16 -0
  100. package/dist/core/modules/sync/core-sync.module.js +50 -0
  101. package/dist/core/modules/sync/core-sync.module.js.map +1 -0
  102. package/dist/core/modules/sync/core-sync.resolver.d.ts +9 -0
  103. package/dist/core/modules/sync/core-sync.resolver.js +46 -0
  104. package/dist/core/modules/sync/core-sync.resolver.js.map +1 -0
  105. package/dist/core/modules/sync/core-sync.service.d.ts +142 -0
  106. package/dist/core/modules/sync/core-sync.service.js +1208 -0
  107. package/dist/core/modules/sync/core-sync.service.js.map +1 -0
  108. package/dist/core/modules/sync/interfaces/core-sync.interfaces.d.ts +56 -0
  109. package/dist/core/modules/sync/interfaces/core-sync.interfaces.js +2 -0
  110. package/dist/core/modules/sync/interfaces/core-sync.interfaces.js.map +1 -0
  111. package/dist/core/modules/sync/models/core-sync-hint.model.d.ts +4 -0
  112. package/dist/core/modules/sync/models/core-sync-hint.model.js +30 -0
  113. package/dist/core/modules/sync/models/core-sync-hint.model.js.map +1 -0
  114. package/dist/core/modules/tenant/core-tenant.guard.js +4 -0
  115. package/dist/core/modules/tenant/core-tenant.guard.js.map +1 -1
  116. package/dist/core.module.js +14 -0
  117. package/dist/core.module.js.map +1 -1
  118. package/dist/index.d.ts +16 -0
  119. package/dist/index.js +16 -0
  120. package/dist/index.js.map +1 -1
  121. package/dist/server/modules/error-code/error-codes.d.ts +6 -0
  122. package/dist/server/modules/sync-note/inputs/sync-note-create.input.d.ts +4 -0
  123. package/dist/server/modules/sync-note/inputs/sync-note-create.input.js +27 -0
  124. package/dist/server/modules/sync-note/inputs/sync-note-create.input.js.map +1 -0
  125. package/dist/server/modules/sync-note/inputs/sync-note.input.d.ts +6 -0
  126. package/dist/server/modules/sync-note/inputs/sync-note.input.js +37 -0
  127. package/dist/server/modules/sync-note/inputs/sync-note.input.js.map +1 -0
  128. package/dist/server/modules/sync-note/sync-note.model.d.ts +10 -0
  129. package/dist/server/modules/sync-note/sync-note.model.js +73 -0
  130. package/dist/server/modules/sync-note/sync-note.model.js.map +1 -0
  131. package/dist/server/modules/sync-note/sync-note.module.d.ts +2 -0
  132. package/dist/server/modules/sync-note/sync-note.module.js +21 -0
  133. package/dist/server/modules/sync-note/sync-note.module.js.map +1 -0
  134. package/dist/server/modules/sync-note/sync-note.service.d.ts +10 -0
  135. package/dist/server/modules/sync-note/sync-note.service.js +35 -0
  136. package/dist/server/modules/sync-note/sync-note.service.js.map +1 -0
  137. package/docs/REQUEST-LIFECYCLE.md +1 -0
  138. package/docs/offline-sync-protocol.md +96 -62
  139. package/docs/security-overrides.md +14 -0
  140. package/migration-guides/12.1.x-to-12.2.x.md +154 -0
  141. package/package.json +4 -2
  142. package/src/core/common/interfaces/server-options.interface.ts +149 -0
  143. package/src/core/common/interfaces/service-options.interface.ts +15 -0
  144. package/src/core/common/persistence/core-persistence.module.ts +21 -2
  145. package/src/core/common/persistence/data-source.runtime.ts +5 -2
  146. package/src/core/common/persistence/data-store.interface.ts +65 -12
  147. package/src/core/common/persistence/id-format.ts +26 -0
  148. package/src/core/common/persistence/model-descriptor.interface.ts +12 -0
  149. package/src/core/common/persistence/model-metadata.registry.ts +31 -2
  150. package/src/core/common/persistence/mongo/sync-schema.plugin.ts +508 -0
  151. package/src/core/common/persistence/mongoose-data-store.ts +171 -35
  152. package/src/core/common/persistence/persisted-model.decorator.ts +26 -0
  153. package/src/core/common/persistence/policies/sync.policy.ts +121 -0
  154. package/src/core/common/persistence/sql/mysql/mysql-data-store.ts +108 -30
  155. package/src/core/common/persistence/sql/mysql/mysql-schema.compiler.ts +107 -4
  156. package/src/core/common/persistence/sql/mysql/mysql-schema.migrator.ts +129 -3
  157. package/src/core/common/persistence/sql/postgres/postgres-schema.compiler.ts +74 -2
  158. package/src/core/common/persistence/sql/postgres/postgres-schema.migrator.ts +139 -7
  159. package/src/core/common/persistence/sql/sql-data-store.ts +325 -44
  160. package/src/core/common/persistence/sql/sql-errors.ts +5 -1
  161. package/src/core/common/persistence/sync-access.registry.ts +50 -0
  162. package/src/core/common/persistence/sync-model.ts +270 -0
  163. package/src/core/common/services/crud.service.ts +257 -19
  164. package/src/core/modules/error-code/error-codes.ts +59 -0
  165. package/src/core/modules/migrate/sql-migration.helper.ts +141 -7
  166. package/src/core/modules/sync/INTEGRATION-CHECKLIST.md +95 -0
  167. package/src/core/modules/sync/README.md +188 -0
  168. package/src/core/modules/sync/SECURITY.md +65 -0
  169. package/src/core/modules/sync/core-sync-base.controller.ts +43 -0
  170. package/src/core/modules/sync/core-sync-cursor.ts +117 -0
  171. package/src/core/modules/sync/core-sync-hints.controller.ts +52 -0
  172. package/src/core/modules/sync/core-sync-hints.service.ts +178 -0
  173. package/src/core/modules/sync/core-sync-infrastructure.models.ts +40 -0
  174. package/src/core/modules/sync/core-sync-mutation.store.ts +146 -0
  175. package/src/core/modules/sync/core-sync-state.store.ts +89 -0
  176. package/src/core/modules/sync/core-sync.constants.ts +51 -0
  177. package/src/core/modules/sync/core-sync.controller.ts +68 -0
  178. package/src/core/modules/sync/core-sync.decorators.ts +84 -0
  179. package/src/core/modules/sync/core-sync.module.ts +75 -0
  180. package/src/core/modules/sync/core-sync.resolver.ts +35 -0
  181. package/src/core/modules/sync/core-sync.service.ts +1728 -0
  182. package/src/core/modules/sync/interfaces/core-sync.interfaces.ts +85 -0
  183. package/src/core/modules/sync/models/core-sync-hint.model.ts +18 -0
  184. package/src/core/modules/tenant/core-tenant.guard.ts +8 -0
  185. package/src/core.module.ts +25 -0
  186. package/src/index.ts +21 -0
  187. package/src/server/modules/sync-note/inputs/sync-note-create.input.ts +14 -0
  188. package/src/server/modules/sync-note/inputs/sync-note.input.ts +23 -0
  189. package/src/server/modules/sync-note/sync-note.model.ts +77 -0
  190. package/src/server/modules/sync-note/sync-note.module.ts +16 -0
  191. package/src/server/modules/sync-note/sync-note.service.ts +25 -0
@@ -0,0 +1,88 @@
1
+ import { createHash } from 'node:crypto';
2
+ export class CoreSyncMutationStore {
3
+ store;
4
+ options;
5
+ constructor(store, options) {
6
+ this.store = store;
7
+ this.options = options;
8
+ }
9
+ static key(model, userId, recordId, mutationId) {
10
+ return createHash('sha256').update([model, userId, recordId, mutationId].join('\u0000')).digest('hex');
11
+ }
12
+ async claim(key, now = new Date()) {
13
+ for (let round = 0; round < 3; round++) {
14
+ const existing = await this.store.findOne({ key });
15
+ if (!existing) {
16
+ try {
17
+ await this.store.insert({ key, ...this.pending(now, 1) });
18
+ return { kind: 'claimed' };
19
+ }
20
+ catch (error) {
21
+ if (!isDuplicateKey(error)) {
22
+ throw error;
23
+ }
24
+ continue;
25
+ }
26
+ }
27
+ if (isExpired(existing, now)) {
28
+ if (await this.takeOver(existing, now)) {
29
+ return { kind: 'claimed' };
30
+ }
31
+ continue;
32
+ }
33
+ if (existing.state === 'done' && existing.status) {
34
+ return { kind: 'done', outcome: outcomeOf(existing) };
35
+ }
36
+ const claimedAt = existing.claimedAt ? new Date(existing.claimedAt).getTime() : 0;
37
+ if (now.getTime() - claimedAt < this.options.claimTimeoutMs) {
38
+ return { kind: 'busy' };
39
+ }
40
+ return (await this.takeOver(existing, now)) ? { kind: 'claimed' } : { kind: 'busy' };
41
+ }
42
+ return { kind: 'busy' };
43
+ }
44
+ async complete(key, outcome, now = new Date()) {
45
+ await this.store.updateOne({ key }, {
46
+ $set: {
47
+ code: outcome.code ?? null,
48
+ expiresAt: new Date(now.getTime() + this.options.retentionMs),
49
+ state: 'done',
50
+ status: outcome.status,
51
+ version: outcome.version ?? null,
52
+ },
53
+ });
54
+ }
55
+ async release(key) {
56
+ await this.store.deleteOne({ key, state: 'pending' });
57
+ }
58
+ pending(now, attempt) {
59
+ return {
60
+ attempt,
61
+ claimedAt: now,
62
+ code: null,
63
+ expiresAt: new Date(now.getTime() + this.options.retentionMs),
64
+ state: 'pending',
65
+ status: null,
66
+ version: null,
67
+ };
68
+ }
69
+ async takeOver(existing, now) {
70
+ const attempt = existing.attempt ?? 0;
71
+ const taken = await this.store.updateOne({ attempt: existing.attempt ?? null, id: existing.id }, { $set: this.pending(now, attempt + 1) });
72
+ return !!taken;
73
+ }
74
+ }
75
+ function isExpired(record, now) {
76
+ return !!record.expiresAt && new Date(record.expiresAt).getTime() <= now.getTime();
77
+ }
78
+ function outcomeOf(record) {
79
+ return {
80
+ ...(record.code ? { code: record.code } : {}),
81
+ status: record.status,
82
+ ...(typeof record.version === 'number' ? { version: record.version } : {}),
83
+ };
84
+ }
85
+ export function isDuplicateKey(error) {
86
+ return error?.code === 11000;
87
+ }
88
+ //# sourceMappingURL=core-sync-mutation.store.js.map
@@ -0,0 +1 @@
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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"}
@@ -0,0 +1,18 @@
1
+ import type { DataStore } from '../../common/persistence/data-store.interface.js';
2
+ interface StateRecord {
3
+ epoch?: null | number;
4
+ horizon?: Date | null;
5
+ key: string;
6
+ }
7
+ export declare class CoreSyncStateStore {
8
+ protected readonly store: DataStore<StateRecord>;
9
+ constructor(store: DataStore<StateRecord>);
10
+ static tenantEpochKey(model: string, tenantId: string): string;
11
+ static userEpochKey(model: string, tenantId: string, userId: string): string;
12
+ static horizonKey(model: string): string;
13
+ epochs(keys: readonly string[]): Promise<Map<string, number>>;
14
+ bump(key: string): Promise<void>;
15
+ horizon(model: string): Promise<Date | undefined>;
16
+ advanceHorizon(model: string, at: Date): Promise<void>;
17
+ }
18
+ export {};
@@ -0,0 +1,64 @@
1
+ import { isDuplicateKey } from './core-sync-mutation.store.js';
2
+ export class CoreSyncStateStore {
3
+ store;
4
+ constructor(store) {
5
+ this.store = store;
6
+ }
7
+ static tenantEpochKey(model, tenantId) {
8
+ return `epoch:t:${model}:${tenantId}`;
9
+ }
10
+ static userEpochKey(model, tenantId, userId) {
11
+ return `epoch:u:${model}:${tenantId}:${userId}`;
12
+ }
13
+ static horizonKey(model) {
14
+ return `horizon:${model}`;
15
+ }
16
+ async epochs(keys) {
17
+ const result = new Map(keys.map((key) => [key, 0]));
18
+ if (!keys.length) {
19
+ return result;
20
+ }
21
+ for (const row of await this.store.find({ key: { $in: [...keys] } }, { select: ['epoch', 'key'] })) {
22
+ result.set(row.key, typeof row.epoch === 'number' ? row.epoch : 0);
23
+ }
24
+ return result;
25
+ }
26
+ async bump(key) {
27
+ if (await this.store.updateOne({ key }, { $inc: { epoch: 1 } })) {
28
+ return;
29
+ }
30
+ try {
31
+ await this.store.insert({ epoch: 1, key });
32
+ }
33
+ catch (error) {
34
+ if (!isDuplicateKey(error)) {
35
+ throw error;
36
+ }
37
+ await this.store.updateOne({ key }, { $inc: { epoch: 1 } });
38
+ }
39
+ }
40
+ async horizon(model) {
41
+ const row = await this.store.findOne({ key: CoreSyncStateStore.horizonKey(model) });
42
+ return row?.horizon ? new Date(row.horizon) : undefined;
43
+ }
44
+ async advanceHorizon(model, at) {
45
+ const key = CoreSyncStateStore.horizonKey(model);
46
+ const behind = { $or: [{ horizon: null }, { horizon: { $lt: at } }], key };
47
+ if (await this.store.updateOne(behind, { $set: { horizon: at } })) {
48
+ return;
49
+ }
50
+ if (await this.store.findOne({ key })) {
51
+ return;
52
+ }
53
+ try {
54
+ await this.store.insert({ horizon: at, key });
55
+ }
56
+ catch (error) {
57
+ if (!isDuplicateKey(error)) {
58
+ throw error;
59
+ }
60
+ await this.store.updateOne(behind, { $set: { horizon: at } });
61
+ }
62
+ }
63
+ }
64
+ //# sourceMappingURL=core-sync-state.store.js.map
@@ -0,0 +1 @@
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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"}
@@ -0,0 +1,28 @@
1
+ export declare const SYNC_MUTATION_MODEL = "SyncMutation";
2
+ export declare const SYNC_STATE_MODEL = "SyncState";
3
+ export declare const SYNC_SERVICE_METADATA = "lt:sync:service";
4
+ export declare const SYNC_FIELD_METADATA = "lt:sync:fields";
5
+ export declare const SYNC_CLAIM_TIMEOUT_MS = 30000;
6
+ export declare const SYNC_REAPPLY_ATTEMPTS = 3;
7
+ export declare const SYNC_DEFAULTS: Readonly<{
8
+ hintDebounceMs: 250;
9
+ maxBytes: 1048576;
10
+ maxItems: 100;
11
+ maxLimit: 1000;
12
+ mutationsDays: 30;
13
+ path: "sync";
14
+ pullLimit: 200;
15
+ rateLimitPull: {
16
+ max: number;
17
+ windowSeconds: number;
18
+ };
19
+ rateLimitPush: {
20
+ max: number;
21
+ windowSeconds: number;
22
+ };
23
+ tombstonesDays: 90;
24
+ }>;
25
+ export declare const SYNC_PURGE_BATCH = 1000;
26
+ export declare const SYNC_PURGE_INTERVAL_MS: number;
27
+ export declare const SYNC_HINT_KEEPALIVE_MS = 25000;
28
+ export declare const SYNC_PULL_LIMIT_CEILING = 1000;
@@ -0,0 +1,23 @@
1
+ export const SYNC_MUTATION_MODEL = 'SyncMutation';
2
+ export const SYNC_STATE_MODEL = 'SyncState';
3
+ export const SYNC_SERVICE_METADATA = 'lt:sync:service';
4
+ export const SYNC_FIELD_METADATA = 'lt:sync:fields';
5
+ export const SYNC_CLAIM_TIMEOUT_MS = 30_000;
6
+ export const SYNC_REAPPLY_ATTEMPTS = 3;
7
+ export const SYNC_DEFAULTS = Object.freeze({
8
+ hintDebounceMs: 250,
9
+ maxBytes: 1_048_576,
10
+ maxItems: 100,
11
+ maxLimit: 1000,
12
+ mutationsDays: 30,
13
+ path: 'sync',
14
+ pullLimit: 200,
15
+ rateLimitPull: { max: 120, windowSeconds: 60 },
16
+ rateLimitPush: { max: 60, windowSeconds: 60 },
17
+ tombstonesDays: 90,
18
+ });
19
+ export const SYNC_PURGE_BATCH = 1000;
20
+ export const SYNC_PURGE_INTERVAL_MS = 60 * 60_000;
21
+ export const SYNC_HINT_KEEPALIVE_MS = 25_000;
22
+ export const SYNC_PULL_LIMIT_CEILING = 1000;
23
+ //# sourceMappingURL=core-sync.constants.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,8 @@
1
+ import { CoreSyncBaseController } from './core-sync-base.controller.js';
2
+ import type { ISyncPullResult, ISyncPushResult } from './interfaces/core-sync.interfaces.js';
3
+ export declare class CoreSyncController extends CoreSyncBaseController {
4
+ pull(model: string, cursor: string, limit: string, currentUser: any, req: any, res: any): Promise<ISyncPullResult | object>;
5
+ push(model: string, body: any, currentUser: any, req: any, res: any): Promise<{
6
+ results: ISyncPushResult[];
7
+ }>;
8
+ }
@@ -0,0 +1,79 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
11
+ return function (target, key) { decorator(target, key, paramIndex); }
12
+ };
13
+ import { Body, Controller, Get, HttpCode, HttpStatus, Param, Post, Query, Req, Res } from '@nestjs/common';
14
+ import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger';
15
+ import { CurrentUser } from '../../common/decorators/current-user.decorator.js';
16
+ import { Roles } from '../../common/decorators/roles.decorator.js';
17
+ import { RoleEnum } from '../../common/enums/role.enum.js';
18
+ import { CoreSyncBaseController } from './core-sync-base.controller.js';
19
+ import { SYNC_DEFAULTS } from './core-sync.constants.js';
20
+ import { SyncResyncRequiredException } from './core-sync.service.js';
21
+ let CoreSyncController = class CoreSyncController extends CoreSyncBaseController {
22
+ async pull(model, cursor, limit, currentUser, req, res) {
23
+ await this.limit('pull', currentUser, res);
24
+ await this.scopeTenants(req, currentUser);
25
+ try {
26
+ return await this.syncService.pull(model, { cursor, limit }, currentUser);
27
+ }
28
+ catch (error) {
29
+ if (error instanceof SyncResyncRequiredException) {
30
+ res?.status?.(error.getStatus());
31
+ return error.getResponse();
32
+ }
33
+ throw error;
34
+ }
35
+ }
36
+ async push(model, body, currentUser, req, res) {
37
+ this.syncService.assertPushRequest(req);
38
+ await this.limit('push', currentUser, res);
39
+ await this.scopeTenants(req, currentUser);
40
+ return this.syncService.push(model, body, currentUser);
41
+ }
42
+ };
43
+ __decorate([
44
+ ApiBearerAuth(),
45
+ ApiOperation({ description: 'One page of changes after the cursor (protocol §5)', summary: 'Pull changes' }),
46
+ Get(':model'),
47
+ Roles(RoleEnum.S_USER),
48
+ __param(0, Param('model')),
49
+ __param(1, Query('cursor')),
50
+ __param(2, Query('limit')),
51
+ __param(3, CurrentUser()),
52
+ __param(4, Req()),
53
+ __param(5, Res({ passthrough: true })),
54
+ __metadata("design:type", Function),
55
+ __metadata("design:paramtypes", [String, String, String, Object, Object, Object]),
56
+ __metadata("design:returntype", Promise)
57
+ ], CoreSyncController.prototype, "pull", null);
58
+ __decorate([
59
+ ApiBearerAuth(),
60
+ ApiOperation({ description: 'Apply pushed changes item by item (protocol §6)', summary: 'Push changes' }),
61
+ HttpCode(HttpStatus.OK),
62
+ Post(':model'),
63
+ Roles(RoleEnum.S_USER),
64
+ __param(0, Param('model')),
65
+ __param(1, Body()),
66
+ __param(2, CurrentUser()),
67
+ __param(3, Req()),
68
+ __param(4, Res({ passthrough: true })),
69
+ __metadata("design:type", Function),
70
+ __metadata("design:paramtypes", [String, Object, Object, Object, Object]),
71
+ __metadata("design:returntype", Promise)
72
+ ], CoreSyncController.prototype, "push", null);
73
+ CoreSyncController = __decorate([
74
+ ApiTags('sync'),
75
+ Controller(SYNC_DEFAULTS.path),
76
+ Roles(RoleEnum.S_USER)
77
+ ], CoreSyncController);
78
+ export { CoreSyncController };
79
+ //# sourceMappingURL=core-sync.controller.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core-sync.controller.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync.controller.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { Type } from '@nestjs/common';
2
+ export interface SyncServiceOptions {
3
+ createInput: Type<any>;
4
+ model: Type<any>;
5
+ modelName?: string;
6
+ updateInput: Type<any>;
7
+ }
8
+ export declare function SyncService(options: SyncServiceOptions): ClassDecorator;
9
+ export declare function getSyncServiceOptions(target: Function): SyncServiceOptions | undefined;
10
+ export type SyncFieldStrategy = 'lww' | 'reject';
11
+ export declare function SyncField(strategy: SyncFieldStrategy): PropertyDecorator;
12
+ export declare function getSyncFieldStrategies(modelClass: Function): Record<string, SyncFieldStrategy>;
@@ -0,0 +1,28 @@
1
+ import { SYNC_FIELD_METADATA, SYNC_SERVICE_METADATA } from './core-sync.constants.js';
2
+ export function SyncService(options) {
3
+ return (target) => {
4
+ Reflect.defineMetadata(SYNC_SERVICE_METADATA, { ...options }, target);
5
+ };
6
+ }
7
+ export function getSyncServiceOptions(target) {
8
+ return Reflect.getMetadata(SYNC_SERVICE_METADATA, target);
9
+ }
10
+ export function SyncField(strategy) {
11
+ if (strategy !== 'lww' && strategy !== 'reject') {
12
+ throw new Error(`@SyncField: strategy must be 'lww' or 'reject', got ${JSON.stringify(strategy)}`);
13
+ }
14
+ return (target, property) => {
15
+ const own = Reflect.hasOwnMetadata(SYNC_FIELD_METADATA, target.constructor)
16
+ ? Reflect.getOwnMetadata(SYNC_FIELD_METADATA, target.constructor)
17
+ : {};
18
+ Reflect.defineMetadata(SYNC_FIELD_METADATA, { ...own, [String(property)]: strategy }, target.constructor);
19
+ };
20
+ }
21
+ export function getSyncFieldStrategies(modelClass) {
22
+ const chain = [];
23
+ for (let current = modelClass; current && current !== Function.prototype; current = Object.getPrototypeOf(current)) {
24
+ chain.unshift(current);
25
+ }
26
+ return Object.assign({}, ...chain.map((current) => Reflect.hasOwnMetadata(SYNC_FIELD_METADATA, current) ? Reflect.getOwnMetadata(SYNC_FIELD_METADATA, current) : {}));
27
+ }
28
+ //# sourceMappingURL=core-sync.decorators.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,16 @@
1
+ import { DynamicModule, Type } from '@nestjs/common';
2
+ import { CoreSyncController } from './core-sync.controller.js';
3
+ import { CoreSyncHintsController } from './core-sync-hints.controller.js';
4
+ import { CoreSyncResolver } from './core-sync.resolver.js';
5
+ import { CoreSyncService } from './core-sync.service.js';
6
+ export interface CoreSyncModuleOptions {
7
+ controller?: Type<CoreSyncController>;
8
+ graphQlHints?: boolean;
9
+ hintsController?: Type<CoreSyncHintsController>;
10
+ path?: string;
11
+ resolver?: Type<CoreSyncResolver>;
12
+ service?: Type<CoreSyncService>;
13
+ }
14
+ export declare class CoreSyncModule {
15
+ static forRoot(options?: CoreSyncModuleOptions): DynamicModule;
16
+ }
@@ -0,0 +1,50 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var CoreSyncModule_1;
8
+ import { Module } from '@nestjs/common';
9
+ import { PATH_METADATA } from '@nestjs/common/constants';
10
+ import { DiscoveryModule } from '@nestjs/core';
11
+ import { CorePersistenceModule } from '../../common/persistence/core-persistence.module.js';
12
+ import { SYNC_DEFAULTS, SYNC_MUTATION_MODEL, SYNC_STATE_MODEL } from './core-sync.constants.js';
13
+ import { CoreSyncController } from './core-sync.controller.js';
14
+ import { CoreSyncHintsController } from './core-sync-hints.controller.js';
15
+ import { CoreSyncHintService } from './core-sync-hints.service.js';
16
+ import { SyncMutationSchema, SyncStateSchema } from './core-sync-infrastructure.models.js';
17
+ import { CoreSyncResolver } from './core-sync.resolver.js';
18
+ import { CoreSyncService } from './core-sync.service.js';
19
+ let CoreSyncModule = CoreSyncModule_1 = class CoreSyncModule {
20
+ static forRoot(options = {}) {
21
+ const controller = options.controller ?? CoreSyncController;
22
+ const hintsController = options.hintsController ?? CoreSyncHintsController;
23
+ for (const routes of [hintsController, controller]) {
24
+ Reflect.defineMetadata(PATH_METADATA, options.path || SYNC_DEFAULTS.path, routes);
25
+ }
26
+ return {
27
+ controllers: [hintsController, controller],
28
+ exports: [CoreSyncHintService, CoreSyncService],
29
+ global: true,
30
+ imports: [
31
+ DiscoveryModule,
32
+ CorePersistenceModule.forFeature([
33
+ { name: SYNC_MUTATION_MODEL, schema: SyncMutationSchema },
34
+ { name: SYNC_STATE_MODEL, schema: SyncStateSchema },
35
+ ]),
36
+ ],
37
+ module: CoreSyncModule_1,
38
+ providers: [
39
+ CoreSyncHintService,
40
+ options.service ? { provide: CoreSyncService, useClass: options.service } : CoreSyncService,
41
+ ...(options.graphQlHints === false ? [] : [options.resolver ?? CoreSyncResolver]),
42
+ ],
43
+ };
44
+ }
45
+ };
46
+ CoreSyncModule = CoreSyncModule_1 = __decorate([
47
+ Module({})
48
+ ], CoreSyncModule);
49
+ export { CoreSyncModule };
50
+ //# sourceMappingURL=core-sync.module.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core-sync.module.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAiB,MAAM,EAAQ,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgClD,IAAM,cAAc,sBAApB,MAAM,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC;QAC5D,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,uBAAuB,CAAC;QAE3E,KAAK,MAAM,MAAM,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpF,CAAC;QACD,OAAO;YAGL,WAAW,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;YAC1C,OAAO,EAAE,CAAC,mBAAmB,EAAE,eAAe,CAAC;YAG/C,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,eAAe;gBACf,qBAAqB,CAAC,UAAU,CAAC;oBAC/B,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,kBAAkB,EAAE;oBACzD,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE;iBACpD,CAAC;aACH;YACD,MAAM,EAAE,gBAAc;YACtB,SAAS,EAAE;gBACT,mBAAmB;gBACnB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,eAAe;gBAC3F,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC,CAAC;aAClF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA/BY,cAAc;IAD1B,MAAM,CAAC,EAAE,CAAC;GACE,cAAc,CA+B1B"}
@@ -0,0 +1,9 @@
1
+ import { CoreSyncService } from './core-sync.service.js';
2
+ import { CoreSyncHintModel } from './models/core-sync-hint.model.js';
3
+ export declare class CoreSyncResolver {
4
+ protected readonly syncService: CoreSyncService;
5
+ constructor(syncService: CoreSyncService);
6
+ syncHint(currentUser: any, models?: string[]): Promise<AsyncIterableIterator<{
7
+ syncHint: CoreSyncHintModel;
8
+ }>>;
9
+ }
@@ -0,0 +1,46 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ 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;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
11
+ return function (target, key) { decorator(target, key, paramIndex); }
12
+ };
13
+ import { Args, Resolver, Subscription } from '@nestjs/graphql';
14
+ import { GraphQLUser } from '../../common/decorators/graphql-user.decorator.js';
15
+ import { Roles } from '../../common/decorators/roles.decorator.js';
16
+ import { RoleEnum } from '../../common/enums/role.enum.js';
17
+ import { CoreSyncService } from './core-sync.service.js';
18
+ import { CoreSyncHintModel } from './models/core-sync-hint.model.js';
19
+ let CoreSyncResolver = class CoreSyncResolver {
20
+ syncService;
21
+ constructor(syncService) {
22
+ this.syncService = syncService;
23
+ }
24
+ syncHint(currentUser, models) {
25
+ return this.syncService.hintIterator(currentUser, models);
26
+ }
27
+ };
28
+ __decorate([
29
+ Roles(RoleEnum.S_USER),
30
+ Subscription(() => CoreSyncHintModel, {
31
+ description: 'A hint whenever a synchronized model the subscriber may pull changes',
32
+ name: 'syncHint',
33
+ }),
34
+ __param(0, GraphQLUser()),
35
+ __param(1, Args('models', { description: 'Only these models (all when absent)', nullable: true, type: () => [String] })),
36
+ __metadata("design:type", Function),
37
+ __metadata("design:paramtypes", [Object, Array]),
38
+ __metadata("design:returntype", Promise)
39
+ ], CoreSyncResolver.prototype, "syncHint", null);
40
+ CoreSyncResolver = __decorate([
41
+ Resolver(),
42
+ Roles(RoleEnum.S_USER),
43
+ __metadata("design:paramtypes", [CoreSyncService])
44
+ ], CoreSyncResolver);
45
+ export { CoreSyncResolver };
46
+ //# sourceMappingURL=core-sync.resolver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core-sync.resolver.js","sourceRoot":"","sources":["../../../../src/core/modules/sync/core-sync.resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/D,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,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAa9D,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IACI;IAA/B,YAA+B,WAA4B;QAA5B,gBAAW,GAAX,WAAW,CAAiB;IAAG,CAAC;IAO/D,QAAQ,CACS,WAAgB,EAE/B,MAAiB;QAEjB,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;CACF,CAAA;AAPC;IALC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;IACtB,YAAY,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE;QACrC,WAAW,EAAE,sEAAsE;QACnF,IAAI,EAAE,UAAU;KACjB,CAAC;IAEC,WAAA,WAAW,EAAE,CAAA;IACb,WAAA,IAAI,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;;;;gDAI9G;AAdU,gBAAgB;IAF5B,QAAQ,EAAE;IACV,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;qCAEuB,eAAe;GADhD,gBAAgB,CAe5B"}