conftree 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nekena RABEHARIVONJY
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# conftree
+
+[![Socket Badge](https://badge.socket.dev/npm/package/conftree/0.1.0)](https://badge.socket.dev/npm/package/conftree/0.1.0)
+
+Generic hierarchical configuration engine. Arbitrary scopes, inheritance, caching, audit trail. Zero required dependencies: works standalone or with any storage/pub-sub backend.
+
+## Install
+
+```bash
+npm install conftree
+```
+
+## Usage
+
+```ts
+import { createEngine } from 'conftree';
+
+const { storage, resolver, writer } = createEngine();
+
+await storage.createDef({
+	key: 'ui.theme',
+	label: 'Theme',
+	type: 'ENUM',
+	options: ['light', 'dark', 'system'],
+	scopes: ['user'],
+	inherit: 'INDEPENDENT',
+	required: false,
+	status: 'STABLE',
+});
+
+await writer.set({
+	key: 'ui.theme',
+	scope: { kind: 'user', refId: 'u1' },
+	value: 'dark',
+	authorId: 'u1',
+});
+await resolver.get('ui.theme', { kind: 'user', refId: 'u1' }); // 'dark'
+```
+
+Revert a scope back to its inherited or default value:
+
+```ts
+await writer.unset({
+	key: 'ui.theme',
+	scope: { kind: 'user', refId: 'u1' },
+	authorId: 'u1',
+});
+```
+
+Inspect the audit trail for a setting:
+
+```ts
+const { auditor } = createEngine();
+await auditor.history('ui.theme', { kind: 'user', refId: 'u1' });
+// [{ action: 'created', authorId: 'u1', after: {...}, at: ... }, ...]
+```
+
+List every setting explicitly set at a scope (paginated):
+
+```ts
+const { entries, nextCursor } = await resolver.listAt({
+	kind: 'user',
+	refId: 'u1',
+});
+// { entries: { 'ui.theme': 'dark', 'ui.pageSize': 20 }, nextCursor: null }
+```
+
+Deprecate or retire a definition (retired definitions stop being readable and writable, but keep their audit history):
+
+```ts
+await storage.updateDefStatus('ui.theme', 'RETIRED');
+```
+
+Bring your own storage or pub/sub backend:
+
+```ts
+const { resolver, writer } = createEngine({
+	storage: new MyPostgresAdapter(pool),
+	hierarchy: new MyClosureTableHierarchy(pool),
+	bus: new MyRedisBus(redisClient),
+});
+```
+
+### Value types
+
+`BOOLEAN`, `NUMERIC`, `TEXT`, `ENUM`, `JSON`, `DATE`.
+
+### Hierarchy
+
+```ts
+const { hierarchy } = createEngine();
+await hierarchy.attach('org-1', null);
+await hierarchy.attach('org-2', null);
+await hierarchy.attach('team-1', 'org-1');
+await hierarchy.move('team-1', 'org-2');
+await hierarchy.detach('team-1');
+```
+
+### Typed settings registry
+
+Get autocomplete and compile-time checking on keys, scopes, and value types by declaring your settings once and wrapping the engine:
+
+```ts
+import { createEngine, createTypedEngine } from 'conftree';
+
+interface Registry {
+	'ui.theme': { value: 'light' | 'dark' | 'system'; scope: 'user' };
+	'chama.contributionAmount': { value: number; scope: 'group' | 'member' };
+}
+
+const { resolver, writer } = createTypedEngine<Registry>(createEngine());
+
+await writer.set({
+	key: 'ui.theme',
+	scope: { kind: 'user', refId: 'u1' },
+	value: 'dark', // only 'light' | 'dark' | 'system' is accepted
+	authorId: 'u1',
+});
+await resolver.get('ui.theme', { kind: 'user', refId: 'u1' }); // typed 'light' | 'dark' | 'system'
+```
+
+`Registry` must be a plain interface/type (not `extends` anything with an index signature) for key-level narrowing to work — see `src/typed/registry.ts` for the `SettingValue`/`SettingScopeKind` helpers this is built on.
+
+### Writing an adapter
+
+Implement `StorageAdapter`, `ScopeHierarchy`, or `ChangeBus`, all defined in `src/storage/storage-port.ts`, `src/core/types.ts`, and `src/cache/change-bus.ts`. `MemoryStorageAdapter` and `LocalScopeHierarchy` are the reference implementations.
+
+## API
+
+- `createEngine(options?)`: returns `{ storage, hierarchy, bus, cache, resolver, writer, auditor }`.
+- `resolver.get(key, scope, asOf?)`, `resolver.getMany(keys, scope, asOf?)`, `resolver.listAt(scope, { limit?, cursor? })`
+- `writer.set(params)`, `writer.setMany(paramsList)`, `writer.unset(params)`
+- `auditor.history(key, scope?)`
+- `storage.updateDefStatus(key, status)`
+- `createTypedEngine<Registry>(engine)`: returns `{ resolver, writer, auditor }` typed against your own key/value/scope registry.
+
+### Errors
+
+All errors extend `ConfTreeError` and carry a stable `code` (e.g. `'CONFLICT'`, `'NOT_FOUND'`), in addition to a specific class (`ConflictError`, `NotFoundError`, ...) and `name`.
+
+## License
+
+MIT

package/dist/cache/cache.d.ts

@@ -0,0 +1,23 @@
+import type { Scope, ScopeHierarchy, Value } from '../core/types';
+import type { ChangeBus } from './change-bus';
+export interface CacheOptions {
+    enabled?: boolean;
+    ttlMs?: number;
+    maxEntries?: number;
+}
+export declare class Cache {
+    private readonly bus;
+    private readonly options;
+    private readonly hierarchy?;
+    private readonly store;
+    constructor(bus: ChangeBus, options?: CacheOptions, hierarchy?: ScopeHierarchy | undefined);
+    get(key: string, scope: Scope): Value | undefined;
+    set(key: string, scope: Scope, value: Value): void;
+    drop(key: string): void;
+    dropAll(): void;
+    dropForScopes(scopeRefIds: Iterable<string>): void;
+    private dropScoped;
+    private onChange;
+    private keyFor;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,qBAAa,KAAK;IAIhB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAL5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;gBAGhC,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,YAAiB,EAC1B,SAAS,CAAC,EAAE,cAAc,YAAA;IAK5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS;IAYjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAoBlD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMvB,OAAO,IAAI,IAAI;IAIf,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAUlD,OAAO,CAAC,UAAU;YAaJ,QAAQ;IAatB,OAAO,CAAC,MAAM;CAGd"}

package/dist/cache/cache.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cache = void 0;
+const DEFAULT_TTL_MS = 30_000;
+const DEFAULT_MAX_ENTRIES = 50_000;
+class Cache {
+    bus;
+    options;
+    hierarchy;
+    store = new Map();
+    constructor(bus, options = {}, hierarchy) {
+        this.bus = bus;
+        this.options = options;
+        this.hierarchy = hierarchy;
+        this.bus.subscribe((event) => this.onChange(event));
+    }
+    get(key, scope) {
+        if (this.options.enabled === false)
+            return undefined;
+        const cacheKey = this.keyFor(key, scope);
+        const entry = this.store.get(cacheKey);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt <= Date.now()) {
+            this.store.delete(cacheKey);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(key, scope, value) {
+        if (this.options.enabled === false)
+            return;
+        const cacheKey = this.keyFor(key, scope);
+        if (!this.store.has(cacheKey) &&
+            this.store.size >= (this.options.maxEntries ?? DEFAULT_MAX_ENTRIES)) {
+            const oldest = this.store.keys().next().value;
+            if (oldest !== undefined)
+                this.store.delete(oldest);
+        }
+        const ttlMs = this.options.ttlMs ?? DEFAULT_TTL_MS;
+        this.store.set(cacheKey, {
+            key,
+            scopeKind: scope.kind,
+            scopeRefId: scope.refId,
+            value,
+            expiresAt: Date.now() + ttlMs,
+        });
+    }
+    drop(key) {
+        for (const [cacheKey, entry] of this.store) {
+            if (entry.key === key)
+                this.store.delete(cacheKey);
+        }
+    }
+    dropAll() {
+        this.store.clear();
+    }
+    dropForScopes(scopeRefIds) {
+        const targets = new Set(scopeRefIds);
+        if (targets.size === 0)
+            return;
+        for (const [cacheKey, entry] of this.store) {
+            if (entry.scopeRefId !== null && targets.has(entry.scopeRefId)) {
+                this.store.delete(cacheKey);
+            }
+        }
+    }
+    dropScoped(key, scopeRefIds) {
+        const targets = new Set(scopeRefIds);
+        for (const [cacheKey, entry] of this.store) {
+            if (entry.key === key &&
+                entry.scopeRefId !== null &&
+                targets.has(entry.scopeRefId)) {
+                this.store.delete(cacheKey);
+            }
+        }
+    }
+    async onChange(event) {
+        if (this.hierarchy && event.scopeRefId !== null) {
+            const descendants = await this.hierarchy
+                .descendants(event.scopeRefId)
+                .catch(() => null);
+            if (descendants !== null) {
+                this.dropScoped(event.key, descendants);
+                return;
+            }
+        }
+        this.drop(event.key);
+    }
+    keyFor(key, scope) {
+        return JSON.stringify([key, scope.kind, scope.refId]);
+    }
+}
+exports.Cache = Cache;
+//# sourceMappingURL=cache.js.map

package/dist/cache/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache/cache.ts"],"names":[],"mappings":";;;AAiBA,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,MAAa,KAAK;IAIC;IACA;IACA;IALD,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IAElD,YACkB,GAAc,EACd,UAAwB,EAAE,EAC1B,SAA0B;QAF1B,QAAG,GAAH,GAAG,CAAW;QACd,YAAO,GAAP,OAAO,CAAmB;QAC1B,cAAS,GAAT,SAAS,CAAiB;QAE3C,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAY;QAC5B,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO,SAAS,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAY,EAAE,KAAY;QAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK;YAAE,OAAO;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,IACC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,EAClE,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACxB,GAAG;YACH,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,UAAU,EAAE,KAAK,CAAC,KAAK;YACvB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC7B,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAW;QACf,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;IACF,CAAC;IAED,OAAO;QACN,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,WAA6B;QAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAC/B,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,GAAW,EAAE,WAA6B;QAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACrC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5C,IACC,KAAK,CAAC,GAAG,KAAK,GAAG;gBACjB,KAAK,CAAC,UAAU,KAAK,IAAI;gBACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAC5B,CAAC;gBACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,KAAkB;QACxC,IAAI,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS;iBACtC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;iBAC7B,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;gBACxC,OAAO;YACR,CAAC;QACF,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAEO,MAAM,CAAC,GAAW,EAAE,KAAY;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;CACD;AA5FD,sBA4FC"}

package/dist/cache/change-bus.d.ts

@@ -0,0 +1,16 @@
+export interface ChangeEvent {
+    definitionId: string;
+    key: string;
+    scopeKind: string;
+    scopeRefId: string | null;
+}
+export interface ChangeBus {
+    publish(event: ChangeEvent): Promise<void>;
+    subscribe(listener: (event: ChangeEvent) => void | Promise<void>): void;
+}
+export declare class LocalBus implements ChangeBus {
+    private readonly listeners;
+    publish(event: ChangeEvent): Promise<void>;
+    subscribe(listener: (event: ChangeEvent) => void | Promise<void>): void;
+}
+//# sourceMappingURL=change-bus.d.ts.map

package/dist/cache/change-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-bus.d.ts","sourceRoot":"","sources":["../../src/cache/change-bus.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACzB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxE;AAED,qBAAa,QAAS,YAAW,SAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAEtB;IAEE,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGvE"}

package/dist/cache/change-bus.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalBus = void 0;
+class LocalBus {
+    listeners = new Set();
+    async publish(event) {
+        await Promise.all([...this.listeners].map((listener) => Promise.resolve(listener(event))));
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+    }
+}
+exports.LocalBus = LocalBus;
+//# sourceMappingURL=change-bus.js.map

package/dist/cache/change-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-bus.js","sourceRoot":"","sources":["../../src/cache/change-bus.ts"],"names":[],"mappings":";;;AAYA,MAAa,QAAQ;IACH,SAAS,GAAG,IAAI,GAAG,EAEjC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,KAAkB;QAC/B,MAAM,OAAO,CAAC,GAAG,CAChB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACpC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAChC,CACD,CAAC;IACH,CAAC;IAED,SAAS,CAAC,QAAsD;QAC/D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;CACD;AAhBD,4BAgBC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,27 @@
+export type ErrorCode = 'NOT_FOUND' | 'SCOPE' | 'REQUIRED' | 'VALUE' | 'CONFLICT' | 'CORRUPT' | 'CYCLE';
+export declare class ConfTreeError extends Error {
+    readonly code: ErrorCode;
+    constructor(message: string, code: ErrorCode);
+}
+export declare class NotFoundError extends ConfTreeError {
+    constructor(key: string);
+}
+export declare class ScopeError extends ConfTreeError {
+    constructor(key: string, scopeKind: string);
+}
+export declare class RequiredError extends ConfTreeError {
+    constructor(key: string, scopeKind: string, scopeRefId: string | null);
+}
+export declare class ValueError extends ConfTreeError {
+    constructor(message: string);
+}
+export declare class ConflictError extends ConfTreeError {
+    constructor(key: string, scopeKind: string, scopeRefId: string | null);
+}
+export declare class CorruptError extends ConfTreeError {
+    constructor(valueId: string);
+}
+export declare class CycleError extends ConfTreeError {
+    constructor(id: string, newParentId: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAClB,WAAW,GACX,OAAO,GACP,UAAU,GACV,OAAO,GACP,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AAEX,qBAAa,aAAc,SAAQ,KAAK;aAGtB,IAAI,EAAE,SAAS;gBAD/B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,SAAS;CAMhC;AAED,qBAAa,aAAc,SAAQ,aAAa;gBACnC,GAAG,EAAE,MAAM;CAGvB;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAChC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAM1C;AAED,qBAAa,aAAc,SAAQ,aAAa;gBACnC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAOrE;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM;CAG3B;AAED,qBAAa,aAAc,SAAQ,aAAa;gBACnC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAOrE;AAED,qBAAa,YAAa,SAAQ,aAAa;gBAClC,OAAO,EAAE,MAAM;CAM3B;AAED,qBAAa,UAAW,SAAQ,aAAa;gBAChC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAM3C"}

package/dist/core/errors.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CycleError = exports.CorruptError = exports.ConflictError = exports.ValueError = exports.RequiredError = exports.ScopeError = exports.NotFoundError = exports.ConfTreeError = void 0;
+class ConfTreeError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = new.target.name;
+        Error.captureStackTrace?.(this, new.target);
+    }
+}
+exports.ConfTreeError = ConfTreeError;
+class NotFoundError extends ConfTreeError {
+    constructor(key) {
+        super(`Unknown setting definition: "${key}"`, 'NOT_FOUND');
+    }
+}
+exports.NotFoundError = NotFoundError;
+class ScopeError extends ConfTreeError {
+    constructor(key, scopeKind) {
+        super(`Setting "${key}" cannot be set or read at scope kind "${scopeKind}"`, 'SCOPE');
+    }
+}
+exports.ScopeError = ScopeError;
+class RequiredError extends ConfTreeError {
+    constructor(key, scopeKind, scopeRefId) {
+        super(`Required setting "${key}" has no resolvable value for scope ${scopeKind}:${scopeRefId ?? 'null'} ` +
+            `and no default is defined`, 'REQUIRED');
+    }
+}
+exports.RequiredError = RequiredError;
+class ValueError extends ConfTreeError {
+    constructor(message) {
+        super(message, 'VALUE');
+    }
+}
+exports.ValueError = ValueError;
+class ConflictError extends ConfTreeError {
+    constructor(key, scopeKind, scopeRefId) {
+        super(`Setting "${key}" at scope ${scopeKind}:${scopeRefId ?? 'null'} was modified concurrently. ` +
+            `Reload the current value and retry.`, 'CONFLICT');
+    }
+}
+exports.ConflictError = ConflictError;
+class CorruptError extends ConfTreeError {
+    constructor(valueId) {
+        super(`setting value row ${valueId} has no typed value set: data corruption`, 'CORRUPT');
+    }
+}
+exports.CorruptError = CorruptError;
+class CycleError extends ConfTreeError {
+    constructor(id, newParentId) {
+        super(`Cannot attach/move scope "${id}" under "${newParentId}": would create a cycle`, 'CYCLE');
+    }
+}
+exports.CycleError = CycleError;
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":";;;AASA,MAAa,aAAc,SAAQ,KAAK;IAGtB;IAFjB,YACC,OAAe,EACC,IAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAW;QAG/B,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;CACD;AATD,sCASC;AAED,MAAa,aAAc,SAAQ,aAAa;IAC/C,YAAY,GAAW;QACtB,KAAK,CAAC,gCAAgC,GAAG,GAAG,EAAE,WAAW,CAAC,CAAC;IAC5D,CAAC;CACD;AAJD,sCAIC;AAED,MAAa,UAAW,SAAQ,aAAa;IAC5C,YAAY,GAAW,EAAE,SAAiB;QACzC,KAAK,CACJ,YAAY,GAAG,0CAA0C,SAAS,GAAG,EACrE,OAAO,CACP,CAAC;IACH,CAAC;CACD;AAPD,gCAOC;AAED,MAAa,aAAc,SAAQ,aAAa;IAC/C,YAAY,GAAW,EAAE,SAAiB,EAAE,UAAyB;QACpE,KAAK,CACJ,qBAAqB,GAAG,uCAAuC,SAAS,IAAI,UAAU,IAAI,MAAM,GAAG;YAClG,2BAA2B,EAC5B,UAAU,CACV,CAAC;IACH,CAAC;CACD;AARD,sCAQC;AAED,MAAa,UAAW,SAAQ,aAAa;IAC5C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzB,CAAC;CACD;AAJD,gCAIC;AAED,MAAa,aAAc,SAAQ,aAAa;IAC/C,YAAY,GAAW,EAAE,SAAiB,EAAE,UAAyB;QACpE,KAAK,CACJ,YAAY,GAAG,cAAc,SAAS,IAAI,UAAU,IAAI,MAAM,8BAA8B;YAC3F,qCAAqC,EACtC,UAAU,CACV,CAAC;IACH,CAAC;CACD;AARD,sCAQC;AAED,MAAa,YAAa,SAAQ,aAAa;IAC9C,YAAY,OAAe;QAC1B,KAAK,CACJ,qBAAqB,OAAO,0CAA0C,EACtE,SAAS,CACT,CAAC;IACH,CAAC;CACD;AAPD,oCAOC;AAED,MAAa,UAAW,SAAQ,aAAa;IAC5C,YAAY,EAAU,EAAE,WAAmB;QAC1C,KAAK,CACJ,6BAA6B,EAAE,YAAY,WAAW,yBAAyB,EAC/E,OAAO,CACP,CAAC;IACH,CAAC;CACD;AAPD,gCAOC"}

package/dist/core/types.d.ts

@@ -0,0 +1,52 @@
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type Value = Date | JsonValue;
+export interface Scope {
+    kind: string;
+    refId: string | null;
+}
+export declare const DEFAULT_SCOPE: Scope;
+export type ValueType = 'BOOLEAN' | 'NUMERIC' | 'TEXT' | 'ENUM' | 'JSON' | 'DATE';
+export type Inherit = 'LOCKED' | 'INHERITABLE_OVERRIDABLE' | 'INDEPENDENT';
+export type Status = 'DRAFT' | 'STABLE' | 'DEPRECATED' | 'RETIRED';
+export interface DefRecord {
+    id: string;
+    key: string;
+    version: number;
+    label: string;
+    description: string | null;
+    type: ValueType;
+    options: string[];
+    min: number | null;
+    max: number | null;
+    scopes: string[];
+    inherit: Inherit;
+    required: boolean;
+    secret: boolean;
+    status: Status;
+    category: string | null;
+}
+export interface ValueRecord {
+    id: string;
+    definitionId: string;
+    scopeKind: string;
+    scopeRefId: string | null;
+    bool: boolean | null;
+    num: number | null;
+    text: string | null;
+    json: unknown;
+    jsonSet: boolean;
+    date: Date | null;
+    version: number;
+}
+export interface ScopeHierarchy {
+    chain(scopeRefId: string): Promise<string[]>;
+    descendants(scopeRefId: string): Promise<string[]>;
+    children(scopeRefId: string): Promise<string[]>;
+    parent(scopeRefId: string): Promise<string | null>;
+    attach(id: string, parentId: string | null): Promise<void>;
+    move(id: string, newParentId: string | null): Promise<void>;
+    detach(id: string): Promise<void>;
+}
+//# 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":"AAAA,MAAM,MAAM,SAAS,GAClB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEhC,MAAM,MAAM,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC;AAErC,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,EAAE,KAAwC,CAAC;AAErE,MAAM,MAAM,SAAS,GACpB,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,yBAAyB,GAAG,aAAa,CAAC;AAE3E,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC"}

package/dist/core/types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SCOPE = void 0;
+exports.DEFAULT_SCOPE = { kind: 'default', refId: null };
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":";;;AAea,QAAA,aAAa,GAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC"}

package/dist/engine/auditor.d.ts

@@ -0,0 +1,8 @@
+import type { Scope } from '../core/types';
+import type { AuditRecord, StorageReader } from '../storage/storage-port';
+export declare class Auditor {
+    private readonly storage;
+    constructor(storage: StorageReader);
+    history(key: string, scope?: Scope): Promise<AuditRecord[]>;
+}
+//# sourceMappingURL=auditor.d.ts.map

package/dist/engine/auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["../../src/engine/auditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE1E,qBAAa,OAAO;IACP,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,aAAa;IAE7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAUjE"}

package/dist/engine/auditor.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Auditor = void 0;
+const errors_1 = require("../core/errors");
+class Auditor {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async history(key, scope) {
+        const def = await this.storage.findAnyDef(key);
+        if (!def)
+            throw new errors_1.NotFoundError(key);
+        return this.storage.findAudit({
+            definitionId: def.id,
+            scopeKind: scope?.kind,
+            scopeRefId: scope?.refId,
+        });
+    }
+}
+exports.Auditor = Auditor;
+//# sourceMappingURL=auditor.js.map

package/dist/engine/auditor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.js","sourceRoot":"","sources":["../../src/engine/auditor.ts"],"names":[],"mappings":";;;AACA,2CAA+C;AAG/C,MAAa,OAAO;IACU;IAA7B,YAA6B,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAEvD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,KAAa;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,sBAAa,CAAC,GAAG,CAAC,CAAC;QAEvC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;YAC7B,YAAY,EAAE,GAAG,CAAC,EAAE;YACpB,SAAS,EAAE,KAAK,EAAE,IAAI;YACtB,UAAU,EAAE,KAAK,EAAE,KAAK;SACxB,CAAC,CAAC;IACJ,CAAC;CACD;AAbD,0BAaC"}

package/dist/engine/engine.d.ts

@@ -0,0 +1,25 @@
+import type { ChangeBus } from '../cache/change-bus';
+import type { CacheOptions } from '../cache/cache';
+import { Cache } from '../cache/cache';
+import { Resolver } from './resolver';
+import type { StorageAdapter } from '../storage/storage-port';
+import type { ScopeHierarchy } from '../core/types';
+import { Writer } from './writer';
+import { Auditor } from './auditor';
+export interface EngineOptions {
+    storage?: StorageAdapter;
+    hierarchy?: ScopeHierarchy;
+    bus?: ChangeBus;
+    cache?: CacheOptions | false;
+}
+export interface Engine {
+    storage: StorageAdapter;
+    hierarchy: ScopeHierarchy;
+    bus: ChangeBus;
+    cache: Cache;
+    resolver: Resolver;
+    writer: Writer;
+    auditor: Auditor;
+}
+export declare function createEngine(options?: EngineOptions): Engine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;CAC7B;AAED,MAAM,WAAW,MAAM;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,cAAc,CAAC;IAC1B,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAYhE"}

package/dist/engine/engine.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngine = createEngine;
+const change_bus_1 = require("../cache/change-bus");
+const cache_1 = require("../cache/cache");
+const hierarchy_cache_sync_1 = require("./hierarchy-cache-sync");
+const memory_storage_1 = require("../storage/memory-storage");
+const resolver_1 = require("./resolver");
+const scope_hierarchy_1 = require("../hierarchy/scope-hierarchy");
+const writer_1 = require("./writer");
+const auditor_1 = require("./auditor");
+function createEngine(options = {}) {
+    const storage = options.storage ?? new memory_storage_1.MemoryStorageAdapter();
+    const rawHierarchy = options.hierarchy ?? new scope_hierarchy_1.LocalScopeHierarchy();
+    const bus = options.bus ?? new change_bus_1.LocalBus();
+    const cacheOptions = options.cache === false ? { enabled: false } : (options.cache ?? {});
+    const cache = new cache_1.Cache(bus, cacheOptions, rawHierarchy);
+    const hierarchy = (0, hierarchy_cache_sync_1.withHierarchyInvalidation)(rawHierarchy, cache);
+    const resolver = new resolver_1.Resolver(storage, hierarchy, cache);
+    const writer = new writer_1.Writer(storage, bus);
+    const auditor = new auditor_1.Auditor(storage);
+    return { storage, hierarchy, bus, cache, resolver, writer, auditor };
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/engine/engine.ts"],"names":[],"mappings":";;AA8BA,oCAYC;AAzCD,oDAA+C;AAE/C,0CAAuC;AACvC,iEAAmE;AACnE,8DAAiE;AACjE,yCAAsC;AACtC,kEAAmE;AAGnE,qCAAkC;AAClC,uCAAoC;AAmBpC,SAAgB,YAAY,CAAC,UAAyB,EAAE;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,qCAAoB,EAAE,CAAC;IAC9D,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,qCAAmB,EAAE,CAAC;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,qBAAQ,EAAE,CAAC;IAC1C,MAAM,YAAY,GACjB,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,IAAI,aAAK,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAA,gDAAyB,EAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,mBAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACtE,CAAC"}

package/dist/engine/hierarchy-cache-sync.d.ts

@@ -0,0 +1,4 @@
+import type { Cache } from '../cache/cache';
+import type { ScopeHierarchy } from '../core/types';
+export declare function withHierarchyInvalidation(hierarchy: ScopeHierarchy, cache: Cache): ScopeHierarchy;
+//# sourceMappingURL=hierarchy-cache-sync.d.ts.map

package/dist/engine/hierarchy-cache-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy-cache-sync.d.ts","sourceRoot":"","sources":["../../src/engine/hierarchy-cache-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,cAAc,EACzB,KAAK,EAAE,KAAK,GACV,cAAc,CAqBhB"}

package/dist/engine/hierarchy-cache-sync.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withHierarchyInvalidation = withHierarchyInvalidation;
+function withHierarchyInvalidation(hierarchy, cache) {
+    return {
+        chain: (id) => hierarchy.chain(id),
+        descendants: (id) => hierarchy.descendants(id),
+        children: (id) => hierarchy.children(id),
+        parent: (id) => hierarchy.parent(id),
+        attach: async (id, parentId) => {
+            await hierarchy.attach(id, parentId);
+            cache.dropForScopes(await hierarchy.descendants(id));
+        },
+        move: async (id, newParentId) => {
+            const descendants = await hierarchy.descendants(id);
+            await hierarchy.move(id, newParentId);
+            cache.dropForScopes(descendants);
+        },
+        detach: async (id) => {
+            const descendants = await hierarchy.descendants(id);
+            await hierarchy.detach(id);
+            cache.dropForScopes(descendants);
+        },
+    };
+}
+//# sourceMappingURL=hierarchy-cache-sync.js.map

package/dist/engine/hierarchy-cache-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy-cache-sync.js","sourceRoot":"","sources":["../../src/engine/hierarchy-cache-sync.ts"],"names":[],"mappings":";;AAGA,8DAwBC;AAxBD,SAAgB,yBAAyB,CACxC,SAAyB,EACzB,KAAY;IAEZ,OAAO;QACN,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE;YAC9B,MAAM,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YACrC,KAAK,CAAC,aAAa,CAAC,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE;YAC/B,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACpD,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YACtC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpB,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACpD,MAAM,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3B,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;KACD,CAAC;AACH,CAAC"}