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

package/dist/svelte/sharing/state.svelte.js

@@ -0,0 +1,101 @@
+import { onDestroy } from 'svelte';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getVibesClient, tryGetVibesClient } from '@vibesdotdev/kernel/client';
+import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+import { emptySharingEntry } from "../../schemas/sharing-state.js";
+import { attempt } from "../../utils/attempt.js";
+import { failureMessage } from "../failure-message.js";
+import { isLinkActive } from "./runtime.js";
+/** A context-owned reactive projection of the runtime's shared capability. */
+export class SharingState {
+    loadRuntime;
+    entries = $state.raw({});
+    pending = null;
+    unsubscribe;
+    generation = 0;
+    disposed = false;
+    constructor(loadRuntime) {
+        this.loadRuntime = loadRuntime;
+    }
+    entry(fileId) { return this.entries[fileId] ?? emptySharingEntry(); }
+    links(fileId) { return this.entry(fileId).links; }
+    isLoading(fileId) { return this.entry(fileId).loading; }
+    error(fileId) { return this.entry(fileId).error; }
+    activeLinks(fileId) {
+        return this.links(fileId).filter(link => isLinkActive(link))
+            .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    resolveClient() {
+        if (this.pending)
+            return this.pending;
+        const generation = this.generation;
+        this.pending = (async () => {
+            const runtime = await this.loadRuntime();
+            this.assertCurrent(generation);
+            const client = tryGetVibesClient('uploads.sharing', runtime)
+                ?? await getVibesClient('uploads.sharing', runtime);
+            this.assertCurrent(generation);
+            this.unsubscribe = client.subscribe(snapshot => {
+                if (!this.disposed && generation === this.generation)
+                    this.entries = snapshot;
+            });
+            return client;
+        })();
+        return this.pending;
+    }
+    assertCurrent(generation) {
+        if (this.disposed || generation !== this.generation)
+            throw new CapabilityError('Sharing state is disposed.', 'UNAVAILABLE', { reason: 'sharing-state-disposed', retryable: false });
+    }
+    async init(fileId) {
+        if (this.disposed)
+            return;
+        const generation = this.generation;
+        const result = await attempt(async () => {
+            const client = await this.resolveClient();
+            if (!this.disposed && generation === this.generation)
+                await client.init(fileId);
+        });
+        if (!result.ok && !this.disposed && generation === this.generation) {
+            this.entries = { ...this.entries, [fileId]: { ...emptySharingEntry(), loaded: true, error: failureMessage(result.failure, 'Could not load share links.') } };
+            this.pending = null;
+        }
+    }
+    async refresh(fileId) {
+        if (this.disposed)
+            return;
+        const generation = this.generation;
+        const client = await this.resolveClient();
+        if (!this.disposed && generation === this.generation)
+            await client.refresh(fileId);
+    }
+    async create(fileId, options = {}) {
+        const generation = this.generation;
+        const client = await this.resolveClient();
+        this.assertCurrent(generation);
+        return client.create(fileId, options);
+    }
+    async revoke(fileId, shareId) {
+        const generation = this.generation;
+        const client = await this.resolveClient();
+        this.assertCurrent(generation);
+        return client.revoke(fileId, shareId);
+    }
+    dispose() {
+        this.disposed = true;
+        this.generation++;
+        this.unsubscribe?.();
+        this.unsubscribe = undefined;
+        this.pending = null;
+        this.entries = {};
+    }
+}
+/** Each consumer releases its projection; the runtime retains shared observations. */
+export function getSharingState() {
+    const store = getRuntimeSvelteContext();
+    const state = new SharingState(() => store.load());
+    onDestroy(() => state.dispose());
+    // Activate observation even when this consumer only displays a badge.
+    void state.init('');
+    return state;
+}

package/dist/svelte/sharing/styles.css

@@ -0,0 +1,8 @@
+/*
+ * Tailwind v4 source declaration for consumers — mirrors @vibesdotdev/kit's
+ * styles.css pattern. Apps that @import this file get this package's
+ * components scanned by their Tailwind build, so utility classes used only
+ * inside these components are emitted in the app's CSS bundle (Tailwind
+ * never scans node_modules). Paths resolve relative to this file.
+ */
+@source "./";

package/dist/svelte/state.svelte.d.ts

@@ -0,0 +1,38 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type CaptureSessionState, type MediaCaptureEntry } from '../schemas/capture-state.ts';
+export type { MediaCaptureEntry } from '../schemas/capture-state.ts';
+export interface MediaCaptureStateInitOptions {
+    providerId?: string;
+    runtime: VibesRuntime;
+}
+/** One tree's reactive projection. It owns URLs, never a runtime-global binding. */
+export declare class MediaCaptureState {
+    private snapshot;
+    captures: MediaCaptureEntry[];
+    private session;
+    private unsubscribe?;
+    private generation;
+    private readonly urls;
+    get providers(): CaptureSessionState['providers'];
+    get sources(): CaptureSessionState['sources'];
+    get providerId(): CaptureSessionState['providerId'];
+    get sourceId(): CaptureSessionState['sourceId'];
+    get selectedCaptureId(): CaptureSessionState['selectedCaptureId'];
+    get loading(): CaptureSessionState['loading'];
+    get capturing(): CaptureSessionState['capturing'];
+    get initialized(): CaptureSessionState['initialized'];
+    get error(): CaptureSessionState['error'];
+    init(options: MediaCaptureStateInitOptions): Promise<void>;
+    selectProvider(id: string): Promise<void>;
+    loadSources(): Promise<void>;
+    selectSource(id: string | number): void;
+    capture(): Promise<void>;
+    selectCapture(id: string): void;
+    dispose(): void;
+}
+export declare function createMediaCaptureState(): MediaCaptureState;
+/** Legacy entrypoint name, now an explicit factory rather than shared mutable state. */
+export declare const mediaCaptureState: typeof createMediaCaptureState;
+export declare function provideMediaCaptureState(state: () => MediaCaptureState): () => MediaCaptureState;
+export declare function useMediaCaptureState(): MediaCaptureState;
+//# sourceMappingURL=state.svelte.d.ts.map

package/dist/svelte/state.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/state.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,EAA6B,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAK1H,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,WAAW,4BAA4B;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;CACtB;AAID,oFAAoF;AACpF,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAA6F;IAC7G,QAAQ,EAAE,iBAAiB,EAAE,CAAuC;IACpE,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAElD,IAAI,SAAS,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAoC;IACrF,IAAI,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAkC;IAC/E,IAAI,UAAU,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAqC;IACxF,IAAI,QAAQ,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAmC;IAClF,IAAI,iBAAiB,IAAI,mBAAmB,CAAC,mBAAmB,CAAC,CAA4C;IAC7G,IAAI,OAAO,IAAI,mBAAmB,CAAC,SAAS,CAAC,CAAkC;IAC/E,IAAI,SAAS,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAoC;IACrF,IAAI,WAAW,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAsC;IAC3F,IAAI,KAAK,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAgC;IAEnE,IAAI,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IA4ChE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IACvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAE/B,OAAO,IAAI,IAAI;CAWf;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAAoC;AAEhG,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,gCAA0B,CAAC;AAEzD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,iBAAiB,GAAG,MAAM,iBAAiB,CAEhG;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAMxD"}

package/dist/svelte/state.svelte.js

@@ -0,0 +1,102 @@
+import { getContext, setContext } from 'svelte';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getVibesClient, tryGetVibesClient } from '@vibesdotdev/kernel/client';
+import { CaptureSessionStateSchema } from "../schemas/capture-state.js";
+import { captureMimeType } from "./runtime.js";
+import { attempt } from "../utils/attempt.js";
+import { failureMessage } from "./failure-message.js";
+const CAPTURE_CONTEXT = Symbol('media.capture');
+/** One tree's reactive projection. It owns URLs, never a runtime-global binding. */
+export class MediaCaptureState {
+    snapshot = $state.raw(CaptureSessionStateSchema.parse({}));
+    captures = $state.raw([]);
+    session = null;
+    unsubscribe;
+    generation = 0;
+    urls = new Map();
+    get providers() { return this.snapshot.providers; }
+    get sources() { return this.snapshot.sources; }
+    get providerId() { return this.snapshot.providerId; }
+    get sourceId() { return this.snapshot.sourceId; }
+    get selectedCaptureId() { return this.snapshot.selectedCaptureId; }
+    get loading() { return this.snapshot.loading; }
+    get capturing() { return this.snapshot.capturing; }
+    get initialized() { return this.snapshot.initialized; }
+    get error() { return this.snapshot.error; }
+    async init(options) {
+        this.dispose();
+        const generation = this.generation;
+        const resolved = await attempt(async () => {
+            const client = tryGetVibesClient('media.capture', options.runtime)
+                ?? await getVibesClient('media.capture', options.runtime);
+            return client.openSession();
+        });
+        if (generation !== this.generation) {
+            if (resolved.ok)
+                resolved.value.dispose();
+            return;
+        }
+        if (!resolved.ok) {
+            this.snapshot = { ...this.snapshot, initialized: true, error: failureMessage(resolved.failure, 'Capture is not available.') };
+            return;
+        }
+        const session = resolved.value;
+        this.session = session;
+        this.unsubscribe = session.subscribe(snapshot => {
+            const ids = new Set(snapshot.captures.map(capture => capture.id));
+            for (const [id, url] of this.urls) {
+                if (!ids.has(id)) {
+                    URL.revokeObjectURL(url);
+                    this.urls.delete(id);
+                }
+            }
+            this.captures = snapshot.captures.map(capture => {
+                let url = this.urls.get(capture.id);
+                if (!url) {
+                    url = URL.createObjectURL(new Blob([new Uint8Array(capture.data)], { type: captureMimeType(capture.format) }));
+                    this.urls.set(capture.id, url);
+                }
+                const entry = {
+                    id: capture.id, url, format: capture.format, timestamp: capture.timestamp,
+                    providerId: capture.providerId
+                };
+                if (capture.sourceId != null)
+                    entry.sourceId = capture.sourceId;
+                return entry;
+            });
+            this.snapshot = snapshot;
+        });
+        await session.init(options.providerId);
+    }
+    selectProvider(id) { return this.session?.selectProvider(id) ?? Promise.resolve(); }
+    loadSources() { return this.session?.loadSources() ?? Promise.resolve(); }
+    selectSource(id) { this.session?.selectSource(id); }
+    capture() { return this.session?.capture() ?? Promise.resolve(); }
+    selectCapture(id) { this.session?.selectCapture(id); }
+    dispose() {
+        this.generation++;
+        this.unsubscribe?.();
+        this.unsubscribe = undefined;
+        this.session?.dispose();
+        this.session = null;
+        for (const url of this.urls.values())
+            URL.revokeObjectURL(url);
+        this.urls.clear();
+        this.captures = [];
+        this.snapshot = CaptureSessionStateSchema.parse({});
+    }
+}
+export function createMediaCaptureState() { return new MediaCaptureState(); }
+/** Legacy entrypoint name, now an explicit factory rather than shared mutable state. */
+export const mediaCaptureState = createMediaCaptureState;
+export function provideMediaCaptureState(state) {
+    return setContext(CAPTURE_CONTEXT, state);
+}
+export function useMediaCaptureState() {
+    const state = getContext(CAPTURE_CONTEXT);
+    if (!state)
+        throw new CapabilityError('A capture tree or explicit capture state is required.', 'UNAVAILABLE', {
+            reason: 'media-capture-tree-required', retryable: false
+        });
+    return state();
+}

package/dist/svelte/styles.css

@@ -0,0 +1,2 @@
+/* Tailwind v4 source declaration for consuming applications. */
+@source "./";

package/dist/svelte/uploader.d.ts

@@ -0,0 +1,17 @@
+import * as z from 'zod/v4';
+import type { UploadKind } from '../uploads/schemas/index.ts';
+/** Explicit provenance attached to an upload by a reusable UI surface. */
+export declare const MediaUploaderProvenanceSchema: z.ZodObject<{
+    sourceApp: z.ZodString;
+    sourceId: z.ZodString;
+}, z.core.$strict>;
+export type MediaUploaderProvenance = z.infer<typeof MediaUploaderProvenanceSchema>;
+export interface MediaUploaderProps extends MediaUploaderProvenance {
+    value?: string;
+    accept?: string;
+    kind?: UploadKind;
+    isPublic?: boolean;
+    onUploaded?: (url: string) => void;
+}
+export declare function parseMediaUploaderProvenance(value: MediaUploaderProvenance): MediaUploaderProvenance;
+//# sourceMappingURL=uploader.d.ts.map

package/dist/svelte/uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../../src/svelte/uploader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,0EAA0E;AAC1E,eAAO,MAAM,6BAA6B;;;kBAGxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,uBAAuB,GAC5B,uBAAuB,CAEzB"}

package/dist/svelte/uploader.js

@@ -0,0 +1,9 @@
+import * as z from 'zod/v4';
+/** Explicit provenance attached to an upload by a reusable UI surface. */
+export const MediaUploaderProvenanceSchema = z.strictObject({
+    sourceApp: z.string().trim().min(1),
+    sourceId: z.string().trim().min(1)
+});
+export function parseMediaUploaderProvenance(value) {
+    return MediaUploaderProvenanceSchema.parse(value);
+}

package/dist/uploads/adapters/local/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Uploads Adapter Local - Exports
+ *
+ * Local filesystem storage adapter for the uploads/store kind.
+ */
+export { uploadsAdapterLocalPlugin, default } from './uploads-adapter-local.plugin.ts';
+export { default as localStorageDescriptor } from './local-storage.descriptor.ts';
+export { LocalStorageService, createLocalStorageService } from './local-storage.impl.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/uploads/adapters/local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/uploads/adapters/local/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,yBAAyB,EACzB,OAAO,EACP,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAGlF,OAAO,EACN,mBAAmB,EACnB,yBAAyB,EACzB,MAAM,yBAAyB,CAAC"}

package/dist/uploads/adapters/local/index.js

@@ -0,0 +1,12 @@
+/**
+ * Uploads Adapter Local - Exports
+ *
+ * Local filesystem storage adapter for the uploads/store kind.
+ */
+// Plugin
+export { uploadsAdapterLocalPlugin, default } from "./uploads-adapter-local.plugin.js";
+// Descriptor
+export { default as localStorageDescriptor } from "./local-storage.descriptor.js";
+// Implementation
+export { LocalStorageService, createLocalStorageService } from "./local-storage.impl.js";
+//# sourceMappingURL=index.js.map

package/dist/uploads/adapters/local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/uploads/adapters/local/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EACN,yBAAyB,EACzB,OAAO,EACP,MAAM,mCAAmC,CAAC;AAE3C,aAAa;AACb,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAElF,iBAAiB;AACjB,OAAO,EACN,mBAAmB,EACnB,yBAAyB,EACzB,MAAM,yBAAyB,CAAC"}

package/dist/uploads/adapters/local/local-storage.descriptor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Local Upload Storage Descriptor
+ *
+ * Descriptor for the local filesystem storage adapter.
+ * Registers as uploads/store with id 'local' for consumer hardware.
+ */
+/**
+ * Upload store descriptor shape
+ */
+export interface UploadStoreDescriptor {
+    id: string;
+    kind: 'uploads/store';
+    name: string;
+    description: string;
+    tags?: string[];
+    hardware: Array<'consumer' | 'cloud'>;
+    enabled: boolean;
+}
+/**
+ * Local storage descriptor metadata
+ */
+declare const descriptor: UploadStoreDescriptor;
+export default descriptor;
+//# sourceMappingURL=local-storage.descriptor.d.ts.map

package/dist/uploads/adapters/local/local-storage.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/uploads/adapters/local/local-storage.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,QAAA,MAAM,UAAU,EAAE,qBAQjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/uploads/adapters/local/local-storage.descriptor.js

@@ -0,0 +1,20 @@
+/**
+ * Local Upload Storage Descriptor
+ *
+ * Descriptor for the local filesystem storage adapter.
+ * Registers as uploads/store with id 'local' for consumer hardware.
+ */
+/**
+ * Local storage descriptor metadata
+ */
+const descriptor = {
+    id: 'local',
+    kind: 'uploads/store',
+    name: 'Local Filesystem Storage',
+    description: 'File upload storage using local filesystem. Suitable for consumer deployments.',
+    tags: ['uploads', 'storage', 'filesystem', 'local', 'node', 'bun'],
+    hardware: ['consumer'], // Node/Bun only, not browser/Cloudflare
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=local-storage.descriptor.js.map

package/dist/uploads/adapters/local/local-storage.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.descriptor.js","sourceRoot":"","sources":["../../../../src/uploads/adapters/local/local-storage.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,MAAM,UAAU,GAA0B;IACzC,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,gFAAgF;IAC7F,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;IAClE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,wCAAwC;IAChE,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/uploads/adapters/local/local-storage.impl.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Local Upload Storage Implementation
+ *
+ * Filesystem-based storage adapter for the uploads/store kind.
+ *
+ * It reaches the disk only through the runtime's filesystem kind and paths
+ * capability, handed in as `host`: the adapter imports no Node module. Every
+ * storage path is resolved against the root and must stay inside it, the file
+ * extension is allowlisted, and the upload kind maps exactly.
+ */
+import type { RuntimePath } from '@vibesdotdev/paths';
+import type { FileSystemAdapterInterface } from '@vibesdotdev/filesystem/interfaces/adapter';
+import { type StorageConfig, type StorageResult, type UploadOptions } from '../../schemas/common.ts';
+export type { StorageConfig, StorageResult, UploadOptions };
+/**
+ * Upload storage interface that adapters must implement
+ */
+export interface UploadStorage {
+    save(options: UploadOptions): Promise<StorageResult>;
+    get(storagePath: string): Promise<Buffer | null>;
+    delete(storagePath: string): Promise<boolean>;
+    getPublicUrl(storagePath: string): string | null;
+    getSignedUrl(storagePath: string, expiresSeconds?: number): Promise<string | null>;
+}
+/** What the adapter reads and writes the disk through: the runtime's filesystem kind and paths capability. */
+export interface LocalStorageHost {
+    files: FileSystemAdapterInterface;
+    path: RuntimePath;
+}
+/**
+ * Local filesystem upload storage adapter.
+ * Provides save/get/delete operations for file storage on the local filesystem.
+ */
+export declare class LocalStorageService implements UploadStorage {
+    private readonly host;
+    private config;
+    private resolvedBasePath;
+    /**
+     * Create a local storage service.
+     *
+     * @param config - Partial storage configuration (localPath, etc.)
+     * @param workspaceRoot - The bound workspace root (`runtime/workspace-path`);
+     *   a relative `localPath` resolves against it, never the process cwd.
+     * @param host - The runtime's filesystem kind and paths capability.
+     */
+    constructor(config: Partial<StorageConfig> | undefined, workspaceRoot: string | undefined, host: LocalStorageHost);
+    /**
+     * Save a file to local storage.
+     *
+     * @param options - Upload options including buffer, kind, userId, etc.
+     * @returns StorageResult with storagePath, size, and backend
+     */
+    save(input: UploadOptions): Promise<StorageResult>;
+    /**
+     * Get a file from local storage.
+     *
+     * @param storagePath - The storage path (e.g., /uploads/media/abc.png)
+     * @returns Buffer containing file data, or null if file not found
+     * @throws `storage-path-outside-root` when the path leaves the storage root
+     */
+    get(storagePath: string): Promise<Buffer | null>;
+    /**
+     * Delete a file from local storage.
+     *
+     * @param storagePath - The storage path (e.g., /uploads/media/abc.png)
+     * @returns true if deleted successfully, false when there was no such file
+     * @throws `storage-path-outside-root` when the path leaves the storage root
+     */
+    delete(storagePath: string): Promise<boolean>;
+    /**
+     * Get a public URL for a local file.
+     *
+     * @param storagePath - The storage path
+     * @returns The public URL (for local, returns the path itself if it starts with /uploads/), or null if invalid
+     */
+    getPublicUrl(storagePath: string): string | null;
+    /**
+     * Get a signed URL for temporary access.
+     *
+     * For local storage, this always returns null as local files
+     * are accessed directly via their public path.
+     *
+     * @param _storagePath - The storage path (ignored for local)
+     * @param _expiresSeconds - Expiration time in seconds (ignored for local)
+     * @returns null (local storage does not support signed URLs)
+     */
+    getSignedUrl(_storagePath: string, _expiresSeconds?: number): Promise<string | null>;
+    /**
+     * Check if a storage path is a local path.
+     *
+     * @param storagePath - The storage path to check
+     * @returns true if the path starts with /uploads/
+     */
+    isLocalPath(storagePath: string): boolean;
+    /**
+     * The subdirectory for an upload kind; a kind that is not one of the known
+     * kinds is refused, never stored under a default.
+     */
+    private getKindPath;
+    /**
+     * The extension of a stored file: the caller's own extension when it is
+     * short, lower-case letters and digits only; else the MIME type's; else `bin`.
+     * Nothing from the name but that extension reaches the path.
+     */
+    private getFileExtension;
+    /**
+     * Resolve a storage path against the storage root, refusing one that leaves it.
+     * Converts /uploads/media/file.png -> <root>/media/file.png.
+     * Handles both absolute storage paths and relative paths.
+     */
+    private confinedPath;
+}
+/**
+ * Create a local storage service instance.
+ *
+ * @param config - Optional storage configuration
+ * @param workspaceRoot - The bound workspace root, for a relative `localPath`
+ * @param host - The runtime's filesystem kind and paths capability
+ * @returns LocalStorageService instance
+ */
+export declare function createLocalStorageService(config: Partial<StorageConfig> | undefined, workspaceRoot: string | undefined, host: LocalStorageHost): LocalStorageService;
+export default LocalStorageService;
+//# sourceMappingURL=local-storage.impl.d.ts.map

package/dist/uploads/adapters/local/local-storage.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.impl.d.ts","sourceRoot":"","sources":["../../../../src/uploads/adapters/local/local-storage.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EAIN,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,yBAAyB,CAAC;AAIjC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrD,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjD,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACnF;AAED,8GAA8G;AAC9G,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,0BAA0B,CAAC;IAClC,IAAI,EAAE,WAAW,CAAC;CAClB;AA6BD;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IAevD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAdtB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IAEjC;;;;;;;OAOG;gBAEF,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,EAC1C,aAAa,EAAE,MAAM,GAAG,SAAS,EAChB,IAAI,EAAE,gBAAgB;IAgBxC;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BxD;;;;;;OAMG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQtD;;;;;;OAMG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnD;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOhD;;;;;;;;;OASG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIpF;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAMzC;;;OAGG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAkBpB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,EAC1C,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,IAAI,EAAE,gBAAgB,GACpB,mBAAmB,CAErB;AAGD,eAAe,mBAAmB,CAAC"}