@byline/storage-local 1.7.0 → 1.7.1

package/dist/local-storage-provider.d.ts

@@ -11,7 +11,14 @@ export interface LocalStorageConfig {
      * Absolute or project-relative path to the root directory where uploaded
      * files will be stored.
      *
-     * @example `'./public/uploads'`
+     * For TanStack Start + Nitro hosts, keep this OUTSIDE `public/` — anything
+     * under `public/` is snapshotted into `.output/public/` at build time and
+     * served by Nitro's static handler from that snapshot, so files written at
+     * runtime won't appear until the next rebuild. Pair `uploadDir` with a
+     * runtime handler in your server entry that streams from this directory
+     * on every request.
+     *
+     * @example `'./uploads'`
      */
     uploadDir: string;
     /**
@@ -30,10 +37,18 @@ export interface LocalStorageConfig {
  *   `<collection>/<year>/<month>/<uuid>-<filename>`
  *
  * The provider generates a public URL by prepending `baseUrl` to the
- * storage path. Pair this with a static file server (e.g. Express
- * `express.static`, TanStack Start's static file serving, or nginx) that
+ * storage path. Pair this with a runtime file handler (Express
+ * `express.static`, an h3 handler, an nginx location block, or a small
+ * `Request → Response` shim in your TanStack Start `server.ts`) that
  * serves the `uploadDir` directory at the `baseUrl` path.
  *
+ * On TanStack Start + Nitro, do NOT use `nitro.publicAssets` for this:
+ * `publicAssets` copies into `.output/public/<baseURL>/` at build time
+ * and the Nitro static handler reads from a build-time virtual asset
+ * registry, so files written after the build never resolve. Use a
+ * runtime handler in `src/server.ts` instead — see the host scaffold
+ * shipped by `@byline/cli` for a worked example.
+ *
  * @example
  * ```ts
  * import { localStorageProvider } from '@byline/storage-local'
@@ -43,7 +58,7 @@ export interface LocalStorageConfig {
  *   ...config,
  *   db: pgAdapter({ connectionString: process.env.DB_CONNECTION_STRING! }),
  *   storage: localStorageProvider({
- *     uploadDir: './public/uploads',
+ *     uploadDir: './uploads',
  *     baseUrl: '/uploads',
  *   }),
  * })

package/dist/local-storage-provider.js

@@ -97,10 +97,18 @@ class LocalStorageProvider {
  *   `<collection>/<year>/<month>/<uuid>-<filename>`
  *
  * The provider generates a public URL by prepending `baseUrl` to the
- * storage path. Pair this with a static file server (e.g. Express
- * `express.static`, TanStack Start's static file serving, or nginx) that
+ * storage path. Pair this with a runtime file handler (Express
+ * `express.static`, an h3 handler, an nginx location block, or a small
+ * `Request → Response` shim in your TanStack Start `server.ts`) that
  * serves the `uploadDir` directory at the `baseUrl` path.
  *
+ * On TanStack Start + Nitro, do NOT use `nitro.publicAssets` for this:
+ * `publicAssets` copies into `.output/public/<baseURL>/` at build time
+ * and the Nitro static handler reads from a build-time virtual asset
+ * registry, so files written after the build never resolve. Use a
+ * runtime handler in `src/server.ts` instead — see the host scaffold
+ * shipped by `@byline/cli` for a worked example.
+ *
  * @example
  * ```ts
  * import { localStorageProvider } from '@byline/storage-local'
@@ -110,7 +118,7 @@ class LocalStorageProvider {
  *   ...config,
  *   db: pgAdapter({ connectionString: process.env.DB_CONNECTION_STRING! }),
  *   storage: localStorageProvider({
- *     uploadDir: './public/uploads',
+ *     uploadDir: './uploads',
  *     baseUrl: '/uploads',
  *   }),
  * })

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/storage-local",
   "private": false,
   "license": "MPL-2.0",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -40,7 +40,7 @@
   "dependencies": {
     "npm-run-all": "^4.1.5",
     "uuid": "^14.0.0",
-    "@byline/core": "1.7.0"
+    "@byline/core": "1.7.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.14",