@hardkas/query 0.2.2-alpha.1 → 0.3.0-alpha

package/dist/index.d.ts

@@ -323,7 +323,19 @@ interface QueryBackend {
     /** Perform index integrity check. */
     doctor(): Promise<any>;
     /** Atomic wipe and rebuild. */
-    rebuild(): Promise<void>;
+    rebuild(options?: {
+        strict?: boolean;
+    }): Promise<any>;
+    /** Incremental index update. */
+    sync(options?: {
+        strict?: boolean;
+    }): Promise<any>;
+    /** Apply pending schema migrations. */
+    migrate(): Promise<{
+        applied: number;
+    }>;
+    /** Execute raw SQL (if supported). */
+    executeRawSql(sql: string): Promise<any[]>;
     /** Find all transaction receipts (for replay analysis). */
     findReceipts(filters?: {
         status?: string;
@@ -340,6 +352,10 @@ interface QueryEngineOptions {
     readonly artifactDir: string;
     /** Primary data backend. If not provided, defaults to auto-discovery (SQLite > Filesystem). */
     readonly backend?: QueryBackend;
+    /** Automatically synchronize the store before queries. Requires 'query-store' lock. */
+    readonly autoSync?: boolean;
+    /** Whether to wait for the lock if held. */
+    readonly waitLock?: boolean;
 }
 declare class QueryEngine {
     private readonly adapters;

package/dist/index.js

@@ -100,7 +100,15 @@ var FilesystemQueryBackend = class {
   async doctor() {
     return { ok: true, backend: "filesystem" };
   }
-  async rebuild() {
+  async rebuild(options) {
+    return {
+      schema: "hardkas.queryRebuild.v1",
+      ok: true,
+      artifacts: { scanned: 0, indexed: 0, duplicates: 0, corrupted: 0 },
+      events: { scanned: 0, indexed: 0, duplicates: 0, corrupted: 0 },
+      warnings: ["Filesystem backend does not support indexing"],
+      errors: []
+    };
   }
   async findReceipts(filters) {
     return this.findArtifacts({ schema: "hardkas.txReceipt", ...filters });
@@ -112,6 +120,15 @@ var FilesystemQueryBackend = class {
     }
     return artifacts;
   }
+  async sync(options) {
+    return this.rebuild(options);
+  }
+  async migrate() {
+    return { applied: 0 };
+  }
+  async executeRawSql(_sql) {
+    throw new Error("Raw SQL execution not supported by Filesystem backend. Use SQLite backend.");
+  }
   async scanFiles(dir) {
     const results = [];
     try {
@@ -1906,6 +1923,7 @@ var TxQueryAdapter = class {
 };
 
 // src/engine.ts
+import { withLock } from "@hardkas/core";
 import fs6 from "fs";
 import path6 from "path";
 var QueryEngine = class _QueryEngine {
@@ -1922,9 +1940,22 @@ var QueryEngine = class _QueryEngine {
         try {
           const { HardkasStore, SqliteQueryBackend, HardkasIndexer } = await import("@hardkas/query-store");
           const store = new HardkasStore({ dbPath });
-          store.connect();
-          const indexer = new HardkasIndexer(store.getDatabase());
-          await indexer.sync();
+          if (options.autoSync) {
+            await withLock({
+              rootDir: options.artifactDir,
+              name: "query-store",
+              command: "query-engine-auto-sync",
+              wait: options.waitLock ?? false,
+              timeoutMs: 5e3
+              // Short timeout for auto-sync
+            }, async () => {
+              store.connect({ autoMigrate: true });
+              const indexer = new HardkasIndexer(store.getDatabase());
+              await indexer.sync();
+            });
+          } else {
+            store.connect();
+          }
           backend = new SqliteQueryBackend(store);
         } catch (e) {
           backend = new FilesystemQueryBackend(options.artifactDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardkas/query",
-  "version": "0.2.2-alpha.1",
+  "version": "0.3.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.2.2-alpha.1",
-    "@hardkas/query-store": "0.2.2-alpha.1",
-    "@hardkas/artifacts": "0.2.2-alpha.1"
+    "@hardkas/core": "0.3.0-alpha",
+    "@hardkas/query-store": "0.3.0-alpha",
+    "@hardkas/artifacts": "0.3.0-alpha"
   },
   "devDependencies": {
     "tsup": "^8.3.5",