@bardway/trpg-media 0.0.0-stage → 0.1.0

package/dist/video-poster.d.ts

@@ -0,0 +1,77 @@
+/** Source moduleMediaUpload browser decoding, poster probing/downsampling and upload compensation. */
+export interface VideoMetadata {
+    width: number;
+    height: number;
+    duration: number;
+}
+export interface VideoLimits {
+    mimeTypes: readonly string[];
+    maximumBytes: number;
+    maximumWidth: number;
+    maximumHeight: number;
+    maximumDurationSeconds: number;
+}
+export interface PosterOptions {
+    limits: VideoLimits;
+    maximumPosterBytes?: number;
+    eventTimeoutMs?: number;
+    signal?: AbortSignal;
+    environment?: PosterEnvironment;
+}
+export interface PosterCanvas {
+    readonly width: number;
+    readonly height: number;
+    readonly source: CanvasImageSource;
+    clear(): void;
+    drawVideo(video: HTMLVideoElement): void;
+    drawCanvas(canvas: PosterCanvas): void;
+    hasVisiblePixels(): boolean;
+    toWebp(): Promise<Blob>;
+}
+export interface PosterEnvironment {
+    createVideo(): HTMLVideoElement;
+    createCanvas(width: number, height: number): PosterCanvas;
+    createObjectURL(file: File): string;
+    revokeObjectURL(url: string): void;
+}
+export declare function validateVideoMetadata(file: Pick<File, 'type' | 'size'>, metadata: VideoMetadata, limits: VideoLimits): void;
+export declare const browserPosterEnvironment: PosterEnvironment;
+export declare const posterFilename: (filename: string) => string;
+export declare const posterSeekTimes: (duration: number) => number[];
+export declare function createVideoPoster(file: File, options: PosterOptions): Promise<{
+    poster: File;
+    metadata: VideoMetadata;
+}>;
+export declare function readWebpDimensions(file: File, signal?: AbortSignal): Promise<{
+    width: number;
+    height: number;
+}>;
+export interface UploadedMediaAsset {
+    key: string;
+    publicUrl: string;
+}
+export interface UploadedDynamicImage {
+    imageUrl: string;
+    videoUrl?: string;
+    width: number;
+    height: number;
+}
+export interface MediaUploadDependencies {
+    upload(file: File): Promise<UploadedMediaAsset>;
+    remove(key: string): Promise<void>;
+    createPoster?: (file: File, options: PosterOptions) => Promise<{
+        poster: File;
+        metadata: VideoMetadata;
+    }>;
+    readImage?: (file: File, signal?: AbortSignal) => Promise<{
+        width: number;
+        height: number;
+    }>;
+}
+export declare class MediaCompensationError extends AggregateError {
+    readonly uploadError: unknown;
+    readonly cleanupError: unknown;
+    constructor(uploadError: unknown, cleanupError: unknown);
+}
+/** Host upload/remove closures retain their original authorization, namespace and account. */
+export declare function uploadDynamicImageAsset(file: File, options: PosterOptions, dependencies: MediaUploadDependencies): Promise<UploadedDynamicImage>;

package/dist/video.js

@@ -0,0 +1,259 @@
+// src/video-poster.ts
+var abortError = () => new DOMException("Media operation aborted", "AbortError");
+var assertActive = (signal) => {
+  if (signal?.aborted) throw abortError();
+};
+function validateLimits(limits) {
+  if (!limits.mimeTypes.length || limits.mimeTypes.some((mime) => typeof mime !== "string" || !mime.trim()))
+    throw new Error("Video MIME policy required");
+  for (const value of [limits.maximumBytes, limits.maximumWidth, limits.maximumHeight])
+    if (!Number.isSafeInteger(value) || value <= 0) throw new Error("Invalid video size limit");
+  if (!Number.isFinite(limits.maximumDurationSeconds) || limits.maximumDurationSeconds <= 0)
+    throw new Error("Invalid video duration limit");
+}
+function validateFile(file, limits) {
+  validateLimits(limits);
+  if (!limits.mimeTypes.includes(file.type)) throw new Error("Unsupported video MIME type");
+  if (!Number.isSafeInteger(file.size) || file.size < 0 || file.size > limits.maximumBytes)
+    throw new Error("Video exceeds byte limit");
+}
+function validateVideoMetadata(file, metadata, limits) {
+  validateFile(file, limits);
+  if (!Number.isFinite(metadata.width) || !Number.isFinite(metadata.height) || metadata.width <= 0 || metadata.height <= 0)
+    throw new Error("Invalid decoded video dimensions");
+  if (metadata.width > limits.maximumWidth || metadata.height > limits.maximumHeight)
+    throw new Error("Video exceeds dimension limit");
+  if (!Number.isFinite(metadata.duration) || metadata.duration <= 0 || metadata.duration > limits.maximumDurationSeconds)
+    throw new Error("Invalid video duration or duration limit exceeded");
+}
+function waitForMediaEvent(target, event, timeoutMs, signal, cleanups) {
+  assertActive(signal);
+  return new Promise((resolve, reject) => {
+    const dispose = () => {
+      clearTimeout(timer);
+      target.removeEventListener(event, success);
+      target.removeEventListener("error", failure);
+      signal?.removeEventListener("abort", cancelled);
+      cleanups.delete(dispose);
+    };
+    const finish = (error) => {
+      dispose();
+      if (error) reject(error);
+      else resolve();
+    };
+    const success = () => finish();
+    const failure = () => finish(new Error("Browser cannot decode video"));
+    const cancelled = () => finish(abortError());
+    const timer = setTimeout(() => finish(new Error("Media event timed out")), timeoutMs);
+    cleanups.add(dispose);
+    target.addEventListener(event, success, { once: true });
+    target.addEventListener("error", failure, { once: true });
+    signal?.addEventListener("abort", cancelled, { once: true });
+  });
+}
+var browserPosterEnvironment = {
+  createVideo: () => document.createElement("video"),
+  createObjectURL: (file) => URL.createObjectURL(file),
+  revokeObjectURL: (url) => URL.revokeObjectURL(url),
+  createCanvas(width, height) {
+    const canvas = document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    const context = canvas.getContext("2d", { willReadFrequently: true });
+    if (!context) throw new Error("Browser cannot create poster canvas");
+    return {
+      get width() {
+        return canvas.width;
+      },
+      get height() {
+        return canvas.height;
+      },
+      source: canvas,
+      clear() {
+        context.clearRect(0, 0, canvas.width, canvas.height);
+      },
+      drawVideo(video) {
+        context.drawImage(video, 0, 0, canvas.width, canvas.height);
+      },
+      drawCanvas(source) {
+        context.drawImage(source.source, 0, 0, canvas.width, canvas.height);
+      },
+      hasVisiblePixels() {
+        const pixels = context.getImageData(0, 0, canvas.width, canvas.height).data;
+        for (let index = 3; index < pixels.length; index += 4) if (pixels[index] !== 0) return true;
+        return false;
+      },
+      toWebp: () => new Promise(
+        (resolve, reject) => canvas.toBlob(
+          (blob) => blob ? resolve(blob) : reject(new Error("Cannot create WebP poster")),
+          "image/webp",
+          0.9
+        )
+      )
+    };
+  }
+};
+var posterFilename = (filename) => {
+  const stem = (filename.split(/[\\/]/).pop() ?? "video").replace(/\.webm$/i, "").replace(/[^A-Za-z0-9_.-]/g, "_");
+  return `${stem || "video"}-poster.webp`;
+};
+var posterSeekTimes = (duration) => Array.from(new Set([0.1, 0.3, 0.5].map((time) => Math.min(time, duration / 2))));
+async function createVideoPoster(file, options) {
+  validateFile(file, options.limits);
+  assertActive(options.signal);
+  const maximum = options.maximumPosterBytes ?? Infinity;
+  const timeout = options.eventTimeoutMs ?? 1e4;
+  if (options.maximumPosterBytes !== void 0 && (!Number.isSafeInteger(maximum) || maximum <= 0) || !Number.isFinite(timeout) || timeout <= 0)
+    throw new Error("Invalid poster limit or event timeout");
+  const environment = options.environment ?? browserPosterEnvironment;
+  const video = environment.createVideo();
+  const objectUrl = environment.createObjectURL(file);
+  const cleanups = /* @__PURE__ */ new Set();
+  video.muted = true;
+  video.playsInline = true;
+  video.preload = "auto";
+  try {
+    const ready = waitForMediaEvent(video, "loadedmetadata", timeout, options.signal, cleanups);
+    video.src = objectUrl;
+    video.load();
+    await ready;
+    assertActive(options.signal);
+    const metadata = {
+      width: video.videoWidth,
+      height: video.videoHeight,
+      duration: video.duration
+    };
+    validateVideoMetadata(file, metadata, options.limits);
+    if (video.readyState < HTMLMediaElement.HAVE_CURRENT_DATA)
+      await waitForMediaEvent(video, "loadeddata", timeout, options.signal, cleanups);
+    const canvas = environment.createCanvas(metadata.width, metadata.height);
+    for (const seekTime of posterSeekTimes(metadata.duration)) {
+      const seeked = waitForMediaEvent(video, "seeked", timeout, options.signal, cleanups);
+      video.currentTime = seekTime;
+      await seeked;
+      assertActive(options.signal);
+      if (video.readyState < HTMLMediaElement.HAVE_CURRENT_DATA)
+        throw new Error("Browser did not decode the selected frame");
+      canvas.clear();
+      canvas.drawVideo(video);
+      if (!canvas.hasVisiblePixels()) continue;
+      let output = canvas;
+      let blob = await output.toWebp();
+      assertActive(options.signal);
+      while (blob.size > maximum) {
+        if (Math.min(output.width, output.height) < 16)
+          throw new Error("Cannot meet poster byte limit");
+        const smaller = environment.createCanvas(
+          Math.max(1, Math.floor(output.width * 0.75)),
+          Math.max(1, Math.floor(output.height * 0.75))
+        );
+        smaller.drawCanvas(output);
+        output = smaller;
+        blob = await output.toWebp();
+        assertActive(options.signal);
+      }
+      return {
+        poster: new File([blob], posterFilename(file.name), { type: "image/webp" }),
+        metadata
+      };
+    }
+    throw new Error("Browser could not generate a visible video poster");
+  } finally {
+    for (const cleanup of [...cleanups]) cleanup();
+    try {
+      video.pause();
+      video.removeAttribute("src");
+      video.load();
+    } finally {
+      environment.revokeObjectURL(objectUrl);
+    }
+  }
+}
+function readWebpDimensions(file, signal) {
+  assertActive(signal);
+  if (file.type !== "image/webp") throw new Error("Image must use WebP MIME type");
+  return new Promise((resolve, reject) => {
+    const objectUrl = URL.createObjectURL(file);
+    const image = new Image();
+    const cleanup = () => {
+      URL.revokeObjectURL(objectUrl);
+      signal?.removeEventListener("abort", cancelled);
+      image.onload = null;
+      image.onerror = null;
+    };
+    const cancelled = () => {
+      cleanup();
+      reject(abortError());
+    };
+    image.onload = () => {
+      const size = { width: image.naturalWidth, height: image.naturalHeight };
+      cleanup();
+      if (size.width <= 0 || size.height <= 0) reject(new Error("Invalid image dimensions"));
+      else resolve(size);
+    };
+    image.onerror = () => {
+      cleanup();
+      reject(new Error("Cannot read WebP image dimensions"));
+    };
+    signal?.addEventListener("abort", cancelled, { once: true });
+    image.src = objectUrl;
+  });
+}
+var MediaCompensationError = class extends AggregateError {
+  constructor(uploadError, cleanupError) {
+    super([uploadError, cleanupError], "Video upload failed and poster cleanup failed");
+    this.uploadError = uploadError;
+    this.cleanupError = cleanupError;
+    this.name = "MediaCompensationError";
+  }
+  uploadError;
+  cleanupError;
+};
+async function uploadDynamicImageAsset(file, options, dependencies) {
+  if (typeof dependencies.upload !== "function" || typeof dependencies.remove !== "function")
+    throw new Error("Real media upload and cleanup drivers are required");
+  assertActive(options.signal);
+  if (file.type === "image/webp") {
+    const size = await (dependencies.readImage ?? readWebpDimensions)(file, options.signal);
+    if (!Number.isFinite(size.width) || !Number.isFinite(size.height) || size.width <= 0 || size.height <= 0)
+      throw new Error("Invalid image dimensions");
+    assertActive(options.signal);
+    const image2 = await dependencies.upload(file);
+    return { imageUrl: image2.publicUrl, ...size };
+  }
+  const { poster, metadata } = await (dependencies.createPoster ?? createVideoPoster)(
+    file,
+    options
+  );
+  validateVideoMetadata(file, metadata, options.limits);
+  assertActive(options.signal);
+  const image = await dependencies.upload(poster);
+  try {
+    assertActive(options.signal);
+    const video = await dependencies.upload(file);
+    return {
+      imageUrl: image.publicUrl,
+      videoUrl: video.publicUrl,
+      width: metadata.width,
+      height: metadata.height
+    };
+  } catch (error) {
+    try {
+      await dependencies.remove(image.key);
+    } catch (cleanupError) {
+      throw new MediaCompensationError(error, cleanupError);
+    }
+    throw error;
+  }
+}
+export {
+  MediaCompensationError,
+  browserPosterEnvironment,
+  createVideoPoster,
+  posterFilename,
+  posterSeekTimes,
+  readWebpDimensions,
+  uploadDynamicImageAsset,
+  validateVideoMetadata
+};
+//# sourceMappingURL=video.js.map

package/dist/video.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/video-poster.ts"],
+  "sourcesContent": ["/** Source moduleMediaUpload browser decoding, poster probing/downsampling and upload compensation. */\nexport interface VideoMetadata {\n  width: number;\n  height: number;\n  duration: number;\n}\nexport interface VideoLimits {\n  mimeTypes: readonly string[];\n  maximumBytes: number;\n  maximumWidth: number;\n  maximumHeight: number;\n  maximumDurationSeconds: number;\n}\nexport interface PosterOptions {\n  limits: VideoLimits;\n  maximumPosterBytes?: number;\n  eventTimeoutMs?: number;\n  signal?: AbortSignal;\n  environment?: PosterEnvironment;\n}\nexport interface PosterCanvas {\n  readonly width: number;\n  readonly height: number;\n  readonly source: CanvasImageSource;\n  clear(): void;\n  drawVideo(video: HTMLVideoElement): void;\n  drawCanvas(canvas: PosterCanvas): void;\n  hasVisiblePixels(): boolean;\n  toWebp(): Promise<Blob>;\n}\nexport interface PosterEnvironment {\n  createVideo(): HTMLVideoElement;\n  createCanvas(width: number, height: number): PosterCanvas;\n  createObjectURL(file: File): string;\n  revokeObjectURL(url: string): void;\n}\n\nconst abortError = (): DOMException => new DOMException('Media operation aborted', 'AbortError');\nconst assertActive = (signal?: AbortSignal): void => {\n  if (signal?.aborted) throw abortError();\n};\nfunction validateLimits(limits: VideoLimits): void {\n  if (\n    !limits.mimeTypes.length ||\n    limits.mimeTypes.some((mime) => typeof mime !== 'string' || !mime.trim())\n  )\n    throw new Error('Video MIME policy required');\n  for (const value of [limits.maximumBytes, limits.maximumWidth, limits.maximumHeight])\n    if (!Number.isSafeInteger(value) || value <= 0) throw new Error('Invalid video size limit');\n  if (!Number.isFinite(limits.maximumDurationSeconds) || limits.maximumDurationSeconds <= 0)\n    throw new Error('Invalid video duration limit');\n}\nfunction validateFile(file: Pick<File, 'type' | 'size'>, limits: VideoLimits): void {\n  validateLimits(limits);\n  if (!limits.mimeTypes.includes(file.type)) throw new Error('Unsupported video MIME type');\n  if (!Number.isSafeInteger(file.size) || file.size < 0 || file.size > limits.maximumBytes)\n    throw new Error('Video exceeds byte limit');\n}\nexport function validateVideoMetadata(\n  file: Pick<File, 'type' | 'size'>,\n  metadata: VideoMetadata,\n  limits: VideoLimits,\n): void {\n  validateFile(file, limits);\n  if (\n    !Number.isFinite(metadata.width) ||\n    !Number.isFinite(metadata.height) ||\n    metadata.width <= 0 ||\n    metadata.height <= 0\n  )\n    throw new Error('Invalid decoded video dimensions');\n  if (metadata.width > limits.maximumWidth || metadata.height > limits.maximumHeight)\n    throw new Error('Video exceeds dimension limit');\n  if (\n    !Number.isFinite(metadata.duration) ||\n    metadata.duration <= 0 ||\n    metadata.duration > limits.maximumDurationSeconds\n  )\n    throw new Error('Invalid video duration or duration limit exceeded');\n}\nfunction waitForMediaEvent(\n  target: HTMLMediaElement,\n  event: 'loadedmetadata' | 'loadeddata' | 'seeked',\n  timeoutMs: number,\n  signal: AbortSignal | undefined,\n  cleanups: Set<() => void>,\n): Promise<void> {\n  assertActive(signal);\n  return new Promise((resolve, reject) => {\n    const dispose = (): void => {\n      clearTimeout(timer);\n      target.removeEventListener(event, success);\n      target.removeEventListener('error', failure);\n      signal?.removeEventListener('abort', cancelled);\n      cleanups.delete(dispose);\n    };\n    const finish = (error?: Error): void => {\n      dispose();\n      if (error) reject(error);\n      else resolve();\n    };\n    const success = () => finish();\n    const failure = () => finish(new Error('Browser cannot decode video'));\n    const cancelled = () => finish(abortError());\n    const timer = setTimeout(() => finish(new Error('Media event timed out')), timeoutMs);\n    cleanups.add(dispose);\n    target.addEventListener(event, success, { once: true });\n    target.addEventListener('error', failure, { once: true });\n    signal?.addEventListener('abort', cancelled, { once: true });\n  });\n}\nexport const browserPosterEnvironment: PosterEnvironment = {\n  createVideo: () => document.createElement('video'),\n  createObjectURL: (file) => URL.createObjectURL(file),\n  revokeObjectURL: (url) => URL.revokeObjectURL(url),\n  createCanvas(width, height) {\n    const canvas = document.createElement('canvas');\n    canvas.width = width;\n    canvas.height = height;\n    const context = canvas.getContext('2d', { willReadFrequently: true });\n    if (!context) throw new Error('Browser cannot create poster canvas');\n    return {\n      get width() {\n        return canvas.width;\n      },\n      get height() {\n        return canvas.height;\n      },\n      source: canvas,\n      clear() {\n        context.clearRect(0, 0, canvas.width, canvas.height);\n      },\n      drawVideo(video) {\n        context.drawImage(video, 0, 0, canvas.width, canvas.height);\n      },\n      drawCanvas(source) {\n        context.drawImage(source.source, 0, 0, canvas.width, canvas.height);\n      },\n      hasVisiblePixels() {\n        const pixels = context.getImageData(0, 0, canvas.width, canvas.height).data;\n        for (let index = 3; index < pixels.length; index += 4) if (pixels[index] !== 0) return true;\n        return false;\n      },\n      toWebp: () =>\n        new Promise((resolve, reject) =>\n          canvas.toBlob(\n            (blob) => (blob ? resolve(blob) : reject(new Error('Cannot create WebP poster'))),\n            'image/webp',\n            0.9,\n          ),\n        ),\n    };\n  },\n};\nexport const posterFilename = (filename: string): string => {\n  const stem = (filename.split(/[\\\\/]/).pop() ?? 'video')\n    .replace(/\\.webm$/i, '')\n    .replace(/[^A-Za-z0-9_.-]/g, '_');\n  return `${stem || 'video'}-poster.webp`;\n};\nexport const posterSeekTimes = (duration: number): number[] =>\n  Array.from(new Set([0.1, 0.3, 0.5].map((time) => Math.min(time, duration / 2))));\n\nexport async function createVideoPoster(\n  file: File,\n  options: PosterOptions,\n): Promise<{ poster: File; metadata: VideoMetadata }> {\n  validateFile(file, options.limits);\n  assertActive(options.signal);\n  const maximum = options.maximumPosterBytes ?? Infinity;\n  const timeout = options.eventTimeoutMs ?? 10_000;\n  if (\n    (options.maximumPosterBytes !== undefined &&\n      (!Number.isSafeInteger(maximum) || maximum <= 0)) ||\n    !Number.isFinite(timeout) ||\n    timeout <= 0\n  )\n    throw new Error('Invalid poster limit or event timeout');\n  const environment = options.environment ?? browserPosterEnvironment;\n  const video = environment.createVideo();\n  const objectUrl = environment.createObjectURL(file);\n  const cleanups = new Set<() => void>();\n  video.muted = true;\n  video.playsInline = true;\n  video.preload = 'auto';\n  try {\n    const ready = waitForMediaEvent(video, 'loadedmetadata', timeout, options.signal, cleanups);\n    video.src = objectUrl;\n    video.load();\n    await ready;\n    assertActive(options.signal);\n    const metadata = {\n      width: video.videoWidth,\n      height: video.videoHeight,\n      duration: video.duration,\n    };\n    validateVideoMetadata(file, metadata, options.limits);\n    if (video.readyState < HTMLMediaElement.HAVE_CURRENT_DATA)\n      await waitForMediaEvent(video, 'loadeddata', timeout, options.signal, cleanups);\n    const canvas = environment.createCanvas(metadata.width, metadata.height);\n    for (const seekTime of posterSeekTimes(metadata.duration)) {\n      const seeked = waitForMediaEvent(video, 'seeked', timeout, options.signal, cleanups);\n      video.currentTime = seekTime;\n      await seeked;\n      assertActive(options.signal);\n      if (video.readyState < HTMLMediaElement.HAVE_CURRENT_DATA)\n        throw new Error('Browser did not decode the selected frame');\n      canvas.clear();\n      canvas.drawVideo(video);\n      if (!canvas.hasVisiblePixels()) continue;\n      let output = canvas;\n      let blob = await output.toWebp();\n      assertActive(options.signal);\n      while (blob.size > maximum) {\n        if (Math.min(output.width, output.height) < 16)\n          throw new Error('Cannot meet poster byte limit');\n        const smaller = environment.createCanvas(\n          Math.max(1, Math.floor(output.width * 0.75)),\n          Math.max(1, Math.floor(output.height * 0.75)),\n        );\n        smaller.drawCanvas(output);\n        output = smaller;\n        blob = await output.toWebp();\n        assertActive(options.signal);\n      }\n      return {\n        poster: new File([blob], posterFilename(file.name), { type: 'image/webp' }),\n        metadata,\n      };\n    }\n    throw new Error('Browser could not generate a visible video poster');\n  } finally {\n    for (const cleanup of [...cleanups]) cleanup();\n    try {\n      video.pause();\n      video.removeAttribute('src');\n      video.load();\n    } finally {\n      environment.revokeObjectURL(objectUrl);\n    }\n  }\n}\n\nexport function readWebpDimensions(\n  file: File,\n  signal?: AbortSignal,\n): Promise<{ width: number; height: number }> {\n  assertActive(signal);\n  if (file.type !== 'image/webp') throw new Error('Image must use WebP MIME type');\n  return new Promise((resolve, reject) => {\n    const objectUrl = URL.createObjectURL(file);\n    const image = new Image();\n    const cleanup = () => {\n      URL.revokeObjectURL(objectUrl);\n      signal?.removeEventListener('abort', cancelled);\n      image.onload = null;\n      image.onerror = null;\n    };\n    const cancelled = () => {\n      cleanup();\n      reject(abortError());\n    };\n    image.onload = () => {\n      const size = { width: image.naturalWidth, height: image.naturalHeight };\n      cleanup();\n      if (size.width <= 0 || size.height <= 0) reject(new Error('Invalid image dimensions'));\n      else resolve(size);\n    };\n    image.onerror = () => {\n      cleanup();\n      reject(new Error('Cannot read WebP image dimensions'));\n    };\n    signal?.addEventListener('abort', cancelled, { once: true });\n    image.src = objectUrl;\n  });\n}\nexport interface UploadedMediaAsset {\n  key: string;\n  publicUrl: string;\n}\nexport interface UploadedDynamicImage {\n  imageUrl: string;\n  videoUrl?: string;\n  width: number;\n  height: number;\n}\nexport interface MediaUploadDependencies {\n  upload(file: File): Promise<UploadedMediaAsset>;\n  remove(key: string): Promise<void>;\n  createPoster?: (\n    file: File,\n    options: PosterOptions,\n  ) => Promise<{ poster: File; metadata: VideoMetadata }>;\n  readImage?: (file: File, signal?: AbortSignal) => Promise<{ width: number; height: number }>;\n}\nexport class MediaCompensationError extends AggregateError {\n  constructor(\n    readonly uploadError: unknown,\n    readonly cleanupError: unknown,\n  ) {\n    super([uploadError, cleanupError], 'Video upload failed and poster cleanup failed');\n    this.name = 'MediaCompensationError';\n  }\n}\n/** Host upload/remove closures retain their original authorization, namespace and account. */\nexport async function uploadDynamicImageAsset(\n  file: File,\n  options: PosterOptions,\n  dependencies: MediaUploadDependencies,\n): Promise<UploadedDynamicImage> {\n  if (typeof dependencies.upload !== 'function' || typeof dependencies.remove !== 'function')\n    throw new Error('Real media upload and cleanup drivers are required');\n  assertActive(options.signal);\n  if (file.type === 'image/webp') {\n    const size = await (dependencies.readImage ?? readWebpDimensions)(file, options.signal);\n    if (\n      !Number.isFinite(size.width) ||\n      !Number.isFinite(size.height) ||\n      size.width <= 0 ||\n      size.height <= 0\n    )\n      throw new Error('Invalid image dimensions');\n    assertActive(options.signal);\n    const image = await dependencies.upload(file);\n    return { imageUrl: image.publicUrl, ...size };\n  }\n  const { poster, metadata } = await (dependencies.createPoster ?? createVideoPoster)(\n    file,\n    options,\n  );\n  validateVideoMetadata(file, metadata, options.limits);\n  assertActive(options.signal);\n  const image = await dependencies.upload(poster);\n  try {\n    assertActive(options.signal);\n    const video = await dependencies.upload(file);\n    return {\n      imageUrl: image.publicUrl,\n      videoUrl: video.publicUrl,\n      width: metadata.width,\n      height: metadata.height,\n    };\n  } catch (error) {\n    try {\n      await dependencies.remove(image.key);\n    } catch (cleanupError) {\n      throw new MediaCompensationError(error, cleanupError);\n    }\n    throw error;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["image"]
+}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@bardway/trpg-media",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Extracted reusable media runtime for TRPG hosts",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "NOTICE.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bardway/mingriAgency_TRPGEngine.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tuning": {
+      "types": "./dist/tuning.d.ts",
+      "import": "./dist/tuning.js"
+    },
+    "./audio": {
+      "types": "./dist/audio.d.ts",
+      "import": "./dist/audio.js"
+    },
+    "./video": {
+      "types": "./dist/video-poster.d.ts",
+      "import": "./dist/video.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "zod": "4.3.6"
+  },
+  "trpg": {
+    "entries": {
+      "index": "src/index.ts",
+      "tuning": "src/tuning.ts",
+      "audio": "src/audio.ts",
+      "video": "src/video-poster.ts"
+    }
+  }
+}