@concavejs/docstore-memory 0.0.1-alpha.8

package/dist/memory-docstore.d.ts

@@ -0,0 +1,87 @@
+import type { JSONValue as JsonValue } from "convex/values";
+import { type ArrayBufferHex, type DatabaseIndexUpdate, type DocStore, type DocumentLogEntry, type DocumentPrevTsQuery, type GlobalKey, type IndexKeyBytes, type InternalDocumentId, type Interval, type LatestDocument, Order, type ResolvedDocument, type TimestampRange, type SearchIndexDefinition, type VectorIndexDefinition } from "@concavejs/core/docstore";
+import { TimestampOracle } from "@concavejs/core/utils";
+export type SerializedDocumentLogEntry = {
+    ts: string;
+    id: InternalDocumentId;
+    value: ResolvedDocument | null;
+    prev_ts: string | null;
+};
+export type SerializedIndexRevision = {
+    ts: string;
+    update: {
+        index_id: ArrayBufferHex;
+        keyHex: string;
+        value: {
+            type: "Deleted";
+        } | {
+            type: "NonClustered";
+            doc_id: InternalDocumentId;
+        };
+    };
+};
+export type MemoryDocStoreSnapshot = {
+    documents: SerializedDocumentLogEntry[];
+    indexes: SerializedIndexRevision[];
+    globals: Array<{
+        key: GlobalKey;
+        value: JsonValue;
+    }>;
+};
+/**
+ * In-memory DocStore implementation for browser/RN and tests.
+ *
+ * Supports the full DocStore contract with MVCC semantics, index scans,
+ * basic search, and vector search.
+ */
+export declare class MemoryDocStore implements DocStore {
+    readonly timestampOracle: TimestampOracle;
+    private readonly documentRevisions;
+    private readonly indexRevisions;
+    private readonly globals;
+    private readonly searchConfigsById;
+    private readonly vectorConfigsById;
+    setupSchema(options?: {
+        searchIndexes?: SearchIndexDefinition[];
+        vectorIndexes?: VectorIndexDefinition[];
+    }): Promise<void>;
+    write(documents: DocumentLogEntry[], indexes: Set<{
+        ts: bigint;
+        update: DatabaseIndexUpdate;
+    }>, conflictStrategy: "Error" | "Overwrite"): Promise<void>;
+    index_scan(indexId: ArrayBufferHex, tableId: string, readTimestamp: bigint, interval: Interval, order: Order): AsyncGenerator<[IndexKeyBytes, LatestDocument]>;
+    load_documents(range: TimestampRange, order: Order): AsyncGenerator<DocumentLogEntry>;
+    getGlobal(key: GlobalKey): Promise<JsonValue | null>;
+    writeGlobal(key: GlobalKey, value: JsonValue): Promise<void>;
+    previous_revisions(queries: Set<{
+        id: InternalDocumentId;
+        ts: bigint;
+    }>): Promise<Map<string, DocumentLogEntry>>;
+    previous_revisions_of_documents(queries: Set<DocumentPrevTsQuery>): Promise<Map<string, DocumentLogEntry>>;
+    count(tableId: string): Promise<number>;
+    get(id: InternalDocumentId, readTimestamp?: bigint): Promise<LatestDocument | null>;
+    scan(tableId: string, readTimestamp?: bigint): Promise<LatestDocument[]>;
+    scanPaginated(tableId: string, cursor: string | null, limit: number, order: Order, readTimestamp?: bigint): Promise<{
+        documents: LatestDocument[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+    search(indexId: ArrayBufferHex, searchQuery: string, filters: Map<string, unknown>, options?: {
+        limit?: number;
+    }): Promise<{
+        doc: LatestDocument;
+        score: number;
+    }[]>;
+    vectorSearch(indexId: ArrayBufferHex, vector: number[], limit: number, filters: Map<string, string>): Promise<{
+        doc: LatestDocument;
+        score: number;
+    }[]>;
+    exportSnapshot(): MemoryDocStoreSnapshot;
+    importSnapshot(snapshot: MemoryDocStoreSnapshot, mode?: "replace" | "merge"): void;
+    static fromSnapshot(snapshot: MemoryDocStoreSnapshot): MemoryDocStore;
+    private validateDocumentWrites;
+    private validateIndexWrites;
+    private applyDocumentWrite;
+    private applyIndexWrite;
+    private resolveVectorConfig;
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@concavejs/docstore-memory",
+  "version": "0.0.1-alpha.8",
+  "license": "FSL-1.1-Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && bun build ./src/index.ts --outfile dist/index.js --target browser --format esm && tsc -p tsconfig.json --emitDeclarationOnly --declaration --declarationMap false --outDir dist",
+    "test": "bun test --run --passWithNoTests"
+  },
+  "dependencies": {
+    "@concavejs/core": "0.0.1-alpha.8",
+    "convex": "^1.27.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}