@dudousxd/nestjs-agent-react 0.18.0 → 0.20.0

package/dist/media.cjs

@@ -0,0 +1,155 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/media/index.ts
+var media_exports = {};
+__export(media_exports, {
+  MediaUploadError: () => MediaUploadError,
+  createMediaUpload: () => createMediaUpload,
+  mediaAttachments: () => mediaAttachments,
+  withMediaUploads: () => withMediaUploads
+});
+module.exports = __toCommonJS(media_exports);
+var import_nestjs_media_client = require("@dudousxd/nestjs-media-client");
+function mediaAttachments(options = {}) {
+  return (file, uploadOptions, connection) => createMediaUpload({
+    ...options,
+    baseUrl: connection.baseUrl,
+    getHeaders: connection.headers,
+    fetch: connection.fetch,
+    ...connection.credentials !== void 0 ? {
+      credentials: connection.credentials
+    } : {}
+  })(file, uploadOptions);
+}
+__name(mediaAttachments, "mediaAttachments");
+var MediaUploadError = class extends Error {
+  static {
+    __name(this, "MediaUploadError");
+  }
+  status;
+  method;
+  path;
+  constructor(status, method, path, statusText) {
+    super(`Attachment upload failed: ${method} ${path} \u2192 ${status} ${statusText}`), this.status = status, this.method = method, this.path = path;
+    this.name = "MediaUploadError";
+  }
+};
+function createMediaUpload(options = {}) {
+  const origin = (options.baseUrl ?? "").replace(/\/$/, "");
+  const base = `${origin}${(options.path ?? "/agent").replace(/\/$/, "")}/attachments/uploads`;
+  const baseFetch = /* @__PURE__ */ __name(() => options.fetch ?? fetch, "baseFetch");
+  const fetchWithCredentials = /* @__PURE__ */ __name((input, init) => baseFetch()(input, {
+    ...init,
+    ...options.credentials !== void 0 ? {
+      credentials: options.credentials
+    } : {}
+  }), "fetchWithCredentials");
+  const headers = /* @__PURE__ */ __name(async () => ({
+    ...options.headers,
+    ...await options.getHeaders?.() ?? {}
+  }), "headers");
+  const discard = /* @__PURE__ */ __name((mediaId) => {
+    void (async () => {
+      await fetchWithCredentials(`${base}/${encodeURIComponent(mediaId)}`, {
+        method: "DELETE",
+        headers: await headers()
+      });
+    })().catch(() => void 0);
+  }, "discard");
+  const call = /* @__PURE__ */ __name(async (method, url, body) => {
+    const response = await fetchWithCredentials(url, {
+      method,
+      headers: {
+        accept: "application/json",
+        ...body !== void 0 ? {
+          "content-type": "application/json"
+        } : {},
+        ...await headers()
+      },
+      ...body !== void 0 ? {
+        body: JSON.stringify(body)
+      } : {}
+    });
+    if (!response.ok) {
+      throw new MediaUploadError(response.status, method, url, response.statusText);
+    }
+    return await response.json();
+  }, "call");
+  return async (file, { signal, onProgress } = {}) => {
+    signal?.throwIfAborted();
+    const begun = await call("POST", base, {
+      filename: file.name,
+      contentType: file.type,
+      size: file.size
+    });
+    const onAbort = /* @__PURE__ */ __name(() => discard(begun.mediaId), "onAbort");
+    signal?.addEventListener("abort", onAbort, {
+      once: true
+    });
+    try {
+      const location = /^https?:\/\//.test(begun.location) ? begun.location : `${origin}${begun.location}`;
+      await (0, import_nestjs_media_client.streamChunks)(location, file, {
+        resume: false,
+        fetchImpl: fetchWithCredentials,
+        getHeaders: headers,
+        ...options.chunkSize !== void 0 ? {
+          chunkSize: options.chunkSize
+        } : {},
+        ...options.retries !== void 0 ? {
+          retries: options.retries
+        } : {},
+        ...signal !== void 0 ? {
+          signal
+        } : {},
+        onProgress: /* @__PURE__ */ __name((sent, total) => onProgress?.(total > 0 ? sent / total : 1), "onProgress")
+      });
+      signal?.throwIfAborted();
+      const attachment = await call("POST", `${base}/${encodeURIComponent(begun.mediaId)}/complete`);
+      onProgress?.(1);
+      return attachment;
+    } catch (error) {
+      if (!signal?.aborted) discard(begun.mediaId);
+      throw error;
+    } finally {
+      signal?.removeEventListener("abort", onAbort);
+    }
+  };
+}
+__name(createMediaUpload, "createMediaUpload");
+function withMediaUploads(backend, options = {}) {
+  const upload = createMediaUpload(options);
+  return new Proxy(backend, {
+    get(target, property) {
+      if (property === "uploadAttachment") return upload;
+      const value = Reflect.get(target, property, target);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  });
+}
+__name(withMediaUploads, "withMediaUploads");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MediaUploadError,
+  createMediaUpload,
+  mediaAttachments,
+  withMediaUploads
+});
+//# sourceMappingURL=media.cjs.map

package/dist/media.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/media/index.ts"],"sourcesContent":["import type { MessageAttachment } from '@dudousxd/nestjs-agent-core';\nimport { streamChunks } from '@dudousxd/nestjs-media-client';\nimport type {\n  AgentBackend,\n  AttachmentUploadStrategy,\n  UploadAttachmentOptions,\n} from '../backend.js';\nimport type { AgentClientOptions } from '../client.js';\n\n/** Tuning for {@link mediaAttachments}; every field optional. */\nexport interface MediaAttachmentsOptions {\n  /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */\n  path?: string;\n  /** Bytes per tus `PATCH`. Default 5 MiB. */\n  chunkSize?: number;\n  /** Attempts per chunk before the upload fails. Default 3. */\n  retries?: number;\n}\n\n/**\n * Resumable attachment uploads through `@dudousxd/nestjs-media`, in one line:\n *\n * ```ts\n * const chat = useAgentChat({ attachments: mediaAttachments() });\n * const files = useAttachments({ backend: chat.backend });\n * ```\n *\n * Reuses the chat client's own connection (base url, headers, credentials), so it needs no\n * configuration. Also takes `new AgentClient({ attachments: mediaAttachments() })`.\n */\nexport function mediaAttachments(options: MediaAttachmentsOptions = {}): AttachmentUploadStrategy {\n  return (file, uploadOptions, connection) =>\n    createMediaUpload({\n      ...options,\n      baseUrl: connection.baseUrl,\n      getHeaders: connection.headers,\n      fetch: connection.fetch,\n      ...(connection.credentials !== undefined ? { credentials: connection.credentials } : {}),\n    })(file, uploadOptions);\n}\n\n/**\n * Where and how {@link createMediaUpload} talks to the server. The connection fields are\n * {@link AgentClientOptions}' — pass the same ones your `AgentClient` gets, so the tus requests\n * carry the same cookies / CSRF header / bearer token as the rest of the chat.\n */\nexport interface MediaUploadOptions extends AgentClientOptions {\n  /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */\n  path?: string;\n  /** Bytes per tus `PATCH`. Default 5 MiB (nestjs-media-client's default). */\n  chunkSize?: number;\n  /** Attempts per chunk before the upload fails. Default 3. */\n  retries?: number;\n}\n\n/** What `useAttachments({ upload })` and `AgentBackend.uploadAttachment` both take. */\nexport type AttachmentUpload = (\n  file: File,\n  options?: UploadAttachmentOptions,\n) => Promise<MessageAttachment>;\n\n/**\n * A non-2xx answer from the agent's upload routes. Carries `status` like `AgentHttpError` does\n * (413 too large, 415 type refused, 404 not yours) — its own class because this subpath is bundled\n * apart from the root entry, where an `instanceof AgentHttpError` would not match a copy.\n */\nexport class MediaUploadError extends Error {\n  constructor(\n    readonly status: number,\n    readonly method: string,\n    readonly path: string,\n    statusText: string,\n  ) {\n    super(`Attachment upload failed: ${method} ${path} → ${status} ${statusText}`);\n    this.name = 'MediaUploadError';\n  }\n}\n\ninterface BeginResponse {\n  mediaId: string;\n  location: string;\n}\n\n/**\n * A resumable `upload` for `useAttachments`, backed by `@dudousxd/nestjs-media` on the server\n * (`AgentMediaAttachmentsModule` from `@dudousxd/nestjs-agent/media`):\n *\n * 1. `POST <path>/attachments/uploads` — the agent validates the file and opens a tus session the\n *    actor owns;\n * 2. the bytes stream to nestjs-media's own tus endpoint in chunks (`streamChunks`), reporting\n *    progress and honouring the abort signal;\n * 3. `POST <path>/attachments/uploads/:mediaId/complete` — the agent confirms the bytes landed and\n *    answers the `MessageAttachment` the turn will reference by `mediaId`.\n *\n * An aborted or failed upload is discarded server-side (`DELETE`), best effort.\n */\nexport function createMediaUpload(options: MediaUploadOptions = {}): AttachmentUpload {\n  const origin = (options.baseUrl ?? '').replace(/\\/$/, '');\n  const base = `${origin}${(options.path ?? '/agent').replace(/\\/$/, '')}/attachments/uploads`;\n  const baseFetch = (): typeof fetch => options.fetch ?? fetch;\n  // Every request — the agent's and media's tus PATCHes — rides the same credentials mode.\n  const fetchWithCredentials: typeof fetch = (input, init) =>\n    baseFetch()(input, {\n      ...init,\n      ...(options.credentials !== undefined ? { credentials: options.credentials } : {}),\n    });\n  const headers = async (): Promise<Record<string, string>> => ({\n    ...options.headers,\n    ...((await options.getHeaders?.()) ?? {}),\n  });\n  const discard = (mediaId: string): void => {\n    void (async () => {\n      await fetchWithCredentials(`${base}/${encodeURIComponent(mediaId)}`, {\n        method: 'DELETE',\n        headers: await headers(),\n      });\n    })().catch(() => undefined);\n  };\n  const call = async <T>(method: string, url: string, body?: unknown): Promise<T> => {\n    const response = await fetchWithCredentials(url, {\n      method,\n      headers: {\n        accept: 'application/json',\n        ...(body !== undefined ? { 'content-type': 'application/json' } : {}),\n        ...(await headers()),\n      },\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n    });\n    if (!response.ok) {\n      throw new MediaUploadError(response.status, method, url, response.statusText);\n    }\n    return (await response.json()) as T;\n  };\n\n  return async (file, { signal, onProgress } = {}) => {\n    signal?.throwIfAborted();\n    const begun = await call<BeginResponse>('POST', base, {\n      filename: file.name,\n      contentType: file.type,\n      size: file.size,\n    });\n    const onAbort = () => discard(begun.mediaId);\n    signal?.addEventListener('abort', onAbort, { once: true });\n    try {\n      const location = /^https?:\\/\\//.test(begun.location)\n        ? begun.location\n        : `${origin}${begun.location}`;\n      await streamChunks(location, file, {\n        resume: false,\n        fetchImpl: fetchWithCredentials,\n        getHeaders: headers,\n        ...(options.chunkSize !== undefined ? { chunkSize: options.chunkSize } : {}),\n        ...(options.retries !== undefined ? { retries: options.retries } : {}),\n        ...(signal !== undefined ? { signal } : {}),\n        onProgress: (sent, total) => onProgress?.(total > 0 ? sent / total : 1),\n      });\n      signal?.throwIfAborted();\n      const attachment = await call<MessageAttachment>(\n        'POST',\n        `${base}/${encodeURIComponent(begun.mediaId)}/complete`,\n      );\n      onProgress?.(1);\n      return attachment;\n    } catch (error) {\n      if (!signal?.aborted) discard(begun.mediaId);\n      throw error;\n    } finally {\n      signal?.removeEventListener('abort', onAbort);\n    }\n  };\n}\n\n/**\n * Plug media uploads in once: the same backend, with `uploadAttachment` replaced by\n * {@link createMediaUpload}. Hand the result to `useAgentChat({ backend })` and\n * `useAttachments({ backend })` and every composer uploads resumably — no per-composer wiring.\n *\n * ```ts\n * const backend = withMediaUploads(new AgentClient(connection), connection);\n * ```\n *\n * Every other member is the original backend's, still bound to it.\n */\nexport function withMediaUploads<B extends AgentBackend>(\n  backend: B,\n  options: MediaUploadOptions = {},\n): B {\n  const upload = createMediaUpload(options);\n  return new Proxy(backend, {\n    get(target, property) {\n      if (property === 'uploadAttachment') return upload;\n      const value: unknown = Reflect.get(target, property, target);\n      return typeof value === 'function' ? value.bind(target) : value;\n    },\n  });\n}\n"],"mappings":"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","names":["mediaAttachments","options","file","uploadOptions","connection","createMediaUpload","baseUrl","getHeaders","headers","fetch","credentials","undefined","MediaUploadError","Error","status","method","path","statusText","name","origin","replace","base","baseFetch","fetchWithCredentials","input","init","discard","mediaId","encodeURIComponent","catch","call","url","body","response","accept","JSON","stringify","ok","json","signal","onProgress","throwIfAborted","begun","filename","contentType","type","size","onAbort","addEventListener","once","location","test","streamChunks","resume","fetchImpl","chunkSize","retries","sent","total","attachment","error","aborted","removeEventListener","withMediaUploads","backend","upload","Proxy","get","target","property","value","Reflect","bind"]}

package/dist/media.d.cts

@@ -0,0 +1,78 @@
+import { MessageAttachment } from '@dudousxd/nestjs-agent-core';
+import { U as UploadAttachmentOptions, d as AgentClientOptions, b as AttachmentUploadStrategy, A as AgentBackend } from './client-0Wd-WPsu.cjs';
+
+/** Tuning for {@link mediaAttachments}; every field optional. */
+interface MediaAttachmentsOptions {
+    /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */
+    path?: string;
+    /** Bytes per tus `PATCH`. Default 5 MiB. */
+    chunkSize?: number;
+    /** Attempts per chunk before the upload fails. Default 3. */
+    retries?: number;
+}
+/**
+ * Resumable attachment uploads through `@dudousxd/nestjs-media`, in one line:
+ *
+ * ```ts
+ * const chat = useAgentChat({ attachments: mediaAttachments() });
+ * const files = useAttachments({ backend: chat.backend });
+ * ```
+ *
+ * Reuses the chat client's own connection (base url, headers, credentials), so it needs no
+ * configuration. Also takes `new AgentClient({ attachments: mediaAttachments() })`.
+ */
+declare function mediaAttachments(options?: MediaAttachmentsOptions): AttachmentUploadStrategy;
+/**
+ * Where and how {@link createMediaUpload} talks to the server. The connection fields are
+ * {@link AgentClientOptions}' — pass the same ones your `AgentClient` gets, so the tus requests
+ * carry the same cookies / CSRF header / bearer token as the rest of the chat.
+ */
+interface MediaUploadOptions extends AgentClientOptions {
+    /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */
+    path?: string;
+    /** Bytes per tus `PATCH`. Default 5 MiB (nestjs-media-client's default). */
+    chunkSize?: number;
+    /** Attempts per chunk before the upload fails. Default 3. */
+    retries?: number;
+}
+/** What `useAttachments({ upload })` and `AgentBackend.uploadAttachment` both take. */
+type AttachmentUpload = (file: File, options?: UploadAttachmentOptions) => Promise<MessageAttachment>;
+/**
+ * A non-2xx answer from the agent's upload routes. Carries `status` like `AgentHttpError` does
+ * (413 too large, 415 type refused, 404 not yours) — its own class because this subpath is bundled
+ * apart from the root entry, where an `instanceof AgentHttpError` would not match a copy.
+ */
+declare class MediaUploadError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    constructor(status: number, method: string, path: string, statusText: string);
+}
+/**
+ * A resumable `upload` for `useAttachments`, backed by `@dudousxd/nestjs-media` on the server
+ * (`AgentMediaAttachmentsModule` from `@dudousxd/nestjs-agent/media`):
+ *
+ * 1. `POST <path>/attachments/uploads` — the agent validates the file and opens a tus session the
+ *    actor owns;
+ * 2. the bytes stream to nestjs-media's own tus endpoint in chunks (`streamChunks`), reporting
+ *    progress and honouring the abort signal;
+ * 3. `POST <path>/attachments/uploads/:mediaId/complete` — the agent confirms the bytes landed and
+ *    answers the `MessageAttachment` the turn will reference by `mediaId`.
+ *
+ * An aborted or failed upload is discarded server-side (`DELETE`), best effort.
+ */
+declare function createMediaUpload(options?: MediaUploadOptions): AttachmentUpload;
+/**
+ * Plug media uploads in once: the same backend, with `uploadAttachment` replaced by
+ * {@link createMediaUpload}. Hand the result to `useAgentChat({ backend })` and
+ * `useAttachments({ backend })` and every composer uploads resumably — no per-composer wiring.
+ *
+ * ```ts
+ * const backend = withMediaUploads(new AgentClient(connection), connection);
+ * ```
+ *
+ * Every other member is the original backend's, still bound to it.
+ */
+declare function withMediaUploads<B extends AgentBackend>(backend: B, options?: MediaUploadOptions): B;
+
+export { type AttachmentUpload, type MediaAttachmentsOptions, MediaUploadError, type MediaUploadOptions, createMediaUpload, mediaAttachments, withMediaUploads };

package/dist/media.d.ts

@@ -0,0 +1,78 @@
+import { MessageAttachment } from '@dudousxd/nestjs-agent-core';
+import { U as UploadAttachmentOptions, d as AgentClientOptions, b as AttachmentUploadStrategy, A as AgentBackend } from './client-0Wd-WPsu.js';
+
+/** Tuning for {@link mediaAttachments}; every field optional. */
+interface MediaAttachmentsOptions {
+    /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */
+    path?: string;
+    /** Bytes per tus `PATCH`. Default 5 MiB. */
+    chunkSize?: number;
+    /** Attempts per chunk before the upload fails. Default 3. */
+    retries?: number;
+}
+/**
+ * Resumable attachment uploads through `@dudousxd/nestjs-media`, in one line:
+ *
+ * ```ts
+ * const chat = useAgentChat({ attachments: mediaAttachments() });
+ * const files = useAttachments({ backend: chat.backend });
+ * ```
+ *
+ * Reuses the chat client's own connection (base url, headers, credentials), so it needs no
+ * configuration. Also takes `new AgentClient({ attachments: mediaAttachments() })`.
+ */
+declare function mediaAttachments(options?: MediaAttachmentsOptions): AttachmentUploadStrategy;
+/**
+ * Where and how {@link createMediaUpload} talks to the server. The connection fields are
+ * {@link AgentClientOptions}' — pass the same ones your `AgentClient` gets, so the tus requests
+ * carry the same cookies / CSRF header / bearer token as the rest of the chat.
+ */
+interface MediaUploadOptions extends AgentClientOptions {
+    /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */
+    path?: string;
+    /** Bytes per tus `PATCH`. Default 5 MiB (nestjs-media-client's default). */
+    chunkSize?: number;
+    /** Attempts per chunk before the upload fails. Default 3. */
+    retries?: number;
+}
+/** What `useAttachments({ upload })` and `AgentBackend.uploadAttachment` both take. */
+type AttachmentUpload = (file: File, options?: UploadAttachmentOptions) => Promise<MessageAttachment>;
+/**
+ * A non-2xx answer from the agent's upload routes. Carries `status` like `AgentHttpError` does
+ * (413 too large, 415 type refused, 404 not yours) — its own class because this subpath is bundled
+ * apart from the root entry, where an `instanceof AgentHttpError` would not match a copy.
+ */
+declare class MediaUploadError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    constructor(status: number, method: string, path: string, statusText: string);
+}
+/**
+ * A resumable `upload` for `useAttachments`, backed by `@dudousxd/nestjs-media` on the server
+ * (`AgentMediaAttachmentsModule` from `@dudousxd/nestjs-agent/media`):
+ *
+ * 1. `POST <path>/attachments/uploads` — the agent validates the file and opens a tus session the
+ *    actor owns;
+ * 2. the bytes stream to nestjs-media's own tus endpoint in chunks (`streamChunks`), reporting
+ *    progress and honouring the abort signal;
+ * 3. `POST <path>/attachments/uploads/:mediaId/complete` — the agent confirms the bytes landed and
+ *    answers the `MessageAttachment` the turn will reference by `mediaId`.
+ *
+ * An aborted or failed upload is discarded server-side (`DELETE`), best effort.
+ */
+declare function createMediaUpload(options?: MediaUploadOptions): AttachmentUpload;
+/**
+ * Plug media uploads in once: the same backend, with `uploadAttachment` replaced by
+ * {@link createMediaUpload}. Hand the result to `useAgentChat({ backend })` and
+ * `useAttachments({ backend })` and every composer uploads resumably — no per-composer wiring.
+ *
+ * ```ts
+ * const backend = withMediaUploads(new AgentClient(connection), connection);
+ * ```
+ *
+ * Every other member is the original backend's, still bound to it.
+ */
+declare function withMediaUploads<B extends AgentBackend>(backend: B, options?: MediaUploadOptions): B;
+
+export { type AttachmentUpload, type MediaAttachmentsOptions, MediaUploadError, type MediaUploadOptions, createMediaUpload, mediaAttachments, withMediaUploads };

package/dist/media.js

@@ -0,0 +1,129 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/media/index.ts
+import { streamChunks } from "@dudousxd/nestjs-media-client";
+function mediaAttachments(options = {}) {
+  return (file, uploadOptions, connection) => createMediaUpload({
+    ...options,
+    baseUrl: connection.baseUrl,
+    getHeaders: connection.headers,
+    fetch: connection.fetch,
+    ...connection.credentials !== void 0 ? {
+      credentials: connection.credentials
+    } : {}
+  })(file, uploadOptions);
+}
+__name(mediaAttachments, "mediaAttachments");
+var MediaUploadError = class extends Error {
+  static {
+    __name(this, "MediaUploadError");
+  }
+  status;
+  method;
+  path;
+  constructor(status, method, path, statusText) {
+    super(`Attachment upload failed: ${method} ${path} \u2192 ${status} ${statusText}`), this.status = status, this.method = method, this.path = path;
+    this.name = "MediaUploadError";
+  }
+};
+function createMediaUpload(options = {}) {
+  const origin = (options.baseUrl ?? "").replace(/\/$/, "");
+  const base = `${origin}${(options.path ?? "/agent").replace(/\/$/, "")}/attachments/uploads`;
+  const baseFetch = /* @__PURE__ */ __name(() => options.fetch ?? fetch, "baseFetch");
+  const fetchWithCredentials = /* @__PURE__ */ __name((input, init) => baseFetch()(input, {
+    ...init,
+    ...options.credentials !== void 0 ? {
+      credentials: options.credentials
+    } : {}
+  }), "fetchWithCredentials");
+  const headers = /* @__PURE__ */ __name(async () => ({
+    ...options.headers,
+    ...await options.getHeaders?.() ?? {}
+  }), "headers");
+  const discard = /* @__PURE__ */ __name((mediaId) => {
+    void (async () => {
+      await fetchWithCredentials(`${base}/${encodeURIComponent(mediaId)}`, {
+        method: "DELETE",
+        headers: await headers()
+      });
+    })().catch(() => void 0);
+  }, "discard");
+  const call = /* @__PURE__ */ __name(async (method, url, body) => {
+    const response = await fetchWithCredentials(url, {
+      method,
+      headers: {
+        accept: "application/json",
+        ...body !== void 0 ? {
+          "content-type": "application/json"
+        } : {},
+        ...await headers()
+      },
+      ...body !== void 0 ? {
+        body: JSON.stringify(body)
+      } : {}
+    });
+    if (!response.ok) {
+      throw new MediaUploadError(response.status, method, url, response.statusText);
+    }
+    return await response.json();
+  }, "call");
+  return async (file, { signal, onProgress } = {}) => {
+    signal?.throwIfAborted();
+    const begun = await call("POST", base, {
+      filename: file.name,
+      contentType: file.type,
+      size: file.size
+    });
+    const onAbort = /* @__PURE__ */ __name(() => discard(begun.mediaId), "onAbort");
+    signal?.addEventListener("abort", onAbort, {
+      once: true
+    });
+    try {
+      const location = /^https?:\/\//.test(begun.location) ? begun.location : `${origin}${begun.location}`;
+      await streamChunks(location, file, {
+        resume: false,
+        fetchImpl: fetchWithCredentials,
+        getHeaders: headers,
+        ...options.chunkSize !== void 0 ? {
+          chunkSize: options.chunkSize
+        } : {},
+        ...options.retries !== void 0 ? {
+          retries: options.retries
+        } : {},
+        ...signal !== void 0 ? {
+          signal
+        } : {},
+        onProgress: /* @__PURE__ */ __name((sent, total) => onProgress?.(total > 0 ? sent / total : 1), "onProgress")
+      });
+      signal?.throwIfAborted();
+      const attachment = await call("POST", `${base}/${encodeURIComponent(begun.mediaId)}/complete`);
+      onProgress?.(1);
+      return attachment;
+    } catch (error) {
+      if (!signal?.aborted) discard(begun.mediaId);
+      throw error;
+    } finally {
+      signal?.removeEventListener("abort", onAbort);
+    }
+  };
+}
+__name(createMediaUpload, "createMediaUpload");
+function withMediaUploads(backend, options = {}) {
+  const upload = createMediaUpload(options);
+  return new Proxy(backend, {
+    get(target, property) {
+      if (property === "uploadAttachment") return upload;
+      const value = Reflect.get(target, property, target);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  });
+}
+__name(withMediaUploads, "withMediaUploads");
+export {
+  MediaUploadError,
+  createMediaUpload,
+  mediaAttachments,
+  withMediaUploads
+};
+//# sourceMappingURL=media.js.map

package/dist/media.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/media/index.ts"],"sourcesContent":["import type { MessageAttachment } from '@dudousxd/nestjs-agent-core';\nimport { streamChunks } from '@dudousxd/nestjs-media-client';\nimport type {\n  AgentBackend,\n  AttachmentUploadStrategy,\n  UploadAttachmentOptions,\n} from '../backend.js';\nimport type { AgentClientOptions } from '../client.js';\n\n/** Tuning for {@link mediaAttachments}; every field optional. */\nexport interface MediaAttachmentsOptions {\n  /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */\n  path?: string;\n  /** Bytes per tus `PATCH`. Default 5 MiB. */\n  chunkSize?: number;\n  /** Attempts per chunk before the upload fails. Default 3. */\n  retries?: number;\n}\n\n/**\n * Resumable attachment uploads through `@dudousxd/nestjs-media`, in one line:\n *\n * ```ts\n * const chat = useAgentChat({ attachments: mediaAttachments() });\n * const files = useAttachments({ backend: chat.backend });\n * ```\n *\n * Reuses the chat client's own connection (base url, headers, credentials), so it needs no\n * configuration. Also takes `new AgentClient({ attachments: mediaAttachments() })`.\n */\nexport function mediaAttachments(options: MediaAttachmentsOptions = {}): AttachmentUploadStrategy {\n  return (file, uploadOptions, connection) =>\n    createMediaUpload({\n      ...options,\n      baseUrl: connection.baseUrl,\n      getHeaders: connection.headers,\n      fetch: connection.fetch,\n      ...(connection.credentials !== undefined ? { credentials: connection.credentials } : {}),\n    })(file, uploadOptions);\n}\n\n/**\n * Where and how {@link createMediaUpload} talks to the server. The connection fields are\n * {@link AgentClientOptions}' — pass the same ones your `AgentClient` gets, so the tus requests\n * carry the same cookies / CSRF header / bearer token as the rest of the chat.\n */\nexport interface MediaUploadOptions extends AgentClientOptions {\n  /** The agent's route prefix (`AgentModule`'s `path`, global prefix included). Default `/agent`. */\n  path?: string;\n  /** Bytes per tus `PATCH`. Default 5 MiB (nestjs-media-client's default). */\n  chunkSize?: number;\n  /** Attempts per chunk before the upload fails. Default 3. */\n  retries?: number;\n}\n\n/** What `useAttachments({ upload })` and `AgentBackend.uploadAttachment` both take. */\nexport type AttachmentUpload = (\n  file: File,\n  options?: UploadAttachmentOptions,\n) => Promise<MessageAttachment>;\n\n/**\n * A non-2xx answer from the agent's upload routes. Carries `status` like `AgentHttpError` does\n * (413 too large, 415 type refused, 404 not yours) — its own class because this subpath is bundled\n * apart from the root entry, where an `instanceof AgentHttpError` would not match a copy.\n */\nexport class MediaUploadError extends Error {\n  constructor(\n    readonly status: number,\n    readonly method: string,\n    readonly path: string,\n    statusText: string,\n  ) {\n    super(`Attachment upload failed: ${method} ${path} → ${status} ${statusText}`);\n    this.name = 'MediaUploadError';\n  }\n}\n\ninterface BeginResponse {\n  mediaId: string;\n  location: string;\n}\n\n/**\n * A resumable `upload` for `useAttachments`, backed by `@dudousxd/nestjs-media` on the server\n * (`AgentMediaAttachmentsModule` from `@dudousxd/nestjs-agent/media`):\n *\n * 1. `POST <path>/attachments/uploads` — the agent validates the file and opens a tus session the\n *    actor owns;\n * 2. the bytes stream to nestjs-media's own tus endpoint in chunks (`streamChunks`), reporting\n *    progress and honouring the abort signal;\n * 3. `POST <path>/attachments/uploads/:mediaId/complete` — the agent confirms the bytes landed and\n *    answers the `MessageAttachment` the turn will reference by `mediaId`.\n *\n * An aborted or failed upload is discarded server-side (`DELETE`), best effort.\n */\nexport function createMediaUpload(options: MediaUploadOptions = {}): AttachmentUpload {\n  const origin = (options.baseUrl ?? '').replace(/\\/$/, '');\n  const base = `${origin}${(options.path ?? '/agent').replace(/\\/$/, '')}/attachments/uploads`;\n  const baseFetch = (): typeof fetch => options.fetch ?? fetch;\n  // Every request — the agent's and media's tus PATCHes — rides the same credentials mode.\n  const fetchWithCredentials: typeof fetch = (input, init) =>\n    baseFetch()(input, {\n      ...init,\n      ...(options.credentials !== undefined ? { credentials: options.credentials } : {}),\n    });\n  const headers = async (): Promise<Record<string, string>> => ({\n    ...options.headers,\n    ...((await options.getHeaders?.()) ?? {}),\n  });\n  const discard = (mediaId: string): void => {\n    void (async () => {\n      await fetchWithCredentials(`${base}/${encodeURIComponent(mediaId)}`, {\n        method: 'DELETE',\n        headers: await headers(),\n      });\n    })().catch(() => undefined);\n  };\n  const call = async <T>(method: string, url: string, body?: unknown): Promise<T> => {\n    const response = await fetchWithCredentials(url, {\n      method,\n      headers: {\n        accept: 'application/json',\n        ...(body !== undefined ? { 'content-type': 'application/json' } : {}),\n        ...(await headers()),\n      },\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n    });\n    if (!response.ok) {\n      throw new MediaUploadError(response.status, method, url, response.statusText);\n    }\n    return (await response.json()) as T;\n  };\n\n  return async (file, { signal, onProgress } = {}) => {\n    signal?.throwIfAborted();\n    const begun = await call<BeginResponse>('POST', base, {\n      filename: file.name,\n      contentType: file.type,\n      size: file.size,\n    });\n    const onAbort = () => discard(begun.mediaId);\n    signal?.addEventListener('abort', onAbort, { once: true });\n    try {\n      const location = /^https?:\\/\\//.test(begun.location)\n        ? begun.location\n        : `${origin}${begun.location}`;\n      await streamChunks(location, file, {\n        resume: false,\n        fetchImpl: fetchWithCredentials,\n        getHeaders: headers,\n        ...(options.chunkSize !== undefined ? { chunkSize: options.chunkSize } : {}),\n        ...(options.retries !== undefined ? { retries: options.retries } : {}),\n        ...(signal !== undefined ? { signal } : {}),\n        onProgress: (sent, total) => onProgress?.(total > 0 ? sent / total : 1),\n      });\n      signal?.throwIfAborted();\n      const attachment = await call<MessageAttachment>(\n        'POST',\n        `${base}/${encodeURIComponent(begun.mediaId)}/complete`,\n      );\n      onProgress?.(1);\n      return attachment;\n    } catch (error) {\n      if (!signal?.aborted) discard(begun.mediaId);\n      throw error;\n    } finally {\n      signal?.removeEventListener('abort', onAbort);\n    }\n  };\n}\n\n/**\n * Plug media uploads in once: the same backend, with `uploadAttachment` replaced by\n * {@link createMediaUpload}. Hand the result to `useAgentChat({ backend })` and\n * `useAttachments({ backend })` and every composer uploads resumably — no per-composer wiring.\n *\n * ```ts\n * const backend = withMediaUploads(new AgentClient(connection), connection);\n * ```\n *\n * Every other member is the original backend's, still bound to it.\n */\nexport function withMediaUploads<B extends AgentBackend>(\n  backend: B,\n  options: MediaUploadOptions = {},\n): B {\n  const upload = createMediaUpload(options);\n  return new Proxy(backend, {\n    get(target, property) {\n      if (property === 'uploadAttachment') return upload;\n      const value: unknown = Reflect.get(target, property, target);\n      return typeof value === 'function' ? value.bind(target) : value;\n    },\n  });\n}\n"],"mappings":"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","names":["streamChunks","mediaAttachments","options","file","uploadOptions","connection","createMediaUpload","baseUrl","getHeaders","headers","fetch","credentials","undefined","MediaUploadError","Error","status","method","path","statusText","name","origin","replace","base","baseFetch","fetchWithCredentials","input","init","discard","mediaId","encodeURIComponent","catch","call","url","body","response","accept","JSON","stringify","ok","json","signal","onProgress","throwIfAborted","begun","filename","contentType","type","size","onAbort","addEventListener","once","location","test","streamChunks","resume","fetchImpl","chunkSize","retries","sent","total","attachment","error","aborted","removeEventListener","withMediaUploads","backend","upload","Proxy","get","target","property","value","Reflect","bind"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-agent-react",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DavideCarvalho/nestjs-agent.git",
@@ -67,16 +67,27 @@
         "types": "./dist/genui-json-render.d.cts",
         "default": "./dist/genui-json-render.cjs"
       }
+    },
+    "./media": {
+      "import": {
+        "types": "./dist/media.d.ts",
+        "default": "./dist/media.js"
+      },
+      "require": {
+        "types": "./dist/media.d.cts",
+        "default": "./dist/media.cjs"
+      }
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@dudousxd/nestjs-agent-core": "0.25.0"
+    "@dudousxd/nestjs-agent-core": "0.26.0"
   },
   "peerDependencies": {
     "@ai-sdk/react": "^4.0.0",
+    "@dudousxd/nestjs-media-client": ">=0.3.0",
     "@json-render/react": ">=0.21.0 <1.0.0",
     "@streamdown/code": "^1.1.1",
     "@streamdown/math": "^1.0.2",
@@ -94,6 +105,9 @@
     "unist-util-visit": "^5.1.0"
   },
   "peerDependenciesMeta": {
+    "@dudousxd/nestjs-media-client": {
+      "optional": true
+    },
     "@json-render/react": {
       "optional": true
     },
@@ -136,6 +150,7 @@
   },
   "devDependencies": {
     "@ai-sdk/react": "4.0.17",
+    "@dudousxd/nestjs-media-client": "0.3.0",
     "@json-render/core": "0.21.0",
     "@json-render/react": "0.21.0",
     "@streamdown/code": "1.1.1",
@@ -159,8 +174,7 @@
     "tsup": "8.5.1",
     "typescript": "5.9.3",
     "unist-util-visit": "5.1.0",
-    "vitest": "2.1.9",
-    "@dudousxd/nestjs-agent-genui": "0.2.0"
+    "vitest": "2.1.9"
   },
   "scripts": {
     "build": "tsup",

package/dist/types-DFD-soWU.d.cts

@@ -1,86 +0,0 @@
-import { ComponentType, ReactNode } from 'react';
-
-/** The `ui` frame component a composed tree is pushed under (`@dudousxd/nestjs-agent-genui`'s `GENUI_TREE_COMPONENT`). */
-declare const GENUI_TREE_COMPONENT = "genui:tree";
-/** One pushed component, normalized from whatever carried it (a transcript block, a `data-ui` part, a stored entry). */
-interface GenerativeUIItem {
-    id: string;
-    component: string;
-    props: Record<string, unknown>;
-    version: number | null;
-    toolCallId: string | null;
-}
-/** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */
-interface GenerativeUIElement {
-    type: string;
-    props: Record<string, unknown>;
-    children?: GenerativeUIElement[];
-}
-/**
- * An app's renderer for one component: it receives the component's props spread, plus `children`
- * when it is a layout node in a tree. Any React component — the library never styles anything.
- */
-type GenuiRenderer<P = any> = ComponentType<P & {
-    children?: ReactNode;
-}>;
-/** Component name → the app's renderer. */
-type GenuiRegistry = Record<string, GenuiRenderer>;
-/**
- * Resolve a component the registry does not have — typically a tenant's own component, fetched for
- * the exact `version` a message was rendered with. Return `null`/`undefined` for "no such
- * component". May be async; results are cached per resolver, name and version.
- */
-type ResolveComponent = (name: string, version: number | null) => GenuiRenderer | null | undefined | Promise<GenuiRenderer | null | undefined>;
-interface GenuiIssueLike {
-    path: (string | number)[];
-    message: string;
-}
-type ValidationLike = {
-    ok: true;
-    value: Record<string, unknown>;
-} | {
-    ok: false;
-    issues: GenuiIssueLike[];
-};
-/**
- * What the renderer needs from a catalog to validate props before drawing them. A
- * `@dudousxd/nestjs-agent-genui` `Catalog` satisfies it; declared structurally so this subpath does
- * not depend on that package.
- */
-interface GenuiCatalogLike {
-    has(name: string): boolean;
-    validate(name: string, props: unknown): Promise<ValidationLike>;
-    validateSync?(name: string, props: unknown): ValidationLike | undefined;
-}
-interface GenerativeUIOptions {
-    registry: GenuiRegistry;
-    /** Validate props against it before rendering. Components the catalog does not know render unvalidated. */
-    catalog?: GenuiCatalogLike;
-    resolveComponent?: ResolveComponent;
-}
-/** Why an item did not render. */
-type GenerativeUIProblem = {
-    reason: 'unknown';
-    item: GenerativeUIItem;
-} | {
-    reason: 'invalid';
-    item: GenerativeUIItem;
-    issues: GenuiIssueLike[];
-} | {
-    reason: 'error';
-    item: GenerativeUIItem;
-    error: unknown;
-};
-type GenerativeUIState = {
-    status: 'ready';
-    item: GenerativeUIItem;
-    Component: GenuiRenderer;
-    props: Record<string, unknown>;
-} | {
-    status: 'loading';
-    item: GenerativeUIItem;
-} | ({
-    status: 'problem';
-} & GenerativeUIProblem);
-
-export { type GenerativeUIOptions as G, type ResolveComponent as R, type GenerativeUIItem as a, type GenerativeUIProblem as b, type GenerativeUIElement as c, type GenerativeUIState as d, GENUI_TREE_COMPONENT as e, type GenuiCatalogLike as f, type GenuiIssueLike as g, type GenuiRegistry as h, type GenuiRenderer as i };