@sochdb/sochdb 0.4.0

package/dist/types/ipc-client.d.ts

@@ -0,0 +1,177 @@
+/**
+ * SochDB IPC Client
+ *
+ * Connects to a SochDB IPC server via Unix domain socket.
+ *
+ * @packageDocumentation
+ */
+import { Query } from './query';
+/**
+ * Wire protocol opcodes.
+ */
+export declare const OpCode: {
+    readonly Put: 1;
+    readonly Get: 2;
+    readonly Delete: 3;
+    readonly BeginTxn: 4;
+    readonly CommitTxn: 5;
+    readonly AbortTxn: 6;
+    readonly Query: 7;
+    readonly CreateTable: 8;
+    readonly PutPath: 9;
+    readonly GetPath: 10;
+    readonly Scan: 11;
+    readonly Checkpoint: 12;
+    readonly Stats: 13;
+    readonly Ping: 14;
+    readonly OK: 128;
+    readonly Error: 129;
+    readonly Value: 130;
+    readonly TxnId: 131;
+    readonly Row: 132;
+    readonly EndStream: 133;
+    readonly StatsResp: 134;
+    readonly Pong: 135;
+};
+/**
+ * Configuration options for IpcClient.
+ */
+export interface IpcClientConfig {
+    /** Path to Unix domain socket */
+    socketPath: string;
+    /** Connection timeout in milliseconds (default: 5000) */
+    connectTimeout?: number;
+    /** Read timeout in milliseconds (default: 30000) */
+    readTimeout?: number;
+}
+/**
+ * IPC Client for SochDB.
+ *
+ * Connects to a SochDB server via Unix domain socket.
+ *
+ * @example
+ * ```typescript
+ * import { IpcClient } from '@sushanth/sochdb';
+ *
+ * const client = await IpcClient.connect('/tmp/sochdb.sock');
+ *
+ * await client.put(Buffer.from('key'), Buffer.from('value'));
+ * const value = await client.get(Buffer.from('key'));
+ *
+ * await client.close();
+ * ```
+ */
+export declare class IpcClient {
+    private _socket;
+    private _config;
+    private _pendingReads;
+    private _readBuffer;
+    private _closed;
+    private constructor();
+    /**
+     * Connect to a SochDB IPC server.
+     *
+     * @param socketPath - Path to the Unix domain socket
+     * @returns A connected IpcClient instance
+     *
+     * @example
+     * ```typescript
+     * const client = await IpcClient.connect('/tmp/sochdb.sock');
+     * ```
+     */
+    static connect(socketPath: string): Promise<IpcClient>;
+    private _connect;
+    private _processBuffer;
+    private _send;
+    private _parseResponse;
+    /**
+     * Encode a key for the wire protocol.
+     * @internal
+     */
+    static encodeKey(key: Buffer): Buffer;
+    /**
+     * Encode a key-value pair for the wire protocol.
+     * @internal
+     */
+    static encodeKeyValue(key: Buffer, value: Buffer): Buffer;
+    /**
+     * Get a value by key.
+     */
+    get(key: Buffer): Promise<Buffer | null>;
+    /**
+     * Put a key-value pair.
+     */
+    put(key: Buffer, value: Buffer): Promise<void>;
+    /**
+     * Delete a key.
+     */
+    delete(key: Buffer): Promise<void>;
+    /**
+     * Get a value by path.
+     * Wire format: path_count(2 LE) + [path_len(2 LE) + path_segment]...
+     */
+    getPath(path: string): Promise<Buffer | null>;
+    /**
+     * Put a value at a path.
+     * Wire format: path_count(2 LE) + [path_len(2 LE) + path_segment]... + value
+     */
+    putPath(path: string, value: Buffer): Promise<void>;
+    /**
+     * Execute a query and return TOON-formatted results.
+     *
+     * Wire format: path_len(2) + path + limit(4) + offset(4) + cols_count(2) + [col_len(2) + col]...
+     */
+    query(pathPrefix: string, options?: {
+        limit?: number;
+        offset?: number;
+        columns?: string[];
+    }): Promise<string>;
+    /**
+     * Scan for keys with a prefix, returning key-value pairs.
+     * This is the preferred method for simple prefix-based iteration.
+     *
+     * Wire format: prefix string
+     * Response format: count(4 LE) + [key_len(2 LE) + key + val_len(4 LE) + val]...
+     */
+    scan(prefix: string): Promise<Array<{
+        key: Buffer;
+        value: Buffer;
+    }>>;
+    /**
+     * Create a query builder.
+     */
+    queryBuilder(pathPrefix: string): Query;
+    /**
+     * Begin a new transaction.
+     */
+    beginTransaction(): Promise<bigint>;
+    /**
+     * Commit a transaction.
+     */
+    commitTransaction(txnId: bigint): Promise<void>;
+    /**
+     * Abort a transaction.
+     */
+    abortTransaction(txnId: bigint): Promise<void>;
+    /**
+     * Force a checkpoint.
+     */
+    checkpoint(): Promise<void>;
+    /**
+     * Get storage statistics.
+     */
+    stats(): Promise<{
+        memtableSizeBytes: number;
+        walSizeBytes: number;
+        activeTransactions: number;
+    }>;
+    /**
+     * Ping the server.
+     */
+    ping(): Promise<boolean>;
+    /**
+     * Close the connection.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ipc-client.d.ts.map

package/dist/types/ipc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc-client.d.ts","sourceRoot":"","sources":["../../src/ipc-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;CA0BT,CAAC;AA6BX;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,aAAa,CAGb;IACR,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO;IAQP;;;;;;;;;;OAUG;WACU,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;YAM9C,QAAQ;IAoCtB,OAAO,CAAC,cAAc;YAoBR,KAAK;IAgCnB,OAAO,CAAC,cAAc;IAYtB;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAWrC;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAazD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAc9C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBnD;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD;;;;OAIG;IACG,KAAK,CACT,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAChE,OAAO,CAAC,MAAM,CAAC;IA6ClB;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA8C1E;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK;IAIvC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAUzC;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;OAEG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IAWF;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAU9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}

package/dist/types/query.d.ts

@@ -0,0 +1,85 @@
+/**
+ * SochDB Query Builder
+ *
+ * Fluent query interface for SochDB.
+ *
+ * @packageDocumentation
+ */
+import { IpcClient } from './ipc-client';
+/**
+ * Query result row.
+ */
+export interface QueryResult {
+    [key: string]: unknown;
+}
+/**
+ * Fluent query builder for SochDB.
+ *
+ * @example
+ * ```typescript
+ * const results = await db.query('users/')
+ *   .limit(10)
+ *   .select(['name', 'email'])
+ *   .toList();
+ * ```
+ */
+export declare class Query {
+    private _client;
+    private _pathPrefix;
+    private _limit?;
+    private _offset?;
+    private _columns?;
+    constructor(client: IpcClient, pathPrefix: string);
+    /**
+     * Limit the number of results.
+     *
+     * @param n - Maximum number of results to return
+     * @returns This query builder for chaining
+     */
+    limit(n: number): Query;
+    /**
+     * Skip the first n results.
+     *
+     * @param n - Number of results to skip
+     * @returns This query builder for chaining
+     */
+    offset(n: number): Query;
+    /**
+     * Select specific columns to return.
+     *
+     * @param columns - Array of column names to select
+     * @returns This query builder for chaining
+     */
+    select(columns: string[]): Query;
+    /**
+     * Execute the query and return results as TOON string.
+     *
+     * @returns TOON formatted string (e.g., "result[N]{cols}: row1; row2")
+     */
+    execute(): Promise<string>;
+    /**
+     * Execute and parse results into a list of objects.
+     *
+     * @returns Array of result objects
+     */
+    toList(): Promise<QueryResult[]>;
+    /**
+     * Execute and return the first result, or null if none.
+     *
+     * @returns First result or null
+     */
+    first(): Promise<QueryResult | null>;
+    /**
+     * Execute and return the count of results.
+     *
+     * @returns Number of matching results
+     */
+    count(): Promise<number>;
+    /**
+     * Simple TOON parser.
+     *
+     * Parses TOON format: "result[N]{col1,col2}: val1,val2; val3,val4"
+     */
+    private _parseToon;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/types/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAW;gBAEhB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM;IAKjD;;;;;OAKG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK;IAKvB;;;;;OAKG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK;IAKxB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK;IAKhC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAQhC;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKtC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQ1C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAK9B;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAmDnB"}

package/dist/types/server-manager.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SochDB Embedded Server Manager
+ *
+ * Manages the lifecycle of the SochDB server process for embedded mode.
+ * Automatically starts the server when needed and stops it on cleanup.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Start an embedded SochDB server for the given database path.
+ * If a server is already running for this path, return the existing instance.
+ *
+ * @param dbPath - Path to the database directory
+ * @returns The socket path for connecting
+ */
+export declare function startEmbeddedServer(dbPath: string): Promise<string>;
+/**
+ * Stop the embedded server for a specific database path
+ */
+export declare function stopEmbeddedServer(dbPath: string): Promise<void>;
+/**
+ * Stop all running embedded servers
+ */
+export declare function stopAllEmbeddedServers(): Promise<void>;
+/**
+ * Check if an embedded server is running for a database path
+ */
+export declare function isServerRunning(dbPath: string): boolean;
+//# sourceMappingURL=server-manager.d.ts.map

package/dist/types/server-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.d.ts","sourceRoot":"","sources":["../../src/server-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8HH;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+EzE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCtE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIvD"}

package/dist/types/sql-engine.d.ts

@@ -0,0 +1,100 @@
+/**
+ * SQL Engine for SochDB JavaScript SDK
+ *
+ * Provides SQL support on top of the KV storage backend.
+ * Tables are stored as:
+ *   - Schema: _sql/tables/{table_name}/schema -> JSON schema definition
+ *   - Rows: _sql/tables/{table_name}/rows/{row_id} -> JSON row data
+ *
+ * @packageDocumentation
+ */
+/**
+ * Result of a SQL query execution.
+ */
+export interface SQLQueryResult {
+    /** Result rows */
+    rows: Array<Record<string, any>>;
+    /** Column names */
+    columns: string[];
+    /** Number of rows affected (for INSERT/UPDATE/DELETE) */
+    rowsAffected: number;
+}
+/**
+ * Parsed SQL operation result.
+ */
+type ParsedSQL = {
+    operation: string;
+    data: Record<string, any>;
+};
+/**
+ * Simple SQL parser for DDL and DML operations.
+ */
+export declare class SQLParser {
+    /**
+     * Parse a SQL statement.
+     */
+    static parse(sql: string): ParsedSQL;
+    private static parseCreateTable;
+    private static splitColumns;
+    private static parseDropTable;
+    private static parseCreateIndex;
+    private static parseDropIndex;
+    private static parseInsert;
+    private static parseValues;
+    private static parseValue;
+    private static parseSelect;
+    private static parseWhere;
+    private static parseUpdate;
+    private static parseDelete;
+}
+/**
+ * Interface for database operations required by SQLExecutor.
+ */
+interface DatabaseInterface {
+    get(key: Buffer | string): Promise<Buffer | null>;
+    put(key: Buffer | string, value: Buffer | string): Promise<void>;
+    delete(key: Buffer | string): Promise<void>;
+    scan(prefix: string): Promise<Array<{
+        key: Buffer;
+        value: Buffer;
+    }>>;
+}
+/**
+ * SQL Executor that operates on a KV database.
+ */
+export declare class SQLExecutor {
+    private db;
+    private readonly TABLE_PREFIX;
+    private readonly SCHEMA_SUFFIX;
+    private readonly ROWS_PREFIX;
+    private readonly INDEX_PREFIX;
+    constructor(db: DatabaseInterface);
+    /**
+     * Execute a SQL statement.
+     */
+    execute(sql: string): Promise<SQLQueryResult>;
+    private schemaKey;
+    private rowKey;
+    private rowPrefix;
+    private indexMetaKey;
+    private indexPrefix;
+    private indexKey;
+    private indexValuePrefix;
+    private getSchema;
+    private getIndexes;
+    private hasIndexForColumn;
+    private lookupByIndex;
+    private updateIndex;
+    private findIndexedEqualityCondition;
+    private createTable;
+    private dropTable;
+    private createIndex;
+    private dropIndex;
+    private insert;
+    private select;
+    private matchesConditions;
+    private update;
+    private deleteRows;
+}
+export {};
+//# sourceMappingURL=sql-engine.d.ts.map

package/dist/types/sql-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-engine.d.ts","sourceRoot":"","sources":["../../src/sql-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB;IAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IACjC,mBAAmB;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;CACtB;AA8BD;;GAEG;AACH,KAAK,SAAS,GAAG;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAyBpC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAsE/B,OAAO,CAAC,MAAM,CAAC,YAAY;IA2B3B,OAAO,CAAC,MAAM,CAAC,cAAc;IAQ7B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAgB/B,OAAO,CAAC,MAAM,CAAC,cAAc;IAe7B,OAAO,CAAC,MAAM,CAAC,WAAW;IAwB1B,OAAO,CAAC,MAAM,CAAC,WAAW;IA8B1B,OAAO,CAAC,MAAM,CAAC,UAAU;IA4BzB,OAAO,CAAC,MAAM,CAAC,WAAW;IA2D1B,OAAO,CAAC,MAAM,CAAC,UAAU;IAkBzB,OAAO,CAAC,MAAM,CAAC,WAAW;IA2B1B,OAAO,CAAC,MAAM,CAAC,WAAW;CAc3B;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;IAG9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,EAAE,EAAE,iBAAiB;IAIjC;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyBnD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,gBAAgB;YAIV,SAAS;YAMT,UAAU;YAqBV,iBAAiB;YAUjB,aAAa;YAMb,WAAW;IA4BzB,OAAO,CAAC,4BAA4B;YAatB,WAAW;YAgBX,SAAS;YA8BT,WAAW;YA8CX,SAAS;YAoBT,MAAM;YAkDN,MAAM;IAwEpB,OAAO,CAAC,iBAAiB;YA2CX,MAAM;YAuFN,UAAU;CA0FzB"}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@sochdb/sochdb",
+  "version": "0.4.0",
+  "description": "SochDB is an AI-native database with token-optimized output, O(|path|) lookups, built-in vector search, and durable transactions.",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "_bin",
+    "bin",
+    "scripts/postinstall.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "sochdb-server": "./bin/sochdb-server.js",
+    "sochdb-bulk": "./bin/sochdb-bulk.js",
+    "sochdb-grpc-server": "./bin/sochdb-grpc-server.js"
+  },
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm && npm run build:types && npm run postbuild",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "postbuild": "node scripts/fix-esm-imports.js",
+    "postinstall": "node scripts/postinstall.js",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "keywords": [
+    "database",
+    "llm",
+    "ai",
+    "vector-search",
+    "embedded",
+    "key-value",
+    "sochdb",
+    "context-retrieval",
+    "transactions"
+  ],
+  "author": "Sushanth <sushanth@sochdb.dev>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sochdb/sochdb.git",
+    "directory": "sochdb-nodejs-sdk"
+  },
+  "homepage": "https://sochdb.dev",
+  "bugs": {
+    "url": "https://github.com/sochdb/sochdb/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "@types/uuid": "^9.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "@grpc/grpc-js": "^1.12.4",
+    "@grpc/proto-loader": "^0.7.15",
+    "koffi": "^2.15.0",
+    "uuid": "^9.0.0"
+  },
+  "optionalDependencies": {
+    "posthog-node": "^4.18.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * Post-install script to ensure native binaries are executable on Unix systems.
+ * This is required because npm doesn't preserve executable permissions during publish.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Only run on Unix-like systems
+if (process.platform === 'win32') {
+  console.log('[sochdb] Skipping chmod on Windows');
+  process.exit(0);
+}
+
+const binDir = path.join(__dirname, '..', '_bin');
+
+if (!fs.existsSync(binDir)) {
+  console.log('[sochdb] No _bin directory found, skipping postinstall (will be populated on first use)');
+  process.exit(0);
+}
+
+const binaryNames = ['sochdb-server', 'sochdb-bulk', 'sochdb-grpc-server'];
+const targets = [
+  'aarch64-apple-darwin',
+  'x86_64-apple-darwin',
+  'aarch64-unknown-linux-gnu',
+  'x86_64-unknown-linux-gnu'
+];
+
+let fixed = 0;
+for (const target of targets) {
+  for (const binaryName of binaryNames) {
+    const binaryPath = path.join(binDir, target, binaryName);
+    if (fs.existsSync(binaryPath)) {
+      try {
+        // Make executable
+        fs.chmodSync(binaryPath, 0o755);
+        fixed++;
+      } catch (err) {
+        console.warn(`[sochdb] Warning: Could not chmod ${binaryPath}: ${err.message}`);
+      }
+    }
+  }
+}
+
+if (fixed > 0) {
+  console.log(`[sochdb] Made ${fixed} native binaries executable`);
+}