@rlabs-inc/fsdb 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * fsDB Type Definitions
+ *
+ * Core types for the Fractal State Database
+ */
+/** Supported column types */
+export type ColumnType = 'string' | 'number' | 'boolean' | 'timestamp' | 'string[]' | 'number[]' | `vector:${number}`;
+/** Schema definition - maps field names to column types */
+export type SchemaDefinition = Record<string, ColumnType>;
+/** Convert a column type to its TypeScript type */
+export type ColumnTypeToTS<T extends ColumnType> = T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : T extends 'timestamp' ? number : T extends 'string[]' ? string[] : T extends 'number[]' ? number[] : T extends `vector:${number}` ? Float32Array | null : never;
+/** Convert a schema definition to a record type */
+export type SchemaToRecord<S extends SchemaDefinition> = {
+    [K in keyof S]: ColumnTypeToTS<S[K]>;
+};
+/** Record with metadata */
+export type RecordWithMeta<S extends SchemaDefinition> = SchemaToRecord<S> & {
+    id: string;
+    created: number;
+    updated: number;
+    stale: boolean;
+};
+/** Partial record for inserts/updates */
+export type PartialRecord<S extends SchemaDefinition> = Partial<SchemaToRecord<S>> & {
+    id?: string;
+};
+export interface ParsedColumnType {
+    baseType: 'string' | 'number' | 'boolean' | 'timestamp' | 'array' | 'vector';
+    arrayType?: 'string' | 'number';
+    vectorDimensions?: number;
+}
+export interface ParsedSchema<S extends SchemaDefinition> {
+    definition: S;
+    columns: (keyof S)[];
+    vectorColumns: (keyof S)[];
+    parsedTypes: Map<keyof S, ParsedColumnType>;
+}
+export interface CollectionOptions<S extends SchemaDefinition> {
+    /** Schema defining the columns */
+    schema: S;
+    /** Which column contains the main content (stored as markdown body) */
+    contentColumn?: keyof S;
+    /** Storage path - local folder or ~/.fsdb/[name] */
+    path?: string;
+    /** Auto-save changes to disk */
+    autoSave?: boolean;
+    /** Watch files for external changes */
+    watchFiles?: boolean;
+    /** Callback when external file changes are detected */
+    onExternalChange?: (event: FileChangeEvent<S>) => void | Promise<void>;
+}
+export interface DatabaseOptions {
+    /** Database name (used for path generation) */
+    name?: string;
+    /**
+     * Use project-local storage instead of global ~/.fsdb/
+     * - false (default): ~/.fsdb/[name]/[collection]/
+     * - true: ./.fsdb/[name]/[collection]/
+     */
+    local?: boolean;
+    /**
+     * Custom base path - overrides both local and global defaults
+     * If set, collections will be stored at [basePath]/[collection]/
+     */
+    basePath?: string;
+}
+export interface FileChangeEvent<S extends SchemaDefinition> {
+    type: 'create' | 'update' | 'delete';
+    id: string;
+    filename: string;
+    filepath: string;
+    record?: RecordWithMeta<S>;
+    stale: boolean;
+}
+export type FilterFn<S extends SchemaDefinition> = (record: SchemaToRecord<S>, index: number) => boolean;
+export interface QueryResult<S extends SchemaDefinition> {
+    indices: number[];
+    records: RecordWithMeta<S>[];
+    count: number;
+}
+export interface PaginatedResult<S extends SchemaDefinition> {
+    records: RecordWithMeta<S>[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+export interface SortOption<S extends SchemaDefinition> {
+    column: keyof S;
+    direction: 'asc' | 'desc';
+}
+export interface VectorSearchOptions<S extends SchemaDefinition> {
+    /** Number of top results to return */
+    topK?: number;
+    /** Minimum similarity threshold (0-1) */
+    minSimilarity?: number;
+    /** Pre-filter records before vector search */
+    filter?: FilterFn<S>;
+}
+export interface VectorSearchResult<S extends SchemaDefinition> {
+    record: RecordWithMeta<S>;
+    similarity: number;
+    stale: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * fsDB - Fractal State Database
+ *
+ * A reactive database with parallel arrays and fine-grained reactivity.
+ * Built on the Father State pattern at every level.
+ *
+ * @packageDocumentation
+ */
+export type { ColumnType, SchemaDefinition, ColumnTypeToTS, SchemaToRecord, RecordWithMeta, PartialRecord, ParsedColumnType, ParsedSchema, CollectionOptions, DatabaseOptions, FileChangeEvent, FilterFn, QueryResult, PaginatedResult, SortOption, VectorSearchOptions, VectorSearchResult, } from './core/types';
+export { createDatabase, fsDB, createPersistentCollection, type Database, type PersistentCollection, } from './core/database';
+export { createCollection, type Collection, } from './core/collection';
+export { createRegistry, generateId, type Registry, } from './core/registry';
+export { createColumns, parseColumnType, parseSchema, getDefaultValue, type ColumnsManager, } from './core/columns';
+export { query, querySorted, queryFirst, queryCount, queryAggregate, queryGroupBy, } from './query/reactive';
+export { eq, neq, gt, gte, lt, lte, between, oneOf, fullText, matches, startsWith, endsWith, contains, containsAny, containsAll, isEmpty, isNotEmpty, exists, isNull, after, before, withinLast, and, or, not, sortBy, paginate, } from './query/filters';
+export { vectorSearch, cosineSimilarity, batchCosineSimilarity, normalizeVector, toFloat32Array, createEmbeddingManager, type EmbeddingManager, } from './vector/search';
+export { parseMarkdown, generateMarkdown, loadFromMarkdown, saveToMarkdown, loadFromDirectory, deleteMarkdownFile, ensureDirectory, idToFilename, filenameToId, } from './persistence/markdown';
+export { createFileWatcher, type FileWatcher, type WatcherOptions, } from './persistence/watcher';
+export { DEFAULT_VALUES, WATCHER_DEBOUNCE_MS, SAVE_GRACE_PERIOD_MS, DEFAULT_PAGE_SIZE, } from './core/constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,YAAY,EAEV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,YAAY,EAGZ,iBAAiB,EACjB,eAAe,EAGf,eAAe,EAGf,QAAQ,EACR,WAAW,EACX,eAAe,EACf,UAAU,EAGV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAMrB,OAAO,EACL,cAAc,EACd,IAAI,EACJ,0BAA0B,EAC1B,KAAK,QAAQ,EACb,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAA;AAM1B,OAAO,EACL,cAAc,EACd,UAAU,EACV,KAAK,QAAQ,GACd,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAA;AAMvB,OAAO,EACL,KAAK,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EAEL,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,OAAO,EACP,KAAK,EAGL,QAAQ,EACR,OAAO,EACP,UAAU,EACV,QAAQ,EAGR,QAAQ,EACR,WAAW,EACX,WAAW,EACX,OAAO,EACP,UAAU,EAGV,MAAM,EACN,MAAM,EAGN,KAAK,EACL,MAAM,EACN,UAAU,EAGV,GAAG,EACH,EAAE,EACF,GAAG,EAGH,MAAM,EACN,QAAQ,GACT,MAAM,iBAAiB,CAAA;AAMxB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAA;AAMxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAA;AAM9B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA"}