@numa-tech/numa 1.18.0 → 1.20.0

package/dist/oss/transfer-paths.js

@@ -0,0 +1,131 @@
+import { createHash } from 'node:crypto';
+import { lstat, readdir, realpath } from 'node:fs/promises';
+import { basename, dirname, isAbsolute, join, relative, sep } from 'node:path';
+import { OssError } from './errors.js';
+import { ossSessionCapabilities, ossTransferOptions } from './transfers.js';
+const MAX_FILES = 10_000;
+function invalid(message = '文件路径无效，或目录包含符号链接。') { throw new OssError(message, 'oss_transfer_path_invalid', 400); }
+function count(files) { if (files.length > MAX_FILES)
+    throw new OssError('单次最多选择 10000 个文件。', 'oss_transfer_limit', 400); }
+function validSize(size) { if (!Number.isSafeInteger(size) || size < 0)
+    invalid(); return size; }
+function segments(path) {
+    const parts = path.split('/');
+    if (parts.some(p => !p || p === '.' || p === '..' || /[\\\u0000-\u001f\u007f]/u.test(p)))
+        invalid();
+    return parts;
+}
+export function transferBinding(session) {
+    return createHash('sha256').update(JSON.stringify([session.grantId, session.accountUid, session.bucketName,
+        session.region, session.scopeType, ossSessionCapabilities(session).root, session.roleArn, session.sourceIdentity])).digest('hex');
+}
+export async function planUploadJobs(session, selected, prefix, folder) {
+    const files = [], keys = new Set();
+    if (!selected.length || selected.length > MAX_FILES || (folder && selected.length !== 1))
+        invalid();
+    const target = prefix ? prefix.replace(/\/$/u, '') + '/' : '';
+    async function visit(path, key, root) {
+        const info = await lstat(path);
+        if (info.isSymbolicLink())
+            invalid();
+        if (info.isDirectory()) {
+            for (const entry of await readdir(path)) {
+                segments(entry);
+                await visit(join(path, entry), key + '/' + entry, root);
+            }
+        }
+        else if (info.isFile()) {
+            const checked = ossTransferOptions(session, key, 'write').key;
+            // Never silently trim a local filename while translating it to an OSS key.
+            if (checked !== key || keys.has(key))
+                invalid();
+            keys.add(key);
+            files.push({ key, localPath: path, localRoot: root, size: validSize(info.size),
+                source: { dev: info.dev, ino: info.ino, size: info.size, mtimeMs: info.mtimeMs } });
+            count(files);
+        }
+        else
+            invalid();
+    }
+    for (const path of selected) {
+        if (!isAbsolute(path))
+            invalid();
+        const info = await lstat(path);
+        if (info.isSymbolicLink() || (folder ? !info.isDirectory() : !info.isFile()))
+            invalid();
+        const name = basename(path);
+        segments(name);
+        const parent = await realpath(dirname(path)), canonical = join(parent, name);
+        await visit(canonical, target + name, folder ? canonical : parent);
+    }
+    if (!files.length)
+        throw new OssError('所选目录中没有文件。', 'oss_transfer_empty', 400);
+    return files;
+}
+export async function planDownloadJobs(session, entries, selectedRoot, transfer) {
+    if (!isAbsolute(selectedRoot) || !entries.length || entries.length > MAX_FILES)
+        invalid();
+    if ((await lstat(selectedRoot)).isSymbolicLink())
+        invalid();
+    const root = await realpath(selectedRoot);
+    if (!(await lstat(root)).isDirectory())
+        invalid();
+    const files = [], outputs = new Set();
+    async function add(key, path, size) {
+        if (ossTransferOptions(session, key, 'read').key !== key)
+            invalid();
+        const parts = segments(path);
+        // Use portable filenames so the same queue cannot create Windows device/ADS paths.
+        if (parts.some(p => /[<>:"|?*]/u.test(p) || /[. ]$/u.test(p) || /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/iu.test(p)))
+            invalid();
+        const folded = parts.join('/').normalize('NFC').toLowerCase();
+        if ([...outputs].some(p => p === folded || p.startsWith(folded + '/') || folded.startsWith(p + '/')))
+            invalid('所选文件的本地路径重复。');
+        outputs.add(folded);
+        const localPath = join(root, ...parts);
+        if (relative(root, localPath).startsWith('..' + sep))
+            invalid();
+        let current = root;
+        for (let i = 0; i < parts.length; i++) {
+            current = join(current, parts[i]);
+            const info = await lstat(current).catch(error => { if (error.code === 'ENOENT')
+                return undefined; throw error; });
+            if (info && (i === parts.length - 1 || info.isSymbolicLink() || !info.isDirectory())) {
+                throw new OssError('目标文件已存在或路径不安全，未覆盖。', 'oss_transfer_destination_exists', 409);
+            }
+        }
+        files.push({ key, localRoot: root, localPath, size: validSize(size) });
+        count(files);
+    }
+    for (const entry of entries) {
+        const key = entry.key;
+        if (!entry.directory) {
+            const metadata = await transfer.stat(session, key);
+            await add(key, key.split('/').pop(), metadata.contentLength);
+            continue;
+        }
+        if (!key.endsWith('/'))
+            invalid();
+        const name = segments(key.slice(0, -1)).at(-1);
+        let marker;
+        const seen = new Set();
+        do {
+            const listing = await transfer.list(session, key, 1000, { marker });
+            for (const object of listing.objects) {
+                if (!object.key.startsWith(key))
+                    invalid();
+                if (!object.key.endsWith('/'))
+                    await add(object.key, name + '/' + object.key.slice(key.length), object.sizeBytes);
+            }
+            marker = listing.truncated ? listing.nextMarker : undefined;
+            if (listing.truncated && (!marker || seen.has(marker)))
+                invalid();
+            if (marker)
+                seen.add(marker);
+        } while (marker);
+    }
+    if (!files.length)
+        throw new OssError('所选目录中没有可下载的文件。', 'oss_transfer_empty', 400);
+    return files;
+}
+//# sourceMappingURL=transfer-paths.js.map

package/dist/oss/transfer-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-paths.js","sourceRoot":"","sources":["../../src/oss/transfer-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EAAqB,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG/F,MAAM,SAAS,GAAG,MAAM,CAAC;AACzB,SAAS,OAAO,CAAC,OAAO,GAAG,mBAAmB,IAAW,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,2BAA2B,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACzH,SAAS,KAAK,CAAC,KAAoB,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS;IAAE,MAAM,IAAI,QAAQ,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1I,SAAS,SAAS,CAAC,IAAY,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;IAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;AACzG,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACpG,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,OAAsB;IACpD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU;QACxG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtI,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAsB,EAAE,QAAkB,EAAE,MAAc,EAAE,MAAe;IAC9G,MAAM,KAAK,GAAkB,EAAE,EAAE,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,SAAS,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACpG,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,GAAW,EAAE,IAAY;QAC1D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,cAAc,EAAE;YAAE,OAAO,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC;YAAC,CAAC;QACxH,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC;YAC9D,2EAA2E;YAC3E,IAAI,OAAO,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3F,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtG,CAAC;;YAAM,OAAO,EAAE,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;QACxH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7E,MAAM,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,YAAY,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAsB,EAAE,OAA8C,EAAE,YAAoB,EAAE,QAA2B;IAC9J,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1F,IAAI,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,EAAE;QAAE,OAAO,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;IAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE;QAAE,OAAO,EAAE,CAAC;IAC7F,MAAM,KAAK,GAAkB,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7D,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY;QACxD,IAAI,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK,GAAG;YAAE,OAAO,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,mFAAmF;QACnF,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,kDAAkD,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QACvI,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9D,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9H,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;QACvC,IAAI,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAChE,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAClH,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACrF,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE,iCAAiC,EAAE,GAAG,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvF,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAAC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAAC,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,EAAE,QAAQ,CAAC,aAAc,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACvJ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;QAChD,IAAI,MAA0B,CAAC;QAAC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/D,GAAG,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,MAAM,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YACpH,CAAC;YACD,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5D,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClE,IAAI,MAAM;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,QAAQ,MAAM,EAAE;IACnB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC;IACnF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/oss/transfer-queue.d.ts

@@ -0,0 +1,62 @@
+import type { AccessSession } from './schemas.js';
+import { type PlannedFile } from './transfer-paths.js';
+import type { TransferJob, TransferWorker } from './transfer-types.js';
+export interface TransferQueueOptions {
+    directory: string;
+    session(grantId: number): Promise<AccessSession>;
+    worker?: TransferWorker;
+    maxConcurrent?: number;
+}
+type Action = 'pause' | 'resume' | 'cancel';
+export declare function createTransferQueue(options: TransferQueueOptions): Promise<TransferQueue>;
+export declare class TransferQueue {
+    private options;
+    private jobs;
+    private readonly active;
+    private readonly actions;
+    private saving;
+    private closing;
+    private closed?;
+    private lock?;
+    private worker;
+    private maximum;
+    private storageError;
+    constructor(options: TransferQueueOptions);
+    initialize(): Promise<void>;
+    list(): {
+        id: string;
+        direction: 'upload' | 'download';
+        grantId: number;
+        key: string;
+        localPath: string;
+        size: number;
+        transferred: number;
+        status: import("./transfer-types.js").TransferStatus;
+        createdAt: string;
+        updatedAt: string;
+        error?: string;
+        bytesPerSecond: number;
+    }[];
+    add(direction: TransferJob['direction'], session: AccessSession, files: PlannedFile[]): Promise<{
+        id: string;
+        direction: 'upload' | 'download';
+        grantId: number;
+        key: string;
+        localPath: string;
+        size: number;
+        transferred: number;
+        status: import("./transfer-types.js").TransferStatus;
+        createdAt: string;
+        updatedAt: string;
+        error?: string;
+        bytesPerSecond: number;
+    }[]>;
+    private context;
+    private schedule;
+    action(id: string, action: Action): Promise<void>;
+    private performAction;
+    private save;
+    close(): Promise<void>;
+    private unlock;
+}
+export {};

package/dist/oss/transfer-queue.js

@@ -0,0 +1,349 @@
+import { randomUUID } from 'node:crypto';
+import { constants } from 'node:fs';
+import { lstat, mkdir, open, readFile, rename, rm, chmod } from 'node:fs/promises';
+import { isAbsolute, join, relative, sep } from 'node:path';
+import { z } from 'zod';
+import { OssError } from './errors.js';
+import { transferBinding } from './transfer-paths.js';
+import { createTransferWorker } from './transfer-worker.js';
+const integer = z.number().int().nonnegative().safe();
+const checkpoint = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('upload'), uploadId: z.string().max(2048), partSize: integer.positive(), parts: z.array(z.object({ number: integer.positive(), etag: z.string().max(2048) }).strict()).max(10000), committing: z.boolean().optional() }).strict(),
+    z.object({ kind: z.literal('download'), partSize: integer.positive(), etag: z.string().max(2048), parts: z.array(integer).max(10000), tempPath: z.string().max(8192), tempDev: integer.optional(), tempIno: integer.optional(), committing: z.boolean().optional() }).strict()
+]);
+const jobSchema = z.object({ id: z.string().uuid(), direction: z.enum(['upload', 'download']), grantId: integer.positive(), key: z.string().min(1).max(1024),
+    localPath: z.string().max(8192), localRoot: z.string().max(8192), size: integer, transferred: integer, binding: z.string().regex(/^[a-f0-9]{64}$/u),
+    source: z.object({ dev: integer, ino: integer, size: integer, mtimeMs: z.number().finite() }).strict().optional(), checkpoint: checkpoint.optional(),
+    status: z.enum(['queued', 'running', 'pausing', 'paused', 'cancelling', 'cancelled', 'completed', 'failed']), createdAt: z.string().datetime(), updatedAt: z.string().datetime(), error: z.string().max(2048).optional()
+}).strict();
+const stateSchema = z.object({ version: z.literal(1), jobs: z.array(jobSchema).max(10000) }).strict();
+function safeError(error) {
+    const code = error instanceof OssError ? error.code : '';
+    const messages = {
+        oss_output_exists: '目标文件已存在，未覆盖。', oss_source_changed: '本地文件已变化，请重新选择文件。',
+        oss_remote_changed: '远程文件已变化，请取消后重新下载。', oss_path_invalid: '本地路径无效或包含符号链接。',
+        oss_checkpoint_invalid: '断点记录无效，请取消后重新创建任务。', oss_transfer_cleanup_failed: '清理未完成，请检查连接后再次取消。',
+        oss_transfer_binding_changed: '授权范围或身份已变化，请重新选择授权并创建任务。',
+        oss_web_session_expired: 'STS 已到期，请续期后继续任务。', oss_web_refresh_failed: '授权续期失败，请检查登录后继续任务。',
+        oss_web_scope_changed: '授权范围已变化，请重新启动 CLI。', oss_operation_forbidden: '当前授权不允许此操作。',
+        oss_grant_forbidden: '当前授权不可用，请检查授权后继续任务。', oss_scope_violation: '对象路径超出当前授权范围。'
+    };
+    return messages[code] ?? '传输失败，请检查网络、权限和本地磁盘后重试。';
+}
+export async function createTransferQueue(options) {
+    const queue = new TransferQueue(options);
+    await queue.initialize();
+    return queue;
+}
+export class TransferQueue {
+    options;
+    jobs = [];
+    active = new Map();
+    actions = new Map();
+    saving = Promise.resolve();
+    closing = false;
+    closed;
+    lock;
+    worker;
+    maximum;
+    storageError = false;
+    constructor(options) {
+        this.options = options;
+        this.worker = options.worker ?? createTransferWorker();
+        this.maximum = options.maxConcurrent ?? 3;
+        if (!Number.isInteger(this.maximum) || this.maximum < 1 || this.maximum > 10)
+            throw new OssError('Invalid concurrency', 'oss_input_invalid', 400);
+    }
+    async initialize() {
+        const directory = this.options.directory;
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+        const info = await lstat(directory);
+        if (!info.isDirectory() || info.isSymbolicLink())
+            throw new OssError('任务目录无效。', 'oss_transfer_storage_invalid');
+        await chmod(directory, 0o700);
+        const path = join(directory, 'queue.lock');
+        try {
+            this.lock = await open(path, 'wx', 0o600);
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+            // Serialize stale-PID recovery: comparing an inode before unlink is not
+            // sufficient when two new servers start at the same time.
+            const recoveryPath = join(directory, 'queue.recovery.lock');
+            const recovery = await open(recoveryPath, 'wx', 0o600).catch(() => { throw new OssError('任务队列正在恢复，或上次恢复被中断；请检查本机任务目录。', 'oss_transfer_queue_busy', 409); });
+            try {
+                const existing = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+                let identity;
+                try {
+                    identity = await existing.stat();
+                    if (!identity.isFile() || identity.size > 100)
+                        throw new Error('invalid lock');
+                    const pid = Number((await existing.readFile('utf8')).trim());
+                    if (!Number.isSafeInteger(pid) || pid <= 0)
+                        throw new OssError('任务目录锁无效，请检查本机任务目录。', 'oss_transfer_storage_invalid');
+                    let alive = true;
+                    try {
+                        process.kill(pid, 0);
+                    }
+                    catch (e) {
+                        if (e.code === 'ESRCH')
+                            alive = false;
+                    }
+                    if (alive)
+                        throw new OssError(`另一个 OSS 网页服务（PID ${pid}）正在使用此账号的任务队列。`, 'oss_transfer_queue_busy', 409);
+                }
+                finally {
+                    await existing.close();
+                }
+                const current = await lstat(path);
+                if (current.dev !== identity.dev || current.ino !== identity.ino)
+                    throw new OssError('任务队列已被占用。', 'oss_transfer_queue_busy', 409);
+                await rm(path);
+                this.lock = await open(path, 'wx', 0o600);
+            }
+            finally {
+                await recovery.close();
+                await rm(recoveryPath, { force: true });
+            }
+        }
+        try {
+            await this.lock.writeFile(String(process.pid));
+            await this.lock.sync();
+            const statePath = join(directory, 'tasks.json');
+            const info = await lstat(statePath).catch(e => { if (e.code === 'ENOENT')
+                return undefined; throw e; });
+            if (info) {
+                if (!info.isFile() || info.isSymbolicLink() || info.size > 16 * 1024 * 1024)
+                    throw new Error('invalid state file');
+                const state = stateSchema.parse(JSON.parse(await readFile(statePath, 'utf8')));
+                const seen = new Set();
+                for (const job of state.jobs) {
+                    const rel = relative(job.localRoot, job.localPath);
+                    if (!isAbsolute(job.localPath) || !isAbsolute(job.localRoot) || !rel || rel === '..' || rel.startsWith('..' + sep) || isAbsolute(rel) || seen.has(job.id))
+                        throw new Error('invalid job path');
+                    seen.add(job.id);
+                    if (['queued', 'running', 'pausing', 'cancelling'].includes(job.status))
+                        job.status = 'paused';
+                }
+                this.jobs = state.jobs;
+            }
+            await this.save();
+        }
+        catch (error) {
+            await this.unlock();
+            if (error instanceof OssError)
+                throw error;
+            throw new OssError('本机任务记录无法读取或写入；请检查任务目录。', 'oss_transfer_storage_invalid');
+        }
+    }
+    list() {
+        return this.jobs.map(job => {
+            const { checkpoint: _checkpoint, binding: _binding, source: _source, localRoot: _root, ...view } = job;
+            const active = this.active.get(job.id);
+            const bytesPerSecond = active && job.status === 'running' ? Math.max(0, (job.transferred - active.initial) / Math.max(1, (Date.now() - active.started) / 1000)) : 0;
+            return { ...view, bytesPerSecond };
+        });
+    }
+    async add(direction, session, files) {
+        if (this.closing || this.storageError)
+            throw new OssError('任务队列不可用。', 'oss_transfer_storage_invalid');
+        const pending = this.jobs.filter(j => !['completed', 'cancelled'].includes(j.status));
+        if (!files.length || pending.length + files.length > 10000)
+            throw new OssError('未完成任务数量已达上限。', 'oss_transfer_limit', 400);
+        const binding = transferBinding(session), date = new Date().toISOString();
+        const additions = files.map(file => jobSchema.parse({ ...file, id: randomUUID(), direction, grantId: session.grantId, binding, transferred: 0, status: 'queued', createdAt: date, updatedAt: date }));
+        for (const job of additions) {
+            if (pending.some(other => other.direction === direction && (direction === 'download' ? other.localPath === job.localPath : other.binding === job.binding && other.key === job.key)))
+                throw new OssError('同一路径已有未完成任务。', 'oss_transfer_duplicate', 409);
+            pending.push(job);
+        }
+        let excess = this.jobs.length + additions.length - 10000;
+        this.jobs = this.jobs.filter(job => { if (excess > 0 && ['completed', 'cancelled'].includes(job.status)) {
+            excess--;
+            return false;
+        } return true; });
+        this.jobs.push(...additions);
+        await this.save();
+        this.schedule();
+        const ids = new Set(additions.map(j => j.id));
+        return this.list().filter(j => ids.has(j.id));
+    }
+    context(job, controller) {
+        return { signal: controller.signal, session: async () => {
+                const session = await this.options.session(job.grantId);
+                if (transferBinding(session) !== job.binding)
+                    throw new OssError('Binding changed', 'oss_transfer_binding_changed');
+                return session;
+            }, save: () => this.save(), progress: bytes => { if (Number.isFinite(bytes)) {
+                job.transferred = Math.max(0, Math.min(job.size, bytes));
+                job.updatedAt = new Date().toISOString();
+            } } };
+    }
+    schedule() {
+        if (this.closing || this.storageError)
+            return;
+        for (const job of this.jobs) {
+            if (this.active.size >= this.maximum)
+                break;
+            if (job.status !== 'queued')
+                continue;
+            const controller = new AbortController();
+            job.status = 'running';
+            delete job.error;
+            const active = { controller, done: Promise.resolve(), started: Date.now(), initial: job.transferred };
+            this.active.set(job.id, active);
+            active.done = (async () => {
+                try {
+                    await this.save();
+                    await this.worker.run(job, this.context(job, controller));
+                    // A committed object/file cannot be undone by a late pause or cancellation.
+                    job.status = 'completed';
+                    job.transferred = job.size;
+                    delete job.checkpoint;
+                }
+                catch (error) {
+                    if (controller.signal.aborted)
+                        job.status = 'paused';
+                    else {
+                        job.status = 'failed';
+                        job.error = safeError(error);
+                    }
+                }
+                finally {
+                    job.updatedAt = new Date().toISOString();
+                    try {
+                        await this.save();
+                    }
+                    catch {
+                        this.storageError = true;
+                    }
+                    this.active.delete(job.id);
+                    this.schedule();
+                }
+            })();
+        }
+    }
+    action(id, action) {
+        const previous = this.actions.get(id) ?? Promise.resolve();
+        const next = previous.catch(() => { }).then(() => this.performAction(id, action));
+        this.actions.set(id, next);
+        void next.finally(() => { if (this.actions.get(id) === next)
+            this.actions.delete(id); }).catch(() => { });
+        return next;
+    }
+    async performAction(id, action) {
+        if (this.closing)
+            throw new OssError('任务服务正在关闭。', 'oss_transfer_storage_invalid');
+        const job = this.jobs.find(j => j.id === id);
+        if (!job)
+            throw new OssError('任务不存在。', 'oss_input_invalid', 404);
+        if (['completed', 'cancelled'].includes(job.status))
+            return;
+        if (action === 'resume') {
+            if (!['paused', 'failed'].includes(job.status))
+                return;
+            if (this.storageError)
+                throw new OssError('任务记录写入失败。', 'oss_transfer_storage_invalid');
+            job.status = 'queued';
+            delete job.error;
+            await this.save();
+            this.schedule();
+            return;
+        }
+        const active = this.active.get(id);
+        job.status = action === 'pause' ? 'pausing' : 'cancelling';
+        active?.controller.abort();
+        if (active)
+            await active.done;
+        if (job.status === 'completed')
+            return;
+        if (action === 'cancel') {
+            try {
+                await this.worker.cancel(job, this.context(job, new AbortController()));
+                if (job.status !== 'completed')
+                    job.status = 'cancelled';
+                delete job.checkpoint;
+                delete job.error;
+            }
+            catch (error) {
+                job.status = 'failed';
+                job.error = safeError(error);
+            }
+        }
+        else
+            job.status = 'paused';
+        job.updatedAt = new Date().toISOString();
+        await this.save();
+    }
+    save() {
+        const write = this.saving.catch(() => { }).then(async () => {
+            const data = JSON.stringify({ version: 1, jobs: this.jobs });
+            if (Buffer.byteLength(data) > 16 * 1024 * 1024)
+                throw new Error('state too large');
+            const temporary = join(this.options.directory, `.tasks-${randomUUID()}.tmp`);
+            const file = await open(temporary, 'wx', 0o600);
+            try {
+                await file.writeFile(data);
+                await file.sync();
+                await file.close();
+                await rename(temporary, join(this.options.directory, 'tasks.json'));
+                // Persist the rename as well as the JSON bytes before acknowledging a checkpoint.
+                let parent;
+                try {
+                    parent = await open(this.options.directory, constants.O_RDONLY);
+                    await parent.sync();
+                }
+                catch (error) {
+                    if (process.platform !== 'win32' || !['EPERM', 'EISDIR', 'EINVAL', 'ENOTSUP'].includes(error.code ?? ''))
+                        throw error;
+                }
+                finally {
+                    await parent?.close();
+                }
+            }
+            finally {
+                await file.close().catch(() => { });
+                await rm(temporary, { force: true }).catch(() => { });
+            }
+        });
+        this.saving = write;
+        return write;
+    }
+    close() {
+        if (this.closed)
+            return this.closed;
+        this.closing = true;
+        this.closed = (async () => {
+            try {
+                for (const job of this.jobs)
+                    if (job.status === 'queued')
+                        job.status = 'paused';
+                for (const active of this.active.values())
+                    active.controller.abort();
+                await Promise.allSettled([...this.active.values()].map(a => a.done));
+                await Promise.allSettled([...this.actions.values()]);
+                await this.save();
+            }
+            finally {
+                await this.unlock();
+            }
+        })();
+        return this.closed;
+    }
+    async unlock() {
+        if (!this.lock)
+            return;
+        const lock = this.lock;
+        this.lock = undefined;
+        try {
+            const owned = await lock.stat(), current = await lstat(join(this.options.directory, 'queue.lock'));
+            if (owned.ino === current.ino && owned.dev === current.dev)
+                await rm(join(this.options.directory, 'queue.lock'));
+        }
+        finally {
+            await lock.close();
+        }
+    }
+}
+//# sourceMappingURL=transfer-queue.js.map

package/dist/oss/transfer-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-queue.js","sourceRoot":"","sources":["../../src/oss/transfer-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAoB,MAAM,qBAAqB,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AACtD,MAAM,UAAU,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC9C,CAAC,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAC,MAAM,EAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAC,UAAU,EAAC,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE;IAC5O,CAAC,CAAC,MAAM,CAAC,EAAC,IAAI,EAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAC,QAAQ,EAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,IAAI,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC,KAAK,EAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC,OAAO,EAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,OAAO,EAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,UAAU,EAAC,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE;CAC9P,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAC,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAC,UAAU,CAAC,CAAC,EAAC,OAAO,EAAC,OAAO,CAAC,QAAQ,EAAE,EAAC,GAAG,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACjJ,SAAS,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC,SAAS,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC,IAAI,EAAC,OAAO,EAAC,WAAW,EAAC,OAAO,EAAC,OAAO,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAC1I,MAAM,EAAC,CAAC,CAAC,MAAM,CAAC,EAAC,GAAG,EAAC,OAAO,EAAC,GAAG,EAAC,OAAO,EAAC,IAAI,EAAC,OAAO,EAAC,OAAO,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAC,UAAU,EAAC,UAAU,CAAC,QAAQ,EAAE;IACxI,MAAM,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAC,SAAS,EAAC,SAAS,EAAC,QAAQ,EAAC,YAAY,EAAC,WAAW,EAAC,WAAW,EAAC,QAAQ,CAAC,CAAC,EAAC,SAAS,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CAC3M,CAAC,CAAC,MAAM,EAAE,CAAC;AACZ,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAC,OAAO,EAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGjG,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAyB;QACrC,iBAAiB,EAAC,cAAc,EAAE,kBAAkB,EAAC,kBAAkB;QACvE,kBAAkB,EAAC,mBAAmB,EAAE,gBAAgB,EAAC,gBAAgB;QACzE,sBAAsB,EAAC,oBAAoB,EAAE,2BAA2B,EAAC,mBAAmB;QAC5F,4BAA4B,EAAC,0BAA0B;QACvD,uBAAuB,EAAC,mBAAmB,EAAE,sBAAsB,EAAC,oBAAoB;QACxF,qBAAqB,EAAC,oBAAoB,EAAE,uBAAuB,EAAC,aAAa;QACjF,mBAAmB,EAAC,qBAAqB,EAAE,mBAAmB,EAAC,eAAe;KAC/E,CAAC;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC;AACpD,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAA4B;IACpE,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAAC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IAAC,OAAO,KAAK,CAAC;AACnF,CAAC;AACD,MAAM,OAAO,aAAa;IAWJ,OAAO;IAVnB,IAAI,GAAiB,EAAE,CAAC;IACf,MAAM,GAAG,IAAI,GAAG,EAAwF,CAAC;IACzG,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IACnD,MAAM,GAAiB,OAAO,CAAC,OAAO,EAAE,CAAC;IACzC,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,CAAgB;IACtB,IAAI,CAAmC;IACvC,MAAM,CAAgB;IACtB,OAAO,CAAQ;IACf,YAAY,GAAG,KAAK,CAAC;IAC7B,YAAoB,OAA4B;uBAA5B,OAAO;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;QAClG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,EAAE;YAAE,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,mBAAmB,EAAC,GAAG,CAAC,CAAC;IACnJ,CAAC;IACD,KAAK,CAAC,UAAU;QACd,MAAM,SAAS,GAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QACvC,MAAM,KAAK,CAAC,SAAS,EAAC,EAAC,SAAS,EAAC,IAAI,EAAC,IAAI,EAAC,KAAK,EAAC,CAAC,CAAC;QACnD,MAAM,IAAI,GAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QAAA,IAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAE,IAAI,CAAC,cAAc,EAAE;YAAC,MAAM,IAAI,QAAQ,CAAC,SAAS,EAAC,8BAA8B,CAAC,CAAC;QAC7I,MAAM,KAAK,CAAC,SAAS,EAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAC,IAAI,CAAC,SAAS,EAAC,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC;YAAC,IAAI,CAAC,IAAI,GAAC,MAAM,IAAI,CAAC,IAAI,EAAC,IAAI,EAAC,KAAK,CAAC,CAAC;QAAC,CAAC;QAC9C,OAAM,KAAK,EAAE,CAAC;YACZ,IAAK,KAA+B,CAAC,IAAI,KAAG,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAClE,wEAAwE;YACxE,0DAA0D;YAC1D,MAAM,YAAY,GAAC,IAAI,CAAC,SAAS,EAAC,qBAAqB,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAC,MAAM,IAAI,CAAC,YAAY,EAAC,IAAI,EAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAE,EAAE,GAAC,MAAM,IAAI,QAAQ,CAAC,8BAA8B,EAAC,yBAAyB,EAAC,GAAG,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;YAClJ,IAAI,CAAC;gBACL,MAAM,QAAQ,GAAC,MAAM,IAAI,CAAC,IAAI,EAAC,SAAS,CAAC,QAAQ,GAAC,SAAS,CAAC,UAAU,CAAC,CAAC;gBACxE,IAAI,QAAQ,CAAC;gBACb,IAAI,CAAC;oBACH,QAAQ,GAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAAA,IAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAE,QAAQ,CAAC,IAAI,GAAC,GAAG;wBAAC,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;oBACxG,MAAM,GAAG,GAAC,MAAM,CAAC,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC3D,IAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAE,GAAG,IAAE,CAAC;wBAAC,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAC,8BAA8B,CAAC,CAAC;oBAC9G,IAAI,KAAK,GAAC,IAAI,CAAC;oBAAA,IAAG,CAAC;wBAAA,OAAO,CAAC,IAAI,CAAC,GAAG,EAAC,CAAC,CAAC,CAAC;oBAAA,CAAC;oBAAA,OAAM,CAAC,EAAC,CAAC;wBAAA,IAAI,CAA2B,CAAC,IAAI,KAAG,OAAO;4BAAC,KAAK,GAAC,KAAK,CAAC;oBAAA,CAAC;oBAC7G,IAAG,KAAK;wBAAC,MAAM,IAAI,QAAQ,CAAC,oBAAoB,GAAG,gBAAgB,EAAC,yBAAyB,EAAC,GAAG,CAAC,CAAC;gBACrG,CAAC;wBAAS,CAAC;oBAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;gBACrC,MAAM,OAAO,GAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;gBAAA,IAAG,OAAO,CAAC,GAAG,KAAG,QAAQ,CAAC,GAAG,IAAE,OAAO,CAAC,GAAG,KAAG,QAAQ,CAAC,GAAG;oBAAC,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAC,yBAAyB,EAAC,GAAG,CAAC,CAAC;gBACxJ,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;gBAAA,IAAI,CAAC,IAAI,GAAC,MAAM,IAAI,CAAC,IAAI,EAAC,IAAI,EAAC,KAAK,CAAC,CAAC;YACrD,CAAC;oBAAS,CAAC;gBAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAAA,MAAM,EAAE,CAAC,YAAY,EAAC,EAAC,KAAK,EAAC,IAAI,EAAC,CAAC,CAAC;YAAA,CAAC;QACzE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAAA,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACtE,MAAM,SAAS,GAAC,IAAI,CAAC,SAAS,EAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAC,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA,EAAE,GAAC,IAAG,CAAC,CAAC,IAAI,KAAG,QAAQ;gBAAC,OAAO,SAAS,CAAC,CAAA,MAAM,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC;YAC7F,IAAG,IAAI,EAAE,CAAC;gBACR,IAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAE,IAAI,CAAC,cAAc,EAAE,IAAE,IAAI,CAAC,IAAI,GAAC,EAAE,GAAC,IAAI,GAAC,IAAI;oBAAC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBACvG,MAAM,KAAK,GAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC5E,MAAM,IAAI,GAAC,IAAI,GAAG,EAAU,CAAC;gBAC7B,KAAI,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC5B,MAAM,GAAG,GAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAChD,IAAG,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAE,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAE,CAAC,GAAG,IAAE,GAAG,KAAG,IAAI,IAAE,GAAG,CAAC,UAAU,CAAC,IAAI,GAAC,GAAG,CAAC,IAAE,UAAU,CAAC,GAAG,CAAC,IAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBAAC,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;oBAC7K,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBACjB,IAAG,CAAC,QAAQ,EAAC,SAAS,EAAC,SAAS,EAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;wBAAC,GAAG,CAAC,MAAM,GAAC,QAAQ,CAAC;gBAC1F,CAAC;gBACD,IAAI,CAAC,IAAI,GAAC,KAAK,CAAC,IAAI,CAAC;YACvB,CAAC;YACD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAAC,OAAM,KAAK,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,IAAG,KAAK,YAAY,QAAQ;gBAAC,MAAM,KAAK,CAAC;YACzC,MAAM,IAAI,QAAQ,CAAC,wBAAwB,EAAC,8BAA8B,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA,EAAE;YACxB,MAAM,EAAC,UAAU,EAAC,WAAW,EAAC,OAAO,EAAC,QAAQ,EAAC,MAAM,EAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAC,GAAG,IAAI,EAAC,GAAC,GAAG,CAAC;YAC3F,MAAM,MAAM,GAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrC,MAAM,cAAc,GAAC,MAAM,IAAE,GAAG,CAAC,MAAM,KAAG,SAAS,CAAA,CAAC,CAAA,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,CAAC,GAAG,CAAC,WAAW,GAAC,MAAM,CAAC,OAAO,CAAC,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAC,MAAM,CAAC,OAAO,CAAC,GAAC,IAAI,CAAC,CAAC,CAAA,CAAC,CAAA,CAAC,CAAC;YAChJ,OAAO,EAAC,GAAG,IAAI,EAAC,cAAc,EAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,SAAkC,EAAC,OAAqB,EAAC,KAAmB;QACpF,IAAG,IAAI,CAAC,OAAO,IAAE,IAAI,CAAC,YAAY;YAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAC,8BAA8B,CAAC,CAAC;QACjG,MAAM,OAAO,GAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,WAAW,EAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACjF,IAAG,CAAC,KAAK,CAAC,MAAM,IAAE,OAAO,CAAC,MAAM,GAAC,KAAK,CAAC,MAAM,GAAC,KAAK;YAAC,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAC,oBAAoB,EAAC,GAAG,CAAC,CAAC;QAChH,MAAM,OAAO,GAAC,eAAe,CAAC,OAAO,CAAC,EAAC,IAAI,GAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrE,MAAM,SAAS,GAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAA,EAAE,CAAA,SAAS,CAAC,KAAK,CAAC,EAAC,GAAG,IAAI,EAAC,EAAE,EAAC,UAAU,EAAE,EAAC,SAAS,EAAC,OAAO,EAAC,OAAO,CAAC,OAAO,EAAC,OAAO,EAAC,WAAW,EAAC,CAAC,EAAC,MAAM,EAAC,QAAQ,EAAC,SAAS,EAAC,IAAI,EAAC,SAAS,EAAC,IAAI,EAAC,CAAC,CAAC,CAAC;QAClL,KAAI,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC3B,IAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAA,EAAE,CAAA,KAAK,CAAC,SAAS,KAAG,SAAS,IAAE,CAAC,SAAS,KAAG,UAAU,CAAA,CAAC,CAAA,KAAK,CAAC,SAAS,KAAG,GAAG,CAAC,SAAS,CAAA,CAAC,CAAA,KAAK,CAAC,OAAO,KAAG,GAAG,CAAC,OAAO,IAAE,KAAK,CAAC,GAAG,KAAG,GAAG,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAC,wBAAwB,EAAC,GAAG,CAAC,CAAC;YAC/N,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,MAAM,GAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAC,SAAS,CAAC,MAAM,GAAC,KAAK,CAAC;QACnD,IAAI,CAAC,IAAI,GAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAA,EAAE,GAAC,IAAG,MAAM,GAAC,CAAC,IAAE,CAAC,WAAW,EAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAC,CAAC;YAAA,MAAM,EAAE,CAAC;YAAA,OAAO,KAAK,CAAC;QAAA,CAAC,CAAA,OAAO,IAAI,CAAC,CAAA,CAAC,CAAC,CAAC;QACpI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAAA,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAAA,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/D,MAAM,GAAG,GAAC,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAAA,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA,EAAE,CAAA,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IACO,OAAO,CAAC,GAAe,EAAC,UAA0B;QACxD,OAAO,EAAC,MAAM,EAAC,UAAU,CAAC,MAAM,EAAC,OAAO,EAAC,KAAK,IAAE,EAAE;gBAChD,MAAM,OAAO,GAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACtD,IAAG,eAAe,CAAC,OAAO,CAAC,KAAG,GAAG,CAAC,OAAO;oBAAC,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAC,8BAA8B,CAAC,CAAC;gBAC/G,OAAO,OAAO,CAAC;YACjB,CAAC,EAAC,IAAI,EAAC,GAAE,EAAE,CAAA,IAAI,CAAC,IAAI,EAAE,EAAC,QAAQ,EAAC,KAAK,CAAA,EAAE,GAAC,IAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAC,CAAC;gBAAA,GAAG,CAAC,WAAW,GAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAC,KAAK,CAAC,CAAC,CAAC;gBAAA,GAAG,CAAC,SAAS,GAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAAA,CAAC,CAAA,CAAC,EAAC,CAAC;IACrK,CAAC;IACO,QAAQ;QACd,IAAG,IAAI,CAAC,OAAO,IAAE,IAAI,CAAC,YAAY;YAAC,OAAO;QAC1C,KAAI,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3B,IAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAE,IAAI,CAAC,OAAO;gBAAC,MAAM;YACxC,IAAG,GAAG,CAAC,MAAM,KAAG,QAAQ;gBAAC,SAAS;YAClC,MAAM,UAAU,GAAC,IAAI,eAAe,EAAE,CAAC;YAAA,GAAG,CAAC,MAAM,GAAC,SAAS,CAAC;YAAA,OAAO,GAAG,CAAC,KAAK,CAAC;YAC7E,MAAM,MAAM,GAAC,EAAC,UAAU,EAAC,IAAI,EAAC,OAAO,CAAC,OAAO,EAAE,EAAC,OAAO,EAAC,IAAI,CAAC,GAAG,EAAE,EAAC,OAAO,EAAC,GAAG,CAAC,WAAW,EAAC,CAAC;YAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAC,MAAM,CAAC,CAAC;YAC3H,MAAM,CAAC,IAAI,GAAC,CAAC,KAAK,IAAE,EAAE;gBACpB,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;oBAAA,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAC,UAAU,CAAC,CAAC,CAAC;oBAC1E,4EAA4E;oBAC5E,GAAG,CAAC,MAAM,GAAC,WAAW,CAAC;oBAAA,GAAG,CAAC,WAAW,GAAC,GAAG,CAAC,IAAI,CAAC;oBAAA,OAAO,GAAG,CAAC,UAAU,CAAC;gBACxE,CAAC;gBAAC,OAAM,KAAK,EAAE,CAAC;oBACd,IAAG,UAAU,CAAC,MAAM,CAAC,OAAO;wBAAC,GAAG,CAAC,MAAM,GAAC,QAAQ,CAAC;yBAAI,CAAC;wBAAA,GAAG,CAAC,MAAM,GAAC,QAAQ,CAAC;wBAAA,GAAG,CAAC,KAAK,GAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBAAA,CAAC;gBACxG,CAAC;wBAAS,CAAC;oBACT,GAAG,CAAC,SAAS,GAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBACvC,IAAG,CAAC;wBAAA,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;oBAAA,CAAC;oBAAA,MAAK,CAAC;wBAAA,IAAI,CAAC,YAAY,GAAC,IAAI,CAAC;oBAAA,CAAC;oBACrD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAAA,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7C,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;IACH,CAAC;IACD,MAAM,CAAC,EAAS,EAAC,MAAa;QAC5B,MAAM,QAAQ,GAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACvD,MAAM,IAAI,GAAC,QAAQ,CAAC,KAAK,CAAC,GAAE,EAAE,GAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAE,EAAE,CAAA,IAAI,CAAC,aAAa,CAAC,EAAE,EAAC,MAAM,CAAC,CAAC,CAAC;QAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAC,IAAI,CAAC,CAAC;QACpG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAE,EAAE,GAAC,IAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAG,IAAI;YAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA,CAAC,CAAC,CAAC,KAAK,CAAC,GAAE,EAAE,GAAC,CAAC,CAAC,CAAC;QAAA,OAAO,IAAI,CAAC;IAC7G,CAAC;IACO,KAAK,CAAC,aAAa,CAAC,EAAS,EAAC,MAAa;QACjD,IAAG,IAAI,CAAC,OAAO;YAAC,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAC,8BAA8B,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,EAAE,KAAG,EAAE,CAAC,CAAC;QAAA,IAAG,CAAC,GAAG;YAAC,MAAM,IAAI,QAAQ,CAAC,QAAQ,EAAC,mBAAmB,EAAC,GAAG,CAAC,CAAC;QACpG,IAAG,CAAC,WAAW,EAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YAAC,OAAO;QACzD,IAAG,MAAM,KAAG,QAAQ,EAAE,CAAC;YACrB,IAAG,CAAC,CAAC,QAAQ,EAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAC,OAAO;YACpD,IAAG,IAAI,CAAC,YAAY;gBAAC,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAC,8BAA8B,CAAC,CAAC;YACpF,GAAG,CAAC,MAAM,GAAC,QAAQ,CAAC;YAAA,OAAO,GAAG,CAAC,KAAK,CAAC;YAAA,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAAA,IAAI,CAAC,QAAQ,EAAE,CAAC;YAAA,OAAO;QAChF,CAAC;QACD,MAAM,MAAM,GAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,GAAG,CAAC,MAAM,GAAC,MAAM,KAAG,OAAO,CAAA,CAAC,CAAA,SAAS,CAAA,CAAC,CAAA,YAAY,CAAC;QAAA,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;QAC9E,IAAG,MAAM;YAAC,MAAM,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,GAAmB,CAAC,MAAM,KAAG,WAAW;YAAC,OAAO;QACpD,IAAG,MAAM,KAAG,QAAQ,EAAE,CAAC;YACrB,IAAG,CAAC;gBAAA,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC;gBAAA,IAAI,GAAmB,CAAC,MAAM,KAAG,WAAW;oBAAC,GAAG,CAAC,MAAM,GAAC,WAAW,CAAC;gBAAA,OAAO,GAAG,CAAC,UAAU,CAAC;gBAAA,OAAO,GAAG,CAAC,KAAK,CAAC;YAAA,CAAC;YACtL,OAAM,KAAK,EAAC,CAAC;gBAAA,GAAG,CAAC,MAAM,GAAC,QAAQ,CAAC;gBAAA,GAAG,CAAC,KAAK,GAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAAA,CAAC;QAC/D,CAAC;;YAAK,GAAG,CAAC,MAAM,GAAC,QAAQ,CAAC;QAC1B,GAAG,CAAC,SAAS,GAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAAA,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IACO,IAAI;QACV,MAAM,KAAK,GAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAE,EAAE,GAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAE,EAAE;YAClD,MAAM,IAAI,GAAC,IAAI,CAAC,SAAS,CAAC,EAAC,OAAO,EAAC,CAAC,EAAC,IAAI,EAAC,IAAI,CAAC,IAAI,EAAC,CAAC,CAAC;YACtD,IAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAC,EAAE,GAAC,IAAI,GAAC,IAAI;gBAAC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC3E,MAAM,SAAS,GAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAC,UAAU,UAAU,EAAE,MAAM,CAAC,CAAC;YAC1E,MAAM,IAAI,GAAC,MAAM,IAAI,CAAC,SAAS,EAAC,IAAI,EAAC,KAAK,CAAC,CAAC;YAC5C,IAAG,CAAC;gBAAA,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAAA,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAA,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBAAA,MAAM,MAAM,CAAC,SAAS,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAC,YAAY,CAAC,CAAC,CAAC;gBACpI,kFAAkF;gBAClF,IAAI,MAAiD,CAAC;gBACtD,IAAG,CAAC;oBAAA,MAAM,GAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;oBAAA,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAAA,CAAC;gBACtF,OAAM,KAAK,EAAC,CAAC;oBAAA,IAAG,OAAO,CAAC,QAAQ,KAAG,OAAO,IAAE,CAAC,CAAC,OAAO,EAAC,QAAQ,EAAC,QAAQ,EAAC,SAAS,CAAC,CAAC,QAAQ,CAAE,KAA+B,CAAC,IAAI,IAAE,EAAE,CAAC;wBAAC,MAAM,KAAK,CAAC;gBAAA,CAAC;wBAC7I,CAAC;oBAAA,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;gBAAA,CAAC;YACjC,CAAC;oBACM,CAAC;gBAAA,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAE,EAAE,GAAC,CAAC,CAAC,CAAC;gBAAA,MAAM,EAAE,CAAC,SAAS,EAAC,EAAC,KAAK,EAAC,IAAI,EAAC,CAAC,CAAC,KAAK,CAAC,GAAE,EAAE,GAAC,CAAC,CAAC,CAAC;YAAA,CAAC;QAC3F,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAC,KAAK,CAAC;QAAA,OAAO,KAAK,CAAC;IACjC,CAAC;IACD,KAAK;QACH,IAAG,IAAI,CAAC,MAAM;YAAC,OAAO,IAAI,CAAC,MAAM,CAAC;QAAA,IAAI,CAAC,OAAO,GAAC,IAAI,CAAC;QACpD,IAAI,CAAC,MAAM,GAAC,CAAC,KAAK,IAAE,EAAE;YACpB,IAAI,CAAC;gBACH,KAAI,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI;oBAAC,IAAG,GAAG,CAAC,MAAM,KAAG,QAAQ;wBAAC,GAAG,CAAC,MAAM,GAAC,QAAQ,CAAC;gBACxE,KAAI,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;oBAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA,EAAE,CAAA,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACnE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAAA,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACzE,CAAC;oBAAO,CAAC;gBAAA,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;YAAA,CAAC;QAChC,CAAC,CAAC,EAAE,CAAC;QAAA,OAAO,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IACO,KAAK,CAAC,MAAM;QAClB,IAAG,CAAC,IAAI,CAAC,IAAI;YAAC,OAAO;QACrB,MAAM,IAAI,GAAC,IAAI,CAAC,IAAI,CAAC;QAAA,IAAI,CAAC,IAAI,GAAC,SAAS,CAAC;QACzC,IAAI,CAAC;YAAA,MAAM,KAAK,GAAC,MAAM,IAAI,CAAC,IAAI,EAAE,EAAC,OAAO,GAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAC,YAAY,CAAC,CAAC,CAAC;YAChG,IAAG,KAAK,CAAC,GAAG,KAAG,OAAO,CAAC,GAAG,IAAE,KAAK,CAAC,GAAG,KAAG,OAAO,CAAC,GAAG;gBAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAC,YAAY,CAAC,CAAC,CAAC;QAC1G,CAAC;gBAAO,CAAC;YAAA,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAAA,CAAC;IAC/B,CAAC;CACF"}

package/dist/oss/transfer-types.d.ts

@@ -0,0 +1,54 @@
+import type { AccessSession } from './schemas.js';
+export type TransferStatus = 'queued' | 'running' | 'pausing' | 'paused' | 'cancelling' | 'cancelled' | 'completed' | 'failed';
+export interface LocalFileIdentity {
+    dev: number;
+    ino: number;
+    size: number;
+    mtimeMs: number;
+}
+export type TransferCheckpoint = {
+    kind: 'upload';
+    uploadId: string;
+    partSize: number;
+    parts: {
+        number: number;
+        etag: string;
+    }[];
+    committing?: boolean;
+} | {
+    kind: 'download';
+    partSize: number;
+    etag: string;
+    parts: number[];
+    tempPath: string;
+    tempDev?: number;
+    tempIno?: number;
+    committing?: boolean;
+};
+export interface TransferJob {
+    id: string;
+    direction: 'upload' | 'download';
+    grantId: number;
+    key: string;
+    localPath: string;
+    localRoot: string;
+    size: number;
+    transferred: number;
+    binding: string;
+    source?: LocalFileIdentity;
+    checkpoint?: TransferCheckpoint;
+    status: TransferStatus;
+    createdAt: string;
+    updatedAt: string;
+    error?: string;
+}
+export interface TransferContext {
+    session(): Promise<AccessSession>;
+    signal: AbortSignal;
+    save(): Promise<void>;
+    progress(bytes: number): void;
+}
+export interface TransferWorker {
+    run(job: TransferJob, context: TransferContext): Promise<void>;
+    cancel(job: TransferJob, context: TransferContext): Promise<void>;
+}

package/dist/oss/transfer-types.js

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

package/dist/oss/transfer-types.js.map

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

package/dist/oss/transfer-worker.d.ts

@@ -0,0 +1,3 @@
+import { type OssTransferDependencies } from './transfers.js';
+import type { TransferWorker } from './transfer-types.js';
+export declare function createTransferWorker({ clientFactory }?: OssTransferDependencies): TransferWorker;