@walkthru-earth/objex 0.1.0

package/dist/storage/CLAUDE.md

@@ -0,0 +1,23 @@
+# storage/
+
+Cloud storage adapters. All implement `StorageAdapter` interface.
+
+```mermaid
+graph LR
+    A[StorageAdapter] --> B[BrowserCloudAdapter<br/>S3/GCS/R2/MinIO/Storj]
+    A --> C[BrowserAzureAdapter<br/>Azure Blob + SAS]
+    A --> D[UrlAdapter<br/>direct HTTPS, read-only]
+    E[index.ts<br/>getAdapter / clearAdapterCache] --> B & C & D
+    B & C --> F[stores/connections]
+    B & C --> G[stores/credentials]
+```
+
+| File | Exports | Used by |
+|------|---------|---------|
+| `adapter.ts` | `StorageAdapter` (interface), `ListPage` | lib/index.ts (npm export) |
+| `browser-cloud.ts` | `BrowserCloudAdapter` | index.ts (factory) |
+| `browser-azure.ts` | `BrowserAzureAdapter` | index.ts (factory) |
+| `url-adapter.ts` | `UrlAdapter` | lib/index.ts (npm export) |
+| `index.ts` | `getAdapter()`, `clearAdapterCache()` | stores/browser, FileTreeSidebar, ArchiveViewer, ModelViewer, DatabaseViewer, MediaViewer, PdfViewer, RawViewer, MarkdownViewer, NotebookViewer, MapViewer, CodeViewer, ImageViewer |
+
+`adapter.ts` and `url-adapter.ts` use relative imports (not `$lib`) — they're published to npm.

package/dist/storage/adapter.d.ts

@@ -0,0 +1,21 @@
+import type { FileEntry, WriteResult } from '../types.js';
+/** A single page of listing results with optional continuation. */
+export interface ListPage {
+    entries: FileEntry[];
+    continuationToken?: string;
+    hasMore: boolean;
+}
+export interface StorageAdapter {
+    list(path: string, signal?: AbortSignal): Promise<FileEntry[]>;
+    read(path: string, offset?: number, length?: number, signal?: AbortSignal): Promise<Uint8Array>;
+    head(path: string, signal?: AbortSignal): Promise<FileEntry>;
+    /** Fetch a single page of listing results. Supports progressive rendering. */
+    listPage?(path: string, continuationToken?: string, pageSize?: number, signal?: AbortSignal): Promise<ListPage>;
+    put(key: string, data: Uint8Array, contentType?: string): Promise<WriteResult>;
+    delete(key: string): Promise<void>;
+    deletePrefix(prefix: string): Promise<{
+        deleted: number;
+    }>;
+    copy(srcKey: string, destKey: string): Promise<WriteResult>;
+    readonly supportsWrite: boolean;
+}

package/dist/storage/adapter.js

@@ -0,0 +1 @@
+export {};

package/dist/storage/browser-azure.d.ts

@@ -0,0 +1,25 @@
+import type { FileEntry, WriteResult } from '../types.js';
+import type { ListPage, StorageAdapter } from './adapter.js';
+/**
+ * Browser-based Azure Blob Storage adapter.
+ *
+ * - Anonymous access uses plain `fetch()`.
+ * - Authenticated access appends SAS token as URL query params.
+ * - Requires CORS to be enabled on the storage account.
+ */
+export declare class BrowserAzureAdapter implements StorageAdapter {
+    private connectionId;
+    constructor(connectionId: string);
+    get supportsWrite(): boolean;
+    private getConnection;
+    listPage(path: string, continuationToken?: string, pageSize?: number, signal?: AbortSignal): Promise<ListPage>;
+    list(path: string): Promise<FileEntry[]>;
+    read(path: string, offset?: number, length?: number, signal?: AbortSignal): Promise<Uint8Array>;
+    head(path: string, signal?: AbortSignal): Promise<FileEntry>;
+    put(key: string, data: Uint8Array, contentType?: string): Promise<WriteResult>;
+    delete(key: string): Promise<void>;
+    deletePrefix(prefix: string): Promise<{
+        deleted: number;
+    }>;
+    copy(srcKey: string, destKey: string): Promise<WriteResult>;
+}

package/dist/storage/browser-azure.js

@@ -0,0 +1,271 @@
+import { connectionStore } from '../stores/connections.svelte.js';
+import { credentialStore } from '../stores/credentials.svelte.js';
+// --- Helpers ---
+function nameFromKey(key) {
+    const trimmed = key.replace(/\/$/, '');
+    const segments = trimmed.split('/');
+    return segments[segments.length - 1] || trimmed;
+}
+function extensionFromName(name) {
+    const dot = name.lastIndexOf('.');
+    if (dot < 1)
+        return '';
+    return name.slice(dot + 1).toLowerCase();
+}
+/**
+ * Build the base URL for Azure Blob REST API.
+ * Format: https://<account>.blob.core.windows.net/<container>
+ */
+function buildBaseUrl(conn) {
+    const base = conn.endpoint.replace(/\/$/, '');
+    return `${base}/${conn.bucket}`;
+}
+function encodeKey(key) {
+    return key
+        .split('/')
+        .map((s) => encodeURIComponent(s))
+        .join('/');
+}
+/**
+ * Get the SAS token query string (with leading '?') if credentials exist.
+ */
+function getSasQuery(conn) {
+    if (conn.anonymous)
+        return '';
+    const creds = credentialStore.get(conn.id);
+    if (!creds || creds.type !== 'sas-token')
+        return '';
+    const token = creds.sasToken;
+    // SAS tokens may or may not start with '?'
+    return token.startsWith('?') ? token : `?${token}`;
+}
+/**
+ * Append SAS token to a URL, handling existing query params.
+ */
+function appendSas(url, sasQuery) {
+    if (!sasQuery)
+        return url;
+    const sep = url.includes('?') ? '&' : '?';
+    // Strip leading '?' from sasQuery when appending with '&'
+    const token = sasQuery.startsWith('?') ? sasQuery.slice(1) : sasQuery;
+    return `${url}${sep}${token}`;
+}
+// --- Adapter ---
+/**
+ * Browser-based Azure Blob Storage adapter.
+ *
+ * - Anonymous access uses plain `fetch()`.
+ * - Authenticated access appends SAS token as URL query params.
+ * - Requires CORS to be enabled on the storage account.
+ */
+export class BrowserAzureAdapter {
+    connectionId;
+    constructor(connectionId) {
+        this.connectionId = connectionId;
+    }
+    get supportsWrite() {
+        const conn = connectionStore.getById(this.connectionId);
+        return !!conn && !conn.anonymous;
+    }
+    getConnection() {
+        const conn = connectionStore.getById(this.connectionId);
+        if (!conn)
+            throw new Error(`Connection not found: ${this.connectionId}`);
+        return conn;
+    }
+    async listPage(path, continuationToken, pageSize, signal) {
+        const conn = this.getConnection();
+        const baseUrl = buildBaseUrl(conn);
+        const sas = getSasQuery(conn);
+        const params = new URLSearchParams({
+            restype: 'container',
+            comp: 'list',
+            delimiter: '/'
+        });
+        if (path)
+            params.set('prefix', path);
+        if (continuationToken)
+            params.set('marker', continuationToken);
+        if (pageSize)
+            params.set('maxresults', String(pageSize));
+        const url = appendSas(`${baseUrl}?${params}`, sas);
+        const res = await fetch(url, { signal });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Azure list failed (${res.status}): ${body || res.statusText}`);
+        }
+        const xml = await res.text();
+        const doc = new DOMParser().parseFromString(xml, 'application/xml');
+        const entries = [];
+        // Parse <BlobPrefix> (directories)
+        for (const bp of doc.querySelectorAll('BlobPrefix')) {
+            const prefix = bp.querySelector('Name')?.textContent ?? '';
+            if (!prefix)
+                continue;
+            const dirName = nameFromKey(prefix);
+            entries.push({
+                name: dirName,
+                path: prefix,
+                is_dir: true,
+                size: 0,
+                modified: 0,
+                extension: dirName.endsWith('.zarr') || dirName.endsWith('.zr3') ? 'zarr' : ''
+            });
+        }
+        // Parse <Blob> (files)
+        for (const blob of doc.querySelectorAll('Blobs > Blob')) {
+            const key = blob.querySelector('Name')?.textContent ?? '';
+            if (!key || key === path || key.endsWith('/'))
+                continue;
+            const name = nameFromKey(key);
+            const size = parseInt(blob.querySelector('Properties > Content-Length')?.textContent ?? '0', 10);
+            const lastMod = blob.querySelector('Properties > Last-Modified')?.textContent ?? '';
+            entries.push({
+                name,
+                path: key,
+                is_dir: false,
+                size,
+                modified: lastMod ? Date.parse(lastMod) || 0 : 0,
+                extension: extensionFromName(name)
+            });
+        }
+        const nextMarker = doc.querySelector('NextMarker')?.textContent || undefined;
+        return { entries, continuationToken: nextMarker, hasMore: !!nextMarker };
+    }
+    async list(path) {
+        const all = [];
+        let token;
+        do {
+            const page = await this.listPage(path, token);
+            all.push(...page.entries);
+            token = page.continuationToken;
+        } while (token);
+        return all;
+    }
+    async read(path, offset, length, signal) {
+        const conn = this.getConnection();
+        const url = appendSas(`${buildBaseUrl(conn)}/${encodeKey(path)}`, getSasQuery(conn));
+        const headers = {};
+        if (offset !== undefined || length !== undefined) {
+            const start = offset ?? 0;
+            const end = length !== undefined ? start + length - 1 : '';
+            headers.Range = `bytes=${start}-${end}`;
+        }
+        const res = await fetch(url, { headers, signal });
+        if (!res.ok && res.status !== 206) {
+            throw new Error(`Azure get failed (${res.status}): ${res.statusText}`);
+        }
+        return new Uint8Array(await res.arrayBuffer());
+    }
+    async head(path, signal) {
+        const conn = this.getConnection();
+        const url = appendSas(`${buildBaseUrl(conn)}/${encodeKey(path)}`, getSasQuery(conn));
+        const res = await fetch(url, { method: 'HEAD', signal });
+        if (!res.ok) {
+            throw new Error(`Azure head failed (${res.status}): ${res.statusText}`);
+        }
+        const name = nameFromKey(path);
+        const size = parseInt(res.headers.get('content-length') ?? '0', 10);
+        const lastMod = res.headers.get('last-modified');
+        return {
+            name,
+            path,
+            is_dir: false,
+            size,
+            modified: lastMod ? Date.parse(lastMod) || 0 : 0,
+            extension: extensionFromName(name)
+        };
+    }
+    async put(key, data, contentType) {
+        const conn = this.getConnection();
+        const url = appendSas(`${buildBaseUrl(conn)}/${encodeKey(key)}`, getSasQuery(conn));
+        const headers = {
+            'x-ms-blob-type': 'BlockBlob'
+        };
+        if (contentType)
+            headers['Content-Type'] = contentType;
+        const res = await fetch(url, {
+            method: 'PUT',
+            body: data.buffer,
+            headers
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Azure put failed (${res.status}): ${body || res.statusText}`);
+        }
+        return {
+            key,
+            size: data.byteLength,
+            e_tag: res.headers.get('etag') ?? undefined
+        };
+    }
+    async delete(key) {
+        const conn = this.getConnection();
+        const url = appendSas(`${buildBaseUrl(conn)}/${encodeKey(key)}`, getSasQuery(conn));
+        const res = await fetch(url, { method: 'DELETE' });
+        if (!res.ok && res.status !== 202 && res.status !== 204) {
+            throw new Error(`Azure delete failed (${res.status}): ${res.statusText}`);
+        }
+    }
+    async deletePrefix(prefix) {
+        if (!prefix) {
+            throw new Error('Cannot delete with empty prefix — this would delete the entire container.');
+        }
+        // List all blobs under prefix (no delimiter → recursive)
+        const conn = this.getConnection();
+        const baseUrl = buildBaseUrl(conn);
+        const sas = getSasQuery(conn);
+        const keys = [];
+        let marker;
+        do {
+            const params = new URLSearchParams({
+                restype: 'container',
+                comp: 'list'
+            });
+            if (prefix)
+                params.set('prefix', prefix);
+            if (marker)
+                params.set('marker', marker);
+            const url = appendSas(`${baseUrl}?${params}`, sas);
+            const res = await fetch(url);
+            if (!res.ok)
+                throw new Error(`Azure list failed (${res.status}): ${res.statusText}`);
+            const xml = await res.text();
+            const doc = new DOMParser().parseFromString(xml, 'application/xml');
+            for (const blob of doc.querySelectorAll('Blobs > Blob')) {
+                const key = blob.querySelector('Name')?.textContent;
+                if (key)
+                    keys.push(key);
+            }
+            const nextMarker = doc.querySelector('NextMarker')?.textContent;
+            marker = nextMarker || undefined;
+        } while (marker);
+        for (const key of keys) {
+            await this.delete(key);
+        }
+        return { deleted: keys.length };
+    }
+    async copy(srcKey, destKey) {
+        const conn = this.getConnection();
+        const sas = getSasQuery(conn);
+        const base = buildBaseUrl(conn);
+        const destUrl = appendSas(`${base}/${encodeKey(destKey)}`, sas);
+        const srcUrl = appendSas(`${base}/${encodeKey(srcKey)}`, sas);
+        const res = await fetch(destUrl, {
+            method: 'PUT',
+            headers: {
+                'x-ms-copy-source': srcUrl,
+                'x-ms-blob-type': 'BlockBlob'
+            }
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Azure copy failed (${res.status}): ${body || res.statusText}`);
+        }
+        return {
+            key: destKey,
+            size: 0,
+            e_tag: res.headers.get('etag') ?? undefined
+        };
+    }
+}

package/dist/storage/browser-cloud.d.ts

@@ -0,0 +1,32 @@
+import type { FileEntry, WriteResult } from '../types.js';
+import type { ListPage, StorageAdapter } from './adapter.js';
+/**
+ * Browser-based cloud storage adapter (S3-compatible).
+ *
+ * Supports S3, R2, GCS, Storj, MinIO, DigitalOcean Spaces, Wasabi, and other
+ * S3-compatible providers.
+ *
+ * - Anonymous connections use plain `fetch()`.
+ * - Authenticated connections use `aws4fetch` for SigV4 request signing.
+ * - Requires CORS to be enabled on the target bucket.
+ */
+export declare class BrowserCloudAdapter implements StorageAdapter {
+    private connectionId;
+    private _fetcher;
+    constructor(connectionId: string);
+    /** Invalidate cached fetcher (call if credentials change). */
+    resetFetcher(): void;
+    private getFetcher;
+    get supportsWrite(): boolean;
+    private getConnection;
+    listPage(path: string, continuationToken?: string, pageSize?: number, signal?: AbortSignal): Promise<ListPage>;
+    list(path: string): Promise<FileEntry[]>;
+    read(path: string, offset?: number, length?: number, signal?: AbortSignal): Promise<Uint8Array>;
+    head(path: string, signal?: AbortSignal): Promise<FileEntry>;
+    put(key: string, data: Uint8Array, contentType?: string): Promise<WriteResult>;
+    delete(key: string): Promise<void>;
+    deletePrefix(prefix: string): Promise<{
+        deleted: number;
+    }>;
+    copy(srcKey: string, destKey: string): Promise<WriteResult>;
+}

package/dist/storage/browser-cloud.js

@@ -0,0 +1,293 @@
+import { AwsClient } from 'aws4fetch';
+import { connectionStore } from '../stores/connections.svelte.js';
+import { credentialStore } from '../stores/credentials.svelte.js';
+// --- Helpers ---
+/** Extract the last path segment from an object key. */
+function nameFromKey(key) {
+    const trimmed = key.replace(/\/$/, '');
+    const segments = trimmed.split('/');
+    return segments[segments.length - 1] || trimmed;
+}
+/** Extract a file extension from a name, or return an empty string. */
+function extensionFromName(name) {
+    const dot = name.lastIndexOf('.');
+    if (dot < 1)
+        return '';
+    return name.slice(dot + 1).toLowerCase();
+}
+/**
+ * Build the base URL for S3-compatible API requests.
+ * Uses path-style addressing (safer for buckets with dots in names).
+ */
+function buildBaseUrl(conn) {
+    if (conn.endpoint) {
+        const base = conn.endpoint.replace(/\/$/, '');
+        return `${base}/${conn.bucket}`;
+    }
+    // Default AWS S3 — path-style
+    return `https://s3.${conn.region}.amazonaws.com/${conn.bucket}`;
+}
+/** Decode a possibly percent-encoded S3 key (some providers URL-encode non-ASCII in XML). */
+function decodeKey(key) {
+    try {
+        return decodeURIComponent(key);
+    }
+    catch {
+        return key;
+    }
+}
+/** Encode an object key for use in a URL path, preserving `/` separators. */
+function encodeKey(key) {
+    return key
+        .split('/')
+        .map((s) => encodeURIComponent(s))
+        .join('/');
+}
+/**
+ * Create a fetch function that signs requests with SigV4 when credentials
+ * are available, or falls back to plain fetch for anonymous access.
+ */
+function createFetcher(conn) {
+    if (conn.anonymous) {
+        return (url, init) => fetch(url, init);
+    }
+    const creds = credentialStore.get(conn.id);
+    if (!creds || creds.type !== 'sigv4') {
+        throw new Error(`No credentials found for connection "${conn.name}". ` +
+            'Provide access key and secret key, or enable anonymous access.');
+    }
+    const client = new AwsClient({
+        accessKeyId: creds.accessKey,
+        secretAccessKey: creds.secretKey,
+        service: 's3',
+        region: conn.region
+    });
+    return (url, init) => client.fetch(url, init);
+}
+// --- Adapter ---
+/**
+ * Browser-based cloud storage adapter (S3-compatible).
+ *
+ * Supports S3, R2, GCS, Storj, MinIO, DigitalOcean Spaces, Wasabi, and other
+ * S3-compatible providers.
+ *
+ * - Anonymous connections use plain `fetch()`.
+ * - Authenticated connections use `aws4fetch` for SigV4 request signing.
+ * - Requires CORS to be enabled on the target bucket.
+ */
+export class BrowserCloudAdapter {
+    connectionId;
+    _fetcher = null;
+    constructor(connectionId) {
+        this.connectionId = connectionId;
+    }
+    /** Invalidate cached fetcher (call if credentials change). */
+    resetFetcher() {
+        this._fetcher = null;
+    }
+    getFetcher() {
+        if (!this._fetcher) {
+            this._fetcher = createFetcher(this.getConnection());
+        }
+        return this._fetcher;
+    }
+    get supportsWrite() {
+        const conn = connectionStore.getById(this.connectionId);
+        return !!conn && !conn.anonymous;
+    }
+    getConnection() {
+        const conn = connectionStore.getById(this.connectionId);
+        if (!conn)
+            throw new Error(`Connection not found: ${this.connectionId}`);
+        return conn;
+    }
+    async listPage(path, continuationToken, pageSize, signal) {
+        const conn = this.getConnection();
+        const baseUrl = buildBaseUrl(conn);
+        const cloudFetch = this.getFetcher();
+        const params = new URLSearchParams({
+            'list-type': '2',
+            delimiter: '/'
+        });
+        if (path)
+            params.set('prefix', path);
+        if (continuationToken)
+            params.set('continuation-token', continuationToken);
+        if (pageSize)
+            params.set('max-keys', String(pageSize));
+        const res = await cloudFetch(`${baseUrl}?${params}`, { signal });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`List failed (${res.status}): ${body || res.statusText}`);
+        }
+        const xml = await res.text();
+        const doc = new DOMParser().parseFromString(xml, 'application/xml');
+        const entries = [];
+        // Parse <CommonPrefixes> (directories)
+        for (const cp of doc.querySelectorAll('CommonPrefixes')) {
+            const prefix = cp.querySelector('Prefix')?.textContent ?? '';
+            if (!prefix)
+                continue;
+            const dirName = nameFromKey(prefix);
+            entries.push({
+                name: decodeKey(dirName),
+                path: prefix,
+                is_dir: true,
+                size: 0,
+                modified: 0,
+                extension: dirName.endsWith('.zarr') || dirName.endsWith('.zr3') ? 'zarr' : ''
+            });
+        }
+        // Parse <Contents> (files)
+        for (const item of doc.querySelectorAll('Contents')) {
+            const key = item.querySelector('Key')?.textContent ?? '';
+            if (!key || key === path || key.endsWith('/'))
+                continue;
+            const name = decodeKey(nameFromKey(key));
+            const size = parseInt(item.querySelector('Size')?.textContent ?? '0', 10);
+            const lastMod = item.querySelector('LastModified')?.textContent ?? '';
+            entries.push({
+                name,
+                path: key,
+                is_dir: false,
+                size,
+                modified: lastMod ? Date.parse(lastMod) || 0 : 0,
+                extension: extensionFromName(name)
+            });
+        }
+        const isTruncated = doc.querySelector('IsTruncated')?.textContent === 'true';
+        const nextToken = isTruncated
+            ? (doc.querySelector('NextContinuationToken')?.textContent ?? undefined)
+            : undefined;
+        return { entries, continuationToken: nextToken, hasMore: !!nextToken };
+    }
+    async list(path) {
+        const all = [];
+        let token;
+        do {
+            const page = await this.listPage(path, token);
+            all.push(...page.entries);
+            token = page.continuationToken;
+        } while (token);
+        return all;
+    }
+    async read(path, offset, length, signal) {
+        const conn = this.getConnection();
+        const url = `${buildBaseUrl(conn)}/${encodeKey(path)}`;
+        const cloudFetch = this.getFetcher();
+        const headers = {};
+        if (offset !== undefined || length !== undefined) {
+            const start = offset ?? 0;
+            const end = length !== undefined ? start + length - 1 : '';
+            headers.Range = `bytes=${start}-${end}`;
+        }
+        const res = await cloudFetch(url, { headers, signal });
+        if (!res.ok && res.status !== 206) {
+            throw new Error(`Fetch failed (${res.status}): ${res.statusText}`);
+        }
+        return new Uint8Array(await res.arrayBuffer());
+    }
+    async head(path, signal) {
+        const conn = this.getConnection();
+        const url = `${buildBaseUrl(conn)}/${encodeKey(path)}`;
+        const cloudFetch = this.getFetcher();
+        const res = await cloudFetch(url, { method: 'HEAD', signal });
+        if (!res.ok) {
+            throw new Error(`Head failed (${res.status}): ${res.statusText}`);
+        }
+        const name = nameFromKey(path);
+        const size = parseInt(res.headers.get('content-length') ?? '0', 10);
+        const lastMod = res.headers.get('last-modified');
+        return {
+            name,
+            path,
+            is_dir: false,
+            size,
+            modified: lastMod ? Date.parse(lastMod) || 0 : 0,
+            extension: extensionFromName(name)
+        };
+    }
+    async put(key, data, contentType) {
+        const conn = this.getConnection();
+        const url = `${buildBaseUrl(conn)}/${encodeKey(key)}`;
+        const cloudFetch = this.getFetcher();
+        const headers = {};
+        if (contentType)
+            headers['Content-Type'] = contentType;
+        const res = await cloudFetch(url, { method: 'PUT', body: data.buffer, headers });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Upload failed (${res.status}): ${body || res.statusText}`);
+        }
+        return {
+            key,
+            size: data.byteLength,
+            e_tag: res.headers.get('etag') ?? undefined
+        };
+    }
+    async delete(key) {
+        const conn = this.getConnection();
+        const url = `${buildBaseUrl(conn)}/${encodeKey(key)}`;
+        const cloudFetch = this.getFetcher();
+        const res = await cloudFetch(url, { method: 'DELETE' });
+        if (!res.ok && res.status !== 204) {
+            throw new Error(`Delete failed (${res.status}): ${res.statusText}`);
+        }
+    }
+    async deletePrefix(prefix) {
+        if (!prefix) {
+            throw new Error('Cannot delete with empty prefix — this would delete the entire bucket.');
+        }
+        // List all objects under prefix (no delimiter → recursive)
+        const conn = this.getConnection();
+        const baseUrl = buildBaseUrl(conn);
+        const cloudFetch = this.getFetcher();
+        const keys = [];
+        let continuationToken;
+        do {
+            const params = new URLSearchParams({ 'list-type': '2' });
+            if (prefix)
+                params.set('prefix', prefix);
+            if (continuationToken)
+                params.set('continuation-token', continuationToken);
+            const res = await cloudFetch(`${baseUrl}?${params}`);
+            if (!res.ok)
+                throw new Error(`List failed (${res.status}): ${res.statusText}`);
+            const xml = await res.text();
+            const doc = new DOMParser().parseFromString(xml, 'application/xml');
+            for (const item of doc.querySelectorAll('Contents')) {
+                const key = item.querySelector('Key')?.textContent;
+                if (key)
+                    keys.push(key);
+            }
+            const isTruncated = doc.querySelector('IsTruncated')?.textContent === 'true';
+            continuationToken = isTruncated
+                ? (doc.querySelector('NextContinuationToken')?.textContent ?? undefined)
+                : undefined;
+        } while (continuationToken);
+        for (const key of keys) {
+            await this.delete(key);
+        }
+        return { deleted: keys.length };
+    }
+    async copy(srcKey, destKey) {
+        const conn = this.getConnection();
+        const url = `${buildBaseUrl(conn)}/${encodeKey(destKey)}`;
+        const cloudFetch = this.getFetcher();
+        const res = await cloudFetch(url, {
+            method: 'PUT',
+            headers: {
+                'x-amz-copy-source': `/${conn.bucket}/${encodeKey(srcKey)}`
+            }
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Copy failed (${res.status}): ${body || res.statusText}`);
+        }
+        return {
+            key: destKey,
+            size: 0,
+            e_tag: res.headers.get('etag') ?? undefined
+        };
+    }
+}

package/dist/storage/index.d.ts

@@ -0,0 +1,11 @@
+import type { StorageAdapter } from './adapter.js';
+export type { StorageAdapter } from './adapter.js';
+/**
+ * Returns the appropriate storage adapter for the given source.
+ * Caches adapter instances per connectionId.
+ */
+export declare function getAdapter(source: 'remote' | 'url', connectionId?: string): StorageAdapter;
+/**
+ * Clear cached adapter for a connection (call on connection update/delete).
+ */
+export declare function clearAdapterCache(connectionId: string): void;