bun-sqlite-for-rxdb 1.1.3 → 1.4.0

package/dist/instance.d.ts

@@ -38,5 +38,6 @@ export declare class BunSQLiteStorageInstance<RxDocType> implements RxStorageIns
             lwt: number;
         } | null;
     }>;
+    private queryWithOurMemory;
 }
 //# sourceMappingURL=instance.d.ts.map

package/dist/query/builder.d.ts

@@ -1,6 +1,7 @@
 import type { RxJsonSchema, MangoQuerySelector, RxDocumentData } from 'rxdb';
 import type { SqlFragment } from './operators';
+export declare function canTranslateToSQL<RxDocType>(selector: MangoQuerySelector<RxDocumentData<RxDocType>>, schema?: RxJsonSchema<RxDocumentData<RxDocType>>): boolean;
 export declare function getCacheSize(): number;
 export declare function clearCache(): void;
-export declare function buildWhereClause<RxDocType>(selector: MangoQuerySelector<RxDocumentData<RxDocType>>, schema: RxJsonSchema<RxDocumentData<RxDocType>>): SqlFragment;
+export declare function buildWhereClause<RxDocType>(selector: MangoQuerySelector<RxDocumentData<RxDocType>>, schema: RxJsonSchema<RxDocumentData<RxDocType>>, collectionName: string): SqlFragment;
 //# sourceMappingURL=builder.d.ts.map

package/dist/query/operators.d.ts

@@ -1,7 +1,13 @@
+import type { RxJsonSchema, RxDocumentData } from 'rxdb';
 export interface SqlFragment {
     sql: string;
     args: (string | number | boolean | null)[];
 }
+type QueryValue = string | number | boolean | null;
+type OperatorExpression = {
+    [key: string]: unknown;
+};
+export type ElemMatchCriteria = QueryValue | OperatorExpression;
 export declare function translateEq(field: string, value: unknown): SqlFragment;
 export declare function translateNe(field: string, value: unknown): SqlFragment;
 export declare function translateGt(field: string, value: unknown): SqlFragment;
@@ -11,11 +17,12 @@ export declare function translateLte(field: string, value: unknown): SqlFragment
 export declare function translateIn(field: string, values: unknown[]): SqlFragment;
 export declare function translateNin(field: string, values: unknown[]): SqlFragment;
 export declare function translateExists(field: string, exists: boolean): SqlFragment;
-export declare function translateRegex(field: string, pattern: string, options?: string): SqlFragment | null;
-export declare function translateElemMatch(field: string, criteria: any): SqlFragment | null;
-export declare function translateNot(field: string, criteria: any): SqlFragment;
-export declare function translateNor(conditions: any[]): SqlFragment;
-export declare function translateType(field: string, type: string): SqlFragment | null;
+export declare function translateRegex<RxDocType>(field: string, pattern: string, options: string | undefined, schema: RxJsonSchema<RxDocumentData<RxDocType>>, fieldName: string): SqlFragment | null;
+export declare function translateElemMatch(field: string, criteria: ElemMatchCriteria): SqlFragment | null;
+export declare function translateNot(field: string, criteria: unknown): SqlFragment;
+export declare function translateType(jsonColumn: string, // rename from tableName — it's the JSON column ("data", "payload", etc.)
+fieldName: string, type: string): SqlFragment | null;
 export declare function translateSize(field: string, size: number): SqlFragment;
 export declare function translateMod(field: string, [divisor, remainder]: [number, number]): SqlFragment;
+export {};
 //# sourceMappingURL=operators.d.ts.map

package/dist/query/regex-matcher.d.ts

@@ -0,0 +1,2 @@
+export declare function matchesRegex(value: unknown, pattern: string, options?: string): boolean;
+//# sourceMappingURL=regex-matcher.d.ts.map

package/dist/query/smart-regex.d.ts

@@ -1,6 +1,7 @@
+import type { RxJsonSchema, RxDocumentData } from 'rxdb';
 export interface SqlFragment {
     sql: string;
     args: (string | number | boolean)[];
 }
-export declare function smartRegexToLike(field: string, pattern: string, options?: string): SqlFragment | null;
+export declare function smartRegexToLike<RxDocType>(field: string, pattern: string, options: string | undefined, schema: RxJsonSchema<RxDocumentData<RxDocType>>, fieldName: string): SqlFragment | null;
 //# sourceMappingURL=smart-regex.d.ts.map

package/dist/src/connection-pool.d.ts

@@ -0,0 +1,4 @@
+import { Database } from 'bun:sqlite';
+export declare function getDatabase(databaseName: string, filename: string): Database;
+export declare function releaseDatabase(databaseName: string): void;
+//# sourceMappingURL=connection-pool.d.ts.map

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { getRxStorageBunSQLite } from './storage';
+export type { BunSQLiteStorageSettings } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/instance.d.ts

@@ -0,0 +1,43 @@
+import { Observable } from 'rxjs';
+import type { RxStorageInstance, RxStorageInstanceCreationParams, BulkWriteRow, RxDocumentData, RxStorageBulkWriteResponse, RxStorageQueryResult, RxStorageCountResult, EventBulk, RxStorageChangeEvent, PreparedQuery, RxJsonSchema, RxStorageDefaultCheckpoint } from 'rxdb';
+import type { BunSQLiteStorageSettings, BunSQLiteInternals } from './types';
+export declare class BunSQLiteStorageInstance<RxDocType> implements RxStorageInstance<RxDocType, BunSQLiteInternals, BunSQLiteStorageSettings> {
+    private db;
+    private stmtManager;
+    private changeStream$;
+    readonly databaseName: string;
+    readonly collectionName: string;
+    readonly schema: Readonly<RxJsonSchema<RxDocumentData<RxDocType>>>;
+    readonly internals: Readonly<BunSQLiteInternals>;
+    readonly options: Readonly<BunSQLiteStorageSettings>;
+    private primaryPath;
+    private tableName;
+    closed?: Promise<void>;
+    constructor(params: RxStorageInstanceCreationParams<RxDocType, BunSQLiteStorageSettings>, settings?: BunSQLiteStorageSettings);
+    private initTable;
+    bulkWrite(documentWrites: BulkWriteRow<RxDocType>[], context: string): Promise<RxStorageBulkWriteResponse<RxDocType>>;
+    findDocumentsById(ids: string[], withDeleted: boolean): Promise<RxDocumentData<RxDocType>[]>;
+    query(preparedQuery: PreparedQuery<RxDocType>): Promise<RxStorageQueryResult<RxDocType>>;
+    private sortDocuments;
+    private getNestedValue;
+    count(preparedQuery: PreparedQuery<RxDocType>): Promise<RxStorageCountResult>;
+    changeStream(): Observable<EventBulk<RxStorageChangeEvent<RxDocumentData<RxDocType>>, RxStorageDefaultCheckpoint>>;
+    cleanup(minimumDeletedTime: number): Promise<boolean>;
+    close(): Promise<void>;
+    remove(): Promise<void>;
+    private attachmentMapKey;
+    getAttachmentData(documentId: string, attachmentId: string, digest: string): Promise<string>;
+    getChangedDocumentsSince(limit: number, checkpoint?: {
+        id: string;
+        lwt: number;
+    }): Promise<{
+        documents: RxDocumentData<RxDocType>[];
+        checkpoint: {
+            id: string;
+            lwt: number;
+        } | null;
+    }>;
+    private queryWithOurMemory;
+    private matchesRegexSelector;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/src/query/builder.d.ts

@@ -0,0 +1,7 @@
+import type { RxJsonSchema, MangoQuerySelector, RxDocumentData } from 'rxdb';
+import type { SqlFragment } from './operators';
+export declare function getCacheSize(): number;
+export declare function clearCache(): void;
+export declare function buildWhereClause<RxDocType>(selector: MangoQuerySelector<RxDocumentData<RxDocType>>, schema: RxJsonSchema<RxDocumentData<RxDocType>>, collectionName: string): SqlFragment | null;
+export declare function buildLogicalOperator<RxDocType>(operator: 'or' | 'nor' | 'and', conditions: MangoQuerySelector<RxDocumentData<RxDocType>>[], schema: RxJsonSchema<RxDocumentData<RxDocType>>, logicalDepth: number): SqlFragment | null;
+//# sourceMappingURL=builder.d.ts.map

package/dist/src/query/lightweight-matcher.d.ts

@@ -0,0 +1,3 @@
+import type { RxDocumentData, MangoQuerySelector } from 'rxdb';
+export declare function matchesSelector<RxDocType>(doc: RxDocumentData<RxDocType>, selector: MangoQuerySelector<RxDocumentData<RxDocType>>): boolean;
+//# sourceMappingURL=lightweight-matcher.d.ts.map

package/dist/src/query/operators.d.ts

@@ -0,0 +1,27 @@
+import type { RxJsonSchema, RxDocumentData } from 'rxdb';
+export interface SqlFragment {
+    sql: string;
+    args: (string | number | boolean | null)[];
+}
+type QueryValue = string | number | boolean | null;
+type OperatorExpression = {
+    [key: string]: unknown;
+};
+export type ElemMatchCriteria = QueryValue | OperatorExpression;
+export declare function translateEq<RxDocType>(field: string, value: unknown, schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateNe<RxDocType>(field: string, value: unknown, schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateGt<RxDocType>(field: string, value: unknown, schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateGte<RxDocType>(field: string, value: unknown, schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateLt<RxDocType>(field: string, value: unknown, schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateLte<RxDocType>(field: string, value: unknown, schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateIn<RxDocType>(field: string, values: unknown[], schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateNin<RxDocType>(field: string, values: unknown[], schema?: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName?: string): SqlFragment;
+export declare function translateExists(field: string, exists: boolean): SqlFragment;
+export declare function translateRegex<RxDocType>(field: string, pattern: string, options: string | undefined, schema: RxJsonSchema<RxDocumentData<RxDocType>>, fieldName: string): SqlFragment | null;
+export declare function translateElemMatch<RxDocType>(field: string, criteria: ElemMatchCriteria, schema: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName: string): SqlFragment | null;
+export declare function translateNot<RxDocType>(field: string, criteria: unknown, schema: RxJsonSchema<RxDocumentData<RxDocType>>, actualFieldName: string): SqlFragment | null;
+export declare function translateType(jsonColumn: string, fieldName: string, type: string, isDirectPath?: boolean): SqlFragment | null;
+export declare function translateSize(field: string, size: number): SqlFragment;
+export declare function translateMod(field: string, value: unknown): SqlFragment | null;
+export {};
+//# sourceMappingURL=operators.d.ts.map

package/dist/src/query/regex-matcher.d.ts

@@ -0,0 +1,2 @@
+export declare function matchesRegex(value: unknown, pattern: string, options?: string): boolean;
+//# sourceMappingURL=regex-matcher.d.ts.map

package/dist/src/query/schema-mapper.d.ts

@@ -0,0 +1,8 @@
+import type { RxJsonSchema, RxDocumentData } from 'rxdb';
+export interface ColumnInfo {
+    column?: string;
+    jsonPath?: string;
+    type: 'string' | 'number' | 'boolean' | 'array' | 'unknown';
+}
+export declare function getColumnInfo<RxDocType>(path: string, schema: RxJsonSchema<RxDocumentData<RxDocType>>): ColumnInfo;
+//# sourceMappingURL=schema-mapper.d.ts.map

package/dist/src/query/smart-regex.d.ts

@@ -0,0 +1,7 @@
+import type { RxJsonSchema, RxDocumentData } from 'rxdb';
+export interface SqlFragment {
+    sql: string;
+    args: (string | number | boolean)[];
+}
+export declare function smartRegexToLike<RxDocType>(field: string, pattern: string, options: string | undefined, schema: RxJsonSchema<RxDocumentData<RxDocType>>, fieldName: string): SqlFragment | null;
+//# sourceMappingURL=smart-regex.d.ts.map

package/dist/src/rxdb-helpers.d.ts

@@ -0,0 +1,28 @@
+import type { RxDocumentData, RxStorageWriteError, BulkWriteRow, RxAttachmentWriteData, RxAttachmentData, RxStorageInstance, RxStorageInstanceCreationParams, EventBulk, RxStorageChangeEvent, RxStorageDefaultCheckpoint } from 'rxdb';
+export interface AttachmentOperation {
+    documentId: string;
+    attachmentId: string;
+    attachmentData: RxAttachmentWriteData;
+    digest: string;
+}
+export interface AttachmentRemoveOperation {
+    documentId: string;
+    attachmentId: string;
+    digest: string;
+}
+export declare function getAttachmentSize(attachmentBase64String: string): number;
+export declare function attachmentWriteDataToNormalData(writeData: RxAttachmentWriteData): RxAttachmentData;
+export declare function stripAttachmentsDataFromDocument<T>(doc: RxDocumentData<T>): RxDocumentData<T>;
+export declare function stripAttachmentsDataFromRow<T>(writeRow: BulkWriteRow<T>): BulkWriteRow<T>;
+export declare function categorizeBulkWriteRows<RxDocType>(storageInstance: RxStorageInstance<RxDocType, any, any>, primaryPath: string, docsInDb: Map<string, RxDocumentData<RxDocType>>, bulkWriteRows: BulkWriteRow<RxDocType>[], context: string): {
+    bulkInsertDocs: BulkWriteRow<RxDocType>[];
+    bulkUpdateDocs: BulkWriteRow<RxDocType>[];
+    errors: RxStorageWriteError<RxDocType>[];
+    eventBulk: EventBulk<RxStorageChangeEvent<RxDocumentData<RxDocType>>, RxStorageDefaultCheckpoint>;
+    newestRow?: BulkWriteRow<RxDocType>;
+    attachmentsAdd: AttachmentOperation[];
+    attachmentsRemove: AttachmentRemoveOperation[];
+    attachmentsUpdate: AttachmentOperation[];
+};
+export declare function ensureRxStorageInstanceParamsAreCorrect(params: RxStorageInstanceCreationParams<any, any>): void;
+//# sourceMappingURL=rxdb-helpers.d.ts.map

package/dist/src/statement-manager.d.ts

@@ -0,0 +1,20 @@
+import type { Database, Changes, SQLQueryBindings } from 'bun:sqlite';
+export type QueryWithParams = {
+    query: string;
+    params: SQLQueryBindings[];
+};
+export declare class StatementManager {
+    private db;
+    private staticStatements;
+    private static readonly MAX_STATEMENTS;
+    private closed;
+    constructor(db: Database);
+    private checkClosed;
+    private evictOldest;
+    all<T = unknown>(queryWithParams: QueryWithParams): T[];
+    get(queryWithParams: QueryWithParams): unknown;
+    run(queryWithParams: QueryWithParams): Changes;
+    close(): void;
+    private isStaticSQL;
+}
+//# sourceMappingURL=statement-manager.d.ts.map

package/dist/src/storage.d.ts

@@ -0,0 +1,4 @@
+import type { RxStorage } from 'rxdb';
+import type { BunSQLiteStorageSettings, BunSQLiteInternals } from './types';
+export declare function getRxStorageBunSQLite(settings?: BunSQLiteStorageSettings): RxStorage<BunSQLiteInternals, BunSQLiteStorageSettings>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/transaction-queue.d.ts

@@ -0,0 +1,3 @@
+import type { Database } from 'bun:sqlite';
+export declare function sqliteTransaction<T>(database: Database, handler: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=transaction-queue.d.ts.map

package/dist/src/types.d.ts

@@ -0,0 +1,20 @@
+import type { Database } from 'bun:sqlite';
+export interface BunSQLiteStorageSettings {
+    /**
+     * Database file path. Use ':memory:' for in-memory database.
+     * @default ':memory:'
+     */
+    filename?: string;
+    /**
+     * Memory-mapped I/O size in bytes. Set to 0 to disable.
+     * Enables 2-5x faster reads for large databases (>500MB).
+     * Trade-off: I/O errors become signals (SIGBUS) instead of returnable errors.
+     * @default 268435456 (256MB)
+     */
+    mmapSize?: number;
+}
+export interface BunSQLiteInternals {
+    db: Database;
+    primaryPath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/utils/stable-stringify.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bun-optimized deterministic JSON stringification.
+ * Phase 1: Basic implementation with core optimizations + edge case handling.
+ *
+ * Performance target: >21,000 ops/sec (baseline)
+ * Optimizations:
+ * - Manual loops (no .map() overhead)
+ * - Custom insertion sort for small arrays (<200 elements)
+ * - String escape fast path
+ * - Direct string concatenation
+ * - Circular reference detection
+ * - BigInt support
+ * - Non-plain object handling (Date, RegExp, Error)
+ */
+export declare function stableStringify(value: unknown): string;
+//# sourceMappingURL=stable-stringify.d.ts.map

package/package.json

@@ -1,23 +1,29 @@
 {
   "name": "bun-sqlite-for-rxdb",
-  "version": "1.1.3",
+  "version": "1.4.0",
   "author": "adam2am",
   "repository": {
     "type": "git",
     "url": "https://github.com/adam2am/bun-sqlite-for-rxdb.git"
   },
   "main": "dist/index.js",
+  "dependencies": {},
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/bun": "latest",
-    "@types/fast-stable-stringify": "^1.0.0",
     "better-sqlite3": "^12.6.2",
+    "fast-check": "^4.5.3",
+    "mingo": "^7.2.0",
     "rxdb": "^16.21.1",
+    "sift": "^17.1.3",
     "typescript": "^5.0.0"
   },
   "peerDependencies": {
     "rxdb": "^16.0.0 || ^17.0.0-beta"
   },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
   "description": "RxDB storage adapter for Bun's native SQLite (bun:sqlite)",
   "keywords": [
     "rxdb",
@@ -32,11 +38,12 @@
   "license": "MIT",
   "files": [
     "dist/",
+    "!dist/test/",
     "!dist/**/*.test.d.ts",
     "!dist/**/*.test.d.ts.map",
+    "!dist/**/*.d.ts.map",
     "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
+    "LICENSE"
   ],
   "scripts": {
     "build": "bun build src/index.ts --outdir dist --target bun && tsc --emitDeclarationOnly --declaration --outDir dist",
@@ -44,9 +51,5 @@
     "typecheck": "tsc --noEmit"
   },
   "type": "module",
-  "types": "dist/index.d.ts",
-  "dependencies": {
-    "fast-stable-stringify": "^1.0.0",
-    "mingo": "^7.2.0"
-  }
+  "types": "dist/index.d.ts"
 }