qumra-pos-storage 0.1.0

package/dist/chunk-HXRUTEU7.js

@@ -0,0 +1,163 @@
+// src/conformance/assert.ts
+function assert(cond, msg) {
+  if (!cond) throw new Error(`conformance: ${msg}`);
+}
+function assertEqual(actual, expected, msg) {
+  const a = JSON.stringify(actual);
+  const e = JSON.stringify(expected);
+  if (a !== e) {
+    throw new Error(`conformance: ${msg} \u2014 \u0627\u0644\u0645\u062A\u0648\u0642\u0639 ${e} \u0644\u0643\u0646 \u062C\u0647 ${a}`);
+  }
+}
+function bytesEqual(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+  return true;
+}
+async function assertThrows(fn, msg) {
+  let threw = false;
+  try {
+    await fn();
+  } catch {
+    threw = true;
+  }
+  assert(threw, msg);
+}
+
+// src/conformance/cases.ts
+async function withAdapter(make, body) {
+  const adapter = await make();
+  try {
+    await body(adapter);
+  } finally {
+    await adapter.close();
+  }
+}
+var CONFORMANCE_CASES = [
+  {
+    name: "execute + query: \u0625\u0646\u0634\u0627\u0621 \u0648\u0625\u062F\u0631\u0627\u062C \u0648\u0642\u0631\u0627\u0621\u0629",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER PRIMARY KEY, name TEXT)");
+      await a.execute("INSERT INTO t (id, name) VALUES (?, ?)", [1, "\u0642\u0647\u0648\u0629"]);
+      const rows = await a.query(
+        "SELECT id, name FROM t"
+      );
+      assertEqual(rows, [{ id: 1, name: "\u0642\u0647\u0648\u0629" }], "\u0635\u0641 \u0648\u0627\u062D\u062F \u0628\u0627\u0644\u0642\u064A\u0645 \u0627\u0644\u0635\u062D");
+    })
+  },
+  {
+    name: "\u0627\u0644\u0645\u0639\u0627\u0645\u0644\u0627\u062A: string / number / null / blob \u062A\u062A\u0631\u0628\u0637 \u0648\u062A\u0631\u062C\u0639 \u0635\u062D",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute(
+        "CREATE TABLE t (id INTEGER, s TEXT, n REAL, z TEXT, b BLOB)"
+      );
+      const blob = new Uint8Array([0, 255, 16, 200]);
+      await a.execute("INSERT INTO t (id, s, n, z, b) VALUES (?, ?, ?, ?, ?)", [
+        7,
+        "\u0646\u0635",
+        12.5,
+        null,
+        blob
+      ]);
+      const rows = await a.query("SELECT id, s, n, z, b FROM t WHERE id = ?", [7]);
+      assert(rows.length === 1, "\u0635\u0641 \u0648\u0627\u062D\u062F");
+      const r = rows[0];
+      assertEqual(
+        { id: r.id, s: r.s, n: r.n, z: r.z },
+        { id: 7, s: "\u0646\u0635", n: 12.5, z: null },
+        "\u0627\u0644\u0642\u064A\u0645 \u063A\u064A\u0631 \u0627\u0644\u0640 blob"
+      );
+      assert(
+        bytesEqual(new Uint8Array(r.b), blob),
+        "\u0627\u0644\u0640 blob \u064A\u0631\u062C\u0639 \u0628\u0646\u0641\u0633 \u0627\u0644\u0628\u0627\u064A\u062A\u0627\u062A"
+      );
+    })
+  },
+  {
+    name: "execute \u0645\u0646 \u063A\u064A\u0631 params \u064A\u0646\u0641\u0651\u0630 \u0623\u0643\u062A\u0631 \u0645\u0646 statement (DDL/migrations)",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute(`
+          CREATE TABLE a (id INTEGER);
+          CREATE TABLE b (id INTEGER);
+          INSERT INTO a (id) VALUES (1);
+          INSERT INTO b (id) VALUES (2);
+        `);
+      const ra = await a.query("SELECT id FROM a");
+      const rb = await a.query("SELECT id FROM b");
+      assertEqual([ra, rb], [[{ id: 1 }], [{ id: 2 }]], "\u0627\u0644\u062C\u062F\u0648\u0644\u064A\u0646 \u0627\u062A\u0639\u0645\u0644\u0648\u0627");
+    })
+  },
+  {
+    name: "transaction \u0628\u062A\u0639\u0645\u0644 commit \u0639\u0646\u062F \u0627\u0644\u0646\u062C\u0627\u062D",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      await a.transaction(async (tx) => {
+        await tx.execute("INSERT INTO t (id) VALUES (1)");
+        await tx.execute("INSERT INTO t (id) VALUES (2)");
+      });
+      const rows = await a.query("SELECT id FROM t ORDER BY id");
+      assertEqual(rows, [{ id: 1 }, { id: 2 }], "\u0627\u0644\u0635\u0641\u064A\u0646 \u0627\u062A\u062B\u0628\u062A\u0648\u0627 \u0628\u0639\u062F \u0627\u0644\u0640 commit");
+    })
+  },
+  {
+    name: "transaction \u0628\u062A\u0639\u0645\u0644 rollback \u0639\u0646\u062F \u0623\u064A throw (atomic) \u0648\u062A\u0639\u064A\u062F \u0627\u0644\u0631\u0645\u064A",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      await assertThrows(
+        () => a.transaction(async (tx) => {
+          await tx.execute("INSERT INTO t (id) VALUES (1)");
+          throw new Error("\u0641\u0634\u0644 \u0645\u0642\u0635\u0648\u062F \u0648\u0633\u0637 \u0627\u0644\u0640 transaction");
+        }),
+        "\u0627\u0644\u0640 transaction \u0628\u062A\u0631\u0645\u064A \u0627\u0644\u062E\u0637\u0623 \u0628\u0631\u0647"
+      );
+      const rows = await a.query("SELECT id FROM t");
+      assertEqual(rows, [], "\u0645\u0641\u064A\u0634 \u0623\u064A \u0635\u0641 \u0627\u062A\u0643\u062A\u0628 \u2014 \u0627\u062A\u0639\u0645\u0644 rollback \u0644\u0644\u0643\u0644");
+    })
+  },
+  {
+    name: "transaction \u0628\u062A\u0631\u062C\u0651\u0639 \u0642\u064A\u0645\u0629 \u0627\u0644\u0640 callback",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      const value = await a.transaction(async (tx) => {
+        await tx.execute("INSERT INTO t (id) VALUES (42)");
+        const rows = await tx.query("SELECT id FROM t");
+        return rows[0].id;
+      });
+      assertEqual(value, 42, "\u0627\u0644\u0642\u064A\u0645\u0629 \u0627\u0644\u0631\u0627\u062C\u0639\u0629 \u0645\u0646 \u0627\u0644\u0640 callback");
+    })
+  },
+  {
+    name: "read-your-writes: \u0627\u0644\u0640 tx \u0628\u064A\u0634\u0648\u0641 \u0643\u062A\u0627\u0628\u0627\u062A\u0647 \u0642\u0628\u0644 \u0627\u0644\u0640 commit",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      await a.transaction(async (tx) => {
+        await tx.execute("INSERT INTO t (id) VALUES (5)");
+        const rows = await tx.query("SELECT id FROM t");
+        assertEqual(rows, [{ id: 5 }], "\u0627\u0644\u0627\u0633\u062A\u0639\u0644\u0627\u0645 \u062C\u0648\u0647 \u0627\u0644\u0640 tx \u0628\u064A\u0634\u0648\u0641 \u0627\u0644\u0625\u062F\u0631\u0627\u062C");
+      });
+    })
+  },
+  {
+    name: "INSERT OR REPLACE: upsert (\u064A\u0633\u062A\u062E\u062F\u0645\u0647 \u0627\u0644\u0640 pull)",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER PRIMARY KEY, v TEXT)");
+      await a.execute("INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)", [1, "\u0623\u0648\u0644"]);
+      await a.execute("INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)", [1, "\u062A\u0627\u0646\u064A"]);
+      const rows = await a.query("SELECT id, v FROM t");
+      assertEqual(rows, [{ id: 1, v: "\u062A\u0627\u0646\u064A" }], "\u0627\u0644\u0635\u0641 \u0627\u062A\u0633\u062A\u0628\u062F\u0644 \u0645\u0634 \u0627\u062A\u0643\u0631\u0651\u0631");
+    })
+  }
+];
+
+// src/conformance/index.ts
+function runAdapterConformance(label, make, harness) {
+  harness.describe(`StorageAdapter conformance \u2014 ${label}`, () => {
+    for (const c of CONFORMANCE_CASES) {
+      harness.it(c.name, () => c.run(make));
+    }
+  });
+}
+
+export { CONFORMANCE_CASES, assert, assertEqual, assertThrows, bytesEqual, runAdapterConformance };
+//# sourceMappingURL=chunk-HXRUTEU7.js.map
+//# sourceMappingURL=chunk-HXRUTEU7.js.map

package/dist/chunk-HXRUTEU7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/conformance/assert.ts","../src/conformance/cases.ts","../src/conformance/index.ts"],"names":[],"mappings":"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","file":"chunk-HXRUTEU7.js","sourcesContent":["/**\n * assertions صغيرة مستقلة عن أي test runner — علشان نفس الـ conformance cases\n * تشتغل تحت vitest (Node) و Playwright (المتصفح، لـ wa-sqlite) من غير تغيير.\n * الفشل = throw.\n */\nexport function assert(cond: unknown, msg: string): asserts cond {\n  if (!cond) throw new Error(`conformance: ${msg}`);\n}\n\nexport function assertEqual(actual: unknown, expected: unknown, msg: string): void {\n  const a = JSON.stringify(actual);\n  const e = JSON.stringify(expected);\n  if (a !== e) {\n    throw new Error(`conformance: ${msg} — المتوقع ${e} لكن جه ${a}`);\n  }\n}\n\nexport function bytesEqual(a: Uint8Array, b: Uint8Array): boolean {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;\n  return true;\n}\n\n/** يتأكد إن fn رمت (للتحقق من الـ rollback / إعادة الرمي). */\nexport async function assertThrows(\n  fn: () => Promise<unknown>,\n  msg: string,\n): Promise<void> {\n  let threw = false;\n  try {\n    await fn();\n  } catch {\n    threw = true;\n  }\n  assert(threw, msg);\n}\n","import type { StorageAdapter } from \"../ports/StorageAdapter\";\nimport { assert, assertEqual, assertThrows, bytesEqual } from \"./assert\";\n\n/** بيرجّع adapter جديد فاضي (مفضّل :memory:) لكل حالة. */\nexport type MakeAdapter = () => Promise<StorageAdapter> | StorageAdapter;\n\nexport interface ConformanceCase {\n  name: string;\n  run(make: MakeAdapter): Promise<void>;\n}\n\n/** helper: يفتح adapter، ينفّذ الجسم، ويقفل مهما حصل. */\nasync function withAdapter(\n  make: MakeAdapter,\n  body: (a: StorageAdapter) => Promise<void>,\n): Promise<void> {\n  const adapter = await make();\n  try {\n    await body(adapter);\n  } finally {\n    await adapter.close();\n  }\n}\n\n/**\n * بطارية العقد اللي أي StorageAdapter لازم يعدّيها قبل الدمج. بتختبر عقد الـ\n * adapter نفسه (execute/query/params/transaction/close) — مش الـ repositories.\n */\nexport const CONFORMANCE_CASES: ConformanceCase[] = [\n  {\n    name: \"execute + query: إنشاء وإدراج وقراءة\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER PRIMARY KEY, name TEXT)\");\n        await a.execute(\"INSERT INTO t (id, name) VALUES (?, ?)\", [1, \"قهوة\"]);\n        const rows = await a.query<{ id: number; name: string }>(\n          \"SELECT id, name FROM t\",\n        );\n        assertEqual(rows, [{ id: 1, name: \"قهوة\" }], \"صف واحد بالقيم الصح\");\n      }),\n  },\n\n  {\n    name: \"المعاملات: string / number / null / blob تتربط وترجع صح\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\n          \"CREATE TABLE t (id INTEGER, s TEXT, n REAL, z TEXT, b BLOB)\",\n        );\n        const blob = new Uint8Array([0, 255, 16, 200]);\n        await a.execute(\"INSERT INTO t (id, s, n, z, b) VALUES (?, ?, ?, ?, ?)\", [\n          7,\n          \"نص\",\n          12.5,\n          null,\n          blob,\n        ]);\n        const rows = await a.query<{\n          id: number;\n          s: string;\n          n: number;\n          z: string | null;\n          b: Uint8Array;\n        }>(\"SELECT id, s, n, z, b FROM t WHERE id = ?\", [7]);\n        assert(rows.length === 1, \"صف واحد\");\n        const r = rows[0]!;\n        assertEqual(\n          { id: r.id, s: r.s, n: r.n, z: r.z },\n          { id: 7, s: \"نص\", n: 12.5, z: null },\n          \"القيم غير الـ blob\",\n        );\n        assert(\n          bytesEqual(new Uint8Array(r.b), blob),\n          \"الـ blob يرجع بنفس البايتات\",\n        );\n      }),\n  },\n\n  {\n    name: \"execute من غير params ينفّذ أكتر من statement (DDL/migrations)\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(`\n          CREATE TABLE a (id INTEGER);\n          CREATE TABLE b (id INTEGER);\n          INSERT INTO a (id) VALUES (1);\n          INSERT INTO b (id) VALUES (2);\n        `);\n        const ra = await a.query<{ id: number }>(\"SELECT id FROM a\");\n        const rb = await a.query<{ id: number }>(\"SELECT id FROM b\");\n        assertEqual([ra, rb], [[{ id: 1 }], [{ id: 2 }]], \"الجدولين اتعملوا\");\n      }),\n  },\n\n  {\n    name: \"transaction بتعمل commit عند النجاح\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        await a.transaction(async (tx) => {\n          await tx.execute(\"INSERT INTO t (id) VALUES (1)\");\n          await tx.execute(\"INSERT INTO t (id) VALUES (2)\");\n        });\n        const rows = await a.query<{ id: number }>(\"SELECT id FROM t ORDER BY id\");\n        assertEqual(rows, [{ id: 1 }, { id: 2 }], \"الصفين اتثبتوا بعد الـ commit\");\n      }),\n  },\n\n  {\n    name: \"transaction بتعمل rollback عند أي throw (atomic) وتعيد الرمي\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        await assertThrows(\n          () =>\n            a.transaction(async (tx) => {\n              await tx.execute(\"INSERT INTO t (id) VALUES (1)\");\n              throw new Error(\"فشل مقصود وسط الـ transaction\");\n            }),\n          \"الـ transaction بترمي الخطأ بره\",\n        );\n        const rows = await a.query<{ id: number }>(\"SELECT id FROM t\");\n        assertEqual(rows, [], \"مفيش أي صف اتكتب — اتعمل rollback للكل\");\n      }),\n  },\n\n  {\n    name: \"transaction بترجّع قيمة الـ callback\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        const value = await a.transaction(async (tx) => {\n          await tx.execute(\"INSERT INTO t (id) VALUES (42)\");\n          const rows = await tx.query<{ id: number }>(\"SELECT id FROM t\");\n          return rows[0]!.id;\n        });\n        assertEqual(value, 42, \"القيمة الراجعة من الـ callback\");\n      }),\n  },\n\n  {\n    name: \"read-your-writes: الـ tx بيشوف كتاباته قبل الـ commit\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        await a.transaction(async (tx) => {\n          await tx.execute(\"INSERT INTO t (id) VALUES (5)\");\n          const rows = await tx.query<{ id: number }>(\"SELECT id FROM t\");\n          assertEqual(rows, [{ id: 5 }], \"الاستعلام جوه الـ tx بيشوف الإدراج\");\n        });\n      }),\n  },\n\n  {\n    name: \"INSERT OR REPLACE: upsert (يستخدمه الـ pull)\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER PRIMARY KEY, v TEXT)\");\n        await a.execute(\"INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)\", [1, \"أول\"]);\n        await a.execute(\"INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)\", [1, \"تاني\"]);\n        const rows = await a.query<{ id: number; v: string }>(\"SELECT id, v FROM t\");\n        assertEqual(rows, [{ id: 1, v: \"تاني\" }], \"الصف اتستبدل مش اتكرّر\");\n      }),\n  },\n];\n","import { CONFORMANCE_CASES, type MakeAdapter } from \"./cases\";\n\nexport { CONFORMANCE_CASES } from \"./cases\";\nexport type { ConformanceCase, MakeAdapter } from \"./cases\";\nexport { assert, assertEqual, assertThrows, bytesEqual } from \"./assert\";\n\n/**\n * ربط الـ conformance battery بـ vitest. أي adapter جديد (op-sqlite / wa-sqlite)\n * لازم يعدّي دي كلها قبل الدمج:\n *\n *   import { runAdapterConformance } from \"qumra-pos-storage/conformance\";\n *   runAdapterConformance(\"better-sqlite3\", () => BetterSqlite3Adapter.open());\n *\n * الـ describe/it بتتحقن — علشان نفضل مستقلين عن الـ runner (Playwright يقدر\n * يمرّر test.describe/test بتوعه لتشغيل نفس الحالات في المتصفح لـ wa-sqlite).\n */\nexport interface TestHarness {\n  describe(name: string, fn: () => void): void;\n  it(name: string, fn: () => void | Promise<void>): void;\n}\n\nexport function runAdapterConformance(\n  label: string,\n  make: MakeAdapter,\n  harness: TestHarness,\n): void {\n  harness.describe(`StorageAdapter conformance — ${label}`, () => {\n    for (const c of CONFORMANCE_CASES) {\n      harness.it(c.name, () => c.run(make));\n    }\n  });\n}\n"]}

package/dist/conformance.cjs

@@ -0,0 +1,170 @@
+'use strict';
+
+// src/conformance/assert.ts
+function assert(cond, msg) {
+  if (!cond) throw new Error(`conformance: ${msg}`);
+}
+function assertEqual(actual, expected, msg) {
+  const a = JSON.stringify(actual);
+  const e = JSON.stringify(expected);
+  if (a !== e) {
+    throw new Error(`conformance: ${msg} \u2014 \u0627\u0644\u0645\u062A\u0648\u0642\u0639 ${e} \u0644\u0643\u0646 \u062C\u0647 ${a}`);
+  }
+}
+function bytesEqual(a, b) {
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+  return true;
+}
+async function assertThrows(fn, msg) {
+  let threw = false;
+  try {
+    await fn();
+  } catch {
+    threw = true;
+  }
+  assert(threw, msg);
+}
+
+// src/conformance/cases.ts
+async function withAdapter(make, body) {
+  const adapter = await make();
+  try {
+    await body(adapter);
+  } finally {
+    await adapter.close();
+  }
+}
+var CONFORMANCE_CASES = [
+  {
+    name: "execute + query: \u0625\u0646\u0634\u0627\u0621 \u0648\u0625\u062F\u0631\u0627\u062C \u0648\u0642\u0631\u0627\u0621\u0629",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER PRIMARY KEY, name TEXT)");
+      await a.execute("INSERT INTO t (id, name) VALUES (?, ?)", [1, "\u0642\u0647\u0648\u0629"]);
+      const rows = await a.query(
+        "SELECT id, name FROM t"
+      );
+      assertEqual(rows, [{ id: 1, name: "\u0642\u0647\u0648\u0629" }], "\u0635\u0641 \u0648\u0627\u062D\u062F \u0628\u0627\u0644\u0642\u064A\u0645 \u0627\u0644\u0635\u062D");
+    })
+  },
+  {
+    name: "\u0627\u0644\u0645\u0639\u0627\u0645\u0644\u0627\u062A: string / number / null / blob \u062A\u062A\u0631\u0628\u0637 \u0648\u062A\u0631\u062C\u0639 \u0635\u062D",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute(
+        "CREATE TABLE t (id INTEGER, s TEXT, n REAL, z TEXT, b BLOB)"
+      );
+      const blob = new Uint8Array([0, 255, 16, 200]);
+      await a.execute("INSERT INTO t (id, s, n, z, b) VALUES (?, ?, ?, ?, ?)", [
+        7,
+        "\u0646\u0635",
+        12.5,
+        null,
+        blob
+      ]);
+      const rows = await a.query("SELECT id, s, n, z, b FROM t WHERE id = ?", [7]);
+      assert(rows.length === 1, "\u0635\u0641 \u0648\u0627\u062D\u062F");
+      const r = rows[0];
+      assertEqual(
+        { id: r.id, s: r.s, n: r.n, z: r.z },
+        { id: 7, s: "\u0646\u0635", n: 12.5, z: null },
+        "\u0627\u0644\u0642\u064A\u0645 \u063A\u064A\u0631 \u0627\u0644\u0640 blob"
+      );
+      assert(
+        bytesEqual(new Uint8Array(r.b), blob),
+        "\u0627\u0644\u0640 blob \u064A\u0631\u062C\u0639 \u0628\u0646\u0641\u0633 \u0627\u0644\u0628\u0627\u064A\u062A\u0627\u062A"
+      );
+    })
+  },
+  {
+    name: "execute \u0645\u0646 \u063A\u064A\u0631 params \u064A\u0646\u0641\u0651\u0630 \u0623\u0643\u062A\u0631 \u0645\u0646 statement (DDL/migrations)",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute(`
+          CREATE TABLE a (id INTEGER);
+          CREATE TABLE b (id INTEGER);
+          INSERT INTO a (id) VALUES (1);
+          INSERT INTO b (id) VALUES (2);
+        `);
+      const ra = await a.query("SELECT id FROM a");
+      const rb = await a.query("SELECT id FROM b");
+      assertEqual([ra, rb], [[{ id: 1 }], [{ id: 2 }]], "\u0627\u0644\u062C\u062F\u0648\u0644\u064A\u0646 \u0627\u062A\u0639\u0645\u0644\u0648\u0627");
+    })
+  },
+  {
+    name: "transaction \u0628\u062A\u0639\u0645\u0644 commit \u0639\u0646\u062F \u0627\u0644\u0646\u062C\u0627\u062D",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      await a.transaction(async (tx) => {
+        await tx.execute("INSERT INTO t (id) VALUES (1)");
+        await tx.execute("INSERT INTO t (id) VALUES (2)");
+      });
+      const rows = await a.query("SELECT id FROM t ORDER BY id");
+      assertEqual(rows, [{ id: 1 }, { id: 2 }], "\u0627\u0644\u0635\u0641\u064A\u0646 \u0627\u062A\u062B\u0628\u062A\u0648\u0627 \u0628\u0639\u062F \u0627\u0644\u0640 commit");
+    })
+  },
+  {
+    name: "transaction \u0628\u062A\u0639\u0645\u0644 rollback \u0639\u0646\u062F \u0623\u064A throw (atomic) \u0648\u062A\u0639\u064A\u062F \u0627\u0644\u0631\u0645\u064A",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      await assertThrows(
+        () => a.transaction(async (tx) => {
+          await tx.execute("INSERT INTO t (id) VALUES (1)");
+          throw new Error("\u0641\u0634\u0644 \u0645\u0642\u0635\u0648\u062F \u0648\u0633\u0637 \u0627\u0644\u0640 transaction");
+        }),
+        "\u0627\u0644\u0640 transaction \u0628\u062A\u0631\u0645\u064A \u0627\u0644\u062E\u0637\u0623 \u0628\u0631\u0647"
+      );
+      const rows = await a.query("SELECT id FROM t");
+      assertEqual(rows, [], "\u0645\u0641\u064A\u0634 \u0623\u064A \u0635\u0641 \u0627\u062A\u0643\u062A\u0628 \u2014 \u0627\u062A\u0639\u0645\u0644 rollback \u0644\u0644\u0643\u0644");
+    })
+  },
+  {
+    name: "transaction \u0628\u062A\u0631\u062C\u0651\u0639 \u0642\u064A\u0645\u0629 \u0627\u0644\u0640 callback",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      const value = await a.transaction(async (tx) => {
+        await tx.execute("INSERT INTO t (id) VALUES (42)");
+        const rows = await tx.query("SELECT id FROM t");
+        return rows[0].id;
+      });
+      assertEqual(value, 42, "\u0627\u0644\u0642\u064A\u0645\u0629 \u0627\u0644\u0631\u0627\u062C\u0639\u0629 \u0645\u0646 \u0627\u0644\u0640 callback");
+    })
+  },
+  {
+    name: "read-your-writes: \u0627\u0644\u0640 tx \u0628\u064A\u0634\u0648\u0641 \u0643\u062A\u0627\u0628\u0627\u062A\u0647 \u0642\u0628\u0644 \u0627\u0644\u0640 commit",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER)");
+      await a.transaction(async (tx) => {
+        await tx.execute("INSERT INTO t (id) VALUES (5)");
+        const rows = await tx.query("SELECT id FROM t");
+        assertEqual(rows, [{ id: 5 }], "\u0627\u0644\u0627\u0633\u062A\u0639\u0644\u0627\u0645 \u062C\u0648\u0647 \u0627\u0644\u0640 tx \u0628\u064A\u0634\u0648\u0641 \u0627\u0644\u0625\u062F\u0631\u0627\u062C");
+      });
+    })
+  },
+  {
+    name: "INSERT OR REPLACE: upsert (\u064A\u0633\u062A\u062E\u062F\u0645\u0647 \u0627\u0644\u0640 pull)",
+    run: (make) => withAdapter(make, async (a) => {
+      await a.execute("CREATE TABLE t (id INTEGER PRIMARY KEY, v TEXT)");
+      await a.execute("INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)", [1, "\u0623\u0648\u0644"]);
+      await a.execute("INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)", [1, "\u062A\u0627\u0646\u064A"]);
+      const rows = await a.query("SELECT id, v FROM t");
+      assertEqual(rows, [{ id: 1, v: "\u062A\u0627\u0646\u064A" }], "\u0627\u0644\u0635\u0641 \u0627\u062A\u0633\u062A\u0628\u062F\u0644 \u0645\u0634 \u0627\u062A\u0643\u0631\u0651\u0631");
+    })
+  }
+];
+
+// src/conformance/index.ts
+function runAdapterConformance(label, make, harness) {
+  harness.describe(`StorageAdapter conformance \u2014 ${label}`, () => {
+    for (const c of CONFORMANCE_CASES) {
+      harness.it(c.name, () => c.run(make));
+    }
+  });
+}
+
+exports.CONFORMANCE_CASES = CONFORMANCE_CASES;
+exports.assert = assert;
+exports.assertEqual = assertEqual;
+exports.assertThrows = assertThrows;
+exports.bytesEqual = bytesEqual;
+exports.runAdapterConformance = runAdapterConformance;
+//# sourceMappingURL=conformance.cjs.map
+//# sourceMappingURL=conformance.cjs.map

package/dist/conformance.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/conformance/assert.ts","../src/conformance/cases.ts","../src/conformance/index.ts"],"names":[],"mappings":";;;AAKO,SAAS,MAAA,CAAO,MAAe,GAAA,EAA2B;AAC/D,EAAA,IAAI,CAAC,IAAA,EAAM,MAAM,IAAI,KAAA,CAAM,CAAA,aAAA,EAAgB,GAAG,CAAA,CAAE,CAAA;AAClD;AAEO,SAAS,WAAA,CAAY,MAAA,EAAiB,QAAA,EAAmB,GAAA,EAAmB;AACjF,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA;AAC/B,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,SAAA,CAAU,QAAQ,CAAA;AACjC,EAAA,IAAI,MAAM,CAAA,EAAG;AACX,IAAA,MAAM,IAAI,MAAM,CAAA,aAAA,EAAgB,GAAG,sDAAc,CAAC,CAAA,iCAAA,EAAW,CAAC,CAAA,CAAE,CAAA;AAAA,EAClE;AACF;AAEO,SAAS,UAAA,CAAW,GAAe,CAAA,EAAwB;AAChE,EAAA,IAAI,CAAA,CAAE,MAAA,KAAW,CAAA,CAAE,MAAA,EAAQ,OAAO,KAAA;AAClC,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,CAAE,MAAA,EAAQ,CAAA,EAAA,EAAK,IAAI,CAAA,CAAE,CAAC,CAAA,KAAM,CAAA,CAAE,CAAC,GAAG,OAAO,KAAA;AAC7D,EAAA,OAAO,IAAA;AACT;AAGA,eAAsB,YAAA,CACpB,IACA,GAAA,EACe;AACf,EAAA,IAAI,KAAA,GAAQ,KAAA;AACZ,EAAA,IAAI;AACF,IAAA,MAAM,EAAA,EAAG;AAAA,EACX,CAAA,CAAA,MAAQ;AACN,IAAA,KAAA,GAAQ,IAAA;AAAA,EACV;AACA,EAAA,MAAA,CAAO,OAAO,GAAG,CAAA;AACnB;;;ACvBA,eAAe,WAAA,CACb,MACA,IAAA,EACe;AACf,EAAA,MAAM,OAAA,GAAU,MAAM,IAAA,EAAK;AAC3B,EAAA,IAAI;AACF,IAAA,MAAM,KAAK,OAAO,CAAA;AAAA,EACpB,CAAA,SAAE;AACA,IAAA,MAAM,QAAQ,KAAA,EAAM;AAAA,EACtB;AACF;AAMO,IAAM,iBAAA,GAAuC;AAAA,EAClD;AAAA,IACE,IAAA,EAAM,2HAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,CAAA,CAAE,QAAQ,oDAAoD,CAAA;AACpE,MAAA,MAAM,EAAE,OAAA,CAAQ,wCAAA,EAA0C,CAAC,CAAA,EAAG,0BAAM,CAAC,CAAA;AACrE,MAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,KAAA;AAAA,QACnB;AAAA,OACF;AACA,MAAA,WAAA,CAAY,IAAA,EAAM,CAAC,EAAE,EAAA,EAAI,GAAG,IAAA,EAAM,0BAAA,EAAQ,CAAA,EAAG,qGAAqB,CAAA;AAAA,IACpE,CAAC;AAAA,GACL;AAAA,EAEA;AAAA,IACE,IAAA,EAAM,kKAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,CAAA,CAAE,OAAA;AAAA,QACN;AAAA,OACF;AACA,MAAA,MAAM,IAAA,GAAO,IAAI,UAAA,CAAW,CAAC,GAAG,GAAA,EAAK,EAAA,EAAI,GAAG,CAAC,CAAA;AAC7C,MAAA,MAAM,CAAA,CAAE,QAAQ,uDAAA,EAAyD;AAAA,QACvE,CAAA;AAAA,QACA,cAAA;AAAA,QACA,IAAA;AAAA,QACA,IAAA;AAAA,QACA;AAAA,OACD,CAAA;AACD,MAAA,MAAM,OAAO,MAAM,CAAA,CAAE,MAMlB,2CAAA,EAA6C,CAAC,CAAC,CAAC,CAAA;AACnD,MAAA,MAAA,CAAO,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,uCAAS,CAAA;AACnC,MAAA,MAAM,CAAA,GAAI,KAAK,CAAC,CAAA;AAChB,MAAA,WAAA;AAAA,QACE,EAAE,EAAA,EAAI,CAAA,CAAE,EAAA,EAAI,CAAA,EAAG,CAAA,CAAE,CAAA,EAAG,CAAA,EAAG,CAAA,CAAE,CAAA,EAAG,CAAA,EAAG,CAAA,CAAE,CAAA,EAAE;AAAA,QACnC,EAAE,IAAI,CAAA,EAAG,CAAA,EAAG,gBAAM,CAAA,EAAG,IAAA,EAAM,GAAG,IAAA,EAAK;AAAA,QACnC;AAAA,OACF;AACA,MAAA,MAAA;AAAA,QACE,WAAW,IAAI,UAAA,CAAW,CAAA,CAAE,CAAC,GAAG,IAAI,CAAA;AAAA,QACpC;AAAA,OACF;AAAA,IACF,CAAC;AAAA,GACL;AAAA,EAEA;AAAA,IACE,IAAA,EAAM,gJAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,EAAE,OAAA,CAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,QAAA,CAKf,CAAA;AACD,MAAA,MAAM,EAAA,GAAK,MAAM,CAAA,CAAE,KAAA,CAAsB,kBAAkB,CAAA;AAC3D,MAAA,MAAM,EAAA,GAAK,MAAM,CAAA,CAAE,KAAA,CAAsB,kBAAkB,CAAA;AAC3D,MAAA,WAAA,CAAY,CAAC,EAAA,EAAI,EAAE,GAAG,CAAC,CAAC,EAAE,EAAA,EAAI,CAAA,EAAG,CAAA,EAAG,CAAC,EAAE,EAAA,EAAI,GAAG,CAAC,GAAG,6FAAkB,CAAA;AAAA,IACtE,CAAC;AAAA,GACL;AAAA,EAEA;AAAA,IACE,IAAA,EAAM,2GAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,CAAA,CAAE,QAAQ,6BAA6B,CAAA;AAC7C,MAAA,MAAM,CAAA,CAAE,WAAA,CAAY,OAAO,EAAA,KAAO;AAChC,QAAA,MAAM,EAAA,CAAG,QAAQ,+BAA+B,CAAA;AAChD,QAAA,MAAM,EAAA,CAAG,QAAQ,+BAA+B,CAAA;AAAA,MAClD,CAAC,CAAA;AACD,MAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,KAAA,CAAsB,8BAA8B,CAAA;AACzE,MAAA,WAAA,CAAY,IAAA,EAAM,CAAC,EAAE,EAAA,EAAI,CAAA,EAAE,EAAG,EAAE,EAAA,EAAI,CAAA,EAAG,CAAA,EAAG,8HAA+B,CAAA;AAAA,IAC3E,CAAC;AAAA,GACL;AAAA,EAEA;AAAA,IACE,IAAA,EAAM,kKAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,CAAA,CAAE,QAAQ,6BAA6B,CAAA;AAC7C,MAAA,MAAM,YAAA;AAAA,QACJ,MACE,CAAA,CAAE,WAAA,CAAY,OAAO,EAAA,KAAO;AAC1B,UAAA,MAAM,EAAA,CAAG,QAAQ,+BAA+B,CAAA;AAChD,UAAA,MAAM,IAAI,MAAM,qGAA+B,CAAA;AAAA,QACjD,CAAC,CAAA;AAAA,QACH;AAAA,OACF;AACA,MAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,KAAA,CAAsB,kBAAkB,CAAA;AAC7D,MAAA,WAAA,CAAY,IAAA,EAAM,EAAC,EAAG,2JAAwC,CAAA;AAAA,IAChE,CAAC;AAAA,GACL;AAAA,EAEA;AAAA,IACE,IAAA,EAAM,uGAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,CAAA,CAAE,QAAQ,6BAA6B,CAAA;AAC7C,MAAA,MAAM,KAAA,GAAQ,MAAM,CAAA,CAAE,WAAA,CAAY,OAAO,EAAA,KAAO;AAC9C,QAAA,MAAM,EAAA,CAAG,QAAQ,gCAAgC,CAAA;AACjD,QAAA,MAAM,IAAA,GAAO,MAAM,EAAA,CAAG,KAAA,CAAsB,kBAAkB,CAAA;AAC9D,QAAA,OAAO,IAAA,CAAK,CAAC,CAAA,CAAG,EAAA;AAAA,MAClB,CAAC,CAAA;AACD,MAAA,WAAA,CAAY,KAAA,EAAO,IAAI,0HAAgC,CAAA;AAAA,IACzD,CAAC;AAAA,GACL;AAAA,EAEA;AAAA,IACE,IAAA,EAAM,gKAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,CAAA,CAAE,QAAQ,6BAA6B,CAAA;AAC7C,MAAA,MAAM,CAAA,CAAE,WAAA,CAAY,OAAO,EAAA,KAAO;AAChC,QAAA,MAAM,EAAA,CAAG,QAAQ,+BAA+B,CAAA;AAChD,QAAA,MAAM,IAAA,GAAO,MAAM,EAAA,CAAG,KAAA,CAAsB,kBAAkB,CAAA;AAC9D,QAAA,WAAA,CAAY,MAAM,CAAC,EAAE,IAAI,CAAA,EAAG,GAAG,2KAAoC,CAAA;AAAA,MACrE,CAAC,CAAA;AAAA,IACH,CAAC;AAAA,GACL;AAAA,EAEA;AAAA,IACE,IAAA,EAAM,gGAAA;AAAA,IACN,KAAK,CAAC,IAAA,KACJ,WAAA,CAAY,IAAA,EAAM,OAAO,CAAA,KAAM;AAC7B,MAAA,MAAM,CAAA,CAAE,QAAQ,iDAAiD,CAAA;AACjE,MAAA,MAAM,EAAE,OAAA,CAAQ,gDAAA,EAAkD,CAAC,CAAA,EAAG,oBAAK,CAAC,CAAA;AAC5E,MAAA,MAAM,EAAE,OAAA,CAAQ,gDAAA,EAAkD,CAAC,CAAA,EAAG,0BAAM,CAAC,CAAA;AAC7E,MAAA,MAAM,IAAA,GAAO,MAAM,CAAA,CAAE,KAAA,CAAiC,qBAAqB,CAAA;AAC3E,MAAA,WAAA,CAAY,IAAA,EAAM,CAAC,EAAE,EAAA,EAAI,GAAG,CAAA,EAAG,0BAAA,EAAQ,CAAA,EAAG,uHAAwB,CAAA;AAAA,IACpE,CAAC;AAAA;AAEP;;;AC/IO,SAAS,qBAAA,CACd,KAAA,EACA,IAAA,EACA,OAAA,EACM;AACN,EAAA,OAAA,CAAQ,QAAA,CAAS,CAAA,kCAAA,EAAgC,KAAK,CAAA,CAAA,EAAI,MAAM;AAC9D,IAAA,KAAA,MAAW,KAAK,iBAAA,EAAmB;AACjC,MAAA,OAAA,CAAQ,GAAG,CAAA,CAAE,IAAA,EAAM,MAAM,CAAA,CAAE,GAAA,CAAI,IAAI,CAAC,CAAA;AAAA,IACtC;AAAA,EACF,CAAC,CAAA;AACH","file":"conformance.cjs","sourcesContent":["/**\n * assertions صغيرة مستقلة عن أي test runner — علشان نفس الـ conformance cases\n * تشتغل تحت vitest (Node) و Playwright (المتصفح، لـ wa-sqlite) من غير تغيير.\n * الفشل = throw.\n */\nexport function assert(cond: unknown, msg: string): asserts cond {\n  if (!cond) throw new Error(`conformance: ${msg}`);\n}\n\nexport function assertEqual(actual: unknown, expected: unknown, msg: string): void {\n  const a = JSON.stringify(actual);\n  const e = JSON.stringify(expected);\n  if (a !== e) {\n    throw new Error(`conformance: ${msg} — المتوقع ${e} لكن جه ${a}`);\n  }\n}\n\nexport function bytesEqual(a: Uint8Array, b: Uint8Array): boolean {\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;\n  return true;\n}\n\n/** يتأكد إن fn رمت (للتحقق من الـ rollback / إعادة الرمي). */\nexport async function assertThrows(\n  fn: () => Promise<unknown>,\n  msg: string,\n): Promise<void> {\n  let threw = false;\n  try {\n    await fn();\n  } catch {\n    threw = true;\n  }\n  assert(threw, msg);\n}\n","import type { StorageAdapter } from \"../ports/StorageAdapter\";\nimport { assert, assertEqual, assertThrows, bytesEqual } from \"./assert\";\n\n/** بيرجّع adapter جديد فاضي (مفضّل :memory:) لكل حالة. */\nexport type MakeAdapter = () => Promise<StorageAdapter> | StorageAdapter;\n\nexport interface ConformanceCase {\n  name: string;\n  run(make: MakeAdapter): Promise<void>;\n}\n\n/** helper: يفتح adapter، ينفّذ الجسم، ويقفل مهما حصل. */\nasync function withAdapter(\n  make: MakeAdapter,\n  body: (a: StorageAdapter) => Promise<void>,\n): Promise<void> {\n  const adapter = await make();\n  try {\n    await body(adapter);\n  } finally {\n    await adapter.close();\n  }\n}\n\n/**\n * بطارية العقد اللي أي StorageAdapter لازم يعدّيها قبل الدمج. بتختبر عقد الـ\n * adapter نفسه (execute/query/params/transaction/close) — مش الـ repositories.\n */\nexport const CONFORMANCE_CASES: ConformanceCase[] = [\n  {\n    name: \"execute + query: إنشاء وإدراج وقراءة\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER PRIMARY KEY, name TEXT)\");\n        await a.execute(\"INSERT INTO t (id, name) VALUES (?, ?)\", [1, \"قهوة\"]);\n        const rows = await a.query<{ id: number; name: string }>(\n          \"SELECT id, name FROM t\",\n        );\n        assertEqual(rows, [{ id: 1, name: \"قهوة\" }], \"صف واحد بالقيم الصح\");\n      }),\n  },\n\n  {\n    name: \"المعاملات: string / number / null / blob تتربط وترجع صح\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\n          \"CREATE TABLE t (id INTEGER, s TEXT, n REAL, z TEXT, b BLOB)\",\n        );\n        const blob = new Uint8Array([0, 255, 16, 200]);\n        await a.execute(\"INSERT INTO t (id, s, n, z, b) VALUES (?, ?, ?, ?, ?)\", [\n          7,\n          \"نص\",\n          12.5,\n          null,\n          blob,\n        ]);\n        const rows = await a.query<{\n          id: number;\n          s: string;\n          n: number;\n          z: string | null;\n          b: Uint8Array;\n        }>(\"SELECT id, s, n, z, b FROM t WHERE id = ?\", [7]);\n        assert(rows.length === 1, \"صف واحد\");\n        const r = rows[0]!;\n        assertEqual(\n          { id: r.id, s: r.s, n: r.n, z: r.z },\n          { id: 7, s: \"نص\", n: 12.5, z: null },\n          \"القيم غير الـ blob\",\n        );\n        assert(\n          bytesEqual(new Uint8Array(r.b), blob),\n          \"الـ blob يرجع بنفس البايتات\",\n        );\n      }),\n  },\n\n  {\n    name: \"execute من غير params ينفّذ أكتر من statement (DDL/migrations)\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(`\n          CREATE TABLE a (id INTEGER);\n          CREATE TABLE b (id INTEGER);\n          INSERT INTO a (id) VALUES (1);\n          INSERT INTO b (id) VALUES (2);\n        `);\n        const ra = await a.query<{ id: number }>(\"SELECT id FROM a\");\n        const rb = await a.query<{ id: number }>(\"SELECT id FROM b\");\n        assertEqual([ra, rb], [[{ id: 1 }], [{ id: 2 }]], \"الجدولين اتعملوا\");\n      }),\n  },\n\n  {\n    name: \"transaction بتعمل commit عند النجاح\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        await a.transaction(async (tx) => {\n          await tx.execute(\"INSERT INTO t (id) VALUES (1)\");\n          await tx.execute(\"INSERT INTO t (id) VALUES (2)\");\n        });\n        const rows = await a.query<{ id: number }>(\"SELECT id FROM t ORDER BY id\");\n        assertEqual(rows, [{ id: 1 }, { id: 2 }], \"الصفين اتثبتوا بعد الـ commit\");\n      }),\n  },\n\n  {\n    name: \"transaction بتعمل rollback عند أي throw (atomic) وتعيد الرمي\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        await assertThrows(\n          () =>\n            a.transaction(async (tx) => {\n              await tx.execute(\"INSERT INTO t (id) VALUES (1)\");\n              throw new Error(\"فشل مقصود وسط الـ transaction\");\n            }),\n          \"الـ transaction بترمي الخطأ بره\",\n        );\n        const rows = await a.query<{ id: number }>(\"SELECT id FROM t\");\n        assertEqual(rows, [], \"مفيش أي صف اتكتب — اتعمل rollback للكل\");\n      }),\n  },\n\n  {\n    name: \"transaction بترجّع قيمة الـ callback\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        const value = await a.transaction(async (tx) => {\n          await tx.execute(\"INSERT INTO t (id) VALUES (42)\");\n          const rows = await tx.query<{ id: number }>(\"SELECT id FROM t\");\n          return rows[0]!.id;\n        });\n        assertEqual(value, 42, \"القيمة الراجعة من الـ callback\");\n      }),\n  },\n\n  {\n    name: \"read-your-writes: الـ tx بيشوف كتاباته قبل الـ commit\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER)\");\n        await a.transaction(async (tx) => {\n          await tx.execute(\"INSERT INTO t (id) VALUES (5)\");\n          const rows = await tx.query<{ id: number }>(\"SELECT id FROM t\");\n          assertEqual(rows, [{ id: 5 }], \"الاستعلام جوه الـ tx بيشوف الإدراج\");\n        });\n      }),\n  },\n\n  {\n    name: \"INSERT OR REPLACE: upsert (يستخدمه الـ pull)\",\n    run: (make) =>\n      withAdapter(make, async (a) => {\n        await a.execute(\"CREATE TABLE t (id INTEGER PRIMARY KEY, v TEXT)\");\n        await a.execute(\"INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)\", [1, \"أول\"]);\n        await a.execute(\"INSERT OR REPLACE INTO t (id, v) VALUES (?, ?)\", [1, \"تاني\"]);\n        const rows = await a.query<{ id: number; v: string }>(\"SELECT id, v FROM t\");\n        assertEqual(rows, [{ id: 1, v: \"تاني\" }], \"الصف اتستبدل مش اتكرّر\");\n      }),\n  },\n];\n","import { CONFORMANCE_CASES, type MakeAdapter } from \"./cases\";\n\nexport { CONFORMANCE_CASES } from \"./cases\";\nexport type { ConformanceCase, MakeAdapter } from \"./cases\";\nexport { assert, assertEqual, assertThrows, bytesEqual } from \"./assert\";\n\n/**\n * ربط الـ conformance battery بـ vitest. أي adapter جديد (op-sqlite / wa-sqlite)\n * لازم يعدّي دي كلها قبل الدمج:\n *\n *   import { runAdapterConformance } from \"qumra-pos-storage/conformance\";\n *   runAdapterConformance(\"better-sqlite3\", () => BetterSqlite3Adapter.open());\n *\n * الـ describe/it بتتحقن — علشان نفضل مستقلين عن الـ runner (Playwright يقدر\n * يمرّر test.describe/test بتوعه لتشغيل نفس الحالات في المتصفح لـ wa-sqlite).\n */\nexport interface TestHarness {\n  describe(name: string, fn: () => void): void;\n  it(name: string, fn: () => void | Promise<void>): void;\n}\n\nexport function runAdapterConformance(\n  label: string,\n  make: MakeAdapter,\n  harness: TestHarness,\n): void {\n  harness.describe(`StorageAdapter conformance — ${label}`, () => {\n    for (const c of CONFORMANCE_CASES) {\n      harness.it(c.name, () => c.run(make));\n    }\n  });\n}\n"]}

package/dist/conformance.d.cts

@@ -0,0 +1,42 @@
+import { a as StorageAdapter } from './StorageAdapter-B2IgHcUF.cjs';
+
+/** بيرجّع adapter جديد فاضي (مفضّل :memory:) لكل حالة. */
+type MakeAdapter = () => Promise<StorageAdapter> | StorageAdapter;
+interface ConformanceCase {
+    name: string;
+    run(make: MakeAdapter): Promise<void>;
+}
+/**
+ * بطارية العقد اللي أي StorageAdapter لازم يعدّيها قبل الدمج. بتختبر عقد الـ
+ * adapter نفسه (execute/query/params/transaction/close) — مش الـ repositories.
+ */
+declare const CONFORMANCE_CASES: ConformanceCase[];
+
+/**
+ * assertions صغيرة مستقلة عن أي test runner — علشان نفس الـ conformance cases
+ * تشتغل تحت vitest (Node) و Playwright (المتصفح، لـ wa-sqlite) من غير تغيير.
+ * الفشل = throw.
+ */
+declare function assert(cond: unknown, msg: string): asserts cond;
+declare function assertEqual(actual: unknown, expected: unknown, msg: string): void;
+declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+/** يتأكد إن fn رمت (للتحقق من الـ rollback / إعادة الرمي). */
+declare function assertThrows(fn: () => Promise<unknown>, msg: string): Promise<void>;
+
+/**
+ * ربط الـ conformance battery بـ vitest. أي adapter جديد (op-sqlite / wa-sqlite)
+ * لازم يعدّي دي كلها قبل الدمج:
+ *
+ *   import { runAdapterConformance } from "qumra-pos-storage/conformance";
+ *   runAdapterConformance("better-sqlite3", () => BetterSqlite3Adapter.open());
+ *
+ * الـ describe/it بتتحقن — علشان نفضل مستقلين عن الـ runner (Playwright يقدر
+ * يمرّر test.describe/test بتوعه لتشغيل نفس الحالات في المتصفح لـ wa-sqlite).
+ */
+interface TestHarness {
+    describe(name: string, fn: () => void): void;
+    it(name: string, fn: () => void | Promise<void>): void;
+}
+declare function runAdapterConformance(label: string, make: MakeAdapter, harness: TestHarness): void;
+
+export { CONFORMANCE_CASES, type ConformanceCase, type MakeAdapter, type TestHarness, assert, assertEqual, assertThrows, bytesEqual, runAdapterConformance };

package/dist/conformance.d.ts

@@ -0,0 +1,42 @@
+import { a as StorageAdapter } from './StorageAdapter-B2IgHcUF.js';
+
+/** بيرجّع adapter جديد فاضي (مفضّل :memory:) لكل حالة. */
+type MakeAdapter = () => Promise<StorageAdapter> | StorageAdapter;
+interface ConformanceCase {
+    name: string;
+    run(make: MakeAdapter): Promise<void>;
+}
+/**
+ * بطارية العقد اللي أي StorageAdapter لازم يعدّيها قبل الدمج. بتختبر عقد الـ
+ * adapter نفسه (execute/query/params/transaction/close) — مش الـ repositories.
+ */
+declare const CONFORMANCE_CASES: ConformanceCase[];
+
+/**
+ * assertions صغيرة مستقلة عن أي test runner — علشان نفس الـ conformance cases
+ * تشتغل تحت vitest (Node) و Playwright (المتصفح، لـ wa-sqlite) من غير تغيير.
+ * الفشل = throw.
+ */
+declare function assert(cond: unknown, msg: string): asserts cond;
+declare function assertEqual(actual: unknown, expected: unknown, msg: string): void;
+declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+/** يتأكد إن fn رمت (للتحقق من الـ rollback / إعادة الرمي). */
+declare function assertThrows(fn: () => Promise<unknown>, msg: string): Promise<void>;
+
+/**
+ * ربط الـ conformance battery بـ vitest. أي adapter جديد (op-sqlite / wa-sqlite)
+ * لازم يعدّي دي كلها قبل الدمج:
+ *
+ *   import { runAdapterConformance } from "qumra-pos-storage/conformance";
+ *   runAdapterConformance("better-sqlite3", () => BetterSqlite3Adapter.open());
+ *
+ * الـ describe/it بتتحقن — علشان نفضل مستقلين عن الـ runner (Playwright يقدر
+ * يمرّر test.describe/test بتوعه لتشغيل نفس الحالات في المتصفح لـ wa-sqlite).
+ */
+interface TestHarness {
+    describe(name: string, fn: () => void): void;
+    it(name: string, fn: () => void | Promise<void>): void;
+}
+declare function runAdapterConformance(label: string, make: MakeAdapter, harness: TestHarness): void;
+
+export { CONFORMANCE_CASES, type ConformanceCase, type MakeAdapter, type TestHarness, assert, assertEqual, assertThrows, bytesEqual, runAdapterConformance };

package/dist/conformance.js

@@ -0,0 +1,3 @@
+export { CONFORMANCE_CASES, assert, assertEqual, assertThrows, bytesEqual, runAdapterConformance } from './chunk-HXRUTEU7.js';
+//# sourceMappingURL=conformance.js.map
+//# sourceMappingURL=conformance.js.map

package/dist/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"conformance.js"}