@iwonz/ywtc 0.0.0 → 2.0.0

package/dist/state.js

@@ -0,0 +1,201 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+function canonicalUrl(value) {
+    const url = new URL(value);
+    url.hash = '';
+    url.search = '';
+    url.pathname = url.pathname.replace(/\/+$/, '') || '/';
+    return url.toString().replace(/\/$/, '');
+}
+function canonicalIdentity(identity) {
+    const endpoint = (value) => value.provider === 'filesystem'
+        ? { provider: value.provider, path: path.resolve(value.path), format: value.format }
+        : {
+            profile: value.profile,
+            provider: value.provider,
+            instance: canonicalUrl(value.instance),
+            objectId: value.objectId,
+            ...(value.containerId ? { containerId: value.containerId } : {}),
+        };
+    return { schema: 'ywtc-state-v2', source: endpoint(identity.source), destination: endpoint(identity.destination) };
+}
+export function transferStateId(identity) {
+    return createHash('sha256').update(JSON.stringify(canonicalIdentity(identity))).digest('hex').slice(0, 24);
+}
+export function resolveStateLocation(identity, options = {}) {
+    const id = transferStateId(identity);
+    if (options.stateFilename !== undefined) {
+        const filename = options.stateFilename.trim();
+        if (!filename)
+            throw new Error('--state must be a non-empty JSON path. Omit it to use automatic state selection.');
+        const runtimeDirectory = path.dirname(filename);
+        return {
+            id,
+            mode: 'explicit',
+            filename,
+            runtimeDirectory,
+            cacheDirectory: path.join(runtimeDirectory, 'cache'),
+            reportsDirectory: path.join(runtimeDirectory, 'reports'),
+        };
+    }
+    const runtimeDirectory = options.runtimeDirectory ?? '.states';
+    return {
+        id,
+        mode: 'automatic',
+        filename: path.join(runtimeDirectory, `${id}.json`),
+        runtimeDirectory,
+        cacheDirectory: path.join(runtimeDirectory, 'cache'),
+        reportsDirectory: path.join(runtimeDirectory, 'reports'),
+    };
+}
+function emptyState(identity) {
+    const now = new Date().toISOString();
+    return { version: 2, identity, createdAt: now, updatedAt: now, pages: {}, graph: { edges: [] }, runs: [] };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function identityEquals(left, right) {
+    return JSON.stringify(canonicalIdentity(left)) === JSON.stringify(canonicalIdentity(right));
+}
+function help(filename) {
+    return `Restore a v2 backup, choose a matching --state file, omit --state for automatic selection, or use --fresh to preserve "${filename}" and start clean.`;
+}
+async function readState(filename) {
+    let content;
+    try {
+        content = await readFile(filename, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw new Error(`Cannot read transfer state "${filename}". ${help(filename)}`, { cause: error });
+    }
+    let value;
+    try {
+        value = JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Transfer state "${filename}" is not valid JSON. ${help(filename)}`, { cause: error });
+    }
+    if (isRecord(value) && value.version === 1) {
+        throw new Error(`Transfer state "${filename}" uses unsupported schema v1. It was preserved unchanged. Use a new workdir/state or --fresh; automatic conversion could duplicate remote content.`);
+    }
+    if (!isRecord(value) || value.version !== 2 || !isRecord(value.identity) || !isRecord(value.pages) || !isRecord(value.graph) || !Array.isArray(value.runs)) {
+        throw new Error(`Transfer state "${filename}" has an unsupported or incomplete schema. ${help(filename)}`);
+    }
+    return value;
+}
+function backupFilename(filename) {
+    return `${filename}.backup-${new Date().toISOString().replace(/[:.]/g, '-')}-${randomUUID().slice(0, 8)}`;
+}
+export class StateStore {
+    filename;
+    state;
+    saveChain = Promise.resolve();
+    readOnly = false;
+    info;
+    constructor(filename) {
+        this.filename = filename;
+    }
+    async load(identity, options = {}) {
+        this.readOnly = options.dryRun ?? false;
+        if (options.fresh) {
+            let preserved;
+            if (!this.readOnly) {
+                const backup = backupFilename(this.filename);
+                try {
+                    const selected = await stat(this.filename);
+                    if (!selected.isFile())
+                        throw new Error(`State path is not a regular file: ${this.filename}`);
+                    await rename(this.filename, backup);
+                    preserved = backup;
+                }
+                catch (error) {
+                    if (error.code !== 'ENOENT')
+                        throw error;
+                }
+            }
+            this.state = emptyState(identity);
+            this.info = { source: 'fresh', ...(preserved ? { backupFilename: preserved } : {}) };
+            return this.state;
+        }
+        const selected = await readState(this.filename);
+        if (selected) {
+            if (!identityEquals(selected.identity, identity)) {
+                throw new Error(`Transfer state "${this.filename}" belongs to another canonical source/destination pair. ${help(this.filename)}`);
+            }
+            for (const run of selected.runs) {
+                if (run.status === 'running') {
+                    run.status = 'interrupted';
+                    run.finishedAt = new Date().toISOString();
+                }
+            }
+            this.state = selected;
+            this.info = { source: 'existing' };
+            return selected;
+        }
+        this.state = emptyState(identity);
+        this.info = { source: 'new' };
+        return this.state;
+    }
+    get value() {
+        if (!this.state)
+            throw new Error('StateStore.load() must be called before accessing state');
+        return this.state;
+    }
+    get loadInfo() {
+        if (!this.info)
+            throw new Error('StateStore.load() must be called before accessing load information');
+        return this.info;
+    }
+    async beginRun(scope, dryRun) {
+        const run = {
+            id: randomUUID(),
+            startedAt: new Date().toISOString(),
+            status: 'running',
+            scope,
+            dryRun,
+            pages: 0,
+            warnings: 0,
+            errors: 0,
+        };
+        this.value.runs.push(run);
+        if (!dryRun)
+            await this.save();
+        return run;
+    }
+    async finishRun(runId, status, counts) {
+        const run = this.value.runs.find((candidate) => candidate.id === runId);
+        if (!run)
+            throw new Error(`State run ${runId} was not initialized`);
+        Object.assign(run, counts, { status, finishedAt: new Date().toISOString() });
+        if (!this.readOnly)
+            await this.save();
+    }
+    async setGraph(rootId, edges) {
+        this.value.graph = { rootId, edges };
+        if (!this.readOnly)
+            await this.save();
+    }
+    async setPage(page) {
+        this.value.pages[page.sourceCanonicalId] = page;
+        if (!this.readOnly)
+            await this.save();
+    }
+    async save() {
+        if (this.readOnly)
+            throw new Error(`Refusing to write transfer state "${this.filename}" during --dry-run.`);
+        const write = this.saveChain.catch(() => undefined).then(async () => {
+            this.value.updatedAt = new Date().toISOString();
+            const temporary = `${this.filename}.${process.pid}.${Date.now()}.${randomUUID().slice(0, 8)}.tmp`;
+            await mkdir(path.dirname(this.filename), { recursive: true, mode: 0o700 });
+            await writeFile(temporary, `${JSON.stringify(this.value, null, 2)}\n`, { mode: 0o600 });
+            await rename(temporary, this.filename);
+        });
+        this.saveChain = write;
+        await write;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,aAAa,CAAC;AACnD,OAAO,EAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC1E,OAAO,IAAI,MAAM,WAAW,CAAC;AAkG7B,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IACvD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,iBAAiB,CAAC,QAA0B;IACnD,MAAM,QAAQ,GAAG,CAAC,KAA2C,EAAW,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,YAAY;QACxG,CAAC,CAAC,EAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAC;QAClF,CAAC,CAAC;YACA,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAC,WAAW,EAAE,KAAK,CAAC,WAAW,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC;IACJ,OAAO,EAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAC,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA0B;IACxD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA0B,EAAE,UAA+D,EAAE;IAChI,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACnH,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,OAAO;YACL,EAAE;YACF,IAAI,EAAE,UAAU;YAChB,QAAQ;YACR,gBAAgB;YAChB,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;YACpD,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC;SACzD,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,SAAS,CAAC;IAC/D,OAAO;QACL,EAAE;QACF,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE,OAAO,CAAC;QACnD,gBAAgB;QAChB,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;QACpD,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,QAA0B;IAC5C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,EAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAC,KAAK,EAAE,EAAE,EAAC,EAAE,IAAI,EAAE,EAAE,EAAC,CAAC;AACzG,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,IAAsB,EAAE,KAAuB;IACrE,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,IAAI,CAAC,QAAgB;IAC5B,OAAO,0HAA0H,QAAQ,oBAAoB,CAAC;AAChK,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,QAAgB;IACvC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,wBAAwB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAC,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,oJAAoJ,CAAC,CAAC;IACnM,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3J,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,8CAA8C,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,KAAiC,CAAC;AAC3C,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,GAAG,QAAQ,WAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC5G,CAAC;AAED,MAAM,OAAO,UAAU;IAMO;IALpB,KAAK,CAAiB;IACtB,SAAS,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7C,QAAQ,GAAG,KAAK,CAAC;IACjB,IAAI,CAAiB;IAE7B,YAA4B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEhD,KAAK,CAAC,IAAI,CAAC,QAA0B,EAAE,UAA+C,EAAE;QACtF,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;QACxC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,SAA6B,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAC9F,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBACpC,SAAS,GAAG,MAAM,CAAC;gBACrB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;wBAAE,MAAM,KAAK,CAAC;gBACtE,CAAC;YACH,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI,GAAG,EAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,cAAc,EAAE,SAAS,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAC,CAAC;YACjF,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,QAAQ,2DAA2D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpI,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC7B,GAAG,CAAC,MAAM,GAAG,aAAa,CAAC;oBAC3B,GAAG,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC5C,CAAC;YACH,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC,IAAI,GAAG,EAAC,MAAM,EAAE,UAAU,EAAC,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,QAAQ;QACV,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACtG,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAwB,EAAE,MAAe;QACtD,MAAM,GAAG,GAAa;YACpB,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,SAAS;YACjB,KAAK;YACL,MAAM;YACN,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,CAAC;SACV,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,MAAiB,EAAE,MAAyD;QACzG,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;QACxE,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,sBAAsB,CAAC,CAAC;QACpE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAC,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,KAAuB;QACpD,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAuB;QACnC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,QAAQ,qBAAqB,CAAC,CAAC;QAC5G,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAClE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;YAClG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;YACzE,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAC,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;YACtF,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,MAAM,KAAK,CAAC;IACd,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,197 @@
+import type { Readable } from 'node:stream';
+export type YandexPageType = 'page' | 'grid' | 'wysiwyg' | 'template';
+export interface YandexBreadcrumb {
+    id?: number;
+    slug: string;
+    title: string;
+    page_exists?: boolean;
+}
+export interface YandexPageDetails {
+    id: number;
+    slug: string;
+    title: string;
+    page_type: YandexPageType;
+    content?: string;
+    breadcrumbs?: YandexBreadcrumb[];
+    redirect?: {
+        page_id: number;
+        redirect_target: {
+            id: number;
+            slug: string;
+            title: string;
+            page_type?: YandexPageType | null;
+        };
+    } | null;
+    attributes?: {
+        created_at?: string;
+        modified_at?: string;
+        lang?: string;
+        is_readonly?: boolean;
+        is_draft?: boolean;
+    };
+}
+export interface YandexPageIdentity {
+    id: number;
+    slug: string;
+}
+export interface YandexAttachment {
+    id: number;
+    name: string;
+    is_downloadable: boolean;
+    download_url: string;
+    size: string | number;
+    description?: string;
+    created_at?: string;
+    mimetype?: string;
+    has_preview?: boolean;
+    check_status?: string;
+}
+export interface YandexGridColumn {
+    id?: string;
+    slug: string;
+    title: string;
+    type?: string;
+    format?: 'yfm' | 'wom' | 'plain' | null;
+    width?: number;
+    width_units?: '%' | 'px' | null;
+}
+export interface YandexGridRow {
+    id: string;
+    row: unknown[];
+    pinned?: boolean;
+    color?: string;
+}
+export interface YandexGrid {
+    id: string | number;
+    title: string;
+    page?: YandexPageIdentity;
+    structure: {
+        columns: YandexGridColumn[];
+        default_sort?: unknown[];
+    };
+    rows: YandexGridRow[];
+    rich_text_format?: 'yfm' | 'wom' | 'plain';
+    revision?: string;
+}
+export interface YandexGridSummary {
+    id: string;
+    title: string;
+    created_at?: string;
+}
+export interface DownloadedFile {
+    path: string;
+    size: number;
+    sha256: string;
+    mimeType?: string;
+}
+export interface ConfluencePage {
+    id: string;
+    type: 'page';
+    status?: string;
+    title: string;
+    space: {
+        key: string;
+        id?: number | string;
+        name?: string;
+    };
+    ancestors?: Array<{
+        id: string;
+    }>;
+    version?: {
+        number: number;
+    };
+    body?: {
+        storage?: {
+            value: string;
+            representation: string;
+        };
+        view?: {
+            value: string;
+            representation: string;
+        };
+    };
+    operations?: Array<{
+        operation: string;
+        targetType: string;
+    }>;
+    _links?: {
+        webui?: string;
+        base?: string;
+        self?: string;
+    };
+}
+export interface ConfluenceAttachment {
+    id: string;
+    title: string;
+    metadata?: {
+        mediaType?: string;
+    };
+    extensions?: {
+        fileSize?: number;
+    };
+    _links?: {
+        download?: string;
+        webui?: string;
+    };
+}
+export interface ConfluencePlatformInfo {
+    deployment: 'data-center' | 'cloud';
+    product: string;
+    version?: string;
+    api: string;
+}
+export interface YandexWikiApi {
+    getPageBySlug(slug: string): Promise<YandexPageDetails>;
+    getPageById(id: number): Promise<YandexPageDetails>;
+    getDescendants(id: number): Promise<YandexPageIdentity[]>;
+    getAttachments(pageId: number): Promise<YandexAttachment[]>;
+    getPageGrids(pageId: number): Promise<YandexGridSummary[]>;
+    getGrid(id: string): Promise<YandexGrid>;
+    download(pageId: number, attachmentId: number, destination: string): Promise<DownloadedFile>;
+    createPage(input: {
+        slug: string;
+        title: string;
+        content: string;
+    }): Promise<YandexPageDetails>;
+    updatePage(input: {
+        id: number;
+        title: string;
+        content: string;
+    }): Promise<YandexPageDetails>;
+    uploadAttachment(input: {
+        pageId: number;
+        filename: string;
+        path: string;
+        size: number;
+    }): Promise<YandexAttachment>;
+}
+export interface ConfluenceApi {
+    preflight?(): Promise<ConfluencePlatformInfo>;
+    resolveTarget(input: string): Promise<ConfluencePage>;
+    getPage(id: string): Promise<ConfluencePage>;
+    findPageByTitle(spaceKey: string, title: string): Promise<ConfluencePage | undefined>;
+    createPage(input: {
+        spaceKey: string;
+        parentId: string;
+        title: string;
+        storage: string;
+    }): Promise<ConfluencePage>;
+    updatePage(input: {
+        pageId: string;
+        title: string;
+        storage: string;
+    }): Promise<ConfluencePage>;
+    findAttachment(pageId: string, filename: string): Promise<ConfluenceAttachment | undefined>;
+    uploadAttachment(input: {
+        pageId: string;
+        filename: string;
+        file: Readable;
+        contentLength?: number;
+        mimeType?: string;
+        existingAttachmentId?: string;
+    }): Promise<ConfluenceAttachment>;
+    listAttachments(pageId: string): Promise<ConfluenceAttachment[]>;
+    getDescendants(pageId: string): Promise<ConfluencePage[]>;
+    downloadAttachment(pageId: string, attachment: ConfluenceAttachment, destination: string): Promise<DownloadedFile>;
+    pageWebUrl(page: ConfluencePage): string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/updater.d.ts

@@ -0,0 +1,24 @@
+export type InstallationChannel = 'brew' | 'global-npm' | 'npx' | 'local' | 'source' | 'unknown';
+export interface UpdateResult {
+    current: string;
+    latest: string;
+    channel: InstallationChannel;
+    updateAvailable: boolean;
+    installed: boolean;
+    command: string;
+}
+export declare function detectInstallationChannel(options?: {
+    entrypoint?: string;
+    environment?: NodeJS.ProcessEnv;
+    packageRoot?: string;
+}): Promise<InstallationChannel>;
+export declare function latestPublishedVersion(fetchImplementation?: typeof fetch): Promise<string>;
+export declare function isNewerVersion(candidate: string, current: string): boolean;
+export declare function runUpdate(options: {
+    currentVersion: string;
+    install: boolean;
+    via?: 'npm' | 'brew';
+    channel?: InstallationChannel;
+    fetchLatest?: () => Promise<string>;
+    execute?: (command: string, args: string[]) => Promise<void>;
+}): Promise<UpdateResult>;

package/dist/updater.js

@@ -0,0 +1,92 @@
+import { spawn } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+async function pathExists(filename) {
+    try {
+        await access(filename);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectInstallationChannel(options = {}) {
+    const environment = options.environment ?? process.env;
+    const entrypoint = path.resolve(options.entrypoint ?? process.argv[1] ?? '');
+    const packageRoot = options.packageRoot ?? path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+    if (entrypoint.includes('/Cellar/ywtc/') || entrypoint.includes('/homebrew/'))
+        return 'brew';
+    if (environment.npm_command === 'exec' || entrypoint.includes('/_npx/'))
+        return 'npx';
+    if (await pathExists(path.join(packageRoot, '.git')))
+        return 'source';
+    if (entrypoint.includes(`${path.sep}node_modules${path.sep}.bin${path.sep}`))
+        return 'local';
+    const npmPrefix = environment.npm_config_prefix;
+    if (npmPrefix && entrypoint.startsWith(path.resolve(npmPrefix)))
+        return 'global-npm';
+    if (entrypoint.includes(`${path.sep}lib${path.sep}node_modules${path.sep}@iwonz${path.sep}ywtc${path.sep}`))
+        return 'global-npm';
+    return 'unknown';
+}
+export async function latestPublishedVersion(fetchImplementation = fetch) {
+    const response = await fetchImplementation('https://registry.npmjs.org/@iwonz%2Fywtc/latest', {
+        headers: { Accept: 'application/json' },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok)
+        throw new Error(`Cannot check npm for updates: HTTP ${response.status}`);
+    const payload = await response.json();
+    if (typeof payload.version !== 'string')
+        throw new Error('npm update response does not contain a version');
+    return payload.version;
+}
+function semverParts(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match)
+        return [0, 0, 0];
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+export function isNewerVersion(candidate, current) {
+    const left = semverParts(candidate);
+    const right = semverParts(current);
+    for (let index = 0; index < left.length; index += 1) {
+        if (left[index] !== right[index])
+            return (left[index] ?? 0) > (right[index] ?? 0);
+    }
+    return false;
+}
+function runProcess(command, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { shell: false, stdio: 'inherit' });
+        child.once('error', reject);
+        child.once('exit', (code, signal) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${command} ${args.join(' ')} failed with ${signal ? `signal ${signal}` : `exit code ${code}`}`));
+        });
+    });
+}
+export async function runUpdate(options) {
+    const channel = options.channel ?? await detectInstallationChannel();
+    const latest = await (options.fetchLatest ?? latestPublishedVersion)();
+    const requested = options.via ?? (channel === 'brew' ? 'brew' : 'npm');
+    const command = requested === 'brew' ? 'brew update && brew upgrade ywtc' : 'npm install -g @iwonz/ywtc@latest';
+    const updateAvailable = isNewerVersion(latest, options.currentVersion);
+    const safe = (requested === 'brew' && channel === 'brew') || (requested === 'npm' && channel === 'global-npm');
+    if (!options.install || !updateAvailable || !safe) {
+        return { current: options.currentVersion, latest, channel, updateAvailable, installed: false, command };
+    }
+    const execute = options.execute ?? runProcess;
+    if (requested === 'brew') {
+        await execute('brew', ['update']);
+        await execute('brew', ['upgrade', 'ywtc']);
+    }
+    else {
+        await execute('npm', ['install', '-g', '@iwonz/ywtc@latest']);
+    }
+    return { current: options.currentVersion, latest, channel, updateAvailable, installed: true, command };
+}
+//# sourceMappingURL=updater.js.map

package/dist/updater.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare function packageVersion(): string;

package/dist/version.js

@@ -0,0 +1,8 @@
+import { readFileSync } from 'node:fs';
+export function packageVersion() {
+    const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    if (typeof packageJson.version !== 'string')
+        throw new Error('Package version is missing');
+    return packageJson.version;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAErC,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAwB,CAAC;IACzH,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC3F,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC"}

package/dist/workspace.d.ts

@@ -0,0 +1,29 @@
+export declare const WORKSPACE_MARKER = ".ywtc-workspace.json";
+export declare const WORKSPACE_ENV = ".env";
+export declare const WORKSPACE_CONFIG = "ywtc.config.yaml";
+export declare const WORKSPACE_STATES = ".states";
+export declare const ENV_TEMPLATE = "# Secrets referenced by ywtc.config.yaml\nYANDEX_WIKI_TOKEN=\nCONFLUENCE_TOKEN=\nCONFLUENCE_EMAIL=\n\n# Optional global overrides\nHTTP_TIMEOUT_MS=30000\nMIGRATION_CONCURRENCY=4\n";
+export declare const CONFIG_TEMPLATE = "schemaVersion: 2\n\ndefaults:\n  timeoutMs: 30000\n  concurrency: 4\n\nconnections:\n  yandex:\n    type: yandex-wiki\n    apiUrl: https://api.wiki.yandex.net/v1\n    webUrl: https://wiki.example.com\n    authType: oauth\n    tokenEnv: YANDEX_WIKI_TOKEN\n    organization:\n      type: yandex360\n      id: \"\"\n    limits:\n      readConcurrency: 4\n      writeConcurrency: 2\n      downloadConcurrency: 2\n      uploadConcurrency: 2\n      requestsPerSecond: 8\n      burst: 8\n\n  confluence:\n    type: confluence\n    deployment: data-center\n    baseUrl: https://confluence.example.com/confluence\n    authType: pat\n    tokenEnv: CONFLUENCE_TOKEN\n    limits:\n      readConcurrency: 4\n      writeConcurrency: 2\n      downloadConcurrency: 2\n      uploadConcurrency: 2\n      requestsPerSecond: 8\n      burst: 10\n";
+export interface Workspace {
+    root: string;
+    marker: string;
+    envFile: string;
+    configFile: string;
+    statesDirectory: string;
+    cacheDirectory: string;
+    reportsDirectory: string;
+    source: 'explicit' | 'current' | 'default';
+}
+export interface WorkspaceInitialization {
+    workspace: Workspace;
+    created: string[];
+    existing: string[];
+}
+export declare function resolveWorkspace(options?: {
+    explicit?: string;
+    cwd?: string;
+    homeDirectory?: string;
+}): Promise<Workspace>;
+export declare function initializeWorkspace(workspace: Workspace): Promise<WorkspaceInitialization>;
+export declare function validateWorkspaceMarker(workspace: Workspace): Promise<void>;
+export declare function resolveWorkspacePath(workspace: Workspace, value: string): string;