qumra-pos-storage 0.1.0

package/dist/index.cjs

@@ -0,0 +1,1335 @@
+'use strict';
+
+var uuidv7 = require('uuidv7');
+
+// src/schema/001_initial.ts
+var SQL_001 = (
+  /* sql */
+  `
+-- ===========================================================================
+-- \u062C\u062F\u0627\u0648\u0644 \u0627\u0644\u0639\u0645\u0644\u064A\u0627\u062A (\u0628\u062A\u062A\u0648\u0644\u0651\u062F \u0645\u062D\u0644\u064A\u0627\u064B \u0648\u0628\u062A\u062A\u0631\u0641\u0639 \u0644\u0644\u0633\u062D\u0627\u0628\u0629)
+-- ===========================================================================
+
+CREATE TABLE shifts (
+  id            TEXT PRIMARY KEY,
+  cashier_id    TEXT NOT NULL,
+  opened_at     TEXT NOT NULL,
+  closed_at     TEXT,
+  opening_cash  INTEGER NOT NULL,   -- \u0642\u0631\u0648\u0634
+  counted_cash  INTEGER,
+  status        TEXT NOT NULL       -- open | closed
+);
+
+CREATE TABLE orders (
+  id            TEXT PRIMARY KEY,
+  shift_id      TEXT NOT NULL REFERENCES shifts(id),
+  cashier_id    TEXT NOT NULL,
+  status        TEXT NOT NULL,      -- completed | voided | refunded
+  subtotal      INTEGER NOT NULL,
+  discount      INTEGER NOT NULL DEFAULT 0,
+  tax           INTEGER NOT NULL DEFAULT 0,
+  total         INTEGER NOT NULL,
+  created_at    TEXT NOT NULL,
+  sync_status   TEXT NOT NULL DEFAULT 'pending'
+);
+CREATE INDEX idx_orders_shift ON orders(shift_id);
+CREATE INDEX idx_orders_created ON orders(created_at);
+
+-- snapshot \u0643\u0627\u0645\u0644 \u0644\u0643\u0644 \u0633\u0637\u0631 \u0648\u0642\u062A \u0627\u0644\u0628\u064A\u0639.
+CREATE TABLE order_items (
+  id            TEXT PRIMARY KEY,
+  order_id      TEXT NOT NULL REFERENCES orders(id),
+  product_id    TEXT NOT NULL,
+  name_snapshot TEXT NOT NULL,      -- \u0627\u0644\u0627\u0633\u0645 \u0648\u0642\u062A \u0627\u0644\u0628\u064A\u0639
+  unit_price    INTEGER NOT NULL,   -- \u0627\u0644\u0633\u0639\u0631 \u0648\u0642\u062A \u0627\u0644\u0628\u064A\u0639
+  qty           REAL NOT NULL,      -- REAL \u0644\u0644\u0633\u0645\u0627\u062D \u0628\u0627\u0644\u0648\u0632\u0646\u064A (\u0643\u064A\u0644\u0648)
+  line_total    INTEGER NOT NULL
+);
+CREATE INDEX idx_items_order ON order_items(order_id);
+
+-- \u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0648\u0627\u062D\u062F \u0645\u0645\u0643\u0646 \u064A\u062A\u062F\u0641\u0639 \u0628\u0623\u0643\u062A\u0631 \u0645\u0646 \u0637\u0631\u064A\u0642\u0629.
+CREATE TABLE payments (
+  id         TEXT PRIMARY KEY,
+  order_id   TEXT NOT NULL REFERENCES orders(id),
+  method     TEXT NOT NULL,   -- cash | card | wallet | ...
+  amount     INTEGER NOT NULL,
+  created_at TEXT NOT NULL
+);
+CREATE INDEX idx_payments_order ON payments(order_id);
+
+-- ===========================================================================
+-- \u0627\u0644\u062C\u062F\u0627\u0648\u0644 \u0627\u0644\u0645\u0631\u062C\u0639\u064A\u0629 (\u0628\u062A\u0646\u0632\u0644 \u0645\u0646 \u0627\u0644\u0633\u064A\u0631\u0641\u0631 \u2014 \u0627\u0644\u0633\u064A\u0631\u0641\u0631 \u0645\u0635\u062F\u0631 \u0627\u0644\u062D\u0642\u064A\u0642\u0629)
+-- ===========================================================================
+
+CREATE TABLE products (
+  id          TEXT PRIMARY KEY,
+  name        TEXT NOT NULL,
+  sku         TEXT,
+  barcode     TEXT,
+  price       INTEGER NOT NULL,
+  category_id TEXT,
+  is_active   INTEGER NOT NULL DEFAULT 1,
+  updated_at  TEXT NOT NULL,
+  is_local    INTEGER NOT NULL DEFAULT 0  -- \u0645\u0646\u062A\u062C \u0627\u062A\u0639\u0645\u0644 \u064A\u062F\u0648\u064A \u0623\u0648\u0641\u0644\u0627\u064A\u0646
+);
+CREATE INDEX idx_products_barcode ON products(barcode);
+
+CREATE TABLE cashiers (
+  id         TEXT PRIMARY KEY,
+  name       TEXT NOT NULL,
+  role       TEXT NOT NULL,
+  pin_hash   TEXT NOT NULL,
+  pin_salt   TEXT NOT NULL,
+  is_active  INTEGER NOT NULL DEFAULT 1,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE settings (
+  key        TEXT PRIMARY KEY,
+  value      TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+-- ===========================================================================
+-- \u062C\u062F\u0627\u0648\u0644 \u0627\u0644\u0628\u0646\u064A\u0629 \u0627\u0644\u062A\u062D\u062A\u064A\u0629
+-- ===========================================================================
+
+-- \u0627\u0644\u0640 Outbox: \u0642\u0644\u0628 \u0627\u0644\u062A\u0634\u063A\u064A\u0644 \u0627\u0644\u0623\u0648\u0641\u0644\u0627\u064A\u0646 \u0643\u0644\u0647.
+CREATE TABLE pending_operations (
+  id              TEXT PRIMARY KEY,     -- UUIDv7 == \u062A\u0631\u062A\u064A\u0628 \u0632\u0645\u0646\u064A
+  op_type         TEXT NOT NULL,        -- order.create | shift.open | ...
+  payload         TEXT NOT NULL,        -- \u0627\u0644\u0646\u0633\u062E\u0629 \u0627\u0644\u0643\u0627\u0645\u0644\u0629 (JSON) \u0644\u0644\u0639\u0645\u0644\u064A\u0629
+  idempotency_key TEXT NOT NULL UNIQUE,
+  client_ts       TEXT NOT NULL,
+  attempts        INTEGER NOT NULL DEFAULT 0,
+  status          TEXT NOT NULL DEFAULT 'pending',  -- pending | inflight | synced | failed
+  last_error      TEXT
+);
+CREATE INDEX idx_ops_status ON pending_operations(status, id);
+
+-- \u062D\u0627\u0644\u0629 \u0627\u0644\u0645\u0632\u0627\u0645\u0646\u0629 \u0644\u0643\u0644 \u0645\u0648\u0631\u062F (\u0644\u0644\u0640 delta pull).
+CREATE TABLE sync_state (
+  resource    TEXT PRIMARY KEY,   -- products | cashiers | settings
+  last_pulled TEXT NOT NULL,
+  cursor      TEXT
+);
+`
+);
+
+// src/schema/002_outbox_inflight.ts
+var SQL_002 = (
+  /* sql */
+  `
+ALTER TABLE pending_operations ADD COLUMN inflight_at TEXT;
+`
+);
+
+// src/schema/index.ts
+var MIGRATIONS = [
+  { version: 1, sql: SQL_001 },
+  { version: 2, sql: SQL_002 }
+];
+
+// src/time.ts
+var nowISO = () => (/* @__PURE__ */ new Date()).toISOString();
+
+// src/migrator.ts
+async function runMigrations(adapter) {
+  await adapter.execute(
+    `CREATE TABLE IF NOT EXISTS _migrations (
+       version    INTEGER PRIMARY KEY,
+       applied_at TEXT NOT NULL
+     );`
+  );
+  const rows = await adapter.query(
+    `SELECT version FROM _migrations`
+  );
+  const applied = new Set(rows.map((r) => r.version));
+  const pending = MIGRATIONS.filter((m) => !applied.has(m.version)).sort(
+    (a, b) => a.version - b.version
+  );
+  for (const migration of pending) {
+    await adapter.transaction(async (tx) => {
+      await tx.execute(migration.sql);
+      await tx.execute(
+        `INSERT INTO _migrations (version, applied_at) VALUES (?, ?)`,
+        [migration.version, nowISO()]
+      );
+    });
+  }
+}
+var newId = () => uuidv7.uuidv7();
+
+// src/repositories/OrdersRepository.ts
+var OrdersRepository = class {
+  constructor(adapter, outbox) {
+    this.adapter = adapter;
+    this.outbox = outbox;
+  }
+  adapter;
+  outbox;
+  /**
+   * بيع atomic: الطلب + العناصر + المدفوعات + سطر outbox واحد، كلهم في transaction
+   * واحدة. بيتحقق إن مجموع المدفوعات = total الطلب قبل الكتابة — الـ validation في
+   * الـ core مش في الـ UI. لو أي جزء فشل، كله بيترجع (rollback).
+   */
+  async create(input) {
+    if (input.items.length === 0) {
+      throw new Error("Cannot create an order with no items");
+    }
+    if (input.payments.length === 0) {
+      throw new Error("Cannot create an order with no payments");
+    }
+    const createdAt = input.createdAt ?? nowISO();
+    const orderId = newId();
+    const discount = input.discount ?? 0;
+    const tax = input.tax ?? 0;
+    const items = input.items.map((it) => ({
+      id: newId(),
+      order_id: orderId,
+      product_id: it.productId,
+      name_snapshot: it.nameSnapshot,
+      unit_price: it.unitPrice,
+      qty: it.qty,
+      line_total: it.lineTotal ?? Math.round(it.unitPrice * it.qty)
+    }));
+    const subtotal = items.reduce((sum, it) => sum + it.line_total, 0);
+    const total = input.total ?? subtotal - discount + tax;
+    const payments = input.payments.map((p) => ({
+      id: newId(),
+      order_id: orderId,
+      method: p.method,
+      amount: p.amount,
+      created_at: createdAt
+    }));
+    const paymentsTotal = payments.reduce((sum, p) => sum + p.amount, 0);
+    if (paymentsTotal !== total) {
+      throw new Error(
+        `Payments (${paymentsTotal}) do not match order total (${total})`
+      );
+    }
+    const order = {
+      id: orderId,
+      shift_id: input.shiftId,
+      cashier_id: input.cashierId,
+      status: input.status ?? "completed",
+      subtotal,
+      discount,
+      tax,
+      total,
+      created_at: createdAt,
+      sync_status: "pending"
+    };
+    await this.adapter.transaction(async (tx) => {
+      await tx.execute(
+        `INSERT INTO orders
+           (id, shift_id, cashier_id, status, subtotal, discount, tax, total, created_at, sync_status)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+        [
+          order.id,
+          order.shift_id,
+          order.cashier_id,
+          order.status,
+          order.subtotal,
+          order.discount,
+          order.tax,
+          order.total,
+          order.created_at,
+          order.sync_status
+        ]
+      );
+      for (const it of items) {
+        await tx.execute(
+          `INSERT INTO order_items
+             (id, order_id, product_id, name_snapshot, unit_price, qty, line_total)
+           VALUES (?, ?, ?, ?, ?, ?, ?)`,
+          [
+            it.id,
+            it.order_id,
+            it.product_id,
+            it.name_snapshot,
+            it.unit_price,
+            it.qty,
+            it.line_total
+          ]
+        );
+      }
+      for (const p of payments) {
+        await tx.execute(
+          `INSERT INTO payments (id, order_id, method, amount, created_at)
+           VALUES (?, ?, ?, ?, ?)`,
+          [p.id, p.order_id, p.method, p.amount, p.created_at]
+        );
+      }
+      await this.outbox.enqueue(tx, {
+        opType: "order.create",
+        payload: { ...order, items, payments },
+        idempotencyKey: `order.create:${order.id}`,
+        clientTs: createdAt
+      });
+    });
+    return { ...order, items, payments };
+  }
+  async void(orderId, opts) {
+    const voidedAt = nowISO();
+    return this.adapter.transaction(async (tx) => {
+      const rows = await tx.query(`SELECT * FROM orders WHERE id = ?`, [
+        orderId
+      ]);
+      const order = rows[0];
+      if (!order) throw new Error(`Order not found: ${orderId}`);
+      if (order.status === "voided") {
+        throw new Error(`Order already voided: ${orderId}`);
+      }
+      await tx.execute(`UPDATE orders SET status = 'voided' WHERE id = ?`, [
+        orderId
+      ]);
+      const voided = { ...order, status: "voided" };
+      await this.outbox.enqueue(tx, {
+        opType: "order.void",
+        payload: { orderId, reason: opts.reason, voidedAt },
+        idempotencyKey: `order.void:${orderId}`,
+        clientTs: voidedAt
+      });
+      return voided;
+    });
+  }
+  async findByShift(shiftId) {
+    return this.adapter.query(
+      `SELECT * FROM orders WHERE shift_id = ? ORDER BY created_at`,
+      [shiftId]
+    );
+  }
+  async getWithDetails(orderId) {
+    const orders = await this.adapter.query(
+      `SELECT * FROM orders WHERE id = ?`,
+      [orderId]
+    );
+    const order = orders[0];
+    if (!order) return null;
+    const items = await this.adapter.query(
+      `SELECT * FROM order_items WHERE order_id = ?`,
+      [orderId]
+    );
+    const payments = await this.adapter.query(
+      `SELECT * FROM payments WHERE order_id = ?`,
+      [orderId]
+    );
+    return { ...order, items, payments };
+  }
+};
+
+// src/repositories/OutboxRepository.ts
+var OutboxRepository = class {
+  constructor(adapter) {
+    this.adapter = adapter;
+  }
+  adapter;
+  /** إضافة عملية. اتنادى جوه transaction بتاعة اللي بينادي، ومرّرله الـ tx. */
+  async enqueue(tx, input) {
+    await tx.execute(
+      `INSERT INTO pending_operations
+         (id, op_type, payload, idempotency_key, client_ts, attempts, status, last_error)
+       VALUES (?, ?, ?, ?, ?, 0, 'pending', NULL)`,
+      [
+        newId(),
+        input.opType,
+        JSON.stringify(input.payload),
+        input.idempotencyKey,
+        input.clientTs
+      ]
+    );
+  }
+  /** العمليات المستنية بالترتيب الزمني (UUIDv7) — وهو ترتيب الرفع. */
+  async listPending(limit = 50) {
+    return this.adapter.query(
+      `SELECT * FROM pending_operations
+       WHERE status = 'pending'
+       ORDER BY id
+       LIMIT ?`,
+      [limit]
+    );
+  }
+  async countByStatus() {
+    const rows = await this.adapter.query(
+      `SELECT status, COUNT(*) AS n FROM pending_operations GROUP BY status`
+    );
+    return Object.fromEntries(rows.map((r) => [r.status, r.n]));
+  }
+  // -------------------------------------------------------------------------
+  // جانب المزامنة (بيستهلكه الـ SyncEngine)
+  // -------------------------------------------------------------------------
+  /**
+   * بيحجز أقدم دفعة pending (بترتيب UUIDv7) ويعلّمها inflight في transaction واحدة —
+   * فمفيش دفعتين بترفعوا نفس العملية. بيزوّد attempts وبيسجّل inflight_at.
+   */
+  async claimBatch(limit = 50, inflightAt = nowISO()) {
+    return this.adapter.transaction(async (tx) => {
+      const rows = await tx.query(
+        `SELECT * FROM pending_operations
+         WHERE status = 'pending'
+         ORDER BY id
+         LIMIT ?`,
+        [limit]
+      );
+      if (rows.length === 0) return [];
+      const ids = rows.map((r) => r.id);
+      const placeholders = ids.map(() => "?").join(",");
+      await tx.execute(
+        `UPDATE pending_operations
+           SET status = 'inflight', inflight_at = ?, attempts = attempts + 1
+         WHERE id IN (${placeholders})`,
+        [inflightAt, ...ids]
+      );
+      return rows.map((r) => ({
+        ...r,
+        status: "inflight",
+        inflight_at: inflightAt,
+        attempts: r.attempts + 1
+      }));
+    });
+  }
+  /**
+   * بيثبّت نتايج الرفع: العمليات الناجحة → synced، والمرفوضة → failed + السبب. وبيعكس
+   * الحالة على صف الطلب (orders.sync_status) لعمليات order.* — كله في transaction واحدة.
+   */
+  async settle(resolutions) {
+    if (resolutions.length === 0) return;
+    await this.adapter.transaction(async (tx) => {
+      for (const { op, outcome, error } of resolutions) {
+        if (outcome === "synced") {
+          await tx.execute(
+            `UPDATE pending_operations SET status = 'synced', last_error = NULL WHERE id = ?`,
+            [op.id]
+          );
+        } else {
+          await tx.execute(
+            `UPDATE pending_operations SET status = 'failed', last_error = ? WHERE id = ?`,
+            [error, op.id]
+          );
+        }
+        if (op.op_type === "order.create" || op.op_type === "order.void") {
+          const orderId = op.idempotency_key.slice(op.op_type.length + 1);
+          await tx.execute(`UPDATE orders SET sync_status = ? WHERE id = ?`, [
+            outcome,
+            orderId
+          ]);
+        }
+      }
+    });
+  }
+  /** إرجاع عمليات inflight لـ pending (فشل شبكة أو السيرفر مردّش عليها). */
+  async releaseToPending(ids) {
+    if (ids.length === 0) return;
+    const placeholders = ids.map(() => "?").join(",");
+    await this.adapter.execute(
+      `UPDATE pending_operations
+         SET status = 'pending', inflight_at = NULL
+       WHERE id IN (${placeholders})`,
+      ids
+    );
+  }
+  /**
+   * استرجاع العمليات العالقة inflight (تطبيق اتقفل وسط رفعة): أي inflight إما بلا
+   * inflight_at أو أقدم من الـ cutoff بترجع pending. الـ idempotency بيحمي لو وصلت فعلاً.
+   */
+  async recoverStuckInflight(cutoffIso) {
+    await this.adapter.execute(
+      `UPDATE pending_operations
+         SET status = 'pending', inflight_at = NULL
+       WHERE status = 'inflight'
+         AND (inflight_at IS NULL OR inflight_at <= ?)`,
+      [cutoffIso]
+    );
+  }
+  /** العمليات اللي رُفضت من السيرفر (للعرض للمدير). */
+  async listFailed(limit = 50) {
+    return this.adapter.query(
+      `SELECT * FROM pending_operations
+       WHERE status = 'failed'
+       ORDER BY id
+       LIMIT ?`,
+      [limit]
+    );
+  }
+  /** إعادة عمليات فاشلة لـ pending (المدير بيعيد المحاولة). بلا ids = كل الفاشلة. */
+  async retryFailed(ids) {
+    if (ids && ids.length > 0) {
+      const placeholders = ids.map(() => "?").join(",");
+      await this.adapter.execute(
+        `UPDATE pending_operations
+           SET status = 'pending', last_error = NULL
+         WHERE status = 'failed' AND id IN (${placeholders})`,
+        ids
+      );
+    } else {
+      await this.adapter.execute(
+        `UPDATE pending_operations
+           SET status = 'pending', last_error = NULL
+         WHERE status = 'failed'`
+      );
+    }
+  }
+};
+
+// src/repositories/ProductsRepository.ts
+var toProduct = (r) => ({
+  ...r,
+  is_active: r.is_active === 1,
+  is_local: r.is_local === 1
+});
+var ProductsRepository = class {
+  constructor(adapter, outbox) {
+    this.adapter = adapter;
+    this.outbox = outbox;
+  }
+  adapter;
+  outbox;
+  /** البحث في المنتجات النشطة بالاسم أو الباركود أو الـ SKU. */
+  async search(text) {
+    const like = `%${text}%`;
+    const rows = await this.adapter.query(
+      `SELECT * FROM products
+       WHERE is_active = 1
+         AND (name LIKE ? OR barcode LIKE ? OR sku LIKE ?)
+       ORDER BY name
+       LIMIT 50`,
+      [like, like, like]
+    );
+    return rows.map(toProduct);
+  }
+  async getByBarcode(barcode) {
+    const rows = await this.adapter.query(
+      `SELECT * FROM products WHERE barcode = ? AND is_active = 1 LIMIT 1`,
+      [barcode]
+    );
+    return rows[0] ? toProduct(rows[0]) : null;
+  }
+  async getById(id) {
+    const rows = await this.adapter.query(
+      `SELECT * FROM products WHERE id = ?`,
+      [id]
+    );
+    return rows[0] ? toProduct(rows[0]) : null;
+  }
+  /** إنشاء منتج يدوي أوفلاين (is_local = 1). بيترفع كـ draft للمراجعة. */
+  async createLocal(input) {
+    const product = {
+      id: newId(),
+      name: input.name,
+      sku: input.sku ?? null,
+      barcode: input.barcode ?? null,
+      price: input.price,
+      category_id: input.categoryId ?? null,
+      is_active: true,
+      updated_at: nowISO(),
+      is_local: true
+    };
+    await this.adapter.transaction(async (tx) => {
+      await tx.execute(
+        `INSERT INTO products
+           (id, name, sku, barcode, price, category_id, is_active, updated_at, is_local)
+         VALUES (?, ?, ?, ?, ?, ?, 1, ?, 1)`,
+        [
+          product.id,
+          product.name,
+          product.sku,
+          product.barcode,
+          product.price,
+          product.category_id,
+          product.updated_at
+        ]
+      );
+      await this.outbox.enqueue(tx, {
+        opType: "product.create_local",
+        payload: product,
+        idempotencyKey: `product.create_local:${product.id}`,
+        clientTs: product.updated_at
+      });
+    });
+    return product;
+  }
+  /**
+   * upsert بالجملة من delta pull بتاع السيرفر (السيرفر مصدر الحقيقة). مفيش سطر
+   * outbox — دي بيانات داخلة (inbound)، مش عملية محلية.
+   */
+  async upsertMany(products) {
+    if (products.length === 0) return;
+    await this.adapter.transaction(async (tx) => {
+      for (const p of products) {
+        await tx.execute(
+          `INSERT OR REPLACE INTO products
+             (id, name, sku, barcode, price, category_id, is_active, updated_at, is_local)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+          [
+            p.id,
+            p.name,
+            p.sku,
+            p.barcode,
+            p.price,
+            p.category_id,
+            p.is_active ? 1 : 0,
+            p.updated_at,
+            p.is_local ? 1 : 0
+          ]
+        );
+      }
+    });
+  }
+};
+
+// src/repositories/ReportsRepository.ts
+var ReportsRepository = class {
+  constructor(adapter) {
+    this.adapter = adapter;
+  }
+  adapter;
+  async shiftSummary(shiftId) {
+    const totals = await this.adapter.query(
+      `SELECT COALESCE(SUM(total), 0) AS total, COUNT(*) AS n
+         FROM orders
+        WHERE shift_id = ? AND status = 'completed'`,
+      [shiftId]
+    );
+    const totalRow = totals[0] ?? { total: 0, n: 0 };
+    const byMethodRows = await this.adapter.query(
+      `SELECT p.method AS method, COALESCE(SUM(p.amount), 0) AS amount
+         FROM payments p
+         JOIN orders o ON o.id = p.order_id
+        WHERE o.shift_id = ? AND o.status = 'completed'
+        GROUP BY p.method`,
+      [shiftId]
+    );
+    const topRows = await this.adapter.query(
+      `SELECT oi.product_id AS product_id,
+              oi.name_snapshot AS name,
+              SUM(oi.qty) AS qty,
+              SUM(oi.line_total) AS total
+         FROM order_items oi
+         JOIN orders o ON o.id = oi.order_id
+        WHERE o.shift_id = ? AND o.status = 'completed'
+        GROUP BY oi.product_id, oi.name_snapshot
+        ORDER BY total DESC
+        LIMIT 10`,
+      [shiftId]
+    );
+    return {
+      shiftId,
+      totalSales: totalRow.total,
+      orderCount: totalRow.n,
+      byPaymentMethod: Object.fromEntries(
+        byMethodRows.map((r) => [r.method, r.amount])
+      ),
+      topProducts: topRows.map((r) => ({
+        productId: r.product_id,
+        name: r.name,
+        qty: r.qty,
+        total: r.total
+      }))
+    };
+  }
+};
+
+// src/repositories/ShiftsRepository.ts
+var ShiftsRepository = class {
+  constructor(adapter, outbox) {
+    this.adapter = adapter;
+    this.outbox = outbox;
+  }
+  adapter;
+  outbox;
+  async open(input) {
+    const shift = {
+      id: newId(),
+      cashier_id: input.cashierId,
+      opened_at: input.openedAt ?? nowISO(),
+      closed_at: null,
+      opening_cash: input.openingCash,
+      counted_cash: null,
+      status: "open"
+    };
+    await this.adapter.transaction(async (tx) => {
+      await tx.execute(
+        `INSERT INTO shifts
+           (id, cashier_id, opened_at, closed_at, opening_cash, counted_cash, status)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`,
+        [
+          shift.id,
+          shift.cashier_id,
+          shift.opened_at,
+          shift.closed_at,
+          shift.opening_cash,
+          shift.counted_cash,
+          shift.status
+        ]
+      );
+      await this.outbox.enqueue(tx, {
+        opType: "shift.open",
+        payload: shift,
+        idempotencyKey: `shift.open:${shift.id}`,
+        clientTs: shift.opened_at
+      });
+    });
+    return shift;
+  }
+  async close(shiftId, input) {
+    const closedAt = input.closedAt ?? nowISO();
+    const shift = await this.adapter.transaction(async (tx) => {
+      const existing = await tx.query(
+        `SELECT * FROM shifts WHERE id = ?`,
+        [shiftId]
+      );
+      const current = existing[0];
+      if (!current) throw new Error(`Shift not found: ${shiftId}`);
+      if (current.status !== "open") {
+        throw new Error(`Shift already closed: ${shiftId}`);
+      }
+      await tx.execute(
+        `UPDATE shifts
+           SET closed_at = ?, counted_cash = ?, status = 'closed'
+         WHERE id = ?`,
+        [closedAt, input.countedCash, shiftId]
+      );
+      const closed = {
+        ...current,
+        closed_at: closedAt,
+        counted_cash: input.countedCash,
+        status: "closed"
+      };
+      await this.outbox.enqueue(tx, {
+        opType: "shift.close",
+        payload: closed,
+        idempotencyKey: `shift.close:${shiftId}`,
+        clientTs: closedAt
+      });
+      return closed;
+    });
+    return shift;
+  }
+  /** الوردية المفتوحة الوحيدة على الجهاز ده (v1: وردية == جهاز واحد). */
+  async getCurrent() {
+    const rows = await this.adapter.query(
+      `SELECT * FROM shifts WHERE status = 'open' ORDER BY opened_at DESC LIMIT 1`
+    );
+    return rows[0] ?? null;
+  }
+  async findById(shiftId) {
+    const rows = await this.adapter.query(
+      `SELECT * FROM shifts WHERE id = ?`,
+      [shiftId]
+    );
+    return rows[0] ?? null;
+  }
+};
+
+// src/createStorage.ts
+async function createStorage(adapter) {
+  await runMigrations(adapter);
+  const outbox = new OutboxRepository(adapter);
+  return {
+    shifts: new ShiftsRepository(adapter, outbox),
+    orders: new OrdersRepository(adapter, outbox),
+    products: new ProductsRepository(adapter, outbox),
+    reports: new ReportsRepository(adapter),
+    outbox,
+    adapter,
+    close: () => adapter.close()
+  };
+}
+
+// src/sync/backoff.ts
+var DEFAULT_BACKOFF = {
+  baseMs: 1e3,
+  // 1s
+  capMs: 5 * 60 * 1e3
+  // 5 دقايق
+};
+function computeBackoff(attempt, cfg = DEFAULT_BACKOFF, random = Math.random) {
+  const exponent = Math.max(0, attempt - 1);
+  const raw = cfg.baseMs * 2 ** exponent;
+  const capped = Math.min(cfg.capMs, raw);
+  const half = capped / 2;
+  return Math.round(half + random() * half);
+}
+
+// src/sync/resources.ts
+var bool = (v, fallback = true) => v ?? fallback ? 1 : 0;
+var nullableStr = (v) => v == null ? null : String(v);
+var PRODUCTS_RESOURCE = {
+  resource: "products",
+  table: "products",
+  guardLocal: true,
+  toRow: (r) => ({
+    id: String(r.id),
+    name: String(r.name),
+    sku: nullableStr(r.sku),
+    barcode: nullableStr(r.barcode),
+    price: Number(r.price),
+    category_id: nullableStr(r.category_id),
+    is_active: bool(r.is_active),
+    updated_at: String(r.updated_at),
+    is_local: 0
+  })
+};
+var CASHIERS_RESOURCE = {
+  resource: "cashiers",
+  table: "cashiers",
+  toRow: (r) => ({
+    id: String(r.id),
+    name: String(r.name),
+    role: String(r.role),
+    pin_hash: String(r.pin_hash),
+    pin_salt: String(r.pin_salt),
+    is_active: bool(r.is_active),
+    updated_at: String(r.updated_at)
+  })
+};
+var SETTINGS_RESOURCE = {
+  resource: "settings",
+  table: "settings",
+  idColumn: "key",
+  toRow: (r) => ({
+    key: String(r.key),
+    value: String(r.value),
+    updated_at: String(r.updated_at)
+  })
+};
+var DEFAULT_RESOURCES = [
+  PRODUCTS_RESOURCE,
+  CASHIERS_RESOURCE,
+  SETTINGS_RESOURCE
+];
+
+// src/sync/SyncStateRepository.ts
+var SyncStateRepository = class {
+  constructor(adapter) {
+    this.adapter = adapter;
+  }
+  adapter;
+  async get(resource) {
+    const rows = await this.adapter.query(
+      `SELECT * FROM sync_state WHERE resource = ?`,
+      [resource]
+    );
+    return rows[0] ?? null;
+  }
+  async set(resource, lastPulled, cursor) {
+    await this.adapter.execute(
+      `INSERT OR REPLACE INTO sync_state (resource, last_pulled, cursor)
+       VALUES (?, ?, ?)`,
+      [resource, lastPulled, cursor]
+    );
+  }
+};
+
+// src/sync/types.ts
+var SyncNetworkError = class extends Error {
+  constructor(message, cause) {
+    super(message, { cause });
+    this.name = "SyncNetworkError";
+  }
+};
+
+// src/sync/SyncEngine.ts
+var FIVE_MIN = 5 * 60 * 1e3;
+var TWO_MIN = 2 * 60 * 1e3;
+var defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var errMsg = (err) => err instanceof Error ? err.message : String(err);
+var toPushOp = (op) => ({
+  idempotency_key: op.idempotency_key,
+  op_type: op.op_type,
+  client_ts: op.client_ts,
+  payload: JSON.parse(op.payload)
+});
+var SyncEngine = class {
+  transport;
+  outbox;
+  adapter;
+  syncState;
+  resources;
+  batchSize;
+  pullIntervalMs;
+  stuckInflightMs;
+  backoff;
+  maxPushRetries;
+  getAuthToken;
+  now;
+  sleep;
+  random;
+  onError;
+  listeners = /* @__PURE__ */ new Set();
+  status = {
+    online: false,
+    paused: false,
+    running: false,
+    pendingCount: 0,
+    inflightCount: 0,
+    failedOps: [],
+    lastPushAt: null,
+    lastPullAt: null,
+    lastError: null
+  };
+  stopped = false;
+  pullTimer = null;
+  /** يخلّي الـ push single-flight — نداءات requestPush بتتسلسل. */
+  pushChain = Promise.resolve();
+  constructor(storage, opts) {
+    this.transport = opts.transport;
+    this.outbox = storage.outbox;
+    this.adapter = storage.adapter;
+    this.syncState = new SyncStateRepository(storage.adapter);
+    this.resources = opts.resources ?? DEFAULT_RESOURCES;
+    this.batchSize = opts.batchSize ?? 50;
+    this.pullIntervalMs = opts.pullIntervalMs ?? FIVE_MIN;
+    this.stuckInflightMs = opts.stuckInflightMs ?? TWO_MIN;
+    this.backoff = { ...DEFAULT_BACKOFF, ...opts.backoff };
+    this.maxPushRetries = opts.maxPushRetries ?? Number.POSITIVE_INFINITY;
+    this.getAuthToken = opts.getAuthToken ?? (() => "");
+    this.now = opts.now ?? Date.now;
+    this.sleep = opts.sleep ?? defaultSleep;
+    this.random = opts.random ?? Math.random;
+    this.onError = opts.onError ?? (() => {
+    });
+  }
+  // -------------------------------------------------------------------------
+  // الحالة
+  // -------------------------------------------------------------------------
+  getStatus() {
+    return this.snapshot();
+  }
+  /** اشتراك في تغيّر الحالة. بيتنادى فوراً بالحالة الحالية، ويرجّع دالة إلغاء. */
+  onStatusChange(cb) {
+    this.listeners.add(cb);
+    cb(this.snapshot());
+    return () => this.listeners.delete(cb);
+  }
+  snapshot() {
+    return { ...this.status, failedOps: this.status.failedOps.map((f) => ({ ...f })) };
+  }
+  emit() {
+    const snap = this.snapshot();
+    for (const cb of this.listeners) {
+      try {
+        cb(snap);
+      } catch (err) {
+        this.onError(err, "listener");
+      }
+    }
+  }
+  async refreshCounts() {
+    const counts = await this.outbox.countByStatus();
+    this.status.pendingCount = counts["pending"] ?? 0;
+    this.status.inflightCount = counts["inflight"] ?? 0;
+    const failed = await this.outbox.listFailed(50);
+    this.status.failedOps = failed.map((o) => ({
+      id: o.id,
+      opType: o.op_type,
+      error: o.last_error ?? "unknown"
+    }));
+  }
+  isPaused() {
+    return this.getAuthToken() === null;
+  }
+  isoNow() {
+    return new Date(this.now()).toISOString();
+  }
+  // -------------------------------------------------------------------------
+  // الاسترجاع عند الإقلاع
+  // -------------------------------------------------------------------------
+  /** يرجّع أي عملية inflight عالقة (أقدم من المهلة) لـ pending. اتنادى عند الإقلاع. */
+  async recover() {
+    const cutoff = new Date(this.now() - this.stuckInflightMs).toISOString();
+    await this.outbox.recoverStuckInflight(cutoff);
+    await this.refreshCounts();
+    this.emit();
+  }
+  // -------------------------------------------------------------------------
+  // Push
+  // -------------------------------------------------------------------------
+  /**
+   * يفضّي الـ outbox في دفعات لحد ما يخلص أو يقابل فشل شبكة/توقّف/pause.
+   * مابيرميش لفشل الشبكة — بيرجّعه في النتيجة عشان pushWithBackoff يجمّع ويعيد.
+   */
+  async pushCycle() {
+    const result = {
+      synced: 0,
+      duplicated: 0,
+      failed: 0,
+      drained: false,
+      networkError: null,
+      paused: false
+    };
+    if (this.isPaused()) {
+      this.status.paused = true;
+      result.paused = true;
+      this.emit();
+      return result;
+    }
+    this.status.paused = false;
+    for (; ; ) {
+      if (this.stopped) return result;
+      const batch = await this.outbox.claimBatch(this.batchSize, this.isoNow());
+      if (batch.length === 0) {
+        result.drained = true;
+        return result;
+      }
+      let resp;
+      try {
+        resp = await this.transport.pushBatch(batch.map(toPushOp), {
+          token: this.getAuthToken()
+        });
+      } catch (err) {
+        await this.outbox.releaseToPending(batch.map((b) => b.id));
+        this.status.online = false;
+        this.status.lastError = errMsg(err);
+        await this.refreshCounts();
+        this.emit();
+        result.networkError = new SyncNetworkError(errMsg(err), err);
+        return result;
+      }
+      const byKey = new Map(resp.results.map((r) => [r.idempotency_key, r]));
+      const resolutions = [];
+      const orphaned = [];
+      for (const op of batch) {
+        const r = byKey.get(op.idempotency_key);
+        if (!r) {
+          orphaned.push(op.id);
+          continue;
+        }
+        if (r.status === "applied" || r.status === "duplicate") {
+          resolutions.push({ op, outcome: "synced", error: null });
+          if (r.status === "duplicate") result.duplicated++;
+          else result.synced++;
+        } else {
+          resolutions.push({ op, outcome: "failed", error: r.error ?? "rejected" });
+          result.failed++;
+        }
+      }
+      await this.outbox.settle(resolutions);
+      await this.outbox.releaseToPending(orphaned);
+      this.status.online = true;
+      this.status.lastError = null;
+      this.status.lastPushAt = this.isoNow();
+      await this.refreshCounts();
+      this.emit();
+    }
+  }
+  /**
+   * push مع إعادة محاولة تلقائية + exponential backoff عند فشل الشبكة، لحد ما
+   * يفضّي الـ outbox أو يتوقّف/يتعلّق (pause) أو يوصل سقف المحاولات.
+   */
+  async push() {
+    const agg = {
+      synced: 0,
+      duplicated: 0,
+      failed: 0,
+      drained: false
+    };
+    let attempt = 0;
+    for (; ; ) {
+      if (this.stopped) return agg;
+      const cycle = await this.pushCycle();
+      agg.synced += cycle.synced;
+      agg.duplicated += cycle.duplicated;
+      agg.failed += cycle.failed;
+      agg.drained = cycle.drained;
+      if (cycle.paused) return agg;
+      if (!cycle.networkError) return agg;
+      attempt++;
+      if (attempt > this.maxPushRetries) return agg;
+      await this.sleep(computeBackoff(attempt, this.backoff, this.random));
+    }
+  }
+  /** يجدول push على سلسلة single-flight (نداءات متتالية مبتتزاحمش). */
+  requestPush() {
+    this.pushChain = this.pushChain.catch(() => void 0).then(() => this.push()).catch((err) => this.onError(err, "push"));
+    return this.pushChain.then(() => void 0);
+  }
+  // -------------------------------------------------------------------------
+  // Pull
+  // -------------------------------------------------------------------------
+  /** ينزّل delta لكل مورد ويكتبه محلياً. بيرمي SyncNetworkError عند فشل الشبكة. */
+  async pull() {
+    const outcome = { upserted: 0, deleted: 0 };
+    if (this.isPaused()) {
+      this.status.paused = true;
+      this.emit();
+      return outcome;
+    }
+    this.status.paused = false;
+    for (const cfg of this.resources) {
+      const state = await this.syncState.get(cfg.resource);
+      let since = state?.last_pulled ?? "";
+      let cursor = state?.cursor ?? null;
+      for (; ; ) {
+        let delta;
+        try {
+          delta = await this.transport.pullDelta(cfg.resource, since, cursor, {
+            token: this.getAuthToken()
+          });
+        } catch (err) {
+          this.status.online = false;
+          this.status.lastError = errMsg(err);
+          this.emit();
+          throw new SyncNetworkError(errMsg(err), err);
+        }
+        await this.applyDelta(cfg, delta);
+        outcome.upserted += delta.changed.length;
+        outcome.deleted += delta.deleted.length;
+        const pulledAt = this.isoNow();
+        await this.syncState.set(cfg.resource, pulledAt, delta.cursor);
+        since = pulledAt;
+        cursor = delta.cursor;
+        if (!delta.hasMore) break;
+      }
+    }
+    this.status.online = true;
+    this.status.lastError = null;
+    this.status.lastPullAt = this.isoNow();
+    this.emit();
+    return outcome;
+  }
+  /** كتابة دفعة delta في transaction واحدة: upsert للمتغيّر + حذف الـ tombstones. */
+  async applyDelta(cfg, delta) {
+    if (delta.changed.length === 0 && delta.deleted.length === 0) return;
+    const idColumn = cfg.idColumn ?? "id";
+    await this.adapter.transaction(async (tx) => {
+      for (const raw of delta.changed) {
+        const row = cfg.toRow(raw);
+        const cols = Object.keys(row);
+        const placeholders = cols.map(() => "?").join(",");
+        await tx.execute(
+          `INSERT OR REPLACE INTO ${cfg.table} (${cols.join(",")}) VALUES (${placeholders})`,
+          cols.map((c) => row[c])
+        );
+      }
+      if (delta.deleted.length > 0) {
+        const placeholders = delta.deleted.map(() => "?").join(",");
+        const guard = cfg.guardLocal ? " AND is_local = 0" : "";
+        await tx.execute(
+          `DELETE FROM ${cfg.table} WHERE ${idColumn} IN (${placeholders})${guard}`,
+          delta.deleted
+        );
+      }
+    });
+  }
+  // -------------------------------------------------------------------------
+  // التنسيق العام
+  // -------------------------------------------------------------------------
+  /** رفع ثم تنزيل — للزر اليدوي وبعد إعادة الاتصال. أخطاء الـ pull الشبكية بتتبلع. */
+  async syncNow() {
+    await this.push();
+    try {
+      await this.pull();
+    } catch (err) {
+      if (!(err instanceof SyncNetworkError)) throw err;
+      this.onError(err, "pull");
+    }
+  }
+  /** بدء التشغيل: استرجاع + مزامنة فورية + pull دوري كل fiveMin. */
+  start() {
+    this.stopped = false;
+    this.status.running = true;
+    this.emit();
+    void this.recover().then(() => this.syncNow()).catch((err) => this.onError(err, "start"));
+    this.pullTimer = setInterval(() => {
+      void this.pull().catch((err) => {
+        if (!(err instanceof SyncNetworkError)) this.onError(err, "pull-interval");
+      });
+    }, this.pullIntervalMs);
+  }
+  /** إيقاف: بيوقف الـ timer وبيخلّي أي push/backoff جاري يخرج عند أقرب نقطة. */
+  stop() {
+    this.stopped = true;
+    this.status.running = false;
+    if (this.pullTimer) {
+      clearInterval(this.pullTimer);
+      this.pullTimer = null;
+    }
+    this.emit();
+  }
+};
+
+// 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.CASHIERS_RESOURCE = CASHIERS_RESOURCE;
+exports.CONFORMANCE_CASES = CONFORMANCE_CASES;
+exports.DEFAULT_BACKOFF = DEFAULT_BACKOFF;
+exports.DEFAULT_RESOURCES = DEFAULT_RESOURCES;
+exports.MIGRATIONS = MIGRATIONS;
+exports.OrdersRepository = OrdersRepository;
+exports.OutboxRepository = OutboxRepository;
+exports.PRODUCTS_RESOURCE = PRODUCTS_RESOURCE;
+exports.ProductsRepository = ProductsRepository;
+exports.ReportsRepository = ReportsRepository;
+exports.SETTINGS_RESOURCE = SETTINGS_RESOURCE;
+exports.ShiftsRepository = ShiftsRepository;
+exports.SyncEngine = SyncEngine;
+exports.SyncNetworkError = SyncNetworkError;
+exports.SyncStateRepository = SyncStateRepository;
+exports.computeBackoff = computeBackoff;
+exports.createStorage = createStorage;
+exports.newId = newId;
+exports.nowISO = nowISO;
+exports.runAdapterConformance = runAdapterConformance;
+exports.runMigrations = runMigrations;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map