@kitedb/core 0.2.6 → 0.2.8

package/dist/schema.d.ts

@@ -24,9 +24,9 @@
 /** Property type identifiers */
 export type PropType = 'string' | 'int' | 'float' | 'bool' | 'vector' | 'any';
 /** Property specification */
-export interface PropSpec {
+export interface PropSpec<T extends PropType = PropType> {
     /** Property type */
-    type: PropType;
+    type: T;
     /** Whether this property is optional */
     optional?: boolean;
     /** Default value for this property */
@@ -51,21 +51,21 @@ export declare const prop: {
      * String property.
      * Stored as UTF-8 strings.
      */
-    string: (_name: string) => PropSpec;
+    string: (_name: string) => PropSpec<"string">;
     /**
      * Integer property.
      * Stored as 64-bit signed integers.
      */
-    int: (_name: string) => PropSpec;
+    int: (_name: string) => PropSpec<"int">;
     /**
      * Float property.
      * Stored as 64-bit IEEE 754 floats.
      */
-    float: (_name: string) => PropSpec;
+    float: (_name: string) => PropSpec<"float">;
     /**
      * Boolean property.
      */
-    bool: (_name: string) => PropSpec;
+    bool: (_name: string) => PropSpec<"bool">;
     /**
      * Vector property for embeddings.
      * Stored as Float32 arrays.
@@ -73,12 +73,12 @@ export declare const prop: {
      * @param _name - Property name
      * @param _dimensions - Vector dimensions (for documentation/validation)
      */
-    vector: (_name: string, _dimensions?: number) => PropSpec;
+    vector: (_name: string, _dimensions?: number) => PropSpec<"vector">;
     /**
      * Any property (schema-less).
      * Accepts any value type.
      */
-    any: (_name: string) => PropSpec;
+    any: (_name: string) => PropSpec<"any">;
 };
 /**
  * Mark a property as optional.
@@ -88,7 +88,9 @@ export declare const prop: {
  * const age = optional(prop.int('age'))
  * ```
  */
-export declare function optional<T extends PropSpec>(spec: T): T;
+export declare function optional<T extends PropSpec>(spec: T): T & {
+    optional: true;
+};
 /**
  * Set a default value for a property.
  *
@@ -112,16 +114,16 @@ export interface KeySpec {
     separator?: string;
 }
 /** Node type specification */
-export interface NodeSpec {
+export interface NodeSpec<P extends Record<string, PropSpec> | undefined = Record<string, PropSpec> | undefined> {
     /** Node type name (must be unique per database) */
     name: string;
     /** Key generation specification */
     key?: KeySpec;
     /** Property definitions */
-    props?: Record<string, PropSpec>;
+    props?: P;
 }
 /** Configuration for node() */
-export interface NodeConfig<K extends string = string> {
+export interface NodeConfig<K extends string = string, P extends Record<string, PropSpec> | undefined = Record<string, PropSpec> | undefined> {
     /**
      * Key generator function or key specification.
      *
@@ -140,7 +142,7 @@ export interface NodeConfig<K extends string = string> {
      */
     key?: ((arg: K) => string) | KeySpec;
     /** Property definitions */
-    props?: Record<string, PropSpec>;
+    props?: P;
 }
 /**
  * Define a node type with properties.
@@ -150,7 +152,7 @@ export interface NodeConfig<K extends string = string> {
  *
  * @param name - The node type name (must be unique)
  * @param config - Node configuration with key function and properties
- * @returns A NodeSpec that can be passed to ray()
+ * @returns A NodeSpec that can be passed to kite()
  *
  * @example
  * ```typescript
@@ -172,13 +174,13 @@ export interface NodeConfig<K extends string = string> {
  * })
  * ```
  */
-export declare function node<K extends string = string>(name: string, config?: NodeConfig<K>): NodeSpec;
+export declare function node<K extends string = string, P extends Record<string, PropSpec> | undefined = Record<string, PropSpec> | undefined>(name: string, config?: NodeConfig<K, P>): NodeSpec<P>;
 /** Edge type specification */
-export interface EdgeSpec {
+export interface EdgeSpec<P extends Record<string, PropSpec> | undefined = Record<string, PropSpec> | undefined> {
     /** Edge type name (must be unique per database) */
     name: string;
     /** Property definitions */
-    props?: Record<string, PropSpec>;
+    props?: P;
 }
 /**
  * Define an edge type with optional properties.
@@ -188,7 +190,7 @@ export interface EdgeSpec {
  *
  * @param name - The edge type name (must be unique)
  * @param props - Optional property definitions
- * @returns An EdgeSpec that can be passed to ray()
+ * @returns An EdgeSpec that can be passed to kite()
  *
  * @example
  * ```typescript
@@ -202,9 +204,35 @@ export interface EdgeSpec {
  * const follows = edge('follows')
  * ```
  */
-export declare function edge(name: string, props?: Record<string, PropSpec>): EdgeSpec;
+export declare function edge<P extends Record<string, PropSpec> | undefined = Record<string, PropSpec> | undefined>(name: string, props?: P): EdgeSpec<P>;
 /** @deprecated Use `node()` instead */
 export declare const defineNode: typeof node;
 /** @deprecated Use `edge()` instead */
 export declare const defineEdge: typeof edge;
+type PropValue<S extends PropSpec> = S['type'] extends 'string' ? string : S['type'] extends 'int' ? number : S['type'] extends 'float' ? number : S['type'] extends 'bool' ? boolean : S['type'] extends 'vector' ? Array<number> : unknown;
+type OptionalKeys<P extends Record<string, PropSpec>> = {
+    [K in keyof P]: P[K] extends {
+        optional: true;
+    } ? K : never;
+}[keyof P];
+type RequiredKeys<P extends Record<string, PropSpec>> = Exclude<keyof P, OptionalKeys<P>>;
+type PropsFromSpec<P extends Record<string, PropSpec> | undefined> = P extends Record<string, PropSpec> ? {
+    [K in RequiredKeys<P>]: PropValue<P[K]>;
+} & {
+    [K in OptionalKeys<P>]?: PropValue<P[K]>;
+} : Record<string, never>;
+export type NodeRef<N extends NodeSpec = NodeSpec> = {
+    id: number;
+    key: string;
+    type: N['name'];
+};
+export type InferNodeInsert<N extends NodeSpec> = {
+    key: string;
+} & PropsFromSpec<N['props']>;
+export type InferNodeUpsert<N extends NodeSpec> = {
+    key: string;
+} & Partial<PropsFromSpec<N['props']>>;
+export type InferNode<N extends NodeSpec> = NodeRef<N> & PropsFromSpec<N['props']>;
+export type InferEdgeProps<E extends EdgeSpec> = PropsFromSpec<E['props']>;
+export {};
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../ts/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,gCAAgC;AAChC,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAE7E,6BAA6B;AAC7B,MAAM,WAAW,QAAQ;IACvB,oBAAoB;IACpB,IAAI,EAAE,QAAQ,CAAA;IACd,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAMD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,IAAI;IACf;;;OAGG;oBACa,MAAM,KAAG,QAAQ;IAEjC;;;OAGG;iBACU,MAAM,KAAG,QAAQ;IAE9B;;;OAGG;mBACY,MAAM,KAAG,QAAQ;IAEhC;;OAEG;kBACW,MAAM,KAAG,QAAQ;IAE/B;;;;;;OAMG;oBACa,MAAM,gBAAgB,MAAM,KAAG,QAAQ;IAEvD;;;OAGG;iBACU,MAAM,KAAG,QAAQ;CAC/B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAE1E;AAMD,8BAA8B;AAC9B,MAAM,WAAW,OAAO;IACtB,0BAA0B;IAC1B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;IACrC,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CACjC;AAED,+BAA+B;AAC/B,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACnD;;;;;;;;;;;;;;;OAeG;IACH,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,OAAO,CAAA;IACpC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CA2B9F;AAMD,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAE7E;AAMD,uCAAuC;AACvC,eAAO,MAAM,UAAU,aAAO,CAAA;AAE9B,uCAAuC;AACvC,eAAO,MAAM,UAAU,aAAO,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../ts/schema.ts"],"names":[],"mappings":"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"}

package/dist/schema.js

@@ -109,7 +109,7 @@ function withDefault(spec, value) {
  *
  * @param name - The node type name (must be unique)
  * @param config - Node configuration with key function and properties
- * @returns A NodeSpec that can be passed to ray()
+ * @returns A NodeSpec that can be passed to kite()
  *
  * @example
  * ```typescript
@@ -166,7 +166,7 @@ function node(name, config) {
  *
  * @param name - The edge type name (must be unique)
  * @param props - Optional property definitions
- * @returns An EdgeSpec that can be passed to ray()
+ * @returns An EdgeSpec that can be passed to kite()
  *
  * @example
  * ```typescript

package/dist/schema.js.map

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

package/index.d.ts

@@ -22,6 +22,10 @@ export declare class Database {
   hasTransaction(): boolean
   /** Create a new node */
   createNode(key?: string | undefined | null): number
+  /** Upsert a node by key (create if missing, update props) */
+  upsertNode(key: string, props: Array<JsNodeProp>): number
+  /** Upsert a node by ID (create if missing, update props) */
+  upsertNodeById(nodeId: number, props: Array<JsNodeProp>): number
   /** Delete a node */
   deleteNode(nodeId: number): void
   /** Check if a node exists */
@@ -38,6 +42,12 @@ export declare class Database {
   addEdge(src: number, etype: number, dst: number): void
   /** Add an edge by type name */
   addEdgeByName(src: number, etypeName: string, dst: number): void
+  /**
+   * Upsert an edge (create if missing, update props)
+   *
+   * Returns true if the edge was created.
+   */
+  upsertEdge(src: number, etype: number, dst: number, props: Array<JsNodeProp>): boolean
   /** Delete an edge */
   deleteEdge(src: number, etype: number, dst: number): void
   /** Check if an edge exists */
@@ -512,11 +522,11 @@ export declare class JsIvfPqIndex {
 }
 
 /**
- * High-level Ray database handle for Node.js/Bun.
+ * High-level Kite database handle for Node.js/Bun.
  *
  * # Thread Safety and Concurrent Access
  *
- * Ray uses an internal RwLock to support concurrent operations:
+ * Kite uses an internal RwLock to support concurrent operations:
  *
  * - **Read operations** (get, exists, neighbors, traversals) use a shared read lock,
  *   allowing multiple concurrent reads without blocking each other.
@@ -541,9 +551,9 @@ export declare class JsIvfPqIndex {
  * await db.insert("User").key("david").set("name", "David").execute();
  * ```
  */
-export declare class Ray {
-  /** Open a Ray database */
-  static open(path: string, options: JsRayOptions): Ray
+export declare class Kite {
+  /** Open a Kite database */
+  static open(path: string, options: JsKiteOptions): Kite
   /** Close the database */
   close(): void
   /** Get a node by key (returns node object with props) */
@@ -563,11 +573,15 @@ export declare class Ray {
   /** Delete a node by key */
   deleteByKey(nodeType: string, key: unknown): boolean
   /** Create an insert builder */
-  insert(nodeType: string): RayInsertBuilder
+  insert(nodeType: string): KiteInsertBuilder
+  /** Create an upsert builder */
+  upsert(nodeType: string): KiteUpsertBuilder
   /** Create an update builder by node ID */
-  updateById(nodeId: number): RayUpdateBuilder
+  updateById(nodeId: number): KiteUpdateBuilder
+  /** Create an upsert builder by node ID */
+  upsertById(nodeType: string, nodeId: number): KiteUpsertByIdBuilder
   /** Create an update builder by key */
-  updateByKey(nodeType: string, key: unknown): RayUpdateBuilder
+  updateByKey(nodeType: string, key: unknown): KiteUpdateBuilder
   /** Link two nodes */
   link(src: number, edgeType: string, dst: number, props?: object | undefined | null): void
   /** Unlink two nodes */
@@ -583,7 +597,9 @@ export declare class Ray {
   /** Delete an edge property */
   delEdgeProp(src: number, edgeType: string, dst: number, propName: string): void
   /** Update edge properties with a builder */
-  updateEdge(src: number, edgeType: string, dst: number): RayUpdateEdgeBuilder
+  updateEdge(src: number, edgeType: string, dst: number): KiteUpdateEdgeBuilder
+  /** Upsert edge properties with a builder */
+  upsertEdge(src: number, edgeType: string, dst: number): KiteUpsertEdgeBuilder
   /** List all nodes of a type (returns array of node objects) */
   all(nodeType: string): Array<object>
   /** Count nodes (optionally by type) */
@@ -606,40 +622,48 @@ export declare class Ray {
   describe(): string
   /** Check database integrity */
   check(): CheckResult
+  /** Begin a transaction */
+  begin(readOnly?: boolean | undefined | null): number
+  /** Commit the current transaction */
+  commit(): void
+  /** Rollback the current transaction */
+  rollback(): void
+  /** Check if there's an active transaction */
+  hasTransaction(): boolean
   /** Execute a batch of operations atomically */
   batch(ops: Array<object>): Array<object>
   /** Begin a traversal from a node ID */
-  from(nodeId: number): RayTraversal
+  from(nodeId: number): KiteTraversal
   /** Begin a traversal from multiple nodes */
-  fromNodes(nodeIds: Array<number>): RayTraversal
+  fromNodes(nodeIds: Array<number>): KiteTraversal
   /** Begin a path finding query */
-  path(source: number, target: number): RayPath
+  path(source: number, target: number): KitePath
   /** Begin a path finding query to multiple targets */
-  pathToAny(source: number, targets: Array<number>): RayPath
+  pathToAny(source: number, targets: Array<number>): KitePath
 }
 
-export declare class RayInsertBuilder {
+export declare class KiteInsertBuilder {
   /** Specify values for a single insert */
-  values(key: unknown, props?: object | undefined | null): RayInsertExecutorSingle
+  values(key: unknown, props?: object | undefined | null): KiteInsertExecutorSingle
   /** Specify values for multiple inserts */
-  valuesMany(entries: Array<unknown>): RayInsertExecutorMany
+  valuesMany(entries: Array<unknown>): KiteInsertExecutorMany
 }
 
-export declare class RayInsertExecutorMany {
+export declare class KiteInsertExecutorMany {
   /** Execute the inserts without returning */
   execute(): void
   /** Execute the inserts and return nodes */
   returning(): Array<object>
 }
 
-export declare class RayInsertExecutorSingle {
+export declare class KiteInsertExecutorSingle {
   /** Execute the insert without returning */
   execute(): void
   /** Execute the insert and return the node */
   returning(): object
 }
 
-export declare class RayPath {
+export declare class KitePath {
   via(edgeType: string): void
   maxDepth(depth: number): void
   direction(direction: string): void
@@ -649,21 +673,21 @@ export declare class RayPath {
   findKShortest(k: number): Array<JsPathResult>
 }
 
-export declare class RayTraversal {
-  whereEdge(func: unknown): void
-  whereNode(func: unknown): void
-  out(edgeType?: string | undefined | null): void
-  in(edgeType?: string | undefined | null): void
-  both(edgeType?: string | undefined | null): void
-  traverse(edgeType: string | undefined | null, options: JsTraverseOptions): void
-  take(limit: number): void
-  select(props: Array<string>): void
+export declare class KiteTraversal {
+  whereEdge(func: unknown): KiteTraversal
+  whereNode(func: unknown): KiteTraversal
+  out(edgeType?: string | undefined | null): KiteTraversal
+  in(edgeType?: string | undefined | null): KiteTraversal
+  both(edgeType?: string | undefined | null): KiteTraversal
+  traverse(edgeType: string | undefined | null, options: JsTraverseOptions): KiteTraversal
+  take(limit: number): KiteTraversal
+  select(props: Array<string>): KiteTraversal
   nodes(): Array<number>
   edges(): Array<JsFullEdge>
   count(): number
 }
 
-export declare class RayUpdateBuilder {
+export declare class KiteUpdateBuilder {
   /** Set a node property */
   set(propName: string, value: unknown): void
   /** Remove a node property */
@@ -674,7 +698,7 @@ export declare class RayUpdateBuilder {
   execute(): void
 }
 
-export declare class RayUpdateEdgeBuilder {
+export declare class KiteUpdateEdgeBuilder {
   /** Set an edge property */
   set(propName: string, value: unknown): void
   /** Remove an edge property */
@@ -685,6 +709,49 @@ export declare class RayUpdateEdgeBuilder {
   execute(): void
 }
 
+export declare class KiteUpsertBuilder {
+  /** Specify values for a single upsert */
+  values(key: unknown, props?: object | undefined | null): KiteUpsertExecutorSingle
+  /** Specify values for multiple upserts */
+  valuesMany(entries: Array<unknown>): KiteUpsertExecutorMany
+}
+
+export declare class KiteUpsertByIdBuilder {
+  /** Set a node property */
+  set(propName: string, value: unknown): void
+  /** Remove a node property */
+  unset(propName: string): void
+  /** Set multiple properties at once */
+  setAll(props: object): void
+  /** Execute the upsert */
+  execute(): void
+}
+
+export declare class KiteUpsertEdgeBuilder {
+  /** Set an edge property */
+  set(propName: string, value: unknown): void
+  /** Remove an edge property */
+  unset(propName: string): void
+  /** Set multiple edge properties at once */
+  setAll(props: object): void
+  /** Execute the upsert */
+  execute(): void
+}
+
+export declare class KiteUpsertExecutorMany {
+  /** Execute the upserts without returning */
+  execute(): void
+  /** Execute the upserts and return nodes */
+  returning(): Array<object>
+}
+
+export declare class KiteUpsertExecutorSingle {
+  /** Execute the upsert without returning */
+  execute(): void
+  /** Execute the upsert and return the node */
+  returning(): object
+}
+
 /** High-level vector index for similarity search */
 export declare class VectorIndex {
   /** Create a new vector index */
@@ -999,6 +1066,14 @@ export interface JsKeySpec {
   separator?: string
 }
 
+export interface JsKiteOptions {
+  nodes: Array<JsNodeSpec>
+  edges: Array<JsEdgeSpec>
+  readOnly?: boolean
+  createIfMissing?: boolean
+  lockFile?: boolean
+}
+
 /** Node property key-value pair for JS */
 export interface JsNodeProp {
   keyId: number
@@ -1089,14 +1164,6 @@ export interface JsPropValue {
   vectorValue?: Array<number>
 }
 
-export interface JsRayOptions {
-  nodes: Array<JsNodeSpec>
-  edges: Array<JsEdgeSpec>
-  readOnly?: boolean
-  createIfMissing?: boolean
-  lockFile?: boolean
-}
-
 /** Options for vector search */
 export interface JsSearchOptions {
   /** Number of clusters to probe (overrides index default) */
@@ -1176,6 +1243,15 @@ export interface JsTraverseOptions {
   unique?: boolean
 }
 
+/**
+ * Kite entrypoint - async version (recommended)
+ * Opens the database on a background thread to avoid blocking the event loop
+ */
+export declare function kite(path: string, options: JsKiteOptions): Promise<unknown>
+
+/** Kite entrypoint - sync version */
+export declare function kiteSync(path: string, options: JsKiteOptions): Kite
+
 /** Memory metrics */
 export interface MemoryMetrics {
   deltaEstimateBytes: number
@@ -1314,15 +1390,6 @@ export declare const enum PropValueTag {
   VectorF32 = 5
 }
 
-/**
- * Ray entrypoint - async version (recommended)
- * Opens the database on a background thread to avoid blocking the event loop
- */
-export declare function ray(path: string, options: JsRayOptions): Promise<unknown>
-
-/** Ray entrypoint - sync version (for backwards compatibility) */
-export declare function raySync(path: string, options: JsRayOptions): Ray
-
 /** Restore a backup into a target path */
 export declare function restoreBackup(backupPath: string, restorePath: string, options?: RestoreOptions | undefined | null): string