sekejap 0.16.0 → 0.16.2

package/index.d.ts

@@ -18,6 +18,21 @@ export declare class Db {
   query(sql: string): string
   /** Parameterized SELECT ($1, $2, …); `paramsJson` is a JSON array string. */
   queryParams(sql: string, paramsJson: string): string
+  /**
+   * Parameterized mutating statement ($1, $2, …); `paramsJson` is a JSON array
+   * string. Returns affected rows. The typed layer's update/delete lower here.
+   */
+  executeParams(sql: string, paramsJson: string): number
+  /**
+   * Subscribe to the change feed. `callback` is invoked once per committed
+   * mutation (a transaction fires once, at COMMIT) with a JSON string
+   * `{"collections":[…],"keys":[…],"edge_types":[…]}`. Returns a subscription
+   * id; pass it to [`unwatch`] to stop. The napi ThreadsafeFunction marshals
+   * the call onto the JS event loop, so no manual threading is needed.
+   */
+  watch(callback: (arg: string) => any): number
+  /** Stop a change-feed subscription created by [`watch`]. */
+  unwatch(id: number): void
   /** Compile a query once for repeated execution — a prepared statement. */
   prepare(sql: string): PreparedStatement
   /**
@@ -35,6 +50,89 @@ export declare class Db {
   edgeCount(): number
   /** Compact: truncate WAL, rewrite payloads/topology, reclaim RAM. */
   compact(): void
+  /**
+   * Open an existing database in paged mode: identity/topology served from
+   * memory-mapped files — small open time and resident memory at any size.
+   */
+  static openPaged(path: string): Db
+  /** Open an existing database read-only. */
+  static openReadOnly(path: string): Db
+  /** A node's raw JSON payload, or null. */
+  get(slug: string): string | null
+  /** True if the node exists. */
+  contains(slug: string): boolean
+  /** Delete a node (and its edges). */
+  remove(slug: string): void
+  /**
+   * Store many nodes in one batch (single disk sync).
+   * `pairsJson` is a JSON array of `[slug, payloadJson]` pairs.
+   */
+  putMany(pairsJson: string): number
+  /** Begin a bulk-load scope (defer the per-write disk sync). Pair with `endBulk`. */
+  beginBulk(): void
+  /** End a bulk-load scope: one disk sync for the whole batch. */
+  endBulk(): void
+  /** Store an embedding under a named field of a node. */
+  putVector(slug: string, field: string, data: Array<number>): void
+  /** The stored embedding for a node's field, or null. */
+  getVector(slug: string, field: string): Array<number> | null
+  /** Create an edge with JSON attributes (primitives ride fast columns). */
+  linkMeta(from: string, to: string, edgeType: string, metaJson: string): void
+  /**
+   * Create many edges in one batch (single disk sync).
+   * `edgesJson` is a JSON array of `[from, to, edgeType]` triples.
+   */
+  linkMany(edgesJson: string): void
+  /** Remove a directed edge. */
+  unlink(from: string, to: string, edgeType: string): void
+  /**
+   * Remove edges matching attribute equality conditions (`propsJson` is a
+   * JSON object). Returns how many were removed.
+   */
+  unlinkWhere(from: string, to: string, edgeType: string, propsJson: string): number
+  /**
+   * Update attributes on matching edges: `propsJson` selects, `setsJson`
+   * assigns. Returns how many were updated.
+   */
+  updateEdge(from: string, to: string, edgeType: string, propsJson: string, setsJson: string): number
+  /**
+   * Edges leaving a node, as a JSON-array string of
+   * `{from, to, type, meta}` objects.
+   */
+  edgesFrom(slug: string): string
+  /** Edges arriving at a node, same shape as `edgesFrom`. */
+  edgesTo(slug: string): string
+  /** Edges from one collection to another, same shape as `edgesFrom`. */
+  edgesBetween(fromCollection: string, toCollection: string): string
+  /** All collection names. */
+  collectionNames(): Array<string>
+  /** Every node slug. */
+  allSlugs(): Array<string>
+  /** DDL string for a collection schema, or null. */
+  schemaDdl(collection: string): string | null
+  /**
+   * Ranked text search over a BM25-indexed field: JSON-array string of
+   * `[slug, score]` pairs, best first.
+   */
+  bm25Search(field: string, query: string, topK: number): string
+  /**
+   * The query plan for a statement, as a JSON-array string (one step per
+   * element). `analyze = true` also executes it and adds per-step timings.
+   */
+  explain(sql: string, analyze?: boolean | undefined | null): string
+  /** Run a SHOW statement (`SHOW TABLES`, `SHOW EDGES`, …); JSON-array string. */
+  show(sql: string): string
+  /** Shrink resident memory to the live working set (never drops indexes). */
+  trimMemory(): void
+  /** Per-structure resident-memory estimate, as a JSON object string. */
+  memoryReport(): string
+  /** Override HNSW search breadth (`efSearch`); null restores the default. */
+  setHnswEfSearch(ef?: number | undefined | null): void
+  /**
+   * Close the database and release its lock. Further calls error (or no-op
+   * for count/list getters). Safe to call twice.
+   */
+  close(): void
 }
 /** A prepared (compiled) query — from `Db.prepare`, run with `Db.queryPrepared`. */
 export declare class PreparedStatement { }

package/package.json

@@ -1,24 +1,76 @@
 {
   "name": "sekejap",
-  "version": "0.16.0",
-  "description": "Embedded graph-first multi-model database — Node.js binding",
+  "version": "0.16.2",
+  "description": "Embedded graph-first multi-model database — Node.js & React Native binding",
   "license": "MIT OR Apache-2.0",
   "repository": "github:sekejapdb/sekejap",
-  "homepage": "https://sekejap.zebflow.com",
-  "keywords": ["database", "graph", "vector", "spatial", "embedded", "multi-model"],
+  "homepage": "https://sekejap.life",
+  "keywords": [
+    "database",
+    "graph",
+    "vector",
+    "spatial",
+    "embedded",
+    "multi-model",
+    "typescript",
+    "react-native"
+  ],
   "main": "index.js",
   "types": "index.d.ts",
-  "files": ["index.js", "index.d.ts", "*.node", "README.md"],
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    },
+    "./orm": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./orm/react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node",
+    "dist/",
+    "README.md"
+  ],
   "napi": {
     "name": "sekejap"
   },
-  "engines": { "node": ">= 16" },
-  "os": ["darwin", "linux", "win32"],
-  "cpu": ["x64", "arm64"],
+  "engines": {
+    "node": ">= 16"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
   "scripts": {
-    "build": "napi build --platform --release"
+    "build": "napi build --platform --release",
+    "build:orm": "tsc -p orm/tsconfig.build.json",
+    "test:orm": "tsx orm/orm.test.ts"
+  },
+  "peerDependencies": {
+    "react": ">=17"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.0"
+    "@napi-rs/cli": "^2.18.0",
+    "@types/node": "^20.19.43",
+    "@types/react": "^18.3.31",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.3"
   }
 }