@telecrypt-io/storage 0.4.0 → 0.5.8

package/dist/core/poll.d.ts

@@ -8,7 +8,8 @@
  * the client's own live background sync loop (already running in this
  * process since TeleCryptIOStorage.create() started it).
  */
-export declare function waitForCondition<T>(check: () => T | null | undefined, opts?: {
+export declare function waitForCondition<T>(check: (signal?: AbortSignal) => T | null | undefined | Promise<T | null | undefined>, opts?: {
     timeoutMs?: number;
     intervalMs?: number;
+    signal?: AbortSignal;
 }): Promise<T>;

package/dist/core/poll.js

@@ -12,13 +12,69 @@ export async function waitForCondition(check, opts) {
     const timeoutMs = opts?.timeoutMs ?? 15000;
     const intervalMs = opts?.intervalMs ?? 300;
     const deadline = Date.now() + timeoutMs;
+    const timeoutError = () => new Error(`timed out after ${timeoutMs}ms waiting for condition`);
+    const abortError = () => {
+        const reason = opts?.signal?.reason;
+        return reason instanceof Error ? reason : new Error("condition wait aborted");
+    };
     for (;;) {
-        const result = check();
+        if (opts?.signal?.aborted)
+            throw abortError();
+        const remaining = deadline - Date.now();
+        if (remaining < 0)
+            throw timeoutError();
+        // A condition check may perform I/O. Awaiting it directly would make the
+        // outer timeout ineffective when that I/O hangs forever. The per-attempt
+        // controller gives checks that support AbortSignal a chance to stop, while
+        // the race still bounds checks that do not.
+        const checkController = new AbortController();
+        let timer;
+        const abortFromCaller = () => checkController.abort(opts?.signal?.reason);
+        opts?.signal?.addEventListener("abort", abortFromCaller, { once: true });
+        const checkPromise = Promise.resolve().then(() => check(checkController.signal));
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                checkController.abort();
+                reject(timeoutError());
+            }, remaining);
+        });
+        let callerAbort;
+        const callerAbortPromise = new Promise((_, reject) => {
+            callerAbort = () => reject(abortError());
+            opts?.signal?.addEventListener("abort", callerAbort, { once: true });
+        });
+        let result;
+        try {
+            result = await Promise.race([checkPromise, timeoutPromise, callerAbortPromise]);
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            opts?.signal?.removeEventListener("abort", abortFromCaller);
+            if (callerAbort)
+                opts?.signal?.removeEventListener("abort", callerAbort);
+        }
         if (result !== null && result !== undefined)
             return result;
         if (Date.now() >= deadline) {
-            throw new Error(`timed out after ${timeoutMs}ms waiting for condition`);
+            throw timeoutError();
         }
-        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        const delay = Math.min(intervalMs, deadline - Date.now());
+        await new Promise((resolve, reject) => {
+            let timer;
+            const onAbort = () => {
+                clearTimeout(timer);
+                opts?.signal?.removeEventListener("abort", onAbort);
+                reject(abortError());
+            };
+            const done = () => {
+                opts?.signal?.removeEventListener("abort", onAbort);
+                resolve();
+            };
+            timer = setTimeout(done, Math.max(0, delay));
+            opts?.signal?.addEventListener("abort", onAbort, { once: true });
+            if (opts?.signal?.aborted)
+                onAbort();
+        });
     }
 }

package/dist/core/types.d.ts

@@ -53,6 +53,20 @@ export interface RecoveryRestore {
     imported: number;
     total: number;
 }
+/** One atomic recovery topology snapshot used to decide whether setup is safe. */
+export interface RecoveryStatus {
+    state: "unconfigured" | "ready" | "partial";
+    crossSigning: {
+        publicKeysOnDevice: boolean;
+        privateKeysCachedLocally: boolean;
+        privateKeysInSecretStorage: boolean;
+    };
+    secretStorage: {
+        ready: boolean;
+        defaultKeyId: string | null;
+    };
+    backupVersion: string | null;
+}
 export interface FileDetails {
     name: string;
     mimetype: string | null;

package/dist/core/validation.d.ts

@@ -0,0 +1,3 @@
+/** Small shared input validators kept out of the public core barrel. */
+export declare const MAX_NAME_LENGTH = 512;
+export declare function validateName(value: unknown, label: string): asserts value is string;

package/dist/core/validation.js

@@ -0,0 +1,10 @@
+/** Small shared input validators kept out of the public core barrel. */
+export const MAX_NAME_LENGTH = 512;
+export function validateName(value, label) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value.length > MAX_NAME_LENGTH ||
+        /[\u0000-\u001f\u007f]/.test(value)) {
+        throw new Error(`invalid ${label}`);
+    }
+}

package/dist/index.d.ts

@@ -1 +1,3 @@
 export { TeleCryptIOStorage } from "./TeleCryptIOStorage.js";
+/** The full platform-agnostic surface for user-facing clients. */
+export * from "./core/index.js";

package/dist/index.js

@@ -1 +1,3 @@
 export { TeleCryptIOStorage } from "./TeleCryptIOStorage.js";
+/** The full platform-agnostic surface for user-facing clients. */
+export * from "./core/index.js";

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@telecrypt-io/storage",
-  "version": "0.4.0",
+  "version": "0.5.8",
   "license": "BUSL-1.1",
   "type": "module",
+  "packageManager": "npm@10.9.8",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -20,12 +21,16 @@
     "README.md",
     "LICENSE"
   ],
+  "engines": {
+    "node": "22.23.2"
+  },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "scripts": {
     "build": "tsc",
+    "typecheck:tests": "tsc -p tsconfig.test.json",
     "lint": "eslint src test --ext .ts",
     "test": "vitest run",
     "test:unit": "vitest run --config vitest.unit.config.ts",
@@ -36,19 +41,16 @@
   },
   "dependencies": {
     "matrix-encrypt-attachment": "1.0.3",
-    "matrix-js-sdk": "41.9.0",
-    "oidc-client-ts": "3.5.0"
+    "matrix-js-sdk": "42.2.0"
   },
   "devDependencies": {
-    "@playwright/test": "1.61.1",
     "@types/node": "22.20.1",
-    "@typescript-eslint/eslint-plugin": "8.64.0",
-    "@typescript-eslint/parser": "8.64.0",
-    "eslint": "10.8.0",
+    "@typescript-eslint/eslint-plugin": "8.67.0",
+    "@typescript-eslint/parser": "8.67.0",
+    "eslint": "10.9.0",
     "fake-indexeddb": "6.2.5",
-    "tsx": "4.23.1",
     "typescript": "5.9.3",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "repository": {
     "type": "git",