@voltro/testing 0.81.0 → 0.83.0

package/dist/platform.d.ts

@@ -0,0 +1,14 @@
+import { PlatformAdapter } from '@voltro/client';
+
+/** Register the conformance suite with vitest. */
+export declare const platformAdapterConformance: (name: string, options: PlatformConformanceOptions) => void;
+
+export declare interface PlatformConformanceOptions {
+    /** Build (or return) the adapter under test. Called once per suite. */
+    readonly adapter: () => PlatformAdapter | Promise<PlatformAdapter>;
+    /** A key the suite may write to `storage` / `secureStorage`. Default
+     *  `voltro:conformance`. */
+    readonly scratchKey?: string;
+}
+
+export { }

package/dist/platform.js

@@ -0,0 +1,46 @@
+import { describe as e, expect as t, it as n } from "vitest";
+//#region src/platformConformance.ts
+var r = (r, i) => {
+	let a = i.scratchKey ?? "voltro:conformance", o = async () => i.adapter();
+	e(`platform adapter conformance — ${r}`, () => {
+		n("describes itself: platform info + derived capabilities are complete", async () => {
+			let e = await o();
+			t(typeof e.platform.kind).toBe("string"), t(typeof e.platform.shell).toBe("string"), t(typeof e.platform.installed).toBe("boolean");
+			for (let [n, r] of Object.entries(e.capabilities)) t(typeof r, `capability ${n}`).toBe("boolean");
+			t(Number.isFinite(e.clock.now())).toBe(!0);
+		}), n("storage: the local area is a synchronous store that reads back what it wrote", async () => {
+			let e = await o(), n = e.storage("local");
+			if (n === null) {
+				t(e.storage("session")).toBeNull();
+				return;
+			}
+			n.setItem(a, "v1"), t(n.getItem(a)).toBe("v1"), n.removeItem?.(a);
+		}), n("secureStorage: honours its declared kind", async () => {
+			let e = await o();
+			e.capabilities.secureTokenStorage ? (t(e.secureStorage.kind).not.toBe("none"), await e.secureStorage.set(a, "secret"), t(await e.secureStorage.get(a)).toBe("secret"), await e.secureStorage.delete(a), t(await e.secureStorage.get(a)).toBeNull()) : (t(e.secureStorage.kind).toBe("none"), t(await e.secureStorage.get(a)).toBeNull(), await t(e.secureStorage.set(a, "secret")).rejects.toThrow());
+		}), n("online: a boolean read and a subscription that can be torn down", async () => {
+			let e = await o();
+			t(typeof e.online.read()).toBe("boolean");
+			let n = e.online.subscribe(() => {});
+			t(typeof n).toBe("function"), n();
+		}), n("lifecycle: one of active/inactive/background, subscribable", async () => {
+			let e = await o();
+			t([
+				"active",
+				"inactive",
+				"background"
+			]).toContain(e.lifecycle.read()), e.lifecycle.subscribe(() => {})();
+		}), n("links: an initial URL (or null) and a subscription", async () => {
+			let e = await o(), n = await e.links.initialUrl();
+			t(n === null || typeof n == "string").toBe(!0), e.links.subscribe(() => {})();
+		}), n("capabilities never claim a port that is absent", async () => {
+			let e = await o();
+			e.capabilities.push && t(e.notifications?.pushToken).toBeTypeOf("function"), e.capabilities.localNotifications && t(e.notifications?.show).toBeTypeOf("function"), e.capabilities.updates && t(e.updates).toBeDefined(), e.capabilities.biometrics && t(e.biometrics).toBeDefined(), e.capabilities.secureTokenStorage && t(e.secureStorage.kind).not.toBe("none"), e.capabilities.installPrompt && t(e.platform.installed).toBe(!1);
+		}), n("webSocket is a constructor function (the api runtime injects it)", async () => {
+			let e = await o();
+			t(typeof e.webSocket).toBe("function");
+		});
+	});
+};
+//#endregion
+export { r as platformAdapterConformance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/testing",
-  "version": "0.81.0",
+  "version": "0.83.0",
   "description": "Test utilities for Voltro apps — deterministic clock, subject and row factories, a handler-level invoke and a request-level app harness, queued LLM responses, scoped subject/tenant runners, and a cross-dialect parity harness.",
   "keywords": [
     "voltro",
@@ -33,6 +33,11 @@
       "import": "./dist/client.js",
       "default": "./dist/client.js"
     },
+    "./platform": {
+      "types": "./dist/platform.d.ts",
+      "import": "./dist/platform.js",
+      "default": "./dist/platform.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",
@@ -43,16 +48,16 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.81.0",
-    "@voltro/env": "0.81.0",
-    "@voltro/logger": "0.81.0",
-    "@voltro/protocol": "0.81.0",
-    "@voltro/runtime": "0.81.0",
-    "@voltro/workflow": "0.81.0"
+    "@voltro/database": "0.83.0",
+    "@voltro/env": "0.83.0",
+    "@voltro/logger": "0.83.0",
+    "@voltro/protocol": "0.83.0",
+    "@voltro/runtime": "0.83.0",
+    "@voltro/workflow": "0.83.0"
   },
   "peerDependencies": {
     "@effect/sql": "^0.52.1",
-    "@voltro/client": "0.81.0",
+    "@voltro/client": "0.83.0",
     "effect": "^3.22.2",
     "react": "^19.0.0"
   },