kitedb 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 N-API for Rust
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# kitedb
+
+KiteDB native bindings for Node.js (and WASI/browser builds), powered by Rust + N-API.
+
+Docs: https://ray-kwaf.vercel.app/docs
+
+## Install
+
+```bash
+npm install kitedb
+# or
+pnpm add kitedb
+# or
+yarn add kitedb
+```
+
+This package ships prebuilt binaries for major platforms. If a prebuild isn't available for your target, you'll need a Rust toolchain to build from source.
+
+## Quickstart (fluent API)
+
+The fluent API provides a high-level, type-safe interface for schema-driven workflows:
+
+```ts
+import { ray, node, edge, prop, optional } from 'kitedb'
+
+// Define your schema
+const User = node('user', {
+  key: (id: string) => `user:${id}`,
+  props: {
+    name: prop.string('name'),
+    email: prop.string('email'),
+    age: optional(prop.int('age')),
+  },
+})
+
+const Knows = edge('knows', {
+  since: prop.int('since'),
+})
+
+// Open database (async)
+const db = await ray('./social.kitedb', {
+  nodes: [User],
+  edges: [Knows],
+})
+
+// Insert nodes
+const alice = db.insert(User).values({ key: 'alice', name: 'Alice', email: 'alice@example.com' }).returning()
+const bob = db.insert(User).values({ key: 'bob', name: 'Bob', email: 'bob@example.com' }).returning()
+
+// Create edges
+db.link(alice, Knows, bob, { since: 2024 })
+
+// Traverse
+const friends = db.from(alice).out(Knows).toArray()
+
+// Pathfinding
+const path = db.shortestPath(alice).via(Knows).to(bob).dijkstra()
+
+db.close()
+```
+
+## Quickstart (low-level API)
+
+For direct control, use the low-level `Database` class:
+
+```ts
+import { Database, JsTraversalDirection, PropType, pathConfig, traversalStep } from 'kitedb'
+
+const db = Database.open('example.kitedb', { createIfMissing: true })
+
+// Transactions are explicit for write operations
+db.begin()
+const alice = db.createNode('user:alice')
+const bob = db.createNode('user:bob')
+
+const knows = db.getOrCreateEtype('knows')
+const weight = db.getOrCreatePropkey('weight')
+
+db.addEdge(alice, knows, bob)
+
+// Set a typed edge property
+db.setEdgeProp(alice, knows, bob, weight, {
+  propType: PropType.Int,
+  intValue: 1,
+})
+
+db.commit()
+
+// Traverse
+const oneHop = db.traverseSingle([alice], JsTraversalDirection.Out, knows)
+console.log(oneHop)
+
+// Multi-hop traversal
+const steps = [traversalStep(JsTraversalDirection.Out, knows), traversalStep(JsTraversalDirection.Out, knows)]
+const twoHop = db.traverse([alice], steps)
+console.log(twoHop)
+
+// Pathfinding
+const config = pathConfig(alice, bob)
+config.allowedEdgeTypes = [knows]
+const shortest = db.bfs(config)
+console.log(shortest)
+
+db.close()
+```
+
+## Backups and health checks
+
+```ts
+import { createBackup, restoreBackup, healthCheck } from 'kitedb'
+
+const backup = createBackup(db, 'backups/graph')
+const restoredPath = restoreBackup(backup.path, 'restored/graph')
+
+const health = healthCheck(db)
+console.log(health.healthy)
+```
+
+## Vector search
+
+```ts
+import { createVectorIndex } from 'kitedb'
+
+const index = createVectorIndex({ dimensions: 3 })
+index.set(1, [0.1, 0.2, 0.3])
+index.set(2, [0.1, 0.25, 0.35])
+index.buildIndex()
+
+const hits = index.search([0.1, 0.2, 0.3], { k: 5 })
+console.log(hits)
+```
+
+## Browser/WASI builds
+
+This package exposes a WASI-compatible build via the `browser` export for bundlers, backed by `kitedb-wasm32-wasi`. If you need to import it directly:
+
+```ts
+import { Database } from 'kitedb-wasm32-wasi'
+```
+
+## Concurrent Access
+
+KiteDB supports concurrent read operations. Multiple async calls can read from the database simultaneously without blocking each other:
+
+```ts
+// These execute concurrently - reads don't block each other
+const [user1, user2, user3] = await Promise.all([db.get(User, 'alice'), db.get(User, 'bob'), db.get(User, 'charlie')])
+
+// Traversals can also run concurrently
+const [aliceFriends, bobFriends] = await Promise.all([
+  db.from(alice).out(Knows).toArray(),
+  db.from(bob).out(Knows).toArray(),
+])
+```
+
+**Concurrency model:**
+
+- **Reads are concurrent**: Multiple `get()`, `from()`, `traverse()`, etc. can run in parallel
+- **Writes are exclusive**: Write operations (`insert()`, `link()`, `update()`) require exclusive access
+- **Read-write interaction**: A write will wait for in-progress reads to complete, then block new reads until done
+
+This is implemented using a read-write lock (RwLock) internally, providing good read scalability while maintaining data consistency.
+
+## API surface
+
+The Node bindings expose both low-level graph primitives (`Database`) and higher-level APIs (Ray) for schema-driven workflows, plus metrics, backups, traversal, and vector search. For full API details and guides, see the docs:
+
+https://ray-kwaf.vercel.app/docs
+
+## License
+
+MIT
+
+# trigger

package/browser.js

@@ -0,0 +1 @@
+export * from 'kitedb-wasm32-wasi'

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * RayDB - A fast, lightweight, embedded graph database for Node.js
+ *
+ * @example
+ * ```typescript
+ * import { ray, defineNode, defineEdge, prop, optional } from '@ray-db/core'
+ *
+ * // Define schema
+ * const User = defineNode('user', {
+ *   key: (id: string) => `user:${id}`,
+ *   props: {
+ *     name: prop.string('name'),
+ *     email: prop.string('email'),
+ *   },
+ * })
+ *
+ * const knows = defineEdge('knows', {
+ *   since: prop.int('since'),
+ * })
+ *
+ * // Open database
+ * const db = await ray('./my.raydb', {
+ *   nodes: [User],
+ *   edges: [knows],
+ * })
+ *
+ * // Insert nodes
+ * const alice = db.insert('user').values('alice', { name: 'Alice' }).returning()
+ *
+ * // Close when done
+ * db.close()
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { node, edge, prop, optional, withDefault, defineNode, defineEdge } from './schema';
+export type { PropType, PropSpec, KeySpec, NodeSpec, NodeConfig, EdgeSpec } from './schema';
+import { Ray as NativeRay } from '../index';
+import type { NodeSpec, EdgeSpec } from './schema';
+export { Ray } from '../index';
+export { Database, VectorIndex, RayInsertBuilder, RayInsertExecutorSingle, RayInsertExecutorMany, RayUpdateBuilder, RayUpdateEdgeBuilder, RayTraversal, RayPath, } from '../index';
+export { JsTraversalDirection as TraversalDirection, JsDistanceMetric as DistanceMetric, JsAggregation as Aggregation, JsSyncMode as SyncMode, JsCompressionType as CompressionType, PropType as PropValueType, } from '../index';
+export { openDatabase, createBackup, restoreBackup, getBackupInfo, createOfflineBackup, collectMetrics, healthCheck, createVectorIndex, bruteForceSearch, pathConfig, traversalStep, version, } from '../index';
+export type { DbStats, CheckResult, OpenOptions, ExportOptions, ExportResult, ImportOptions, ImportResult, BackupOptions, BackupResult, RestoreOptions, OfflineBackupOptions, StreamOptions, PaginationOptions, NodePage, EdgePage, NodeWithProps, EdgeWithProps, DatabaseMetrics, DataMetrics, CacheMetrics, CacheLayerMetrics, MemoryMetrics, MvccMetrics, MvccStats, HealthCheckResult, HealthCheckEntry, JsTraverseOptions as TraverseOptions, JsTraversalStep as TraversalStep, JsTraversalResult as TraversalResult, JsPathConfig as PathConfig, JsPathResult as PathResult, JsPathEdge as PathEdge, VectorIndexOptions, VectorIndexStats, VectorSearchHit, SimilarOptions, JsIvfConfig as IvfConfig, JsIvfStats as IvfStats, JsPqConfig as PqConfig, JsSearchOptions as SearchOptions, JsSearchResult as SearchResult, JsBruteForceResult as BruteForceResult, CompressionOptions, SingleFileOptimizeOptions, VacuumOptions, JsCacheStats as CacheStats, JsEdge as Edge, JsFullEdge as FullEdge, JsNodeProp as NodeProp, JsPropValue as PropValue, JsEdgeInput as EdgeInput, } from '../index';
+/** Options for opening a Ray database */
+export interface RayOptions {
+    /** Node type definitions */
+    nodes: NodeSpec[];
+    /** Edge type definitions */
+    edges: EdgeSpec[];
+    /** Open in read-only mode (default: false) */
+    readOnly?: boolean;
+    /** Create database if it doesn't exist (default: true) */
+    createIfMissing?: boolean;
+    /** Acquire file lock (default: true) */
+    lockFile?: boolean;
+}
+/**
+ * Open a Ray database asynchronously.
+ *
+ * This is the recommended way to open a database as it doesn't block
+ * the Node.js event loop during file I/O.
+ *
+ * @param path - Path to the database file
+ * @param options - Database options including schema
+ * @returns Promise resolving to a Ray database instance
+ *
+ * @example
+ * ```typescript
+ * const db = await ray('./my.raydb', {
+ *   nodes: [User, Post],
+ *   edges: [follows, authored],
+ * })
+ * ```
+ */
+export declare function ray(path: string, options: RayOptions): Promise<NativeRay>;
+/**
+ * Open a Ray database synchronously.
+ *
+ * Use this when you need synchronous initialization (e.g., at module load time).
+ * For most cases, prefer the async `ray()` function.
+ *
+ * @param path - Path to the database file
+ * @param options - Database options including schema
+ * @returns A Ray database instance
+ *
+ * @example
+ * ```typescript
+ * const db = raySync('./my.raydb', {
+ *   nodes: [User],
+ *   edges: [knows],
+ * })
+ * ```
+ */
+export declare function raySync(path: string, options: RayOptions): NativeRay;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * RayDB - A fast, lightweight, embedded graph database for Node.js
+ *
+ * @example
+ * ```typescript
+ * import { ray, defineNode, defineEdge, prop, optional } from '@ray-db/core'
+ *
+ * // Define schema
+ * const User = defineNode('user', {
+ *   key: (id: string) => `user:${id}`,
+ *   props: {
+ *     name: prop.string('name'),
+ *     email: prop.string('email'),
+ *   },
+ * })
+ *
+ * const knows = defineEdge('knows', {
+ *   since: prop.int('since'),
+ * })
+ *
+ * // Open database
+ * const db = await ray('./my.raydb', {
+ *   nodes: [User],
+ *   edges: [knows],
+ * })
+ *
+ * // Insert nodes
+ * const alice = db.insert('user').values('alice', { name: 'Alice' }).returning()
+ *
+ * // Close when done
+ * db.close()
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.version = exports.traversalStep = exports.pathConfig = exports.bruteForceSearch = exports.createVectorIndex = exports.healthCheck = exports.collectMetrics = exports.createOfflineBackup = exports.getBackupInfo = exports.restoreBackup = exports.createBackup = exports.openDatabase = exports.PropValueType = exports.CompressionType = exports.SyncMode = exports.Aggregation = exports.DistanceMetric = exports.TraversalDirection = exports.RayPath = exports.RayTraversal = exports.RayUpdateEdgeBuilder = exports.RayUpdateBuilder = exports.RayInsertExecutorMany = exports.RayInsertExecutorSingle = exports.RayInsertBuilder = exports.VectorIndex = exports.Database = exports.Ray = exports.defineEdge = exports.defineNode = exports.withDefault = exports.optional = exports.prop = exports.edge = exports.node = void 0;
+exports.ray = ray;
+exports.raySync = raySync;
+// =============================================================================
+// Schema Builders (clean API)
+// =============================================================================
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "node", { enumerable: true, get: function () { return schema_1.node; } });
+Object.defineProperty(exports, "edge", { enumerable: true, get: function () { return schema_1.edge; } });
+Object.defineProperty(exports, "prop", { enumerable: true, get: function () { return schema_1.prop; } });
+Object.defineProperty(exports, "optional", { enumerable: true, get: function () { return schema_1.optional; } });
+Object.defineProperty(exports, "withDefault", { enumerable: true, get: function () { return schema_1.withDefault; } });
+Object.defineProperty(exports, "defineNode", { enumerable: true, get: function () { return schema_1.defineNode; } });
+Object.defineProperty(exports, "defineEdge", { enumerable: true, get: function () { return schema_1.defineEdge; } });
+// =============================================================================
+// Native Bindings
+// =============================================================================
+// Import native bindings
+const index_1 = require("../index");
+// =============================================================================
+// Clean Type Aliases (no Js prefix)
+// =============================================================================
+// Re-export Ray class
+var index_2 = require("../index");
+Object.defineProperty(exports, "Ray", { enumerable: true, get: function () { return index_2.Ray; } });
+// Re-export other classes with clean names
+var index_3 = require("../index");
+Object.defineProperty(exports, "Database", { enumerable: true, get: function () { return index_3.Database; } });
+Object.defineProperty(exports, "VectorIndex", { enumerable: true, get: function () { return index_3.VectorIndex; } });
+Object.defineProperty(exports, "RayInsertBuilder", { enumerable: true, get: function () { return index_3.RayInsertBuilder; } });
+Object.defineProperty(exports, "RayInsertExecutorSingle", { enumerable: true, get: function () { return index_3.RayInsertExecutorSingle; } });
+Object.defineProperty(exports, "RayInsertExecutorMany", { enumerable: true, get: function () { return index_3.RayInsertExecutorMany; } });
+Object.defineProperty(exports, "RayUpdateBuilder", { enumerable: true, get: function () { return index_3.RayUpdateBuilder; } });
+Object.defineProperty(exports, "RayUpdateEdgeBuilder", { enumerable: true, get: function () { return index_3.RayUpdateEdgeBuilder; } });
+Object.defineProperty(exports, "RayTraversal", { enumerable: true, get: function () { return index_3.RayTraversal; } });
+Object.defineProperty(exports, "RayPath", { enumerable: true, get: function () { return index_3.RayPath; } });
+// Re-export enums with clean names
+var index_4 = require("../index");
+Object.defineProperty(exports, "TraversalDirection", { enumerable: true, get: function () { return index_4.JsTraversalDirection; } });
+Object.defineProperty(exports, "DistanceMetric", { enumerable: true, get: function () { return index_4.JsDistanceMetric; } });
+Object.defineProperty(exports, "Aggregation", { enumerable: true, get: function () { return index_4.JsAggregation; } });
+Object.defineProperty(exports, "SyncMode", { enumerable: true, get: function () { return index_4.JsSyncMode; } });
+Object.defineProperty(exports, "CompressionType", { enumerable: true, get: function () { return index_4.JsCompressionType; } });
+Object.defineProperty(exports, "PropValueType", { enumerable: true, get: function () { return index_4.PropType; } });
+// Re-export utility functions
+var index_5 = require("../index");
+Object.defineProperty(exports, "openDatabase", { enumerable: true, get: function () { return index_5.openDatabase; } });
+Object.defineProperty(exports, "createBackup", { enumerable: true, get: function () { return index_5.createBackup; } });
+Object.defineProperty(exports, "restoreBackup", { enumerable: true, get: function () { return index_5.restoreBackup; } });
+Object.defineProperty(exports, "getBackupInfo", { enumerable: true, get: function () { return index_5.getBackupInfo; } });
+Object.defineProperty(exports, "createOfflineBackup", { enumerable: true, get: function () { return index_5.createOfflineBackup; } });
+Object.defineProperty(exports, "collectMetrics", { enumerable: true, get: function () { return index_5.collectMetrics; } });
+Object.defineProperty(exports, "healthCheck", { enumerable: true, get: function () { return index_5.healthCheck; } });
+Object.defineProperty(exports, "createVectorIndex", { enumerable: true, get: function () { return index_5.createVectorIndex; } });
+Object.defineProperty(exports, "bruteForceSearch", { enumerable: true, get: function () { return index_5.bruteForceSearch; } });
+Object.defineProperty(exports, "pathConfig", { enumerable: true, get: function () { return index_5.pathConfig; } });
+Object.defineProperty(exports, "traversalStep", { enumerable: true, get: function () { return index_5.traversalStep; } });
+Object.defineProperty(exports, "version", { enumerable: true, get: function () { return index_5.version; } });
+// =============================================================================
+// Type Conversion Helpers
+// =============================================================================
+function propSpecToNative(spec) {
+    return {
+        type: spec.type,
+        optional: spec.optional,
+        default: spec.default,
+    };
+}
+function nodeSpecToNative(spec) {
+    let props;
+    if (spec.props) {
+        props = {};
+        for (const [k, v] of Object.entries(spec.props)) {
+            props[k] = propSpecToNative(v);
+        }
+    }
+    return {
+        name: spec.name,
+        key: spec.key,
+        props,
+    };
+}
+function edgeSpecToNative(spec) {
+    let props;
+    if (spec.props) {
+        props = {};
+        for (const [k, v] of Object.entries(spec.props)) {
+            props[k] = propSpecToNative(v);
+        }
+    }
+    return {
+        name: spec.name,
+        props,
+    };
+}
+function optionsToNative(options) {
+    return {
+        nodes: options.nodes.map(nodeSpecToNative),
+        edges: options.edges.map(edgeSpecToNative),
+        readOnly: options.readOnly,
+        createIfMissing: options.createIfMissing,
+        lockFile: options.lockFile,
+    };
+}
+// =============================================================================
+// Main Entry Points
+// =============================================================================
+/**
+ * Open a Ray database asynchronously.
+ *
+ * This is the recommended way to open a database as it doesn't block
+ * the Node.js event loop during file I/O.
+ *
+ * @param path - Path to the database file
+ * @param options - Database options including schema
+ * @returns Promise resolving to a Ray database instance
+ *
+ * @example
+ * ```typescript
+ * const db = await ray('./my.raydb', {
+ *   nodes: [User, Post],
+ *   edges: [follows, authored],
+ * })
+ * ```
+ */
+async function ray(path, options) {
+    const nativeOptions = optionsToNative(options);
+    // Cast through unknown because NAPI-RS generates Promise<unknown> for async tasks
+    return (await (0, index_1.ray)(path, nativeOptions));
+}
+/**
+ * Open a Ray database synchronously.
+ *
+ * Use this when you need synchronous initialization (e.g., at module load time).
+ * For most cases, prefer the async `ray()` function.
+ *
+ * @param path - Path to the database file
+ * @param options - Database options including schema
+ * @returns A Ray database instance
+ *
+ * @example
+ * ```typescript
+ * const db = raySync('./my.raydb', {
+ *   nodes: [User],
+ *   edges: [knows],
+ * })
+ * ```
+ */
+function raySync(path, options) {
+    const nativeOptions = optionsToNative(options);
+    return (0, index_1.raySync)(path, nativeOptions);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"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"}