Skip to main content

Troubleshooting

Module not initialized​

Make sure @quik/storage-express is registered in your bootstrap module and appears after @quik/http-express and @quik/storage. LocalStorage.init() only runs when an HTTP engine feature is registered — a worker or CLI-only boot silently skips it.

Upload folder missing​

SingleFile/ArrayFile throw MissingUploadFolderError (from @quik/storage) when storage.local.upload is not configured.

Signed download/upload route mismatch​

This package does not register GET/POST routes for signed local storage URLs itself; the consuming application defines them. If a generated URL 404s, check that your route is mounted at the same path as storage.local.http.basePath.

Common Errors​

RequireLocalStorageToken re-throws the following @quik/storage errors — see that module's troubleshooting guide for the full list:

  • quik.errors.storage.invalid-signed-url: the token query parameter is missing or malformed (401).
  • quik.errors.storage.signed-url-expired: the token was used after its expiration (410).
  • quik.errors.storage.signed-url-purpose-mismatch: a token issued for "upload" was used for "download" (or vice versa) (401).
  • quik.errors.storage.missing-upload-folder: storage.local.upload is not configured before using the local engine.