@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/infra/harness-state.js

@@ -0,0 +1,101 @@
+// Stores harness ownership metadata atomically and rejects foreign files.
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import * as z from 'zod';
+import { busyError, DevkitError } from '../domain/errors.js';
+import { assertWorkspaceName } from '../domain/workspace/name.js';
+import { writeAtomicFile } from './atomic-file.js';
+import { assertStoreParents } from './store-parents.js';
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+const id = z.string().regex(/^[A-Za-z0-9_-]+$/);
+const relative = z
+    .string()
+    .refine((value) => !/[\\\x00-\x1f:]/.test(value) &&
+    value.split('/').every((part) => !!part && part !== '.' && part !== '..' && part !== '.git'));
+const receipt = {
+    key: id,
+    kind: z.enum(['mcp', 'rules']),
+    relative,
+    protocol: id,
+    name: id,
+    agents: z.array(id),
+    digest,
+    created: z.boolean(),
+};
+const consistentIntent = (value) => !value.receipt || (value.receipt.key === value.key && value.receipt.relative === value.relative);
+const uniqueKeys = (value) => new Set(value.receipts.map((item) => item.key)).size === value.receipts.length;
+const intent = (object) => object({
+    key: id,
+    relative,
+    before: digest.nullable(),
+    after: digest.nullable(),
+    receipt: object(receipt).nullable(),
+}).refine(consistentIntent);
+const state = (object) => object({
+    owner: z.literal('fx:harness:v1'),
+    root: z.string().min(1),
+    receipts: z.array(object(receipt)),
+    pending: intent(object).nullable(),
+}).refine(uniqueKeys);
+const written = state(z.strictObject);
+const read = state(z.object);
+export class FileHarnessState {
+    home;
+    lock;
+    constructor(home, lock) {
+        this.home = home;
+        this.lock = lock;
+    }
+    async read(workspace) {
+        return this.readFile(this.file(workspace));
+    }
+    async write(workspace, state) {
+        const file = this.file(workspace);
+        let text;
+        try {
+            text = JSON.stringify(written.parse({ owner: 'fx:harness:v1', ...state }));
+        }
+        catch {
+            throw invalid();
+        }
+        await assertStoreParents(this.home, file, invalid);
+        const lease = await this.lock.acquire({ key: `harness-state:${workspace}`, waitMs: 2000 });
+        if (!lease)
+            throw busyError('LOCK_BUSY', 'The harness metadata');
+        try {
+            await this.readFile(file);
+            await fs.mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+            await assertStoreParents(this.home, file, invalid);
+            await writeAtomicFile(file, text, { durable: true });
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    async readFile(file) {
+        await assertStoreParents(this.home, file, invalid);
+        try {
+            const stat = await fs.lstat(file);
+            if (!stat.isFile() || stat.nlink !== 1)
+                throw invalid();
+            const { owner: _owner, ...state } = read.parse(JSON.parse(await fs.readFile(file, 'utf8')));
+            return state;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw invalid();
+        }
+    }
+    file(workspace) {
+        assertWorkspaceName(workspace);
+        return path.join(this.home, 'workspaces', workspace, 'harness.json');
+    }
+}
+function invalid() {
+    return new DevkitError('config', 'HARNESS_STATE_INVALID', 'Harness ownership metadata is invalid or foreign', {
+        nextSteps: ['Inspect the workspace harness metadata before retrying.', 'fx doctor'],
+        hint: 'Do not delete ownership evidence to force replacement of existing native configuration.',
+    });
+}
+//# sourceMappingURL=harness-state.js.map

package/dist/infra/harness-state.js.map

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

package/dist/infra/home.js

@@ -0,0 +1,16 @@
+// Where the personal directory is. One function, so a test or the e2e harness
+// relocates the whole of ~/.fx through FX_HOME.
+import os from 'node:os';
+import path from 'node:path';
+import { DevkitError } from '../domain/errors.js';
+import { windowsPathProblem } from '../domain/path.js';
+export function fxHome(env) {
+    const home = env['FX_HOME'] ?? path.join(os.homedir(), '.fx');
+    const problem = process.platform === 'win32' ? windowsPathProblem(path.resolve(home)) : undefined;
+    if (problem)
+        throw new DevkitError('config', 'FX_HOME_INVALID', problem, {
+            nextSteps: [`Point FX_HOME at a directory Windows can address instead of ${home}.`],
+        });
+    return home;
+}
+//# sourceMappingURL=home.js.map

package/dist/infra/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/infra/home.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gDAAgD;AAEhD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,UAAU,MAAM,CAAC,GAAsB;IAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,IAAI,OAAO;QACT,MAAM,IAAI,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE;YAC1D,SAAS,EAAE,CAAC,+DAA+D,IAAI,GAAG,CAAC;SACpF,CAAC,CAAC;IACL,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/infra/hook-state.js

@@ -0,0 +1,62 @@
+// Hook metadata contains only ownership and bounded, dated status fields.
+// Corruption is explicit: losing ownership cannot authorize replacing a file.
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import * as z from 'zod';
+import { DevkitError } from '../domain/errors.js';
+import { writeAtomicFile } from './atomic-file.js';
+const receipt = {
+    agent: z.string(),
+    relative: z.string(),
+    owner: z.string(),
+    created: z.boolean(),
+};
+const observation = {
+    checkedAt: z.number(),
+    phase: z.string(),
+    code: z.string(),
+    command: z.string().nullable(),
+    detail: z.string().optional(),
+};
+const state = {
+    root: z.string(),
+    receipts: z.array(z.strictObject(receipt)),
+    lastAttempt: z.number().nullable(),
+    lastRefresh: z.number().nullable(),
+    observations: z.array(z.strictObject(observation)),
+};
+const written = z.strictObject(state);
+const read = z.object({
+    ...state,
+    receipts: z.array(z.object(receipt)),
+    observations: z.array(z.object(observation)),
+});
+export class FileHookState {
+    home;
+    constructor(home) {
+        this.home = home;
+    }
+    async read(workspace) {
+        try {
+            return read.parse(JSON.parse(await fs.readFile(this.file(workspace), 'utf8')));
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return null;
+            throw new DevkitError('config', 'HOOK_STATE_INVALID', `Hook metadata could not be read: ${this.file(workspace)}`, {
+                hint: 'Inspect the workspace hook metadata before retrying.',
+                nextSteps: ['fx self info', 'Repair the hook metadata file, then run fx hook list.'],
+                cause: err,
+            });
+        }
+    }
+    async write(workspace, state) {
+        const file = this.file(workspace);
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        await writeAtomicFile(file, JSON.stringify(written.parse(state)));
+    }
+    file(workspace) {
+        return path.join(this.home, 'workspaces', encodeURIComponent(workspace), 'hooks.json');
+    }
+}
+//# sourceMappingURL=hook-state.js.map

package/dist/infra/hook-state.js.map

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

package/dist/infra/local-store.js

@@ -0,0 +1,57 @@
+// Persist personal workspace layers using the manifest codec and a workspace lease.
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { stringify } from 'yaml';
+import { busyError } from '../domain/errors.js';
+import { loadLocal } from '../domain/manifest/loader.js';
+import { writeAtomicFile } from './atomic-file.js';
+import { FileLock } from './lock.js';
+import { localLayerPath } from './workspace-home.js';
+export class FileLocalLayerStore {
+    home;
+    constructor(home) {
+        this.home = home;
+    }
+    path(workspace) {
+        return localLayerPath(this.home, workspace);
+    }
+    async read(workspace) {
+        let raw;
+        try {
+            raw = await fs.readFile(this.path(workspace), 'utf8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return {};
+            throw err;
+        }
+        return loadLocal(raw).doc;
+    }
+    async write(workspace, next) {
+        await this.persist(workspace, async () => next);
+    }
+    async update(workspace, change) {
+        return this.persist(workspace, async () => change(await this.read(workspace)));
+    }
+    async persist(workspace, change) {
+        const file = this.path(workspace);
+        const lease = await new FileLock(this.home).acquire({
+            key: `local:${workspace}`,
+            waitMs: 5000,
+        });
+        if (lease === null)
+            throw busyError('WORKSPACE_BUSY', `The personal layer for ${workspace}`, {
+                nextSteps: ['Retry the selection change.'],
+            });
+        try {
+            const next = await change();
+            await fs.mkdir(path.dirname(file), { recursive: true });
+            await writeAtomicFile(file, stringify(next));
+            return next;
+        }
+        finally {
+            await lease.release();
+        }
+    }
+}
+//# sourceMappingURL=local-store.js.map

package/dist/infra/local-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-store.js","sourceRoot":"","sources":["../../src/infra/local-store.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,IAAI,CAAC,SAAiB;QACpB,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAChE,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,IAAgB;QAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,MAAiE;QAEjE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,MAAiC;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;YAClD,GAAG,EAAE,SAAS,SAAS,EAAE;YACzB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,IAAI;YAChB,MAAM,SAAS,CAAC,gBAAgB,EAAE,0BAA0B,SAAS,EAAE,EAAE;gBACvE,SAAS,EAAE,CAAC,6BAA6B,CAAC;aAC3C,CAAC,CAAC;QACL,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE,CAAC;YAC5B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/infra/lock.js

@@ -0,0 +1,116 @@
+// Cross-process leases live under FX_HOME. Publishing a complete owner record
+// by exclusive hard link prevents a crash from leaving an ownerless lock.
+// Reapers themselves hold leases, so competing stale recoveries cannot remove
+// a newly acquired lock. Unreadable owners are conservatively left alone.
+import { createHash, randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { asDevkitError } from '../domain/errors.js';
+export class FileLock {
+    home;
+    constructor(home) {
+        this.home = home;
+    }
+    async acquire(input) {
+        const dir = path.join(this.home, 'locks');
+        const file = path.join(dir, createHash('sha256').update(input.key).digest('hex'));
+        try {
+            await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+            const until = performance.now() + Math.max(0, input.waitMs);
+            do {
+                const lease = await claim(file, 0);
+                if (lease !== null)
+                    return lease;
+                const remaining = until - performance.now();
+                if (remaining <= 0)
+                    return null;
+                await delay(Math.min(20, remaining));
+            } while (performance.now() <= until);
+            return null;
+        }
+        catch (err) {
+            throw asDevkitError(err);
+        }
+    }
+}
+async function claim(file, depth) {
+    const owner = { pid: process.pid, token: randomUUID() };
+    if (await publish(file, owner))
+        return leaseFor(file, owner);
+    if (depth >= 8)
+        return null;
+    const old = await readOwner(file);
+    if (old === undefined || isAlive(old.pid))
+        return null;
+    const reaper = await claim(`${file}.reaper`, depth + 1);
+    if (reaper === null)
+        return null;
+    try {
+        const current = await readOwner(file);
+        if (current?.token !== old.token || isAlive(current.pid))
+            return null;
+        await fs.unlink(file);
+        return (await publish(file, owner)) ? leaseFor(file, owner) : null;
+    }
+    finally {
+        await reaper.release();
+    }
+}
+async function publish(file, owner) {
+    const candidate = `${file}.${owner.token}.candidate`;
+    try {
+        await fs.writeFile(candidate, JSON.stringify(owner), { flag: 'wx', mode: 0o600 });
+        await fs.link(candidate, file);
+        return true;
+    }
+    catch (err) {
+        if (hasCode(err, 'EEXIST'))
+            return false;
+        throw asDevkitError(err);
+    }
+    finally {
+        await fs.rm(candidate, { force: true });
+    }
+}
+function leaseFor(file, owner) {
+    let released = false;
+    return {
+        async release() {
+            if (released)
+                return;
+            released = true;
+            if ((await readOwner(file))?.token === owner.token)
+                await fs.unlink(file);
+        },
+    };
+}
+async function readOwner(file) {
+    try {
+        const value = JSON.parse(await fs.readFile(file, 'utf8'));
+        if (typeof value !== 'object' || value === null)
+            return undefined;
+        const owner = value;
+        if (!Number.isSafeInteger(owner.pid) ||
+            (owner.pid ?? 0) <= 0 ||
+            typeof owner.token !== 'string')
+            return undefined;
+        return owner;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return !hasCode(err, 'ESRCH');
+    }
+}
+function hasCode(err, code) {
+    return typeof err === 'object' && err !== null && 'code' in err && err.code === code;
+}
+//# sourceMappingURL=lock.js.map

package/dist/infra/lock.js.map

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

package/dist/infra/projection-store.js

@@ -0,0 +1,135 @@
+// Managed projection writes use same-directory replacement after a locked
+// re-read. Symlinked ancestors are foreign, so a project entry cannot redirect
+// a write into an unrelated tree. No copy of a user's document enters FX_HOME.
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { asDevkitError } from '../domain/errors.js';
+import { isAtOrInside, pathKey, samePath } from '../domain/path.js';
+import { writeAtomicFile } from './atomic-file.js';
+export class FileProjectionStore {
+    lock;
+    constructor(lock) {
+        this.lock = lock;
+    }
+    async read(at) {
+        const file = path.resolve(at.root, at.relative);
+        if (!(await isSafe(at)))
+            return { kind: 'foreign', text: null };
+        try {
+            const stat = await fs.lstat(file);
+            if (!stat.isFile() || stat.nlink !== 1)
+                return { kind: 'foreign', text: null };
+            return { kind: 'file', text: await fs.readFile(file, 'utf8') };
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return { kind: 'absent', text: null };
+            throw asDevkitError(err);
+        }
+    }
+    async readLink(at) {
+        if (!(await isSafe(at)))
+            return { kind: 'unsafe', target: null };
+        try {
+            const file = path.resolve(at.root, at.relative);
+            const stat = await fs.lstat(file);
+            return stat.isSymbolicLink()
+                ? { kind: 'link', target: await fs.readlink(file) }
+                : { kind: 'foreign', target: null };
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return { kind: 'absent', target: null };
+            throw asDevkitError(err);
+        }
+    }
+    async writeLink(input) {
+        if (input.before.kind !== 'link')
+            return 'conflict';
+        const file = path.resolve(input.root, input.relative);
+        const lease = await this.lock.acquire({ key: `projection:${pathKey(file)}`, waitMs: 0 });
+        if (!lease)
+            return 'busy';
+        try {
+            const current = await this.readLink(input);
+            if (current.kind !== input.before.kind || current.target !== input.before.target)
+                return 'conflict';
+            if (current.target === input.target)
+                return 'unchanged';
+            if (input.target === null)
+                await fs.unlink(file);
+            else
+                await replaceLink(file, input.target);
+            return 'written';
+        }
+        catch (err) {
+            throw asDevkitError(err);
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    async write(input) {
+        if (input.before.kind === 'foreign')
+            return 'conflict';
+        if (input.before.text === input.text)
+            return 'unchanged';
+        const file = path.resolve(input.root, input.relative);
+        const lease = await this.lock.acquire({ key: `projection:${pathKey(file)}`, waitMs: 0 });
+        if (!lease)
+            return 'busy';
+        try {
+            const current = await this.read(input);
+            if (current.kind !== input.before.kind || current.text !== input.before.text)
+                return 'conflict';
+            if (input.text === null)
+                await fs.unlink(file);
+            else
+                await replace(file, input.text);
+            return 'written';
+        }
+        catch (err) {
+            throw asDevkitError(err);
+        }
+        finally {
+            await lease.release();
+        }
+    }
+}
+async function isSafe(at) {
+    const root = path.resolve(at.root);
+    const file = path.resolve(root, at.relative);
+    if (samePath(file, root) || !isAtOrInside(file, root))
+        return false;
+    let parent = path.dirname(file);
+    while (parent !== path.dirname(root)) {
+        try {
+            const stat = await fs.lstat(parent);
+            if (!stat.isDirectory() || stat.isSymbolicLink())
+                return false;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                return false;
+        }
+        parent = path.dirname(parent);
+    }
+    return true;
+}
+async function replace(file, text) {
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const mode = await fs.stat(file).then((stat) => stat.mode & 0o777, () => 0o600);
+    await writeAtomicFile(file, text, { mode });
+}
+async function replaceLink(file, target) {
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    try {
+        await fs.symlink(path.resolve(target), temporary, process.platform === 'win32' ? 'junction' : 'dir');
+        await fs.rename(temporary, file);
+    }
+    finally {
+        await fs.rm(temporary, { force: true });
+    }
+}
+//# sourceMappingURL=projection-store.js.map

package/dist/infra/projection-store.js.map

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

package/dist/infra/store-parents.js

@@ -0,0 +1,24 @@
+// Personal journals may create missing directories, but must not traverse a
+// foreign ancestor. The owning store supplies its public corruption error.
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { isAtOrInside, samePath } from '../domain/path.js';
+export async function assertStoreParents(home, file, invalid) {
+    const root = path.resolve(home);
+    const target = path.resolve(file);
+    if (samePath(target, root) || !isAtOrInside(target, root))
+        throw invalid();
+    for (let directory = path.dirname(target);; directory = path.dirname(directory)) {
+        try {
+            if (!(await fs.lstat(directory)).isDirectory())
+                throw invalid();
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw invalid();
+        }
+        if (samePath(directory, root))
+            return;
+    }
+}
+//# sourceMappingURL=store-parents.js.map

package/dist/infra/store-parents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-parents.js","sourceRoot":"","sources":["../../src/infra/store-parents.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2EAA2E;AAE3E,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,IAAY,EACZ,OAAoB;IAEpB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC;QAAE,MAAM,OAAO,EAAE,CAAC;IAC3E,KAAK,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACjF,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE;gBAAE,MAAM,OAAO,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,OAAO,EAAE,CAAC;QAC1E,CAAC;QACD,IAAI,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;YAAE,OAAO;IACxC,CAAC;AACH,CAAC"}

package/dist/infra/stored-shape.js

@@ -0,0 +1,3 @@
+// Require each persisted domain field to have a matching schema.
+export {};
+//# sourceMappingURL=stored-shape.js.map

package/dist/infra/stored-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-shape.js","sourceRoot":"","sources":["../../src/infra/stored-shape.ts"],"names":[],"mappings":"AAAA,iEAAiE"}