@vibesdotdev/storage 0.0.1 → 1.0.0-rc.3

package/dist/svelte/platform-storage-port.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Storage's view of the Platform runtime client (`runtime/client#platform`).
+ *
+ * Platform depends on Storage, so this surface imports no Platform module. It
+ * resolves the `platform` runtime client by kind on the runtime it was handed
+ * and admits only the `storage` namespace slice each caller uses; the slice
+ * types are declared here, by the consumer. Platform proves at compile time
+ * that its client's `storage` namespace satisfies {@link PlatformStorageNamespace}
+ * (`@vibesdotdev/platform/svelte/storage`).
+ *
+ * A client that does not answer the requested slice is refused typed
+ * (`UNAVAILABLE` `storage-platform-client-unsupported`); a missing `platform`
+ * client is the runtime's own typed absence.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { StorageDrive, StorageEntry, StorageObjectRef, StorageObjectUrl, StorageScopeFilter, StorageTarget } from '@vibesdotdev/storage/schemas';
+import type { CreateStorageProviderInput, StorageProviderDetail } from '@vibesdotdev/storage/schemas/storage-provider';
+/** The `runtime/client` id Platform registers its API client under. */
+export declare const PLATFORM_CLIENT_ID = "platform";
+/** A drive target's opaque adapter config, passed back to browse and search as resolved. */
+export type StorageAdapterConfig = NonNullable<StorageTarget['config']>;
+/** Provider listing and management. */
+export interface PlatformStorageProvidersPort {
+    listProviders(): Promise<{
+        providers: StorageProviderDetail[];
+    }>;
+    createProvider(input: CreateStorageProviderInput): Promise<{
+        provider: StorageProviderDetail;
+    }>;
+    deleteProvider(providerId: string): Promise<void>;
+}
+/** Enumeration of a `browse`-capable storage adapter. */
+export interface PlatformStorageBrowsePort {
+    listDrives(adapterId: string, config?: StorageAdapterConfig): Promise<StorageDrive[]>;
+    list(adapterId: string, driveId: string, path?: string, config?: StorageAdapterConfig, options?: {
+        itemId?: string;
+    }): Promise<StorageEntry[]>;
+}
+/** Search within a `search`-capable storage adapter. */
+export interface PlatformStorageSearchPort {
+    search(adapterId: string, driveId: string, query: string, options?: {
+        path?: string;
+        limit?: number;
+    }, config?: StorageAdapterConfig): Promise<StorageEntry[]>;
+}
+/** Object writes and serving URLs over a drive target. */
+export interface PlatformStorageObjectsPort {
+    upload(target: StorageTarget, key: string, file: Blob, options?: {
+        contentType?: string;
+    }): Promise<StorageObjectRef>;
+    delete(target: StorageTarget, key: string): Promise<void>;
+    url(target: StorageTarget, key: string, options?: {
+        ttlSeconds?: number;
+        disposition?: 'inline' | 'attachment';
+    }): Promise<StorageObjectUrl>;
+}
+/** The scope's drives (every backend the caller can reach, narrowed by the filter). */
+export interface PlatformStorageDrivesPort {
+    drives(scope?: {
+        projectId?: string;
+        filter?: StorageScopeFilter;
+    }): Promise<StorageTarget[]>;
+}
+/** Every slice of the Platform client's `storage` namespace Storage's UI calls. */
+export interface PlatformStorageNamespace extends PlatformStorageProvidersPort, PlatformStorageDrivesPort {
+    browse: PlatformStorageBrowsePort;
+    search: PlatformStorageSearchPort;
+    objects: PlatformStorageObjectsPort;
+}
+/** The explorer slice as resolved: drives, browse and objects; search only when answered. */
+export interface PlatformStorageExplorerPort {
+    drives: PlatformStorageDrivesPort['drives'];
+    browse: PlatformStorageBrowsePort;
+    objects: PlatformStorageObjectsPort;
+    search?: PlatformStorageSearchPort;
+}
+/** Provider listing and management on the runtime's Platform client. */
+export declare function resolvePlatformStorageProviders(runtime: VibesRuntime): Promise<PlatformStorageProvidersPort>;
+/** Adapter browse on the runtime's Platform client. */
+export declare function resolvePlatformStorageBrowse(runtime: VibesRuntime): Promise<PlatformStorageBrowsePort>;
+/**
+ * The explorer slice on the runtime's Platform client: drives, browse and
+ * objects are required; search is present only when the client answers it.
+ */
+export declare function resolvePlatformStorageExplorer(runtime: VibesRuntime): Promise<PlatformStorageExplorerPort>;
+//# sourceMappingURL=platform-storage-port.d.ts.map

package/dist/svelte/platform-storage-port.d.ts.map

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

package/dist/svelte/platform-storage-port.js

@@ -0,0 +1,71 @@
+/**
+ * Storage's view of the Platform runtime client (`runtime/client#platform`).
+ *
+ * Platform depends on Storage, so this surface imports no Platform module. It
+ * resolves the `platform` runtime client by kind on the runtime it was handed
+ * and admits only the `storage` namespace slice each caller uses; the slice
+ * types are declared here, by the consumer. Platform proves at compile time
+ * that its client's `storage` namespace satisfies {@link PlatformStorageNamespace}
+ * (`@vibesdotdev/platform/svelte/storage`).
+ *
+ * A client that does not answer the requested slice is refused typed
+ * (`UNAVAILABLE` `storage-platform-client-unsupported`); a missing `platform`
+ * client is the runtime's own typed absence.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+/** The `runtime/client` id Platform registers its API client under. */
+export const PLATFORM_CLIENT_ID = 'platform';
+const ProvidersSliceSchema = z.object({
+    storage: z.object({ listProviders: z.function(), createProvider: z.function(), deleteProvider: z.function() })
+});
+const BrowseSliceSchema = z.object({
+    storage: z.object({ browse: z.object({ listDrives: z.function(), list: z.function() }) })
+});
+const ExplorerSliceSchema = z.object({
+    storage: z.object({
+        drives: z.function(),
+        browse: z.object({ listDrives: z.function(), list: z.function() }),
+        objects: z.object({ upload: z.function(), delete: z.function(), url: z.function() })
+    })
+});
+const SearchSliceSchema = z.object({ search: z.object({ search: z.function() }) });
+function unsupported(slice) {
+    return new CapabilityError(`The Platform client does not expose storage ${slice}.`, 'UNAVAILABLE', {
+        reason: 'storage-platform-client-unsupported',
+        retryable: false,
+        details: { slice }
+    });
+}
+/** The runtime's Platform client's `storage` namespace, admitted by `slice` before it is returned. */
+async function platformStorage(runtime, name, slice) {
+    const client = await getVibesClient(PLATFORM_CLIENT_ID, runtime);
+    if (!slice.safeParse(client).success)
+        throw unsupported(name);
+    return client.storage;
+}
+/** Provider listing and management on the runtime's Platform client. */
+export async function resolvePlatformStorageProviders(runtime) {
+    return platformStorage(runtime, 'providers', ProvidersSliceSchema);
+}
+/** Adapter browse on the runtime's Platform client. */
+export async function resolvePlatformStorageBrowse(runtime) {
+    const storage = await platformStorage(runtime, 'browse', BrowseSliceSchema);
+    return storage.browse;
+}
+/**
+ * The explorer slice on the runtime's Platform client: drives, browse and
+ * objects are required; search is present only when the client answers it.
+ */
+export async function resolvePlatformStorageExplorer(runtime) {
+    const storage = await platformStorage(runtime, 'drives/browse/objects', ExplorerSliceSchema);
+    const explorer = {
+        drives: (scope) => storage.drives(scope),
+        browse: storage.browse,
+        objects: storage.objects
+    };
+    if (SearchSliceSchema.safeParse(storage).success)
+        explorer.search = storage.search;
+    return explorer;
+}

package/dist/svelte/storage-browse-runtime.d.ts

@@ -0,0 +1,65 @@
+import type { StorageSortKey, StorageSortDir } from '../schemas/explorer/views.ts';
+export type { BrowseLocationContext, StorageBrowserEntryDecoration, StorageSortKey, StorageSortDir } from '../schemas/explorer/views.ts';
+/**
+ * Storage-browse runtime helpers.
+ *
+ * Wraps the runtime Platform client's `storage.browse` (resolved by kind through
+ * `./platform-storage-port.ts`) so cross-app surfaces (the
+ * StorageBrowser component, Casework Files, AI model-source pickers, …) can
+ * enumerate a `browse`-capable `storage/adapter` (SharePoint, …) without
+ * touching adapter-specific endpoints. The platform client resolves the browse
+ * request through the runtime; the endpoint is just the cloud transport.
+ *
+ * Non-Svelte module (safe to import anywhere). The reactive store lives in
+ * `./stores/storage-browse.svelte.ts`.
+ */
+import type { StorageDrive, StorageEntry, StorageTarget } from '@vibesdotdev/storage/schemas';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export type { StorageDrive, StorageEntry };
+/** A drive target's opaque adapter config, passed back to the Platform client as resolved. */
+export type StorageBrowseConfig = NonNullable<StorageTarget['config']>;
+/**
+ * Client surface consumed by the store. Implemented either by an injected test
+ * double or by the canonical platform client's `storage.browse` namespace.
+ */
+export interface PlatformStorageBrowseClient {
+    listDrives(adapterId: string, config?: StorageBrowseConfig): Promise<StorageDrive[]>;
+    listEntries(adapterId: string, driveId: string, path?: string, config?: StorageBrowseConfig, options?: {
+        itemId?: string;
+    }): Promise<StorageEntry[]>;
+}
+/** The browser's current location, passed to rowActions/decorate so app-supplied
+ *  actions know which drive + path an entry lives in (e.g. to build a link). */
+type ActionVariant = 'default' | 'ghost' | 'outline' | 'secondary';
+/** A per-entry action rendered by the StorageBrowser (e.g. "Create job from folder"). */
+export interface StorageBrowserAction {
+    id: string;
+    label: string;
+    icon?: string;
+    variant?: ActionVariant;
+    run: (entry: StorageEntry) => void | Promise<void>;
+    /** Hide the action for entries that fail this predicate. */
+    visible?: (entry: StorageEntry) => boolean;
+}
+/** A toolbar action rendered in the browser header (e.g. "Import folder"). */
+export interface StorageBrowserHeaderAction {
+    id: string;
+    label: string;
+    icon?: string;
+    variant?: ActionVariant;
+    run: () => void | Promise<void>;
+}
+/** Host-supplied decoration for an entry row (badge / disabled state). */
+/** Sortable column for the browser's entry list. */
+/** Sort direction. */
+/**
+ * Pure comparator for `StorageEntry` rows — directories always sort before
+ * files (Finder-style), then by the requested key/direction. Entries missing
+ * the keyed value (e.g. directories have no `sizeBytes`, sources may omit
+ * `modifiedAt`) sort last regardless of direction, so empty cells never lead.
+ * Stable when the keyed values tie (falls back to a case-insensitive name
+ * compare). Non-Svelte / no side effects — safe to call from a `$derived`.
+ */
+export declare function compareEntries(a: StorageEntry, b: StorageEntry, key: StorageSortKey, dir: StorageSortDir): number;
+export declare function resolvePlatformStorageBrowseClient(runtime: VibesRuntime, client?: PlatformStorageBrowseClient): Promise<PlatformStorageBrowseClient>;
+//# sourceMappingURL=storage-browse-runtime.d.ts.map

package/dist/svelte/storage-browse-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-browse-runtime.d.ts","sourceRoot":"","sources":["../../src/svelte/storage-browse-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnF,YAAY,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACzI;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AAE3C,8FAA8F;AAC9F,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC3C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACrF,WAAW,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC3B;AAED;gFACgF;AAGhF,KAAK,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEnE,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;CAC3C;AAED,8EAA8E;AAC9E,MAAM,WAAW,0BAA0B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,0EAA0E;AAG1E,oDAAoD;AAEpD,sBAAsB;AAGtB;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC7B,CAAC,EAAE,YAAY,EACf,CAAC,EAAE,YAAY,EACf,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,cAAc,GACjB,MAAM,CAyBR;AA4BD,wBAAsB,kCAAkC,CACvD,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,2BAA2B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAQtC"}

package/dist/svelte/storage-browse-runtime.js

@@ -0,0 +1,68 @@
+import { resolvePlatformStorageBrowse } from "./platform-storage-port.js";
+/** Host-supplied decoration for an entry row (badge / disabled state). */
+/** Sortable column for the browser's entry list. */
+/** Sort direction. */
+/**
+ * Pure comparator for `StorageEntry` rows — directories always sort before
+ * files (Finder-style), then by the requested key/direction. Entries missing
+ * the keyed value (e.g. directories have no `sizeBytes`, sources may omit
+ * `modifiedAt`) sort last regardless of direction, so empty cells never lead.
+ * Stable when the keyed values tie (falls back to a case-insensitive name
+ * compare). Non-Svelte / no side effects — safe to call from a `$derived`.
+ */
+export function compareEntries(a, b, key, dir) {
+    // Directories first, independent of key/direction.
+    if (a.kind !== b.kind)
+        return a.kind === 'directory' ? -1 : 1;
+    const sign = dir === 'desc' ? -1 : 1;
+    // Stable tiebreak (case-insensitive name); never flipped by direction so the
+    // secondary order is predictable regardless of the chosen column.
+    const byName = a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
+    switch (key) {
+        case 'name':
+            return sign * byName || byName;
+        case 'kind':
+            // `kind` already split out above (dirs-first), so within a group only
+            // the name distinguishes rows.
+            return sign * byName || byName;
+        case 'size':
+            return orderBy(presence(a.sizeBytes, b.sizeBytes) ?? sign * numCmp(a.sizeBytes, b.sizeBytes), byName);
+        case 'modified':
+            // ISO 8601 strings compare lexicographically in chronological order.
+            return orderBy(presence(a.modifiedAt, b.modifiedAt) ?? sign * strCmp(a.modifiedAt, b.modifiedAt), byName);
+    }
+}
+/** Resolve presence ordering for an optional field: undefined sorts last and
+ *  is NEVER flipped by direction (so empty cells stay at the bottom in both
+ *  asc and desc). Returns `null` when both are present — the caller then does
+ *  the keyed compare. */
+function presence(a, b) {
+    const aMissing = a === undefined;
+    const bMissing = b === undefined;
+    if (aMissing && bMissing)
+        return 0;
+    if (aMissing)
+        return 1;
+    if (bMissing)
+        return -1;
+    return null;
+}
+/** Apply the keyed result, falling back to the stable name tiebreak on a tie. */
+function orderBy(primary, byName) {
+    return primary || byName;
+}
+function numCmp(a, b) {
+    return a - b;
+}
+function strCmp(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+export async function resolvePlatformStorageBrowseClient(runtime, client) {
+    if (client)
+        return client;
+    const browse = await resolvePlatformStorageBrowse(runtime);
+    return {
+        listDrives: (adapterId, config) => browse.listDrives(adapterId, config),
+        listEntries: (adapterId, driveId, path, config, options) => browse.list(adapterId, driveId, path, config, options)
+    };
+}

package/dist/svelte/storage-connection.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Whether a storage browse failure means the provider is not connected, so a
+ * surface offers a connect action instead of an error: an auth or permission
+ * failure, the typed not-connected reason, or the browse route's HTTP 412
+ * (missing provider credential). Read from code, reason and status, never
+ * from message text.
+ */
+import * as z from 'zod/v4';
+import type { CapabilityError, CaughtFailure } from '@vibesdotdev/kernel';
+export declare function isStorageNotConnected(failure: CapabilityError): boolean;
+/** The external object stores a user connects with their own credentials. */
+export declare const ExternalStorageProviderTypeSchema: z.ZodEnum<{
+    user_s3: "user_s3";
+    user_r2: "user_r2";
+    user_gcs: "user_gcs";
+}>;
+/**
+ * What the connect dialog tells the user about a failed connect or provision:
+ * an action they can take, chosen by the failure's code. The failure's text
+ * (which can carry a provider body or an echoed credential) is never shown.
+ */
+export declare function storageConnectFailureCopy(cause: CaughtFailure): string;
+//# sourceMappingURL=storage-connection.d.ts.map

package/dist/svelte/storage-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-connection.d.ts","sourceRoot":"","sources":["../../src/svelte/storage-connection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAM1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAIvE;AAED,6EAA6E;AAC7E,eAAO,MAAM,iCAAiC;;;;EAA6C,CAAC;AAE5F;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CActE"}

package/dist/svelte/storage-connection.js

@@ -0,0 +1,40 @@
+/**
+ * Whether a storage browse failure means the provider is not connected, so a
+ * surface offers a connect action instead of an error: an auth or permission
+ * failure, the typed not-connected reason, or the browse route's HTTP 412
+ * (missing provider credential). Read from code, reason and status, never
+ * from message text.
+ */
+import * as z from 'zod/v4';
+import { STORAGE_REQUEST_FAILED, storageSurfaceFailure } from "../client/storage-failure.js";
+/** The browse route's missing-credential answer. */
+const PreconditionFailedSchema = z.object({ status: z.literal(412) });
+export function isStorageNotConnected(failure) {
+    if (failure.code === 'AUTH_REQUIRED' || failure.code === 'PERMISSION_DENIED')
+        return true;
+    if (failure.reason === 'storage-provider-not-connected')
+        return true;
+    return failure.reason === STORAGE_REQUEST_FAILED && PreconditionFailedSchema.safeParse(failure.details).success;
+}
+/** The external object stores a user connects with their own credentials. */
+export const ExternalStorageProviderTypeSchema = z.enum(['user_s3', 'user_r2', 'user_gcs']);
+/**
+ * What the connect dialog tells the user about a failed connect or provision:
+ * an action they can take, chosen by the failure's code. The failure's text
+ * (which can carry a provider body or an echoed credential) is never shown.
+ */
+export function storageConnectFailureCopy(cause) {
+    const failure = storageSurfaceFailure(cause);
+    switch (failure.code) {
+        case 'AUTH_REQUIRED':
+            return 'Sign in again, then retry.';
+        case 'PERMISSION_DENIED':
+            return 'You do not have permission to add storage here.';
+        case 'INVALID_INPUT':
+            return 'Check the bucket, region and credentials, then try again.';
+        case 'CONFLICT':
+            return 'That storage is already connected.';
+        default:
+            return 'Something went wrong. Please try again.';
+    }
+}

package/dist/svelte/storage-display.d.ts

@@ -0,0 +1,6 @@
+export declare function getStorageProviderTypeLabel(type: string | null | undefined): string;
+export declare function getStorageProviderTypeShortLabel(type: string | null | undefined): string;
+export declare function getStorageProviderIcon(type: string | null | undefined): string;
+export declare function getStorageProviderColorClass(type: string | null | undefined): string;
+export declare function getStorageBillingModeLabel(mode: string | null | undefined): string;
+//# sourceMappingURL=storage-display.d.ts.map

package/dist/svelte/storage-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-display.d.ts","sourceRoot":"","sources":["../../src/svelte/storage-display.ts"],"names":[],"mappings":"AA2CA,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,MAAM,CAMR;AAED,wBAAgB,gCAAgC,CAC/C,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,MAAM,CAKR;AAED,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,MAAM,CAER;AAED,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,MAAM,CAMR"}

package/dist/svelte/storage-display.js

@@ -0,0 +1,58 @@
+const STORAGE_PROVIDER_TYPE_LABELS = new Map([
+    ['vibes_r2', 'Vibes Cloud Storage'],
+    ['user_s3', 'Amazon S3'],
+    ['user_r2', 'Cloudflare R2'],
+    ['user_gcs', 'Google Cloud Storage']
+]);
+const STORAGE_PROVIDER_TYPE_SHORT_LABELS = new Map([
+    ['vibes_r2', 'Vibes Storage'],
+    ['user_s3', 'Amazon S3'],
+    ['user_r2', 'Cloudflare R2'],
+    ['user_gcs', 'Google Cloud Storage']
+]);
+const STORAGE_PROVIDER_ICONS = new Map([
+    ['vibes_r2', 'lucide:cloud'],
+    ['user_s3', 'lucide:server'],
+    ['user_r2', 'lucide:cloud'],
+    ['user_gcs', 'lucide:database']
+]);
+const STORAGE_PROVIDER_COLOR_CLASSES = new Map([
+    ['vibes_r2', 'text-vibes-500'],
+    ['user_s3', 'text-orange-500'],
+    ['user_r2', 'text-blue-500'],
+    ['user_gcs', 'text-red-500']
+]);
+const STORAGE_BILLING_MODE_LABELS = new Map([
+    ['vibes_included', 'Included'],
+    ['user_pays_vibes', 'Billed'],
+    ['user_external', 'External']
+]);
+function humanizeIdentifier(value) {
+    if (!value)
+        return '';
+    return value
+        .replace(/[_-]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+export function getStorageProviderTypeLabel(type) {
+    return (STORAGE_PROVIDER_TYPE_LABELS.get(type ?? '') ??
+        humanizeIdentifier(type) ??
+        'Storage');
+}
+export function getStorageProviderTypeShortLabel(type) {
+    return (STORAGE_PROVIDER_TYPE_SHORT_LABELS.get(type ?? '') ??
+        getStorageProviderTypeLabel(type));
+}
+export function getStorageProviderIcon(type) {
+    return STORAGE_PROVIDER_ICONS.get(type ?? '') ?? 'lucide:hard-drive';
+}
+export function getStorageProviderColorClass(type) {
+    return STORAGE_PROVIDER_COLOR_CLASSES.get(type ?? '') ?? 'text-gray-500';
+}
+export function getStorageBillingModeLabel(mode) {
+    return (STORAGE_BILLING_MODE_LABELS.get(mode ?? '') ??
+        humanizeIdentifier(mode) ??
+        'Unknown');
+}

package/dist/svelte/storage-explorer-runtime.d.ts

@@ -0,0 +1,120 @@
+import type { StorageExplorerTransport, StorageExplorerFailure, ConnectableScope, ConnectExternalProviderInput, ProvisionVibesProviderInput } from '../schemas/explorer/views.ts';
+export type { StoragePreview, StorageExplorerTransport, StorageExplorerFailureKind, StorageExplorerFailure, ConnectableScope, ConnectExternalProviderInput, ProvisionVibesProviderInput } from '../schemas/explorer/views.ts';
+/**
+ * Storage-explorer runtime helpers for `@vibesdotdev/storage/svelte`.
+ *
+ * The preferred client is the storage-owned `storage/explorer` capability. In a
+ * native renderer that capability is projected from the trusted consumer worker,
+ * so account auth and backend routing never move into the webview. Ordinary web
+ * hosts can use the canonical Platform client fallback.
+ *
+ * Non-Svelte module (safe to import anywhere). Reactive state lives in the
+ * components; the extensibility seams (actions, preview) are typed here.
+ */
+import type { StorageTarget, StorageEntry, StorageScopeFilter, StorageTargetScope } from '@vibesdotdev/storage/schemas';
+import { type StorageExplorerCapability } from '@vibesdotdev/storage/client';
+import { type CaughtFailure, type VibesRuntime } from '@vibesdotdev/kernel';
+import type { PlatformStorageBrowseClient } from './storage-browse-runtime.ts';
+export type { StorageTarget, StorageEntry, StorageScopeFilter, StorageTargetScope };
+/** Scope the explorer enumerates. The DEFAULT (an empty object) is every drive
+ *  across every scope the user can reach — personal + every org/project/team.
+ *  These props NARROW the set; they never grant (mirrors `StorageScopeFilter`).
+ *  `projectId` additionally scopes object queries to a project's providers. */
+export type { StorageExplorerScope } from '../schemas/explorer/capability.ts';
+import type { StorageExplorerScope } from '../schemas/explorer/capability.ts';
+type ActionVariant = 'default' | 'ghost' | 'outline' | 'secondary' | 'destructive';
+/** A context-menu / row action in the explorer. `target` is the drive the entry
+ *  lives on, so actions can resolve URLs, build AI refs, etc. */
+export interface StorageExplorerAction {
+    id: string;
+    label: string;
+    icon?: string;
+    variant?: ActionVariant;
+    run: (entry: StorageEntry, target: StorageTarget) => void | Promise<void>;
+    /** Hide the action for entries that fail this predicate. */
+    visible?: (entry: StorageEntry, target: StorageTarget) => boolean;
+}
+/** An extensible preview rendered in the details pane. Hosts return one of these
+ *  from `previewFor(entry, target)`; the pane knows how to render each `kind`. */
+export interface StorageExplorerClient extends StorageExplorerCapability {
+    upload?(target: StorageTarget, key: string, file: Blob): Promise<void>;
+    delete?(target: StorageTarget, key: string): Promise<void>;
+}
+/**
+ * Resolve the storage owner capability. Native hosts require the projected
+ * owner; web hosts may fall back to the canonical Platform client.
+ */
+export declare function resolveStorageExplorerClient(runtime: VibesRuntime, transport?: StorageExplorerTransport): Promise<StorageExplorerClient>;
+/**
+ * Classify owner/runtime failures so the surface can offer the correct
+ * recovery action: by the failure's code and reason (and HTTP status), and,
+ * for an error that crossed an RPC boundary untyped, by its leading machine
+ * token only, never by matching prose.
+ */
+export declare function classifyStorageExplorerError(cause: CaughtFailure): StorageExplorerFailure;
+/** Present owner/runtime errors as setup or reconnect actions, never raw RPC/HTTP noise. */
+export declare function describeStorageExplorerError(cause: CaughtFailure): string;
+export declare function createStorageExplorerBrowseClient(target: StorageTarget, resolveClient: () => Promise<StorageExplorerClient>): PlatformStorageBrowseClient;
+/** Enumerate the scope's storage drives (vibes + connected + SharePoint),
+ *  narrowed by the scope filter (everything by default). */
+export declare function resolveScopeDrives(scope: StorageExplorerScope | undefined, client: StorageExplorerClient): Promise<StorageTarget[]>;
+/** Resolve a serving URL for an entry (download / share / preview). */
+export declare function resolveObjectUrl(target: StorageTarget, entry: StorageEntry, opts: {
+    ttlSeconds?: number;
+    disposition?: 'inline' | 'attachment';
+} | undefined, client: StorageExplorerClient, driveId?: string | null): Promise<{
+    kind: string;
+    url: string;
+    expiresAt?: string;
+}>;
+/** Upload a file at `key` (a drive-relative path) into the target. */
+export declare function uploadObject(target: StorageTarget, key: string, file: Blob, client: StorageExplorerClient): Promise<void>;
+/** Delete an entry from its drive. */
+export declare function deleteEntry(target: StorageTarget, entry: StorageEntry, client: StorageExplorerClient): Promise<void>;
+/**
+ * Search entries within a search-capable adapter (e.g. SharePoint via Graph
+ * content search). Mirrors `resolveScopeDrives` / `resolveObjectUrl` in style.
+ *
+ * @param target  The selected drive (from `resolveScopeDrives`) — provides
+ *                adapterId + config; IDOR-checked server-side like browse.
+ * @param driveId The active drive within the adapter (e.g. a SharePoint site).
+ * @param query   Search string (min 1 char).
+ * @param opts    Optional subtree scope + result limit.
+ */
+export declare function searchStorageEntries(target: StorageTarget, driveId: string, query: string, opts: {
+    path?: string;
+    limit?: number;
+} | undefined, client: StorageExplorerClient): Promise<StorageEntry[]>;
+/**
+ * Whether the given target's adapter declares the `search` capability.
+ * Used by the explorer to show/hide the search box without a round-trip.
+ * Adapters that support search: SharePoint (delegated + app-only).
+ * R2, S3, GCS do NOT support search.
+ */
+export declare function targetSupportsSearch(target: StorageTarget | null): boolean;
+/** A scope a provider can be connected into, surfaced in the connect dialog.
+ *  `canAdmin` gates org/project/team scopes (you can only connect org storage
+ *  if you administer that org). Personal is always connectable. */
+/** External object-store provider connect input (S3 / R2 / GCS). */
+/** Provision a vibes-managed (`vibes_r2`) drive — no user credentials. Personal
+ *  always; org-scoped when the caller administers the org (admin-gated + made
+ *  idempotent server-side). */
+/** Connect an external object-store provider (S3/R2/GCS) through the platform
+ *  client (client → cloud-api), not a bespoke fetch. `scope.organizationId`
+ *  connects a shared org drive (admin-gated server-side). */
+export declare function connectExternalProvider(runtime: VibesRuntime, input: ConnectExternalProviderInput): Promise<void>;
+/** Provision a vibes-managed shared drive (no credentials) into a scope. The
+ *  server skips the external-storage billing gate, admin-gates org scopes on the
+ *  caller's `orgs`-claim role, and is idempotent per org. */
+export declare function provisionVibesProvider(runtime: VibesRuntime, input: ProvisionVibesProviderInput): Promise<void>;
+/** Build the Microsoft (SharePoint/OneDrive) connect URL for a scope. Personal →
+ *  delegated per-user sign-in; org → admin-consent (once that flow lands). The
+ *  explorer passes the absolute platform origin so org apps reach it cross-app. */
+export declare function microsoftConnectUrl(platformOrigin: string, returnTo: string, scope?: ConnectableScope, authOrigin?: string): string;
+/**
+ * A portable storage entity reference for AI flows:
+ * `storage://{providerId}/{driveId}/{key}`. The chat/AI worker resolves it
+ * lazily (head/get) at run time — nothing is copied up front.
+ */
+export declare function storageRef(target: StorageTarget, driveId: string | null, key: string): string;
+//# sourceMappingURL=storage-explorer-runtime.d.ts.map

package/dist/svelte/storage-explorer-runtime.d.ts.map

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