@utilarium/overcontext 0.0.4-dev.0

package/dist/storage/memory.js

@@ -0,0 +1,128 @@
+import { ReadonlyStorageError, ValidationError } from './errors.js';
+
+const createMemoryProvider = (options)=>{
+    const { registry, readonly = false, defaultNamespace, initialData = [] } = options;
+    // Storage: namespace -> type -> id -> entity
+    const store = new Map();
+    const getNamespaceStore = (namespace)=>{
+        if (!store.has(namespace)) {
+            store.set(namespace, new Map());
+        }
+        return store.get(namespace);
+    };
+    const getTypeStore = (namespace, type)=>{
+        const nsStore = getNamespaceStore(namespace);
+        if (!nsStore.has(type)) {
+            nsStore.set(type, new Map());
+        }
+        return nsStore.get(type);
+    };
+    const resolveNamespace = (ns)=>{
+        var _ref;
+        return (_ref = ns !== null && ns !== void 0 ? ns : defaultNamespace) !== null && _ref !== void 0 ? _ref : '_default';
+    };
+    // Initialize with any provided data
+    for (const entity of initialData){
+        const ns = resolveNamespace(entity.namespace);
+        getTypeStore(ns, entity.type).set(entity.id, entity);
+    }
+    return {
+        name: 'memory',
+        location: 'in-memory',
+        registry,
+        async initialize () {},
+        async dispose () {
+            store.clear();
+        },
+        async isAvailable () {
+            return true;
+        },
+        async get (type, id, namespace) {
+            const ns = resolveNamespace(namespace);
+            return getTypeStore(ns, type).get(id);
+        },
+        async getAll (type, namespace) {
+            const ns = resolveNamespace(namespace);
+            return Array.from(getTypeStore(ns, type).values());
+        },
+        async find (filter) {
+            var _filter_ids;
+            let results = [];
+            const types = filter.type ? Array.isArray(filter.type) ? filter.type : [
+                filter.type
+            ] : registry.types();
+            const ns = resolveNamespace(filter.namespace);
+            for (const type of types){
+                results = results.concat(await this.getAll(type, ns));
+            }
+            if ((_filter_ids = filter.ids) === null || _filter_ids === void 0 ? void 0 : _filter_ids.length) {
+                results = results.filter((e)=>filter.ids.includes(e.id));
+            }
+            if (filter.search) {
+                const s = filter.search.toLowerCase();
+                results = results.filter((e)=>e.name.toLowerCase().includes(s));
+            }
+            if (filter.offset) results = results.slice(filter.offset);
+            if (filter.limit) results = results.slice(0, filter.limit);
+            return results;
+        },
+        async exists (type, id, namespace) {
+            const ns = resolveNamespace(namespace);
+            return getTypeStore(ns, type).has(id);
+        },
+        async count (filter) {
+            return (await this.find(filter)).length;
+        },
+        async save (entity, namespace) {
+            if (readonly) {
+                throw new ReadonlyStorageError();
+            }
+            const validationResult = registry.validate(entity);
+            if (!validationResult.success) {
+                throw new ValidationError('Validation failed', validationResult.errors || []);
+            }
+            const ns = resolveNamespace(namespace);
+            const now = new Date();
+            const existing = getTypeStore(ns, entity.type).get(entity.id);
+            const saved = {
+                ...entity,
+                namespace: ns,
+                createdAt: (existing === null || existing === void 0 ? void 0 : existing.createdAt) || now,
+                updatedAt: now
+            };
+            getTypeStore(ns, entity.type).set(entity.id, saved);
+            return saved;
+        },
+        async delete (type, id, namespace) {
+            if (readonly) {
+                throw new ReadonlyStorageError();
+            }
+            const ns = resolveNamespace(namespace);
+            return getTypeStore(ns, type).delete(id);
+        },
+        async saveBatch (entities, namespace) {
+            return Promise.all(entities.map((e)=>this.save(e, namespace)));
+        },
+        async deleteBatch (refs, namespace) {
+            let count = 0;
+            for (const ref of refs){
+                if (await this.delete(ref.type, ref.id, namespace)) count++;
+            }
+            return count;
+        },
+        async listNamespaces () {
+            return Array.from(store.keys()).filter((ns)=>ns !== '_default');
+        },
+        async namespaceExists (namespace) {
+            return store.has(namespace);
+        },
+        async listTypes (namespace) {
+            const ns = resolveNamespace(namespace);
+            const nsStore = store.get(ns);
+            return nsStore ? Array.from(nsStore.keys()) : [];
+        }
+    };
+};
+
+export { createMemoryProvider };
+//# sourceMappingURL=memory.js.map

package/dist/storage/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sources":["../../src/storage/memory.ts"],"sourcesContent":["import { StorageProvider, StorageProviderOptions, EntityFilter } from './interface';\nimport { BaseEntity } from '../schema/base';\nimport { ValidationError, ReadonlyStorageError } from './errors';\n\nexport interface MemoryProviderOptions extends StorageProviderOptions {\n    /** Initial data to populate */\n    initialData?: BaseEntity[];\n}\n\nexport const createMemoryProvider = (\n    options: MemoryProviderOptions\n): StorageProvider => {\n    const { registry, readonly = false, defaultNamespace, initialData = [] } = options;\n\n    // Storage: namespace -> type -> id -> entity\n    const store = new Map<string, Map<string, Map<string, BaseEntity>>>();\n\n    const getNamespaceStore = (namespace: string): Map<string, Map<string, BaseEntity>> => {\n        if (!store.has(namespace)) {\n            store.set(namespace, new Map());\n        }\n        return store.get(namespace)!;\n    };\n\n    const getTypeStore = (\n        namespace: string,\n        type: string\n    ): Map<string, BaseEntity> => {\n        const nsStore = getNamespaceStore(namespace);\n        if (!nsStore.has(type)) {\n            nsStore.set(type, new Map());\n        }\n        return nsStore.get(type)!;\n    };\n\n    const resolveNamespace = (ns?: string): string => ns ?? defaultNamespace ?? '_default';\n\n    // Initialize with any provided data\n    for (const entity of initialData) {\n        const ns = resolveNamespace(entity.namespace);\n        getTypeStore(ns, entity.type).set(entity.id, entity);\n    }\n\n    return {\n        name: 'memory',\n        location: 'in-memory',\n        registry,\n\n        async initialize() { },\n\n        async dispose() {\n            store.clear();\n        },\n\n        async isAvailable() {\n            return true;\n        },\n\n        async get<T extends BaseEntity>(\n            type: string,\n            id: string,\n            namespace?: string\n        ): Promise<T | undefined> {\n            const ns = resolveNamespace(namespace);\n            return getTypeStore(ns, type).get(id) as T | undefined;\n        },\n\n        async getAll<T extends BaseEntity>(\n            type: string,\n            namespace?: string\n        ): Promise<T[]> {\n            const ns = resolveNamespace(namespace);\n            return Array.from(getTypeStore(ns, type).values()) as T[];\n        },\n\n        async find<T extends BaseEntity>(filter: EntityFilter): Promise<T[]> {\n            let results: T[] = [];\n\n            const types = filter.type\n                ? (Array.isArray(filter.type) ? filter.type : [filter.type])\n                : registry.types();\n\n            const ns = resolveNamespace(filter.namespace);\n\n            for (const type of types) {\n                results = results.concat(await this.getAll<T>(type, ns));\n            }\n\n            if (filter.ids?.length) {\n                results = results.filter(e => filter.ids!.includes(e.id));\n            }\n\n            if (filter.search) {\n                const s = filter.search.toLowerCase();\n                results = results.filter(e => e.name.toLowerCase().includes(s));\n            }\n\n            if (filter.offset) results = results.slice(filter.offset);\n            if (filter.limit) results = results.slice(0, filter.limit);\n\n            return results;\n        },\n\n        async exists(type: string, id: string, namespace?: string): Promise<boolean> {\n            const ns = resolveNamespace(namespace);\n            return getTypeStore(ns, type).has(id);\n        },\n\n        async count(filter: EntityFilter): Promise<number> {\n            return (await this.find(filter)).length;\n        },\n\n        async save<T extends BaseEntity>(entity: T, namespace?: string): Promise<T> {\n            if (readonly) {\n                throw new ReadonlyStorageError();\n            }\n\n            const validationResult = registry.validate(entity);\n            if (!validationResult.success) {\n                throw new ValidationError(\n                    'Validation failed',\n                    validationResult.errors || []\n                );\n            }\n\n            const ns = resolveNamespace(namespace);\n            const now = new Date();\n            const existing = getTypeStore(ns, entity.type).get(entity.id);\n\n            const saved = {\n                ...entity,\n                namespace: ns,\n                createdAt: existing?.createdAt || now,\n                updatedAt: now,\n            } as T;\n\n            getTypeStore(ns, entity.type).set(entity.id, saved);\n            return saved;\n        },\n\n        async delete(type: string, id: string, namespace?: string): Promise<boolean> {\n            if (readonly) {\n                throw new ReadonlyStorageError();\n            }\n\n            const ns = resolveNamespace(namespace);\n            return getTypeStore(ns, type).delete(id);\n        },\n\n        async saveBatch<T extends BaseEntity>(\n            entities: T[],\n            namespace?: string\n        ): Promise<T[]> {\n            return Promise.all(entities.map(e => this.save(e, namespace)));\n        },\n\n        async deleteBatch(\n            refs: Array<{ type: string; id: string }>,\n            namespace?: string\n        ): Promise<number> {\n            let count = 0;\n            for (const ref of refs) {\n                if (await this.delete(ref.type, ref.id, namespace)) count++;\n            }\n            return count;\n        },\n\n        async listNamespaces(): Promise<string[]> {\n            return Array.from(store.keys()).filter(ns => ns !== '_default');\n        },\n\n        async namespaceExists(namespace: string): Promise<boolean> {\n            return store.has(namespace);\n        },\n\n        async listTypes(namespace?: string): Promise<string[]> {\n            const ns = resolveNamespace(namespace);\n            const nsStore = store.get(ns);\n            return nsStore ? Array.from(nsStore.keys()) : [];\n        },\n    };\n};\n"],"names":["createMemoryProvider","options","registry","readonly","defaultNamespace","initialData","store","Map","getNamespaceStore","namespace","has","set","get","getTypeStore","type","nsStore","resolveNamespace","ns","entity","id","name","location","initialize","dispose","clear","isAvailable","getAll","Array","from","values","find","filter","results","types","isArray","concat","ids","length","e","includes","search","s","toLowerCase","offset","slice","limit","exists","count","save","ReadonlyStorageError","validationResult","validate","success","ValidationError","errors","now","Date","existing","saved","createdAt","updatedAt","delete","saveBatch","entities","Promise","all","map","deleteBatch","refs","ref","listNamespaces","keys","namespaceExists","listTypes"],"mappings":"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"}

package/dist/storage/observable.d.ts

@@ -0,0 +1,6 @@
+import { StorageProvider } from './interface';
+import { ObservableStorageProvider } from './events';
+/**
+ * Wrap any StorageProvider to make it observable.
+ */
+export declare const createObservableProvider: (provider: StorageProvider) => ObservableStorageProvider;

package/dist/storage/observable.js

@@ -0,0 +1,98 @@
+/**
+ * Wrap any StorageProvider to make it observable.
+ */ const createObservableProvider = (provider)=>{
+    const handlers = new Set();
+    const emit = (event)=>{
+        handlers.forEach((handler)=>{
+            try {
+                handler(event);
+            } catch (error) {
+                // eslint-disable-next-line no-console
+                console.error('Storage event handler error:', error);
+            }
+        });
+    };
+    return {
+        ...provider,
+        subscribe (handler) {
+            handlers.add(handler);
+            return ()=>handlers.delete(handler);
+        },
+        async initialize () {
+            await provider.initialize();
+            emit({
+                type: 'storage:initialized',
+                timestamp: new Date()
+            });
+        },
+        async dispose () {
+            emit({
+                type: 'storage:disposed',
+                timestamp: new Date()
+            });
+            await provider.dispose();
+        },
+        async save (entity, namespace) {
+            const existing = await provider.get(entity.type, entity.id, namespace);
+            const saved = await provider.save(entity, namespace);
+            if (existing) {
+                emit({
+                    type: 'entity:updated',
+                    timestamp: new Date(),
+                    namespace,
+                    entityType: entity.type,
+                    entityId: entity.id,
+                    entity: saved,
+                    previousEntity: existing
+                });
+            } else {
+                emit({
+                    type: 'entity:created',
+                    timestamp: new Date(),
+                    namespace,
+                    entityType: entity.type,
+                    entityId: entity.id,
+                    entity: saved
+                });
+            }
+            return saved;
+        },
+        async delete (type, id, namespace) {
+            const deleted = await provider.delete(type, id, namespace);
+            if (deleted) {
+                emit({
+                    type: 'entity:deleted',
+                    timestamp: new Date(),
+                    namespace,
+                    entityType: type,
+                    entityId: id
+                });
+            }
+            return deleted;
+        },
+        async saveBatch (entities, namespace) {
+            const saved = await provider.saveBatch(entities, namespace);
+            emit({
+                type: 'batch:saved',
+                timestamp: new Date(),
+                namespace,
+                entities: saved
+            });
+            return saved;
+        },
+        async deleteBatch (refs, namespace) {
+            const count = await provider.deleteBatch(refs, namespace);
+            emit({
+                type: 'batch:deleted',
+                timestamp: new Date(),
+                namespace,
+                refs,
+                deletedCount: count
+            });
+            return count;
+        }
+    };
+};
+
+export { createObservableProvider };
+//# sourceMappingURL=observable.js.map

package/dist/storage/observable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable.js","sources":["../../src/storage/observable.ts"],"sourcesContent":["import { BaseEntity } from '../schema/base';\nimport { StorageProvider } from './interface';\nimport {\n    StorageEventHandler,\n    AnyStorageEvent,\n    ObservableStorageProvider,\n} from './events';\n\n/**\n * Wrap any StorageProvider to make it observable.\n */\nexport const createObservableProvider = (\n    provider: StorageProvider\n): ObservableStorageProvider => {\n    const handlers = new Set<StorageEventHandler>();\n\n    const emit = (event: AnyStorageEvent): void => {\n        handlers.forEach(handler => {\n            try {\n                handler(event);\n            } catch (error) {\n                // eslint-disable-next-line no-console\n                console.error('Storage event handler error:', error);\n            }\n        });\n    };\n\n    return {\n        ...provider,\n\n        subscribe(handler: StorageEventHandler): () => void {\n            handlers.add(handler);\n            return () => handlers.delete(handler);\n        },\n\n        async initialize(): Promise<void> {\n            await provider.initialize();\n            emit({ type: 'storage:initialized', timestamp: new Date() });\n        },\n\n        async dispose(): Promise<void> {\n            emit({ type: 'storage:disposed', timestamp: new Date() });\n            await provider.dispose();\n        },\n\n        async save<T extends BaseEntity>(entity: T, namespace?: string): Promise<T> {\n            const existing = await provider.get(entity.type, entity.id, namespace);\n            const saved = await provider.save(entity, namespace);\n\n            if (existing) {\n                emit({\n                    type: 'entity:updated',\n                    timestamp: new Date(),\n                    namespace,\n                    entityType: entity.type,\n                    entityId: entity.id,\n                    entity: saved,\n                    previousEntity: existing,\n                });\n            } else {\n                emit({\n                    type: 'entity:created',\n                    timestamp: new Date(),\n                    namespace,\n                    entityType: entity.type,\n                    entityId: entity.id,\n                    entity: saved,\n                });\n            }\n\n            return saved;\n        },\n\n        async delete(type: string, id: string, namespace?: string): Promise<boolean> {\n            const deleted = await provider.delete(type, id, namespace);\n\n            if (deleted) {\n                emit({\n                    type: 'entity:deleted',\n                    timestamp: new Date(),\n                    namespace,\n                    entityType: type,\n                    entityId: id,\n                });\n            }\n\n            return deleted;\n        },\n\n        async saveBatch<T extends BaseEntity>(entities: T[], namespace?: string): Promise<T[]> {\n            const saved = await provider.saveBatch(entities, namespace);\n\n            emit({\n                type: 'batch:saved',\n                timestamp: new Date(),\n                namespace,\n                entities: saved,\n            });\n\n            return saved;\n        },\n\n        async deleteBatch(\n            refs: Array<{ type: string; id: string }>,\n            namespace?: string\n        ): Promise<number> {\n            const count = await provider.deleteBatch(refs, namespace);\n\n            emit({\n                type: 'batch:deleted',\n                timestamp: new Date(),\n                namespace,\n                refs,\n                deletedCount: count,\n            });\n\n            return count;\n        },\n    };\n};\n"],"names":["createObservableProvider","provider","handlers","Set","emit","event","forEach","handler","error","console","subscribe","add","delete","initialize","type","timestamp","Date","dispose","save","entity","namespace","existing","get","id","saved","entityType","entityId","previousEntity","deleted","saveBatch","entities","deleteBatch","refs","count","deletedCount"],"mappings":"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"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@utilarium/overcontext",
+  "version": "0.0.4-dev.0",
+  "description": "Schema-driven framework for context management - provides infrastructure for defining and managing custom entity schemas.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/utilarium/overcontext.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run lint && tsc --noEmit && vite build",
+    "dev": "vite build --watch",
+    "watch": "vite build --watch",
+    "test": "vitest run --coverage",
+    "precommit": "npm run lint && npm run test",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "docs:dev": "cd docs && cp ../README.md public/ && npm install && npm run dev",
+    "docs:build": "cd docs && cp ../README.md public/ && npm install && npm run build",
+    "docs:preview": "cd docs && npm run preview",
+    "docs:test": "cd docs && npm install && npm run test",
+    "docs:coverage": "cd docs && npm install && npm run coverage"
+  },
+  "keywords": [
+    "context",
+    "schema",
+    "entity",
+    "framework",
+    "zod",
+    "storage",
+    "hierarchical",
+    "discovery"
+  ],
+  "author": "Tim O'Brien <tobrien@discursive.com>",
+  "license": "Apache-2.0",
+  "homepage": "https://utilarium.github.io/overcontext/",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.30.1",
+    "@rollup/plugin-replace": "^6.0.2",
+    "@swc/core": "^1.12.11",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.36.0",
+    "@typescript-eslint/parser": "^8.36.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "ajv": "^8.17.1",
+    "eslint": "^9.30.1",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^17.0.0",
+    "typescript": "^5.8.3",
+    "vite": "^7.0.4",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-node": "^7.0.0",
+    "vitest": "^4.0.16"
+  },
+  "overrides": {
+    "wrap-ansi": "7.0.0"
+  }
+}