mcard-js 2.1.39 → 2.1.41

package/dist/storage/SqliteNodeEngine.d.cts

@@ -1,10 +1,14 @@
-import { S as StorageEngine, M as MCard, P as Page } from '../StorageAdapter-DdDUiIvH.cjs';
+import { A as AbstractSqlEngine, M as MCard, P as Page } from '../AbstractSqlEngine-BSfp8S_Y.cjs';
 
 /**
  * SqliteNodeEngine - Native SQLite backend for Node.js using better-sqlite3
  *
  * Provides synchronous SQLite operations with the same schema as Python implementation.
  * Supports both file-based and in-memory databases.
+ *
+ * Handle operations (register, resolve, update, rename, prune, etc.) are
+ * inherited from AbstractSqlEngine — only card operations and sync helpers
+ * are implemented here.
  */
 
 /**
@@ -12,13 +16,13 @@ import { S as StorageEngine, M as MCard, P as Page } from '../StorageAdapter-DdD
  *
  * Uses better-sqlite3 for synchronous, high-performance SQLite operations.
  */
-declare class SqliteNodeEngine implements StorageEngine {
+declare class SqliteNodeEngine extends AbstractSqlEngine {
     private db;
     private dbPath;
     /**
      * Convert a database row into an MCard instance.
      */
-    private static rowToCard;
+    protected rowToCard(row: Record<string, unknown>): MCard;
     /**
      * Create a new SqliteNodeEngine via async factory.
      * @param dbPath Path to database file, or ':memory:' for in-memory database
@@ -30,6 +34,8 @@ declare class SqliteNodeEngine implements StorageEngine {
      * Initialize database schema
      */
     private setupDatabase;
+    protected queryRows(sql: string, ...params: unknown[]): Promise<Record<string, unknown>[]>;
+    protected execSql(sql: string, ...params: unknown[]): Promise<number>;
     /**
      * Close the database connection
      */
@@ -39,106 +45,15 @@ declare class SqliteNodeEngine implements StorageEngine {
      */
     getDbPath(): string;
     add(card: MCard): Promise<string>;
-    /**
-     * Add a card synchronously (for performance-critical paths)
-     */
     addSync(card: MCard): string;
-    get(hash: string): Promise<MCard | null>;
-    /**
-     * Get a card synchronously
-     */
     getSync(hash: string): MCard | null;
-    delete(hash: string): Promise<void>;
-    /**
-     * Delete a card synchronously
-     */
     deleteSync(hash: string): boolean;
-    getPage(pageNumber?: number, pageSize?: number): Promise<Page<MCard>>;
-    /**
-     * Get a page of cards synchronously
-     */
     getPageSync(pageNumber?: number, pageSize?: number): Page<MCard>;
-    count(): Promise<number>;
-    /**
-     * Count cards synchronously
-     */
     countSync(): number;
-    searchByHash(hashPrefix: string): Promise<MCard[]>;
-    search(query: string, pageNumber: number, pageSize: number): Promise<Page<MCard>>;
-    getAll(): Promise<MCard[]>;
-    clear(): Promise<void>;
-    /**
-     * Clear all data synchronously
-     * Delete in FK-safe order: children first, then parents
-     */
     clearSync(): void;
-    /**
-     * Search cards by string in content, hash, or g_time
-     */
     searchByString(searchString: string, pageNumber?: number, pageSize?: number): Page<MCard>;
-    /**
-     * Search cards by content pattern (binary-safe)
-     */
     searchByContent(searchPattern: string | Uint8Array, pageNumber?: number, pageSize?: number): Page<MCard>;
-    /**
-     * Get all cards (single page with all items)
-     */
     getAllCards(): Page<MCard>;
-    registerHandle(handle: string, hash: string): Promise<void>;
-    /**
-     * Register a handle synchronously
-     */
-    registerHandleSync(handle: string, hash: string): void;
-    resolveHandle(handle: string): Promise<string | null>;
-    /**
-     * Resolve a handle synchronously
-     */
-    resolveHandleSync(handle: string): string | null;
-    getByHandle(handle: string): Promise<MCard | null>;
-    /**
-     * Get card by handle synchronously
-     */
-    getByHandleSync(handle: string): MCard | null;
-    updateHandle(handle: string, newHash: string): Promise<string>;
-    /**
-     * Update a handle synchronously
-     */
-    updateHandleSync(handle: string, newHash: string): string;
-    getHandleHistory(handle: string): Promise<{
-        previousHash: string;
-        changedAt: string;
-    }[]>;
-    /**
-     * Get handle history synchronously
-     */
-    getHandleHistorySync(handle: string): {
-        previousHash: string;
-        changedAt: string;
-    }[];
-    pruneHandleHistory(handle: string, options?: {
-        olderThan?: string;
-        deleteAll?: boolean;
-    }): Promise<number>;
-    /**
-     * Prune handle history synchronously
-     */
-    pruneHandleHistorySync(handle: string, options?: {
-        olderThan?: string;
-        deleteAll?: boolean;
-    }): number;
-    getAllHandles(): Promise<{
-        handle: string;
-        hash: string;
-    }[]>;
-    getAllHandlesSync(): {
-        handle: string;
-        hash: string;
-    }[];
-    removeHandle(handle: string): Promise<void>;
-    removeHandleSync(handle: string): void;
-    renameHandle(oldHandle: string, newHandle: string): Promise<void>;
-    renameHandleSync(oldHandle: string, newHandle: string): void;
-    deleteHistoryEntry(handle: string, previousHash: string): Promise<void>;
     deleteHistoryEntrySync(handle: string, previousHash: string): void;
 }
 

package/dist/storage/SqliteNodeEngine.d.ts

@@ -1,10 +1,14 @@
-import { S as StorageEngine, M as MCard, P as Page } from '../StorageAdapter-DdDUiIvH.js';
+import { A as AbstractSqlEngine, M as MCard, P as Page } from '../AbstractSqlEngine-BSfp8S_Y.js';
 
 /**
  * SqliteNodeEngine - Native SQLite backend for Node.js using better-sqlite3
  *
  * Provides synchronous SQLite operations with the same schema as Python implementation.
  * Supports both file-based and in-memory databases.
+ *
+ * Handle operations (register, resolve, update, rename, prune, etc.) are
+ * inherited from AbstractSqlEngine — only card operations and sync helpers
+ * are implemented here.
  */
 
 /**
@@ -12,13 +16,13 @@ import { S as StorageEngine, M as MCard, P as Page } from '../StorageAdapter-DdD
  *
  * Uses better-sqlite3 for synchronous, high-performance SQLite operations.
  */
-declare class SqliteNodeEngine implements StorageEngine {
+declare class SqliteNodeEngine extends AbstractSqlEngine {
     private db;
     private dbPath;
     /**
      * Convert a database row into an MCard instance.
      */
-    private static rowToCard;
+    protected rowToCard(row: Record<string, unknown>): MCard;
     /**
      * Create a new SqliteNodeEngine via async factory.
      * @param dbPath Path to database file, or ':memory:' for in-memory database
@@ -30,6 +34,8 @@ declare class SqliteNodeEngine implements StorageEngine {
      * Initialize database schema
      */
     private setupDatabase;
+    protected queryRows(sql: string, ...params: unknown[]): Promise<Record<string, unknown>[]>;
+    protected execSql(sql: string, ...params: unknown[]): Promise<number>;
     /**
      * Close the database connection
      */
@@ -39,106 +45,15 @@ declare class SqliteNodeEngine implements StorageEngine {
      */
     getDbPath(): string;
     add(card: MCard): Promise<string>;
-    /**
-     * Add a card synchronously (for performance-critical paths)
-     */
     addSync(card: MCard): string;
-    get(hash: string): Promise<MCard | null>;
-    /**
-     * Get a card synchronously
-     */
     getSync(hash: string): MCard | null;
-    delete(hash: string): Promise<void>;
-    /**
-     * Delete a card synchronously
-     */
     deleteSync(hash: string): boolean;
-    getPage(pageNumber?: number, pageSize?: number): Promise<Page<MCard>>;
-    /**
-     * Get a page of cards synchronously
-     */
     getPageSync(pageNumber?: number, pageSize?: number): Page<MCard>;
-    count(): Promise<number>;
-    /**
-     * Count cards synchronously
-     */
     countSync(): number;
-    searchByHash(hashPrefix: string): Promise<MCard[]>;
-    search(query: string, pageNumber: number, pageSize: number): Promise<Page<MCard>>;
-    getAll(): Promise<MCard[]>;
-    clear(): Promise<void>;
-    /**
-     * Clear all data synchronously
-     * Delete in FK-safe order: children first, then parents
-     */
     clearSync(): void;
-    /**
-     * Search cards by string in content, hash, or g_time
-     */
     searchByString(searchString: string, pageNumber?: number, pageSize?: number): Page<MCard>;
-    /**
-     * Search cards by content pattern (binary-safe)
-     */
     searchByContent(searchPattern: string | Uint8Array, pageNumber?: number, pageSize?: number): Page<MCard>;
-    /**
-     * Get all cards (single page with all items)
-     */
     getAllCards(): Page<MCard>;
-    registerHandle(handle: string, hash: string): Promise<void>;
-    /**
-     * Register a handle synchronously
-     */
-    registerHandleSync(handle: string, hash: string): void;
-    resolveHandle(handle: string): Promise<string | null>;
-    /**
-     * Resolve a handle synchronously
-     */
-    resolveHandleSync(handle: string): string | null;
-    getByHandle(handle: string): Promise<MCard | null>;
-    /**
-     * Get card by handle synchronously
-     */
-    getByHandleSync(handle: string): MCard | null;
-    updateHandle(handle: string, newHash: string): Promise<string>;
-    /**
-     * Update a handle synchronously
-     */
-    updateHandleSync(handle: string, newHash: string): string;
-    getHandleHistory(handle: string): Promise<{
-        previousHash: string;
-        changedAt: string;
-    }[]>;
-    /**
-     * Get handle history synchronously
-     */
-    getHandleHistorySync(handle: string): {
-        previousHash: string;
-        changedAt: string;
-    }[];
-    pruneHandleHistory(handle: string, options?: {
-        olderThan?: string;
-        deleteAll?: boolean;
-    }): Promise<number>;
-    /**
-     * Prune handle history synchronously
-     */
-    pruneHandleHistorySync(handle: string, options?: {
-        olderThan?: string;
-        deleteAll?: boolean;
-    }): number;
-    getAllHandles(): Promise<{
-        handle: string;
-        hash: string;
-    }[]>;
-    getAllHandlesSync(): {
-        handle: string;
-        hash: string;
-    }[];
-    removeHandle(handle: string): Promise<void>;
-    removeHandleSync(handle: string): void;
-    renameHandle(oldHandle: string, newHandle: string): Promise<void>;
-    renameHandleSync(oldHandle: string, newHandle: string): void;
-    deleteHistoryEntry(handle: string, previousHash: string): Promise<void>;
     deleteHistoryEntrySync(handle: string, previousHash: string): void;
 }
 

package/dist/storage/SqliteNodeEngine.js

@@ -1,11 +1,12 @@
 import {
   SqliteNodeEngine
-} from "../chunk-2VNRWIBZ.js";
-import "../chunk-DWXNZ5AJ.js";
-import "../chunk-NZ6OQ7UT.js";
-import "../chunk-WVFWNVT2.js";
+} from "../chunk-FIE4LAJG.js";
+import "../chunk-RSTKX7WM.js";
+import "../chunk-3EIBJPNF.js";
+import "../chunk-ADV52544.js";
+import "../chunk-3MMMJ7NH.js";
 import "../chunk-7NKII2JA.js";
-import "../chunk-MLKGABMK.js";
+import "../chunk-PNKVD2UK.js";
 export {
   SqliteNodeEngine
 };