@dloizides/content-upload 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 1.0.0
+
+Initial release (KEFI-PEOPLE-1 "Organizer people editor", task T3).
+
+- `uploadImage(file, options)`: multipart POST to a consumer-supplied endpoint; CSRF header,
+  credentials, client-side validation (empty / `maxBytes` / `allowedTypes`), abort, progress over
+  XMLHttpRequest, typed `UploadError` with `UploadErrorKind`.
+- `buildUploadRequest` for pinning the write shape (no Content-Type on FormData).
+- `blobFromUri(uri)`.
+- `useImageUpload(options)` hook: `UploadStatus` idle / uploading / error / done, progress,
+  supersede-on-new-upload, abort on reset and unmount.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 dloizides
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# @dloizides/content-upload
+
+Image upload for the dloizides.com RN-web portals: one multipart POST to the ContentService
+through a same-origin BFF proxy, plus a React hook with `idle / uploading / error / done` states.
+Merged from kefi-web `uploadContent.ts` and katalogos-web `useUploadContent.ts`.
+
+## Install
+
+```bash
+npm install @dloizides/content-upload
+```
+
+Peer dependency: `react >= 18` (only for the hook).
+
+## Client
+
+```ts
+import { uploadImage, UploadError, UploadErrorKind } from '@dloizides/content-upload';
+
+const content = await uploadImage(file, {
+  endpoint: '/bff/api/content/api/v1/content/upload', // consumer-supplied
+  maxBytes: 5 * 1024 * 1024,
+  allowedTypes: ['image/png', 'image/jpeg', 'image/webp'],
+});
+// content = { contentId, status, url }
+```
+
+The request is `multipart/form-data` with fields `File`, `Category` (default `Image`) and
+`IsPublic` (default `true`), `credentials: 'include'` and the `X-BFF-Csrf: 1` anti-forgery header
+(`csrf: null` disables it, `csrf: { name, value }` replaces it). **No Content-Type is ever set**:
+the runtime adds the multipart boundary, and a JSON content type on a FormData body is a 415 (the
+same rule `@dloizides/bff-web-client`'s `writeContentTypeGuard` enforces for axios).
+
+Every failure throws `UploadError` with a `kind`: `Validation`, `Network`, `Http` (`status` set),
+`Aborted`, `InvalidResponse`. Map `kind` to translated copy; `message` is developer-facing.
+
+Transport: with `onProgress` and no `fetchImpl`, the upload uses `XMLHttpRequest` (the only
+transport that reports upload progress, available in browsers and React Native). Otherwise it
+uses `fetch`. `signal` aborts either.
+
+`blobFromUri(uri)` reads a `blob:` / `data:` / RN picker `file:` URI into a `Blob`.
+
+## Hook
+
+```ts
+import { useImageUpload, UploadStatus } from '@dloizides/content-upload';
+
+const { status, progress, error, result, upload, reset } = useImageUpload({
+  endpoint: '/bff/api/content/api/v1/content/upload',
+  onSuccess: (content) => setAvatarUrl(content.url),
+});
+
+await upload(file); // resolves to the content, or null on error / abort
+```
+
+- A new `upload()` or `reset()` aborts the in-flight request; its late result is dropped.
+- Unmount aborts the in-flight request.
+- Options are read at call time, so an inline options object is fine.
+
+## Scripts
+
+`npm run lint` · `npm run typecheck` · `npm run test:coverage` (100% threshold) · `npm run build`.
+Publish only via `./publish.ps1 -Bump <patch|minor|major>`.

package/dist/index.d.mts

@@ -0,0 +1,141 @@
+/** A header the BFF anti-forgery middleware requires on mutating requests. */
+interface CsrfHeader {
+    name: string;
+    value: string;
+}
+/** Body returned by the ContentService upload endpoint. */
+interface UploadedContent {
+    /** Stable id of the persisted content row. */
+    contentId: string;
+    /** Server status (e.g. "Active"). */
+    status: string;
+    /** Public download URL; present when the upload was public. */
+    url?: string;
+}
+/** Receives whole-number upload progress, 0-100. */
+type ProgressListener = (percent: number) => void;
+/** Options for `uploadImage`. Only `endpoint` is required. */
+interface UploadImageOptions {
+    /** Same-origin URL of the upload endpoint, e.g. `/bff/api/content/api/v1/content/upload`. */
+    endpoint: string;
+    /** Filename sent with the file part. Defaults to `File.name`, else `"upload"`. */
+    fileName?: string;
+    /** ContentService `Category` form field. Default `"Image"`. */
+    category?: string;
+    /** ContentService `IsPublic` form field. Default `true`. */
+    isPublic?: boolean;
+    /** Reject a 2xx body without `url`. Defaults to the value of `isPublic`. */
+    requireUrl?: boolean;
+    /** Anti-forgery header. Default `X-BFF-Csrf: 1`; pass `null` to send none. */
+    csrf?: CsrfHeader | null;
+    /** Fetch credentials mode. Default `"include"` (BFF session cookie). */
+    credentials?: RequestCredentials;
+    /** Reject files larger than this many bytes before sending. */
+    maxBytes?: number;
+    /** Reject files whose MIME type is not in this list before sending. */
+    allowedTypes?: readonly string[];
+    /** Aborts the request; the promise rejects with `UploadErrorKind.Aborted`. */
+    signal?: AbortSignal;
+    /**
+     * Progress listener. When set (and no `fetchImpl` is given) the upload goes over
+     * XMLHttpRequest, the only browser/RN transport that reports upload progress.
+     */
+    onProgress?: ProgressListener;
+    /** Custom fetch (tests, SSR). Forces the fetch transport. */
+    fetchImpl?: typeof fetch;
+    /** Custom XMLHttpRequest factory (tests). */
+    xhrFactory?: () => XMLHttpRequest;
+}
+
+/** A fully built multipart upload, independent of the transport that sends it. */
+interface UploadRequest {
+    url: string;
+    /** Never contains Content-Type: the runtime sets the multipart boundary for a FormData body. */
+    headers: Record<string, string>;
+    form: FormData;
+    credentials: RequestCredentials;
+    signal: AbortSignal | undefined;
+}
+
+/** The Bff.AspNetCore anti-forgery convention: header presence, any value. */
+declare const DEFAULT_CSRF_HEADER: CsrfHeader;
+/** Build the transport-independent request. Exported so consumers can pin the write shape. */
+declare function buildUploadRequest(file: Blob, options: UploadImageOptions): UploadRequest;
+/**
+ * Upload one image as multipart/form-data (`File`, `Category`, `IsPublic`) to a
+ * consumer-supplied endpoint and return the parsed `{ contentId, status, url }`.
+ *
+ * Never sets Content-Type: the runtime adds the multipart boundary, and a JSON content type
+ * on a FormData body is a 415 (see `@dloizides/bff-web-client` writeContentTypeGuard).
+ *
+ * @throws {UploadError} for every failure; switch on `error.kind`.
+ */
+declare function uploadImage(file: Blob, options: UploadImageOptions): Promise<UploadedContent>;
+
+/**
+ * Read a local URI (`blob:`, `data:`, or an RN image-picker `file:` URI) into a Blob so it
+ * can be passed to `uploadImage`.
+ *
+ * @throws {UploadError} `Validation` when the URI cannot be read.
+ */
+declare function blobFromUri(uri: string, fetchImpl?: typeof fetch): Promise<Blob>;
+
+/** Lifecycle of a single `useImageUpload` slot. */
+declare const enum UploadStatus {
+    Idle = "idle",
+    Uploading = "uploading",
+    Error = "error",
+    Done = "done"
+}
+
+/** Why an upload failed. Consumers map this to translated copy; `message` is developer-facing only. */
+declare const enum UploadErrorKind {
+    /** Rejected client-side before any request: empty file, too large, disallowed MIME type. */
+    Validation = "validation",
+    /** The request never produced an HTTP response (offline, DNS, CORS). */
+    Network = "network",
+    /** The server answered outside 2xx; `status` carries the code. */
+    Http = "http",
+    /** The caller aborted (AbortSignal / hook reset). */
+    Aborted = "aborted",
+    /** 2xx, but the body was not `{ contentId, status, url? }` (or lacked a required url). */
+    InvalidResponse = "invalid-response"
+}
+
+/** The single error type thrown by `uploadImage` and surfaced by `useImageUpload`. */
+declare class UploadError extends Error {
+    readonly kind: UploadErrorKind;
+    /** HTTP status for `UploadErrorKind.Http`; undefined otherwise. */
+    readonly status: number | undefined;
+    constructor(kind: UploadErrorKind, message: string, status?: number);
+}
+/** Normalise anything thrown into an `UploadError` (unknown throws become `Network`). */
+declare function toUploadError(cause: unknown): UploadError;
+
+/** Options for `useImageUpload`: everything `uploadImage` takes except the per-call wiring. */
+interface UseImageUploadOptions extends Omit<UploadImageOptions, 'signal' | 'onProgress'> {
+    onSuccess?: (content: UploadedContent) => void;
+    onError?: (error: UploadError) => void;
+}
+interface ImageUploadState {
+    status: UploadStatus;
+    /** 0-100. Stays 0 while uploading when the transport cannot report progress (fetch). */
+    progress: number;
+    error: UploadError | null;
+    result: UploadedContent | null;
+}
+interface UseImageUploadResult extends ImageUploadState {
+    /** Start an upload (aborting any in-flight one). Resolves to the content, or null on error/abort. */
+    upload: (file: Blob, fileName?: string) => Promise<UploadedContent | null>;
+    /** Abort any in-flight upload and return to idle. */
+    reset: () => void;
+}
+/**
+ * One image-upload slot: idle -> uploading -> done | error. Progress is reported when the
+ * XMLHttpRequest transport is available (browser, React Native) and no `fetchImpl` is set.
+ * A newer `upload()` or `reset()` supersedes the previous request; its late result is dropped.
+ * Unmount aborts the in-flight request.
+ */
+declare function useImageUpload(options: UseImageUploadOptions): UseImageUploadResult;
+
+export { type CsrfHeader, DEFAULT_CSRF_HEADER, type ImageUploadState, type ProgressListener, UploadError, UploadErrorKind, type UploadImageOptions, type UploadRequest, UploadStatus, type UploadedContent, type UseImageUploadOptions, type UseImageUploadResult, blobFromUri, buildUploadRequest, toUploadError, uploadImage, useImageUpload };

package/dist/index.d.ts

@@ -0,0 +1,141 @@
+/** A header the BFF anti-forgery middleware requires on mutating requests. */
+interface CsrfHeader {
+    name: string;
+    value: string;
+}
+/** Body returned by the ContentService upload endpoint. */
+interface UploadedContent {
+    /** Stable id of the persisted content row. */
+    contentId: string;
+    /** Server status (e.g. "Active"). */
+    status: string;
+    /** Public download URL; present when the upload was public. */
+    url?: string;
+}
+/** Receives whole-number upload progress, 0-100. */
+type ProgressListener = (percent: number) => void;
+/** Options for `uploadImage`. Only `endpoint` is required. */
+interface UploadImageOptions {
+    /** Same-origin URL of the upload endpoint, e.g. `/bff/api/content/api/v1/content/upload`. */
+    endpoint: string;
+    /** Filename sent with the file part. Defaults to `File.name`, else `"upload"`. */
+    fileName?: string;
+    /** ContentService `Category` form field. Default `"Image"`. */
+    category?: string;
+    /** ContentService `IsPublic` form field. Default `true`. */
+    isPublic?: boolean;
+    /** Reject a 2xx body without `url`. Defaults to the value of `isPublic`. */
+    requireUrl?: boolean;
+    /** Anti-forgery header. Default `X-BFF-Csrf: 1`; pass `null` to send none. */
+    csrf?: CsrfHeader | null;
+    /** Fetch credentials mode. Default `"include"` (BFF session cookie). */
+    credentials?: RequestCredentials;
+    /** Reject files larger than this many bytes before sending. */
+    maxBytes?: number;
+    /** Reject files whose MIME type is not in this list before sending. */
+    allowedTypes?: readonly string[];
+    /** Aborts the request; the promise rejects with `UploadErrorKind.Aborted`. */
+    signal?: AbortSignal;
+    /**
+     * Progress listener. When set (and no `fetchImpl` is given) the upload goes over
+     * XMLHttpRequest, the only browser/RN transport that reports upload progress.
+     */
+    onProgress?: ProgressListener;
+    /** Custom fetch (tests, SSR). Forces the fetch transport. */
+    fetchImpl?: typeof fetch;
+    /** Custom XMLHttpRequest factory (tests). */
+    xhrFactory?: () => XMLHttpRequest;
+}
+
+/** A fully built multipart upload, independent of the transport that sends it. */
+interface UploadRequest {
+    url: string;
+    /** Never contains Content-Type: the runtime sets the multipart boundary for a FormData body. */
+    headers: Record<string, string>;
+    form: FormData;
+    credentials: RequestCredentials;
+    signal: AbortSignal | undefined;
+}
+
+/** The Bff.AspNetCore anti-forgery convention: header presence, any value. */
+declare const DEFAULT_CSRF_HEADER: CsrfHeader;
+/** Build the transport-independent request. Exported so consumers can pin the write shape. */
+declare function buildUploadRequest(file: Blob, options: UploadImageOptions): UploadRequest;
+/**
+ * Upload one image as multipart/form-data (`File`, `Category`, `IsPublic`) to a
+ * consumer-supplied endpoint and return the parsed `{ contentId, status, url }`.
+ *
+ * Never sets Content-Type: the runtime adds the multipart boundary, and a JSON content type
+ * on a FormData body is a 415 (see `@dloizides/bff-web-client` writeContentTypeGuard).
+ *
+ * @throws {UploadError} for every failure; switch on `error.kind`.
+ */
+declare function uploadImage(file: Blob, options: UploadImageOptions): Promise<UploadedContent>;
+
+/**
+ * Read a local URI (`blob:`, `data:`, or an RN image-picker `file:` URI) into a Blob so it
+ * can be passed to `uploadImage`.
+ *
+ * @throws {UploadError} `Validation` when the URI cannot be read.
+ */
+declare function blobFromUri(uri: string, fetchImpl?: typeof fetch): Promise<Blob>;
+
+/** Lifecycle of a single `useImageUpload` slot. */
+declare const enum UploadStatus {
+    Idle = "idle",
+    Uploading = "uploading",
+    Error = "error",
+    Done = "done"
+}
+
+/** Why an upload failed. Consumers map this to translated copy; `message` is developer-facing only. */
+declare const enum UploadErrorKind {
+    /** Rejected client-side before any request: empty file, too large, disallowed MIME type. */
+    Validation = "validation",
+    /** The request never produced an HTTP response (offline, DNS, CORS). */
+    Network = "network",
+    /** The server answered outside 2xx; `status` carries the code. */
+    Http = "http",
+    /** The caller aborted (AbortSignal / hook reset). */
+    Aborted = "aborted",
+    /** 2xx, but the body was not `{ contentId, status, url? }` (or lacked a required url). */
+    InvalidResponse = "invalid-response"
+}
+
+/** The single error type thrown by `uploadImage` and surfaced by `useImageUpload`. */
+declare class UploadError extends Error {
+    readonly kind: UploadErrorKind;
+    /** HTTP status for `UploadErrorKind.Http`; undefined otherwise. */
+    readonly status: number | undefined;
+    constructor(kind: UploadErrorKind, message: string, status?: number);
+}
+/** Normalise anything thrown into an `UploadError` (unknown throws become `Network`). */
+declare function toUploadError(cause: unknown): UploadError;
+
+/** Options for `useImageUpload`: everything `uploadImage` takes except the per-call wiring. */
+interface UseImageUploadOptions extends Omit<UploadImageOptions, 'signal' | 'onProgress'> {
+    onSuccess?: (content: UploadedContent) => void;
+    onError?: (error: UploadError) => void;
+}
+interface ImageUploadState {
+    status: UploadStatus;
+    /** 0-100. Stays 0 while uploading when the transport cannot report progress (fetch). */
+    progress: number;
+    error: UploadError | null;
+    result: UploadedContent | null;
+}
+interface UseImageUploadResult extends ImageUploadState {
+    /** Start an upload (aborting any in-flight one). Resolves to the content, or null on error/abort. */
+    upload: (file: Blob, fileName?: string) => Promise<UploadedContent | null>;
+    /** Abort any in-flight upload and return to idle. */
+    reset: () => void;
+}
+/**
+ * One image-upload slot: idle -> uploading -> done | error. Progress is reported when the
+ * XMLHttpRequest transport is available (browser, React Native) and no `fetchImpl` is set.
+ * A newer `upload()` or `reset()` supersedes the previous request; its late result is dropped.
+ * Unmount aborts the in-flight request.
+ */
+declare function useImageUpload(options: UseImageUploadOptions): UseImageUploadResult;
+
+export { type CsrfHeader, DEFAULT_CSRF_HEADER, type ImageUploadState, type ProgressListener, UploadError, UploadErrorKind, type UploadImageOptions, type UploadRequest, UploadStatus, type UploadedContent, type UseImageUploadOptions, type UseImageUploadResult, blobFromUri, buildUploadRequest, toUploadError, uploadImage, useImageUpload };

package/dist/index.js

@@ -0,0 +1,304 @@
+'use strict';
+
+var react = require('react');
+
+// src/UploadErrorKind.ts
+var UploadErrorKind = /* @__PURE__ */ ((UploadErrorKind2) => {
+  UploadErrorKind2["Validation"] = "validation";
+  UploadErrorKind2["Network"] = "network";
+  UploadErrorKind2["Http"] = "http";
+  UploadErrorKind2["Aborted"] = "aborted";
+  UploadErrorKind2["InvalidResponse"] = "invalid-response";
+  return UploadErrorKind2;
+})(UploadErrorKind || {});
+
+// src/UploadError.ts
+var UploadError = class extends Error {
+  constructor(kind, message, status) {
+    super(message);
+    this.name = "UploadError";
+    this.kind = kind;
+    this.status = status;
+  }
+};
+function toUploadError(cause) {
+  if (cause instanceof UploadError) {
+    return cause;
+  }
+  const message = cause instanceof Error ? cause.message : String(cause);
+  return new UploadError("network" /* Network */, message);
+}
+
+// src/parseUploadedContent.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalid(message) {
+  return new UploadError("invalid-response" /* InvalidResponse */, message);
+}
+function parseUploadedContent(text, requireUrl) {
+  let payload;
+  try {
+    payload = JSON.parse(text);
+  } catch {
+    throw invalid("Upload response was not JSON.");
+  }
+  if (!isRecord(payload) || typeof payload.contentId !== "string" || typeof payload.status !== "string") {
+    throw invalid("Upload response shape was invalid.");
+  }
+  const url = typeof payload.url === "string" && payload.url !== "" ? payload.url : void 0;
+  if (requireUrl && url === void 0) {
+    throw invalid("Upload response did not include a public URL.");
+  }
+  return { contentId: payload.contentId, status: payload.status, url };
+}
+
+// src/transports.ts
+var HTTP_OK_MIN = 200;
+var HTTP_OK_MAX_EXCLUSIVE = 300;
+var PERCENT_COMPLETE = 100;
+function isOk(status) {
+  return status >= HTTP_OK_MIN && status < HTTP_OK_MAX_EXCLUSIVE;
+}
+function httpError(status) {
+  return new UploadError("http" /* Http */, `Upload failed (${String(status)}).`, status);
+}
+function abortedError() {
+  return new UploadError("aborted" /* Aborted */, "Upload was cancelled.");
+}
+async function sendWithFetch(request, fetchImpl) {
+  let response;
+  try {
+    response = await fetchImpl(request.url, {
+      method: "POST",
+      credentials: request.credentials,
+      headers: request.headers,
+      body: request.form,
+      signal: request.signal
+    });
+  } catch (cause) {
+    if (request.signal?.aborted === true) {
+      throw abortedError();
+    }
+    const detail = cause instanceof Error ? cause.message : String(cause);
+    throw new UploadError("network" /* Network */, detail);
+  }
+  if (!isOk(response.status)) {
+    throw httpError(response.status);
+  }
+  return response.text();
+}
+function reportProgress(event, onProgress) {
+  if (event.lengthComputable && event.total > 0) {
+    onProgress(Math.round(event.loaded / event.total * PERCENT_COMPLETE));
+  }
+}
+function sendWithXhr(request, createXhr, onProgress) {
+  return new Promise((resolve, reject) => {
+    const { signal } = request;
+    if (signal?.aborted === true) {
+      reject(abortedError());
+      return;
+    }
+    const xhr = createXhr();
+    xhr.upload.addEventListener("progress", (event) => reportProgress(event, onProgress));
+    xhr.addEventListener("load", () => {
+      if (isOk(xhr.status)) {
+        resolve(xhr.responseText);
+      } else {
+        reject(httpError(xhr.status));
+      }
+    });
+    xhr.addEventListener("error", () => reject(new UploadError("network" /* Network */, "Upload failed (network error).")));
+    xhr.addEventListener("abort", () => reject(abortedError()));
+    signal?.addEventListener("abort", () => xhr.abort(), { once: true });
+    xhr.open("POST", request.url);
+    xhr.withCredentials = request.credentials === "include";
+    Object.entries(request.headers).forEach(([name, value]) => xhr.setRequestHeader(name, value));
+    xhr.send(request.form);
+  });
+}
+
+// src/uploadImage.ts
+var DEFAULT_CSRF_HEADER = { name: "X-BFF-Csrf", value: "1" };
+var DEFAULT_CATEGORY = "Image";
+var DEFAULT_FILE_NAME = "upload";
+var FILE_FIELD = "File";
+var CATEGORY_FIELD = "Category";
+var IS_PUBLIC_FIELD = "IsPublic";
+function validationError(message) {
+  return new UploadError("validation" /* Validation */, message);
+}
+function validate(file, options) {
+  if (file.size === 0) {
+    throw validationError("File is empty.");
+  }
+  if (options.maxBytes !== void 0 && file.size > options.maxBytes) {
+    throw validationError(`File is ${String(file.size)} bytes; the limit is ${String(options.maxBytes)}.`);
+  }
+  if (options.allowedTypes !== void 0 && !options.allowedTypes.includes(file.type)) {
+    throw validationError(`File type "${file.type}" is not allowed.`);
+  }
+}
+function resolveFileName(file, explicit) {
+  if (explicit !== void 0 && explicit !== "") {
+    return explicit;
+  }
+  if ("name" in file && typeof file.name === "string" && file.name !== "") {
+    return file.name;
+  }
+  return DEFAULT_FILE_NAME;
+}
+function buildHeaders(csrf) {
+  const headers = { Accept: "application/json" };
+  const header = csrf === void 0 ? DEFAULT_CSRF_HEADER : csrf;
+  if (header !== null) {
+    headers[header.name] = header.value;
+  }
+  return headers;
+}
+function buildUploadRequest(file, options) {
+  const form = new FormData();
+  form.append(FILE_FIELD, file, resolveFileName(file, options.fileName));
+  form.append(CATEGORY_FIELD, options.category ?? DEFAULT_CATEGORY);
+  form.append(IS_PUBLIC_FIELD, String(options.isPublic ?? true));
+  return {
+    url: options.endpoint,
+    headers: buildHeaders(options.csrf),
+    form,
+    credentials: options.credentials ?? "include",
+    signal: options.signal
+  };
+}
+function resolveXhrFactory(options) {
+  if (options.fetchImpl !== void 0) {
+    return void 0;
+  }
+  if (options.xhrFactory !== void 0) {
+    return options.xhrFactory;
+  }
+  return typeof XMLHttpRequest === "undefined" ? void 0 : () => new XMLHttpRequest();
+}
+async function send(request, options) {
+  const { onProgress } = options;
+  const createXhr = onProgress === void 0 ? void 0 : resolveXhrFactory(options);
+  if (createXhr !== void 0 && onProgress !== void 0) {
+    return sendWithXhr(request, createXhr, onProgress);
+  }
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
+  return sendWithFetch(request, fetchImpl);
+}
+async function uploadImage(file, options) {
+  validate(file, options);
+  const request = buildUploadRequest(file, options);
+  const text = await send(request, options);
+  return parseUploadedContent(text, options.requireUrl ?? options.isPublic ?? true);
+}
+
+// src/blobFromUri.ts
+async function blobFromUri(uri, fetchImpl) {
+  const doFetch = fetchImpl ?? globalThis.fetch.bind(globalThis);
+  let response;
+  try {
+    response = await doFetch(uri);
+  } catch (cause) {
+    const detail = cause instanceof Error ? cause.message : String(cause);
+    throw new UploadError("validation" /* Validation */, `Could not read file: ${detail}`);
+  }
+  if (!response.ok) {
+    throw new UploadError("validation" /* Validation */, `Could not read file (${String(response.status)}).`);
+  }
+  return response.blob();
+}
+
+// src/UploadStatus.ts
+var UploadStatus = /* @__PURE__ */ ((UploadStatus2) => {
+  UploadStatus2["Idle"] = "idle";
+  UploadStatus2["Uploading"] = "uploading";
+  UploadStatus2["Error"] = "error";
+  UploadStatus2["Done"] = "done";
+  return UploadStatus2;
+})(UploadStatus || {});
+
+// src/useImageUpload.ts
+var IDLE = { status: "idle" /* Idle */, progress: 0, error: null, result: null };
+var UPLOADING = { status: "uploading" /* Uploading */, progress: 0, error: null, result: null };
+function reducer(state, action) {
+  switch (action.type) {
+    case "start":
+      return UPLOADING;
+    case "progress":
+      return { ...state, progress: action.percent };
+    case "done":
+      return { status: "done" /* Done */, progress: PERCENT_COMPLETE, error: null, result: action.result };
+    case "fail":
+      return { ...state, status: "error" /* Error */, error: action.error };
+    default:
+      return IDLE;
+  }
+}
+function useImageUpload(options) {
+  const [state, dispatch] = react.useReducer(reducer, IDLE);
+  const optionsRef = react.useRef(options);
+  optionsRef.current = options;
+  const controllerRef = react.useRef(null);
+  const requestIdRef = react.useRef(0);
+  const abortInFlight = react.useCallback(() => {
+    controllerRef.current?.abort();
+    controllerRef.current = null;
+    requestIdRef.current += 1;
+  }, []);
+  react.useEffect(() => abortInFlight, [abortInFlight]);
+  const upload = react.useCallback(async (file, fileName) => {
+    abortInFlight();
+    const controller = new AbortController();
+    controllerRef.current = controller;
+    const requestId = requestIdRef.current;
+    const isCurrent = () => requestId === requestIdRef.current;
+    const { onSuccess, onError, ...uploadOptions } = optionsRef.current;
+    dispatch({ type: "start" });
+    try {
+      const result = await uploadImage(file, {
+        ...uploadOptions,
+        fileName: fileName ?? uploadOptions.fileName,
+        signal: controller.signal,
+        onProgress: (percent) => {
+          if (isCurrent()) {
+            dispatch({ type: "progress", percent });
+          }
+        }
+      });
+      if (!isCurrent()) {
+        return null;
+      }
+      dispatch({ type: "done", result });
+      onSuccess?.(result);
+      return result;
+    } catch (cause) {
+      if (!isCurrent()) {
+        return null;
+      }
+      const error = toUploadError(cause);
+      dispatch({ type: "fail", error });
+      onError?.(error);
+      return null;
+    }
+  }, [abortInFlight]);
+  const reset = react.useCallback(() => {
+    abortInFlight();
+    dispatch({ type: "reset" });
+  }, [abortInFlight]);
+  return { ...state, upload, reset };
+}
+
+exports.DEFAULT_CSRF_HEADER = DEFAULT_CSRF_HEADER;
+exports.UploadError = UploadError;
+exports.UploadErrorKind = UploadErrorKind;
+exports.UploadStatus = UploadStatus;
+exports.blobFromUri = blobFromUri;
+exports.buildUploadRequest = buildUploadRequest;
+exports.toUploadError = toUploadError;
+exports.uploadImage = uploadImage;
+exports.useImageUpload = useImageUpload;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/UploadErrorKind.ts","../src/UploadError.ts","../src/parseUploadedContent.ts","../src/transports.ts","../src/uploadImage.ts","../src/blobFromUri.ts","../src/UploadStatus.ts","../src/useImageUpload.ts"],"names":["UploadErrorKind","UploadStatus","useReducer","useRef","useCallback","useEffect"],"mappings":"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","file":"index.js","sourcesContent":["/** Why an upload failed. Consumers map this to translated copy; `message` is developer-facing only. */\nexport const enum UploadErrorKind {\n  /** Rejected client-side before any request: empty file, too large, disallowed MIME type. */\n  Validation = 'validation',\n  /** The request never produced an HTTP response (offline, DNS, CORS). */\n  Network = 'network',\n  /** The server answered outside 2xx; `status` carries the code. */\n  Http = 'http',\n  /** The caller aborted (AbortSignal / hook reset). */\n  Aborted = 'aborted',\n  /** 2xx, but the body was not `{ contentId, status, url? }` (or lacked a required url). */\n  InvalidResponse = 'invalid-response',\n}\n","import { UploadErrorKind } from './UploadErrorKind';\n\n/** The single error type thrown by `uploadImage` and surfaced by `useImageUpload`. */\nexport class UploadError extends Error {\n  readonly kind: UploadErrorKind;\n  /** HTTP status for `UploadErrorKind.Http`; undefined otherwise. */\n  readonly status: number | undefined;\n\n  constructor(kind: UploadErrorKind, message: string, status?: number) {\n    super(message);\n    this.name = 'UploadError';\n    this.kind = kind;\n    this.status = status;\n  }\n}\n\n/** Normalise anything thrown into an `UploadError` (unknown throws become `Network`). */\nexport function toUploadError(cause: unknown): UploadError {\n  if (cause instanceof UploadError) {\n    return cause;\n  }\n  const message = cause instanceof Error ? cause.message : String(cause);\n  return new UploadError(UploadErrorKind.Network, message);\n}\n","import { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\nimport type { UploadedContent } from './types';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction invalid(message: string): UploadError {\n  return new UploadError(UploadErrorKind.InvalidResponse, message);\n}\n\n/** Parse the upload endpoint's JSON body into `UploadedContent`, or throw `InvalidResponse`. */\nexport function parseUploadedContent(text: string, requireUrl: boolean): UploadedContent {\n  let payload: unknown;\n  try {\n    payload = JSON.parse(text);\n  } catch {\n    throw invalid('Upload response was not JSON.');\n  }\n  if (!isRecord(payload) || typeof payload.contentId !== 'string' || typeof payload.status !== 'string') {\n    throw invalid('Upload response shape was invalid.');\n  }\n  const url = typeof payload.url === 'string' && payload.url !== '' ? payload.url : undefined;\n  if (requireUrl && url === undefined) {\n    throw invalid('Upload response did not include a public URL.');\n  }\n  return { contentId: payload.contentId, status: payload.status, url };\n}\n","import { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\nimport type { ProgressListener } from './types';\n\nconst HTTP_OK_MIN = 200;\nconst HTTP_OK_MAX_EXCLUSIVE = 300;\nexport const PERCENT_COMPLETE = 100;\n\n/** A fully built multipart upload, independent of the transport that sends it. */\nexport interface UploadRequest {\n  url: string;\n  /** Never contains Content-Type: the runtime sets the multipart boundary for a FormData body. */\n  headers: Record<string, string>;\n  form: FormData;\n  credentials: RequestCredentials;\n  signal: AbortSignal | undefined;\n}\n\nfunction isOk(status: number): boolean {\n  return status >= HTTP_OK_MIN && status < HTTP_OK_MAX_EXCLUSIVE;\n}\n\nfunction httpError(status: number): UploadError {\n  return new UploadError(UploadErrorKind.Http, `Upload failed (${String(status)}).`, status);\n}\n\nfunction abortedError(): UploadError {\n  return new UploadError(UploadErrorKind.Aborted, 'Upload was cancelled.');\n}\n\n/** POST with fetch; resolves to the raw response text of a 2xx. */\nexport async function sendWithFetch(request: UploadRequest, fetchImpl: typeof fetch): Promise<string> {\n  let response: Response;\n  try {\n    response = await fetchImpl(request.url, {\n      method: 'POST',\n      credentials: request.credentials,\n      headers: request.headers,\n      body: request.form,\n      signal: request.signal,\n    });\n  } catch (cause) {\n    if (request.signal?.aborted === true) {\n      throw abortedError();\n    }\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new UploadError(UploadErrorKind.Network, detail);\n  }\n  if (!isOk(response.status)) {\n    throw httpError(response.status);\n  }\n  return response.text();\n}\n\nfunction reportProgress(event: ProgressEvent, onProgress: ProgressListener): void {\n  if (event.lengthComputable && event.total > 0) {\n    onProgress(Math.round((event.loaded / event.total) * PERCENT_COMPLETE));\n  }\n}\n\n/** POST with XMLHttpRequest so upload progress can be observed. */\nexport function sendWithXhr(\n  request: UploadRequest,\n  createXhr: () => XMLHttpRequest,\n  onProgress: ProgressListener,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const { signal } = request;\n    if (signal?.aborted === true) {\n      reject(abortedError());\n      return;\n    }\n    const xhr = createXhr();\n    xhr.upload.addEventListener('progress', (event) => reportProgress(event, onProgress));\n    xhr.addEventListener('load', () => {\n      if (isOk(xhr.status)) {\n        resolve(xhr.responseText);\n      } else {\n        reject(httpError(xhr.status));\n      }\n    });\n    xhr.addEventListener('error', () => reject(new UploadError(UploadErrorKind.Network, 'Upload failed (network error).')));\n    xhr.addEventListener('abort', () => reject(abortedError()));\n    signal?.addEventListener('abort', () => xhr.abort(), { once: true });\n    xhr.open('POST', request.url);\n    xhr.withCredentials = request.credentials === 'include';\n    Object.entries(request.headers).forEach(([name, value]) => xhr.setRequestHeader(name, value));\n    xhr.send(request.form);\n  });\n}\n","import { parseUploadedContent } from './parseUploadedContent';\nimport { sendWithFetch, sendWithXhr } from './transports';\nimport { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\nimport type { UploadRequest } from './transports';\nimport type { CsrfHeader, UploadedContent, UploadImageOptions } from './types';\n\n/** The Bff.AspNetCore anti-forgery convention: header presence, any value. */\nexport const DEFAULT_CSRF_HEADER: CsrfHeader = { name: 'X-BFF-Csrf', value: '1' };\n\nconst DEFAULT_CATEGORY = 'Image';\nconst DEFAULT_FILE_NAME = 'upload';\nconst FILE_FIELD = 'File';\nconst CATEGORY_FIELD = 'Category';\nconst IS_PUBLIC_FIELD = 'IsPublic';\n\nfunction validationError(message: string): UploadError {\n  return new UploadError(UploadErrorKind.Validation, message);\n}\n\n/** Client-side checks that must fail before a byte leaves the device. */\nfunction validate(file: Blob, options: UploadImageOptions): void {\n  if (file.size === 0) {\n    throw validationError('File is empty.');\n  }\n  if (options.maxBytes !== undefined && file.size > options.maxBytes) {\n    throw validationError(`File is ${String(file.size)} bytes; the limit is ${String(options.maxBytes)}.`);\n  }\n  if (options.allowedTypes !== undefined && !options.allowedTypes.includes(file.type)) {\n    throw validationError(`File type \"${file.type}\" is not allowed.`);\n  }\n}\n\nfunction resolveFileName(file: Blob, explicit: string | undefined): string {\n  if (explicit !== undefined && explicit !== '') {\n    return explicit;\n  }\n  if ('name' in file && typeof file.name === 'string' && file.name !== '') {\n    return file.name;\n  }\n  return DEFAULT_FILE_NAME;\n}\n\nfunction buildHeaders(csrf: CsrfHeader | null | undefined): Record<string, string> {\n  const headers: Record<string, string> = { Accept: 'application/json' };\n  const header = csrf === undefined ? DEFAULT_CSRF_HEADER : csrf;\n  if (header !== null) {\n    headers[header.name] = header.value;\n  }\n  return headers;\n}\n\n/** Build the transport-independent request. Exported so consumers can pin the write shape. */\nexport function buildUploadRequest(file: Blob, options: UploadImageOptions): UploadRequest {\n  const form = new FormData();\n  form.append(FILE_FIELD, file, resolveFileName(file, options.fileName));\n  form.append(CATEGORY_FIELD, options.category ?? DEFAULT_CATEGORY);\n  form.append(IS_PUBLIC_FIELD, String(options.isPublic ?? true));\n  return {\n    url: options.endpoint,\n    headers: buildHeaders(options.csrf),\n    form,\n    credentials: options.credentials ?? 'include',\n    signal: options.signal,\n  };\n}\n\nfunction resolveXhrFactory(options: UploadImageOptions): (() => XMLHttpRequest) | undefined {\n  if (options.fetchImpl !== undefined) {\n    return undefined;\n  }\n  if (options.xhrFactory !== undefined) {\n    return options.xhrFactory;\n  }\n  return typeof XMLHttpRequest === 'undefined' ? undefined : (): XMLHttpRequest => new XMLHttpRequest();\n}\n\nasync function send(request: UploadRequest, options: UploadImageOptions): Promise<string> {\n  const { onProgress } = options;\n  const createXhr = onProgress === undefined ? undefined : resolveXhrFactory(options);\n  if (createXhr !== undefined && onProgress !== undefined) {\n    return sendWithXhr(request, createXhr, onProgress);\n  }\n  const fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);\n  return sendWithFetch(request, fetchImpl);\n}\n\n/**\n * Upload one image as multipart/form-data (`File`, `Category`, `IsPublic`) to a\n * consumer-supplied endpoint and return the parsed `{ contentId, status, url }`.\n *\n * Never sets Content-Type: the runtime adds the multipart boundary, and a JSON content type\n * on a FormData body is a 415 (see `@dloizides/bff-web-client` writeContentTypeGuard).\n *\n * @throws {UploadError} for every failure; switch on `error.kind`.\n */\nexport async function uploadImage(file: Blob, options: UploadImageOptions): Promise<UploadedContent> {\n  validate(file, options);\n  const request = buildUploadRequest(file, options);\n  const text = await send(request, options);\n  return parseUploadedContent(text, options.requireUrl ?? options.isPublic ?? true);\n}\n","import { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\n/**\n * Read a local URI (`blob:`, `data:`, or an RN image-picker `file:` URI) into a Blob so it\n * can be passed to `uploadImage`.\n *\n * @throws {UploadError} `Validation` when the URI cannot be read.\n */\nexport async function blobFromUri(uri: string, fetchImpl?: typeof fetch): Promise<Blob> {\n  const doFetch = fetchImpl ?? globalThis.fetch.bind(globalThis);\n  let response: Response;\n  try {\n    response = await doFetch(uri);\n  } catch (cause) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new UploadError(UploadErrorKind.Validation, `Could not read file: ${detail}`);\n  }\n  if (!response.ok) {\n    throw new UploadError(UploadErrorKind.Validation, `Could not read file (${String(response.status)}).`);\n  }\n  return response.blob();\n}\n","/** Lifecycle of a single `useImageUpload` slot. */\nexport const enum UploadStatus {\n  Idle = 'idle',\n  Uploading = 'uploading',\n  Error = 'error',\n  Done = 'done',\n}\n","import { useCallback, useEffect, useReducer, useRef } from 'react';\n\nimport { PERCENT_COMPLETE } from './transports';\nimport { toUploadError } from './UploadError';\nimport { uploadImage } from './uploadImage';\nimport { UploadStatus } from './UploadStatus';\n\nimport type { UploadedContent, UploadImageOptions } from './types';\nimport type { UploadError } from './UploadError';\n\n/** Options for `useImageUpload`: everything `uploadImage` takes except the per-call wiring. */\nexport interface UseImageUploadOptions extends Omit<UploadImageOptions, 'signal' | 'onProgress'> {\n  onSuccess?: (content: UploadedContent) => void;\n  onError?: (error: UploadError) => void;\n}\n\nexport interface ImageUploadState {\n  status: UploadStatus;\n  /** 0-100. Stays 0 while uploading when the transport cannot report progress (fetch). */\n  progress: number;\n  error: UploadError | null;\n  result: UploadedContent | null;\n}\n\nexport interface UseImageUploadResult extends ImageUploadState {\n  /** Start an upload (aborting any in-flight one). Resolves to the content, or null on error/abort. */\n  upload: (file: Blob, fileName?: string) => Promise<UploadedContent | null>;\n  /** Abort any in-flight upload and return to idle. */\n  reset: () => void;\n}\n\nconst IDLE: ImageUploadState = { status: UploadStatus.Idle, progress: 0, error: null, result: null };\nconst UPLOADING: ImageUploadState = { status: UploadStatus.Uploading, progress: 0, error: null, result: null };\n\ntype Action =\n  | { type: 'start' }\n  | { type: 'progress'; percent: number }\n  | { type: 'done'; result: UploadedContent }\n  | { type: 'fail'; error: UploadError }\n  | { type: 'reset' };\n\nfunction reducer(state: ImageUploadState, action: Action): ImageUploadState {\n  switch (action.type) {\n    case 'start':\n      return UPLOADING;\n    case 'progress':\n      return { ...state, progress: action.percent };\n    case 'done':\n      return { status: UploadStatus.Done, progress: PERCENT_COMPLETE, error: null, result: action.result };\n    case 'fail':\n      return { ...state, status: UploadStatus.Error, error: action.error };\n    default:\n      return IDLE;\n  }\n}\n\n/**\n * One image-upload slot: idle -> uploading -> done | error. Progress is reported when the\n * XMLHttpRequest transport is available (browser, React Native) and no `fetchImpl` is set.\n * A newer `upload()` or `reset()` supersedes the previous request; its late result is dropped.\n * Unmount aborts the in-flight request.\n */\nexport function useImageUpload(options: UseImageUploadOptions): UseImageUploadResult {\n  const [state, dispatch] = useReducer(reducer, IDLE);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const controllerRef = useRef<AbortController | null>(null);\n  const requestIdRef = useRef(0);\n\n  const abortInFlight = useCallback((): void => {\n    controllerRef.current?.abort();\n    controllerRef.current = null;\n    requestIdRef.current += 1;\n  }, []);\n\n  useEffect(() => abortInFlight, [abortInFlight]);\n\n  const upload = useCallback(async (file: Blob, fileName?: string): Promise<UploadedContent | null> => {\n    abortInFlight();\n    const controller = new AbortController();\n    controllerRef.current = controller;\n    const requestId = requestIdRef.current;\n    const isCurrent = (): boolean => requestId === requestIdRef.current;\n    const { onSuccess, onError, ...uploadOptions } = optionsRef.current;\n    dispatch({ type: 'start' });\n    try {\n      const result = await uploadImage(file, {\n        ...uploadOptions,\n        fileName: fileName ?? uploadOptions.fileName,\n        signal: controller.signal,\n        onProgress: (percent) => {\n          if (isCurrent()) {\n            dispatch({ type: 'progress', percent });\n          }\n        },\n      });\n      if (!isCurrent()) {\n        return null;\n      }\n      dispatch({ type: 'done', result });\n      onSuccess?.(result);\n      return result;\n    } catch (cause) {\n      if (!isCurrent()) {\n        return null;\n      }\n      const error = toUploadError(cause);\n      dispatch({ type: 'fail', error });\n      onError?.(error);\n      return null;\n    }\n  }, [abortInFlight]);\n\n  const reset = useCallback((): void => {\n    abortInFlight();\n    dispatch({ type: 'reset' });\n  }, [abortInFlight]);\n\n  return { ...state, upload, reset };\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,294 @@
+import { useReducer, useRef, useCallback, useEffect } from 'react';
+
+// src/UploadErrorKind.ts
+var UploadErrorKind = /* @__PURE__ */ ((UploadErrorKind2) => {
+  UploadErrorKind2["Validation"] = "validation";
+  UploadErrorKind2["Network"] = "network";
+  UploadErrorKind2["Http"] = "http";
+  UploadErrorKind2["Aborted"] = "aborted";
+  UploadErrorKind2["InvalidResponse"] = "invalid-response";
+  return UploadErrorKind2;
+})(UploadErrorKind || {});
+
+// src/UploadError.ts
+var UploadError = class extends Error {
+  constructor(kind, message, status) {
+    super(message);
+    this.name = "UploadError";
+    this.kind = kind;
+    this.status = status;
+  }
+};
+function toUploadError(cause) {
+  if (cause instanceof UploadError) {
+    return cause;
+  }
+  const message = cause instanceof Error ? cause.message : String(cause);
+  return new UploadError("network" /* Network */, message);
+}
+
+// src/parseUploadedContent.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalid(message) {
+  return new UploadError("invalid-response" /* InvalidResponse */, message);
+}
+function parseUploadedContent(text, requireUrl) {
+  let payload;
+  try {
+    payload = JSON.parse(text);
+  } catch {
+    throw invalid("Upload response was not JSON.");
+  }
+  if (!isRecord(payload) || typeof payload.contentId !== "string" || typeof payload.status !== "string") {
+    throw invalid("Upload response shape was invalid.");
+  }
+  const url = typeof payload.url === "string" && payload.url !== "" ? payload.url : void 0;
+  if (requireUrl && url === void 0) {
+    throw invalid("Upload response did not include a public URL.");
+  }
+  return { contentId: payload.contentId, status: payload.status, url };
+}
+
+// src/transports.ts
+var HTTP_OK_MIN = 200;
+var HTTP_OK_MAX_EXCLUSIVE = 300;
+var PERCENT_COMPLETE = 100;
+function isOk(status) {
+  return status >= HTTP_OK_MIN && status < HTTP_OK_MAX_EXCLUSIVE;
+}
+function httpError(status) {
+  return new UploadError("http" /* Http */, `Upload failed (${String(status)}).`, status);
+}
+function abortedError() {
+  return new UploadError("aborted" /* Aborted */, "Upload was cancelled.");
+}
+async function sendWithFetch(request, fetchImpl) {
+  let response;
+  try {
+    response = await fetchImpl(request.url, {
+      method: "POST",
+      credentials: request.credentials,
+      headers: request.headers,
+      body: request.form,
+      signal: request.signal
+    });
+  } catch (cause) {
+    if (request.signal?.aborted === true) {
+      throw abortedError();
+    }
+    const detail = cause instanceof Error ? cause.message : String(cause);
+    throw new UploadError("network" /* Network */, detail);
+  }
+  if (!isOk(response.status)) {
+    throw httpError(response.status);
+  }
+  return response.text();
+}
+function reportProgress(event, onProgress) {
+  if (event.lengthComputable && event.total > 0) {
+    onProgress(Math.round(event.loaded / event.total * PERCENT_COMPLETE));
+  }
+}
+function sendWithXhr(request, createXhr, onProgress) {
+  return new Promise((resolve, reject) => {
+    const { signal } = request;
+    if (signal?.aborted === true) {
+      reject(abortedError());
+      return;
+    }
+    const xhr = createXhr();
+    xhr.upload.addEventListener("progress", (event) => reportProgress(event, onProgress));
+    xhr.addEventListener("load", () => {
+      if (isOk(xhr.status)) {
+        resolve(xhr.responseText);
+      } else {
+        reject(httpError(xhr.status));
+      }
+    });
+    xhr.addEventListener("error", () => reject(new UploadError("network" /* Network */, "Upload failed (network error).")));
+    xhr.addEventListener("abort", () => reject(abortedError()));
+    signal?.addEventListener("abort", () => xhr.abort(), { once: true });
+    xhr.open("POST", request.url);
+    xhr.withCredentials = request.credentials === "include";
+    Object.entries(request.headers).forEach(([name, value]) => xhr.setRequestHeader(name, value));
+    xhr.send(request.form);
+  });
+}
+
+// src/uploadImage.ts
+var DEFAULT_CSRF_HEADER = { name: "X-BFF-Csrf", value: "1" };
+var DEFAULT_CATEGORY = "Image";
+var DEFAULT_FILE_NAME = "upload";
+var FILE_FIELD = "File";
+var CATEGORY_FIELD = "Category";
+var IS_PUBLIC_FIELD = "IsPublic";
+function validationError(message) {
+  return new UploadError("validation" /* Validation */, message);
+}
+function validate(file, options) {
+  if (file.size === 0) {
+    throw validationError("File is empty.");
+  }
+  if (options.maxBytes !== void 0 && file.size > options.maxBytes) {
+    throw validationError(`File is ${String(file.size)} bytes; the limit is ${String(options.maxBytes)}.`);
+  }
+  if (options.allowedTypes !== void 0 && !options.allowedTypes.includes(file.type)) {
+    throw validationError(`File type "${file.type}" is not allowed.`);
+  }
+}
+function resolveFileName(file, explicit) {
+  if (explicit !== void 0 && explicit !== "") {
+    return explicit;
+  }
+  if ("name" in file && typeof file.name === "string" && file.name !== "") {
+    return file.name;
+  }
+  return DEFAULT_FILE_NAME;
+}
+function buildHeaders(csrf) {
+  const headers = { Accept: "application/json" };
+  const header = csrf === void 0 ? DEFAULT_CSRF_HEADER : csrf;
+  if (header !== null) {
+    headers[header.name] = header.value;
+  }
+  return headers;
+}
+function buildUploadRequest(file, options) {
+  const form = new FormData();
+  form.append(FILE_FIELD, file, resolveFileName(file, options.fileName));
+  form.append(CATEGORY_FIELD, options.category ?? DEFAULT_CATEGORY);
+  form.append(IS_PUBLIC_FIELD, String(options.isPublic ?? true));
+  return {
+    url: options.endpoint,
+    headers: buildHeaders(options.csrf),
+    form,
+    credentials: options.credentials ?? "include",
+    signal: options.signal
+  };
+}
+function resolveXhrFactory(options) {
+  if (options.fetchImpl !== void 0) {
+    return void 0;
+  }
+  if (options.xhrFactory !== void 0) {
+    return options.xhrFactory;
+  }
+  return typeof XMLHttpRequest === "undefined" ? void 0 : () => new XMLHttpRequest();
+}
+async function send(request, options) {
+  const { onProgress } = options;
+  const createXhr = onProgress === void 0 ? void 0 : resolveXhrFactory(options);
+  if (createXhr !== void 0 && onProgress !== void 0) {
+    return sendWithXhr(request, createXhr, onProgress);
+  }
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
+  return sendWithFetch(request, fetchImpl);
+}
+async function uploadImage(file, options) {
+  validate(file, options);
+  const request = buildUploadRequest(file, options);
+  const text = await send(request, options);
+  return parseUploadedContent(text, options.requireUrl ?? options.isPublic ?? true);
+}
+
+// src/blobFromUri.ts
+async function blobFromUri(uri, fetchImpl) {
+  const doFetch = fetchImpl ?? globalThis.fetch.bind(globalThis);
+  let response;
+  try {
+    response = await doFetch(uri);
+  } catch (cause) {
+    const detail = cause instanceof Error ? cause.message : String(cause);
+    throw new UploadError("validation" /* Validation */, `Could not read file: ${detail}`);
+  }
+  if (!response.ok) {
+    throw new UploadError("validation" /* Validation */, `Could not read file (${String(response.status)}).`);
+  }
+  return response.blob();
+}
+
+// src/UploadStatus.ts
+var UploadStatus = /* @__PURE__ */ ((UploadStatus2) => {
+  UploadStatus2["Idle"] = "idle";
+  UploadStatus2["Uploading"] = "uploading";
+  UploadStatus2["Error"] = "error";
+  UploadStatus2["Done"] = "done";
+  return UploadStatus2;
+})(UploadStatus || {});
+
+// src/useImageUpload.ts
+var IDLE = { status: "idle" /* Idle */, progress: 0, error: null, result: null };
+var UPLOADING = { status: "uploading" /* Uploading */, progress: 0, error: null, result: null };
+function reducer(state, action) {
+  switch (action.type) {
+    case "start":
+      return UPLOADING;
+    case "progress":
+      return { ...state, progress: action.percent };
+    case "done":
+      return { status: "done" /* Done */, progress: PERCENT_COMPLETE, error: null, result: action.result };
+    case "fail":
+      return { ...state, status: "error" /* Error */, error: action.error };
+    default:
+      return IDLE;
+  }
+}
+function useImageUpload(options) {
+  const [state, dispatch] = useReducer(reducer, IDLE);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const controllerRef = useRef(null);
+  const requestIdRef = useRef(0);
+  const abortInFlight = useCallback(() => {
+    controllerRef.current?.abort();
+    controllerRef.current = null;
+    requestIdRef.current += 1;
+  }, []);
+  useEffect(() => abortInFlight, [abortInFlight]);
+  const upload = useCallback(async (file, fileName) => {
+    abortInFlight();
+    const controller = new AbortController();
+    controllerRef.current = controller;
+    const requestId = requestIdRef.current;
+    const isCurrent = () => requestId === requestIdRef.current;
+    const { onSuccess, onError, ...uploadOptions } = optionsRef.current;
+    dispatch({ type: "start" });
+    try {
+      const result = await uploadImage(file, {
+        ...uploadOptions,
+        fileName: fileName ?? uploadOptions.fileName,
+        signal: controller.signal,
+        onProgress: (percent) => {
+          if (isCurrent()) {
+            dispatch({ type: "progress", percent });
+          }
+        }
+      });
+      if (!isCurrent()) {
+        return null;
+      }
+      dispatch({ type: "done", result });
+      onSuccess?.(result);
+      return result;
+    } catch (cause) {
+      if (!isCurrent()) {
+        return null;
+      }
+      const error = toUploadError(cause);
+      dispatch({ type: "fail", error });
+      onError?.(error);
+      return null;
+    }
+  }, [abortInFlight]);
+  const reset = useCallback(() => {
+    abortInFlight();
+    dispatch({ type: "reset" });
+  }, [abortInFlight]);
+  return { ...state, upload, reset };
+}
+
+export { DEFAULT_CSRF_HEADER, UploadError, UploadErrorKind, UploadStatus, blobFromUri, buildUploadRequest, toUploadError, uploadImage, useImageUpload };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/UploadErrorKind.ts","../src/UploadError.ts","../src/parseUploadedContent.ts","../src/transports.ts","../src/uploadImage.ts","../src/blobFromUri.ts","../src/UploadStatus.ts","../src/useImageUpload.ts"],"names":["UploadErrorKind","UploadStatus"],"mappings":"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","file":"index.mjs","sourcesContent":["/** Why an upload failed. Consumers map this to translated copy; `message` is developer-facing only. */\nexport const enum UploadErrorKind {\n  /** Rejected client-side before any request: empty file, too large, disallowed MIME type. */\n  Validation = 'validation',\n  /** The request never produced an HTTP response (offline, DNS, CORS). */\n  Network = 'network',\n  /** The server answered outside 2xx; `status` carries the code. */\n  Http = 'http',\n  /** The caller aborted (AbortSignal / hook reset). */\n  Aborted = 'aborted',\n  /** 2xx, but the body was not `{ contentId, status, url? }` (or lacked a required url). */\n  InvalidResponse = 'invalid-response',\n}\n","import { UploadErrorKind } from './UploadErrorKind';\n\n/** The single error type thrown by `uploadImage` and surfaced by `useImageUpload`. */\nexport class UploadError extends Error {\n  readonly kind: UploadErrorKind;\n  /** HTTP status for `UploadErrorKind.Http`; undefined otherwise. */\n  readonly status: number | undefined;\n\n  constructor(kind: UploadErrorKind, message: string, status?: number) {\n    super(message);\n    this.name = 'UploadError';\n    this.kind = kind;\n    this.status = status;\n  }\n}\n\n/** Normalise anything thrown into an `UploadError` (unknown throws become `Network`). */\nexport function toUploadError(cause: unknown): UploadError {\n  if (cause instanceof UploadError) {\n    return cause;\n  }\n  const message = cause instanceof Error ? cause.message : String(cause);\n  return new UploadError(UploadErrorKind.Network, message);\n}\n","import { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\nimport type { UploadedContent } from './types';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction invalid(message: string): UploadError {\n  return new UploadError(UploadErrorKind.InvalidResponse, message);\n}\n\n/** Parse the upload endpoint's JSON body into `UploadedContent`, or throw `InvalidResponse`. */\nexport function parseUploadedContent(text: string, requireUrl: boolean): UploadedContent {\n  let payload: unknown;\n  try {\n    payload = JSON.parse(text);\n  } catch {\n    throw invalid('Upload response was not JSON.');\n  }\n  if (!isRecord(payload) || typeof payload.contentId !== 'string' || typeof payload.status !== 'string') {\n    throw invalid('Upload response shape was invalid.');\n  }\n  const url = typeof payload.url === 'string' && payload.url !== '' ? payload.url : undefined;\n  if (requireUrl && url === undefined) {\n    throw invalid('Upload response did not include a public URL.');\n  }\n  return { contentId: payload.contentId, status: payload.status, url };\n}\n","import { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\nimport type { ProgressListener } from './types';\n\nconst HTTP_OK_MIN = 200;\nconst HTTP_OK_MAX_EXCLUSIVE = 300;\nexport const PERCENT_COMPLETE = 100;\n\n/** A fully built multipart upload, independent of the transport that sends it. */\nexport interface UploadRequest {\n  url: string;\n  /** Never contains Content-Type: the runtime sets the multipart boundary for a FormData body. */\n  headers: Record<string, string>;\n  form: FormData;\n  credentials: RequestCredentials;\n  signal: AbortSignal | undefined;\n}\n\nfunction isOk(status: number): boolean {\n  return status >= HTTP_OK_MIN && status < HTTP_OK_MAX_EXCLUSIVE;\n}\n\nfunction httpError(status: number): UploadError {\n  return new UploadError(UploadErrorKind.Http, `Upload failed (${String(status)}).`, status);\n}\n\nfunction abortedError(): UploadError {\n  return new UploadError(UploadErrorKind.Aborted, 'Upload was cancelled.');\n}\n\n/** POST with fetch; resolves to the raw response text of a 2xx. */\nexport async function sendWithFetch(request: UploadRequest, fetchImpl: typeof fetch): Promise<string> {\n  let response: Response;\n  try {\n    response = await fetchImpl(request.url, {\n      method: 'POST',\n      credentials: request.credentials,\n      headers: request.headers,\n      body: request.form,\n      signal: request.signal,\n    });\n  } catch (cause) {\n    if (request.signal?.aborted === true) {\n      throw abortedError();\n    }\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new UploadError(UploadErrorKind.Network, detail);\n  }\n  if (!isOk(response.status)) {\n    throw httpError(response.status);\n  }\n  return response.text();\n}\n\nfunction reportProgress(event: ProgressEvent, onProgress: ProgressListener): void {\n  if (event.lengthComputable && event.total > 0) {\n    onProgress(Math.round((event.loaded / event.total) * PERCENT_COMPLETE));\n  }\n}\n\n/** POST with XMLHttpRequest so upload progress can be observed. */\nexport function sendWithXhr(\n  request: UploadRequest,\n  createXhr: () => XMLHttpRequest,\n  onProgress: ProgressListener,\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const { signal } = request;\n    if (signal?.aborted === true) {\n      reject(abortedError());\n      return;\n    }\n    const xhr = createXhr();\n    xhr.upload.addEventListener('progress', (event) => reportProgress(event, onProgress));\n    xhr.addEventListener('load', () => {\n      if (isOk(xhr.status)) {\n        resolve(xhr.responseText);\n      } else {\n        reject(httpError(xhr.status));\n      }\n    });\n    xhr.addEventListener('error', () => reject(new UploadError(UploadErrorKind.Network, 'Upload failed (network error).')));\n    xhr.addEventListener('abort', () => reject(abortedError()));\n    signal?.addEventListener('abort', () => xhr.abort(), { once: true });\n    xhr.open('POST', request.url);\n    xhr.withCredentials = request.credentials === 'include';\n    Object.entries(request.headers).forEach(([name, value]) => xhr.setRequestHeader(name, value));\n    xhr.send(request.form);\n  });\n}\n","import { parseUploadedContent } from './parseUploadedContent';\nimport { sendWithFetch, sendWithXhr } from './transports';\nimport { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\nimport type { UploadRequest } from './transports';\nimport type { CsrfHeader, UploadedContent, UploadImageOptions } from './types';\n\n/** The Bff.AspNetCore anti-forgery convention: header presence, any value. */\nexport const DEFAULT_CSRF_HEADER: CsrfHeader = { name: 'X-BFF-Csrf', value: '1' };\n\nconst DEFAULT_CATEGORY = 'Image';\nconst DEFAULT_FILE_NAME = 'upload';\nconst FILE_FIELD = 'File';\nconst CATEGORY_FIELD = 'Category';\nconst IS_PUBLIC_FIELD = 'IsPublic';\n\nfunction validationError(message: string): UploadError {\n  return new UploadError(UploadErrorKind.Validation, message);\n}\n\n/** Client-side checks that must fail before a byte leaves the device. */\nfunction validate(file: Blob, options: UploadImageOptions): void {\n  if (file.size === 0) {\n    throw validationError('File is empty.');\n  }\n  if (options.maxBytes !== undefined && file.size > options.maxBytes) {\n    throw validationError(`File is ${String(file.size)} bytes; the limit is ${String(options.maxBytes)}.`);\n  }\n  if (options.allowedTypes !== undefined && !options.allowedTypes.includes(file.type)) {\n    throw validationError(`File type \"${file.type}\" is not allowed.`);\n  }\n}\n\nfunction resolveFileName(file: Blob, explicit: string | undefined): string {\n  if (explicit !== undefined && explicit !== '') {\n    return explicit;\n  }\n  if ('name' in file && typeof file.name === 'string' && file.name !== '') {\n    return file.name;\n  }\n  return DEFAULT_FILE_NAME;\n}\n\nfunction buildHeaders(csrf: CsrfHeader | null | undefined): Record<string, string> {\n  const headers: Record<string, string> = { Accept: 'application/json' };\n  const header = csrf === undefined ? DEFAULT_CSRF_HEADER : csrf;\n  if (header !== null) {\n    headers[header.name] = header.value;\n  }\n  return headers;\n}\n\n/** Build the transport-independent request. Exported so consumers can pin the write shape. */\nexport function buildUploadRequest(file: Blob, options: UploadImageOptions): UploadRequest {\n  const form = new FormData();\n  form.append(FILE_FIELD, file, resolveFileName(file, options.fileName));\n  form.append(CATEGORY_FIELD, options.category ?? DEFAULT_CATEGORY);\n  form.append(IS_PUBLIC_FIELD, String(options.isPublic ?? true));\n  return {\n    url: options.endpoint,\n    headers: buildHeaders(options.csrf),\n    form,\n    credentials: options.credentials ?? 'include',\n    signal: options.signal,\n  };\n}\n\nfunction resolveXhrFactory(options: UploadImageOptions): (() => XMLHttpRequest) | undefined {\n  if (options.fetchImpl !== undefined) {\n    return undefined;\n  }\n  if (options.xhrFactory !== undefined) {\n    return options.xhrFactory;\n  }\n  return typeof XMLHttpRequest === 'undefined' ? undefined : (): XMLHttpRequest => new XMLHttpRequest();\n}\n\nasync function send(request: UploadRequest, options: UploadImageOptions): Promise<string> {\n  const { onProgress } = options;\n  const createXhr = onProgress === undefined ? undefined : resolveXhrFactory(options);\n  if (createXhr !== undefined && onProgress !== undefined) {\n    return sendWithXhr(request, createXhr, onProgress);\n  }\n  const fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);\n  return sendWithFetch(request, fetchImpl);\n}\n\n/**\n * Upload one image as multipart/form-data (`File`, `Category`, `IsPublic`) to a\n * consumer-supplied endpoint and return the parsed `{ contentId, status, url }`.\n *\n * Never sets Content-Type: the runtime adds the multipart boundary, and a JSON content type\n * on a FormData body is a 415 (see `@dloizides/bff-web-client` writeContentTypeGuard).\n *\n * @throws {UploadError} for every failure; switch on `error.kind`.\n */\nexport async function uploadImage(file: Blob, options: UploadImageOptions): Promise<UploadedContent> {\n  validate(file, options);\n  const request = buildUploadRequest(file, options);\n  const text = await send(request, options);\n  return parseUploadedContent(text, options.requireUrl ?? options.isPublic ?? true);\n}\n","import { UploadError } from './UploadError';\nimport { UploadErrorKind } from './UploadErrorKind';\n\n/**\n * Read a local URI (`blob:`, `data:`, or an RN image-picker `file:` URI) into a Blob so it\n * can be passed to `uploadImage`.\n *\n * @throws {UploadError} `Validation` when the URI cannot be read.\n */\nexport async function blobFromUri(uri: string, fetchImpl?: typeof fetch): Promise<Blob> {\n  const doFetch = fetchImpl ?? globalThis.fetch.bind(globalThis);\n  let response: Response;\n  try {\n    response = await doFetch(uri);\n  } catch (cause) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new UploadError(UploadErrorKind.Validation, `Could not read file: ${detail}`);\n  }\n  if (!response.ok) {\n    throw new UploadError(UploadErrorKind.Validation, `Could not read file (${String(response.status)}).`);\n  }\n  return response.blob();\n}\n","/** Lifecycle of a single `useImageUpload` slot. */\nexport const enum UploadStatus {\n  Idle = 'idle',\n  Uploading = 'uploading',\n  Error = 'error',\n  Done = 'done',\n}\n","import { useCallback, useEffect, useReducer, useRef } from 'react';\n\nimport { PERCENT_COMPLETE } from './transports';\nimport { toUploadError } from './UploadError';\nimport { uploadImage } from './uploadImage';\nimport { UploadStatus } from './UploadStatus';\n\nimport type { UploadedContent, UploadImageOptions } from './types';\nimport type { UploadError } from './UploadError';\n\n/** Options for `useImageUpload`: everything `uploadImage` takes except the per-call wiring. */\nexport interface UseImageUploadOptions extends Omit<UploadImageOptions, 'signal' | 'onProgress'> {\n  onSuccess?: (content: UploadedContent) => void;\n  onError?: (error: UploadError) => void;\n}\n\nexport interface ImageUploadState {\n  status: UploadStatus;\n  /** 0-100. Stays 0 while uploading when the transport cannot report progress (fetch). */\n  progress: number;\n  error: UploadError | null;\n  result: UploadedContent | null;\n}\n\nexport interface UseImageUploadResult extends ImageUploadState {\n  /** Start an upload (aborting any in-flight one). Resolves to the content, or null on error/abort. */\n  upload: (file: Blob, fileName?: string) => Promise<UploadedContent | null>;\n  /** Abort any in-flight upload and return to idle. */\n  reset: () => void;\n}\n\nconst IDLE: ImageUploadState = { status: UploadStatus.Idle, progress: 0, error: null, result: null };\nconst UPLOADING: ImageUploadState = { status: UploadStatus.Uploading, progress: 0, error: null, result: null };\n\ntype Action =\n  | { type: 'start' }\n  | { type: 'progress'; percent: number }\n  | { type: 'done'; result: UploadedContent }\n  | { type: 'fail'; error: UploadError }\n  | { type: 'reset' };\n\nfunction reducer(state: ImageUploadState, action: Action): ImageUploadState {\n  switch (action.type) {\n    case 'start':\n      return UPLOADING;\n    case 'progress':\n      return { ...state, progress: action.percent };\n    case 'done':\n      return { status: UploadStatus.Done, progress: PERCENT_COMPLETE, error: null, result: action.result };\n    case 'fail':\n      return { ...state, status: UploadStatus.Error, error: action.error };\n    default:\n      return IDLE;\n  }\n}\n\n/**\n * One image-upload slot: idle -> uploading -> done | error. Progress is reported when the\n * XMLHttpRequest transport is available (browser, React Native) and no `fetchImpl` is set.\n * A newer `upload()` or `reset()` supersedes the previous request; its late result is dropped.\n * Unmount aborts the in-flight request.\n */\nexport function useImageUpload(options: UseImageUploadOptions): UseImageUploadResult {\n  const [state, dispatch] = useReducer(reducer, IDLE);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const controllerRef = useRef<AbortController | null>(null);\n  const requestIdRef = useRef(0);\n\n  const abortInFlight = useCallback((): void => {\n    controllerRef.current?.abort();\n    controllerRef.current = null;\n    requestIdRef.current += 1;\n  }, []);\n\n  useEffect(() => abortInFlight, [abortInFlight]);\n\n  const upload = useCallback(async (file: Blob, fileName?: string): Promise<UploadedContent | null> => {\n    abortInFlight();\n    const controller = new AbortController();\n    controllerRef.current = controller;\n    const requestId = requestIdRef.current;\n    const isCurrent = (): boolean => requestId === requestIdRef.current;\n    const { onSuccess, onError, ...uploadOptions } = optionsRef.current;\n    dispatch({ type: 'start' });\n    try {\n      const result = await uploadImage(file, {\n        ...uploadOptions,\n        fileName: fileName ?? uploadOptions.fileName,\n        signal: controller.signal,\n        onProgress: (percent) => {\n          if (isCurrent()) {\n            dispatch({ type: 'progress', percent });\n          }\n        },\n      });\n      if (!isCurrent()) {\n        return null;\n      }\n      dispatch({ type: 'done', result });\n      onSuccess?.(result);\n      return result;\n    } catch (cause) {\n      if (!isCurrent()) {\n        return null;\n      }\n      const error = toUploadError(cause);\n      dispatch({ type: 'fail', error });\n      onError?.(error);\n      return null;\n    }\n  }, [abortInFlight]);\n\n  const reset = useCallback((): void => {\n    abortInFlight();\n    dispatch({ type: 'reset' });\n  }, [abortInFlight]);\n\n  return { ...state, upload, reset };\n}\n"]}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@dloizides/content-upload",
+  "version": "1.0.0",
+  "description": "Framework-light image upload client for the dloizides.com ContentService (multipart POST through a same-origin BFF proxy, CSRF header, abort, optional progress) plus a useImageUpload React hook with idle/uploading/error/done states. The endpoint is supplied by the consumer.",
+  "keywords": [
+    "upload",
+    "multipart",
+    "content",
+    "bff",
+    "react-hook",
+    "dloizides"
+  ],
+  "author": "dloizides",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openmindednewby/content-upload.git"
+  },
+  "homepage": "https://github.com/openmindednewby/content-upload#readme",
+  "bugs": {
+    "url": "https://github.com/openmindednewby/content-upload/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsup",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "security:audit": "npm audit --audit-level=high",
+    "deps:outdated": "npm outdated || exit 0",
+    "deps:unused": "npx depcheck --ignores \"@types/jest,@types/node,@types/react,rimraf,react-dom,@testing-library/react,@testing-library/dom\"",
+    "deps:licenses": "npx license-checker --onlyAllow \"MIT;Apache-2.0;ISC;BSD-2-Clause;BSD-3-Clause;0BSD;Unlicense;CC0-1.0\"",
+    "prepublishOnly": "npm run clean && npm run build && npm run test"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.19.32",
+    "@types/react": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "eslint-plugin-sonarjs": "^4.0.3",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  }
+}