conftree 0.1.0

package/dist/engine/resolver.d.ts

@@ -0,0 +1,24 @@
+import type { Scope, ScopeHierarchy, Value } from '../core/types';
+import type { StorageReader } from '../storage/storage-port';
+import type { Cache } from '../cache/cache';
+export interface ListAtPage {
+    entries: Record<string, Value>;
+    nextCursor: string | null;
+}
+export declare class Resolver {
+    private readonly storage;
+    private readonly hierarchy?;
+    private readonly cache?;
+    constructor(storage: StorageReader, hierarchy?: ScopeHierarchy | undefined, cache?: Cache | undefined);
+    get(key: string, scope: Scope, asOf?: Date): Promise<Value>;
+    listAt(scope: Scope, opts?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<ListAtPage>;
+    getMany(keys: string[], scope: Scope, asOf?: Date): Promise<Record<string, Value>>;
+    private resolveMissing;
+    private getDefs;
+    private checkScope;
+    private unwrap;
+}
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/engine/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,KAAK,EACL,cAAc,EACd,KAAK,EAEL,MAAM,eAAe,CAAC;AAQvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,QAAQ;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAFN,OAAO,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,cAAc,YAAA,EAC1B,KAAK,CAAC,EAAE,KAAK,YAAA;IAGzB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;IAK3D,MAAM,CACX,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5C,OAAO,CAAC,UAAU,CAAC;IAuBhB,OAAO,CACZ,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,KAAK,EACZ,IAAI,CAAC,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAwGnB,cAAc;YA8Bd,OAAO;IASrB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,MAAM;CAoBd"}

package/dist/engine/resolver.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Resolver = void 0;
+const types_1 = require("../core/types");
+const errors_1 = require("../core/errors");
+class Resolver {
+    storage;
+    hierarchy;
+    cache;
+    constructor(storage, hierarchy, cache) {
+        this.storage = storage;
+        this.hierarchy = hierarchy;
+        this.cache = cache;
+    }
+    async get(key, scope, asOf) {
+        const result = await this.getMany([key], scope, asOf);
+        return result[key];
+    }
+    async listAt(scope, opts = {}) {
+        const { values, nextCursor } = await this.storage.listValues({
+            scopeKind: scope.kind,
+            scopeRefId: scope.refId,
+            limit: opts.limit,
+            cursor: opts.cursor,
+        });
+        if (values.length === 0)
+            return { entries: {}, nextCursor };
+        const defs = await this.storage.findDefsByIds([
+            ...new Set(values.map((v) => v.definitionId)),
+        ]);
+        const defById = new Map(defs.map((d) => [d.id, d]));
+        const entries = {};
+        for (const row of values) {
+            const def = defById.get(row.definitionId);
+            if (!def)
+                continue;
+            entries[def.key] = this.unwrap(def, row);
+        }
+        return { entries, nextCursor };
+    }
+    async getMany(keys, scope, asOf) {
+        const uniqueKeys = [...new Set(keys)];
+        const result = {};
+        const uncached = [];
+        if (asOf === undefined) {
+            for (const key of uniqueKeys) {
+                const cached = this.cache?.get(key, scope);
+                if (cached !== undefined)
+                    result[key] = cached;
+                else
+                    uncached.push(key);
+            }
+        }
+        else {
+            uncached.push(...uniqueKeys);
+        }
+        if (uncached.length === 0)
+            return result;
+        const defByKey = await this.getDefs(uncached);
+        for (const key of uncached) {
+            this.checkScope(defByKey.get(key), scope);
+        }
+        const exactDefs = [];
+        const chainDefs = [];
+        for (const key of uncached) {
+            const def = defByKey.get(key);
+            const climbsHierarchy = def.inherit !== 'INDEPENDENT' &&
+                scope.refId !== null &&
+                this.hierarchy;
+            (climbsHierarchy ? chainDefs : exactDefs).push(def);
+        }
+        const chain = chainDefs.length > 0 && scope.refId !== null && this.hierarchy
+            ? await this.hierarchy.chain(scope.refId)
+            : [];
+        const [exactRows, chainRows] = await Promise.all([
+            exactDefs.length > 0
+                ? this.storage.findValues({
+                    definitionIds: exactDefs.map((d) => d.id),
+                    scopeKind: scope.kind,
+                    scopeRefId: scope.refId,
+                    asOf,
+                })
+                : Promise.resolve([]),
+            chainDefs.length > 0 && chain.length > 0
+                ? this.storage.findChainValues({
+                    definitionIds: chainDefs.map((d) => d.id),
+                    chain,
+                    asOf,
+                })
+                : Promise.resolve([]),
+        ]);
+        const exactByDef = new Map(exactRows.map((r) => [r.definitionId, r]));
+        const chainByDef = new Map();
+        for (const row of chainRows) {
+            const list = chainByDef.get(row.definitionId) ?? [];
+            list.push(row);
+            chainByDef.set(row.definitionId, list);
+        }
+        const chainDefIds = new Set(chainDefs.map((d) => d.id));
+        const missing = [];
+        for (const key of uncached) {
+            const def = defByKey.get(key);
+            let row;
+            if (chainDefIds.has(def.id)) {
+                const byRef = new Map((chainByDef.get(def.id) ?? []).map((v) => [
+                    v.scopeRefId,
+                    v,
+                ]));
+                for (const ref of chain) {
+                    row = byRef.get(ref);
+                    if (row)
+                        break;
+                }
+            }
+            else {
+                row = exactByDef.get(def.id);
+            }
+            if (row) {
+                result[key] = this.unwrap(def, row);
+                if (asOf === undefined)
+                    this.cache?.set(key, scope, result[key]);
+            }
+            else {
+                missing.push(def);
+            }
+        }
+        if (missing.length > 0)
+            await this.resolveMissing(missing, scope, uncached, defByKey, result, asOf);
+        return result;
+    }
+    async resolveMissing(missing, scope, keysInOrder, defByKey, result, asOf) {
+        const defaultRows = await this.storage.findValues({
+            definitionIds: missing.map((d) => d.id),
+            scopeKind: types_1.DEFAULT_SCOPE.kind,
+            scopeRefId: types_1.DEFAULT_SCOPE.refId,
+        });
+        const defaultByDef = new Map(defaultRows.map((r) => [r.definitionId, r]));
+        const missingIds = new Set(missing.map((d) => d.id));
+        for (const key of keysInOrder) {
+            const def = defByKey.get(key);
+            if (!missingIds.has(def.id))
+                continue;
+            const row = defaultByDef.get(def.id);
+            if (!row) {
+                throw new errors_1.RequiredError(def.key, scope.kind, scope.refId);
+            }
+            result[key] = this.unwrap(def, row);
+            if (asOf === undefined)
+                this.cache?.set(key, scope, result[key]);
+        }
+    }
+    async getDefs(keys) {
+        const defs = await this.storage.findDefs(keys);
+        const byKey = new Map(defs.map((d) => [d.key, d]));
+        for (const key of keys) {
+            if (!byKey.has(key))
+                throw new errors_1.NotFoundError(key);
+        }
+        return byKey;
+    }
+    checkScope(def, scope) {
+        if (scope.kind === 'default')
+            return;
+        if (!def.scopes.includes(scope.kind)) {
+            throw new errors_1.ScopeError(def.key, scope.kind);
+        }
+    }
+    unwrap(def, row) {
+        switch (def.type) {
+            case 'BOOLEAN':
+                if (row.bool === null)
+                    throw new errors_1.CorruptError(row.id);
+                return row.bool;
+            case 'NUMERIC':
+                if (row.num === null)
+                    throw new errors_1.CorruptError(row.id);
+                return row.num;
+            case 'TEXT':
+            case 'ENUM':
+                if (row.text === null)
+                    throw new errors_1.CorruptError(row.id);
+                return row.text;
+            case 'JSON':
+                if (!row.jsonSet)
+                    throw new errors_1.CorruptError(row.id);
+                return row.json;
+            case 'DATE':
+                if (row.date === null)
+                    throw new errors_1.CorruptError(row.id);
+                return row.date;
+        }
+    }
+}
+exports.Resolver = Resolver;
+//# sourceMappingURL=resolver.js.map

package/dist/engine/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/engine/resolver.ts"],"names":[],"mappings":"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"}

package/dist/engine/writer.d.ts

@@ -0,0 +1,32 @@
+import type { Scope, Value, ValueRecord } from '../core/types';
+import type { StorageAdapter } from '../storage/storage-port';
+import type { ChangeBus } from '../cache/change-bus';
+export interface SetParams {
+    key: string;
+    scope: Scope;
+    value: Value;
+    expectedVersion?: number;
+    authorId: string;
+    reason?: string;
+}
+export interface UnsetParams {
+    key: string;
+    scope: Scope;
+    expectedVersion?: number;
+    authorId: string;
+    reason?: string;
+}
+export declare class Writer {
+    private readonly storage;
+    private readonly bus?;
+    constructor(storage: StorageAdapter, bus?: ChangeBus | undefined);
+    set(params: SetParams): Promise<ValueRecord>;
+    setMany(paramsList: SetParams[]): Promise<ValueRecord[]>;
+    private setInTx;
+    unset(params: UnsetParams): Promise<void>;
+    private unsetInTx;
+    private emit;
+    private validate;
+    private snapshotOf;
+}
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/engine/writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO1E,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,qBAAa,MAAM;IAEjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBADJ,OAAO,EAAE,cAAc,EACvB,GAAG,CAAC,EAAE,SAAS,YAAA;IAG3B,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ5C,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAchD,OAAO;IA8Df,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAOjC,SAAS;YA8CT,IAAI;IASlB,OAAO,CAAC,QAAQ;IA4DhB,OAAO,CAAC,UAAU;CAoBlB"}

package/dist/engine/writer.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Writer = void 0;
+const errors_1 = require("../core/errors");
+const REDACTED = '[redacted]';
+class Writer {
+    storage;
+    bus;
+    constructor(storage, bus) {
+        this.storage = storage;
+        this.bus = bus;
+    }
+    async set(params) {
+        const created = await this.storage.transact((tx) => this.setInTx(tx, params));
+        await this.emit(created, params.key);
+        return created;
+    }
+    async setMany(paramsList) {
+        const created = await this.storage.transact(async (tx) => {
+            const results = [];
+            for (const params of paramsList) {
+                results.push(await this.setInTx(tx, params));
+            }
+            return results;
+        });
+        await Promise.all(created.map((row, i) => this.emit(row, paramsList[i].key)));
+        return created;
+    }
+    async setInTx(tx, params) {
+        const def = await tx.findDef(params.key);
+        if (!def)
+            throw new errors_1.NotFoundError(params.key);
+        if (params.scope.kind !== 'default' &&
+            !def.scopes.includes(params.scope.kind)) {
+            throw new errors_1.ScopeError(def.key, params.scope.kind);
+        }
+        this.validate(def, params.value);
+        const current = await tx.findValue(def.id, params.scope.kind, params.scope.refId);
+        const currentVersion = current?.version ?? 0;
+        const expected = params.expectedVersion ?? 0;
+        if (currentVersion !== expected) {
+            throw new errors_1.ConflictError(def.key, params.scope.kind, params.scope.refId);
+        }
+        if (current) {
+            await tx.closeValue(current.id);
+        }
+        const created = await tx.createValue({
+            definitionId: def.id,
+            scopeKind: params.scope.kind,
+            scopeRefId: params.scope.refId,
+            version: currentVersion + 1,
+            authorId: params.authorId,
+            reason: params.reason,
+            type: def.type,
+            value: params.value,
+        });
+        await tx.createAudit({
+            valueId: created.id,
+            definitionId: def.id,
+            scopeKind: created.scopeKind,
+            scopeRefId: created.scopeRefId,
+            action: current ? 'superseded' : 'created',
+            authorId: params.authorId,
+            before: current ? this.snapshotOf(def, current) : undefined,
+            after: this.snapshotOf(def, created),
+            reason: params.reason,
+        });
+        return created;
+    }
+    async unset(params) {
+        const closed = await this.storage.transact((tx) => this.unsetInTx(tx, params));
+        if (closed)
+            await this.emit(closed, params.key);
+    }
+    async unsetInTx(tx, params) {
+        const def = await tx.findDef(params.key);
+        if (!def)
+            throw new errors_1.NotFoundError(params.key);
+        if (params.scope.kind !== 'default' &&
+            !def.scopes.includes(params.scope.kind)) {
+            throw new errors_1.ScopeError(def.key, params.scope.kind);
+        }
+        const current = await tx.findValue(def.id, params.scope.kind, params.scope.refId);
+        const currentVersion = current?.version ?? 0;
+        const expected = params.expectedVersion ?? 0;
+        if (currentVersion !== expected) {
+            throw new errors_1.ConflictError(def.key, params.scope.kind, params.scope.refId);
+        }
+        if (!current)
+            return null;
+        await tx.closeValue(current.id);
+        await tx.createAudit({
+            valueId: current.id,
+            definitionId: def.id,
+            scopeKind: current.scopeKind,
+            scopeRefId: current.scopeRefId,
+            action: 'unset',
+            authorId: params.authorId,
+            before: this.snapshotOf(def, current),
+            reason: params.reason,
+        });
+        return current;
+    }
+    async emit(created, key) {
+        await this.bus?.publish({
+            definitionId: created.definitionId,
+            key,
+            scopeKind: created.scopeKind,
+            scopeRefId: created.scopeRefId,
+        });
+    }
+    validate(def, value) {
+        switch (def.type) {
+            case 'BOOLEAN':
+                if (typeof value !== 'boolean') {
+                    throw new errors_1.ValueError(`Setting "${def.key}" expects a boolean`);
+                }
+                break;
+            case 'NUMERIC': {
+                if (typeof value !== 'number' || !Number.isFinite(value)) {
+                    throw new errors_1.ValueError(`Setting "${def.key}" expects a finite number`);
+                }
+                if (def.min !== null && value < def.min) {
+                    throw new errors_1.ValueError(`Setting "${def.key}" must be >= ${def.min}, got ${value}`);
+                }
+                if (def.max !== null && value > def.max) {
+                    throw new errors_1.ValueError(`Setting "${def.key}" must be <= ${def.max}, got ${value}`);
+                }
+                break;
+            }
+            case 'TEXT':
+                if (typeof value !== 'string') {
+                    throw new errors_1.ValueError(`Setting "${def.key}" expects a string`);
+                }
+                break;
+            case 'ENUM':
+                if (typeof value !== 'string' || !def.options.includes(value)) {
+                    throw new errors_1.ValueError(`Setting "${def.key}" must be one of: ${def.options.join(', ')}`);
+                }
+                break;
+            case 'JSON':
+                try {
+                    JSON.stringify(value);
+                }
+                catch {
+                    throw new errors_1.ValueError(`Setting "${def.key}" expects a JSON-serializable value`);
+                }
+                break;
+            case 'DATE':
+                if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
+                    throw new errors_1.ValueError(`Setting "${def.key}" expects a valid Date`);
+                }
+                break;
+        }
+    }
+    snapshotOf(def, row) {
+        if (def.secret) {
+            return {
+                scopeKind: row.scopeKind,
+                scopeRefId: row.scopeRefId,
+                version: row.version,
+                value: REDACTED,
+            };
+        }
+        return {
+            scopeKind: row.scopeKind,
+            scopeRefId: row.scopeRefId,
+            version: row.version,
+            bool: row.bool,
+            num: row.num,
+            text: row.text,
+            json: row.jsonSet ? row.json : undefined,
+            date: row.date,
+        };
+    }
+}
+exports.Writer = Writer;
+//# sourceMappingURL=writer.js.map

package/dist/engine/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/engine/writer.ts"],"names":[],"mappings":"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"}

package/dist/hierarchy/scope-hierarchy.d.ts

@@ -0,0 +1,15 @@
+import type { ScopeHierarchy } from '../core/types';
+export declare class LocalScopeHierarchy implements ScopeHierarchy {
+    private readonly parentOf;
+    private readonly childrenOf;
+    chain(id: string): Promise<string[]>;
+    descendants(id: string): Promise<string[]>;
+    children(id: string): Promise<string[]>;
+    parent(id: 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>;
+    private addChild;
+    private assertNoCycle;
+}
+//# sourceMappingURL=scope-hierarchy.d.ts.map

package/dist/hierarchy/scope-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-hierarchy.d.ts","sourceRoot":"","sources":["../../src/hierarchy/scope-hierarchy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,qBAAa,mBAAoB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAEvD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAapC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe1C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI1C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,OAAO,CAAC,QAAQ;YAMF,aAAa;CAW3B"}

package/dist/hierarchy/scope-hierarchy.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalScopeHierarchy = void 0;
+const errors_1 = require("../core/errors");
+class LocalScopeHierarchy {
+    parentOf = new Map();
+    childrenOf = new Map();
+    async chain(id) {
+        const result = [];
+        const seen = new Set();
+        let current = id;
+        while (current !== null) {
+            if (seen.has(current))
+                break;
+            seen.add(current);
+            result.push(current);
+            current = this.parentOf.get(current) ?? null;
+        }
+        return result;
+    }
+    async descendants(id) {
+        const result = [];
+        const stack = [id];
+        const seen = new Set();
+        while (stack.length > 0) {
+            const current = stack.pop();
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+            result.push(current);
+            const kids = this.childrenOf.get(current);
+            if (kids)
+                stack.push(...kids);
+        }
+        return result;
+    }
+    async children(id) {
+        return [...(this.childrenOf.get(id) ?? [])];
+    }
+    async parent(id) {
+        return this.parentOf.get(id) ?? null;
+    }
+    async attach(id, parentId) {
+        if (parentId !== null)
+            await this.assertNoCycle(id, parentId);
+        this.parentOf.set(id, parentId);
+        if (parentId !== null)
+            this.addChild(parentId, id);
+        if (!this.childrenOf.has(id))
+            this.childrenOf.set(id, new Set());
+    }
+    async move(id, newParentId) {
+        if (newParentId !== null)
+            await this.assertNoCycle(id, newParentId);
+        const oldParent = this.parentOf.get(id) ?? null;
+        if (oldParent !== null)
+            this.childrenOf.get(oldParent)?.delete(id);
+        this.parentOf.set(id, newParentId);
+        if (newParentId !== null)
+            this.addChild(newParentId, id);
+    }
+    async detach(id) {
+        const parentId = this.parentOf.get(id) ?? null;
+        const kids = [...(this.childrenOf.get(id) ?? [])];
+        for (const kid of kids) {
+            await this.move(kid, parentId);
+        }
+        if (parentId !== null)
+            this.childrenOf.get(parentId)?.delete(id);
+        this.parentOf.delete(id);
+        this.childrenOf.delete(id);
+    }
+    addChild(parentId, id) {
+        if (!this.childrenOf.has(parentId))
+            this.childrenOf.set(parentId, new Set());
+        this.childrenOf.get(parentId).add(id);
+    }
+    async assertNoCycle(id, newParentId) {
+        if (id === newParentId ||
+            (await this.chain(newParentId)).includes(id)) {
+            throw new errors_1.CycleError(id, newParentId);
+        }
+    }
+}
+exports.LocalScopeHierarchy = LocalScopeHierarchy;
+//# sourceMappingURL=scope-hierarchy.js.map

package/dist/hierarchy/scope-hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-hierarchy.js","sourceRoot":"","sources":["../../src/hierarchy/scope-hierarchy.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './core/types';
+export * from './core/errors';
+export * from './cache/change-bus';
+export * from './cache/cache';
+export * from './hierarchy/scope-hierarchy';
+export * from './storage/storage-port';
+export * from './storage/memory-storage';
+export * from './engine/resolver';
+export * from './engine/writer';
+export * from './engine/auditor';
+export * from './engine/hierarchy-cache-sync';
+export * from './engine/engine';
+export * from './typed/registry';
+export * from './typed/typed-resolver';
+export * from './typed/typed-writer';
+export * from './typed/typed-auditor';
+export * from './typed/typed-engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./core/types"), exports);
+__exportStar(require("./core/errors"), exports);
+__exportStar(require("./cache/change-bus"), exports);
+__exportStar(require("./cache/cache"), exports);
+__exportStar(require("./hierarchy/scope-hierarchy"), exports);
+__exportStar(require("./storage/storage-port"), exports);
+__exportStar(require("./storage/memory-storage"), exports);
+__exportStar(require("./engine/resolver"), exports);
+__exportStar(require("./engine/writer"), exports);
+__exportStar(require("./engine/auditor"), exports);
+__exportStar(require("./engine/hierarchy-cache-sync"), exports);
+__exportStar(require("./engine/engine"), exports);
+__exportStar(require("./typed/registry"), exports);
+__exportStar(require("./typed/typed-resolver"), exports);
+__exportStar(require("./typed/typed-writer"), exports);
+__exportStar(require("./typed/typed-auditor"), exports);
+__exportStar(require("./typed/typed-engine"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,gDAA8B;AAC9B,qDAAmC;AACnC,gDAA8B;AAC9B,8DAA4C;AAC5C,yDAAuC;AACvC,2DAAyC;AACzC,oDAAkC;AAClC,kDAAgC;AAChC,mDAAiC;AACjC,gEAA8C;AAC9C,kDAAgC;AAChC,mDAAiC;AACjC,yDAAuC;AACvC,uDAAqC;AACrC,wDAAsC;AACtC,uDAAqC"}