@rlabs-inc/fsdb 1.0.0

package/dist/persistence/markdown.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Markdown Persistence
+ *
+ * Parse and generate markdown files with YAML frontmatter.
+ * Uses Bun file APIs for fast I/O.
+ */
+import type { SchemaDefinition, RecordWithMeta } from '../core/types';
+/** Convert an ID to a safe filename */
+export declare function idToFilename(id: string): string;
+/** Extract ID from a filename */
+export declare function filenameToId(filename: string): string;
+interface ParsedMarkdown {
+    frontmatter: Record<string, unknown>;
+    content: string;
+}
+/**
+ * Parse a markdown file with YAML frontmatter
+ *
+ * Format:
+ * ---
+ * key: value
+ * ---
+ * Content here
+ */
+export declare function parseMarkdown(text: string): ParsedMarkdown;
+/**
+ * Generate markdown with YAML frontmatter
+ */
+export declare function generateMarkdown<S extends SchemaDefinition>(record: RecordWithMeta<S>, schema: S, contentColumn?: keyof S): string;
+/**
+ * Load a record from a markdown file
+ */
+export declare function loadFromMarkdown<S extends SchemaDefinition>(filepath: string, schema: S, contentColumn?: keyof S): Promise<{
+    id: string;
+    record: Partial<RecordWithMeta<S>>;
+} | null>;
+/**
+ * Save a record to a markdown file
+ */
+export declare function saveToMarkdown<S extends SchemaDefinition>(filepath: string, record: RecordWithMeta<S>, schema: S, contentColumn?: keyof S): Promise<boolean>;
+/**
+ * Load all records from a directory
+ */
+export declare function loadFromDirectory<S extends SchemaDefinition>(dirpath: string, schema: S, contentColumn?: keyof S): Promise<{
+    id: string;
+    record: Partial<RecordWithMeta<S>>;
+}[]>;
+/**
+ * Delete a markdown file
+ */
+export declare function deleteMarkdownFile(filepath: string): Promise<boolean>;
+/**
+ * Ensure a directory exists
+ */
+export declare function ensureDirectory(dirpath: string): Promise<void>;
+export {};
+//# sourceMappingURL=markdown.d.ts.map

package/dist/persistence/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/persistence/markdown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,cAAc,EAAE,MAAM,eAAe,CAAA;AAOrF,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAMD,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAqC1D;AAkFD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EACzD,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,CAAC,EACT,aAAa,CAAC,EAAE,MAAM,CAAC,GACtB,MAAM,CA4BR;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,EAC/D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,EACT,aAAa,CAAC,EAAE,MAAM,CAAC,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,CA8CpE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EAC7D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,CAAC,EACT,aAAa,CAAC,EAAE,MAAM,CAAC,GACtB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,EAChE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,EACT,aAAa,CAAC,EAAE,MAAM,CAAC,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAA;CAAE,EAAE,CAAC,CAmB/D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ3E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE"}

package/dist/persistence/watcher.d.ts

@@ -0,0 +1,38 @@
+/**
+ * File Watcher
+ *
+ * Watch a directory for markdown file changes.
+ * Uses Node's fs.watch with debouncing.
+ */
+import type { SchemaDefinition, FileChangeEvent } from '../core/types';
+export interface FileWatcher<S extends SchemaDefinition> {
+    /** Start watching */
+    start(): void;
+    /** Stop watching */
+    stop(): void;
+    /** Is currently watching */
+    readonly isWatching: boolean;
+    /** Register a callback for file changes */
+    onChange(callback: (event: FileChangeEvent<S>) => void | Promise<void>): () => void;
+    /** Mark a file as being saved (prevents reload loop) */
+    markSaving(id: string): void;
+    /** Clear saving mark */
+    clearSaving(id: string): void;
+}
+export interface WatcherOptions<S extends SchemaDefinition> {
+    /** Directory to watch */
+    dirpath: string;
+    /** Schema for parsing files */
+    schema: S;
+    /** Content column */
+    contentColumn?: keyof S;
+    /** Debounce time in ms */
+    debounceMs?: number;
+    /** Callback to check if embedding is stale */
+    isStaleCallback?: (id: string, content: string) => boolean;
+}
+/**
+ * Create a file watcher
+ */
+export declare function createFileWatcher<S extends SchemaDefinition>(options: WatcherOptions<S>): FileWatcher<S>;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/persistence/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/persistence/watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,eAAe,EAAE,MAAM,eAAe,CAAA;AAItF,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,gBAAgB;IACrD,qBAAqB;IACrB,KAAK,IAAI,IAAI,CAAA;IAEb,oBAAoB;IACpB,IAAI,IAAI,IAAI,CAAA;IAEZ,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAE5B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAA;IAEnF,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B,wBAAwB;IACxB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,gBAAgB;IACxD,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAA;IAEf,+BAA+B;IAC/B,MAAM,EAAE,CAAC,CAAA;IAET,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC,CAAA;IAEvB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAA;CAC3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,EAC1D,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,WAAW,CAAC,CAAC,CAAC,CAoKhB"}

package/dist/query/filters.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Filter Helpers
+ *
+ * Composable filter functions for querying collections.
+ * All filters return FilterFn<S> that can be combined with and/or/not.
+ */
+import type { SchemaDefinition, SchemaToRecord, FilterFn, RecordWithMeta, SortOption, PaginatedResult } from '../core/types';
+/** Equal to */
+export declare function eq<S extends SchemaDefinition, K extends keyof S>(column: K, value: SchemaToRecord<S>[K]): FilterFn<S>;
+/** Not equal to */
+export declare function neq<S extends SchemaDefinition, K extends keyof S>(column: K, value: SchemaToRecord<S>[K]): FilterFn<S>;
+/** Greater than */
+export declare function gt<S extends SchemaDefinition, K extends keyof S>(column: K, value: number): FilterFn<S>;
+/** Greater than or equal */
+export declare function gte<S extends SchemaDefinition, K extends keyof S>(column: K, value: number): FilterFn<S>;
+/** Less than */
+export declare function lt<S extends SchemaDefinition, K extends keyof S>(column: K, value: number): FilterFn<S>;
+/** Less than or equal */
+export declare function lte<S extends SchemaDefinition, K extends keyof S>(column: K, value: number): FilterFn<S>;
+/** Between (inclusive) */
+export declare function between<S extends SchemaDefinition, K extends keyof S>(column: K, min: number, max: number): FilterFn<S>;
+/** Value is one of the provided values */
+export declare function oneOf<S extends SchemaDefinition, K extends keyof S>(column: K, values: SchemaToRecord<S>[K][]): FilterFn<S>;
+/** Full-text search across all text columns or specific columns */
+export declare function fullText<S extends SchemaDefinition>(query: string, options?: {
+    columns?: (keyof S)[];
+    caseSensitive?: boolean;
+}): FilterFn<S>;
+/** Regex pattern matching */
+export declare function matches<S extends SchemaDefinition, K extends keyof S>(column: K, pattern: RegExp | string): FilterFn<S>;
+/** Starts with prefix */
+export declare function startsWith<S extends SchemaDefinition, K extends keyof S>(column: K, prefix: string, caseSensitive?: boolean): FilterFn<S>;
+/** Ends with suffix */
+export declare function endsWith<S extends SchemaDefinition, K extends keyof S>(column: K, suffix: string, caseSensitive?: boolean): FilterFn<S>;
+/** Array contains a value */
+export declare function contains<S extends SchemaDefinition, K extends keyof S>(column: K, value: unknown): FilterFn<S>;
+/** Array contains any of the values */
+export declare function containsAny<S extends SchemaDefinition, K extends keyof S>(column: K, values: unknown[]): FilterFn<S>;
+/** Array contains all of the values */
+export declare function containsAll<S extends SchemaDefinition, K extends keyof S>(column: K, values: unknown[]): FilterFn<S>;
+/** Array is empty */
+export declare function isEmpty<S extends SchemaDefinition, K extends keyof S>(column: K): FilterFn<S>;
+/** Array is not empty */
+export declare function isNotEmpty<S extends SchemaDefinition, K extends keyof S>(column: K): FilterFn<S>;
+/** Value exists (not null/undefined) */
+export declare function exists<S extends SchemaDefinition, K extends keyof S>(column: K): FilterFn<S>;
+/** Value is null or undefined */
+export declare function isNull<S extends SchemaDefinition, K extends keyof S>(column: K): FilterFn<S>;
+/** Timestamp is after a date */
+export declare function after<S extends SchemaDefinition, K extends keyof S>(column: K, date: Date | number): FilterFn<S>;
+/** Timestamp is before a date */
+export declare function before<S extends SchemaDefinition, K extends keyof S>(column: K, date: Date | number): FilterFn<S>;
+/** Timestamp is within last N milliseconds */
+export declare function withinLast<S extends SchemaDefinition, K extends keyof S>(column: K, milliseconds: number): FilterFn<S>;
+/** Combine filters with AND */
+export declare function and<S extends SchemaDefinition>(...filters: FilterFn<S>[]): FilterFn<S>;
+/** Combine filters with OR */
+export declare function or<S extends SchemaDefinition>(...filters: FilterFn<S>[]): FilterFn<S>;
+/** Negate a filter */
+export declare function not<S extends SchemaDefinition>(filter: FilterFn<S>): FilterFn<S>;
+/** Sort records by one or more columns */
+export declare function sortBy<S extends SchemaDefinition>(records: RecordWithMeta<S>[], ...sorts: (keyof S | SortOption<S>)[]): RecordWithMeta<S>[];
+/** Paginate records */
+export declare function paginate<S extends SchemaDefinition>(records: RecordWithMeta<S>[], page?: number, pageSize?: number): PaginatedResult<S>;
+//# sourceMappingURL=filters.d.ts.map

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

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

package/dist/query/reactive.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Reactive Queries
+ *
+ * Queries that automatically re-evaluate when underlying data changes.
+ * Built on derived() from @rlabs-inc/signals.
+ */
+import { type DerivedSignal } from '@rlabs-inc/signals';
+import type { Collection } from '../core/collection';
+import type { SchemaDefinition, SchemaToRecord, RecordWithMeta, FilterFn, QueryResult, SortOption } from '../core/types';
+/**
+ * Create a reactive query that auto-updates when data changes
+ *
+ * @example
+ * const activeUsers = query(users, (r) => r.active === true)
+ * effect(() => {
+ *   console.log('Active users:', activeUsers.value.count)
+ * })
+ */
+export declare function query<S extends SchemaDefinition>(collection: Collection<S>, filter: FilterFn<S>): DerivedSignal<QueryResult<S>>;
+/**
+ * Create a reactive sorted query
+ *
+ * @example
+ * const topUsers = querySorted(users, (r) => r.score > 100, 'score', true)
+ */
+export declare function querySorted<S extends SchemaDefinition>(collection: Collection<S>, filter: FilterFn<S>, sortBy: keyof S | SortOption<S>[], descending?: boolean): DerivedSignal<QueryResult<S>>;
+/**
+ * Create a reactive query that returns only the first match
+ *
+ * @example
+ * const admin = queryFirst(users, (r) => r.role === 'admin')
+ */
+export declare function queryFirst<S extends SchemaDefinition>(collection: Collection<S>, filter: FilterFn<S>): DerivedSignal<RecordWithMeta<S> | undefined>;
+/**
+ * Create a reactive count query
+ *
+ * @example
+ * const activeCount = queryCount(users, (r) => r.active)
+ */
+export declare function queryCount<S extends SchemaDefinition>(collection: Collection<S>, filter: FilterFn<S>): DerivedSignal<number>;
+/**
+ * Create a reactive aggregation query
+ *
+ * @example
+ * const totalScore = queryAggregate(users, (records) =>
+ *   records.reduce((sum, r) => sum + r.score, 0)
+ * )
+ */
+export declare function queryAggregate<S extends SchemaDefinition, T>(collection: Collection<S>, aggregator: (records: SchemaToRecord<S>[]) => T, filter?: FilterFn<S>): DerivedSignal<T>;
+/**
+ * Create a reactive query that groups records by a field
+ *
+ * @example
+ * const byRole = queryGroupBy(users, 'role')
+ * // { admin: [...], user: [...], guest: [...] }
+ */
+export declare function queryGroupBy<S extends SchemaDefinition, K extends keyof S>(collection: Collection<S>, field: K, filter?: FilterFn<S>): DerivedSignal<Map<SchemaToRecord<S>[K], RecordWithMeta<S>[]>>;
+//# sourceMappingURL=reactive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../../src/query/reactive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,QAAQ,EACR,WAAW,EACX,UAAU,EACX,MAAM,eAAe,CAAA;AAMtB;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,gBAAgB,EAC9C,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAClB,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAgB/B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,gBAAgB,EACpD,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,EACjC,UAAU,UAAQ,GACjB,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA8B/B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,gBAAgB,EACnD,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAClB,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAU9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,gBAAgB,EACnD,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAClB,aAAa,CAAC,MAAM,CAAC,CASvB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,EAC1D,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,UAAU,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAC/C,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GACnB,aAAa,CAAC,CAAC,CAAC,CAalB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,gBAAgB,EAAE,CAAC,SAAS,MAAM,CAAC,EACxE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,CAAC,EACR,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GACnB,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAsB/D"}

package/dist/vector/search.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Vector Search
+ *
+ * Cosine similarity search with optimized Float32Array operations.
+ * Includes stale embedding detection via content hashing.
+ */
+import type { Collection } from '../core/collection';
+import type { SchemaDefinition, VectorSearchOptions, VectorSearchResult } from '../core/types';
+/**
+ * Convert a number array to Float32Array
+ */
+export declare function toFloat32Array(arr: number[] | Float32Array): Float32Array;
+/**
+ * Normalize a vector to unit length (in-place)
+ */
+export declare function normalizeVector(vec: Float32Array): Float32Array;
+/**
+ * Calculate cosine similarity between two vectors
+ *
+ * Returns a value between -1 and 1 (1 = identical direction)
+ */
+export declare function cosineSimilarity(a: Float32Array | number[], b: Float32Array | number[]): number;
+/**
+ * Batch cosine similarity with pre-computed norms
+ *
+ * More efficient when searching against many vectors
+ */
+export declare function batchCosineSimilarity(query: Float32Array, vectors: Float32Array[], indices: number[], topK: number): {
+    index: number;
+    similarity: number;
+}[];
+export interface EmbeddingManager {
+    /** Store an embedding with its source content hash */
+    setEmbedding(id: string, column: string, content: string): void;
+    /** Check if an embedding is stale (content changed) */
+    isStale(id: string, column: string, currentContent: string): boolean;
+    /** Get the stored hash for an embedding */
+    getHash(id: string, column: string): bigint | undefined;
+    /** Clear hash for a record */
+    clearHash(id: string, column: string): void;
+    /** Clear all hashes */
+    reset(): void;
+}
+/**
+ * Create an embedding manager for stale detection
+ *
+ * Uses Bun.hash() for ultra-fast content fingerprinting
+ */
+export declare function createEmbeddingManager(): EmbeddingManager;
+/**
+ * Perform vector similarity search on a collection
+ *
+ * Optimized for performance:
+ * - Minimal record reconstruction
+ * - Filter uses raw column data, not full records
+ * - Only top-K results get full record reconstruction
+ */
+export declare function vectorSearch<S extends SchemaDefinition>(collection: Collection<S>, vectorColumn: keyof S, queryVector: Float32Array | number[], options?: VectorSearchOptions<S>): VectorSearchResult<S>[];
+//# sourceMappingURL=search.d.ts.map

package/dist/vector/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/vector/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,eAAe,CAAA;AAMtB;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,YAAY,CAGzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAY/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,EAC1B,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,GACzB,MAAM,CAsBR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,GACX;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,CAmCzC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAE/D,uDAAuD;IACvD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAA;IAEpE,2CAA2C;IAC3C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAEvD,8BAA8B;IAC9B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3C,uBAAuB;IACvB,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CA4CzD;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,gBAAgB,EACrD,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,YAAY,EAAE,MAAM,CAAC,EACrB,WAAW,EAAE,YAAY,GAAG,MAAM,EAAE,EACpC,OAAO,GAAE,mBAAmB,CAAC,CAAC,CAAM,GACnC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CA4CzB"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@rlabs-inc/fsdb",
+  "version": "1.0.0",
+  "description": "Fractal State Database - A reactive in memory database with markdown files persistence made with parallel arrays and fine-grained reactivity.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outfile dist/index.mjs --target node --format esm && bun build src/index.ts --outfile dist/index.js --target node --format cjs && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --declaration --outDir dist",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "database",
+    "reactive",
+    "signals",
+    "fractal",
+    "father-state",
+    "parallel-arrays",
+    "columnar",
+    "fine-grained",
+    "markdown",
+    "embeddings",
+    "vector-search"
+  ],
+  "author": "RLabs Inc.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rlabs-inc/fsdb"
+  },
+  "dependencies": {
+    "@rlabs-inc/signals": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  }
+}