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

package/dist/svelte/runtime-log.js

@@ -0,0 +1,19 @@
+/**
+ * Logging for the Svelte surface: a component or store logs on the runtime it
+ * was handed, never the host default. The Svelte runtime store a component
+ * captured at init is the source: its `load()` yields the runtime the logger
+ * binds to.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+import { attempt } from "../utils/attempt.js";
+/**
+ * Log one entry on the runtime `source` holds. A source that never loaded has
+ * no runtime to bind a logger to, so the entry is dropped; the store records
+ * that failed load on its own `error`.
+ */
+export async function logOn(source, level, context, message, fields) {
+    const loaded = await attempt(() => source.load());
+    if (!loaded.ok)
+        return;
+    getLogger('media', loaded.value).child({ context })[level](message, fields);
+}

package/dist/svelte/runtime.d.ts

@@ -0,0 +1,9 @@
+export declare function captureMimeType(format: string): string;
+/**
+ * A portable timestamped file name for a capture. The extension comes from the
+ * format only when it is a short lowercase token; any other format (or an
+ * unreadable timestamp) yields `bin` / `unknown-time`, so a provider-supplied
+ * format can never shape the name beyond its extension.
+ */
+export declare function captureFileName(timestamp: number, format: string): string;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/svelte/runtime.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOtD;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzE"}

package/dist/svelte/runtime.js

@@ -0,0 +1,27 @@
+export function captureMimeType(format) {
+    if (format === 'jpeg' || format === 'jpg')
+        return 'image/jpeg';
+    if (format === 'png')
+        return 'image/png';
+    if (format === 'webm')
+        return 'video/webm';
+    if (format === 'mp4')
+        return 'video/mp4';
+    if (format === 'wav')
+        return 'audio/wav';
+    return 'application/octet-stream';
+}
+/** A file extension a capture's format may become: short and alphanumeric, anything else is `bin`. */
+const EXTENSION_FORMAT = /^[a-z0-9]{1,8}$/;
+/**
+ * A portable timestamped file name for a capture. The extension comes from the
+ * format only when it is a short lowercase token; any other format (or an
+ * unreadable timestamp) yields `bin` / `unknown-time`, so a provider-supplied
+ * format can never shape the name beyond its extension.
+ */
+export function captureFileName(timestamp, format) {
+    const extension = format === 'jpeg' ? 'jpg' : EXTENSION_FORMAT.test(format) ? format : 'bin';
+    const moment = new Date(timestamp);
+    const stamp = Number.isNaN(moment.getTime()) ? 'unknown-time' : moment.toISOString().replace(/[:.]/g, '-');
+    return `vibes-capture-${stamp}.${extension}`;
+}

package/dist/svelte/sharing/README.md

@@ -0,0 +1,38 @@
+# @vibesdotdev/media/svelte/sharing
+
+Reusable Svelte 5 components for revocable media share links.
+
+```svelte
+<script lang="ts">
+  // Import via narrow subpaths to avoid pulling the $state barrel into .ts modules.
+  import ShareButton from '@vibesdotdev/media/svelte/sharing/components/ShareButton.svelte';
+  import ShareLoader from '@vibesdotdev/media/svelte/sharing/components/ShareLoader.svelte';
+
+  let { fileId }: { fileId: string } = $props();
+</script>
+
+<ShareLoader {fileId} />
+<ShareButton {fileId} />
+```
+
+`<ShareButton>` opens a dialog where the media owner can create a revocable
+public link (optional label, expiry, and download cap), copy it to the
+clipboard, and revoke it. Links resolve through the uploads `runtime/client`
+(`getVibesUploadsClient(runtime)`); the caller must compose
+`@vibesdotdev/media/uploads/plugin` into the runtime first.
+
+The plugin also registers `uploads.sharing`, the runtime-owned shared state.
+Each component owns a reactive projection and releases its subscription when
+unmounted. Removing one consumer leaves the others active; disposing the runtime
+clears shared state and ignores late HTTP completions, including revoke rollback.
+`SharingState` and `getSharingState()` remain compatible entrypoints.
+
+Active badges count future and never-expiring links, excluding revoked, expired,
+and invalid-expiry links. Links appear newest first. Mounted lifecycle proof runs
+under `bun run test:svelte` with real runtime clients and HTTP/clock boundaries.
+
+The owner is billed for anonymous share-download egress, so the download cap is
+a cost ceiling. Revocation is immediate at the origin (a CDN copy may persist
+until its short cache TTL expires).
+
+See [`SPEC.md`](./SPEC.md) for the full contract.

package/dist/svelte/sharing/components/ShareButton.svelte

@@ -0,0 +1,57 @@
+<script lang="ts">
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { Button } from '@vibesdotdev/kit/components/ui/button';
+	import { getSharingState } from '../state.svelte.js';
+	import ShareDialog from './ShareDialog.svelte';
+
+	/**
+	 * ShareButton — an icon button that opens the share-link dialog for a media
+	 * item. Reuses the kit Button/Icon to match the host app's button row (e.g.
+	 * the ImageViewer download button). Reflects the active link count as a small
+	 * badge when known.
+	 */
+	let {
+		fileId,
+		size = 'sm',
+		variant = 'outline',
+		label = 'Share image',
+		ariaLabel
+	}: {
+		fileId: string;
+		size?: 'default' | 'sm' | 'lg' | 'icon';
+		variant?: 'default' | 'outline' | 'secondary' | 'ghost' | 'link' | 'destructive';
+		label?: string;
+		ariaLabel?: string;
+	} = $props();
+
+	let open = $state(false);
+
+	const sharingState = getSharingState();
+	const activeCount = $derived(sharingState.activeLinks(fileId).length);
+	const activeLinkText = $derived(
+		activeCount === 0
+			? ''
+			: activeCount === 1
+				? ', 1 active share link'
+				: `, ${activeCount} active share links`
+	);
+	const buttonLabel = $derived(`${ariaLabel ?? (label || 'Open share links')}${activeLinkText}`);
+</script>
+
+<Button
+	type="button"
+	{size}
+	{variant}
+	onclick={() => (open = true)}
+	aria-label={buttonLabel}
+	aria-haspopup="dialog"
+	aria-expanded={open}
+	disabled={!fileId}
+>
+	<Icon icon="lucide:share-2" class="h-4 w-4" aria-hidden="true" />
+	{#if activeCount > 0}
+		<span class="ml-1 text-xs tabular-nums" aria-hidden="true">{activeCount}</span>
+	{/if}
+</Button>
+
+<ShareDialog {fileId} bind:open />

package/dist/svelte/sharing/components/ShareButton.svelte.d.ts

@@ -0,0 +1,11 @@
+type $$ComponentProps = {
+    fileId: string;
+    size?: 'default' | 'sm' | 'lg' | 'icon';
+    variant?: 'default' | 'outline' | 'secondary' | 'ghost' | 'link' | 'destructive';
+    label?: string;
+    ariaLabel?: string;
+};
+declare const ShareButton: import("svelte").Component<$$ComponentProps, {}, "">;
+type ShareButton = ReturnType<typeof ShareButton>;
+export default ShareButton;
+//# sourceMappingURL=ShareButton.svelte.d.ts.map

package/dist/svelte/sharing/components/ShareButton.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareButton.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/sharing/components/ShareButton.svelte.ts"],"names":[],"mappings":"AAQC,KAAK,gBAAgB,GAAI;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IACxC,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA8CH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/sharing/components/ShareDialog.svelte

@@ -0,0 +1,222 @@
+<script lang="ts">
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import { Badge } from '@vibesdotdev/kit/components/ui/badge';
+	import { Button } from '@vibesdotdev/kit/components/ui/button';
+	import * as Dialog from '@vibesdotdev/kit/components/ui/dialog';
+	import { Input } from '@vibesdotdev/kit/components/ui/input';
+	import { Label } from '@vibesdotdev/kit/components/ui/label';
+	import { toast } from 'svelte-sonner';
+	import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+	import { logOn } from '../../runtime-log.js';
+	import { attempt, failureLabel } from '../../../utils/attempt.js';
+	import { failureMessage } from '../../failure-message.js';
+	import { getSharingState } from '../state.svelte.js';
+	import {
+		SHARE_EXPIRY_PRESETS,
+		formatExpiry,
+		isLinkActive,
+		copyToClipboard,
+		type ClipboardHost
+	} from '../runtime.js';
+
+	/**
+	 * ShareDialog — create, copy, and revoke revocable public share links for a
+	 * media item. All mutations go through `sharingState`, which resolves the
+	 * uploads `runtime/client`. The owner is charged for anonymous share egress,
+	 * so an optional max-downloads cap is offered as a cost guard.
+	 */
+	let {
+		fileId,
+		open = $bindable(false)
+	}: {
+		fileId: string;
+		open?: boolean;
+	} = $props();
+
+	// Captured at component init: Svelte context is unavailable after mount.
+	const runtimeStore = getRuntimeSvelteContext();
+	/** The page's own clipboard and document; a failed attempt is logged by class only. */
+	const clipboardHost: ClipboardHost = {
+		navigator: globalThis.navigator,
+		document: globalThis.document,
+		onFailure: (failure) =>
+			void logOn(runtimeStore, 'debug', 'svelte.sharing', 'share dialog: clipboard attempt failed', { failure: failureLabel(failure) })
+	};
+
+	let label = $state('');
+	let expiryValue = $state<number | null>(null);
+	let maxDownloads = $state<number | null>(null);
+	let creating = $state(false);
+
+	const sharingState = getSharingState();
+	const links = $derived(sharingState.links(fileId));
+	const loading = $derived(sharingState.isLoading(fileId));
+	const loadError = $derived(sharingState.error(fileId));
+
+	// Lazily load existing links when the dialog first opens.
+	$effect(() => {
+		if (open && fileId) void sharingState.init(fileId);
+	});
+
+	function resetForm() {
+		label = '';
+		expiryValue = null;
+		maxDownloads = null;
+	}
+
+	async function createLink() {
+		if (!fileId || creating) return;
+		creating = true;
+		const created = await attempt(() =>
+			sharingState.create(fileId, {
+				label: label.trim() || undefined,
+				expiresIn: expiryValue ?? undefined,
+				maxDownloads: maxDownloads ?? undefined
+			})
+		);
+		creating = false;
+		if (!created.ok) {
+			// A fixed message; the failure's class and reason are logged, never its text.
+			toast.error(failureMessage(created.failure, 'Failed to create share link'));
+			void logOn(runtimeStore, 'warn', 'svelte.sharing', 'share dialog: create failed', { failure: failureLabel(created.failure) });
+			return;
+		}
+		resetForm();
+		const ok = await copyToClipboard(created.value.shareUrl, clipboardHost);
+		toast.success(ok ? 'Share link created and copied' : 'Share link created');
+	}
+
+	async function copyLink(url: string) {
+		const ok = await copyToClipboard(url, clipboardHost);
+		if (ok) toast.success('Link copied');
+		else toast.error('Could not copy link');
+	}
+
+	async function revokeLink(shareId: string) {
+		const revoked = await attempt(() => sharingState.revoke(fileId, shareId));
+		if (!revoked.ok) {
+			toast.error(failureMessage(revoked.failure, 'Failed to revoke share link'));
+			void logOn(runtimeStore, 'warn', 'svelte.sharing', 'share dialog: revoke failed', { failure: failureLabel(revoked.failure) });
+			return;
+		}
+		if (revoked.value) toast.success('Share link revoked');
+		else toast.error('Share link not found');
+	}
+
+	function onExpiryChange(raw: string) {
+		expiryValue = raw === 'null' ? null : Number(raw);
+	}
+
+	function onMaxDownloadsInput(raw: string) {
+		const n = Number(raw);
+		maxDownloads = raw && Number.isFinite(n) && n > 0 ? Math.floor(n) : null;
+	}
+</script>
+
+<Dialog.Root bind:open>
+	<Dialog.Content class="sm:max-w-lg">
+		<Dialog.Header>
+			<Dialog.Title>Share link</Dialog.Title>
+			<Dialog.Description>
+				Create a revocable public link to this media. Anyone with the link can view it until you
+				revoke it. You are charged for downloads, so set a download cap if you want a cost ceiling.
+			</Dialog.Description>
+		</Dialog.Header>
+
+		<div class="space-y-4 py-2">
+			<div class="space-y-2">
+				<Label for="share-label">Label (optional)</Label>
+				<Input id="share-label" bind:value={label} placeholder="e.g. Twitter" />
+			</div>
+
+			<div class="grid grid-cols-2 gap-3">
+				<div class="space-y-2">
+					<Label for="share-expiry">Expires</Label>
+					<select
+						id="share-expiry"
+						class="border-input bg-background ring-offset-background focus-visible:ring-ring flex h-9 w-full rounded-md border px-3 py-1 text-sm shadow-sm focus-visible:outline-none focus-visible:ring-1"
+						value={expiryValue === null ? 'null' : String(expiryValue)}
+						onchange={(event) => onExpiryChange(event.currentTarget.value)}
+					>
+						{#each SHARE_EXPIRY_PRESETS as preset}
+							<option value={preset.value === null ? 'null' : String(preset.value)}>
+								{preset.label}
+							</option>
+						{/each}
+					</select>
+				</div>
+				<div class="space-y-2">
+					<Label for="share-max">Max downloads (optional)</Label>
+					<Input
+						id="share-max"
+						type="number"
+						min="1"
+						placeholder="Unlimited"
+						value={maxDownloads ?? ''}
+						oninput={(event) => onMaxDownloadsInput(event.currentTarget.value)}
+					/>
+				</div>
+			</div>
+
+			<Button onclick={createLink} disabled={!fileId || creating} class="w-full">
+				<Icon icon="lucide:link" class="mr-2 h-4 w-4" />
+				{creating ? 'Creating…' : 'Create share link'}
+			</Button>
+
+			<div class="space-y-2">
+				<div class="text-muted-foreground text-xs font-medium">Existing links</div>
+				{#if loading}
+					<p class="text-muted-foreground text-sm">Loading…</p>
+				{:else if loadError}
+					<p class="text-destructive text-sm">{loadError}</p>
+				{:else if links.length === 0}
+					<p class="text-muted-foreground text-sm">No share links yet.</p>
+				{:else}
+					<ul class="space-y-2">
+						{#each links as link (link.id)}
+							{@const active = isLinkActive(link)}
+							<li class="flex items-center gap-2 rounded-md border p-2">
+								<div class="min-w-0 flex-1">
+									<div class="flex items-center gap-2">
+										<span class="truncate text-sm font-medium">
+											{link.label || 'Untitled link'}
+										</span>
+										<Badge variant={active ? 'secondary' : 'outline'}>
+											{link.revokedAt ? 'Revoked' : active ? 'Active' : 'Expired'}
+										</Badge>
+									</div>
+									<div class="text-muted-foreground truncate text-xs">{link.shareUrl}</div>
+									<div class="text-muted-foreground text-xs">
+										Expires: {formatExpiry(link.expiresAt)} · Downloads: {link.downloadCount}{#if link.maxDownloads}/{link.maxDownloads}{/if}
+									</div>
+								</div>
+								{#if active}
+									<Button
+										size="sm"
+										variant="ghost"
+										aria-label="Copy link"
+										onclick={() => copyLink(link.shareUrl)}
+									>
+										<Icon icon="lucide:copy" class="h-4 w-4" />
+									</Button>
+									<Button
+										size="sm"
+										variant="ghost"
+										aria-label="Revoke link"
+										onclick={() => revokeLink(link.id)}
+									>
+										<Icon icon="lucide:trash-2" class="h-4 w-4" />
+									</Button>
+								{/if}
+							</li>
+						{/each}
+					</ul>
+				{/if}
+			</div>
+		</div>
+
+		<Dialog.Footer>
+			<Button variant="outline" onclick={() => (open = false)}>Close</Button>
+		</Dialog.Footer>
+	</Dialog.Content>
+</Dialog.Root>

package/dist/svelte/sharing/components/ShareDialog.svelte.d.ts

@@ -0,0 +1,8 @@
+type $$ComponentProps = {
+    fileId: string;
+    open?: boolean;
+};
+declare const ShareDialog: import("svelte").Component<$$ComponentProps, {}, "open">;
+type ShareDialog = ReturnType<typeof ShareDialog>;
+export default ShareDialog;
+//# sourceMappingURL=ShareDialog.svelte.d.ts.map

package/dist/svelte/sharing/components/ShareDialog.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareDialog.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/sharing/components/ShareDialog.svelte.ts"],"names":[],"mappings":"AAuBC,KAAK,gBAAgB,GAAI;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAmMH,QAAA,MAAM,WAAW,0DAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/sharing/components/ShareLoader.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import { getSharingState } from '../state.svelte.js';
+
+	/**
+	 * ShareLoader — non-visual. Eagerly loads a file's existing share links into
+	 * the runtime's sharing state so `<ShareButton>` can reflect link count
+	 * immediately. Mount once per file (or per panel). Renders nothing.
+	 *
+	 * The dialog also lazily inits on open, so this loader is optional — use it
+	 * when you want the link count badge to be correct before the dialog opens.
+	 */
+	let { fileId }: { fileId: string } = $props();
+	const sharingState = getSharingState();
+
+	onMount(() => {
+		if (fileId) void sharingState.init(fileId);
+	});
+</script>

package/dist/svelte/sharing/components/ShareLoader.svelte.d.ts

@@ -0,0 +1,7 @@
+type $$ComponentProps = {
+    fileId: string;
+};
+declare const ShareLoader: import("svelte").Component<$$ComponentProps, {}, "">;
+type ShareLoader = ReturnType<typeof ShareLoader>;
+export default ShareLoader;
+//# sourceMappingURL=ShareLoader.svelte.d.ts.map

package/dist/svelte/sharing/components/ShareLoader.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareLoader.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/sharing/components/ShareLoader.svelte.ts"],"names":[],"mappings":"AAMC,KAAK,gBAAgB,GAAI;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAuB7C,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/sharing/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @vibesdotdev/media/svelte/sharing
+ *
+ * Reusable Svelte components and runtime helpers for revocable share links over
+ * uploaded media. Any app can embed `<ShareButton>` / `<ShareDialog>` to let an
+ * owner create, copy, and revoke public share links for a media item, backed by
+ * the runtime-owned `uploads.sharing` client and its context-owned projections.
+ *
+ * NOTE: this barrel re-exports `state.svelte.ts`, which uses Svelte runes. Apps
+ * that import the barrel from a non-Svelte (`.ts`) module will pull the runes
+ * runtime. To avoid that, import components via their narrow subpaths
+ * (`@vibesdotdev/media/svelte/sharing/components/ShareButton.svelte`).
+ */
+export { getSharingState, type SharingState } from './state.svelte.ts';
+export { SHARE_EXPIRY_PRESETS, formatExpiry, isLinkActive, copyToClipboard } from './runtime.ts';
+export { default as ShareButton } from './components/ShareButton.svelte';
+export { default as ShareDialog } from './components/ShareDialog.svelte';
+export { default as ShareLoader } from './components/ShareLoader.svelte';
+export type { ShareLink, CreateShareLinkOptions } from '@vibesdotdev/media/uploads/client';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/sharing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/svelte/sharing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEvE,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEzE,YAAY,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/svelte/sharing/index.js

@@ -0,0 +1,19 @@
+/**
+ * @vibesdotdev/media/svelte/sharing
+ *
+ * Reusable Svelte components and runtime helpers for revocable share links over
+ * uploaded media. Any app can embed `<ShareButton>` / `<ShareDialog>` to let an
+ * owner create, copy, and revoke public share links for a media item, backed by
+ * the runtime-owned `uploads.sharing` client and its context-owned projections.
+ *
+ * NOTE: this barrel re-exports `state.svelte.ts`, which uses Svelte runes. Apps
+ * that import the barrel from a non-Svelte (`.ts`) module will pull the runes
+ * runtime. To avoid that, import components via their narrow subpaths
+ * (`@vibesdotdev/media/svelte/sharing/components/ShareButton.svelte`).
+ */
+export { getSharingState } from "./state.svelte.js";
+export { SHARE_EXPIRY_PRESETS, formatExpiry, isLinkActive, copyToClipboard } from "./runtime.js";
+export { default as ShareButton } from './components/ShareButton.svelte';
+export { default as ShareDialog } from './components/ShareDialog.svelte';
+export { default as ShareLoader } from './components/ShareLoader.svelte';
+// Type-only re-export; the uploads client is composed at the app surface.

package/dist/svelte/sharing/runtime.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Browser runtime helpers for `@vibesdotdev/media/svelte/sharing`.
+ *
+ * Rune-free, side-effect-free helpers used by the components and unit-tested
+ * directly (the state store lives in state.svelte.ts and is not imported here,
+ * to keep this module importable from non-Svelte contexts and tests).
+ */
+import type { CaughtFailure } from '@vibesdotdev/kernel';
+/**
+ * What `copyToClipboard` copies through: a window's navigator and document
+ * (the page's own by default), and where a failed attempt is reported. This
+ * module logs nothing itself, so it stays usable with no runtime booted.
+ */
+export interface ClipboardHost {
+    navigator?: Pick<Navigator, 'clipboard'>;
+    document?: Document;
+    onFailure?: (failure: CaughtFailure) => void;
+}
+/** Expiry option presets offered by the share dialog (seconds, or null=never). */
+export declare const SHARE_EXPIRY_PRESETS: Array<{
+    label: string;
+    value: number | null;
+}>;
+/**
+ * Format an ISO expiry timestamp (or null) into a short human label. Returns
+ * 'Never' for null, 'Expired' for past timestamps and 'Unknown' for a value
+ * that is not a timestamp: it is never read as "never expires".
+ */
+export declare function formatExpiry(expiresAt: string | null, now?: number): string;
+/**
+ * True when the share link is currently usable: not revoked and not expired.
+ * Fails closed: an expiry that is not a timestamp is not active.
+ */
+export declare function isLinkActive(link: {
+    revokedAt: string | null;
+    expiresAt: string | null;
+}, now?: number): boolean;
+/**
+ * Copy text to the clipboard. Uses the async Clipboard API when available and
+ * falls back to a hidden textarea + execCommand for older/insecure contexts.
+ * Returns true on success.
+ */
+export declare function copyToClipboard(text: string, host?: ClipboardHost): Promise<boolean>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/svelte/sharing/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/svelte/sharing/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AAED,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAM/E,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAMvF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC5D,GAAG,GAAE,MAAmB,GACtB,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAiC1F"}

package/dist/svelte/sharing/runtime.js

@@ -0,0 +1,81 @@
+/**
+ * Browser runtime helpers for `@vibesdotdev/media/svelte/sharing`.
+ *
+ * Rune-free, side-effect-free helpers used by the components and unit-tested
+ * directly (the state store lives in state.svelte.ts and is not imported here,
+ * to keep this module importable from non-Svelte contexts and tests).
+ */
+import { attempt, attemptSync } from "../../utils/attempt.js";
+/** Expiry option presets offered by the share dialog (seconds, or null=never). */
+export const SHARE_EXPIRY_PRESETS = [
+    { label: 'Never', value: null },
+    { label: '1 hour', value: 60 * 60 },
+    { label: '24 hours', value: 60 * 60 * 24 },
+    { label: '7 days', value: 60 * 60 * 24 * 7 },
+    { label: '30 days', value: 60 * 60 * 24 * 30 }
+];
+/**
+ * Format an ISO expiry timestamp (or null) into a short human label. Returns
+ * 'Never' for null, 'Expired' for past timestamps and 'Unknown' for a value
+ * that is not a timestamp: it is never read as "never expires".
+ */
+export function formatExpiry(expiresAt, now = Date.now()) {
+    if (expiresAt === null)
+        return 'Never';
+    const ts = Date.parse(expiresAt);
+    if (Number.isNaN(ts))
+        return 'Unknown';
+    if (ts <= now)
+        return 'Expired';
+    return new Date(ts).toLocaleString();
+}
+/**
+ * True when the share link is currently usable: not revoked and not expired.
+ * Fails closed: an expiry that is not a timestamp is not active.
+ */
+export function isLinkActive(link, now = Date.now()) {
+    if (link.revokedAt !== null)
+        return false;
+    if (link.expiresAt === null)
+        return true;
+    const ts = Date.parse(link.expiresAt);
+    if (Number.isNaN(ts))
+        return false;
+    return ts > now;
+}
+/**
+ * Copy text to the clipboard. Uses the async Clipboard API when available and
+ * falls back to a hidden textarea + execCommand for older/insecure contexts.
+ * Returns true on success.
+ */
+export async function copyToClipboard(text, host) {
+    // The page's own navigator and document unless the caller names the host (another window, a test).
+    const { navigator: pageNavigator, document: pageDocument, onFailure } = host ?? { navigator: globalThis.navigator, document: globalThis.document };
+    const clipboard = pageNavigator?.clipboard;
+    if (clipboard) {
+        const written = await attempt(() => clipboard.writeText(text));
+        if (written.ok)
+            return true;
+        // The Clipboard API was denied or failed: the caller is told, and the execCommand path is tried.
+        onFailure?.(written.failure);
+    }
+    if (!pageDocument)
+        return false;
+    const copied = attemptSync(() => {
+        const textarea = pageDocument.createElement('textarea');
+        textarea.value = text;
+        textarea.setAttribute('readonly', '');
+        textarea.style.position = 'absolute';
+        textarea.style.left = '-9999px';
+        pageDocument.body.appendChild(textarea);
+        textarea.select();
+        const ok = pageDocument.execCommand('copy');
+        pageDocument.body.removeChild(textarea);
+        return ok;
+    });
+    if (copied.ok)
+        return copied.value;
+    // execCommand is a deprecated browser API; its failure is `false` to the caller, who is also told why.
+    onFailure?.(copied.failure);
+    return false;
+}

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

@@ -0,0 +1,28 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { CreateShareLinkOptions, ShareLink } from '../../uploads/schemas/shares.ts';
+import { type SharingEntry } from '../../schemas/sharing-state.ts';
+/** A context-owned reactive projection of the runtime's shared capability. */
+export declare class SharingState {
+    private readonly loadRuntime;
+    private entries;
+    private pending;
+    private unsubscribe?;
+    private generation;
+    private disposed;
+    constructor(loadRuntime: () => Promise<VibesRuntime>);
+    entry(fileId: string): SharingEntry;
+    links(fileId: string): ShareLink[];
+    isLoading(fileId: string): boolean;
+    error(fileId: string): string | null;
+    activeLinks(fileId: string): ShareLink[];
+    private resolveClient;
+    private assertCurrent;
+    init(fileId: string): Promise<void>;
+    refresh(fileId: string): Promise<void>;
+    create(fileId: string, options?: CreateShareLinkOptions): Promise<ShareLink>;
+    revoke(fileId: string, shareId: string): Promise<boolean>;
+    dispose(): void;
+}
+/** Each consumer releases its projection; the runtime retains shared observations. */
+export declare function getSharingState(): SharingState;
+//# sourceMappingURL=state.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/sharing/state.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAqB,KAAK,YAAY,EAAwB,MAAM,gCAAgC,CAAC;AAK5G,8EAA8E;AAC9E,qBAAa,YAAY;IAOZ,OAAO,CAAC,QAAQ,CAAC,WAAW;IANxC,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAS;gBAEI,WAAW,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC;IAErE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IACnC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAClC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAClC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAEpC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAKxC,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,aAAa;IAMf,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,SAAS,CAAC;IAMhF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO/D,OAAO,IAAI,IAAI;CAQf;AAED,sFAAsF;AACtF,wBAAgB,eAAe,IAAI,YAAY,CAO9C"}