@iwonz/ywtc 0.0.0-stage → 2.0.0

package/dist/graph.js

@@ -0,0 +1,121 @@
+function byCanonicalPage(left, right) {
+    return left.canonicalId.localeCompare(right.canonicalId);
+}
+function edgeStatusForReference(reference) {
+    if (reference.kind === 'external' || reference.kind === 'attachment' || reference.kind === 'anchor')
+        return 'external';
+    return reference.kind === 'unsupported' ? 'unsupported' : 'broken';
+}
+export async function discoverPageGraph(input) {
+    const { adapter, root, scope, signal, onProgress } = input;
+    const selected = new Map([[root.canonicalId, root]]);
+    const edges = [];
+    const warnings = [];
+    if (scope === 'subtree') {
+        const descendants = (await adapter.getDescendants(root)).sort(byCanonicalPage);
+        for (const page of descendants) {
+            if (signal?.aborted)
+                throw signal.reason ?? new Error('Discovery cancelled');
+            selected.set(page.canonicalId, page);
+        }
+    }
+    else if (scope === 'linked') {
+        const queue = [root];
+        let queueIndex = 0;
+        const expanded = new Set();
+        while (queueIndex < queue.length) {
+            if (signal?.aborted)
+                throw signal.reason ?? new Error('Discovery cancelled');
+            const page = queue[queueIndex++];
+            if (expanded.has(page.canonicalId))
+                continue;
+            expanded.add(page.canonicalId);
+            const references = [...page.references].sort((left, right) => left.raw.localeCompare(right.raw));
+            for (const reference of references) {
+                if (reference.kind !== 'page') {
+                    edges.push({ from: page.canonicalId, raw: reference.raw, status: edgeStatusForReference(reference) });
+                    continue;
+                }
+                if (reference.href && /^https?:\/\//i.test(reference.href)) {
+                    const target = new URL(reference.href);
+                    const origin = new URL(page.url).origin;
+                    if (target.origin !== origin) {
+                        edges.push({ from: page.canonicalId, raw: reference.raw, status: 'external' });
+                        continue;
+                    }
+                }
+                try {
+                    const resolved = await adapter.resolveReference(page, reference);
+                    if (!resolved) {
+                        edges.push({ from: page.canonicalId, raw: reference.raw, status: 'broken' });
+                        continue;
+                    }
+                    const alreadySelected = selected.has(resolved.canonicalId);
+                    edges.push({
+                        from: page.canonicalId,
+                        to: resolved.canonicalId,
+                        raw: reference.raw,
+                        status: alreadySelected && expanded.has(resolved.canonicalId) ? 'cycle' : 'resolved',
+                    });
+                    if (!alreadySelected) {
+                        selected.set(resolved.canonicalId, resolved);
+                        queue.push(resolved);
+                    }
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    const inaccessible = /\b(?:401|403|forbidden|permission|access)\b/i.test(message);
+                    edges.push({ from: page.canonicalId, raw: reference.raw, status: inaccessible ? 'inaccessible' : 'broken', message });
+                    warnings.push(`${page.title}: cannot follow ${reference.raw}: ${message}`);
+                }
+            }
+            onProgress?.({ pages: selected.size, edges: edges.length, active: page.title });
+        }
+    }
+    const selectedByProviderId = new Map([...selected.values()].map((page) => [page.id, page]));
+    const projected = new Map();
+    projected.set(root.canonicalId, undefined);
+    for (const page of selected.values()) {
+        if (page.canonicalId === root.canonicalId)
+            continue;
+        const sourceParent = page.parentId ? selectedByProviderId.get(page.parentId) : undefined;
+        projected.set(page.canonicalId, sourceParent?.canonicalId ?? root.canonicalId);
+    }
+    // A malformed vendor hierarchy must never make creation order impossible.
+    // Break the first cycle encountered from each node by attaching that node to
+    // the selected root; link-graph cycles remain recorded independently above.
+    for (const page of selected.values()) {
+        if (page.canonicalId === root.canonicalId)
+            continue;
+        const seen = new Set();
+        let current = page.canonicalId;
+        while (current && current !== root.canonicalId) {
+            if (seen.has(current)) {
+                projected.set(page.canonicalId, root.canonicalId);
+                warnings.push(`Hierarchy cycle detected at ${page.title}; attached below the root.`);
+                break;
+            }
+            seen.add(current);
+            current = projected.get(current);
+        }
+    }
+    const depths = new Map([[root.canonicalId, 0]]);
+    const depthOf = (id) => {
+        if (id === root.canonicalId)
+            return 0;
+        const cached = depths.get(id);
+        if (cached !== undefined)
+            return cached;
+        const parent = projected.get(id);
+        const depth = parent ? depthOf(parent) + 1 : 0;
+        depths.set(id, depth);
+        return depth;
+    };
+    const pages = [...selected.values()].map((page) => {
+        const projectedParentId = projected.get(page.canonicalId);
+        return { ...page, depth: depthOf(page.canonicalId), ...(projectedParentId ? { projectedParentId } : {}) };
+    }).sort((left, right) => left.depth - right.depth || left.canonicalId.localeCompare(right.canonicalId));
+    onProgress?.({ pages: pages.length, edges: edges.length });
+    return { rootId: root.canonicalId, pages, edges, warnings };
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,26 @@
+import { type AxiosRequestConfig, type AxiosResponse } from 'axios';
+import type { RequestRateLimiter } from './rate-limiter.js';
+export interface RetryingHttpClientOptions {
+    baseURL?: string;
+    timeoutMs: number;
+    headers?: Record<string, string>;
+    maxRetries?: number;
+    rateLimiter?: RequestRateLimiter;
+}
+export type RetryingRequestConfig = AxiosRequestConfig & {
+    /** Unsafe methods are not retried by default because their outcome can be ambiguous. */
+    retryMode?: 'safe' | 'always' | 'never';
+};
+export declare class HttpRequestError extends Error {
+    readonly status?: number | undefined;
+    readonly method?: string | undefined;
+    readonly url?: string | undefined;
+    constructor(message: string, status?: number | undefined, method?: string | undefined, url?: string | undefined);
+}
+export declare class RetryingHttpClient {
+    private readonly client;
+    private readonly maxRetries;
+    private readonly rateLimiter;
+    constructor(options: RetryingHttpClientOptions);
+    request<T>(config: RetryingRequestConfig): Promise<AxiosResponse<T>>;
+}

package/dist/http.js

@@ -0,0 +1,100 @@
+import axios from 'axios';
+export class HttpRequestError extends Error {
+    status;
+    method;
+    url;
+    constructor(message, status, method, url) {
+        super(message);
+        this.status = status;
+        this.method = method;
+        this.url = url;
+        this.name = 'HttpRequestError';
+    }
+}
+function retryAfterMs(response) {
+    const raw = response?.headers['retry-after'];
+    if (raw === undefined)
+        return undefined;
+    const seconds = Number(raw);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1_000);
+    const date = Date.parse(String(raw));
+    return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());
+}
+function isRetriable(error) {
+    if (!error.response)
+        return error.code !== 'ERR_CANCELED';
+    return error.response.status === 429 || error.response.status >= 500;
+}
+function safeErrorMessage(error) {
+    const status = error.response?.status;
+    const payload = error.response?.data;
+    let detail = '';
+    if (typeof payload === 'string')
+        detail = payload.slice(0, 500);
+    else if (payload && typeof payload === 'object') {
+        const body = payload;
+        detail = String(body.debug_message ?? body.message ?? body.error_code ?? '').slice(0, 500);
+    }
+    const guidance = status === 401
+        ? 'authentication rejected; check token and auth type'
+        : status === 403
+            ? 'permission denied; check source visibility and destination page/attachment permissions'
+            : status === 404
+                ? 'resource or API route not found; check URL, page ID, deployment, and API compatibility'
+                : status === 409
+                    ? 'destination conflict; retry with the same state after checking the current page version/title'
+                    : status === 413
+                        ? 'payload too large for the destination; check Confluence attachment limits'
+                        : status === 429
+                            ? 'rate limited after bounded retries; lower configured RPS/concurrency or retry later'
+                            : undefined;
+    return [`HTTP request failed`, status ? `status=${status}` : undefined, guidance, detail || error.message]
+        .filter(Boolean)
+        .join(': ');
+}
+export class RetryingHttpClient {
+    client;
+    maxRetries;
+    rateLimiter;
+    constructor(options) {
+        this.client = axios.create({
+            ...(options.baseURL ? { baseURL: options.baseURL } : {}),
+            timeout: options.timeoutMs,
+            ...(options.headers ? { headers: options.headers } : {}),
+            maxRedirects: 5,
+            validateStatus: (status) => status >= 200 && status < 300,
+        });
+        this.maxRetries = options.maxRetries ?? 4;
+        this.rateLimiter = options.rateLimiter;
+    }
+    async request(config) {
+        const { retryMode = 'safe', ...axiosConfig } = config;
+        const method = String(axiosConfig.method ?? 'GET').toUpperCase();
+        const canRetry = retryMode === 'always'
+            || (retryMode === 'safe' && ['GET', 'HEAD', 'OPTIONS'].includes(method));
+        for (let attempt = 0;; attempt += 1) {
+            try {
+                await this.rateLimiter?.acquire();
+                return await this.client.request(axiosConfig);
+            }
+            catch (caught) {
+                const error = caught;
+                if (!axios.isAxiosError(error))
+                    throw caught;
+                const backoff = Math.min(30_000, 500 * 2 ** attempt + Math.floor(Math.random() * 250));
+                const headerDelay = retryAfterMs(error.response);
+                const delay = error.response?.status === 429
+                    ? Math.max(1_000, headerDelay ?? backoff)
+                    : Math.min(60_000, headerDelay ?? backoff);
+                if (error.response?.status === 429)
+                    this.rateLimiter?.pause(delay);
+                if (!canRetry || attempt >= this.maxRetries || !isRetriable(error)) {
+                    throw new HttpRequestError(safeErrorMessage(error), error.response?.status, method, String(axiosConfig.url ?? ''));
+                }
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export * from './config.js';
+export * from './cli-arguments.js';
+export * from './adapters/confluence.js';
+export * from './adapters/factory.js';
+export * from './adapters/yandex.js';
+export * from './clients/confluence-cloud.js';
+export * from './clients/confluence-factory.js';
+export * from './clients/confluence.js';
+export * from './clients/yandex-wiki.js';
+export * from './conversion.js';
+export * from './content-model.js';
+export * from './domain.js';
+export * from './filesystem-export.js';
+export * from './graph.js';
+export * from './input.js';
+export * from './locators.js';
+export * from './migrator.js';
+export * from './rate-limiter.js';
+export * from './report.js';
+export * from './state.js';
+export * from './types.js';
+export * from './updater.js';
+export * from './version.js';
+export * from './workspace.js';

package/dist/index.js

@@ -0,0 +1,25 @@
+export * from './config.js';
+export * from './cli-arguments.js';
+export * from './adapters/confluence.js';
+export * from './adapters/factory.js';
+export * from './adapters/yandex.js';
+export * from './clients/confluence-cloud.js';
+export * from './clients/confluence-factory.js';
+export * from './clients/confluence.js';
+export * from './clients/yandex-wiki.js';
+export * from './conversion.js';
+export * from './content-model.js';
+export * from './domain.js';
+export * from './filesystem-export.js';
+export * from './graph.js';
+export * from './input.js';
+export * from './locators.js';
+export * from './migrator.js';
+export * from './rate-limiter.js';
+export * from './report.js';
+export * from './state.js';
+export * from './types.js';
+export * from './updater.js';
+export * from './version.js';
+export * from './workspace.js';
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,4 @@
+export declare function normalizeWikiSlug(value: string): string;
+export declare function parseWikiSource(input: string, wikiWebUrl: string): string;
+export declare function resolveRelativeWikiSlug(currentSlug: string, hrefPath: string): string;
+export declare function safeFilename(value: string): string;

package/dist/input.js

@@ -0,0 +1,56 @@
+import path from 'node:path';
+function decodePath(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+export function normalizeWikiSlug(value) {
+    return decodePath(value)
+        .replace(/^\/+|\/+$/g, '')
+        .replace(/\/{2,}/g, '/')
+        .trim();
+}
+export function parseWikiSource(input, wikiWebUrl) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        throw new Error('Source Wiki slug or URL is required');
+    try {
+        const source = new URL(trimmed);
+        const configured = new URL(wikiWebUrl);
+        if (source.host !== configured.host) {
+            throw new Error(`Source URL host must match ${configured.host}`);
+        }
+        const basePath = configured.pathname.replace(/\/+$/, '');
+        const pathname = basePath && source.pathname.startsWith(basePath)
+            ? source.pathname.slice(basePath.length)
+            : source.pathname;
+        const slug = normalizeWikiSlug(pathname);
+        if (!slug)
+            throw new Error('Source URL does not contain a Wiki page slug');
+        return slug;
+    }
+    catch (error) {
+        if (/^[a-z][a-z\d+.-]*:\/\//i.test(trimmed))
+            throw error;
+        const slug = normalizeWikiSlug(trimmed);
+        if (!slug)
+            throw new Error('Source Wiki slug is empty');
+        return slug;
+    }
+}
+export function resolveRelativeWikiSlug(currentSlug, hrefPath) {
+    const decoded = decodePath(hrefPath).replace(/\\/g, '/');
+    if (decoded.startsWith('/'))
+        return normalizeWikiSlug(decoded);
+    const directory = path.posix.dirname(normalizeWikiSlug(currentSlug));
+    return normalizeWikiSlug(path.posix.normalize(path.posix.join(directory === '.' ? '' : directory, decoded)));
+}
+export function safeFilename(value) {
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: filesystem control characters must be removed.
+    const normalized = path.basename(value).replace(/[\u0000-\u001f<>:"/\\|?*]/g, '_').trim();
+    return normalized || 'unnamed-file';
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

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

package/dist/locators.d.ts

@@ -0,0 +1,24 @@
+import type { AppConfig, ConnectionProfile } from './config.js';
+import type { ExportFormat } from './domain.js';
+export interface RemoteLocator {
+    type: 'remote';
+    value: string;
+    profile: ConnectionProfile;
+}
+export interface DirectoryLocator {
+    type: 'directory';
+    path: string;
+    format: ExportFormat;
+}
+export type ResolvedLocator = RemoteLocator | DirectoryLocator;
+export declare function selectRemoteProfile(config: AppConfig, locator: string, requestedProfile: string | undefined, role: 'source' | 'destination'): ConnectionProfile;
+export declare function resolveSourceLocator(config: AppConfig, value: string, profile?: string): RemoteLocator;
+export declare function resolveDestinationLocator(input: {
+    config: AppConfig;
+    value: string;
+    profile?: string;
+    format?: ExportFormat;
+    cwd?: string;
+}): ResolvedLocator;
+export declare function profileBaseUrl(profile: ConnectionProfile): string;
+export declare function sameRemoteInstance(left: ConnectionProfile, right: ConnectionProfile): boolean;

package/dist/locators.js

@@ -0,0 +1,84 @@
+import path from 'node:path';
+function normalizedBase(profile) {
+    return new URL(profile.type === 'yandex-wiki' ? profile.webUrl : profile.baseUrl);
+}
+function normalizedProfileUrl(profile) {
+    const url = normalizedBase(profile);
+    url.hash = '';
+    url.search = '';
+    url.pathname = url.pathname.replace(/\/+$/, '') || '/';
+    if (profile.type === 'confluence' && profile.deployment === 'cloud') {
+        url.pathname = url.pathname.replace(/\/wiki$/, '') || '/';
+    }
+    return url;
+}
+function isAbsoluteUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+function urlMatchesProfile(value, profile) {
+    const candidate = new URL(value);
+    const base = normalizedBase(profile);
+    if (candidate.origin !== base.origin)
+        return false;
+    const basePath = base.pathname.replace(/\/+$/, '');
+    return !basePath || candidate.pathname === basePath || candidate.pathname.startsWith(`${basePath}/`);
+}
+export function selectRemoteProfile(config, locator, requestedProfile, role) {
+    if (requestedProfile) {
+        const profile = config.profiles[requestedProfile];
+        if (!profile)
+            throw new Error(`Unknown --${role}-profile "${requestedProfile}". Available profiles: ${Object.keys(config.profiles).sort().join(', ') || 'none'}.`);
+        if (isAbsoluteUrl(locator) && !urlMatchesProfile(locator, profile)) {
+            throw new Error(`${role} URL does not belong to profile "${requestedProfile}" (${normalizedBase(profile).origin}).`);
+        }
+        return profile;
+    }
+    const profiles = Object.values(config.profiles);
+    if (isAbsoluteUrl(locator)) {
+        const matches = profiles
+            .filter((profile) => urlMatchesProfile(locator, profile))
+            .sort((left, right) => normalizedBase(right).pathname.length - normalizedBase(left).pathname.length);
+        if (matches.length === 0)
+            throw new Error(`No configured profile matches ${role} URL. Add its base URL to ${config.configFile} or pass a configured endpoint.`);
+        if (matches.length > 1 && normalizedBase(matches[0]).pathname.length === normalizedBase(matches[1]).pathname.length) {
+            throw new Error(`Multiple profiles match ${role} URL: ${matches.map((profile) => profile.name).join(', ')}. Pass --${role}-profile.`);
+        }
+        return matches[0];
+    }
+    const suitable = /^\d+$/.test(locator)
+        ? profiles
+        : profiles.filter((profile) => profile.type === 'yandex-wiki');
+    if (suitable.length === 1)
+        return suitable[0];
+    if (suitable.length === 0) {
+        throw new Error(`No configured profile accepts the ${role} shorthand "${locator}". Use an absolute URL or add a Yandex Wiki profile.`);
+    }
+    throw new Error(`The ${role} locator "${locator}" is shorthand and ${suitable.length} suitable profiles are configured. Pass --${role}-profile (${suitable.map((profile) => profile.name).sort().join(', ')}).`);
+}
+export function resolveSourceLocator(config, value, profile) {
+    return { type: 'remote', value: value.trim(), profile: selectRemoteProfile(config, value.trim(), profile, 'source') };
+}
+export function resolveDestinationLocator(input) {
+    const value = input.value.trim();
+    if (input.format) {
+        if (input.profile)
+            throw new Error('--destination-profile cannot be combined with a filesystem --format.');
+        if (isAbsoluteUrl(value))
+            throw new Error('--format cannot be used with an HTTP(S) destination. Omit --format for a remote page.');
+        return { type: 'directory', path: path.resolve(input.cwd ?? process.cwd(), value), format: input.format };
+    }
+    return { type: 'remote', value, profile: selectRemoteProfile(input.config, value, input.profile, 'destination') };
+}
+export function profileBaseUrl(profile) {
+    return normalizedProfileUrl(profile).toString().replace(/\/$/, '');
+}
+export function sameRemoteInstance(left, right) {
+    return left.type === right.type && profileBaseUrl(left) === profileBaseUrl(right);
+}
+//# sourceMappingURL=locators.js.map

package/dist/locators.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+export interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export declare function redact(value: unknown, secrets: string[]): string;
+export declare function createLogger(secrets?: string[]): Logger;

package/dist/logger.js

@@ -0,0 +1,28 @@
+export function redact(value, secrets) {
+    let message = value instanceof Error ? value.message : String(value);
+    for (const secret of secrets) {
+        if (secret) {
+            message = message.split(secret).join('[REDACTED]');
+        }
+    }
+    return message;
+}
+export function createLogger(secrets = []) {
+    const write = (level, message) => {
+        const safe = redact(message, secrets);
+        const target = level === 'error' ? console.error : level === 'warn' ? console.warn : console.log;
+        const time = new Date().toISOString().slice(11, 19);
+        const symbol = level === 'error' ? '✗' : level === 'warn' ? '⚠' : '◆';
+        const color = process.stderr.isTTY && !process.env.NO_COLOR
+            ? level === 'error' ? 31 : level === 'warn' ? 33 : 36
+            : undefined;
+        const marker = color ? `\u001B[${color}m${symbol}\u001B[0m` : symbol;
+        target(`  ${time} ${marker} ${safe}`);
+    };
+    return {
+        info: (message) => write('info', message),
+        warn: (message) => write('warn', message),
+        error: (message) => write('error', message),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,OAAiB;IACtD,IAAI,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAoB,EAAE;IACjD,MAAM,KAAK,GAAG,CAAC,KAAe,EAAE,OAAe,EAAQ,EAAE;QACvD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QACjG,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QACtE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ;YACzD,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YACrD,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;QACrE,MAAM,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;QACzC,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;QACzC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/migrator.d.ts

@@ -0,0 +1,53 @@
+import { createProviderAdapter } from './adapters/factory.js';
+import type { AppConfig } from './config.js';
+import type { TransferScope } from './domain.js';
+import type { Logger } from './logger.js';
+import type { RemoteLocator, ResolvedLocator } from './locators.js';
+import { type MigrationReportPaths } from './report.js';
+import { type RunStatus } from './state.js';
+export interface TransferOptions {
+    source: RemoteLocator;
+    destination: ResolvedLocator;
+    scope: TransferScope;
+    dryRun: boolean;
+    archive: boolean;
+    fresh?: boolean;
+    concurrency: number;
+    stateFilename?: string;
+    runtimeDirectory: string;
+    cacheDirectory: string;
+    reportsDirectory: string;
+    signal?: AbortSignal;
+    onStatus?: (message: string) => void;
+}
+export interface TransferResult {
+    status: RunStatus;
+    hasErrors: boolean;
+    reportPaths: MigrationReportPaths;
+    stateId: string;
+    stateFilename: string;
+    stateBackupFilename?: string;
+    output?: string;
+    archive?: string;
+    summary: {
+        pages: number;
+        complete: number;
+        partial: number;
+        failed: number;
+        resources: number;
+        bytes: number;
+        links: number;
+        cycles: number;
+        warnings: number;
+        errors: number;
+    };
+}
+export declare class Migrator {
+    private readonly config;
+    private readonly logger;
+    private readonly adapterFactory;
+    constructor(config: AppConfig, logger: Logger, adapterFactory?: typeof createProviderAdapter);
+    run(options: TransferOptions): Promise<TransferResult>;
+    private exportFilesystem;
+    private transferRemote;
+}