@vibesdotdev/media 0.0.0-stage → 1.0.0-rc.3

package/dist/uploads/server/service.js

@@ -0,0 +1,152 @@
+/**
+ * Upload Storage Service
+ *
+ * Core service class for handling file uploads.
+ * Delegates backend operations to adapter packages via runtime resolution:
+ * - uploads-adapter-s3 for S3 backend
+ * - uploads-adapter-local for local filesystem backend
+ * - uploads-adapter-r2 for Cloudflare R2 backend
+ *
+ * Adapters are resolved via runtime.query('uploads/store').withId(backend).resolve()
+ * NOT via if (config.backend === 's3') branching.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { defaultUploadsBackend } from "./backend.js";
+import { loadUploadsConfig } from "../../config/uploads.js";
+import { parseRequest } from "../schemas/requests.js";
+import { uploadStorageOptionsSchema, validateUpload, MAX_FILE_SIZE, ALLOWED_MIME_TYPES, } from "../schemas/common.js";
+/** Local path when the uploads config does not name one. */
+const DEFAULT_LOCAL_PATH = 'uploads';
+export class UploadStorageService {
+    runtime;
+    config;
+    adapter = null;
+    backendWasExplicit;
+    backendFromManifest = false;
+    constructor(runtime, config) {
+        this.runtime = runtime;
+        this.backendWasExplicit = config?.backend !== undefined;
+        this.config = {
+            localPath: DEFAULT_LOCAL_PATH,
+            ...config,
+            backend: config?.backend ?? defaultUploadsBackend()
+        };
+    }
+    /**
+     * Get or create the storage adapter instance via runtime resolution.
+     *
+     * Uses runtime.query('uploads/store').withId(backend).resolve() to select
+     * the appropriate adapter based on config.backend ('local', 's3', 'r2').
+     * This replaces the prior if (config.backend === 's3') branching pattern.
+     *
+     * Adapters (uploads-adapter-local, uploads-adapter-s3, uploads-adapter-r2)
+     * self-register with ids 'local', 's3', 'r2' matching config.backend values.
+     */
+    async getAdapter() {
+        if (this.adapter) {
+            return this.adapter;
+        }
+        if (!this.backendWasExplicit && !this.backendFromManifest) {
+            const uploads = await loadUploadsConfig(this.runtime);
+            this.config = { ...this.config, backend: uploads.backend, localPath: uploads.localPath };
+            this.backendFromManifest = true;
+        }
+        // Runtime resolution: select adapter by backend id
+        this.adapter = await this.runtime
+            .query('uploads/store')
+            .withId(this.config.backend)
+            .resolve();
+        return this.adapter;
+    }
+    /**
+     * Validates file size and MIME type before storage
+     */
+    validateFile(buffer, contentType) {
+        const parsed = parseRequest(uploadStorageOptionsSchema.pick({ buffer: true, contentType: true }), { buffer, contentType });
+        if (!parsed.success) {
+            return { valid: false, error: new CapabilityError('The upload payload is invalid.', 'INVALID_INPUT', { reason: 'upload-options-invalid' }) };
+        }
+        const result = validateUpload(parsed.data.buffer.byteLength, parsed.data.contentType);
+        if (!result.valid) {
+            return { valid: false, error: result.error };
+        }
+        return { valid: true };
+    }
+    /**
+     * Saves a file to storage (local or S3)
+     */
+    async saveFile(input) {
+        const parsed = parseRequest(uploadStorageOptionsSchema, input);
+        if (!parsed.success) {
+            throw new CapabilityError('The storage upload request is invalid.', 'INVALID_INPUT', { reason: 'upload-options-invalid' });
+        }
+        const options = parsed.data;
+        // Validate before saving
+        const validation = validateUpload(options.buffer.byteLength, options.contentType);
+        if (!validation.valid) {
+            throw validation.error;
+        }
+        const adapter = await this.getAdapter();
+        return adapter.save(options);
+    }
+    /**
+     * Retrieves file content from storage
+     */
+    async getFile(storagePath) {
+        const adapter = await this.getAdapter();
+        return adapter.get(storagePath);
+    }
+    /**
+     * Deletes a file from storage
+     */
+    async deleteFile(storagePath) {
+        const adapter = await this.getAdapter();
+        return adapter.delete(storagePath);
+    }
+    /**
+     * Generates a signed URL for temporary access to private S3 objects
+     */
+    async getSignedUrl(storagePath, expiresSeconds = 3600) {
+        const adapter = await this.getAdapter();
+        return adapter.getSignedUrl(storagePath, expiresSeconds);
+    }
+    /**
+     * Returns a public URL for accessing the file
+     */
+    async getPublicUrl(storagePath) {
+        const adapter = await this.getAdapter();
+        return adapter.getPublicUrl(storagePath);
+    }
+    /**
+     * Checks if a storage path is a local path
+     */
+    isLocalPath(storagePath) {
+        return storagePath.startsWith('/uploads/');
+    }
+    /**
+     * Parses an s3:// URI into bucket and key components
+     */
+    parseS3Path(storagePath) {
+        if (!storagePath.startsWith('s3://'))
+            return null;
+        const rest = storagePath.slice(5);
+        const slashIndex = rest.indexOf('/');
+        if (slashIndex < 0)
+            return null;
+        return {
+            bucket: rest.slice(0, slashIndex),
+            key: rest.slice(slashIndex + 1)
+        };
+    }
+    // Configuration getters
+    getConfig() {
+        return { ...this.config };
+    }
+    getMaxFileSize() {
+        return MAX_FILE_SIZE;
+    }
+    getAllowedMimeTypes() {
+        return ALLOWED_MIME_TYPES;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/uploads/server/service.js.map

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

package/dist/uploads/server/storage-client.d.ts

@@ -0,0 +1,11 @@
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { UploadStorageService } from './service.ts';
+/** Runtime-owned default storage service; BaseRuntimeClient retries failed loads. */
+export declare class UploadStorageClient extends BaseRuntimeClient {
+    private service?;
+    protected onLoad(): Promise<void>;
+    getService(): Promise<UploadStorageService>;
+    protected onDispose(): void;
+}
+export default UploadStorageClient;
+//# sourceMappingURL=storage-client.d.ts.map

package/dist/uploads/server/storage-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.d.ts","sourceRoot":"","sources":["../../../src/uploads/server/storage-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,qFAAqF;AACrF,qBAAa,mBAAoB,SAAQ,iBAAiB;IACzD,OAAO,CAAC,OAAO,CAAC,CAAuB;cAEd,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;cAM9B,SAAS,IAAI,IAAI;CAGpC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/uploads/server/storage-client.js

@@ -0,0 +1,23 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { UploadStorageService } from "./service.js";
+import { buildConfig } from "./config.js";
+/** Runtime-owned default storage service; BaseRuntimeClient retries failed loads. */
+export class UploadStorageClient extends BaseRuntimeClient {
+    service;
+    async onLoad() {
+        await super.onLoad();
+        this.service = new UploadStorageService(this.runtime, await buildConfig(this.runtime));
+    }
+    async getService() {
+        await this.ensureLoaded();
+        if (!this.service)
+            throw new CapabilityError('Upload storage is unavailable.', 'UNAVAILABLE', { reason: 'upload-storage-unavailable' });
+        return this.service;
+    }
+    onDispose() {
+        this.service = undefined;
+    }
+}
+export default UploadStorageClient;
+//# sourceMappingURL=storage-client.js.map

package/dist/uploads/server/storage-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-client.js","sourceRoot":"","sources":["../../../src/uploads/server/storage-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,qFAAqF;AACrF,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACjD,OAAO,CAAwB;IAEpB,KAAK,CAAC,MAAM;QAC9B,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,UAAU;QACf,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,eAAe,CAAC,gCAAgC,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC,CAAC;QACxI,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAEkB,SAAS;QAC3B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC1B,CAAC;CACD;AAED,eAAe,mBAAmB,CAAC"}

package/dist/uploads/server/storage.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Upload Storage - Legacy Function Exports
+ *
+ * Maintains backward compatibility with existing API endpoints.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { UploadStorageService } from './service.ts';
+import type { UploadOptions, StorageResult } from '../schemas/index.ts';
+/** True when this host's uploads config selects the S3 backend. */
+export declare function isS3Enabled(runtime: VibesRuntime): Promise<boolean>;
+/** Compatibility entrypoint; the kernel owns the client and its initialization lifecycle. */
+export declare function createDefaultService(runtime: VibesRuntime): Promise<UploadStorageService>;
+/**
+ * Validates file metadata before saving
+ */
+export declare function validateFile(runtime: VibesRuntime, buffer: Buffer, contentType?: string): Promise<{
+    valid: true;
+} | {
+    valid: false;
+    error: Error;
+}>;
+export declare function saveToStorage(runtime: VibesRuntime, options: UploadOptions): Promise<StorageResult>;
+export declare function getSignedUrl(runtime: VibesRuntime, storagePath: string, expiresSeconds?: number): Promise<string | null>;
+export declare function getPublicUrlFromS3Key(runtime: VibesRuntime, key: string): Promise<string | null>;
+export declare function isLocalPath(runtime: VibesRuntime, storagePath: string): Promise<boolean>;
+export declare function parseS3(runtime: VibesRuntime, storagePath: string): Promise<{
+    bucket: string;
+    key: string;
+} | null>;
+/**
+ * Retrieves file content from storage
+ */
+export declare function getFile(runtime: VibesRuntime, storagePath: string): Promise<Buffer | null>;
+/**
+ * Deletes a file from storage
+ */
+export declare function deleteFile(runtime: VibesRuntime, storagePath: string): Promise<boolean>;
+export { UploadStorageService } from './service.ts';
+export { validateUpload, MAX_FILE_SIZE, ALLOWED_MIME_TYPES } from '../schemas/common.ts';
+//# sourceMappingURL=storage.d.ts.map

package/dist/uploads/server/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/uploads/server/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKpD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,mEAAmE;AACnE,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzE;AAED,6FAA6F;AAC7F,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAG/F;AAED;;GAEG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAE3D;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAEzG;AAED,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,MAAM,EACnB,cAAc,SAAO,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAItG;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9F;AAED,wBAAsB,OAAO,CAC5B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAEjD;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEhG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7F;AAGD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/uploads/server/storage.js

@@ -0,0 +1,59 @@
+/**
+ * Upload Storage - Legacy Function Exports
+ *
+ * Maintains backward compatibility with existing API endpoints.
+ */
+import {} from '@vibesdotdev/kernel';
+import { UploadStorageService } from "./service.js";
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { requireBucket } from "./config.js";
+import { loadUploadsConfig } from "../../config/uploads.js";
+/** True when this host's uploads config selects the S3 backend. */
+export async function isS3Enabled(runtime) {
+    return (await loadUploadsConfig(runtime)).backend === 's3';
+}
+/** Compatibility entrypoint; the kernel owns the client and its initialization lifecycle. */
+export async function createDefaultService(runtime) {
+    const client = await getVibesClient('uploads-storage', runtime);
+    return client.getService();
+}
+/**
+ * Validates file metadata before saving
+ */
+export async function validateFile(runtime, buffer, contentType) {
+    return (await createDefaultService(runtime)).validateFile(buffer, contentType);
+}
+export async function saveToStorage(runtime, options) {
+    return (await createDefaultService(runtime)).saveFile(options);
+}
+export async function getSignedUrl(runtime, storagePath, expiresSeconds = 3600) {
+    return (await createDefaultService(runtime)).getSignedUrl(storagePath, expiresSeconds);
+}
+export async function getPublicUrlFromS3Key(runtime, key) {
+    const uploads = await loadUploadsConfig(runtime);
+    const bucket = requireBucket(uploads.s3Bucket);
+    return (await createDefaultService(runtime)).getPublicUrl(`s3://${bucket}/${key}`);
+}
+export async function isLocalPath(runtime, storagePath) {
+    return (await createDefaultService(runtime)).isLocalPath(storagePath);
+}
+export async function parseS3(runtime, storagePath) {
+    return (await createDefaultService(runtime)).parseS3Path(storagePath);
+}
+/**
+ * Retrieves file content from storage
+ */
+export async function getFile(runtime, storagePath) {
+    return (await createDefaultService(runtime)).getFile(storagePath);
+}
+/**
+ * Deletes a file from storage
+ */
+export async function deleteFile(runtime, storagePath) {
+    return (await createDefaultService(runtime)).deleteFile(storagePath);
+}
+// Re-export service for new implementations
+export { UploadStorageService } from "./service.js";
+// Re-export validation utilities
+export { validateUpload, MAX_FILE_SIZE, ALLOWED_MIME_TYPES } from "../schemas/common.js";
+//# sourceMappingURL=storage.js.map

package/dist/uploads/server/storage.js.map

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

package/dist/uploads/uploads.plugin.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Uploads Plugin
+ *
+ * Runtime plugin that registers:
+ * - uploads/store kind (capability descriptor)
+ * - uploads logger + output descriptors
+ * - runtime/client 'uploads' registration backed by UploadsClient
+ */
+export declare const uploadsPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default uploadsPlugin;
+//# sourceMappingURL=uploads.plugin.d.ts.map

package/dist/uploads/uploads.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.plugin.d.ts","sourceRoot":"","sources":["../../src/uploads/uploads.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgEH,eAAO,MAAM,aAAa,6CA0BxB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/uploads/uploads.plugin.js

@@ -0,0 +1,89 @@
+/**
+ * Uploads Plugin
+ *
+ * Runtime plugin that registers:
+ * - uploads/store kind (capability descriptor)
+ * - uploads logger + output descriptors
+ * - runtime/client 'uploads' registration backed by UploadsClient
+ */
+import { createRuntimePlugin, loader, createRuntimeAsset } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import uploadsDocs from "./docs/uploads.docs.descriptor.js";
+import uploadsShareLinksDocs from "./docs/uploads.share-links.docs.descriptor.js";
+import mediaUploadsConfigDescriptor from "../config/media.uploads.config.descriptor.js";
+// Descriptors
+const uploadsStoreDescriptor = createRuntimeAsset({
+    id: 'uploads/store',
+    kind: 'uploads/store',
+    name: 'Uploads Store',
+    description: 'File storage backend adapter'
+});
+// Kind definitions - enables runtime.query('uploads/store') to work.
+// Adapters (uploads-adapter-{local,s3,r2}) register descriptors+loaders for
+// this kind via their own plugins; consumers select with withId().
+const uploadsStoreDescriptorSchema = z.object({
+    id: z.string(),
+    kind: z.literal('uploads/store'),
+    name: z.string(),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    hardware: z.array(z.enum(['consumer', 'cloud'])).optional(),
+    enabled: z.boolean().default(true)
+});
+const uploadsStoreKind = {
+    id: 'uploads/store',
+    descriptorSchema: uploadsStoreDescriptorSchema,
+    contexts: ['runtime']
+};
+const uploadsLoggerDescriptor = createRuntimeAsset({
+    id: 'uploads',
+    kind: 'logging/logger',
+    name: 'Uploads Logger',
+    description: 'Logger for uploads module',
+    namespace: 'uploads',
+    level: 'info'
+});
+const uploadsOutputDescriptor = createRuntimeAsset({
+    id: 'uploads',
+    kind: 'logging/output',
+    name: 'Uploads Output',
+    description: 'Output for uploads logs',
+    // `storage` is REQUIRED by OutputDescriptorSchema (no default). Omitting it
+    // makes registerPlugin throw at runtime init, which 500s EVERY request of
+    // any app composing this plugin (took down account-web prod on 2026-07-15).
+    storage: 'file',
+    format: 'jsonl',
+    path: 'logs/uploads.jsonl'
+});
+const uploadsClientDescriptor = createRuntimeAsset({
+    id: 'uploads',
+    kind: 'runtime/client',
+    name: 'Uploads Client',
+    description: 'Canonical client for uploads'
+});
+export const uploadsPlugin = createRuntimePlugin({
+    id: 'uploads',
+    name: 'Uploads',
+    description: 'Runtime-resolved file upload client and storage store kind.',
+    dependencies: ['runtime-client'],
+    kinds: [uploadsStoreKind],
+    descriptors: [
+        uploadsStoreDescriptor,
+        uploadsLoggerDescriptor,
+        uploadsOutputDescriptor,
+        uploadsDocs,
+        uploadsShareLinksDocs,
+        mediaUploadsConfigDescriptor,
+        uploadsClientDescriptor,
+        createRuntimeAsset({ id: 'uploads.sharing', kind: 'runtime/client', name: 'Sharing Client' }),
+        createRuntimeAsset({ id: 'uploads-storage', kind: 'runtime/client', name: 'Upload Storage Client' })
+    ],
+    loaders: [
+        // Return the class so AssetAccessor instantiates it with (descriptor, context).
+        loader('uploads.sharing', { kind: 'runtime/client' }, () => import('./client/sharing-client.js')),
+        loader('uploads', { kind: 'runtime/client' }, () => import('./client/uploads-client.js')),
+        loader('uploads-storage', { kind: 'runtime/client' }, () => import('./server/storage-client.js'))
+    ]
+});
+export default uploadsPlugin;
+//# sourceMappingURL=uploads.plugin.js.map

package/dist/uploads/uploads.plugin.js.map

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

package/dist/utils/attempt.d.ts

@@ -0,0 +1,27 @@
+/**
+ * One attempt, captured once as an outcome: the value, or the failure that
+ * ended it. The caller reads the failure and decides (branch on its `code` /
+ * `reason`, report its value-free facts, or rethrow it); the capture itself
+ * never decides, drops or rewrites it.
+ */
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+export type Attempt<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly failure: CaughtFailure;
+};
+/** Run `work`; an async failure is the outcome, never thrown. */
+export declare function attempt<T>(work: () => Promise<T>): Promise<Attempt<T>>;
+/** Run `work`; a synchronous failure is the outcome, never thrown. */
+export declare function attemptSync<T>(work: () => T): Attempt<T>;
+/** Throw a captured failure again: the `Error` itself, or the non-Error value that was thrown. */
+export declare function rethrowFailure(failure: CaughtFailure): never;
+/**
+ * The failure named by its value-free facts only (`CapabilityError UNAVAILABLE
+ * upload-response-invalid`, `Error ENOENT`): safe in a log field or a message,
+ * never the failure's own text.
+ */
+export declare function failureLabel(failure: CaughtFailure): string;
+//# sourceMappingURL=attempt.d.ts.map

package/dist/utils/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../src/utils/attempt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhG,MAAM,MAAM,OAAO,CAAC,CAAC,IAClB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAE3D,iEAAiE;AACjE,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAM5E;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMxD;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAG3D"}

package/dist/utils/attempt.js

@@ -0,0 +1,39 @@
+/**
+ * One attempt, captured once as an outcome: the value, or the failure that
+ * ended it. The caller reads the failure and decides (branch on its `code` /
+ * `reason`, report its value-free facts, or rethrow it); the capture itself
+ * never decides, drops or rewrites it.
+ */
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+/** Run `work`; an async failure is the outcome, never thrown. */
+export async function attempt(work) {
+    try {
+        return { ok: true, value: await work() };
+    }
+    catch (error) {
+        return { ok: false, failure: CaughtFailureSchema.parse(error) };
+    }
+}
+/** Run `work`; a synchronous failure is the outcome, never thrown. */
+export function attemptSync(work) {
+    try {
+        return { ok: true, value: work() };
+    }
+    catch (error) {
+        return { ok: false, failure: CaughtFailureSchema.parse(error) };
+    }
+}
+/** Throw a captured failure again: the `Error` itself, or the non-Error value that was thrown. */
+export function rethrowFailure(failure) {
+    throw failure instanceof Error ? failure : failure.value;
+}
+/**
+ * The failure named by its value-free facts only (`CapabilityError UNAVAILABLE
+ * upload-response-invalid`, `Error ENOENT`): safe in a log field or a message,
+ * never the failure's own text.
+ */
+export function failureLabel(failure) {
+    const facts = valueFreeFailure(failure);
+    return [facts.name, facts.code, facts.reason].filter((fact) => fact !== undefined).join(' ');
+}
+//# sourceMappingURL=attempt.js.map

package/dist/utils/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../../src/utils/attempt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAC;AAMhG,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,IAAsB;IACtD,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;AACF,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAI,IAAa;IAC3C,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;AACF,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,cAAc,CAAC,OAAsB;IACpD,MAAM,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9F,CAAC"}

package/dist/utils/failure-message.d.ts

@@ -0,0 +1,8 @@
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/**
+ * A message safe to show a user for a failed media call: fixed text chosen by
+ * the failure's reason or code, never the failure's own message, which can
+ * carry a server's answer or a request value. Anything else is `fallback`.
+ */
+export declare function failureMessage(failure: CaughtFailure, fallback: string): string;
+//# sourceMappingURL=failure-message.d.ts.map

package/dist/utils/failure-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-message.d.ts","sourceRoot":"","sources":["../../src/utils/failure-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoB5E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/E"}

package/dist/utils/failure-message.js

@@ -0,0 +1,28 @@
+import { isCapabilityError } from '@vibesdotdev/kernel';
+/** What a user is told for the refusals they can act on; any other failure gets the caller's fixed fallback. */
+const REASON_MESSAGES = new Map(Object.entries({
+    'upload-file-empty': 'That file is empty.',
+    'upload-file-too-large': 'That file is too large.',
+    'upload-type-not-allowed': 'That file type is not allowed.',
+    'upload-size-invalid': 'That file could not be read.',
+    'uploads-origin-unresolved': 'Uploads are not available here.',
+    'media-capture-provider-unavailable': 'No capture provider is available.',
+    'media-capture-result-invalid': 'The capture could not be read.'
+}));
+/** What a user is told by a failure's code when its reason has no message of its own. */
+const CODE_MESSAGES = new Map(Object.entries({
+    AUTH_REQUIRED: 'Sign in to continue.',
+    PERMISSION_DENIED: 'You do not have permission to do that.',
+    RATE_LIMITED: 'Too many requests. Try again shortly.'
+}));
+/**
+ * A message safe to show a user for a failed media call: fixed text chosen by
+ * the failure's reason or code, never the failure's own message, which can
+ * carry a server's answer or a request value. Anything else is `fallback`.
+ */
+export function failureMessage(failure, fallback) {
+    if (!isCapabilityError(failure))
+        return fallback;
+    return REASON_MESSAGES.get(failure.reason) ?? CODE_MESSAGES.get(failure.code) ?? fallback;
+}
+//# sourceMappingURL=failure-message.js.map

package/dist/utils/failure-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-message.js","sourceRoot":"","sources":["../../src/utils/failure-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,gHAAgH;AAChH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAiB,MAAM,CAAC,OAAO,CAAC;IAC9D,mBAAmB,EAAE,qBAAqB;IAC1C,uBAAuB,EAAE,yBAAyB;IAClD,yBAAyB,EAAE,gCAAgC;IAC3D,qBAAqB,EAAE,8BAA8B;IACrD,2BAA2B,EAAE,iCAAiC;IAC9D,oCAAoC,EAAE,mCAAmC;IACzE,8BAA8B,EAAE,gCAAgC;CAChE,CAAC,CAAC,CAAC;AAEJ,yFAAyF;AACzF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAiB,MAAM,CAAC,OAAO,CAAC;IAC5D,aAAa,EAAE,sBAAsB;IACrC,iBAAiB,EAAE,wCAAwC;IAC3D,YAAY,EAAE,uCAAuC;CACrD,CAAC,CAAC,CAAC;AAEJ;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsB,EAAE,QAAgB;IACtE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjD,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;AAC3F,CAAC"}