@agentunion/fastaun 0.4.12 → 0.5.0

package/dist/storage/types.js.map

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

package/dist/storage/vfs.d.ts

@@ -0,0 +1,147 @@
+import { StorageLowLevel, type StorageRpcClient } from './lowlevel.js';
+import { type DownloadResult, type NodeView, type RemoveResult, type StorageRaw, type UnmountResult, type UsageView } from './types.js';
+export { StorageLowLevel } from './lowlevel.js';
+export * from './errors.js';
+export * from './types.js';
+export interface StorageOptions {
+    owner?: string | null;
+    bucket?: string;
+}
+export interface WriteBytesOptions extends StorageOptions {
+    contentType?: string;
+    overwrite?: boolean;
+    expectedVersion?: number;
+    public?: boolean;
+    metadata?: StorageRaw;
+}
+export interface ReadOptions extends StorageOptions {
+    token?: string;
+    offset?: number;
+    limit?: number;
+    overwrite?: boolean;
+}
+export interface ListOptions extends StorageOptions {
+    page?: number;
+    size?: number;
+    marker?: string;
+    long?: boolean;
+    recursive?: boolean;
+    token?: string;
+}
+export interface StatOptions extends StorageOptions {
+    token?: string;
+}
+export interface StoragePathRef {
+    owner?: string | null;
+    path: string;
+}
+export type StoragePathLike = string | StoragePathRef;
+export interface MountOptions extends StorageOptions {
+    sourceOwner?: string | null;
+    sourceBucket?: string;
+    readonly?: boolean;
+    expires?: number;
+    expiresAt?: number;
+    requireApproval?: boolean;
+}
+export declare class StorageVFS {
+    readonly lowlevel: StorageLowLevel;
+    useFsRpc: boolean;
+    private readonly client;
+    constructor(client: StorageRpcClient, options?: {
+        lowlevel?: StorageLowLevel;
+        useFsRpc?: boolean;
+    });
+    get defaultOwner(): string | null;
+    private owner;
+    writeBytes(path: string, input: Uint8Array | ArrayBuffer | string, options?: WriteBytesOptions): Promise<NodeView>;
+    uploadFile(localPath: string, remotePath: string, options?: WriteBytesOptions): Promise<NodeView>;
+    readBytes(path: string, options?: ReadOptions): Promise<Uint8Array>;
+    private readBytesWithMetadata;
+    downloadFile(path: string, options?: ReadOptions & {
+        verifyHash?: boolean;
+    }): Promise<DownloadResult>;
+    downloadFile(path: string, localPath: string, options?: ReadOptions & {
+        verifyHash?: boolean;
+    }): Promise<DownloadResult>;
+    list(path: string, options?: ListOptions): Promise<NodeView[]>;
+    stat(path: string, options?: StatOptions): Promise<NodeView>;
+    lstat(path: string, options?: StatOptions): Promise<NodeView>;
+    mkdir(path: string, options?: StorageOptions & {
+        parents?: boolean;
+    }): Promise<NodeView>;
+    remove(path: string, options?: StorageOptions & {
+        recursive?: boolean;
+    }): Promise<RemoveResult>;
+    rename(src: string, dst: string, options?: StorageOptions & {
+        overwrite?: boolean;
+        expectedVersion?: number;
+    }): Promise<NodeView>;
+    copy(src: string, dst: string, options?: StorageOptions & {
+        overwrite?: boolean;
+        followSymlinks?: boolean;
+        recursive?: boolean;
+        dstOwner?: string | null;
+        dstBucket?: string;
+    }): Promise<NodeView>;
+    find(path: string, options?: StorageOptions & {
+        name?: string;
+        nodeType?: string;
+        size?: string;
+        mtime?: string;
+        page?: number;
+        pageSize?: number;
+        token?: string;
+    }): Promise<NodeView[]>;
+    df(options?: StorageOptions): Promise<UsageView>;
+    mount(source: StoragePathLike, mountPath: StoragePathLike, options?: MountOptions): Promise<NodeView>;
+    mountVolume(volumeId: string, mountPath: StoragePathLike, options?: MountOptions): Promise<NodeView>;
+    approveMount(mountPath: StoragePathLike, options?: StorageOptions & {
+        mountId?: string;
+        requestId?: string;
+    }): Promise<StorageRaw>;
+    rejectMount(mountPath: StoragePathLike, options?: StorageOptions & {
+        mountId?: string;
+        requestId?: string;
+    }): Promise<StorageRaw>;
+    unmount(mountPath: StoragePathLike, options?: StorageOptions): Promise<UnmountResult>;
+    symlink(target: string, linkPath: string, options?: StorageOptions & {
+        overwrite?: boolean;
+    }): Promise<NodeView>;
+    readlink(path: string, options?: StorageOptions): Promise<NodeView>;
+    repoint(path: string, newTarget: string, options?: StorageOptions & {
+        expectedVersion?: number;
+    }): Promise<NodeView>;
+    renameSymlink(src: string, dst: string, options?: StorageOptions & {
+        overwrite?: boolean;
+        expectedVersion?: number;
+    }): Promise<NodeView>;
+    setAcl(path: string, options: StorageOptions & {
+        granteeAid: string;
+        perms: string;
+        expiresAt?: number;
+        maxUses?: number;
+    }): Promise<StorageRaw>;
+    removeAcl(path: string, options: StorageOptions & {
+        granteeAid: string;
+    }): Promise<StorageRaw>;
+    listAcl(path: string, options?: StorageOptions): Promise<StorageRaw>;
+    setVisibility(path: string, options: StorageOptions & {
+        visibility: string;
+        allowRoles?: string[];
+    }): Promise<NodeView>;
+    checkAccess(path: string, options?: StorageOptions & {
+        operation?: string;
+        token?: string;
+        followSymlinks?: boolean;
+    }): Promise<StorageRaw>;
+    issueToken(path: string, options?: StorageOptions & {
+        expiresAt?: number;
+        maxReads?: number;
+    }): Promise<StorageRaw>;
+    revokeToken(path: string, options: StorageOptions & {
+        token: string;
+    }): Promise<StorageRaw>;
+    listTokens(path: string, options?: StorageOptions): Promise<StorageRaw>;
+    getUsage(options?: StorageOptions): Promise<UsageView>;
+}

package/dist/storage/vfs.js

@@ -0,0 +1,489 @@
+import { mapStorageError, StorageConflictError, StorageError, StorageExistsError } from './errors.js';
+import { base64ToBytes, StorageLowLevel } from './lowlevel.js';
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { basename, dirname, extname, join } from 'node:path';
+import { nodeFromAny, pathToKey, unmountFromAny, usageFromAny, } from './types.js';
+export { StorageLowLevel } from './lowlevel.js';
+export * from './errors.js';
+export * from './types.js';
+async function sha256Hex(data) {
+    const copy = new Uint8Array(data.byteLength);
+    copy.set(data);
+    const subtle = globalThis.crypto?.subtle;
+    if (!subtle?.digest)
+        throw new StorageError('SHA-256 unavailable', 'EUNSUPPORTED');
+    const digest = await subtle.digest('SHA-256', copy.buffer);
+    return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+function toBytes(data) {
+    if (typeof data === 'string')
+        return new TextEncoder().encode(data);
+    if (data instanceof Uint8Array)
+        return data;
+    return new Uint8Array(data);
+}
+function contentTypeForPath(path) {
+    const ext = extname(path).toLowerCase();
+    const known = {
+        '.txt': 'text/plain',
+        '.json': 'application/json',
+        '.md': 'text/markdown',
+        '.html': 'text/html',
+        '.csv': 'text/csv',
+        '.png': 'image/png',
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.gif': 'image/gif',
+        '.webp': 'image/webp',
+        '.pdf': 'application/pdf',
+    };
+    return known[ext] ?? 'application/octet-stream';
+}
+function textValue(value) {
+    if (value === undefined || value === null)
+        return '';
+    return String(value).trim();
+}
+function isInlineFallbackError(error) {
+    const code = String(error.code).toUpperCase();
+    if (['EINLINE', 'EINLINE_LIMIT', 'ERR_INLINE_LIMIT', 'INLINE_LIMIT', '-32033'].includes(code))
+        return true;
+    // 当前服务端把 inline 过大映射为通用 -32602；只保留协议术语 inline 兜底，不再依赖中文文案。
+    return error.code === -32602 && error.message.toLowerCase().includes('inline');
+}
+async function statOrNull(path) {
+    try {
+        return await stat(path);
+    }
+    catch (exc) {
+        if (exc?.code === 'ENOENT')
+            return null;
+        throw exc;
+    }
+}
+function parsePathLike(input, fallbackOwner) {
+    if (typeof input !== 'string') {
+        return { owner: input.owner ?? fallbackOwner ?? null, path: input.path };
+    }
+    const match = input.match(/^([^:]+):(\/.*)$/);
+    if (match) {
+        return { owner: match[1], path: match[2] };
+    }
+    return { owner: fallbackOwner ?? null, path: input };
+}
+export class StorageVFS {
+    lowlevel;
+    useFsRpc;
+    client;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.lowlevel = options.lowlevel ?? new StorageLowLevel(client);
+        this.useFsRpc = options.useFsRpc ?? true;
+    }
+    get defaultOwner() {
+        return this.client.aid ?? null;
+    }
+    owner(owner) {
+        return owner || this.defaultOwner;
+    }
+    async writeBytes(path, input, options = {}) {
+        const data = toBytes(input);
+        const owner = this.owner(options.owner);
+        const bucket = options.bucket ?? 'default';
+        const objectKey = pathToKey(path);
+        const sha256 = await sha256Hex(data);
+        const overwrite = options.overwrite ?? false;
+        try {
+            const check = await this.lowlevel.checkUpload({ owner, bucket, objectKey, size: data.length, sha256 });
+            if (check.within_limit === false) {
+                throw new StorageError(`file size exceeds max_file_size_bytes: ${data.length}`, 'E2BIG', path, check);
+            }
+            if (check.target_exists && !overwrite && options.expectedVersion === undefined) {
+                throw new StorageExistsError(`remote path already exists: ${path}`, 'EEXIST', path, check.target);
+            }
+            if (check.dedup_hit || check.skip_upload) {
+                const completed = await this.lowlevel.completeUpload({
+                    owner,
+                    bucket,
+                    objectKey,
+                    size: data.length,
+                    sha256,
+                    contentType: options.contentType ?? 'application/octet-stream',
+                    metadata: options.metadata,
+                    isPublic: options.public ?? false,
+                    expectedVersion: options.expectedVersion,
+                    skipBlob: true,
+                    overwrite,
+                });
+                return nodeFromAny(completed);
+            }
+            if (check.inline === true) {
+                return nodeFromAny(await this.lowlevel.putObject({
+                    owner,
+                    bucket,
+                    objectKey,
+                    content: data,
+                    contentType: options.contentType ?? 'application/octet-stream',
+                    metadata: options.metadata,
+                    isPublic: options.public ?? false,
+                    expectedVersion: options.expectedVersion,
+                    overwrite,
+                }));
+            }
+            const session = await this.lowlevel.createUploadSession({
+                owner,
+                bucket,
+                objectKey,
+                size: data.length,
+                contentType: options.contentType,
+                expectedVersion: options.expectedVersion,
+                overwrite,
+            });
+            const uploadUrl = String(session.upload_url ?? '');
+            if (!uploadUrl)
+                throw new StorageError(`create_upload_session did not return upload_url`, 'ESTORAGE', path);
+            await this.lowlevel.httpPut(uploadUrl, data, session.headers);
+            return nodeFromAny(await this.lowlevel.completeUpload({
+                owner,
+                bucket,
+                objectKey,
+                sessionId: String(session.session_id ?? ''),
+                size: data.length,
+                sha256,
+                contentType: options.contentType,
+                metadata: options.metadata,
+                isPublic: options.public ?? false,
+                expectedVersion: options.expectedVersion,
+                overwrite,
+            }));
+        }
+        catch (exc) {
+            throw mapStorageError(exc, path);
+        }
+    }
+    async uploadFile(localPath, remotePath, options = {}) {
+        const data = await readFile(localPath);
+        return this.writeBytes(remotePath, data, {
+            ...options,
+            contentType: options.contentType ?? contentTypeForPath(localPath),
+        });
+    }
+    async readBytes(path, options = {}) {
+        return (await this.readBytesWithMetadata(path, options)).data;
+    }
+    async readBytesWithMetadata(path, options = {}) {
+        const owner = this.owner(options.owner);
+        const bucket = options.bucket ?? 'default';
+        const objectKey = pathToKey(path);
+        try {
+            const result = await this.lowlevel.getObject({ owner, bucket, objectKey, token: options.token, offset: options.offset, limit: options.limit });
+            return {
+                data: base64ToBytes(String(result.content ?? '')),
+                sha256: textValue(result.sha256),
+            };
+        }
+        catch (exc) {
+            const mapped = mapStorageError(exc, path);
+            if (options.offset !== undefined || options.limit !== undefined)
+                throw mapped;
+            if (!isInlineFallbackError(mapped))
+                throw mapped;
+        }
+        const ticket = await this.lowlevel.createDownloadTicket({ owner, bucket, objectKey, token: options.token });
+        const downloadUrl = String(ticket.download_url ?? '');
+        if (!downloadUrl)
+            throw new StorageError(`create_download_ticket did not return download_url`, 'ESTORAGE', path);
+        return {
+            data: await this.lowlevel.httpGet(downloadUrl),
+            sha256: textValue(ticket.sha256),
+        };
+    }
+    async downloadFile(path, localPathOrOptions = {}, maybeOptions = {}) {
+        if (typeof localPathOrOptions === 'string') {
+            const localPath = localPathOrOptions;
+            const options = maybeOptions;
+            const owner = this.owner(options.owner);
+            const bucket = options.bucket ?? 'default';
+            const objectKey = pathToKey(path);
+            const ticket = await this.lowlevel.createDownloadTicket({ owner, bucket, objectKey, token: options.token });
+            const downloadUrl = String(ticket.download_url ?? '');
+            if (!downloadUrl)
+                throw new StorageError(`create_download_ticket did not return download_url`, 'ESTORAGE', path);
+            let targetPath = localPath;
+            const localInfo = await statOrNull(targetPath);
+            if (localInfo?.isDirectory()) {
+                targetPath = join(targetPath, textValue(ticket.file_name) || basename(objectKey));
+            }
+            const targetInfo = await statOrNull(targetPath);
+            const overwrite = options.overwrite ?? false;
+            if (targetInfo) {
+                if (targetInfo.isDirectory())
+                    throw new StorageError(`local path is a directory: ${targetPath}`, 'EISDIR', targetPath);
+                if (!overwrite)
+                    throw new StorageExistsError(`local path already exists: ${targetPath}`, 'EEXIST', targetPath);
+            }
+            const data = await this.lowlevel.httpGet(downloadUrl);
+            const actualSha = await sha256Hex(data);
+            const expectedSha = textValue(ticket.sha256);
+            const expected = expectedSha.toLowerCase();
+            const verified = !expected || actualSha.toLowerCase() === expected;
+            if (!verified && (options.verifyHash ?? true)) {
+                throw new StorageError(`hash mismatch: expected=${expected} actual=${actualSha.toLowerCase()}`, 'EHASH', path);
+            }
+            await mkdir(dirname(targetPath), { recursive: true });
+            try {
+                await writeFile(targetPath, data, { flag: overwrite ? 'w' : 'wx' });
+            }
+            catch (exc) {
+                if (!overwrite && exc?.code === 'EEXIST') {
+                    throw new StorageExistsError(`local path already exists: ${targetPath}`, 'EEXIST', targetPath);
+                }
+                throw exc;
+            }
+            return {
+                path,
+                localPath: targetPath,
+                size: data.length,
+                sha256: expectedSha || actualSha,
+                verified,
+            };
+        }
+        const options = localPathOrOptions;
+        const { data, sha256: expectedSha } = await this.readBytesWithMetadata(path, options);
+        const actualSha = await sha256Hex(data);
+        const expected = expectedSha.toLowerCase();
+        const verified = Boolean(expected) && actualSha.toLowerCase() === expected;
+        if (!verified && expected && (options.verifyHash ?? true)) {
+            throw new StorageError(`hash mismatch: expected=${expected} actual=${actualSha.toLowerCase()}`, 'EHASH', path);
+        }
+        return {
+            path,
+            size: data.length,
+            sha256: expectedSha || actualSha,
+            verified,
+            data,
+        };
+    }
+    async list(path, options = {}) {
+        if (options.recursive) {
+            const result = [];
+            const pending = [path];
+            while (pending.length) {
+                const current = pending.shift();
+                const children = await this.list(current, { ...options, recursive: false });
+                result.push(...children);
+                pending.push(...children.filter((node) => node.type === 'dir').map((node) => node.path));
+            }
+            return result;
+        }
+        const owner = this.owner(options.owner);
+        const bucket = options.bucket ?? 'default';
+        const key = pathToKey(path);
+        const raw = await this.lowlevel.fsList({
+            owner,
+            bucket,
+            path: key,
+            page: options.page,
+            size: options.size,
+            marker: options.marker,
+            token: options.token,
+        });
+        const items = (raw.nodes ?? raw.items ?? []);
+        return items.map((item) => nodeFromAny(item));
+    }
+    async stat(path, options = {}) {
+        const owner = this.owner(options.owner);
+        const raw = await this.lowlevel.fsStat({ owner, bucket: options.bucket ?? 'default', path: pathToKey(path), token: options.token });
+        return nodeFromAny(raw);
+    }
+    async lstat(path, options = {}) {
+        const owner = this.owner(options.owner);
+        const raw = await this.lowlevel.fsLstat({ owner, bucket: options.bucket ?? 'default', path: pathToKey(path), token: options.token });
+        return nodeFromAny(raw);
+    }
+    async mkdir(path, options = {}) {
+        const raw = await this.lowlevel.fsMkdir({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path), parents: options.parents });
+        return nodeFromAny(raw.node ?? raw);
+    }
+    async remove(path, options = {}) {
+        const raw = await this.lowlevel.fsRemove({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path), recursive: options.recursive });
+        return { path, removedCount: Number(raw.removed_count ?? raw.deleted_count ?? 0) };
+    }
+    async rename(src, dst, options = {}) {
+        const raw = await this.lowlevel.fsRename({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', src: pathToKey(src), dst: pathToKey(dst), overwrite: options.overwrite, expectedVersion: options.expectedVersion });
+        return nodeFromAny(raw.node ?? raw);
+    }
+    async copy(src, dst, options = {}) {
+        const raw = await this.lowlevel.fsCopy({
+            owner: this.owner(options.owner),
+            bucket: options.bucket ?? 'default',
+            src: pathToKey(src),
+            dst: pathToKey(dst),
+            overwrite: options.overwrite,
+            followSymlinks: options.followSymlinks,
+            recursive: options.recursive,
+            dstOwner: options.dstOwner,
+            dstBucket: options.dstBucket,
+        });
+        return nodeFromAny(raw.node ?? raw);
+    }
+    async find(path, options = {}) {
+        const raw = await this.lowlevel.fsFind({
+            owner: this.owner(options.owner),
+            bucket: options.bucket ?? 'default',
+            path: pathToKey(path),
+            name: options.name,
+            nodeType: options.nodeType,
+            size: options.size,
+            mtime: options.mtime,
+            page: options.page,
+            pageSize: options.pageSize,
+            token: options.token,
+        });
+        const items = (raw.nodes ?? raw.items ?? []);
+        return items.map((item) => nodeFromAny(item));
+    }
+    async df(options = {}) {
+        const owner = this.owner(options.owner);
+        const raw = await this.lowlevel.fsDf({ owner, bucket: options.bucket ?? 'default' });
+        return usageFromAny(raw, owner ?? undefined);
+    }
+    async mount(source, mountPath, options = {}) {
+        const owner = this.owner(options.owner);
+        const mountRef = parsePathLike(mountPath, owner);
+        const sourceRef = parsePathLike(source, options.sourceOwner ?? this.defaultOwner);
+        const raw = await this.lowlevel.fsMount({
+            owner: mountRef.owner,
+            bucket: options.bucket ?? 'default',
+            mountPath: pathToKey(mountRef.path),
+            sourceAid: String(sourceRef.owner ?? ''),
+            sourceBucket: options.sourceBucket,
+            sourcePath: pathToKey(sourceRef.path),
+            readonly: options.readonly,
+            expiresAt: options.expiresAt ?? options.expires,
+            requireApproval: options.requireApproval,
+        });
+        return nodeFromAny(raw.node ?? raw.mount ?? raw);
+    }
+    async mountVolume(volumeId, mountPath, options = {}) {
+        const owner = this.owner(options.owner);
+        const mountRef = parsePathLike(mountPath, owner);
+        const raw = await this.lowlevel.fsMount({
+            owner: mountRef.owner,
+            bucket: options.bucket ?? 'default',
+            mountPath: pathToKey(mountRef.path),
+            readonly: options.readonly,
+            expiresAt: options.expiresAt ?? options.expires,
+            requireApproval: options.requireApproval,
+            volumeId,
+        });
+        return nodeFromAny(raw.node ?? raw.mount ?? raw);
+    }
+    approveMount(mountPath, options = {}) {
+        const owner = this.owner(options.owner);
+        const mountRef = parsePathLike(mountPath, owner);
+        return this.lowlevel.fsApprove({
+            owner: mountRef.owner,
+            bucket: options.bucket ?? 'default',
+            mountPath: pathToKey(mountRef.path),
+            mountId: options.mountId,
+            requestId: options.requestId,
+        });
+    }
+    rejectMount(mountPath, options = {}) {
+        const owner = this.owner(options.owner);
+        const mountRef = parsePathLike(mountPath, owner);
+        return this.lowlevel.fsReject({
+            owner: mountRef.owner,
+            bucket: options.bucket ?? 'default',
+            mountPath: pathToKey(mountRef.path),
+            mountId: options.mountId,
+            requestId: options.requestId,
+        });
+    }
+    async unmount(mountPath, options = {}) {
+        const owner = this.owner(options.owner);
+        const mountRef = parsePathLike(mountPath, owner);
+        const raw = await this.lowlevel.fsUnmount({
+            owner: mountRef.owner,
+            bucket: options.bucket ?? 'default',
+            mountPath: pathToKey(mountRef.path),
+        });
+        return unmountFromAny(raw, {
+            owner: mountRef.owner,
+            bucket: options.bucket ?? 'default',
+            mountPath: pathToKey(mountRef.path),
+        });
+    }
+    async symlink(target, linkPath, options = {}) {
+        const raw = await this.lowlevel.createSymlink({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(linkPath), target, overwrite: options.overwrite });
+        return nodeFromAny(raw.symlink ?? raw);
+    }
+    async readlink(path, options = {}) {
+        const raw = await this.lowlevel.readlink({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path) });
+        return nodeFromAny(raw.symlink ?? raw);
+    }
+    async repoint(path, newTarget, options = {}) {
+        const raw = await this.lowlevel.atomicRepoint({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path), newTarget, expectedVersion: options.expectedVersion });
+        if (raw.ok === false)
+            throw new StorageConflictError('symlink version conflict', 'ECONFLICT', path, raw);
+        return nodeFromAny(raw.symlink ?? raw);
+    }
+    async renameSymlink(src, dst, options = {}) {
+        const raw = await this.lowlevel.renameSymlink({
+            owner: this.owner(options.owner),
+            bucket: options.bucket ?? 'default',
+            path: pathToKey(src),
+            newPath: pathToKey(dst),
+            overwrite: options.overwrite,
+            expectedVersion: options.expectedVersion,
+        });
+        if (raw.ok === false)
+            throw new StorageConflictError('symlink version conflict', 'ECONFLICT', src, raw);
+        return nodeFromAny(raw.symlink ?? raw);
+    }
+    setAcl(path, options) {
+        return this.lowlevel.setAcl({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path), granteeAid: options.granteeAid, perms: options.perms, expiresAt: options.expiresAt, maxUses: options.maxUses });
+    }
+    removeAcl(path, options) {
+        return this.lowlevel.removeAcl({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path), granteeAid: options.granteeAid });
+    }
+    listAcl(path, options = {}) {
+        return this.lowlevel.listAcl({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path) });
+    }
+    async setVisibility(path, options) {
+        const raw = await this.lowlevel.setVisibility({
+            owner: this.owner(options.owner),
+            bucket: options.bucket ?? 'default',
+            path: pathToKey(path),
+            visibility: options.visibility,
+            allowRoles: options.allowRoles,
+        });
+        return nodeFromAny(raw.node ?? raw);
+    }
+    checkAccess(path, options = {}) {
+        return this.lowlevel.checkAccess({
+            owner: this.owner(options.owner),
+            bucket: options.bucket ?? 'default',
+            path: pathToKey(path),
+            operation: options.operation ?? 'read',
+            token: options.token,
+            followSymlinks: options.followSymlinks ?? true,
+        });
+    }
+    issueToken(path, options = {}) {
+        return this.lowlevel.issueToken({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path), expiresAt: options.expiresAt, maxReads: options.maxReads });
+    }
+    revokeToken(path, options) {
+        return this.lowlevel.revokeToken({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path), token: options.token });
+    }
+    listTokens(path, options = {}) {
+        return this.lowlevel.listTokens({ owner: this.owner(options.owner), bucket: options.bucket ?? 'default', path: pathToKey(path) });
+    }
+    async getUsage(options = {}) {
+        const owner = this.owner(options.owner);
+        const raw = await this.lowlevel.getQuota({ owner, bucket: options.bucket ?? 'default' });
+        return usageFromAny(raw, owner ?? '');
+    }
+}
+//# sourceMappingURL=vfs.js.map