@lotics/app-sdk 0.54.1 → 0.54.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/files.md +8 -3
- package/package.json +1 -1
package/docs/files.md
CHANGED
|
@@ -52,13 +52,18 @@ use-access to the app itself.
|
|
|
52
52
|
The pipeline is: optimize (images only) → mint a presigned upload URL → `PUT` the bytes straight
|
|
53
53
|
to object storage → finalize. The API server never proxies the bytes.
|
|
54
54
|
|
|
55
|
-
- **Image optimization.** JPEG/PNG/WebP
|
|
55
|
+
- **Image optimization.** JPEG/PNG/WebP images larger than 1280 px on the long edge are
|
|
56
56
|
resized to ≤1280 px and re-encoded as JPEG at quality 0.75 before upload — phone photos
|
|
57
57
|
typically shrink 10–20×. Non-image files pass through unchanged, and any optimization failure
|
|
58
58
|
falls back to uploading the original bytes (never an upload error).
|
|
59
|
-
**Warning:** PNG/WebP
|
|
59
|
+
**Warning:** PNG/WebP larger than 1280 px on the long edge are *converted to JPEG* —
|
|
60
60
|
transparency is lost and the stored filename's extension becomes `.jpg`. If you need lossless
|
|
61
|
-
originals, keep
|
|
61
|
+
originals, keep PNG/WebP ≤1280 px or upload them as non-image MIME types.
|
|
62
|
+
- **HEIC/HEIF always becomes JPEG, regardless of size.** Most browsers cannot decode HEIC
|
|
63
|
+
(the Samsung/iPhone camera default), so where the browser can't convert it client-side the
|
|
64
|
+
server converts it at finalize under the same ≤1280 px / q0.75 policy (conversion failure
|
|
65
|
+
stores the original bytes — never an upload error). Either way the stored file — and the
|
|
66
|
+
file identity your app gets back — is `name.jpg` with `mime_type: "image/jpeg"`.
|
|
62
67
|
- **Transport resilience.** The storage `PUT` has a 5-minute per-request timeout and retries
|
|
63
68
|
network errors / timeouts / 5xx up to 3 attempts with 1 s → 2 s backoff between attempts. 4xx
|
|
64
69
|
responses are terminal (no retry). The presigned upload URL itself is valid for 10 minutes.
|