qumra-pos-storage 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -124,10 +124,28 @@ ALTER TABLE pending_operations ADD COLUMN inflight_at TEXT;
 `
 );
 
+// src/schema/003_documents.ts
+var SQL_003 = (
+  /* sql */
+  `
+CREATE TABLE documents (
+  id          TEXT PRIMARY KEY,     -- UUIDv7 \u0628\u064A\u062A\u0648\u0644\u0651\u062F \u062A\u0644\u0642\u0627\u0626\u064A\u0627\u064B (\u0645\u0631\u0633\u0627\u0629 \u0627\u0644\u0640 idempotency)
+  collection  TEXT NOT NULL,        -- "orders" | "products" | \u0623\u064A \u0627\u0633\u0645 \u0628\u062A\u0627\u0639\u0643
+  data        TEXT NOT NULL,        -- JSON \u2014 \u0623\u064A keys \u0625\u0646\u062A \u0639\u0627\u064A\u0632\u0647\u0627
+  created_at  TEXT NOT NULL,
+  updated_at  TEXT NOT NULL,
+  deleted     INTEGER NOT NULL DEFAULT 0,   -- \u062D\u0630\u0641 \u0646\u0627\u0639\u0645 (tombstone) \u2014 \u0627\u0644\u0628\u064A\u0627\u0646\u0627\u062A \u0645\u0627\u0628\u062A\u062A\u0645\u0633\u0651\u062D
+  sync_status TEXT NOT NULL DEFAULT 'pending'
+);
+CREATE INDEX idx_documents_collection ON documents(collection, updated_at);
+`
+);
+
 // src/schema/index.ts
 var MIGRATIONS = [
   { version: 1, sql: SQL_001 },
-  { version: 2, sql: SQL_002 }
+  { version: 2, sql: SQL_002 },
+  { version: 3, sql: SQL_003 }
 ];
 
 // src/time.ts
@@ -160,6 +178,99 @@ async function runMigrations(adapter) {
 }
 var newId = () => uuidv7.uuidv7();
 
+// src/repositories/DocumentsRepository.ts
+var DocumentsRepository = class {
+  constructor(adapter, outbox) {
+    this.adapter = adapter;
+    this.outbox = outbox;
+  }
+  adapter;
+  outbox;
+  /** إنشاء مستند جديد بـ UUID تلقائي. بيرجّع المستند بالـ id. */
+  async create(collection, data) {
+    return this.write(collection, newId(), data, false);
+  }
+  /** إدراج/تحديث مستند بـ id معروف (لو موجود بيتحدّث، لو لأ بيتعمل). */
+  async upsert(collection, id, data) {
+    return this.write(collection, id, data, false);
+  }
+  /** حذف ناعم (tombstone) — البيانات مابتتمسّح، بس بتتعلّم deleted وتتزامن كحذف. */
+  async remove(collection, id) {
+    const existing = await this.get(collection, id);
+    if (!existing) return;
+    await this.write(collection, id, existing.data, true);
+  }
+  async get(collection, id) {
+    const rows = await this.adapter.query(
+      `SELECT * FROM documents WHERE id = ? AND collection = ?`,
+      [id, collection]
+    );
+    const row = rows[0];
+    return row ? this.toDoc(row) : null;
+  }
+  /** كل مستندات مجموعة (أحدث أولاً). بيتجاهل المحذوف افتراضياً. */
+  async all(collection, opts = {}) {
+    const limit = opts.limit ?? 100;
+    const offset = opts.offset ?? 0;
+    const guard = opts.includeDeleted ? "" : "AND deleted = 0";
+    const rows = await this.adapter.query(
+      `SELECT * FROM documents
+       WHERE collection = ? ${guard}
+       ORDER BY updated_at DESC
+       LIMIT ? OFFSET ?`,
+      [collection, limit, offset]
+    );
+    return rows.map((r) => this.toDoc(r));
+  }
+  async write(collection, id, data, deleted) {
+    const now = nowISO();
+    const dataJson = JSON.stringify(data);
+    const opType = deleted ? "doc.delete" : "doc.upsert";
+    await this.adapter.transaction(async (tx) => {
+      await tx.execute(
+        `INSERT INTO documents
+           (id, collection, data, created_at, updated_at, deleted, sync_status)
+         VALUES (?, ?, ?, ?, ?, ?, 'pending')
+         ON CONFLICT(id) DO UPDATE SET
+           data = excluded.data,
+           updated_at = excluded.updated_at,
+           deleted = excluded.deleted,
+           sync_status = 'pending'`,
+        [id, collection, dataJson, now, now, deleted ? 1 : 0]
+      );
+      await this.outbox.enqueue(tx, {
+        opType,
+        payload: { op: deleted ? "delete" : "upsert", id, collection, data, updatedAt: now },
+        // فريد لكل كتابة (opId جديد) علشان التحديثات المتتالية تتزامن كلها؛
+        // والـ docId جوه المفتاح علشان الـ settle يعكس sync_status على المستند.
+        idempotencyKey: `${opType}:${id}:${newId()}`,
+        clientTs: now
+      });
+    });
+    const stored = await this.get(collection, id);
+    return stored ?? {
+      id,
+      collection,
+      data,
+      createdAt: now,
+      updatedAt: now,
+      deleted,
+      syncStatus: "pending"
+    };
+  }
+  toDoc(row) {
+    return {
+      id: row.id,
+      collection: row.collection,
+      data: JSON.parse(row.data),
+      createdAt: row.created_at,
+      updatedAt: row.updated_at,
+      deleted: row.deleted === 1,
+      syncStatus: row.sync_status
+    };
+  }
+};
+
 // src/repositories/OrdersRepository.ts
 var OrdersRepository = class {
   constructor(adapter, outbox) {
@@ -414,6 +525,14 @@ var OutboxRepository = class {
             outcome,
             orderId
           ]);
+        } else if (op.op_type === "doc.upsert" || op.op_type === "doc.delete") {
+          const docId = op.idempotency_key.slice(op.op_type.length + 1).split(":")[0];
+          if (docId) {
+            await tx.execute(`UPDATE documents SET sync_status = ? WHERE id = ?`, [
+              outcome,
+              docId
+            ]);
+          }
         }
       }
     });
@@ -731,6 +850,7 @@ async function createStorage(adapter) {
     orders: new OrdersRepository(adapter, outbox),
     products: new ProductsRepository(adapter, outbox),
     reports: new ReportsRepository(adapter),
+    docs: new DocumentsRepository(adapter, outbox),
     outbox,
     adapter,
     close: () => adapter.close()
@@ -1314,6 +1434,7 @@ exports.CASHIERS_RESOURCE = CASHIERS_RESOURCE;
 exports.CONFORMANCE_CASES = CONFORMANCE_CASES;
 exports.DEFAULT_BACKOFF = DEFAULT_BACKOFF;
 exports.DEFAULT_RESOURCES = DEFAULT_RESOURCES;
+exports.DocumentsRepository = DocumentsRepository;
 exports.MIGRATIONS = MIGRATIONS;
 exports.OrdersRepository = OrdersRepository;
 exports.OutboxRepository = OutboxRepository;