@lenne.tech/nuxt-extensions 1.18.6 → 1.19.0

package/README.md

@@ -177,8 +177,9 @@ export default defineNuxtConfig({
 
     // TUS upload configuration
     tus: {
-      defaultEndpoint: '/files/upload',
+      defaultEndpoint: '/tus',            // nest-server's TUS path (module default: '/files/upload')
       defaultChunkSize: 5 * 1024 * 1024,  // 5MB
+      resolveAgainstApi: true,            // relative endpoint = path on the API, like auth/AI requests
     },
 
     // i18n configuration (optional)
@@ -536,8 +537,8 @@ const {
   resumeUpload,
   cancelUpload,
 } = useLtTusUpload({
-  endpoint: '/api/files/upload',
-  onSuccess: (item) => console.log('Uploaded:', item.url),
+  endpoint: '/tus', // optional — defaults to ltExtensions.tus.defaultEndpoint
+  onSuccess: (item) => console.log('Stored file:', item.fileId),
   onError: (item, error) => console.error('Failed:', error),
 });
 
@@ -575,6 +576,19 @@ function handleFileSelect(event: Event) {
 </template>
 ```
 
+**Where the upload goes.** A relative endpoint is a path on the API: it is resolved like the auth
+requests — `NUXT_PUBLIC_API_URL` + path, or `/api` + path while the dev proxy is on
+(`NUXT_PUBLIC_API_PROXY=true`). So `'/tus'` works in every environment without per-stage config. An
+absolute URL is used as it is. If your project routes uploads through its own same-origin proxy
+instead, set `ltExtensions.tus.resolveAgainstApi: false` and the relative endpoint stays on the app
+origin.
+
+**Which id to keep.** After a successful upload, `item.fileId` is the id of the stored file, read
+from the `X-File-Id` response header (nest-server 11.42.13+). Use it for file links and references.
+`item.url` is the TUS upload resource; its last segment is the upload id, not the file id. `fileId`
+is undefined when the backend sends no such header (an older nest-server, or an `onUploadComplete()`
+override that never calls `super.onUploadComplete(upload)`).
+
 ### Transition Components
 
 ```vue

package/dist/module.d.mts

@@ -3,7 +3,7 @@ import { LtExtensionsModuleOptions } from '../dist/runtime/types/index.js';
 export * from '../dist/runtime/types/index.js';
 
 declare const name = "@lenne.tech/nuxt-extensions";
-declare const version = "1.18.6";
+declare const version = "1.19.0";
 declare const configKey = "ltExtensions";
 declare const DEFAULT_LT_AUTH_STATE_COOKIE = "lt-auth-state";
 declare const DEFAULT_LT_JWT_TOKEN_COOKIE = "lt-jwt-token";

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "configKey": "ltExtensions",
   "name": "@lenne.tech/nuxt-extensions",
-  "version": "1.18.6",
+  "version": "1.19.0",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -2,7 +2,7 @@ import { defineNuxtModule, createResolver, tryResolveModule, addImports, addComp
 import { pathToFileURL } from 'node:url';
 
 const name = "@lenne.tech/nuxt-extensions";
-const version = "1.18.6";
+const version = "1.19.0";
 const configKey = "ltExtensions";
 const DEFAULT_LT_AUTH_STATE_COOKIE = "lt-auth-state";
 const DEFAULT_LT_JWT_TOKEN_COOKIE = "lt-jwt-token";
@@ -49,7 +49,8 @@ const defaultOptions = {
   tus: {
     defaultChunkSize: 5 * 1024 * 1024,
     // 5MB
-    defaultEndpoint: "/files/upload"
+    defaultEndpoint: "/files/upload",
+    resolveAgainstApi: true
   }
 };
 const module$1 = defineNuxtModule({
@@ -147,7 +148,8 @@ const module$1 = defineNuxtModule({
       },
       tus: {
         defaultChunkSize: resolvedOptions.tus?.defaultChunkSize || 5 * 1024 * 1024,
-        defaultEndpoint: resolvedOptions.tus?.defaultEndpoint || "/files/upload"
+        defaultEndpoint: resolvedOptions.tus?.defaultEndpoint || "/files/upload",
+        resolveAgainstApi: resolvedOptions.tus?.resolveAgainstApi ?? true
       }
     };
     addImports([
@@ -241,6 +243,11 @@ const module$1 = defineNuxtModule({
     }
     nuxt.options.build.transpile.push(resolve("./runtime"));
     nuxt.options.build.transpile.push("tus-js-client");
+    if (await tryResolveModule("tus-js-client", [pathToFileURL(`${nuxt.options.rootDir}/`)])) {
+      nuxt.options.vite.optimizeDeps ||= {};
+      nuxt.options.vite.optimizeDeps.include ||= [];
+      nuxt.options.vite.optimizeDeps.include.push("tus-js-client > url-parse");
+    }
     console.log(`[${name}] v${version}`);
     if (nuxt.options.dev) {
       console.log(`[${name}] Module loaded with config:`, {

package/dist/runtime/composables/use-lt-file.js

@@ -2,7 +2,8 @@ import { useRuntimeConfig } from "#imports";
 export function useLtFile() {
   const config = useRuntimeConfig();
   function getFileApiBase() {
-    return config.public.ltExtensions?.tus?.defaultEndpoint?.replace("/upload", "") || "/files";
+    const endpoint = config.public.ltExtensions?.tus?.defaultEndpoint;
+    return (endpoint?.endsWith("/upload") ? endpoint.slice(0, -"/upload".length) : "") || "/files";
   }
   function isValidMongoID(id) {
     return /^[a-f\d]{24}$/i.test(id);

package/dist/runtime/composables/use-lt-tus-upload.d.ts

@@ -16,8 +16,8 @@ import type { LtUploadOptions, UseLtTusUploadReturn } from '../types/index.js';
  * @example
  * ```typescript
  * const { addFiles, uploads, totalProgress, isUploading } = useLtTusUpload({
- *   endpoint: '/api/files/upload',
- *   onSuccess: (item) => console.log('Uploaded:', item.url),
+ *   endpoint: '/tus', // a path on the API — resolved like the auth requests
+ *   onSuccess: (item) => console.log('Stored file:', item.fileId),
  * });
  *
  * // Add files from input

package/dist/runtime/composables/use-lt-tus-upload.js

@@ -1,4 +1,13 @@
 import { computed, ref, useRuntimeConfig } from "#imports";
+import { buildLtApiUrl } from "../lib/auth-state.js";
+const LT_TUS_FILE_ID_HEADER = "X-File-Id";
+const ABSOLUTE_URL = /^(?:[a-z][a-z\d+.-]*:|\/\/)/i;
+function resolveLtTusEndpoint(endpoint, resolveAgainstApi) {
+  if (!endpoint || !resolveAgainstApi || ABSOLUTE_URL.test(endpoint)) {
+    return endpoint;
+  }
+  return buildLtApiUrl(endpoint.startsWith("/") ? endpoint : `/${endpoint}`);
+}
 let tusModule = null;
 async function getTusModule() {
   if (!tusModule) {
@@ -22,7 +31,7 @@ export function useLtTusUpload(defaultOptions = {}) {
     endpoint: tusConfig?.defaultEndpoint || "/files/upload",
     parallelUploads: 3,
     retryDelays: [0, 1e3, 3e3, 5e3, 1e4],
-    ...defaultOptions
+    ...Object.fromEntries(Object.entries(defaultOptions).filter(([, value]) => value !== void 0))
   };
   const uploads = computed(() => Array.from(uploadItems.value.values()));
   const isUploading = computed(() => uploads.value.some((u) => u.status === "uploading"));
@@ -73,9 +82,10 @@ export function useLtTusUpload(defaultOptions = {}) {
   async function createTusUpload(item, options) {
     const tus = await getTusModule();
     const speedTracker = createSpeedTracker();
+    let fileId;
     return new tus.Upload(item.file, {
       chunkSize: options.chunkSize || defaultConfig.chunkSize,
-      endpoint: options.endpoint || defaultConfig.endpoint,
+      endpoint: resolveLtTusEndpoint(options.endpoint || defaultConfig.endpoint, tusConfig?.resolveAgainstApi !== false),
       headers: options.headers,
       metadata: {
         filename: item.file.name,
@@ -83,6 +93,9 @@ export function useLtTusUpload(defaultOptions = {}) {
         ...options.metadata,
         ...item.metadata
       },
+      onAfterResponse: (_req, res) => {
+        fileId = res.getHeader(LT_TUS_FILE_ID_HEADER) || fileId;
+      },
       onBeforeRequest: (req) => {
         const xhr = req.getUnderlyingObject();
         xhr.withCredentials = true;
@@ -115,6 +128,7 @@ export function useLtTusUpload(defaultOptions = {}) {
         const currentItem = uploadItems.value.get(item.id);
         updateItem(item.id, {
           completedAt: /* @__PURE__ */ new Date(),
+          fileId,
           progress: { ...currentItem.progress, percentage: 100 },
           status: "completed",
           url: tusUpload?.url ?? void 0

package/dist/runtime/types/module.d.ts

@@ -88,8 +88,22 @@ export interface LtAuthModuleOptions {
 export interface LtTusModuleOptions {
     /** Default chunk size in bytes (default: 5MB) */
     defaultChunkSize?: number;
-    /** Default TUS upload endpoint (default: '/files/upload') */
+    /**
+     * Default TUS upload endpoint (default: '/files/upload').
+     *
+     * nest-server serves TUS at `/tus` unless its `tus.path` is changed. A relative value is a path
+     * on the API while `resolveAgainstApi` is on; an absolute URL is used as it is.
+     */
     defaultEndpoint?: string;
+    /**
+     * Resolve a relative upload endpoint against the API base URL (default: true).
+     *
+     * Uses the same rule as the auth and AI requests: `NUXT_PUBLIC_API_URL` on the client, the
+     * `/api` dev-proxy prefix while `NUXT_PUBLIC_API_PROXY` is on. Without it, a relative endpoint
+     * goes to the app origin, where nothing serves TUS unless the project put its own proxy in
+     * front. Set it to `false` for exactly that setup. Absolute endpoints are never rewritten.
+     */
+    resolveAgainstApi?: boolean;
 }
 /**
  * i18n module configuration options
@@ -301,6 +315,7 @@ export interface LtExtensionsPublicRuntimeConfig {
         tus: {
             defaultChunkSize: number;
             defaultEndpoint: string;
+            resolveAgainstApi: boolean;
         };
     };
 }

package/dist/runtime/types/upload.d.ts

@@ -28,6 +28,13 @@ export interface LtUploadItem {
     error?: string;
     /** The file being uploaded */
     file: File;
+    /**
+     * Id of the stored file, from the `X-File-Id` header of the response that completed the upload
+     * (nest-server 11.42.13+). Use it for file links and references — not the last segment of `url`,
+     * which is the TUS upload id. Undefined when the backend sends no such header: an older
+     * nest-server, or an `onUploadComplete()` override that never calls `super.onUploadComplete()`.
+     */
+    fileId?: string;
     /** Unique identifier for this upload */
     id: string;
     /** Custom metadata to include with the upload */
@@ -38,7 +45,7 @@ export interface LtUploadItem {
     startedAt?: Date;
     /** Current status of the upload */
     status: LtUploadStatus;
-    /** URL of the uploaded file (available after completion) */
+    /** URL of the TUS upload resource (available after completion) — not a file URL; see `fileId` */
     url?: string;
 }
 /**
@@ -49,7 +56,7 @@ export interface LtUploadOptions {
     autoStart?: boolean;
     /** Chunk size in bytes (default: 5MB) */
     chunkSize?: number;
-    /** TUS upload endpoint URL */
+    /** TUS upload endpoint URL; a relative path is resolved against the API (see `tus.resolveAgainstApi`) */
     endpoint?: string;
     /** Additional headers to include with requests */
     headers?: Record<string, string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/nuxt-extensions",
-  "version": "1.18.6",
+  "version": "1.19.0",
   "description": "Reusable Nuxt 4 composables, components, and Better-Auth integration for lenne.tech projects",
   "repository": {
     "type": "git",
@@ -102,23 +102,23 @@
   "devDependencies": {
     "@better-auth/passkey": "1.7.7",
     "@nuxt/module-builder": "1.0.3",
-    "@nuxt/schema": "4.6.0",
+    "@nuxt/schema": "4.6.1",
     "@nuxt/ui": "4.11.3",
     "@playwright/test": "1.64.0",
-    "@types/node": "26.6.4",
+    "@types/node": "26.6.5",
     "@vitest/coverage-v8": "5.0.3",
     "@vue/server-renderer": "3.5.43",
     "better-auth": "1.7.7",
     "cross-spawn": "7.0.6",
-    "happy-dom": "20.14.5",
-    "nuxt": "4.6.0",
+    "happy-dom": "20.14.6",
+    "nuxt": "4.6.1",
     "oxfmt": "0.72.0",
     "oxlint": "1.87.0",
     "reka-ui": "2.10.5",
     "tus-js-client": "4.3.1",
     "typescript": "5.9.3",
     "vitest": "5.0.3",
-    "vue-tsc": "3.3.12"
+    "vue-tsc": "3.3.13"
   },
   "keywords": [
     "nuxt",