Skip to main content

Troubleshooting

Module not initialized​

Make sure @quik/storage is registered in your bootstrap module and appears after its dependencies.

Engine not registered​

StorageStore.get(name)/getDefault() throw StorageEngineNotLoadedError until an engine instance is registered with StorageStore.register(name, engine). Registering the same name twice throws StorageEngineAlreadyRegisteredError.

Signed URL generation fails​

Generating a signed local storage URL without storage.local.signed.secret configured throws StorageLocalSigningSecretMissingError.

Common Errors​

  • quik.errors.storage.engine-already-registered: a second engine was registered under the same name.
  • quik.errors.storage.not-loaded: no engine is registered under the requested name.
  • quik.errors.storage.not-enabled: the requested engine's enabled config flag is false.
  • quik.errors.storage.missing-upload-folder: storage.local.upload is not configured before using the local engine.
  • quik.errors.storage.file-not-found / file-contents-missing: the requested storage path does not exist, or a file operation received no content.
  • quik.errors.storage.local-signing-secret-missing: storage.local.signed.secret is not set.
  • quik.errors.storage.invalid-signed-url: a signed URL token is missing, malformed, or its signature does not match.
  • quik.errors.storage.signed-url-expired: a signed URL token was used after its expiration.
  • quik.errors.storage.signed-url-purpose-mismatch: a token issued for "upload" was used for "download" (or vice versa).