@nitida/asset-client 0.19.0 → 0.20.0

package/AGENTS.md

@@ -117,5 +117,7 @@ was never renamed.
 
 ⚠️ `@aquienpz/asset-client` still exists on npm but is **frozen at 0.14.2 (2026-07-18)**. It
 predates `oext`, the `variants` array, and a `hasPreset` that does not claim an `original` the
-asset does not have. Install `@nitida/asset-client`. The `@aquienpz/tenant-config` and
-`@aquienpz/asset-uploader-*` packages are internal and are not on npm at all.
+asset does not have. Install `@nitida/asset-client`. `@nitida/asset-uploader-web` and
+`@nitida/asset-uploader-expo` ARE on npm since 2026-08-23 — reach for one only
+when you need an upload to survive a reload or a backgrounded app.
+`@aquienpz/tenant-config` is still internal.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Espacio Futuro LTD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -128,3 +128,13 @@ shape. `presets` is populated everywhere, on every version — so read existence
 
 Deeper guidance — including uploads, tenant onboarding and the CORS boundary — lives in
 `@nitida/sdk`'s `skills/nitida-sdk/SKILL.md`, which ships inside that package.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+⚠️ **The licence covers this client code, not the service.** MIT lets you use,
+modify and redistribute the SDK; it does not grant access to nitida. The
+service is governed by its own terms and plan tiers, and every call still needs
+credentials issued to your project. Same shape as every other API client you
+already depend on.

package/SECURITY.md

@@ -0,0 +1,56 @@
+# Security
+
+## Reporting a vulnerability
+
+Email **security@espaciofuturo.io**. Please do not open a public issue — a
+public report is a disclosure, and it reaches attackers at the same moment it
+reaches us.
+
+Include what you have: the affected package and version, what you did, and what
+happened. A URL that reproduces it is worth more than a paragraph describing
+one. We will confirm receipt and tell you what we found.
+
+## What is in scope
+
+The published client packages and the service they talk to:
+
+- `@nitida/sdk`, `@nitida/asset-client`
+- `@nitida/asset-compressor-web`, `@nitida/asset-compressor-native`
+- `@nitida/asset-uploader-web`, `@nitida/asset-uploader-expo`
+- the delivery edge (`8ok.uk`) and the API (`api.nitida.gofuture.space`)
+
+## Two behaviours that look like bugs and are not
+
+Reported often enough to state up front, so a real report is not lost among
+them:
+
+**A 404 on a private asset is the feature.** An asset with
+`visibility: "private"` answers 404 on every public URL — the raw path, every
+stored variant, every `/t/` transform and every HLS segment. It is not a
+missing file. Signed access lives at `/a/{tenant}/…?exp&sig`, minted on your
+backend. See the SDK's `getPrivateAssetUrl`.
+
+**A presigned upload URL is a bearer credential, on purpose.** The browser
+uploader persists presigned R2 PUT URLs in IndexedDB, because that is what
+resuming after a reload means. They are write-only, scoped to the parts of one
+upload the holder started, expire in 60 minutes, and are deleted on complete
+and on abort.
+
+## Credentials, and the one mistake that matters
+
+An API key (`amk_rt_*`, `amk_ad_*`, `amk_ci_*`) is a **server-side** credential.
+It must never reach a browser bundle, an `NEXT_PUBLIC_*` variable, or a mobile
+app binary.
+
+The same goes for a tenant's **URL signing key**: it mints signed URLs for
+every private asset that tenant owns. Sign on your backend, or pre-sign at
+build time.
+
+The client packages are built so this is hard to get wrong — the web entrypoint
+`@nitida/sdk/web` does not accept `apiKey` or `signingKey` at all; the types
+reject them. If you find a path that leaks either one, that is exactly the
+report we want.
+
+If you believe a key has been exposed, email the address above and we will
+rotate it. Rotating a signing key invalidates every URL already signed with it,
+so tell us whether you have signed URLs in circulation.

package/dist/index.cjs

@@ -616,8 +616,13 @@ function setTenantId(id) {
 function getTenantId() {
   return tenantId;
 }
-function variantPrefix() {
-  return tenantId != null ? `${tenantId.toString(36)}/v/` : "";
+function variantPrefix(caller) {
+  if (tenantId == null) {
+    throw new Error(
+      `${caller}: no tenant is configured, so every variant URL would 404. Call setTenantId(id) once at boot, or construct a NitidaClient with \`tenantId\` (it does this for you). The tenant is part of the CDN path (\`<cdn>/<tenantId base36>/v/<sha16>-<preset>.<ext>\`) and cannot be guessed from the asset.`
+    );
+  }
+  return `${tenantId.toString(36)}/v/`;
 }
 var ORIGINAL_EXT_BY_MIME = {
   "image/png": "png",
@@ -661,7 +666,7 @@ function getAssetUrl(asset, preset) {
   );
   const fallback = transformFallbackFor(asset, preset);
   if (fallback) return fallback;
-  return buildPublicAssetUrl(asset, preset);
+  return buildPublicAssetUrl(asset, preset, "getAssetUrl");
 }
 function transformFallbackFor(asset, preset) {
   if (typeof asset.presets !== "string") return null;
@@ -670,23 +675,27 @@ function transformFallbackFor(asset, preset) {
   if (maxDim == null) return null;
   return `${cdnBaseUrl}/t/format=webp,width=${maxDim}/${asset.sha}.webp`;
 }
-function buildPublicAssetUrl(asset, preset) {
-  assertSha(asset, "getPrivateAssetUrl");
+function buildPublicAssetUrl(asset, preset, caller) {
+  assertSha(asset, caller);
   if (preset === "original") {
     const stored = asset.variants?.find((v) => v.preset === "original")?.url;
     if (stored) return stored;
     const ext = asset.oext || originalExtForMime(asset.mime);
-    return `${cdnBaseUrl}/${variantPrefix()}${asset.sha}-${PRESET_SHORT.original}.${ext}`;
+    return `${cdnBaseUrl}/${variantPrefix(caller)}${asset.sha}-${PRESET_SHORT.original}.${ext}`;
   }
   if (preset === "hls") {
     const stored = asset.variants?.find((v) => v.preset === "hls")?.url;
     if (stored) return stored;
     return `${cdnBaseUrl}/t/format=hls/${asset.sha}.m3u8`;
   }
-  return `${cdnBaseUrl}/${variantPrefix()}${asset.sha}-${PRESET_SHORT[preset]}.${PRESET_EXT[preset]}`;
+  return `${cdnBaseUrl}/${variantPrefix(caller)}${asset.sha}-${PRESET_SHORT[preset]}.${PRESET_EXT[preset]}`;
 }
 async function getPrivateAssetUrl(asset, preset, signingKey, opts) {
-  return signAccessUrl(buildPublicAssetUrl(asset, preset), signingKey, opts);
+  return signAccessUrl(
+    buildPublicAssetUrl(asset, preset, "getPrivateAssetUrl"),
+    signingKey,
+    opts
+  );
 }
 async function getPrivateTransformUrl(asset, opts, signingKey, signOpts) {
   const url = buildTransformUrl(asset, opts);