@hardkas/query 0.5.4-alpha → 0.6.0-alpha

package/dist/index.d.ts

@@ -334,7 +334,12 @@ interface QueryBackend {
     migrate(): Promise<{
         applied: number;
     }>;
-    /** Execute raw SQL (if supported). */
+    /**
+     * Execute raw SQL (if supported).
+     * @deprecated BOUNDARY DINÁMICO: Este es el ÚNICO boundary dinámico aceptado en el sistema
+     * que puede retornar `any[]` de forma intencional (SQLite devuelve filas genéricas).
+     * Todos los llamadores DEBEN validar el output estrictamente en runtime mediante guards.
+     */
     executeRawSql(sql: string): Promise<any[]>;
     /** Find all transaction receipts (for replay analysis). */
     findReceipts(filters?: {

package/dist/index.js

@@ -686,13 +686,16 @@ var ArtifactQueryAdapter = class {
       sorted.sort((a, b) => {
         const aVal = String(a[sort.field] ?? "");
         const bVal = String(b[sort.field] ?? "");
-        const cmp = aVal.localeCompare(bVal);
+        const cmp = aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
         return sort.direction === "desc" ? -cmp : cmp;
       });
     } else {
       sorted.sort((a, b) => {
-        const cmp = (b.createdAt ?? "").localeCompare(a.createdAt ?? "");
-        return cmp !== 0 ? cmp : a.schema.localeCompare(b.schema);
+        const dateA = b.createdAt ?? "";
+        const dateB = a.createdAt ?? "";
+        const cmp = dateA < dateB ? -1 : dateA > dateB ? 1 : 0;
+        if (cmp !== 0) return cmp;
+        return a.schema < b.schema ? -1 : a.schema > b.schema ? 1 : 0;
       });
     }
     return sorted;
@@ -731,6 +734,7 @@ function classifyStaleness(hours) {
 // src/adapters/lineage-adapter.ts
 import fs3 from "fs/promises";
 import path3 from "path";
+import { deterministicCompare } from "@hardkas/core";
 var VALID_TRANSITIONS2 = {
   "hardkas.snapshot": ["hardkas.txPlan"],
   "hardkas.txPlan": ["hardkas.signedTx"],
@@ -834,7 +838,7 @@ var LineageQueryAdapter = class {
       const seqA = a.from.sequence ?? 0;
       const seqB = b.from.sequence ?? 0;
       if (seqA !== seqB) return seqA - seqB;
-      return a.from.contentHash.localeCompare(b.from.contentHash);
+      return deterministicCompare(a.from.contentHash, b.from.contentHash);
     });
     const paged = transitions.slice(request.offset, request.offset + request.limit);
     let why;
@@ -875,7 +879,7 @@ var LineageQueryAdapter = class {
         });
       }
     }
-    orphans.sort((a, b) => a.node.contentHash.localeCompare(b.node.contentHash));
+    orphans.sort((a, b) => deterministicCompare(a.node.contentHash, b.node.contentHash));
     const paged = orphans.slice(request.offset, request.offset + request.limit);
     let why;
     if (request.explain) {
@@ -1016,6 +1020,7 @@ var LineageQueryAdapter = class {
 // src/adapters/replay-adapter.ts
 import fs4 from "fs/promises";
 import { calculateContentHash as calculateContentHash2 } from "@hardkas/artifacts";
+import { deterministicCompare as deterministicCompare2 } from "@hardkas/core";
 var ReplayQueryAdapter = class {
   domain = "replay";
   rootDir;
@@ -1063,8 +1068,8 @@ var ReplayQueryAdapter = class {
       }
     }
     items.sort((a, b) => {
-      const cmp = b.daaScore.localeCompare(a.daaScore);
-      return cmp !== 0 ? cmp : a.txId.localeCompare(b.txId);
+      const cmp = deterministicCompare2(b.daaScore, a.daaScore);
+      return cmp !== 0 ? cmp : deterministicCompare2(a.txId, b.txId);
     });
     const total = items.length;
     const paged = items.slice(request.offset, request.offset + request.limit);
@@ -1174,7 +1179,7 @@ var ReplayQueryAdapter = class {
         });
       }
     }
-    divergences.sort((a, b) => a.txId.localeCompare(b.txId));
+    divergences.sort((a, b) => deterministicCompare2(a.txId, b.txId));
     const paged = divergences.slice(request.offset, request.offset + request.limit);
     let why;
     if (request.explain) {
@@ -1355,6 +1360,7 @@ function explainInvariants(result) {
 // src/adapters/dag-adapter.ts
 import fs5 from "fs/promises";
 import path4 from "path";
+import { deterministicCompare as deterministicCompare3 } from "@hardkas/core";
 var DagQueryAdapter = class {
   domain = "dag";
   rootDir;
@@ -1399,7 +1405,7 @@ var DagQueryAdapter = class {
       winnerTxId: c.winnerTxId,
       loserTxIds: c.loserTxIds
     }));
-    items.sort((a, b) => a.outpoint.localeCompare(b.outpoint));
+    items.sort((a, b) => deterministicCompare3(a.outpoint, b.outpoint));
     const paged = items.slice(request.offset, request.offset + request.limit);
     let why;
     if (request.explain) {
@@ -1435,7 +1441,7 @@ var DagQueryAdapter = class {
         currentlyAccepted: dag.acceptedTxIds.includes(txId)
       };
     });
-    items.sort((a, b) => a.txId.localeCompare(b.txId));
+    items.sort((a, b) => deterministicCompare3(a.txId, b.txId));
     const paged = items.slice(request.offset, request.offset + request.limit);
     let why;
     if (request.explain) {
@@ -1488,7 +1494,7 @@ var DagQueryAdapter = class {
         });
       }
     }
-    entries.sort((a, b) => a.daaScore.localeCompare(b.daaScore));
+    entries.sort((a, b) => deterministicCompare3(a.daaScore, b.daaScore));
     let why;
     if (request.explain) {
       why = entries.map((e) => explainTxHistory(e, dag));
@@ -1587,7 +1593,7 @@ var DagQueryAdapter = class {
         });
       }
     }
-    anomalies.sort((a, b) => a.kind.localeCompare(b.kind));
+    anomalies.sort((a, b) => deterministicCompare3(a.kind, b.kind));
     const paged = anomalies.slice(request.offset, request.offset + request.limit);
     let why;
     if (request.explain) {
@@ -1719,6 +1725,7 @@ function explainAnomaly(a, _dag) {
 
 // src/adapters/events-adapter.ts
 import path5 from "path";
+import { deterministicCompare as deterministicCompare4 } from "@hardkas/core";
 var EventsQueryAdapter = class {
   domain = "events";
   rootDir;
@@ -1758,9 +1765,9 @@ var EventsQueryAdapter = class {
       }
     }
     const sorted = [...filtered].sort((a, b) => {
-      const cmp = a.timestamp.localeCompare(b.timestamp);
+      const cmp = deterministicCompare4(a.timestamp, b.timestamp);
       if (cmp !== 0) return cmp;
-      return a.eventId.localeCompare(b.eventId);
+      return deterministicCompare4(a.eventId, b.eventId);
     });
     const total = sorted.length;
     const paged = sorted.slice(request.offset, request.offset + request.limit);
@@ -1814,6 +1821,7 @@ var EventsQueryAdapter = class {
 };
 
 // src/adapters/tx-adapter.ts
+import { deterministicCompare as deterministicCompare5 } from "@hardkas/core";
 var TxQueryAdapter = class {
   domain = "tx";
   rootDir;
@@ -1853,7 +1861,7 @@ var TxQueryAdapter = class {
     const result = {
       txId,
       artifacts,
-      events: events.sort((a, b) => a.timestamp.localeCompare(b.timestamp) || a.eventId.localeCompare(b.eventId)),
+      events: events.sort((a, b) => deterministicCompare5(a.timestamp, b.timestamp) || deterministicCompare5(a.eventId, b.eventId)),
       warnings,
       complete
     };
@@ -1906,7 +1914,7 @@ var TxQueryAdapter = class {
         role
       });
     }
-    return results.sort((a, b) => a.filePath.localeCompare(b.filePath));
+    return results.sort((a, b) => deterministicCompare5(a.filePath, b.filePath));
   }
   async findEventsByTxId(txId) {
     const docs = await this.backend.getEvents({ txId });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/query",
-  "version": "0.5.4-alpha",
+  "version": "0.6.0-alpha",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,9 +14,9 @@
   ],
   "dependencies": {
     "picocolors": "^1.1.1",
-    "@hardkas/core": "0.5.4-alpha",
-    "@hardkas/artifacts": "0.5.4-alpha",
-    "@hardkas/query-store": "0.5.4-alpha"
+    "@hardkas/core": "0.6.0-alpha",
+    "@hardkas/query-store": "0.6.0-alpha",
+    "@hardkas/artifacts": "0.6.0-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",