@optimystic/db-core 0.0.1

package/dist/src/utility/is-record-empty.d.ts

@@ -0,0 +1,3 @@
+/** True if the given object has no keys.  This should not be used for classes or objects with proto fields. */
+export declare function isRecordEmpty<T>(record: Record<string, T>): boolean;
+//# sourceMappingURL=is-record-empty.d.ts.map

package/dist/src/utility/is-record-empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record-empty.d.ts","sourceRoot":"","sources":["../../../src/utility/is-record-empty.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,OAAO,CAGnE"}

package/dist/src/utility/is-record-empty.js

@@ -0,0 +1,7 @@
+/** True if the given object has no keys.  This should not be used for classes or objects with proto fields. */
+export function isRecordEmpty(record) {
+    for (const key in record)
+        return false;
+    return true;
+}
+//# sourceMappingURL=is-record-empty.js.map

package/dist/src/utility/is-record-empty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-record-empty.js","sourceRoot":"","sources":["../../../src/utility/is-record-empty.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,UAAU,aAAa,CAAI,MAAyB;IACzD,KAAK,MAAM,GAAG,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/src/utility/latches.d.ts

@@ -0,0 +1,11 @@
+/** Lightweight implementation of a mutex lock queue. */
+export declare class Latches {
+    private static lockQueues;
+    /**
+     * Acquires a lock for the given key. Waits if another operation holds the lock.
+     * Returns a release function that must be called to release the lock.
+         * WARNING: The key scope is global to the entire process, so follow the convention of using `ClassName.methodName:${id}` to avoid conflicts.
+     */
+    static acquire(key: string): Promise<() => void>;
+}
+//# sourceMappingURL=latches.d.ts.map

package/dist/src/utility/latches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latches.d.ts","sourceRoot":"","sources":["../../../src/utility/latches.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,qBAAa,OAAO;IAEhB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAoC;IAE7D;;;;OAIG;WACU,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;CA+BzD"}

package/dist/src/utility/latches.js

@@ -0,0 +1,36 @@
+/** Lightweight implementation of a mutex lock queue. */
+export class Latches {
+    // Stores the promise representing the completion of the last queued operation for a key.
+    static lockQueues = new Map();
+    /**
+     * Acquires a lock for the given key. Waits if another operation holds the lock.
+     * Returns a release function that must be called to release the lock.
+         * WARNING: The key scope is global to the entire process, so follow the convention of using `ClassName.methodName:${id}` to avoid conflicts.
+     */
+    static async acquire(key) {
+        // Get the promise the current operation needs to wait for (if any)
+        const currentTail = this.lockQueues.get(key) ?? Promise.resolve();
+        let resolveNewTail;
+        // Create the promise that the *next* operation will wait for
+        const newTail = new Promise(resolve => {
+            resolveNewTail = resolve;
+        });
+        // Immediately set the new promise as the tail for this key
+        this.lockQueues.set(key, newTail);
+        // Wait for the previous operation (if any) to complete
+        await currentTail;
+        // Lock acquired. Return the function to release *this* lock.
+        const release = () => {
+            // Signal that this operation is complete, allowing the next awaiter (if any)
+            resolveNewTail();
+            // Optimization: If this promise is still the current tail in the map,
+            // it means no other operation queued up behind this one while it was running.
+            // We can safely remove the entry from the map to prevent unbounded growth.
+            if (this.lockQueues.get(key) === newTail) {
+                this.lockQueues.delete(key);
+            }
+        };
+        return release;
+    }
+}
+//# sourceMappingURL=latches.js.map

package/dist/src/utility/latches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latches.js","sourceRoot":"","sources":["../../../src/utility/latches.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,OAAO,OAAO;IAChB,yFAAyF;IACjF,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7D;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAW;QAC5B,mEAAmE;QACnE,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAElE,IAAI,cAA0B,CAAC;QAC/B,6DAA6D;QAC7D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YACxC,cAAc,GAAG,OAAO,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,2DAA2D;QAC3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAElC,uDAAuD;QACvD,MAAM,WAAW,CAAC;QAElB,6DAA6D;QAC7D,MAAM,OAAO,GAAG,GAAG,EAAE;YACjB,6EAA6E;YAC7E,cAAc,EAAE,CAAC;YAEjB,sEAAsE;YACtE,8EAA8E;YAC9E,2EAA2E;YAC3E,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;gBACvC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,OAAO,CAAC;IACnB,CAAC"}

package/dist/src/utility/nameof.d.ts

@@ -0,0 +1,3 @@
+export declare function nameof<TObject>(obj: TObject, key: keyof TObject): string;
+export declare function nameof<TObject>(key: keyof TObject): string;
+//# sourceMappingURL=nameof.d.ts.map

package/dist/src/utility/nameof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameof.d.ts","sourceRoot":"","sources":["../../../src/utility/nameof.ts"],"names":[],"mappings":"AACA,wBAAgB,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,GAAG,MAAM,CAAC;AAC1E,wBAAgB,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,GAAG,MAAM,CAAC"}

package/dist/src/utility/nameof.js

@@ -0,0 +1,5 @@
+export function nameof(key1, key2) {
+    return key2 ?? key1;
+}
+/* eslint-enable */
+//# sourceMappingURL=nameof.js.map

package/dist/src/utility/nameof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameof.js","sourceRoot":"","sources":["../../../src/utility/nameof.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,MAAM,CAAC,IAAS,EAAE,IAAU;IAC1C,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AACD,mBAAmB"}

package/dist/src/utility/pending.d.ts

@@ -0,0 +1,13 @@
+export declare class Pending<T> {
+    promise: Promise<T>;
+    response?: T;
+    error?: unknown;
+    t1: number;
+    duration?: number;
+    get isResponse(): boolean;
+    get isError(): boolean;
+    get isComplete(): boolean;
+    result(): Promise<T>;
+    constructor(promise: Promise<T>);
+}
+//# sourceMappingURL=pending.d.ts.map

package/dist/src/utility/pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../../src/utility/pending.ts"],"names":[],"mappings":"AAAA,qBAAa,OAAO,CAAC,CAAC;IA6Bb,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IA5B3B,QAAQ,CAAC,EAAE,CAAC,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,SAAc;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAEK,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;gBAWlB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CAW3B"}

package/dist/src/utility/pending.js

@@ -0,0 +1,37 @@
+export class Pending {
+    promise;
+    response;
+    error;
+    t1 = Date.now();
+    duration;
+    get isResponse() {
+        return this.response !== undefined;
+    }
+    get isError() {
+        return this.error !== undefined;
+    }
+    get isComplete() {
+        return this.isResponse || this.isError;
+    }
+    async result() {
+        if (this.isResponse) {
+            return this.response;
+        }
+        if (this.isError) {
+            throw this.error;
+        }
+        return await this.promise;
+    }
+    constructor(promise) {
+        this.promise = promise;
+        promise.then(response => {
+            this.duration = Date.now() - this.t1;
+            this.response = response;
+            return response;
+        }, error => {
+            this.duration = Date.now() - this.t1;
+            this.error = error;
+        });
+    }
+}
+//# sourceMappingURL=pending.js.map

package/dist/src/utility/pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.js","sourceRoot":"","sources":["../../../src/utility/pending.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,OAAO;IA6BX;IA5BR,QAAQ,CAAK;IACb,KAAK,CAAW;IAChB,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChB,QAAQ,CAAU;IAElB,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC;IACpC,CAAC;IAED,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IACjC,CAAC;IAED,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM;QACX,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,QAAS,CAAC;QACvB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,KAAM,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED,YACQ,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;QAE1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACzB,OAAO,QAAQ,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,EAAE;YACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@optimystic/db-core",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "Core database functionality for Optimystic",
+  "main": "dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gotchoices/optimystic.git",
+    "directory": "packages/db-core"
+  },
+  "author": "Got Choices Foundation",
+  "license": "MIT",
+  "keywords": [
+    "optimystic",
+    "database",
+    "core",
+    "distributed",
+    "transactional",
+    "acid"
+  ],
+  "scripts": {
+    "clean": "aegir clean",
+    "build": "aegir build --env node",
+    "lint": "aegir lint",
+    "test": "aegir test",
+    "test:node": "aegir test -t node",
+    "dep-check": "aegir dep-check"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "aegir": "^45.1.4"
+  },
+  "dependencies": {
+    "@libp2p/crypto": "^5.1.7",
+    "@libp2p/interface": "^2.10.5",
+    "@libp2p/peer-id": "^5.1.8",
+    "@libp2p/peer-id-factory": "^4.2.4",
+    "@multiformats/multiaddr": "^12.5.1",
+    "debug": "^4.4.1",
+    "uint8arrays": "^5.1.0"
+  }
+}

package/src/blocks/block-store.ts

@@ -0,0 +1,13 @@
+import type { BlockType, IBlock, BlockId, BlockHeader, BlockOperation } from "./index.js";
+
+export type BlockSource<T extends IBlock> = {
+	createBlockHeader(type: BlockType, newId?: BlockId): BlockHeader;
+	tryGet(id: BlockId): Promise<T | undefined>;
+	generateId(): BlockId;
+};
+
+export type BlockStore<T extends IBlock> = BlockSource<T> & {
+	insert(block: T): void;
+	update(blockId: BlockId, op: BlockOperation): void;
+	delete(blockId: BlockId): void;
+};

package/src/blocks/block-types.ts

@@ -0,0 +1,11 @@
+import type { BlockType } from ".";
+
+const blockTypes = new Map<BlockType, string>();
+
+export function registerBlockType(blockType: BlockType, name: string) {
+	if (blockTypes.has(blockType)) {
+		throw new Error(`Block type ${blockType} (${name}) already registered (${blockTypes.get(blockType)})`);
+	}
+	blockTypes.set(blockType, name);
+	return blockType;
+}

package/src/blocks/helpers.ts

@@ -0,0 +1,13 @@
+import type { BlockOperation, IBlock, BlockId, BlockStore } from "../index.js";
+import { applyOperation } from "../transform/helpers.js";
+
+export async function get<T extends IBlock>(store: BlockStore<T>, id: BlockId): Promise<T> {
+	const block = await store.tryGet(id);
+	if (!block) throw Error(`Missing block (${id})`);
+	return block;
+}
+
+export function apply<T extends IBlock>(store: BlockStore<T>, block: IBlock, op: BlockOperation) {
+	applyOperation(block, op);
+	store.update(block.header.id, op);
+}

package/src/blocks/index.ts

@@ -0,0 +1,5 @@
+export * from "./block-store.js";
+export * from "./block-types.js";
+export * from "./helpers.js";
+export * from "./structs.js";
+

package/src/blocks/structs.ts

@@ -0,0 +1,17 @@
+export type BlockId = string;	// base32 encoded
+export type BlockType = string;	// Generally a short code
+
+export type BlockHeader = {
+	id: BlockId;  // Domain wide block identifier
+	type: BlockType;
+	collectionId: BlockId;
+}
+
+/** A simple block with only a header.  Blocks should be treated as immutable */
+export type IBlock = {
+	header: BlockHeader;
+}
+
+export type BlockOperation = [entity: string, index: number, deleteCount: number, inserted: unknown[] | unknown]
+export type BlockOperations = BlockOperation[];
+