chore: more examples

Author: krizzu

examples/example-web/.gitignore examples/common-tests/.gitignoreexamples/example-web/.gitignore renamed to examples/common-tests/.gitignore

@@ -0,0 +1,24 @@
+{
+  "name": "example-common-tests",
+  "version": "0.0.1",
+  "private": true,
+  "main": "src/index.ts",
+  "installConfig": {
+    "hoistingLimits": "workspaces"
+  },
+  "scripts": {
+    "test:lint": "eslint .",
+    "test:ts": "tsc"
+  },
+  "dependencies": {
+    "@react-native-async-storage/async-storage": "workspace:*",
+    "react": "19.0.0"
+  },
+  "devDependencies": {
+    "@react-native-async-storage/eslint-config": "workspace:*",
+    "@types/react": "^19.0.0",
+    "eslint": "9.34.0",
+    "prettier": "3.6.2",
+    "typescript": "5.9.2"
+  }
+}

…es/example-react-native/eslint.config.js examples/common-tests/eslint.config.jsexamples/example-react-native/eslint.config.js renamed to examples/common-tests/eslint.config.js examples/example-react-native/eslint.config.js renamed to examples/common-tests/eslint.config.js

@@ -0,0 +1 @@
+export { useBasicTest } from "./tests/BasicTests";

examples/common-tests/package.json

@@ -0,0 +1,131 @@
+import type { AsyncStorage } from "@react-native-async-storage/async-storage";
+import { useLogs, type TestLogs } from "../useLogs";
+
+type Test = {
+  run: () => void;
+  name: string;
+};
+
+export function useBasicTest(storage: AsyncStorage): {
+  logs: TestLogs;
+  tests: Test[];
+} {
+  const logs = useLogs();
+
+  const testSingleSetCrudKey = async () => {
+    try {
+      const key = "single-set";
+      let value = `value-${Math.round(Math.random() * 1000)}`;
+
+      logs.add(`setting ${key} with value ${value}`);
+      await storage.setItem(key, value);
+      logs.add(`stored ${key} value:`, await storage.getItem(key));
+
+      let keysToFetch = [key, "missing-key-1", "missing-key-2"];
+      logs.add(
+        `fetching keys (${keysToFetch}): `,
+        await storage.getMany(keysToFetch)
+      );
+
+      logs.add(`all keys: `, await storage.getAllKeys());
+
+      logs.add(`removing ${key}`);
+      await storage.removeItem(key);
+      logs.add(`current ${key} value:`, await storage.getItem(key));
+
+      value = `value-${Math.round(Math.random() * 1000)}`;
+      logs.add(`Saving new ${key} value: ${value}`);
+      await storage.setItem(key, value);
+      logs.add(`current ${key} value:`, await storage.getItem(key));
+
+      value = `value-${Math.round(Math.random() * 1000)}`;
+      logs.add(`Overriding n ${key} value: ${value}`);
+      await storage.setItem(key, value);
+      logs.add(`current ${key} value:`, await storage.getItem(key));
+
+      keysToFetch = [key, "missing-key-1", "missing-key-2"];
+      logs.add(
+        `fetching keys (${keysToFetch}): `,
+        await storage.getMany(keysToFetch)
+      );
+    } catch (e) {
+      logs.report(e);
+    }
+  };
+
+  const testMultiKey = async () => {
+    try {
+      const entries = { key1: "value1", key2: "42", key3: "true" };
+      logs.add("MultiSet test with entries:", entries);
+      await storage.setMany(entries);
+      logs.add("fetching keys", ["key1", "key2", "key3", "missing"]);
+      const values = await storage.getMany(["key1", "key2", "key3", "missing"]);
+      logs.add("result", values);
+
+      logs.add("removing key1 and key2");
+      await storage.removeMany(["key1", "key2"]);
+      const remainingKeys = await storage.getAllKeys();
+      logs.add("remaining keys after removing:", remainingKeys);
+
+      const final = await storage.getMany(remainingKeys);
+      logs.add("get many remaining values:", final);
+    } catch (e) {
+      logs.report(e);
+    }
+  };
+
+  const saveBigData = async () => {
+    try {
+      const key = "big-data";
+      const data = JSON.stringify(new Array(500_000).fill("a"));
+      logs.add(`Saving ${key} with data size ${data.length}`);
+      const timeNow = +Date.now();
+      await storage.setItem(key, data);
+      logs.add(`saving took ${+Date.now() - timeNow}ms`);
+
+      logs.add(`reading ${key}`);
+      const res = await storage.getItem(key);
+      logs.add(`size of result: ${res?.length}`);
+    } catch (e) {
+      logs.report(e);
+    }
+  };
+
+  const clearStorage = async () => {
+    try {
+      logs.add("Currently stored keys: ", await storage.getAllKeys());
+
+      logs.add("deleting everything");
+      storage.clear();
+      logs.add("keys after deletion: ", await storage.getAllKeys());
+      logs.add("saving some values");
+
+      await storage.setItem("key-after-delete", "my item");
+      logs.add("keys after saving: ", await storage.getAllKeys());
+    } catch (e) {
+      logs.report(e);
+    }
+  };
+
+  return {
+    logs,
+    tests: [
+      {
+        name: "Single key set",
+        run: testSingleSetCrudKey,
+      },
+      {
+        name: "Multiple key sets",
+        run: testMultiKey,
+      },
+      {
+        name: "Big data set",
+        run: saveBigData,
+      },
+      {
+        name: "Storage clearance",
+        run: clearStorage,
+      },
+    ],
+  };
+}

examples/common-tests/src/index.ts

@@ -0,0 +1,35 @@
+import { useState } from "react";
+
+export type TestLogs = ReturnType<typeof useLogs>;
+
+export function useLogs() {
+  const [logs, setLogs] = useState<string[]>([]);
+
+  function addLog(...text: any[]) {
+    const message = text
+      .map((t) => {
+        if (typeof t !== "string") {
+          return JSON.stringify(t, null, 2);
+        }
+        return t;
+      })
+      .join(" ");
+
+    setLogs((l) => [...l, message]);
+  }
+
+  function clearLog() {
+    setLogs([]);
+  }
+
+  function reportError(e: any) {
+    alert(JSON.stringify(e, null, 2));
+  }
+
+  return {
+    logs,
+    add: addLog,
+    clear: clearLog,
+    report: reportError,
+  };
+}