@kodelyth/matrix 2026.5.42 → 2026.6.2

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 (205) hide show
  1. package/klaw.plugin.json +891 -3
  2. package/package.json +18 -6
  3. package/CHANGELOG.md +0 -321
  4. package/SPEC-SUPPORT.md +0 -116
  5. package/api.ts +0 -38
  6. package/auth-presence.ts +0 -56
  7. package/channel-plugin-api.ts +0 -3
  8. package/cli-metadata.ts +0 -11
  9. package/contract-api.ts +0 -17
  10. package/doctor-contract-api.ts +0 -1
  11. package/helper-api.ts +0 -3
  12. package/index.ts +0 -55
  13. package/plugin-entry.handlers.runtime.ts +0 -1
  14. package/runtime-api.ts +0 -72
  15. package/runtime-heavy-api.ts +0 -1
  16. package/runtime-setter-api.ts +0 -3
  17. package/secret-contract-api.ts +0 -5
  18. package/setup-entry.ts +0 -17
  19. package/setup-plugin-api.ts +0 -3
  20. package/src/account-selection.ts +0 -223
  21. package/src/actions.ts +0 -346
  22. package/src/approval-auth.ts +0 -25
  23. package/src/approval-handler.runtime.ts +0 -592
  24. package/src/approval-ids.ts +0 -6
  25. package/src/approval-native.ts +0 -345
  26. package/src/approval-reaction-auth.ts +0 -45
  27. package/src/approval-reactions.ts +0 -313
  28. package/src/auth-precedence.ts +0 -61
  29. package/src/channel-account-paths.ts +0 -97
  30. package/src/channel.runtime.ts +0 -17
  31. package/src/channel.setup.ts +0 -48
  32. package/src/channel.ts +0 -667
  33. package/src/cli-metadata.ts +0 -19
  34. package/src/cli.ts +0 -2298
  35. package/src/config-adapter.ts +0 -41
  36. package/src/config-schema.ts +0 -159
  37. package/src/config-ui-hints.ts +0 -56
  38. package/src/directory-live.ts +0 -238
  39. package/src/doctor-contract.ts +0 -287
  40. package/src/doctor.ts +0 -262
  41. package/src/env-vars.ts +0 -92
  42. package/src/exec-approval-resolver.ts +0 -23
  43. package/src/exec-approvals.ts +0 -287
  44. package/src/group-mentions.ts +0 -41
  45. package/src/legacy-crypto-inspector-availability.ts +0 -60
  46. package/src/legacy-crypto.ts +0 -531
  47. package/src/legacy-state.ts +0 -156
  48. package/src/matrix/account-config.ts +0 -175
  49. package/src/matrix/accounts.ts +0 -194
  50. package/src/matrix/actions/client.ts +0 -31
  51. package/src/matrix/actions/devices.ts +0 -34
  52. package/src/matrix/actions/limits.ts +0 -6
  53. package/src/matrix/actions/messages.ts +0 -129
  54. package/src/matrix/actions/pins.ts +0 -63
  55. package/src/matrix/actions/polls.ts +0 -109
  56. package/src/matrix/actions/profile.ts +0 -37
  57. package/src/matrix/actions/reactions.ts +0 -59
  58. package/src/matrix/actions/room.ts +0 -71
  59. package/src/matrix/actions/summary.ts +0 -88
  60. package/src/matrix/actions/types.ts +0 -63
  61. package/src/matrix/actions/verification.ts +0 -589
  62. package/src/matrix/actions.ts +0 -37
  63. package/src/matrix/active-client.ts +0 -26
  64. package/src/matrix/async-lock.ts +0 -18
  65. package/src/matrix/backup-health.ts +0 -124
  66. package/src/matrix/client/config-runtime-api.ts +0 -9
  67. package/src/matrix/client/config-secret-input.runtime.ts +0 -1
  68. package/src/matrix/client/config.ts +0 -853
  69. package/src/matrix/client/create-client.ts +0 -105
  70. package/src/matrix/client/env-auth.ts +0 -95
  71. package/src/matrix/client/file-sync-store.ts +0 -289
  72. package/src/matrix/client/logging.ts +0 -140
  73. package/src/matrix/client/migration-snapshot.runtime.ts +0 -1
  74. package/src/matrix/client/private-network-host.ts +0 -1
  75. package/src/matrix/client/runtime.ts +0 -4
  76. package/src/matrix/client/shared.ts +0 -316
  77. package/src/matrix/client/storage.ts +0 -543
  78. package/src/matrix/client/types.ts +0 -50
  79. package/src/matrix/client/url-validation.ts +0 -73
  80. package/src/matrix/client-bootstrap.ts +0 -173
  81. package/src/matrix/client.ts +0 -23
  82. package/src/matrix/config-paths.ts +0 -31
  83. package/src/matrix/config-update.ts +0 -292
  84. package/src/matrix/credentials-read.ts +0 -208
  85. package/src/matrix/credentials-write.runtime.ts +0 -35
  86. package/src/matrix/credentials.ts +0 -95
  87. package/src/matrix/deps.ts +0 -309
  88. package/src/matrix/device-health.ts +0 -29
  89. package/src/matrix/direct-management.ts +0 -349
  90. package/src/matrix/direct-room.ts +0 -128
  91. package/src/matrix/draft-stream.ts +0 -225
  92. package/src/matrix/encryption-guidance.ts +0 -24
  93. package/src/matrix/errors.ts +0 -21
  94. package/src/matrix/format.ts +0 -426
  95. package/src/matrix/legacy-crypto-inspector.ts +0 -95
  96. package/src/matrix/media-errors.ts +0 -20
  97. package/src/matrix/media-text.ts +0 -162
  98. package/src/matrix/monitor/access-state.ts +0 -145
  99. package/src/matrix/monitor/ack-config.ts +0 -27
  100. package/src/matrix/monitor/allowlist.ts +0 -89
  101. package/src/matrix/monitor/auto-join.ts +0 -86
  102. package/src/matrix/monitor/config.ts +0 -569
  103. package/src/matrix/monitor/context-summary.ts +0 -43
  104. package/src/matrix/monitor/direct.ts +0 -296
  105. package/src/matrix/monitor/events.ts +0 -397
  106. package/src/matrix/monitor/handler.ts +0 -2266
  107. package/src/matrix/monitor/inbound-dedupe.ts +0 -267
  108. package/src/matrix/monitor/index.ts +0 -540
  109. package/src/matrix/monitor/legacy-crypto-restore.ts +0 -139
  110. package/src/matrix/monitor/location.ts +0 -108
  111. package/src/matrix/monitor/media.ts +0 -119
  112. package/src/matrix/monitor/mentions.ts +0 -256
  113. package/src/matrix/monitor/reaction-events.ts +0 -197
  114. package/src/matrix/monitor/recent-invite.ts +0 -30
  115. package/src/matrix/monitor/replies.ts +0 -136
  116. package/src/matrix/monitor/reply-context.ts +0 -92
  117. package/src/matrix/monitor/room-history.ts +0 -301
  118. package/src/matrix/monitor/room-info.ts +0 -126
  119. package/src/matrix/monitor/rooms.ts +0 -52
  120. package/src/matrix/monitor/route.ts +0 -179
  121. package/src/matrix/monitor/runtime-api.ts +0 -28
  122. package/src/matrix/monitor/startup-verification.ts +0 -237
  123. package/src/matrix/monitor/startup.ts +0 -218
  124. package/src/matrix/monitor/status.ts +0 -120
  125. package/src/matrix/monitor/sync-lifecycle.ts +0 -91
  126. package/src/matrix/monitor/task-runner.ts +0 -38
  127. package/src/matrix/monitor/test-events.ts +0 -21
  128. package/src/matrix/monitor/thread-context.ts +0 -108
  129. package/src/matrix/monitor/threads.ts +0 -85
  130. package/src/matrix/monitor/types.ts +0 -30
  131. package/src/matrix/monitor/verification-events.ts +0 -643
  132. package/src/matrix/monitor/verification-utils.ts +0 -46
  133. package/src/matrix/outbound-media-runtime.ts +0 -1
  134. package/src/matrix/poll-summary.ts +0 -110
  135. package/src/matrix/poll-types.ts +0 -429
  136. package/src/matrix/probe.runtime.ts +0 -4
  137. package/src/matrix/probe.ts +0 -97
  138. package/src/matrix/profile.ts +0 -184
  139. package/src/matrix/reaction-common.ts +0 -147
  140. package/src/matrix/sdk/crypto-bootstrap.ts +0 -438
  141. package/src/matrix/sdk/crypto-facade.ts +0 -242
  142. package/src/matrix/sdk/crypto-node.runtime.ts +0 -17
  143. package/src/matrix/sdk/crypto-runtime.ts +0 -14
  144. package/src/matrix/sdk/decrypt-bridge.ts +0 -410
  145. package/src/matrix/sdk/event-helpers.ts +0 -83
  146. package/src/matrix/sdk/http-client.ts +0 -87
  147. package/src/matrix/sdk/idb-persistence-lock.ts +0 -51
  148. package/src/matrix/sdk/idb-persistence.ts +0 -288
  149. package/src/matrix/sdk/logger.ts +0 -108
  150. package/src/matrix/sdk/read-response-with-limit.ts +0 -19
  151. package/src/matrix/sdk/recovery-key-store.ts +0 -453
  152. package/src/matrix/sdk/timeout-abort-signal.ts +0 -1
  153. package/src/matrix/sdk/transport-runtime-api.ts +0 -18
  154. package/src/matrix/sdk/transport.ts +0 -352
  155. package/src/matrix/sdk/types.ts +0 -245
  156. package/src/matrix/sdk/verification-manager.ts +0 -795
  157. package/src/matrix/sdk/verification-status.ts +0 -23
  158. package/src/matrix/sdk.ts +0 -2152
  159. package/src/matrix/send/client.ts +0 -93
  160. package/src/matrix/send/formatting.ts +0 -189
  161. package/src/matrix/send/media.ts +0 -244
  162. package/src/matrix/send/targets.ts +0 -104
  163. package/src/matrix/send/types.ts +0 -131
  164. package/src/matrix/send.ts +0 -660
  165. package/src/matrix/session-store-metadata.ts +0 -108
  166. package/src/matrix/startup-abort.ts +0 -44
  167. package/src/matrix/subagent-hooks.ts +0 -308
  168. package/src/matrix/sync-state.ts +0 -27
  169. package/src/matrix/target-ids.ts +0 -79
  170. package/src/matrix/thread-bindings-shared.ts +0 -206
  171. package/src/matrix/thread-bindings.ts +0 -580
  172. package/src/matrix-migration.runtime.ts +0 -9
  173. package/src/migration-config.ts +0 -243
  174. package/src/migration-snapshot-backup.ts +0 -116
  175. package/src/migration-snapshot.ts +0 -53
  176. package/src/onboarding.ts +0 -775
  177. package/src/outbound.ts +0 -248
  178. package/src/plugin-entry.runtime.js +0 -115
  179. package/src/plugin-entry.runtime.ts +0 -70
  180. package/src/profile-update.ts +0 -71
  181. package/src/record-shared.ts +0 -3
  182. package/src/resolve-targets.ts +0 -175
  183. package/src/resolver.runtime.ts +0 -5
  184. package/src/resolver.ts +0 -21
  185. package/src/runtime-api.ts +0 -106
  186. package/src/runtime.ts +0 -13
  187. package/src/secret-contract.ts +0 -174
  188. package/src/session-route.ts +0 -126
  189. package/src/setup-bootstrap.ts +0 -102
  190. package/src/setup-config.ts +0 -222
  191. package/src/setup-contract.ts +0 -90
  192. package/src/setup-core.ts +0 -146
  193. package/src/setup-dm-policy.ts +0 -15
  194. package/src/setup-surface.ts +0 -4
  195. package/src/startup-maintenance.ts +0 -114
  196. package/src/storage-paths.ts +0 -92
  197. package/src/thread-binding-api.ts +0 -23
  198. package/src/tool-actions.runtime.ts +0 -1
  199. package/src/tool-actions.ts +0 -498
  200. package/src/types.ts +0 -257
  201. package/subagent-hooks-api.ts +0 -31
  202. package/test-api.ts +0 -21
  203. package/thread-binding-api.ts +0 -4
  204. package/thread-bindings-runtime.ts +0 -4
  205. package/tsconfig.json +0 -16
@@ -1,105 +0,0 @@
1
- import fs from "node:fs";
2
- import type { PinnedDispatcherPolicy } from "klaw/plugin-sdk/ssrf-dispatcher";
3
- import {
4
- ssrfPolicyFromDangerouslyAllowPrivateNetwork,
5
- type SsrFPolicy,
6
- } from "klaw/plugin-sdk/ssrf-runtime";
7
- import { normalizeOptionalString } from "klaw/plugin-sdk/string-coerce-runtime";
8
- import type { MatrixClient } from "../sdk.js";
9
- import { resolveValidatedMatrixHomeserverUrl } from "./config.js";
10
- import {
11
- maybeMigrateLegacyStorage,
12
- resolveMatrixStoragePaths,
13
- writeStorageMeta,
14
- } from "./storage.js";
15
-
16
- type MatrixCreateClientRuntimeDeps = {
17
- MatrixClient: typeof import("../sdk.js").MatrixClient;
18
- ensureMatrixSdkLoggingConfigured: typeof import("./logging.js").ensureMatrixSdkLoggingConfigured;
19
- };
20
-
21
- let matrixCreateClientRuntimeDepsPromise: Promise<MatrixCreateClientRuntimeDeps> | undefined;
22
-
23
- async function loadMatrixCreateClientRuntimeDeps(): Promise<MatrixCreateClientRuntimeDeps> {
24
- matrixCreateClientRuntimeDepsPromise ??= Promise.all([
25
- import("../sdk.js"),
26
- import("./logging.js"),
27
- ]).then(([sdkModule, loggingModule]) => ({
28
- MatrixClient: sdkModule.MatrixClient,
29
- ensureMatrixSdkLoggingConfigured: loggingModule.ensureMatrixSdkLoggingConfigured,
30
- }));
31
- return await matrixCreateClientRuntimeDepsPromise;
32
- }
33
-
34
- export async function createMatrixClient(params: {
35
- homeserver: string;
36
- userId?: string;
37
- accessToken: string;
38
- password?: string;
39
- deviceId?: string;
40
- persistStorage?: boolean;
41
- encryption?: boolean;
42
- localTimeoutMs?: number;
43
- initialSyncLimit?: number;
44
- accountId?: string | null;
45
- autoBootstrapCrypto?: boolean;
46
- allowPrivateNetwork?: boolean;
47
- ssrfPolicy?: SsrFPolicy;
48
- dispatcherPolicy?: PinnedDispatcherPolicy;
49
- }): Promise<MatrixClient> {
50
- const { MatrixClient, ensureMatrixSdkLoggingConfigured } =
51
- await loadMatrixCreateClientRuntimeDeps();
52
- ensureMatrixSdkLoggingConfigured();
53
- const homeserver = await resolveValidatedMatrixHomeserverUrl(params.homeserver, {
54
- dangerouslyAllowPrivateNetwork: params.allowPrivateNetwork,
55
- });
56
- const matrixClientUserId = normalizeOptionalString(params.userId);
57
- const userId = matrixClientUserId ?? "unknown";
58
- const persistStorage = params.persistStorage !== false;
59
- const storagePaths = persistStorage
60
- ? resolveMatrixStoragePaths({
61
- homeserver,
62
- userId,
63
- accessToken: params.accessToken,
64
- accountId: params.accountId,
65
- deviceId: params.deviceId,
66
- env: process.env,
67
- })
68
- : null;
69
-
70
- if (storagePaths) {
71
- await maybeMigrateLegacyStorage({
72
- storagePaths,
73
- env: process.env,
74
- });
75
- fs.mkdirSync(storagePaths.rootDir, { recursive: true });
76
- writeStorageMeta({
77
- storagePaths,
78
- homeserver,
79
- userId,
80
- accountId: params.accountId,
81
- deviceId: params.deviceId,
82
- });
83
- }
84
-
85
- const cryptoDatabasePrefix = storagePaths
86
- ? `klaw-matrix-${storagePaths.accountKey}-${storagePaths.tokenHash}`
87
- : undefined;
88
-
89
- return new MatrixClient(homeserver, params.accessToken, {
90
- userId: matrixClientUserId,
91
- password: params.password,
92
- deviceId: params.deviceId,
93
- encryption: params.encryption,
94
- localTimeoutMs: params.localTimeoutMs,
95
- initialSyncLimit: params.initialSyncLimit,
96
- storagePath: storagePaths?.storagePath,
97
- recoveryKeyPath: storagePaths?.recoveryKeyPath,
98
- idbSnapshotPath: storagePaths?.idbSnapshotPath,
99
- cryptoDatabasePrefix,
100
- autoBootstrapCrypto: params.autoBootstrapCrypto,
101
- ssrfPolicy:
102
- params.ssrfPolicy ?? ssrfPolicyFromDangerouslyAllowPrivateNetwork(params.allowPrivateNetwork),
103
- dispatcherPolicy: params.dispatcherPolicy,
104
- });
105
- }
@@ -1,95 +0,0 @@
1
- import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "klaw/plugin-sdk/account-id";
2
- import { getMatrixScopedEnvVarNames } from "../../env-vars.js";
3
-
4
- type MatrixEnvConfig = {
5
- homeserver: string;
6
- userId: string;
7
- accessToken?: string;
8
- password?: string;
9
- deviceId?: string;
10
- deviceName?: string;
11
- };
12
-
13
- function cleanEnv(value: unknown): string {
14
- return typeof value === "string" ? value.trim() : "";
15
- }
16
-
17
- export function resolveGlobalMatrixEnvConfig(env: NodeJS.ProcessEnv): MatrixEnvConfig {
18
- return {
19
- homeserver: cleanEnv(env.MATRIX_HOMESERVER),
20
- userId: cleanEnv(env.MATRIX_USER_ID),
21
- accessToken: cleanEnv(env.MATRIX_ACCESS_TOKEN) || undefined,
22
- password: cleanEnv(env.MATRIX_PASSWORD) || undefined,
23
- deviceId: cleanEnv(env.MATRIX_DEVICE_ID) || undefined,
24
- deviceName: cleanEnv(env.MATRIX_DEVICE_NAME) || undefined,
25
- };
26
- }
27
-
28
- export function hasReadyMatrixEnvAuth(config: {
29
- homeserver?: string;
30
- userId?: string;
31
- accessToken?: string;
32
- password?: string;
33
- }): boolean {
34
- const homeserver = cleanEnv(config.homeserver);
35
- const userId = cleanEnv(config.userId);
36
- const accessToken = cleanEnv(config.accessToken);
37
- const password = cleanEnv(config.password);
38
- return Boolean(homeserver && (accessToken || (userId && password)));
39
- }
40
-
41
- export function resolveScopedMatrixEnvConfig(
42
- accountId: string,
43
- env: NodeJS.ProcessEnv = process.env,
44
- ): MatrixEnvConfig {
45
- const keys = getMatrixScopedEnvVarNames(accountId);
46
- return {
47
- homeserver: cleanEnv(env[keys.homeserver]),
48
- userId: cleanEnv(env[keys.userId]),
49
- accessToken: cleanEnv(env[keys.accessToken]) || undefined,
50
- password: cleanEnv(env[keys.password]) || undefined,
51
- deviceId: cleanEnv(env[keys.deviceId]) || undefined,
52
- deviceName: cleanEnv(env[keys.deviceName]) || undefined,
53
- };
54
- }
55
-
56
- export function resolveMatrixEnvAuthReadiness(
57
- accountId: string,
58
- env: NodeJS.ProcessEnv = process.env,
59
- ): {
60
- ready: boolean;
61
- homeserver?: string;
62
- userId?: string;
63
- sourceHint: string;
64
- missingMessage: string;
65
- } {
66
- const normalizedAccountId = normalizeAccountId(accountId);
67
- const scoped = resolveScopedMatrixEnvConfig(normalizedAccountId, env);
68
- const scopedReady = hasReadyMatrixEnvAuth(scoped);
69
- if (normalizedAccountId !== DEFAULT_ACCOUNT_ID) {
70
- const keys = getMatrixScopedEnvVarNames(normalizedAccountId);
71
- return {
72
- ready: scopedReady,
73
- homeserver: scoped.homeserver || undefined,
74
- userId: scoped.userId || undefined,
75
- sourceHint: `${keys.homeserver} (+ auth vars)`,
76
- missingMessage: `Set per-account env vars for "${normalizedAccountId}" (for example ${keys.homeserver} + ${keys.accessToken} or ${keys.userId} + ${keys.password}).`,
77
- };
78
- }
79
-
80
- const defaultScoped = resolveScopedMatrixEnvConfig(DEFAULT_ACCOUNT_ID, env);
81
- const global = resolveGlobalMatrixEnvConfig(env);
82
- const defaultScopedReady = hasReadyMatrixEnvAuth(defaultScoped);
83
- const globalReady = hasReadyMatrixEnvAuth(global);
84
- const defaultKeys = getMatrixScopedEnvVarNames(DEFAULT_ACCOUNT_ID);
85
- return {
86
- ready: defaultScopedReady || globalReady,
87
- homeserver: defaultScoped.homeserver || global.homeserver || undefined,
88
- userId: defaultScoped.userId || global.userId || undefined,
89
- sourceHint: "MATRIX_* or MATRIX_DEFAULT_*",
90
- missingMessage:
91
- `Set Matrix env vars for the default account ` +
92
- `(for example MATRIX_HOMESERVER + MATRIX_ACCESS_TOKEN, MATRIX_USER_ID + MATRIX_PASSWORD, ` +
93
- `or ${defaultKeys.homeserver} + ${defaultKeys.accessToken}).`,
94
- };
95
- }
@@ -1,289 +0,0 @@
1
- import { readFileSync } from "node:fs";
2
- import fs from "node:fs/promises";
3
- import path from "node:path";
4
- import { writeJsonFileAtomically } from "klaw/plugin-sdk/json-store";
5
- import {
6
- Category,
7
- MemoryStore,
8
- SyncAccumulator,
9
- type ISyncData,
10
- type IRooms,
11
- type ISyncResponse,
12
- type IStoredClientOpts,
13
- } from "matrix-js-sdk/lib/matrix.js";
14
- import { isRecord } from "../../record-shared.js";
15
- import { createAsyncLock } from "../async-lock.js";
16
- import { LogService } from "../sdk/logger.js";
17
- import { claimCurrentTokenStorageState } from "./storage.js";
18
-
19
- const STORE_VERSION = 1;
20
- const PERSIST_DEBOUNCE_MS = 250;
21
-
22
- type PersistedMatrixSyncStore = {
23
- version: number;
24
- savedSync: ISyncData | null;
25
- clientOptions?: IStoredClientOpts;
26
- cleanShutdown?: boolean;
27
- };
28
-
29
- function normalizeRoomsData(value: unknown): IRooms | null {
30
- if (!isRecord(value)) {
31
- return null;
32
- }
33
- return {
34
- [Category.Join]: isRecord(value[Category.Join]) ? (value[Category.Join] as IRooms["join"]) : {},
35
- [Category.Invite]: isRecord(value[Category.Invite])
36
- ? (value[Category.Invite] as IRooms["invite"])
37
- : {},
38
- [Category.Leave]: isRecord(value[Category.Leave])
39
- ? (value[Category.Leave] as IRooms["leave"])
40
- : {},
41
- [Category.Knock]: isRecord(value[Category.Knock])
42
- ? (value[Category.Knock] as IRooms["knock"])
43
- : {},
44
- };
45
- }
46
-
47
- function toPersistedSyncData(value: unknown): ISyncData | null {
48
- if (!isRecord(value)) {
49
- return null;
50
- }
51
- if (typeof value.nextBatch === "string" && value.nextBatch.trim()) {
52
- const roomsData = normalizeRoomsData(value.roomsData);
53
- if (!Array.isArray(value.accountData) || !roomsData) {
54
- return null;
55
- }
56
- return {
57
- nextBatch: value.nextBatch,
58
- accountData: value.accountData,
59
- roomsData,
60
- };
61
- }
62
-
63
- // Older Matrix state files stored the raw /sync-shaped payload directly.
64
- if (typeof value.next_batch === "string" && value.next_batch.trim()) {
65
- const roomsData = normalizeRoomsData(value.rooms);
66
- if (!roomsData) {
67
- return null;
68
- }
69
- return {
70
- nextBatch: value.next_batch,
71
- accountData:
72
- isRecord(value.account_data) && Array.isArray(value.account_data.events)
73
- ? value.account_data.events
74
- : [],
75
- roomsData,
76
- };
77
- }
78
-
79
- return null;
80
- }
81
-
82
- function readPersistedStore(raw: string): PersistedMatrixSyncStore | null {
83
- try {
84
- const parsed = JSON.parse(raw) as {
85
- version?: unknown;
86
- savedSync?: unknown;
87
- clientOptions?: unknown;
88
- cleanShutdown?: unknown;
89
- };
90
- const savedSync = toPersistedSyncData(parsed.savedSync);
91
- if (parsed.version === STORE_VERSION) {
92
- return {
93
- version: STORE_VERSION,
94
- savedSync,
95
- clientOptions: isRecord(parsed.clientOptions)
96
- ? (parsed.clientOptions as IStoredClientOpts)
97
- : undefined,
98
- cleanShutdown: parsed.cleanShutdown === true,
99
- };
100
- }
101
-
102
- // Backward-compat: prior Matrix state files stored the raw sync blob at the
103
- // top level without versioning or wrapped metadata.
104
- return {
105
- version: STORE_VERSION,
106
- savedSync: toPersistedSyncData(parsed),
107
- cleanShutdown: false,
108
- };
109
- } catch {
110
- return null;
111
- }
112
- }
113
-
114
- function cloneJson<T>(value: T): T {
115
- return structuredClone(value);
116
- }
117
-
118
- function syncDataToSyncResponse(syncData: ISyncData): ISyncResponse {
119
- return {
120
- next_batch: syncData.nextBatch,
121
- rooms: syncData.roomsData,
122
- account_data: {
123
- events: syncData.accountData,
124
- },
125
- };
126
- }
127
-
128
- export class FileBackedMatrixSyncStore extends MemoryStore {
129
- private readonly persistLock = createAsyncLock();
130
- private readonly accumulator = new SyncAccumulator();
131
- private savedSync: ISyncData | null = null;
132
- private savedClientOptions: IStoredClientOpts | undefined;
133
- private readonly hadSavedSyncOnLoad: boolean;
134
- private readonly hadCleanShutdownOnLoad: boolean;
135
- private cleanShutdown = false;
136
- private dirty = false;
137
- private persistTimer: NodeJS.Timeout | null = null;
138
- private persistPromise: Promise<void> | null = null;
139
-
140
- constructor(private readonly storagePath: string) {
141
- super();
142
-
143
- let restoredSavedSync: ISyncData | null = null;
144
- let restoredClientOptions: IStoredClientOpts | undefined;
145
- let restoredCleanShutdown = false;
146
- try {
147
- const raw = readFileSync(this.storagePath, "utf8");
148
- const persisted = readPersistedStore(raw);
149
- restoredSavedSync = persisted?.savedSync ?? null;
150
- restoredClientOptions = persisted?.clientOptions;
151
- restoredCleanShutdown = persisted?.cleanShutdown === true;
152
- } catch {
153
- // Missing or unreadable sync cache should not block startup.
154
- }
155
-
156
- this.savedSync = restoredSavedSync;
157
- this.savedClientOptions = restoredClientOptions;
158
- this.hadSavedSyncOnLoad = restoredSavedSync !== null;
159
- this.hadCleanShutdownOnLoad = this.hadSavedSyncOnLoad && restoredCleanShutdown;
160
- this.cleanShutdown = this.hadCleanShutdownOnLoad;
161
-
162
- if (this.savedSync) {
163
- this.accumulator.accumulate(syncDataToSyncResponse(this.savedSync), true);
164
- super.setSyncToken(this.savedSync.nextBatch);
165
- }
166
- if (this.savedClientOptions) {
167
- void super.storeClientOptions(this.savedClientOptions);
168
- }
169
- }
170
-
171
- hasSavedSync(): boolean {
172
- return this.hadSavedSyncOnLoad;
173
- }
174
-
175
- hasSavedSyncFromCleanShutdown(): boolean {
176
- return this.hadCleanShutdownOnLoad;
177
- }
178
-
179
- override getSavedSync(): Promise<ISyncData | null> {
180
- return Promise.resolve(this.savedSync ? cloneJson(this.savedSync) : null);
181
- }
182
-
183
- override getSavedSyncToken(): Promise<string | null> {
184
- return Promise.resolve(this.savedSync?.nextBatch ?? null);
185
- }
186
-
187
- override setSyncData(syncData: ISyncResponse): Promise<void> {
188
- this.accumulator.accumulate(syncData);
189
- this.savedSync = this.accumulator.getJSON();
190
- this.markDirtyAndSchedulePersist();
191
- return Promise.resolve();
192
- }
193
-
194
- override getClientOptions() {
195
- return Promise.resolve(
196
- this.savedClientOptions ? cloneJson(this.savedClientOptions) : undefined,
197
- );
198
- }
199
-
200
- override storeClientOptions(options: IStoredClientOpts) {
201
- this.savedClientOptions = cloneJson(options);
202
- void super.storeClientOptions(options);
203
- this.markDirtyAndSchedulePersist();
204
- return Promise.resolve();
205
- }
206
-
207
- override save(force = false) {
208
- if (force) {
209
- return this.flush();
210
- }
211
- return Promise.resolve();
212
- }
213
-
214
- override wantsSave(): boolean {
215
- // We persist directly from setSyncData/storeClientOptions so the SDK's
216
- // periodic save hook stays disabled. Shutdown uses flush() for a final sync.
217
- return false;
218
- }
219
-
220
- override async deleteAllData(): Promise<void> {
221
- if (this.persistTimer) {
222
- clearTimeout(this.persistTimer);
223
- this.persistTimer = null;
224
- }
225
- this.dirty = false;
226
- await this.persistPromise?.catch(() => undefined);
227
- await super.deleteAllData();
228
- this.savedSync = null;
229
- this.savedClientOptions = undefined;
230
- this.cleanShutdown = false;
231
- await fs.rm(this.storagePath, { force: true }).catch(() => undefined);
232
- }
233
-
234
- markCleanShutdown(): void {
235
- this.cleanShutdown = true;
236
- this.dirty = true;
237
- }
238
-
239
- async flush(): Promise<void> {
240
- if (this.persistTimer) {
241
- clearTimeout(this.persistTimer);
242
- this.persistTimer = null;
243
- }
244
- while (this.dirty || this.persistPromise) {
245
- if (this.dirty && !this.persistPromise) {
246
- this.persistPromise = this.persist().finally(() => {
247
- this.persistPromise = null;
248
- });
249
- }
250
- await this.persistPromise;
251
- }
252
- }
253
-
254
- private markDirtyAndSchedulePersist(): void {
255
- this.cleanShutdown = false;
256
- this.dirty = true;
257
- if (this.persistTimer) {
258
- return;
259
- }
260
- this.persistTimer = setTimeout(() => {
261
- this.persistTimer = null;
262
- void this.flush().catch((err) => {
263
- LogService.warn("MatrixFileSyncStore", "Failed to persist Matrix sync store:", err);
264
- });
265
- }, PERSIST_DEBOUNCE_MS);
266
- this.persistTimer.unref?.();
267
- }
268
-
269
- private async persist(): Promise<void> {
270
- this.dirty = false;
271
- const payload: PersistedMatrixSyncStore = {
272
- version: STORE_VERSION,
273
- savedSync: this.savedSync ? cloneJson(this.savedSync) : null,
274
- cleanShutdown: this.cleanShutdown,
275
- ...(this.savedClientOptions ? { clientOptions: cloneJson(this.savedClientOptions) } : {}),
276
- };
277
- try {
278
- await this.persistLock(async () => {
279
- await writeJsonFileAtomically(this.storagePath, payload);
280
- claimCurrentTokenStorageState({
281
- rootDir: path.dirname(this.storagePath),
282
- });
283
- });
284
- } catch (err) {
285
- this.dirty = true;
286
- throw err;
287
- }
288
- }
289
- }
@@ -1,140 +0,0 @@
1
- import { logger as matrixJsSdkRootLogger } from "matrix-js-sdk/lib/logger.js";
2
- import { ConsoleLogger, LogService, setMatrixConsoleLogging } from "../sdk/logger.js";
3
-
4
- let matrixSdkLoggingConfigured = false;
5
- let matrixSdkLogMode: "default" | "quiet" = "default";
6
- const matrixSdkBaseLogger = new ConsoleLogger();
7
- let matrixJsSdkRootLoggerSnapshot: MatrixJsSdkRootLoggerSnapshot | null = null;
8
-
9
- type MatrixJsSdkLogger = {
10
- trace: (...messageOrObject: unknown[]) => void;
11
- debug: (...messageOrObject: unknown[]) => void;
12
- info: (...messageOrObject: unknown[]) => void;
13
- warn: (...messageOrObject: unknown[]) => void;
14
- error: (...messageOrObject: unknown[]) => void;
15
- getChild: (namespace: string) => MatrixJsSdkLogger;
16
- };
17
-
18
- type MatrixJsSdkLoglevelLogger = {
19
- getLevel?: () => number | string;
20
- methodFactory?: unknown;
21
- rebuild?: () => void;
22
- setLevel?: (level: number | string, persist?: boolean) => void;
23
- };
24
-
25
- type MatrixJsSdkRootLoggerSnapshot = {
26
- level?: number | string;
27
- methodFactory?: unknown;
28
- };
29
-
30
- function shouldSuppressMatrixHttpNotFound(module: string, messageOrObject: unknown[]): boolean {
31
- if (!module.includes("MatrixHttpClient")) {
32
- return false;
33
- }
34
- return messageOrObject.some((entry) => {
35
- if (!entry || typeof entry !== "object") {
36
- return false;
37
- }
38
- return (entry as { errcode?: string }).errcode === "M_NOT_FOUND";
39
- });
40
- }
41
-
42
- export function ensureMatrixSdkLoggingConfigured(): void {
43
- if (!matrixSdkLoggingConfigured) {
44
- matrixSdkLoggingConfigured = true;
45
- }
46
- applyMatrixSdkLogger();
47
- }
48
-
49
- export function setMatrixSdkLogMode(mode: "default" | "quiet"): void {
50
- matrixSdkLogMode = mode;
51
- if (!matrixSdkLoggingConfigured) {
52
- return;
53
- }
54
- applyMatrixSdkLogger();
55
- }
56
-
57
- export function setMatrixSdkConsoleLogging(enabled: boolean): void {
58
- setMatrixConsoleLogging(enabled);
59
- }
60
-
61
- export function createMatrixJsSdkClientLogger(prefix = "matrix"): MatrixJsSdkLogger {
62
- return createMatrixJsSdkLoggerInstance(prefix);
63
- }
64
-
65
- function applyMatrixSdkLogger(): void {
66
- if (matrixSdkLogMode === "quiet") {
67
- setMatrixJsSdkRootLoggerLevel("silent");
68
- LogService.setLogger({
69
- trace: () => {},
70
- debug: () => {},
71
- info: () => {},
72
- warn: () => {},
73
- error: () => {},
74
- });
75
- return;
76
- }
77
-
78
- setMatrixJsSdkRootLoggerLevel("debug");
79
- LogService.setLogger({
80
- trace: (module, ...messageOrObject) => matrixSdkBaseLogger.trace(module, ...messageOrObject),
81
- debug: (module, ...messageOrObject) => matrixSdkBaseLogger.debug(module, ...messageOrObject),
82
- info: (module, ...messageOrObject) => matrixSdkBaseLogger.info(module, ...messageOrObject),
83
- warn: (module, ...messageOrObject) => matrixSdkBaseLogger.warn(module, ...messageOrObject),
84
- error: (module, ...messageOrObject) => {
85
- if (shouldSuppressMatrixHttpNotFound(module, messageOrObject)) {
86
- return;
87
- }
88
- matrixSdkBaseLogger.error(module, ...messageOrObject);
89
- },
90
- });
91
- }
92
-
93
- function setMatrixJsSdkRootLoggerLevel(level: "debug" | "silent"): void {
94
- const logger = matrixJsSdkRootLogger as unknown as MatrixJsSdkLoglevelLogger;
95
- matrixJsSdkRootLoggerSnapshot ??= {
96
- level: logger.getLevel?.(),
97
- methodFactory: logger.methodFactory,
98
- };
99
- if (level === "silent") {
100
- logger.methodFactory = () => () => undefined;
101
- logger.setLevel?.("silent", false);
102
- logger.rebuild?.();
103
- return;
104
- }
105
- logger.methodFactory = matrixJsSdkRootLoggerSnapshot.methodFactory;
106
- const previousLevel = matrixJsSdkRootLoggerSnapshot.level;
107
- if (typeof previousLevel === "string" || typeof previousLevel === "number") {
108
- logger.setLevel?.(previousLevel, false);
109
- }
110
- logger.rebuild?.();
111
- }
112
-
113
- function createMatrixJsSdkLoggerInstance(prefix: string): MatrixJsSdkLogger {
114
- const log = (method: keyof ConsoleLogger, ...messageOrObject: unknown[]): void => {
115
- if (matrixSdkLogMode === "quiet") {
116
- return;
117
- }
118
- (matrixSdkBaseLogger[method] as (module: string, ...args: unknown[]) => void)(
119
- prefix,
120
- ...messageOrObject,
121
- );
122
- };
123
-
124
- return {
125
- trace: (...messageOrObject) => log("trace", ...messageOrObject),
126
- debug: (...messageOrObject) => log("debug", ...messageOrObject),
127
- info: (...messageOrObject) => log("info", ...messageOrObject),
128
- warn: (...messageOrObject) => log("warn", ...messageOrObject),
129
- error: (...messageOrObject) => {
130
- if (shouldSuppressMatrixHttpNotFound(prefix, messageOrObject)) {
131
- return;
132
- }
133
- log("error", ...messageOrObject);
134
- },
135
- getChild: (namespace: string) => {
136
- const nextNamespace = namespace.trim();
137
- return createMatrixJsSdkLoggerInstance(nextNamespace ? `${prefix}.${nextNamespace}` : prefix);
138
- },
139
- };
140
- }
@@ -1 +0,0 @@
1
- export { maybeCreateMatrixMigrationSnapshot } from "../../migration-snapshot-backup.js";
@@ -1 +0,0 @@
1
- export { isPrivateOrLoopbackHost } from "klaw/plugin-sdk/ssrf-runtime";
@@ -1,4 +0,0 @@
1
- export function isBunRuntime(): boolean {
2
- const versions = process.versions as { bun?: string };
3
- return typeof versions.bun === "string";
4
- }