@numa-tech/numa 1.17.1 → 1.19.0

package/dist/oss/transfer-worker.js

@@ -0,0 +1,415 @@
+import { constants } from 'node:fs';
+import { open, lstat, mkdir, link, unlink } from 'node:fs/promises';
+import { dirname, basename, resolve, relative, isAbsolute, join, parse } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { Readable } from 'node:stream';
+import OSS from 'ali-oss';
+import { OssError } from './errors.js';
+import { ossTransferOptions } from './transfers.js';
+const PART = 8 * 1024 * 1024;
+const fail = (message, code = 'oss_transfer_failed') => new OssError(message, code);
+function check(ctx) { if (ctx.signal.aborted)
+    throw fail('Transfer paused.', 'oss_transfer_paused'); }
+function same(a, b) { return a.dev === b.dev && a.ino === b.ino && a.size === b.size && a.mtimeMs === b.mtimeMs; }
+function code(error) { return error?.code; }
+function headers(res) { return Object.fromEntries(Object.entries(res?.headers ?? {}).map(([k, v]) => [k.toLowerCase(), String(v)])); }
+/** Reject symlinks in every component, including ancestors of the chosen root. */
+async function safePath(job, createParents = false) {
+    const root = resolve(job.localRoot), path = resolve(job.localPath), rel = relative(root, path);
+    if (!isAbsolute(job.localRoot) || !isAbsolute(job.localPath) || !rel || rel === '..' || rel.startsWith(`..${parse(path).root === '/' ? '/' : '\\'}`) || isAbsolute(rel))
+        throw fail('Local path is outside the selected directory.', 'oss_path_invalid');
+    let current = parse(path).root;
+    const components = relative(current, path).split(/[\\/]/u);
+    for (let i = 0; i < components.length; i++) {
+        current = join(current, components[i]);
+        let st;
+        try {
+            st = await lstat(current);
+        }
+        catch (e) {
+            if (code(e) !== 'ENOENT')
+                throw e;
+            if (i === components.length - 1)
+                return;
+            if (!createParents)
+                throw fail('Local parent directory is missing.', 'oss_path_invalid');
+            try {
+                await mkdir(current, { mode: 0o700 });
+            }
+            catch (mkdirError) {
+                if (code(mkdirError) !== 'EEXIST')
+                    throw mkdirError;
+            }
+            st = await lstat(current);
+        }
+        if (st.isSymbolicLink())
+            throw fail('Local path contains a symbolic link.', 'oss_path_invalid');
+        if (i < components.length - 1 && !st.isDirectory())
+            throw fail('Local parent is not a directory.', 'oss_path_invalid');
+    }
+}
+function validateCheckpoint(job) {
+    const cp = job.checkpoint;
+    if (!cp)
+        return;
+    if (cp.kind !== job.direction || !Number.isSafeInteger(cp.partSize) || cp.partSize < 100 * 1024 || cp.partSize > 5 * 1024 ** 3 || !Array.isArray(cp.parts))
+        throw fail('Invalid transfer checkpoint.', 'oss_checkpoint_invalid');
+    const count = Math.ceil(job.size / cp.partSize);
+    if (count > 10000)
+        throw fail('Invalid transfer checkpoint.', 'oss_checkpoint_invalid');
+    const numbers = cp.kind === 'upload' ? cp.parts.map(p => p.number - 1) : cp.parts;
+    if (new Set(numbers).size !== numbers.length || numbers.some(n => !Number.isInteger(n) || n < 0 || n >= count)
+        || (cp.kind === 'upload' && (typeof cp.uploadId !== 'string' || (job.size > 0 && !cp.uploadId) || cp.parts.some(p => typeof p.etag !== 'string' || !p.etag)))
+        || (cp.kind === 'download' && (typeof cp.etag !== 'string' || !cp.etag)))
+        throw fail('Invalid transfer checkpoint.', 'oss_checkpoint_invalid');
+}
+async function syncDirectory(path) {
+    let directory;
+    try {
+        directory = await open(path, constants.O_RDONLY);
+        await directory.sync();
+    }
+    catch (e) {
+        if (process.platform !== 'win32' || !['EPERM', 'EISDIR', 'EINVAL', 'ENOTSUP'].includes(code(e) ?? ''))
+            throw e;
+    }
+    finally {
+        await directory?.close();
+    }
+}
+async function exists(path) { try {
+    return await lstat(path);
+}
+catch (e) {
+    if (code(e) === 'ENOENT')
+        return undefined;
+    throw e;
+} }
+async function concurrent(parts, ctx, work) {
+    let next = 0;
+    let failure;
+    await Promise.all(Array.from({ length: Math.min(3, parts.length) }, async () => {
+        while (!failure && !ctx.signal.aborted) {
+            const n = parts[next++];
+            if (n === undefined)
+                return;
+            try {
+                await work(n);
+            }
+            catch (e) {
+                failure ??= e;
+            }
+        }
+    }));
+    if (failure)
+        throw failure;
+    check(ctx);
+}
+async function retry(ctx, operation) {
+    for (let attempt = 0;; attempt++) {
+        check(ctx);
+        try {
+            return await operation();
+        }
+        catch (e) {
+            check(ctx);
+            const status = e?.status;
+            if (e instanceof OssError || attempt >= 2 || !(status === 429 || (status !== undefined && status >= 500) || ['ECONNRESET', 'ETIMEDOUT', 'EPIPE'].includes(code(e) ?? '')))
+                throw e;
+        }
+    }
+}
+function bindAbort(ctx, stream) {
+    const abort = () => stream.destroy(fail('Transfer paused.', 'oss_transfer_paused'));
+    stream.on('error', () => undefined);
+    ctx.signal.addEventListener('abort', abort, { once: true });
+    if (ctx.signal.aborted)
+        abort();
+    return () => ctx.signal.removeEventListener('abort', abort);
+}
+export function createTransferWorker({ clientFactory = options => new OSS(options) } = {}) {
+    async function client(job, ctx, operation, allowAborted = false) {
+        if (!allowAborted)
+            check(ctx);
+        const scoped = ossTransferOptions(await ctx.session(), job.key, operation);
+        if (!allowAborted)
+            check(ctx);
+        return clientFactory(scoped.options);
+    }
+    async function upload(job, ctx) {
+        await safePath(job);
+        const file = await open(job.localPath, constants.O_RDONLY | constants.O_NOFOLLOW);
+        try {
+            const verify = async () => { await safePath(job); const st = await file.stat(); const current = await lstat(job.localPath); if (!st.isFile() || !job.source || !same(st, job.source) || !same(current, job.source) || st.size !== job.size)
+                throw fail('Upload source changed.', 'oss_source_changed'); };
+            await verify();
+            if (job.checkpoint && job.checkpoint.kind !== 'upload')
+                throw fail('Invalid transfer checkpoint.');
+            let cp = job.checkpoint;
+            if (cp?.committing) {
+                try {
+                    const head = await (await client(job, ctx, 'read')).head(job.key);
+                    const h = headers(head.res);
+                    if ((head.meta?.['numa-transfer-id'] ?? h['x-oss-meta-numa-transfer-id']) === job.id && Number(h['content-length']) === job.size) {
+                        ctx.progress(job.size);
+                        return;
+                    }
+                    throw fail('Destination already exists.', 'oss_output_exists');
+                }
+                catch (e) {
+                    if (e.status !== 404)
+                        throw e;
+                }
+            }
+            if (!cp) {
+                const partSize = Math.max(PART, Math.ceil(job.size / 10000));
+                if (partSize > 5 * 1024 ** 3)
+                    throw fail('Upload exceeds the multipart size limit.', 'oss_input_invalid');
+                const uploadId = job.size ? (await (await client(job, ctx, 'write')).initMultipartUpload(job.key, { headers: { 'x-oss-meta-numa-transfer-id': job.id } })).uploadId : '';
+                cp = { kind: 'upload', uploadId, partSize, parts: [] };
+                job.checkpoint = cp;
+                await ctx.save();
+            }
+            const checkpoint = cp;
+            const count = Math.ceil(job.size / cp.partSize);
+            const progress = () => ctx.progress(checkpoint.parts.reduce((sum, p) => sum + Math.min(checkpoint.partSize, job.size - (p.number - 1) * checkpoint.partSize), 0));
+            progress();
+            await concurrent(Array.from({ length: count }, (_, i) => i + 1).filter(n => !checkpoint.parts.some(p => p.number === n)), ctx, async (n) => {
+                const result = await retry(ctx, async () => {
+                    await verify();
+                    const sdk = await client(job, ctx, 'write');
+                    const start = (n - 1) * checkpoint.partSize, end = Math.min(job.size, start + checkpoint.partSize);
+                    const stream = Readable.from((async function* () { let position = start; while (position < end) {
+                        check(ctx);
+                        const buffer = Buffer.alloc(Math.min(256 * 1024, end - position));
+                        const { bytesRead } = await file.read(buffer, 0, buffer.length, position);
+                        if (!bytesRead)
+                            throw fail('Upload source changed.', 'oss_source_changed');
+                        position += bytesRead;
+                        yield buffer.subarray(0, bytesRead);
+                    } })());
+                    const cleanup = bindAbort(ctx, stream);
+                    try {
+                        return await sdk.uploadPart(job.key, checkpoint.uploadId, n, stream, start, end);
+                    }
+                    finally {
+                        cleanup();
+                        stream.destroy();
+                    }
+                });
+                if (!result.etag)
+                    throw fail('OSS returned no part ETag.');
+                checkpoint.parts.push({ number: n, etag: result.etag });
+                await ctx.save();
+                progress();
+            });
+            await verify();
+            check(ctx);
+            checkpoint.committing = true;
+            await ctx.save();
+            const sdk = await client(job, ctx, 'write');
+            if (job.size === 0)
+                await sdk.put(job.key, Buffer.alloc(0), { headers: { 'x-oss-meta-numa-transfer-id': job.id, 'x-oss-forbid-overwrite': 'true' } });
+            else
+                await sdk.completeMultipartUpload(job.key, checkpoint.uploadId, checkpoint.parts, { headers: { 'x-oss-forbid-overwrite': 'true' } });
+            ctx.progress(job.size);
+        }
+        finally {
+            await file.close();
+        }
+    }
+    async function ownedTemp(job) {
+        const cp = job.checkpoint;
+        if (cp?.kind !== 'download' || dirname(cp.tempPath) !== dirname(job.localPath) || !/^\.numa-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.part$/u.test(basename(cp.tempPath)) || cp.tempDev === undefined || cp.tempIno === undefined)
+            throw fail('Invalid download temporary file.', 'oss_path_invalid');
+        await safePath(job);
+        const f = await open(cp.tempPath, constants.O_RDWR | constants.O_NOFOLLOW);
+        const st = await f.stat();
+        if (!st.isFile() || st.dev !== cp.tempDev || st.ino !== cp.tempIno || st.size !== job.size) {
+            await f.close();
+            throw fail('Download temporary file changed.', 'oss_source_changed');
+        }
+        return f;
+    }
+    async function download(job, ctx) {
+        await safePath(job, true);
+        if (job.checkpoint && job.checkpoint.kind !== 'download')
+            throw fail('Invalid transfer checkpoint.');
+        let cp = job.checkpoint;
+        const destination = await exists(job.localPath);
+        if (destination) {
+            if (cp?.committing && destination.dev === cp.tempDev && destination.ino === cp.tempIno && destination.size === job.size) {
+                await cleanupTemp(job);
+                ctx.progress(job.size);
+                return;
+            }
+            throw fail('Destination already exists.', 'oss_output_exists');
+        }
+        const head = await (await client(job, ctx, 'read')).head(job.key);
+        const h = headers(head.res);
+        if (!h.etag || Number(h['content-length']) !== job.size || (cp && cp.etag !== h.etag))
+            throw fail('Remote object changed.', 'oss_remote_changed');
+        let file;
+        if (!cp) {
+            const tempPath = join(dirname(job.localPath), `.numa-${randomUUID()}.part`);
+            file = await open(tempPath, constants.O_RDWR | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
+            try {
+                await file.truncate(job.size);
+                await file.sync();
+                await syncDirectory(dirname(tempPath));
+                const st = await file.stat();
+                cp = { kind: 'download', partSize: Math.max(PART, Math.ceil(job.size / 10000)), etag: h.etag, parts: [], tempPath, tempDev: st.dev, tempIno: st.ino };
+                job.checkpoint = cp;
+                await ctx.save();
+            }
+            catch (e) {
+                await file.close();
+                throw e;
+            }
+        }
+        else
+            file = await ownedTemp(job);
+        const checkpoint = cp;
+        try {
+            const progress = () => ctx.progress(checkpoint.parts.reduce((sum, n) => sum + Math.min(checkpoint.partSize, job.size - n * checkpoint.partSize), 0));
+            progress();
+            await concurrent(Array.from({ length: Math.ceil(job.size / checkpoint.partSize) }, (_, i) => i).filter(n => !checkpoint.parts.includes(n)), ctx, async (n) => {
+                await retry(ctx, async () => {
+                    const start = n * checkpoint.partSize, end = Math.min(job.size, start + checkpoint.partSize) - 1;
+                    const result = await (await client(job, ctx, 'read')).getStream(job.key, { headers: { Range: `bytes=${start}-${end}`, 'If-Match': checkpoint.etag } });
+                    const stream = result.stream;
+                    const cleanup = bindAbort(ctx, stream);
+                    try {
+                        const rh = headers(result.res);
+                        if (result.res.status !== 206 || rh['content-range'] !== `bytes ${start}-${end}/${job.size}` || (rh.etag && rh.etag !== checkpoint.etag))
+                            throw fail('Remote object or byte range changed.', 'oss_remote_changed');
+                        let position = start;
+                        for await (const data of stream) {
+                            check(ctx);
+                            const chunk = Buffer.isBuffer(data) ? data : Buffer.from(data);
+                            if (position + chunk.length > end + 1)
+                                throw fail('Invalid download byte count.');
+                            let offset = 0;
+                            while (offset < chunk.length) {
+                                const { bytesWritten } = await file.write(chunk, offset, chunk.length - offset, position);
+                                if (!bytesWritten)
+                                    throw fail('Cannot write download file.');
+                                offset += bytesWritten;
+                                position += bytesWritten;
+                            }
+                        }
+                        if (position !== end + 1)
+                            throw fail('Incomplete download byte range.');
+                        await file.sync();
+                    }
+                    finally {
+                        cleanup();
+                        stream.destroy();
+                    }
+                });
+                checkpoint.parts.push(n);
+                await ctx.save();
+                progress();
+            });
+            check(ctx);
+            await safePath(job);
+            const identity = await lstat(checkpoint.tempPath);
+            if (identity.dev !== checkpoint.tempDev || identity.ino !== checkpoint.tempIno)
+                throw fail('Download temporary file changed.', 'oss_source_changed');
+            checkpoint.committing = true;
+            await ctx.save();
+            await file.sync();
+            await link(checkpoint.tempPath, job.localPath);
+            await syncDirectory(dirname(job.localPath));
+            await cleanupTemp(job);
+            ctx.progress(job.size);
+        }
+        finally {
+            await file.close();
+        }
+    }
+    async function cleanupTemp(job) {
+        const cp = job.checkpoint;
+        if (cp?.kind !== 'download')
+            return;
+        await safePath(job);
+        const st = await exists(cp.tempPath);
+        if (!st)
+            return;
+        const f = await ownedTemp(job);
+        await f.close();
+        await unlink(cp.tempPath);
+    }
+    return {
+        async run(job, ctx) { try {
+            check(ctx);
+            if (!Number.isSafeInteger(job.size) || job.size < 0)
+                throw fail('Invalid transfer size.', 'oss_input_invalid');
+            validateCheckpoint(job);
+            await (job.direction === 'upload' ? upload(job, ctx) : download(job, ctx));
+        }
+        catch (e) {
+            if (e instanceof OssError)
+                throw e;
+            if (code(e) === 'EEXIST' || e.status === 409)
+                throw fail('Destination already exists.', 'oss_output_exists');
+            if (e.status === 412)
+                throw fail('Remote object changed.', 'oss_remote_changed');
+            throw fail('OSS transfer failed. Retry or resume the transfer.');
+        } },
+        async cancel(job, ctx) {
+            try {
+                validateCheckpoint(job);
+                const cp = job.checkpoint;
+                if (cp?.kind === 'upload') {
+                    if (cp.committing) {
+                        let head;
+                        try {
+                            head = await (await client(job, ctx, 'read', true)).head(job.key);
+                        }
+                        catch (e) {
+                            if (e.status !== 404)
+                                throw e;
+                        }
+                        if (head) {
+                            const h = headers(head.res);
+                            if ((head.meta?.['numa-transfer-id'] ?? h['x-oss-meta-numa-transfer-id']) === job.id && Number(h['content-length']) === job.size) {
+                                job.status = 'completed';
+                                ctx.progress(job.size);
+                                return;
+                            }
+                        }
+                    }
+                    if (cp.uploadId) {
+                        try {
+                            await (await client(job, ctx, 'write', true)).abortMultipartUpload(job.key, cp.uploadId);
+                        }
+                        catch (e) {
+                            if (e.status !== 404)
+                                throw e;
+                        }
+                    }
+                }
+                else if (cp?.kind === 'download') {
+                    if (cp.committing) {
+                        await safePath(job);
+                        const final = await exists(job.localPath);
+                        if (final?.isFile() && final.dev === cp.tempDev && final.ino === cp.tempIno && final.size === job.size) {
+                            await cleanupTemp(job);
+                            job.status = 'completed';
+                            ctx.progress(job.size);
+                            return;
+                        }
+                    }
+                    await cleanupTemp(job);
+                }
+            }
+            catch (e) {
+                if (e instanceof OssError)
+                    throw e;
+                throw fail('Unable to clean up the cancelled transfer.', 'oss_transfer_cleanup_failed');
+            }
+        }
+    };
+}
+//# sourceMappingURL=transfer-worker.js.map

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

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

package/dist/oss/transfers.d.ts

@@ -1,3 +1,4 @@
+import { Readable } from "node:stream";
 import OSS from "ali-oss";
 import type { AccessSession } from "./schemas.js";
 export interface OssTransferDependencies {
@@ -23,11 +24,22 @@ export interface OssObjectMetadata {
     etag?: string;
     lastModified?: string;
     metadata: Record<string, string>;
+    storageClass?: string;
+    objectType?: string;
+    versionId?: string;
+    crc64?: string;
+    cacheControl?: string;
+    contentDisposition?: string;
+    contentEncoding?: string;
+    expires?: string;
+    serverSideEncryption?: string;
 }
 export declare class OssTransferClient {
     private readonly clientFactory;
     constructor(dependencies?: OssTransferDependencies);
     private client;
+    readStream(session: AccessSession, key: string, maxBytes?: number): Promise<Readable>;
+    uploadStream(session: AccessSession, key: string, source: Readable, size: number): Promise<void>;
     list(session: AccessSession, requestedPrefix?: string, limit?: number, options?: OssListOptions): Promise<{
         prefix: string;
         objects: OssObjectSummary[];
@@ -48,4 +60,18 @@ export declare class OssTransferClient {
         key: string;
     }>;
 }
+/** Unsigned public-network address; object ACLs still govern anonymous access. */
+export declare function ossObjectPublicUrl(session: AccessSession, key: string): string;
+export declare function ossSessionCapabilities(session: AccessSession): {
+    root: string;
+    list: boolean;
+    read: boolean;
+    write: boolean;
+    delete: boolean;
+};
 export declare function sessionMetadata(session: AccessSession): Record<string, unknown>;
+/** Validate every refreshed session before background transfer requests. */
+export declare function ossTransferOptions(session: AccessSession, key: string, operation: "read" | "write" | "delete" | "list"): {
+    key: string;
+    options: OSS.Options;
+};

package/dist/oss/transfers.js

@@ -3,6 +3,7 @@ import { createWriteStream } from "node:fs";
 import { access, link, mkdir, rm, stat } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { pipeline } from "node:stream/promises";
+import { Transform } from "node:stream";
 import OSS from "ali-oss";
 import { OssError } from "./errors.js";
 function normalizedPrefix(prefix) {
@@ -133,6 +134,48 @@ export class OssTransferClient {
     client(session) {
         return this.clientFactory(clientOptions(session));
     }
+    async readStream(session, key, maxBytes) {
+        requirePermission(session, "read");
+        const objectKey = validateKey(key, effectivePrefix(session), "object key");
+        if (maxBytes !== undefined && (!Number.isSafeInteger(maxBytes) || maxBytes < 1 || maxBytes > 1024 * 1024)) {
+            throw new OssError("Invalid preview length.", "oss_input_invalid");
+        }
+        try {
+            const result = await this.client(session).getStream(objectKey, maxBytes ? { headers: { Range: `bytes=0-${maxBytes - 1}` } } : undefined);
+            if (!result.stream)
+                throw new OssError("OSS returned no object stream.", "oss_download_failed");
+            return result.stream;
+        }
+        catch (error) {
+            throw transferError("download", error);
+        }
+    }
+    async uploadStream(session, key, source, size) {
+        requirePermission(session, "write");
+        const objectKey = validateKey(key, effectivePrefix(session), "object key");
+        if (!Number.isSafeInteger(size) || size < 0 || size > 5 * 1024 ** 3) {
+            throw new OssError("Upload must be at most 5 GiB.", "oss_input_invalid");
+        }
+        let received = 0;
+        const checked = new Transform({
+            transform(chunk, _encoding, callback) {
+                received += chunk.length;
+                callback(received > size ? new Error("Upload exceeds declared length.") : null, chunk);
+            },
+            flush(callback) { callback(received !== size ? new Error("Incomplete upload.") : null); }
+        });
+        // Attach both consumers before allowing input to flow; pipeline propagates aborts.
+        const upload = this.client(session).putStream(objectKey, checked, {
+            contentLength: size, headers: { "x-oss-forbid-overwrite": "true" }
+        }).catch(error => { checked.destroy(); throw error; });
+        try {
+            await Promise.all([upload, pipeline(source, checked)]);
+        }
+        catch (error) {
+            checked.destroy();
+            throw transferError("upload", error);
+        }
+    }
     async list(session, requestedPrefix, limit = 100, options = {}) {
         requirePermission(session, "list");
         if (!Number.isSafeInteger(limit) || limit < 1 || limit > 1000) {
@@ -196,6 +239,15 @@ export class OssTransferClient {
                 contentLength: header("content-length") === undefined ? undefined : Number(header("content-length")),
                 etag: header("etag"),
                 lastModified: header("last-modified"),
+                storageClass: header("x-oss-storage-class"),
+                objectType: header("x-oss-object-type"),
+                versionId: header("x-oss-version-id"),
+                crc64: header("x-oss-hash-crc64ecma"),
+                cacheControl: header("cache-control"),
+                contentDisposition: header("content-disposition"),
+                contentEncoding: header("content-encoding"),
+                expires: header("expires"),
+                serverSideEncryption: header("x-oss-server-side-encryption"),
                 metadata: Object.fromEntries(Object.entries(meta).filter((entry) => typeof entry[1] === "string"))
             };
         }
@@ -272,6 +324,31 @@ export class OssTransferClient {
         }
     }
 }
+/** Unsigned public-network address; object ACLs still govern anonymous access. */
+export function ossObjectPublicUrl(session, key) {
+    requirePermission(session, "read");
+    const objectKey = validateKey(key, effectivePrefix(session), "object key");
+    const options = clientOptions(session);
+    const region = String(options.region).replace(/-internal$/u, "");
+    const encoded = objectKey.split("/").map(part => encodeURIComponent(part)
+        .replace(/[!'()*]/gu, c => `%${c.charCodeAt(0).toString(16).toUpperCase()}`)).join("/");
+    return `https://${options.bucket}.${region}.aliyuncs.com/${encoded}`;
+}
+export function ossSessionCapabilities(session) {
+    clientOptions(session);
+    const prefix = effectivePrefix(session);
+    const allowed = (operation) => {
+        try {
+            requirePermission(session, operation);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    return { root: prefix ? `${prefix}/` : "", list: allowed("list"), read: allowed("read"),
+        write: allowed("write"), delete: allowed("delete") };
+}
 export function sessionMetadata(session) {
     return {
         session_id: session.sessionId,
@@ -292,4 +369,9 @@ export function sessionMetadata(session) {
         expires_at: session.expiration
     };
 }
+/** Validate every refreshed session before background transfer requests. */
+export function ossTransferOptions(session, key, operation) {
+    requirePermission(session, operation);
+    return { key: validateKey(key, effectivePrefix(session), "object key", operation === "list"), options: clientOptions(session) };
+}
 //# sourceMappingURL=transfers.js.map