@walkthru-earth/objex 0.1.0 → 1.1.0

package/dist/storage/providers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Provider registry — single source of truth for all cloud storage providers.
+ *
+ * Centralizes endpoint patterns, regions, auth methods, and UI metadata.
+ * Used by ConnectionDialog, browser-cloud adapter, host-detection, url-state, etc.
+ */
+export type ProviderId = 's3' | 'gcs' | 'r2' | 'minio' | 'azure' | 'storj' | 'b2' | 'digitalocean' | 'wasabi' | 'contabo' | 'hetzner' | 'linode' | 'ovhcloud';
+export interface ProviderRegion {
+    code: string;
+    label: string;
+}
+export interface ProviderDef {
+    /** Display label in the UI. */
+    label: string;
+    /** Short description shown as helper text. */
+    description: string;
+    /** Auth method used by this provider. */
+    authMethod: 'sigv4' | 'sas-token';
+    /** Whether the region field is relevant for this provider. */
+    needsRegion: boolean;
+    /** Whether the endpoint field is required. */
+    needsEndpoint: boolean;
+    /** Default region when creating a new connection. */
+    defaultRegion: string;
+    /**
+     * Endpoint template with `{region}` placeholder.
+     * If null, the user must provide a custom endpoint (e.g. MinIO).
+     * If a fixed string (no `{region}`), it's always the same (e.g. GCS).
+     */
+    endpointTemplate: string | null;
+    /** Known regions with labels. Empty = free-form region input. */
+    regions: ProviderRegion[];
+    /** Bucket label override (e.g. Azure uses "Container"). */
+    bucketLabel?: string;
+    /** Default endpoint placeholder shown in the input. */
+    endpointPlaceholder: string;
+    /** URI schemes that map to this provider (lowercase, without "://"). */
+    schemes: string[];
+}
+export declare const PROVIDERS: Record<ProviderId, ProviderDef>;
+/** All provider IDs, ordered for the UI. */
+export declare const PROVIDER_IDS: ProviderId[];
+/** Get provider def, falling back to S3 for unknown. */
+export declare function getProvider(id: string): ProviderDef;
+/** Build endpoint URL from template + region. */
+export declare function buildEndpointFromTemplate(id: ProviderId, region: string): string;
+/**
+ * Build the base URL for API requests (endpoint + bucket).
+ * Used by browser-cloud adapter and url-state.
+ */
+export declare function buildProviderBaseUrl(provider: ProviderId, endpoint: string, bucket: string, region: string): string;
+/** Check if a provider uses the GCS JSON API (not S3 XML). */
+export declare function isGcsProvider(provider: string, endpoint: string): boolean;

package/dist/storage/providers.js

@@ -0,0 +1,318 @@
+/**
+ * Provider registry — single source of truth for all cloud storage providers.
+ *
+ * Centralizes endpoint patterns, regions, auth methods, and UI metadata.
+ * Used by ConnectionDialog, browser-cloud adapter, host-detection, url-state, etc.
+ */
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+export const PROVIDERS = {
+    s3: {
+        label: 'AWS S3',
+        description: 'Amazon S3 or any S3-compatible service',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'us-east-1',
+        endpointTemplate: null,
+        regions: [
+            { code: 'us-east-1', label: 'US East (N. Virginia)' },
+            { code: 'us-east-2', label: 'US East (Ohio)' },
+            { code: 'us-west-1', label: 'US West (N. California)' },
+            { code: 'us-west-2', label: 'US West (Oregon)' },
+            { code: 'eu-west-1', label: 'EU (Ireland)' },
+            { code: 'eu-west-2', label: 'EU (London)' },
+            { code: 'eu-west-3', label: 'EU (Paris)' },
+            { code: 'eu-central-1', label: 'EU (Frankfurt)' },
+            { code: 'eu-central-2', label: 'EU (Zurich)' },
+            { code: 'eu-north-1', label: 'EU (Stockholm)' },
+            { code: 'eu-south-1', label: 'EU (Milan)' },
+            { code: 'eu-south-2', label: 'EU (Spain)' },
+            { code: 'ap-northeast-1', label: 'Asia Pacific (Tokyo)' },
+            { code: 'ap-northeast-2', label: 'Asia Pacific (Seoul)' },
+            { code: 'ap-northeast-3', label: 'Asia Pacific (Osaka)' },
+            { code: 'ap-southeast-1', label: 'Asia Pacific (Singapore)' },
+            { code: 'ap-southeast-2', label: 'Asia Pacific (Sydney)' },
+            { code: 'ap-southeast-3', label: 'Asia Pacific (Jakarta)' },
+            { code: 'ap-south-1', label: 'Asia Pacific (Mumbai)' },
+            { code: 'ap-south-2', label: 'Asia Pacific (Hyderabad)' },
+            { code: 'ap-east-1', label: 'Asia Pacific (Hong Kong)' },
+            { code: 'sa-east-1', label: 'South America (São Paulo)' },
+            { code: 'ca-central-1', label: 'Canada (Central)' },
+            { code: 'ca-west-1', label: 'Canada (Calgary)' },
+            { code: 'me-south-1', label: 'Middle East (Bahrain)' },
+            { code: 'me-central-1', label: 'Middle East (UAE)' },
+            { code: 'af-south-1', label: 'Africa (Cape Town)' },
+            { code: 'il-central-1', label: 'Israel (Tel Aviv)' }
+        ],
+        endpointPlaceholder: 'Leave empty for AWS, or enter custom S3 endpoint',
+        schemes: ['s3', 's3a', 's3n', 'aws']
+    },
+    gcs: {
+        label: 'Google Cloud',
+        description: 'Google Cloud Storage',
+        authMethod: 'sigv4',
+        needsRegion: false,
+        needsEndpoint: false,
+        defaultRegion: 'auto',
+        endpointTemplate: 'https://storage.googleapis.com',
+        regions: [],
+        endpointPlaceholder: 'https://storage.googleapis.com',
+        schemes: ['gs', 'gcs']
+    },
+    r2: {
+        label: 'Cloudflare R2',
+        description: 'Cloudflare R2 Storage',
+        authMethod: 'sigv4',
+        needsRegion: false,
+        needsEndpoint: true,
+        defaultRegion: 'auto',
+        endpointTemplate: null,
+        regions: [],
+        endpointPlaceholder: 'https://<account-id>.r2.cloudflarestorage.com',
+        schemes: ['r2']
+    },
+    azure: {
+        label: 'Azure',
+        description: 'Azure Blob Storage',
+        authMethod: 'sas-token',
+        needsRegion: false,
+        needsEndpoint: true,
+        defaultRegion: '',
+        endpointTemplate: null,
+        regions: [],
+        bucketLabel: 'Container',
+        endpointPlaceholder: 'https://<account>.blob.core.windows.net',
+        schemes: ['azure', 'az', 'abfs', 'abfss', 'wasbs', 'adl']
+    },
+    minio: {
+        label: 'MinIO',
+        description: 'Self-hosted MinIO or S3-compatible',
+        authMethod: 'sigv4',
+        needsRegion: false,
+        needsEndpoint: true,
+        defaultRegion: 'us-east-1',
+        endpointTemplate: null,
+        regions: [],
+        endpointPlaceholder: 'https://minio.example.com or http://localhost:9000',
+        schemes: []
+    },
+    storj: {
+        label: 'Storj',
+        description: 'Storj Decentralized Cloud',
+        authMethod: 'sigv4',
+        needsRegion: false,
+        needsEndpoint: false,
+        defaultRegion: 'us1',
+        endpointTemplate: 'https://gateway.storjshare.io',
+        regions: [
+            { code: 'us1', label: 'US1' },
+            { code: 'eu1', label: 'EU1' },
+            { code: 'ap1', label: 'AP1' }
+        ],
+        endpointPlaceholder: 'https://gateway.storjshare.io',
+        schemes: ['storj', 'sj']
+    },
+    b2: {
+        label: 'Backblaze B2',
+        description: 'Backblaze B2 Cloud Storage',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'us-west-004',
+        endpointTemplate: 'https://s3.{region}.backblazeb2.com',
+        regions: [
+            { code: 'us-west-000', label: 'US West (Sacramento)' },
+            { code: 'us-west-001', label: 'US West (Stockton)' },
+            { code: 'us-west-002', label: 'US West (Phoenix)' },
+            { code: 'us-west-004', label: 'US West' },
+            { code: 'us-east-005', label: 'US East (Reston)' },
+            { code: 'eu-central-003', label: 'EU Central (Amsterdam)' },
+            { code: 'ca-central-001', label: 'Canada (Toronto)' }
+        ],
+        endpointPlaceholder: 'https://s3.us-west-004.backblazeb2.com',
+        schemes: []
+    },
+    digitalocean: {
+        label: 'DigitalOcean',
+        description: 'DigitalOcean Spaces',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'nyc3',
+        endpointTemplate: 'https://{region}.digitaloceanspaces.com',
+        regions: [
+            { code: 'nyc3', label: 'New York 3' },
+            { code: 'sfo3', label: 'San Francisco 3' },
+            { code: 'ams3', label: 'Amsterdam 3' },
+            { code: 'sgp1', label: 'Singapore 1' },
+            { code: 'lon1', label: 'London 1' },
+            { code: 'fra1', label: 'Frankfurt 1' },
+            { code: 'tor1', label: 'Toronto 1' },
+            { code: 'blr1', label: 'Bangalore 1' },
+            { code: 'syd1', label: 'Sydney 1' }
+        ],
+        endpointPlaceholder: 'https://nyc3.digitaloceanspaces.com',
+        schemes: []
+    },
+    wasabi: {
+        label: 'Wasabi',
+        description: 'Wasabi Hot Cloud Storage',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'us-east-1',
+        endpointTemplate: 'https://s3.{region}.wasabisys.com',
+        regions: [
+            { code: 'us-east-1', label: 'US East 1 (Virginia)' },
+            { code: 'us-east-2', label: 'US East 2 (Virginia)' },
+            { code: 'us-central-1', label: 'US Central 1 (Texas)' },
+            { code: 'us-west-1', label: 'US West 1 (Oregon)' },
+            { code: 'eu-central-1', label: 'EU Central 1 (Amsterdam)' },
+            { code: 'eu-central-2', label: 'EU Central 2 (Frankfurt)' },
+            { code: 'eu-west-1', label: 'EU West 1 (London)' },
+            { code: 'eu-west-2', label: 'EU West 2 (Paris)' },
+            { code: 'ap-northeast-1', label: 'AP Northeast 1 (Tokyo)' },
+            { code: 'ap-northeast-2', label: 'AP Northeast 2 (Osaka)' },
+            { code: 'ap-southeast-1', label: 'AP Southeast 1 (Singapore)' },
+            { code: 'ap-southeast-2', label: 'AP Southeast 2 (Sydney)' },
+            { code: 'ca-central-1', label: 'Canada (Toronto)' }
+        ],
+        endpointPlaceholder: 'https://s3.us-east-1.wasabisys.com',
+        schemes: []
+    },
+    contabo: {
+        label: 'Contabo',
+        description: 'Contabo Object Storage',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'eu2',
+        endpointTemplate: 'https://{region}.contabostorage.com',
+        regions: [
+            { code: 'eu2', label: 'European Union' },
+            { code: 'usc1', label: 'US Central' },
+            { code: 'sin1', label: 'Singapore' }
+        ],
+        endpointPlaceholder: 'https://eu2.contabostorage.com',
+        schemes: []
+    },
+    hetzner: {
+        label: 'Hetzner',
+        description: 'Hetzner Object Storage',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'fsn1',
+        endpointTemplate: 'https://{region}.your-objectstorage.com',
+        regions: [
+            { code: 'fsn1', label: 'Falkenstein, DE' },
+            { code: 'nbg1', label: 'Nuremberg, DE' },
+            { code: 'hel1', label: 'Helsinki, FI' }
+        ],
+        endpointPlaceholder: 'https://fsn1.your-objectstorage.com',
+        schemes: []
+    },
+    linode: {
+        label: 'Linode / Akamai',
+        description: 'Akamai / Linode Object Storage',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'us-east-1',
+        endpointTemplate: 'https://{region}.linodeobjects.com',
+        regions: [
+            { code: 'us-east-1', label: 'Newark, NJ' },
+            { code: 'us-southeast-1', label: 'Atlanta, GA' },
+            { code: 'us-ord-1', label: 'Chicago, IL' },
+            { code: 'us-iad-1', label: 'Washington, DC' },
+            { code: 'us-lax-1', label: 'Los Angeles, CA' },
+            { code: 'us-sea-1', label: 'Seattle, WA' },
+            { code: 'us-mia-1', label: 'Miami, FL' },
+            { code: 'eu-central-1', label: 'Frankfurt, DE' },
+            { code: 'nl-ams-1', label: 'Amsterdam, NL' },
+            { code: 'gb-lon-1', label: 'London, UK' },
+            { code: 'fr-par-1', label: 'Paris, FR' },
+            { code: 'ap-south-1', label: 'Singapore' },
+            { code: 'jp-osa-1', label: 'Osaka, JP' },
+            { code: 'au-mel-1', label: 'Melbourne, AU' },
+            { code: 'br-gru-1', label: 'São Paulo, BR' },
+            { code: 'in-maa-1', label: 'Chennai, IN' },
+            { code: 'id-cgk-1', label: 'Jakarta, ID' },
+            { code: 'it-mil-1', label: 'Milan, IT' },
+            { code: 'se-sto-1', label: 'Stockholm, SE' }
+        ],
+        endpointPlaceholder: 'https://us-east-1.linodeobjects.com',
+        schemes: []
+    },
+    ovhcloud: {
+        label: 'OVHcloud',
+        description: 'OVHcloud Object Storage',
+        authMethod: 'sigv4',
+        needsRegion: true,
+        needsEndpoint: false,
+        defaultRegion: 'gra',
+        endpointTemplate: 'https://s3.{region}.io.cloud.ovh.net',
+        regions: [
+            { code: 'gra', label: 'Gravelines, FR' },
+            { code: 'sbg', label: 'Strasbourg, FR' },
+            { code: 'bhs', label: 'Beauharnois, CA' },
+            { code: 'de', label: 'Frankfurt, DE' },
+            { code: 'uk', label: 'London, UK' },
+            { code: 'waw', label: 'Warsaw, PL' }
+        ],
+        endpointPlaceholder: 'https://s3.gra.io.cloud.ovh.net',
+        schemes: []
+    }
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** All provider IDs, ordered for the UI. */
+export const PROVIDER_IDS = [
+    's3',
+    'gcs',
+    'r2',
+    'azure',
+    'b2',
+    'digitalocean',
+    'wasabi',
+    'storj',
+    'hetzner',
+    'contabo',
+    'linode',
+    'ovhcloud',
+    'minio'
+];
+/** Get provider def, falling back to S3 for unknown. */
+export function getProvider(id) {
+    return PROVIDERS[id] ?? PROVIDERS.s3;
+}
+/** Build endpoint URL from template + region. */
+export function buildEndpointFromTemplate(id, region) {
+    const def = PROVIDERS[id];
+    if (!def?.endpointTemplate)
+        return '';
+    return def.endpointTemplate.replace('{region}', region);
+}
+/**
+ * Build the base URL for API requests (endpoint + bucket).
+ * Used by browser-cloud adapter and url-state.
+ */
+export function buildProviderBaseUrl(provider, endpoint, bucket, region) {
+    if (endpoint) {
+        return `${endpoint.replace(/\/$/, '')}/${bucket}`;
+    }
+    const def = PROVIDERS[provider];
+    if (def?.endpointTemplate) {
+        const resolved = def.endpointTemplate.replace('{region}', region || def.defaultRegion);
+        return `${resolved}/${bucket}`;
+    }
+    // Fallback: AWS S3 path-style
+    return `https://s3.${region || 'us-east-1'}.amazonaws.com/${bucket}`;
+}
+/** Check if a provider uses the GCS JSON API (not S3 XML). */
+export function isGcsProvider(provider, endpoint) {
+    return provider === 'gcs' || (!!endpoint && /storage\.googleapis\.com/i.test(endpoint));
+}

package/dist/stores/connections.svelte.js

@@ -1,32 +1,6 @@
+import { STORAGE_KEYS } from '../constants.js';
+import { loadFromStorage, persistToStorage } from '../utils/local-storage.js';
 import { credentialStore, storeToNative } from './credentials.svelte.js';
-const CONNECTIONS_KEY = 'obstore-explore-connections';
-// ---------------------------------------------------------------------------
-// localStorage helpers
-// ---------------------------------------------------------------------------
-function loadFromLocalStorage() {
-    if (typeof window === 'undefined')
-        return [];
-    try {
-        const raw = localStorage.getItem(CONNECTIONS_KEY);
-        if (raw) {
-            return JSON.parse(raw);
-        }
-    }
-    catch {
-        // ignore parse errors
-    }
-    return [];
-}
-function persistToLocalStorage(connections) {
-    if (typeof window === 'undefined')
-        return;
-    try {
-        localStorage.setItem(CONNECTIONS_KEY, JSON.stringify(connections));
-    }
-    catch {
-        // ignore storage errors
-    }
-}
 // ---------------------------------------------------------------------------
 // Store
 // ---------------------------------------------------------------------------
@@ -48,7 +22,7 @@ function createConnectionsStore() {
         async load() {
             if (loaded)
                 return;
-            connections = loadFromLocalStorage();
+            connections = loadFromStorage(STORAGE_KEYS.CONNECTIONS, []);
             loaded = true;
         },
         /**
@@ -75,7 +49,7 @@ function createConnectionsStore() {
                 rootPrefix: config.rootPrefix
             };
             connections = [...connections, conn];
-            persistToLocalStorage(connections);
+            persistToStorage(STORAGE_KEYS.CONNECTIONS, connections);
             // Store credentials in memory (never persisted to localStorage).
             if (!config.anonymous) {
                 if (config.sas_token) {
@@ -114,7 +88,7 @@ function createConnectionsStore() {
                 rootPrefix: config.rootPrefix
             };
             connections = [...connections];
-            persistToLocalStorage(connections);
+            persistToStorage(STORAGE_KEYS.CONNECTIONS, connections);
             // Invalidate cached adapter for this connection
             import('../storage/index.js').then(({ clearAdapterCache }) => clearAdapterCache(id));
             // Update in-memory credentials.
@@ -148,7 +122,7 @@ function createConnectionsStore() {
         async remove(id) {
             const before = connections.length;
             connections = connections.filter((c) => c.id !== id);
-            persistToLocalStorage(connections);
+            persistToStorage(STORAGE_KEYS.CONNECTIONS, connections);
             credentialStore.remove(id);
             // Invalidate cached adapter for this connection
             import('../storage/index.js').then(({ clearAdapterCache }) => clearAdapterCache(id));
@@ -158,7 +132,7 @@ function createConnectionsStore() {
          * Test whether a connection is reachable via a lightweight list.
          */
         async test(id) {
-            const { getAdapter } = await import(/* @vite-ignore */ '$lib/storage/index.js');
+            const { getAdapter } = await import('../storage/index.js');
             const adapter = getAdapter('remote', id);
             await adapter.list('');
             return true;
@@ -200,7 +174,7 @@ function createConnectionsStore() {
                 }
             }
             try {
-                const { getAdapter } = await import(/* @vite-ignore */ '$lib/storage/index.js');
+                const { getAdapter } = await import('../storage/index.js');
                 const adapter = getAdapter('remote', tempId);
                 await adapter.list(config.rootPrefix || '');
                 return true;

package/dist/stores/files.svelte.d.ts

@@ -1,10 +1,5 @@
 import type { FileEntry } from '../types.js';
-export type SortField = 'name' | 'size' | 'modified' | 'extension';
-export type SortDirection = 'asc' | 'desc';
-export interface SortConfig {
-    field: SortField;
-    direction: SortDirection;
-}
+import { type SortConfig, type SortField } from '../utils/file-sort.js';
 export declare const fileStore: {
     readonly entries: FileEntry[];
     readonly currentPath: string;

package/dist/stores/files.svelte.js

@@ -1,27 +1,4 @@
-function sortEntries(entries, config) {
-    const sorted = [...entries];
-    const dir = config.direction === 'asc' ? 1 : -1;
-    sorted.sort((a, b) => {
-        // Directories always come first
-        if (a.is_dir && !b.is_dir)
-            return -1;
-        if (!a.is_dir && b.is_dir)
-            return 1;
-        switch (config.field) {
-            case 'name':
-                return dir * a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
-            case 'size':
-                return dir * (a.size - b.size);
-            case 'modified':
-                return dir * (a.modified - b.modified);
-            case 'extension':
-                return dir * a.extension.localeCompare(b.extension, undefined, { sensitivity: 'base' });
-            default:
-                return 0;
-        }
-    });
-    return sorted;
-}
+import { sortFileEntries, toggleSortField } from '../utils/file-sort.js';
 function createFilesStore() {
     let files = $state([]);
     let currentPath = $state('');
@@ -45,7 +22,7 @@ function createFilesStore() {
             return sortConfig;
         },
         setFiles(entries) {
-            files = sortEntries(entries, sortConfig);
+            files = sortFileEntries(entries, sortConfig);
             error = null;
         },
         setPath(path) {
@@ -58,17 +35,8 @@ function createFilesStore() {
             error = message;
         },
         sort(field) {
-            if (sortConfig.field === field) {
-                // Toggle direction if clicking the same field
-                sortConfig = {
-                    field,
-                    direction: sortConfig.direction === 'asc' ? 'desc' : 'asc'
-                };
-            }
-            else {
-                sortConfig = { field, direction: 'asc' };
-            }
-            files = sortEntries(files, sortConfig);
+            sortConfig = toggleSortField(sortConfig, field);
+            files = sortFileEntries(files, sortConfig);
         }
     };
 }

package/dist/stores/query-history.svelte.js

@@ -1,32 +1,9 @@
-const STORAGE_KEY = 'obstore-explore-query-history';
-const MAX_ENTRIES = 200;
-function loadEntries() {
-    if (typeof window === 'undefined')
-        return [];
-    try {
-        const raw = localStorage.getItem(STORAGE_KEY);
-        if (raw)
-            return JSON.parse(raw);
-    }
-    catch {
-        // ignore parse errors
-    }
-    return [];
-}
-function persistEntries(entries) {
-    if (typeof window === 'undefined')
-        return;
-    try {
-        localStorage.setItem(STORAGE_KEY, JSON.stringify(entries));
-    }
-    catch {
-        // ignore storage errors
-    }
-}
+import { MAX_QUERY_HISTORY_ENTRIES, STORAGE_KEYS } from '../constants.js';
+import { loadFromStorage, persistToStorage } from '../utils/local-storage.js';
 function createQueryHistoryStore() {
-    let entries = $state(loadEntries());
+    let entries = $state(loadFromStorage(STORAGE_KEYS.QUERY_HISTORY, []));
     function save() {
-        persistEntries(entries);
+        persistToStorage(STORAGE_KEYS.QUERY_HISTORY, entries);
     }
     return {
         get entries() {
@@ -37,7 +14,7 @@ function createQueryHistoryStore() {
                 ...entry,
                 id: crypto.randomUUID()
             };
-            entries = [newEntry, ...entries].slice(0, MAX_ENTRIES);
+            entries = [newEntry, ...entries].slice(0, MAX_QUERY_HISTORY_ENTRIES);
             save();
         },
         remove(id) {

package/dist/stores/settings.svelte.d.ts

@@ -1,5 +1,6 @@
 import { type Locale } from '../i18n/index.svelte.js';
 import type { Theme } from '../types.js';
+export declare function resolveTheme(theme: Theme): 'light' | 'dark';
 export declare const settings: {
     readonly theme: Theme;
     readonly resolved: "light" | "dark";

package/dist/stores/settings.svelte.js

@@ -1,36 +1,16 @@
+import { STORAGE_KEYS } from '../constants.js';
 import { setLocale } from '../i18n/index.svelte.js';
-const SETTINGS_KEY = 'obstore-explore-settings';
+import { loadFromStorage, persistToStorage } from '../utils/local-storage.js';
+const SETTINGS_DEFAULTS = { theme: 'system', locale: 'en', featureLimit: 1000 };
 function loadSettings() {
-    if (typeof window === 'undefined') {
-        return { theme: 'system', locale: 'en', featureLimit: 1000 };
-    }
-    try {
-        const raw = localStorage.getItem(SETTINGS_KEY);
-        if (raw) {
-            const parsed = JSON.parse(raw);
-            return {
-                theme: parsed.theme ?? 'system',
-                locale: parsed.locale ?? 'en',
-                featureLimit: parsed.featureLimit ?? 100
-            };
-        }
-    }
-    catch {
-        // ignore parse errors
-    }
-    return { theme: 'system', locale: 'en', featureLimit: 1000 };
-}
-function persistSettings(settings) {
-    if (typeof window === 'undefined')
-        return;
-    try {
-        localStorage.setItem(SETTINGS_KEY, JSON.stringify(settings));
-    }
-    catch {
-        // ignore storage errors
-    }
+    const stored = loadFromStorage(STORAGE_KEYS.SETTINGS, {});
+    return {
+        theme: stored.theme ?? SETTINGS_DEFAULTS.theme,
+        locale: stored.locale ?? SETTINGS_DEFAULTS.locale,
+        featureLimit: stored.featureLimit ?? SETTINGS_DEFAULTS.featureLimit
+    };
 }
-function resolveTheme(theme) {
+export function resolveTheme(theme) {
     if (theme !== 'system')
         return theme;
     if (typeof window === 'undefined')
@@ -51,7 +31,7 @@ function createSettingsStore() {
         document.documentElement.lang = initial.locale;
     }
     function persist() {
-        persistSettings({ theme, locale, featureLimit });
+        persistToStorage(STORAGE_KEYS.SETTINGS, { theme, locale, featureLimit });
     }
     function applyTheme(t) {
         theme = t;

package/dist/types.d.ts

@@ -9,7 +9,7 @@ export interface FileEntry {
 export interface Connection {
     id: string;
     name: string;
-    provider: 's3' | 'gcs' | 'r2' | 'minio' | 'azure' | 'storj';
+    provider: string;
     endpoint: string;
     bucket: string;
     region: string;
@@ -19,7 +19,7 @@ export interface Connection {
 }
 export interface ConnectionConfig {
     name: string;
-    provider: 's3' | 'gcs' | 'r2' | 'minio' | 'azure' | 'storj';
+    provider: string;
     endpoint: string;
     bucket: string;
     region: string;

package/dist/utils/clipboard.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copy text to clipboard and run a feedback callback for COPY_FEEDBACK_MS.
+ * Silently catches clipboard errors (e.g. insecure context).
+ *
+ * @returns true if copy succeeded, false otherwise.
+ */
+export declare function copyToClipboard(text: string, onFeedback?: (copied: boolean) => void): Promise<boolean>;
+/**
+ * Wire click-to-copy on all elements matching `selector` inside `root`.
+ * Each element must have `data-code` (URI-encoded) with the text to copy.
+ * Adds/removes a `copied` CSS class for visual feedback.
+ */
+export declare function wireCodeCopyButtons(root: Element, selector: string): void;