@ibanzajoe/uploader 1.1.0 → 1.3.0

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/README.md CHANGED
@@ -1,46 +1,113 @@
1
- # @uploader/react
1
+ # @ibanzajoe/uploader
2
2
 
3
3
  React picker and headless upload client for the Uploader platform.
4
4
 
5
+ > 📖 **Full developer guide:** [docs/14 — SDK Developer Guide](https://github.com/ibanzajoe/file-uploader/blob/main/docs/14-sdk-developer-guide.md)
6
+ > — install, the headless client, delivery/transform URLs, public/hotlink/signed
7
+ > protection, per-file protection, image editing, error handling, and an
8
+ > end-to-end example.
9
+
5
10
  ## Installation
6
11
 
7
12
  ```bash
8
- npm install @uploader/react
13
+ npm install @ibanzajoe/uploader
9
14
  ```
10
15
 
11
16
  ## Quick start — React picker
12
17
 
13
18
  ```tsx
14
- import { PickerOverlay } from '@uploader/react'
15
- import '@uploader/react/styles.css'
19
+ import { useState } from 'react'
20
+ import { PickerOverlay } from '@ibanzajoe/uploader'
21
+ import '@ibanzajoe/uploader/styles.css'
16
22
 
17
23
  function App() {
24
+ const [open, setOpen] = useState(false)
18
25
  return (
19
- <PickerOverlay
20
- apiKey="pk_your_api_key"
21
- apiUrl="https://your-api.example.com"
22
- onUploadDone={(res) => console.log(res.filesUploaded)}
23
- />
26
+ <>
27
+ <button onClick={() => setOpen(true)}>Upload</button>
28
+ <PickerOverlay
29
+ apikey="pk_your_api_key"
30
+ apiUrl="https://your-api.example.com"
31
+ open={open}
32
+ onClose={() => setOpen(false)}
33
+ onUploadDone={(res) => console.log(res.filesUploaded)}
34
+ />
35
+ </>
24
36
  )
25
37
  }
26
38
  ```
27
39
 
28
- ## Headless client (no React required)
40
+ ## Headless upload client (no React required)
41
+
42
+ The `@ibanzajoe/uploader/core` entry is a framework-free client — use it in a Node
43
+ script, a serverless function, a Vue/Svelte app, or behind your own UI. It has no
44
+ React dependency.
29
45
 
30
46
  ```ts
31
- import { UploaderClient } from '@uploader/react/core'
47
+ import { UploaderClient } from '@ibanzajoe/uploader/core'
32
48
 
33
49
  const client = new UploaderClient({
34
- apiKey: 'pk_your_api_key',
50
+ apikey: 'pk_your_api_key', // required — your public key
35
51
  apiUrl: 'https://your-api.example.com',
36
52
  })
37
53
 
38
- const result = await client.upload(file, { filename: 'photo.jpg' })
39
- console.log(result.handle) // e.g. "abc123def456"
40
- console.log(result.url) // public delivery URL
54
+ // Upload one file (a browser File/Blob, or a Node Blob/File):
55
+ const result = await client.upload(file, {
56
+ filename: 'photo.jpg',
57
+ onProgress: (pct) => console.log(`${pct}%`),
58
+ })
59
+
60
+ console.log(result.handle) // stable id, e.g. "abc123def456"
61
+ console.log(result.url) // delivery URL (cdn for public, edge for hotlink/signed)
62
+ console.log(result.size, result.mimetype)
41
63
  ```
42
64
 
43
- Large files (≥ 6 MiB) are automatically uploaded via multipart; smaller files use a single PUT.
65
+ Upload **many** files with bounded concurrency:
66
+
67
+ ```ts
68
+ const results = await client.uploadAll(files, { concurrency: 3 })
69
+ ```
70
+
71
+ **`new UploaderClient(options)`**
72
+
73
+ | Option | Type | Description |
74
+ |---|---|---|
75
+ | `apikey` | `string` | **Required.** Public key (`pk_…`). |
76
+ | `apiUrl` | `string` | Base URL of the API. Omit for same-origin. |
77
+ | `security` | `{ policy, signature }` | Signed policy applied to every request (see Delivery protection). |
78
+ | `deliveryProtection` | `'public' \| 'hotlink' \| 'signed'` | Client-wide **default** protection for uploads (see below). |
79
+ | `allowedOrigins` | `string[]` | Client-wide default per-file origin lock. |
80
+ | `directUpload` | `boolean` | Leave unset to auto-detect direct-to-bucket; `false` forces the proxied flow. |
81
+
82
+ **`client.upload(file, options?) → Promise<FileResult>`**
83
+
84
+ | Upload option | Type | Description |
85
+ |---|---|---|
86
+ | `onProgress` | `(percent: number) => void` | `0`–`100`. Real byte progress on the direct + multipart paths. |
87
+ | `filename` | `string` | Override the stored filename. |
88
+ | `path` | `string` | Storage path prefix. |
89
+ | `signal` | `AbortSignal` | Cancel the upload (throws `UploaderError` code `ABORTED`). |
90
+ | `chunkSize` | `number` | Multipart chunk size in bytes (default ~5 MB). |
91
+ | `deliveryProtection` | `'public' \| 'hotlink' \| 'signed'` | **Per-upload** protection for this file — overrides the client default. |
92
+ | `allowedOrigins` | `string[]` | Per-upload origin lock for this file. |
93
+
94
+ **`FileResult`**
95
+
96
+ ```ts
97
+ type FileResult = {
98
+ handle: string // stable public id — build delivery/transform URLs from it
99
+ url: string // delivery URL for the original
100
+ filename: string
101
+ mimetype: string
102
+ size: number // bytes
103
+ status: 'Stored'
104
+ }
105
+ ```
106
+
107
+ Large files (≥ ~6 MiB) upload via multipart automatically; smaller files use a
108
+ single PUT. When the account/plan allows it, bytes go **direct to storage** via a
109
+ presigned URL (they never transit the API); otherwise the client transparently
110
+ falls back to a proxied upload.
44
111
 
45
112
  ## Components
46
113
 
@@ -50,11 +117,22 @@ Full-screen modal picker with drag-and-drop, progress, and error UI.
50
117
 
51
118
  | Prop | Type | Description |
52
119
  |---|---|---|
53
- | `apiKey` | `string` | API key (`pk_…`) |
120
+ | `apikey` | `string` | API key (`pk_…`). **Required.** |
54
121
  | `apiUrl` | `string` | Base URL of the API server |
122
+ | `open` | `boolean` | Whether the modal is open. **Required.** |
123
+ | `onClose` | `() => void` | Called when the modal should close (ESC, backdrop, cancel) |
55
124
  | `onUploadDone` | `(res: PickerResponse) => void` | Called when all uploads complete |
56
- | `accept` | `string` | MIME type filter (e.g. `image/*`) |
57
- | `maxFiles` | `number` | Maximum number of files selectable at once |
125
+ | `deliveryProtection` | `'public' \| 'hotlink' \| 'signed'` | Protection for every file this picker uploads (see Delivery protection). Omit → account default. |
126
+ | `allowedOrigins` | `string[]` | Per-file origin lock (see Delivery protection). Omit → account allowlist. |
127
+ | `pickerOptions` | `PickerOptions` | File constraints + sources — `{ accept?: string[], maxFiles?, maxSize?, fromSources?, cameraFacingMode? }` |
128
+ | `theme` | `UploaderTheme` | Per-instance design tokens (see Theming) |
129
+
130
+ `<DropPane>` accepts the same `apikey` / `apiUrl` / `deliveryProtection` /
131
+ `allowedOrigins` / callback props.
132
+
133
+ > **Requires `@ibanzajoe/uploader` ≥ 1.3.0** for `deliveryProtection` /
134
+ > `allowedOrigins` on the picker components. (Earlier versions only honored them
135
+ > on the headless client.)
58
136
 
59
137
  ### `<DropPane>`
60
138
 
@@ -62,7 +140,75 @@ Inline drop zone that can be embedded in a form.
62
140
 
63
141
  ### `usePicker(options)`
64
142
 
65
- Headless hook returns `{ open, uploading, files, errors }`.
143
+ Headless hook for building a fully custom picker UI. Takes the same options as the
144
+ components (all `UploaderClientOptions` incl. `deliveryProtection`/`allowedOrigins`,
145
+ plus `pickerOptions` and the `onUpload*` callbacks) and returns:
146
+
147
+ ```ts
148
+ { files, addFiles, removeFile, editFile, retryFile, upload, progress, isUploading, isDone }
149
+ ```
150
+
151
+ ## Delivery protection (public / hotlink / signed)
152
+
153
+ Every file is served under one of three protection modes. **You choose the mode per
154
+ upload** (or set a client-wide default); it must be one your account's plan allows.
155
+
156
+ | Mode | Who can access | Delivery URL you get back |
157
+ |---|---|---|
158
+ | `public` | anyone with the link | `https://cdn.…/<key>` (CDN-cached, cheapest) |
159
+ | `hotlink` | requests from your allowed domains (Origin/Referer allowlist) | `https://edge.…/file/<handle>` |
160
+ | `signed` | only holders of a valid **signed URL** you mint server-side | `https://edge.…/file/<handle>` |
161
+
162
+ Set it per upload (headless or picker), or as a client-wide default:
163
+
164
+ ```ts
165
+ // headless — per upload wins over the client default
166
+ await client.upload(logo, { deliveryProtection: 'public' })
167
+ await client.upload(productImg, { deliveryProtection: 'hotlink' })
168
+ await client.upload(idScan, { deliveryProtection: 'signed' })
169
+
170
+ // client-wide default
171
+ const client = new UploaderClient({ apikey, apiUrl, deliveryProtection: 'signed' })
172
+ ```
173
+
174
+ ```tsx
175
+ // React picker (≥ 1.3.0)
176
+ <PickerOverlay apikey="pk_…" deliveryProtection="signed" open={open} onClose={close} />
177
+ ```
178
+
179
+ Resolution order: **per-upload → client default → the account default** configured in
180
+ the dashboard. If you request a mode your plan doesn't allow, the API responds `403
181
+ DELIVERY_MODE_NOT_ALLOWED`.
182
+
183
+ **`allowedOrigins`** (the domain list):
184
+ - For `hotlink`: omit it and the file uses your **account allowlist** (set in the
185
+ dashboard settings). Pass a per-file `allowedOrigins` only to override it for that
186
+ file (it replaces, not merges).
187
+ - For `signed`: the signature is the gate; a per-file `allowedOrigins` is an optional
188
+ extra domain lock layered on top.
189
+
190
+ ### Viewing a `signed` file
191
+
192
+ A `signed` file's `url` is not directly loadable — each view needs a fresh signed URL,
193
+ minted **server-side** with your API key secret. Use the one-call helper from the
194
+ **server** entry (Node only — never ship the secret to the browser):
195
+
196
+ ```ts
197
+ import { getSignedDeliveryUrl } from '@ibanzajoe/uploader/server'
198
+
199
+ // in an authenticated backend route:
200
+ const url = getSignedDeliveryUrl({
201
+ handle: file.handle,
202
+ secret: process.env.UPLOADER_API_SECRET, // the API key's secret
203
+ baseUrl: 'https://edge.your-domain.com', // origin of FileResult.url
204
+ expiresIn: 300, // seconds (default 300)
205
+ // ops: [resize({ w: 400 }), output({ format: 'webp' })], // optional transform
206
+ })
207
+ // → https://edge.…/file/<handle>?policy=…&signature=… (hand to <img src>)
208
+ ```
209
+
210
+ Prefer to build it yourself? `withSignedPolicy(url, { policy, signature })` from
211
+ `@ibanzajoe/uploader/core` appends a `policy`/`signature` pair you produced.
66
212
 
67
213
  ## Theming
68
214
 
@@ -79,8 +225,8 @@ leaks to the rest of your app. Only the keys you set change; everything else
79
225
  falls back to the shipped defaults.
80
226
 
81
227
  ```tsx
82
- import { PickerOverlay } from '@uploader/react'
83
- import '@uploader/react/styles.css'
228
+ import { PickerOverlay } from '@ibanzajoe/uploader'
229
+ import '@ibanzajoe/uploader/styles.css'
84
230
 
85
231
  <PickerOverlay
86
232
  apikey="pk_…"
@@ -149,16 +295,29 @@ Notes:
149
295
 
150
296
  ## Signed policies
151
297
 
152
- When the account has `requireSigned` enabled, pass a signed policy on upload:
298
+ When the account serves files in **signed** delivery mode (or requires signed
299
+ uploads), attach a signed policy at the **client** level — it rides as auth on
300
+ every request from that client:
153
301
 
154
302
  ```ts
155
- const result = await client.upload(file, {
156
- policy: 'base64-encoded-policy',
157
- signature: 'hmac-sha256-hex-signature',
303
+ const client = new UploaderClient({
304
+ apikey: 'pk_…',
305
+ apiUrl: 'https://your-api.example.com',
306
+ security: {
307
+ policy: 'base64-encoded-policy', // from YOUR backend
308
+ signature: 'hmac-sha256-hex-signature', // from YOUR backend
309
+ },
158
310
  })
159
311
  ```
160
312
 
161
- Build signed policies via the admin dashboard (`/api-keys` → "Build signed policy") or directly via `POST /api/admin/api-keys/:id/sign`.
313
+ For building **read** URLs of signed files, prefer the one-call
314
+ `getSignedDeliveryUrl()` from `@ibanzajoe/uploader/server` (see
315
+ [Delivery protection → Viewing a signed file](#viewing-a-signed-file)). It signs and
316
+ assembles the URL for you. If you'd rather bring your own `policy`/`signature`
317
+ (produced **server-side** — HMAC over the API key's secret; the SDK never signs in
318
+ the browser), append them with `withSignedPolicy(url, { policy, signature })`. Full
319
+ recipe + example:
320
+ [docs/14 §7.3](https://github.com/ibanzajoe/file-uploader/blob/main/docs/14-sdk-developer-guide.md#73-signed-urls-the-private-tier).
162
321
 
163
322
  ## Building
164
323
 
@@ -406,64 +406,11 @@ var UploaderClient = class {
406
406
  }
407
407
  };
408
408
 
409
- // src/core/transform.ts
410
- var resize = (params) => ({ name: "resize", params });
411
- var crop = (rect) => ({
412
- name: "crop",
413
- params: { dim: `${rect.x},${rect.y},${rect.w},${rect.h}`, ...rect }
414
- });
415
- var rotate = (params) => ({ name: "rotate", params });
416
- var flip = () => ({ name: "flip", params: {} });
417
- var flop = () => ({ name: "flop", params: {} });
418
- var quality = (params) => ({ name: "quality", params });
419
- var output = (params) => ({ name: "output", params });
420
- function serializeOp(op) {
421
- switch (op.name) {
422
- case "resize": {
423
- const parts = [];
424
- if (op.params.w !== void 0) parts.push(`w:${op.params.w}`);
425
- if (op.params.h !== void 0) parts.push(`h:${op.params.h}`);
426
- if (op.params.fit !== void 0) parts.push(`fit:${op.params.fit}`);
427
- return `resize=${parts.join(",")}`;
428
- }
429
- case "crop":
430
- return `crop=dim:${op.params.dim}`;
431
- case "rotate":
432
- return `rotate=deg:${op.params.deg}`;
433
- case "flip":
434
- return "flip";
435
- case "flop":
436
- return "flop";
437
- case "quality":
438
- return `quality=n:${op.params.n}`;
439
- case "output":
440
- return `output=format:${op.params.format}`;
441
- }
442
- }
443
- function transformUrl({ handle, ops, apiUrl = "" }) {
444
- const base = apiUrl.replace(/\/$/, "");
445
- const chain = ops.map(serializeOp).join("/");
446
- return chain ? `${base}/${chain}/${handle}` : `${base}/${handle}`;
447
- }
448
- function withSignedPolicy(url, security) {
449
- const sep = url.includes("?") ? "&" : "?";
450
- return `${url}${sep}policy=${encodeURIComponent(security.policy)}&signature=${encodeURIComponent(security.signature)}`;
451
- }
452
-
453
409
  export {
454
410
  UploaderError,
455
411
  MULTIPART_THRESHOLD,
456
412
  DEFAULT_CHUNK_SIZE,
457
413
  planChunks,
458
- UploaderClient,
459
- resize,
460
- crop,
461
- rotate,
462
- flip,
463
- flop,
464
- quality,
465
- output,
466
- transformUrl,
467
- withSignedPolicy
414
+ UploaderClient
468
415
  };
469
- //# sourceMappingURL=chunk-QRUZUI5L.js.map
416
+ //# sourceMappingURL=chunk-6AJTZNOI.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/core/errors.ts","../src/core/chunk.ts","../src/core/client.ts"],"sourcesContent":["/**\n * Typed errors for UploaderClient.\n *\n * UploaderError is thrown by upload / uploadAll on any non-retried failure.\n * The caller can narrow on `err.code` for structured handling.\n */\n\nexport type UploaderErrorCode =\n | 'ABORTED' // AbortSignal fired\n | 'NETWORK_ERROR' // fetch() threw (no response)\n | 'SERVER_ERROR' // 5xx after all retries exhausted\n | 'CLIENT_ERROR' // 4xx (not retried)\n | 'INVALID_RESPONSE' // response body did not match expected shape\n\nexport class UploaderError extends Error {\n readonly code: UploaderErrorCode\n /** HTTP status code when available (undefined for ABORTED / NETWORK_ERROR). */\n readonly statusCode?: number\n\n constructor(code: UploaderErrorCode, message: string, statusCode?: number) {\n super(message)\n this.name = 'UploaderError'\n this.code = code\n this.statusCode = statusCode\n }\n}\n","/**\n * Chunk planner for multipart uploads.\n *\n * Decides single-shot vs multipart by comparing the file size against\n * MULTIPART_THRESHOLD. For multipart files, slices the Blob into parts of\n * `chunkSize` bytes.\n */\n\n/** Files ≤ this size use single-shot POST /api/store. */\nexport const MULTIPART_THRESHOLD = 5 * 1024 * 1024 // 5 MB\n\n/** Default part size for multipart uploads. */\nexport const DEFAULT_CHUNK_SIZE = 5 * 1024 * 1024 // 5 MB\n\nexport type ChunkPlan =\n | { mode: 'single' }\n | { mode: 'multipart'; parts: Blob[]; partSize: number }\n\n/**\n * Build a chunk plan for a file.\n *\n * @param file The File or Blob to upload.\n * @param chunkSize Desired part size in bytes (default DEFAULT_CHUNK_SIZE).\n * @returns A plan describing whether to use single-shot or multipart.\n */\nexport function planChunks(file: File | Blob, chunkSize = DEFAULT_CHUNK_SIZE): ChunkPlan {\n if (file.size <= MULTIPART_THRESHOLD) {\n return { mode: 'single' }\n }\n\n const parts: Blob[] = []\n let offset = 0\n while (offset < file.size) {\n parts.push(file.slice(offset, offset + chunkSize))\n offset += chunkSize\n }\n return { mode: 'multipart', parts, partSize: chunkSize }\n}\n","/**\n * UploaderClient — headless upload client.\n *\n * Chooses single-shot (POST /api/store, multipart/form-data) vs multipart\n * (start/part/complete) based on file size relative to MULTIPART_THRESHOLD\n * (5 MB). Parts are retried individually with exponential backoff. Progress\n * is emitted as a 0–100 integer. AbortSignal cancels in-flight work.\n */\n\nimport type {\n FileResult,\n UploadStartResponse,\n UploadPartResponse,\n UploaderClientOptions,\n UploadAllOptions,\n UploadOptions,\n} from './types.js'\nimport { UploaderError } from './errors.js'\nimport { planChunks } from './chunk.js'\n\n// ─── Constants ────────────────────────────────────────────────────────────────\n\nconst MAX_RETRIES = 3\nconst RETRY_BASE_MS = 200\n\n/**\n * Single presigned PUT ceiling (mirrors the server's Phase-A limit). Files above\n * this fall back to the proxied multipart flow.\n */\nconst MAX_DIRECT_PUT_BYTES = 5 * 1024 * 1024 * 1024 // 5 GB\n\n/**\n * Skip the advisory client checksum above this size — SubtleCrypto has no\n * streaming API, so hashing would load the whole file into memory a second time.\n * The checksum is advisory only (the server can't verify it anyway).\n */\nconst SHA256_MAX_BYTES = 64 * 1024 * 1024 // 64 MB\n\n// ─── Internal helpers ─────────────────────────────────────────────────────────\n\n/** Sleep for `ms` milliseconds, resolving early if signal fires. */\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n return new Promise<void>((resolve, reject) => {\n if (signal?.aborted) {\n reject(new UploaderError('ABORTED', 'Upload aborted'))\n return\n }\n const timer = setTimeout(resolve, ms)\n signal?.addEventListener('abort', () => {\n clearTimeout(timer)\n reject(new UploaderError('ABORTED', 'Upload aborted'))\n }, { once: true })\n })\n}\n\n/** Throw UploaderError(ABORTED) if signal has already fired. */\nfunction checkAbort(signal?: AbortSignal): void {\n if (signal?.aborted) {\n throw new UploaderError('ABORTED', 'Upload aborted')\n }\n}\n\n/**\n * Fetch with retry on network errors and 5xx responses.\n * 4xx responses are not retried — they surface immediately as CLIENT_ERROR.\n */\nasync function fetchWithRetry(\n url: string,\n init: RequestInit,\n signal?: AbortSignal,\n maxRetries = MAX_RETRIES,\n): Promise<Response> {\n let lastErr: unknown\n for (let attempt = 0; attempt < maxRetries; attempt++) {\n checkAbort(signal)\n try {\n const res = await fetch(url, { ...init, signal })\n if (res.status >= 400 && res.status < 500) {\n // Client error — do not retry\n const body = await res.text().catch(() => '')\n throw new UploaderError(\n 'CLIENT_ERROR',\n `HTTP ${res.status}: ${body}`,\n res.status,\n )\n }\n if (res.status >= 500) {\n // Server error — retry with backoff\n lastErr = new UploaderError(\n 'SERVER_ERROR',\n `HTTP ${res.status}`,\n res.status,\n )\n if (attempt < maxRetries - 1) {\n await sleep(RETRY_BASE_MS * 2 ** attempt, signal)\n }\n continue\n }\n return res\n } catch (err) {\n if (err instanceof UploaderError) {\n if (err.code === 'CLIENT_ERROR' || err.code === 'ABORTED') throw err\n lastErr = err\n } else {\n // fetch() threw (network failure, CORS, etc.)\n lastErr = new UploaderError(\n 'NETWORK_ERROR',\n err instanceof Error ? err.message : String(err),\n )\n }\n if (attempt < maxRetries - 1) {\n await sleep(RETRY_BASE_MS * 2 ** attempt, signal)\n }\n }\n }\n throw lastErr\n}\n\n/**\n * Best-effort SHA-256 (hex) of a Blob for the advisory checksum sent at confirm.\n * Returns undefined when SubtleCrypto is unavailable (insecure context / older\n * runtime) or the file is large — never throws. The server treats this as a hint\n * only, so skipping it is safe.\n */\nasync function sha256Hex(blob: Blob): Promise<string | undefined> {\n try {\n const c = (globalThis as { crypto?: Crypto }).crypto\n if (!c?.subtle || blob.size > SHA256_MAX_BYTES) return undefined\n const digest = await c.subtle.digest('SHA-256', await blob.arrayBuffer())\n return Array.from(new Uint8Array(digest))\n .map((b) => b.toString(16).padStart(2, '0'))\n .join('')\n } catch {\n return undefined\n }\n}\n\n/**\n * PUT a body straight to a presigned bucket URL via XMLHttpRequest.\n *\n * XHR (not fetch) so real upload progress is reported (fetch cannot). The\n * Content-Type header MUST equal the value the server signed, or S3/R2 reject\n * the signature. Bytes go browser → bucket; our server never sees them.\n */\nfunction xhrPut(\n url: string,\n body: Blob,\n opts: { contentType: string; onProgress?: (percent: number) => void; signal?: AbortSignal },\n): Promise<void> {\n return new Promise<void>((resolve, reject) => {\n if (opts.signal?.aborted) {\n reject(new UploaderError('ABORTED', 'Upload aborted'))\n return\n }\n const xhr = new XMLHttpRequest()\n xhr.open('PUT', url)\n xhr.setRequestHeader('Content-Type', opts.contentType)\n\n if (opts.onProgress) {\n xhr.upload.onprogress = (e: ProgressEvent) => {\n if (e.lengthComputable) {\n // Reserve the last 5% for the confirm round-trip.\n opts.onProgress!(Math.round((e.loaded / e.total) * 95))\n }\n }\n }\n xhr.onload = () => {\n if (xhr.status >= 200 && xhr.status < 300) {\n resolve()\n } else {\n const code = xhr.status >= 400 && xhr.status < 500 ? 'CLIENT_ERROR' : 'SERVER_ERROR'\n reject(new UploaderError(code, `Bucket PUT failed: HTTP ${xhr.status}`, xhr.status))\n }\n }\n xhr.onerror = () => reject(new UploaderError('NETWORK_ERROR', 'Bucket PUT network error'))\n xhr.onabort = () => reject(new UploaderError('ABORTED', 'Upload aborted'))\n\n if (opts.signal) {\n opts.signal.addEventListener('abort', () => xhr.abort(), { once: true })\n }\n xhr.send(body)\n })\n}\n\n/** Shape returned by POST /api/uploads/presign. */\ntype PresignResponse = { handle: string; storageKey: string; putUrl: string; contentType: string }\n\n// ─── UploaderClient ────────────────────────────────────────────────────────────\n\nexport class UploaderClient {\n readonly apikey: string\n readonly apiUrl: string\n readonly security: UploaderClientOptions['security']\n readonly #directUploadOption?: boolean\n /** Client-level default per-file delivery protection (docs/13). */\n readonly #deliveryProtection?: UploaderClientOptions['deliveryProtection']\n /** Client-level default per-file allowed origins (docs/13). */\n readonly #allowedOrigins?: string[]\n\n /** Memoized capability probe — one request per client, shared across uploads. */\n #capsPromise: Promise<{ directUpload: boolean }> | null = null\n\n constructor(options: UploaderClientOptions) {\n this.apikey = options.apikey\n this.apiUrl = (options.apiUrl ?? 'https://api.uploaderhq.io').replace(/\\/$/, '')\n this.security = options.security\n this.#directUploadOption = options.directUpload\n this.#deliveryProtection = options.deliveryProtection\n this.#allowedOrigins = options.allowedOrigins\n }\n\n /**\n * Resolve the effective per-file protection for one upload: a per-upload value\n * overrides the client-level default (docs/13). Returns an object carrying ONLY\n * the keys that are set, so callers spread it into the request body and unset\n * fields are omitted entirely — an old server ignores them and the file inherits\n * the account mode (`null`).\n */\n #resolveProtection(opts: UploadOptions): {\n deliveryProtection?: UploaderClientOptions['deliveryProtection']\n allowedOrigins?: string[]\n } {\n const out: { deliveryProtection?: UploaderClientOptions['deliveryProtection']; allowedOrigins?: string[] } = {}\n const mode = opts.deliveryProtection ?? this.#deliveryProtection\n if (mode !== undefined) out.deliveryProtection = mode\n const origins = opts.allowedOrigins ?? this.#allowedOrigins\n if (origins !== undefined) out.allowedOrigins = origins\n return out\n }\n\n // ─── Capability negotiation ─────────────────────────────────────────────────\n\n /**\n * Probe GET /api/capabilities once per client and cache the result. Fails OPEN\n * to the proxied flow ({ directUpload: false }) on any error/timeout, so a\n * flaky probe never blocks uploads and old servers (404) are handled.\n */\n #getCapabilities(): Promise<{ directUpload: boolean }> {\n // Explicit opt-out — never probe, never use direct upload.\n if (this.#directUploadOption === false) {\n return Promise.resolve({ directUpload: false })\n }\n if (!this.#capsPromise) {\n this.#capsPromise = fetch(`${this.apiUrl}/api/capabilities`, {\n headers: this.#authHeaders(),\n })\n .then(async (res) => {\n if (!res.ok) return { directUpload: false }\n const body = (await res.json().catch(() => ({}))) as Record<string, unknown>\n return { directUpload: body['directUpload'] === true }\n })\n .catch(() => ({ directUpload: false }))\n }\n return this.#capsPromise\n }\n\n // ─── Direct-to-bucket upload ────────────────────────────────────────────────\n\n /**\n * Presign → PUT-to-bucket → confirm. Bytes go browser → bucket directly; our\n * server only signs and records. Used when the account has the directUpload\n * capability and the file fits a single PUT.\n */\n async #uploadDirect(file: File | Blob, opts: UploadOptions): Promise<FileResult> {\n const { onProgress, filename, signal } = opts\n const name = filename ?? (file instanceof File ? file.name : 'upload')\n // Must match the Content-Type we send on the PUT (the server signs it).\n const contentType = file instanceof File && file.type ? file.type : 'application/octet-stream'\n\n onProgress?.(0)\n checkAbort(signal)\n\n const protection = this.#resolveProtection(opts)\n const presign = async (): Promise<PresignResponse> => {\n const res = await fetchWithRetry(\n `${this.apiUrl}/api/uploads/presign`,\n {\n method: 'POST',\n headers: { ...this.#authHeaders(), 'Content-Type': 'application/json' },\n body: JSON.stringify({ filename: name, contentType, size: file.size, ...protection }),\n },\n signal,\n )\n return (await res.json()) as PresignResponse\n }\n\n let signed = await presign()\n\n // Advisory checksum (best-effort; unverifiable server-side).\n const checksum = await sha256Hex(file)\n\n // PUT straight to the bucket. A 403 means the short-lived signature lapsed\n // (or a stale key) — re-presign once and retry before giving up.\n try {\n await xhrPut(signed.putUrl, file, { contentType: signed.contentType, onProgress, signal })\n } catch (err) {\n if (err instanceof UploaderError && err.statusCode === 403) {\n signed = await presign()\n await xhrPut(signed.putUrl, file, { contentType: signed.contentType, onProgress, signal })\n } else {\n throw err\n }\n }\n\n // Confirm — server verifies the object exists, records usage, enqueues.\n checkAbort(signal)\n const confirmRes = await fetchWithRetry(\n `${this.apiUrl}/api/uploads/confirm`,\n {\n method: 'POST',\n headers: { ...this.#authHeaders(), 'Content-Type': 'application/json' },\n body: JSON.stringify({ handle: signed.handle, checksum }),\n },\n signal,\n )\n const body = (await confirmRes.json()) as unknown\n onProgress?.(100)\n return this.#parseFileResult(body)\n }\n\n // ─── Auth headers ──────────────────────────────────────────────────────────\n\n /**\n * Build the auth headers shared by all requests.\n * Attaches the API key and, when present, the signed policy pair.\n */\n #authHeaders(): Record<string, string> {\n const headers: Record<string, string> = {\n 'X-Uploader-Key': this.apikey,\n }\n if (this.security) {\n headers['X-Uploader-Policy'] = this.security.policy\n headers['X-Uploader-Signature'] = this.security.signature\n }\n return headers\n }\n\n // ─── Single-shot upload ────────────────────────────────────────────────────\n\n /**\n * POST /api/store — multipart/form-data for files ≤ MULTIPART_THRESHOLD.\n */\n async #uploadSingleShot(\n file: File | Blob,\n opts: UploadOptions,\n ): Promise<FileResult> {\n const { onProgress, filename, signal } = opts\n\n onProgress?.(0)\n checkAbort(signal)\n\n const form = new FormData()\n form.append('file', file, filename ?? (file instanceof File ? file.name : 'upload'))\n if (filename) form.append('filename', filename)\n // Per-file delivery protection (docs/13) — sent as form fields; allowedOrigins\n // is JSON-encoded to match the server's parse. Omitted when unset (inherit).\n const protection = this.#resolveProtection(opts)\n if (protection.deliveryProtection) form.append('deliveryProtection', protection.deliveryProtection)\n if (protection.allowedOrigins) form.append('allowedOrigins', JSON.stringify(protection.allowedOrigins))\n\n const res = await fetchWithRetry(\n `${this.apiUrl}/api/store`,\n {\n method: 'POST',\n headers: this.#authHeaders(),\n body: form,\n },\n signal,\n )\n\n const body = await res.json() as unknown\n onProgress?.(100)\n return this.#parseFileResult(body)\n }\n\n // ─── Multipart upload ──────────────────────────────────────────────────────\n\n /**\n * start → parts (parallel with progress) → complete for files > MULTIPART_THRESHOLD.\n */\n async #uploadMultipart(\n file: File | Blob,\n parts: Blob[],\n opts: UploadOptions,\n ): Promise<FileResult> {\n const { onProgress, filename, signal } = opts\n const name = filename ?? (file instanceof File ? file.name : 'upload')\n const mime = file instanceof File ? file.type : 'application/octet-stream'\n\n onProgress?.(0)\n checkAbort(signal)\n\n // 1. Start\n const protection = this.#resolveProtection(opts)\n const startRes = await fetchWithRetry(\n `${this.apiUrl}/api/upload/start`,\n {\n method: 'POST',\n headers: { ...this.#authHeaders(), 'Content-Type': 'application/json' },\n body: JSON.stringify({ filename: name, mimetype: mime, size: file.size, ...protection }),\n },\n signal,\n )\n const { uploadId } = await startRes.json() as UploadStartResponse\n\n // 2. Upload parts sequentially (retried individually)\n const etags: { partNumber: number; etag: string }[] = []\n let uploadedBytes = 0\n\n for (let i = 0; i < parts.length; i++) {\n checkAbort(signal)\n const partBlob = parts[i]!\n const partNumber = i + 1\n\n const partForm = new FormData()\n partForm.append('uploadId', uploadId)\n partForm.append('partNumber', String(partNumber))\n partForm.append('part', partBlob)\n\n const partRes = await fetchWithRetry(\n `${this.apiUrl}/api/upload/part`,\n {\n method: 'POST',\n headers: this.#authHeaders(),\n body: partForm,\n },\n signal,\n )\n const { etag } = await partRes.json() as UploadPartResponse\n\n etags.push({ partNumber, etag })\n uploadedBytes += partBlob.size\n onProgress?.(Math.round((uploadedBytes / file.size) * 95)) // reserve 5% for complete\n }\n\n // 3. Complete\n checkAbort(signal)\n const completeRes = await fetchWithRetry(\n `${this.apiUrl}/api/upload/complete`,\n {\n method: 'POST',\n headers: { ...this.#authHeaders(), 'Content-Type': 'application/json' },\n body: JSON.stringify({ uploadId, parts: etags }),\n },\n signal,\n )\n const body = await completeRes.json() as unknown\n onProgress?.(100)\n return this.#parseFileResult(body)\n }\n\n // ─── Response parser ───────────────────────────────────────────────────────\n\n #parseFileResult(body: unknown): FileResult {\n if (\n typeof body !== 'object' ||\n body === null ||\n typeof (body as Record<string, unknown>)['handle'] !== 'string' ||\n typeof (body as Record<string, unknown>)['url'] !== 'string'\n ) {\n throw new UploaderError('INVALID_RESPONSE', 'Unexpected response shape from upload API')\n }\n return body as FileResult\n }\n\n // ─── Public API ───────────────────────────────────────────────────────────\n\n /**\n * Upload a single file.\n *\n * Automatically selects single-shot vs multipart upload based on file size.\n * Emits progress via `opts.onProgress` (0–100). Respects `opts.signal` for\n * cancellation. Retries network errors and 5xx responses up to 3 times with\n * exponential backoff; 4xx errors are surfaced immediately.\n *\n * @throws {UploaderError} with code ABORTED | NETWORK_ERROR | SERVER_ERROR |\n * CLIENT_ERROR | INVALID_RESPONSE\n */\n async upload(\n file: File | Blob,\n opts: UploadOptions = {},\n ): Promise<FileResult> {\n // Prefer direct-to-bucket when the account supports it and the file fits a\n // single PUT. The probe fails open, so an old server or a disabled account\n // transparently uses the proxied flow below.\n const caps = await this.#getCapabilities()\n if (caps.directUpload && file.size <= MAX_DIRECT_PUT_BYTES) {\n return this.#uploadDirect(file, opts)\n }\n\n const plan = planChunks(file, opts.chunkSize)\n if (plan.mode === 'single') {\n return this.#uploadSingleShot(file, opts)\n }\n return this.#uploadMultipart(file, plan.parts, opts)\n }\n\n /**\n * Upload multiple files with concurrency limiting.\n *\n * Resolves once all uploads settle (fulfilled or rejected). The returned\n * array preserves input order. `opts.concurrency` caps simultaneous\n * in-flight uploads (default 3). Each file shares the same opts\n * (including onProgress — the callback fires per-file, not aggregate).\n *\n * @returns Array of PromiseSettledResult in input order.\n */\n async uploadAll(\n files: Array<File | Blob>,\n opts: UploadAllOptions = {},\n ): Promise<PromiseSettledResult<FileResult>[]> {\n const concurrency = opts.concurrency ?? 3\n const results: PromiseSettledResult<FileResult>[] = new Array(files.length)\n\n let index = 0\n\n async function worker(client: UploaderClient): Promise<void> {\n while (index < files.length) {\n const i = index++\n const file = files[i]!\n try {\n results[i] = { status: 'fulfilled', value: await client.upload(file, opts) }\n } catch (err) {\n results[i] = { status: 'rejected', reason: err }\n }\n }\n }\n\n const workers = Array.from({ length: Math.min(concurrency, files.length) }, () =>\n worker(this),\n )\n await Promise.all(workers)\n return results\n }\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,56 @@
1
+ // src/core/transform.ts
2
+ var resize = (params) => ({ name: "resize", params });
3
+ var crop = (rect) => ({
4
+ name: "crop",
5
+ params: { dim: `${rect.x},${rect.y},${rect.w},${rect.h}`, ...rect }
6
+ });
7
+ var rotate = (params) => ({ name: "rotate", params });
8
+ var flip = () => ({ name: "flip", params: {} });
9
+ var flop = () => ({ name: "flop", params: {} });
10
+ var quality = (params) => ({ name: "quality", params });
11
+ var output = (params) => ({ name: "output", params });
12
+ function serializeOp(op) {
13
+ switch (op.name) {
14
+ case "resize": {
15
+ const parts = [];
16
+ if (op.params.w !== void 0) parts.push(`w:${op.params.w}`);
17
+ if (op.params.h !== void 0) parts.push(`h:${op.params.h}`);
18
+ if (op.params.fit !== void 0) parts.push(`fit:${op.params.fit}`);
19
+ return `resize=${parts.join(",")}`;
20
+ }
21
+ case "crop":
22
+ return `crop=dim:${op.params.dim}`;
23
+ case "rotate":
24
+ return `rotate=deg:${op.params.deg}`;
25
+ case "flip":
26
+ return "flip";
27
+ case "flop":
28
+ return "flop";
29
+ case "quality":
30
+ return `quality=n:${op.params.n}`;
31
+ case "output":
32
+ return `output=format:${op.params.format}`;
33
+ }
34
+ }
35
+ function transformUrl({ handle, ops, apiUrl = "" }) {
36
+ const base = apiUrl.replace(/\/$/, "");
37
+ const chain = ops.map(serializeOp).join("/");
38
+ return chain ? `${base}/${chain}/${handle}` : `${base}/${handle}`;
39
+ }
40
+ function withSignedPolicy(url, security) {
41
+ const sep = url.includes("?") ? "&" : "?";
42
+ return `${url}${sep}policy=${encodeURIComponent(security.policy)}&signature=${encodeURIComponent(security.signature)}`;
43
+ }
44
+
45
+ export {
46
+ resize,
47
+ crop,
48
+ rotate,
49
+ flip,
50
+ flop,
51
+ quality,
52
+ output,
53
+ transformUrl,
54
+ withSignedPolicy
55
+ };
56
+ //# sourceMappingURL=chunk-DJK2SQ5I.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/core/transform.ts"],"sourcesContent":["/**\n * Delivery / transform URL builder.\n *\n * The API serves transformed derivatives at `GET /<chain>/<handle>`, where\n * <chain> is a slash-joined list of ops (e.g. `resize=w:200,h:200,fit:crop`).\n * These op builders + `transformUrl()` construct that URL from an uploaded file\n * handle, so consumers render an image at any size/format/quality without\n * hand-assembling URL strings.\n *\n * The op/param types and serialization mirror @uploader/shared EXACTLY — the\n * API's `parseTransformChain` is the other half of this contract, and\n * `contract.conformance.ts` asserts at typecheck time that they stay in sync.\n */\n\n// ─── Op vocabulary (mirrors @uploader/shared) ────────────────────────────────\n\nexport type TransformOpName =\n | 'resize'\n | 'crop'\n | 'rotate'\n | 'flip'\n | 'flop'\n | 'quality'\n | 'output'\n\n/** Parameters for the resize operation. */\nexport type ResizeParams = {\n w?: number\n h?: number\n fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside' | 'crop'\n}\n\n/** Parameters for the crop operation. */\nexport type CropParams = {\n /** \"x,y,w,h\" notation. */\n dim: string\n x?: number\n y?: number\n w?: number\n h?: number\n}\n\n/** Parameters for the rotate operation. */\nexport type RotateParams = { deg: number }\n\n/** Parameters for the quality operation. */\nexport type QualityParams = { n: number }\n\n/** Parameters for the output operation. */\nexport type OutputParams = { format: string }\n\n/** A single transform operation with its typed params. */\nexport type TransformOp =\n | { name: 'resize'; params: ResizeParams }\n | { name: 'crop'; params: CropParams }\n | { name: 'rotate'; params: RotateParams }\n | { name: 'flip'; params: Record<string, never> }\n | { name: 'flop'; params: Record<string, never> }\n | { name: 'quality'; params: QualityParams }\n | { name: 'output'; params: OutputParams }\n\n/** An ordered list of transform operations. */\nexport type TransformChain = { ops: TransformOp[] }\n\n// ─── Op builders ─────────────────────────────────────────────────────────────\n\n/** Resize to a width and/or height with an optional fit mode. */\nexport const resize = (params: ResizeParams): TransformOp => ({ name: 'resize', params })\n\n/** Crop a rectangular region: origin (x, y) and size w×h, in source pixels. */\nexport const crop = (rect: { x: number; y: number; w: number; h: number }): TransformOp => ({\n name: 'crop',\n params: { dim: `${rect.x},${rect.y},${rect.w},${rect.h}`, ...rect },\n})\n\n/** Rotate clockwise by `deg` degrees. */\nexport const rotate = (params: RotateParams): TransformOp => ({ name: 'rotate', params })\n\n/** Flip vertically (mirror top↔bottom). */\nexport const flip = (): TransformOp => ({ name: 'flip', params: {} })\n\n/** Flop horizontally (mirror left↔right). */\nexport const flop = (): TransformOp => ({ name: 'flop', params: {} })\n\n/** Set output quality 1–100 (ignored by lossless formats). */\nexport const quality = (params: QualityParams): TransformOp => ({ name: 'quality', params })\n\n/** Convert the output format, e.g. `{ format: 'webp' }`. */\nexport const output = (params: OutputParams): TransformOp => ({ name: 'output', params })\n\n// ─── Serialization (vendored from @uploader/shared, parser-compatible) ────────\n\nfunction serializeOp(op: TransformOp): string {\n switch (op.name) {\n case 'resize': {\n const parts: string[] = []\n if (op.params.w !== undefined) parts.push(`w:${op.params.w}`)\n if (op.params.h !== undefined) parts.push(`h:${op.params.h}`)\n if (op.params.fit !== undefined) parts.push(`fit:${op.params.fit}`)\n return `resize=${parts.join(',')}`\n }\n case 'crop':\n return `crop=dim:${op.params.dim}`\n case 'rotate':\n return `rotate=deg:${op.params.deg}`\n case 'flip':\n return 'flip'\n case 'flop':\n return 'flop'\n case 'quality':\n return `quality=n:${op.params.n}`\n case 'output':\n return `output=format:${op.params.format}`\n }\n}\n\nexport type TransformUrlOptions = {\n /** File handle from an upload (`FileResult.handle`). */\n handle: string\n /** Ordered transform ops to apply. Must contain at least one op. */\n ops: TransformOp[]\n /**\n * Base API URL. Defaults to '' so the URL is relative — `/<chain>/<handle>` —\n * and resolves same-origin (e.g. proxied to the API). Pass an absolute URL to\n * point at a remote API directly.\n */\n apiUrl?: string\n}\n\n/**\n * Build a delivery URL that applies `ops` to the file identified by `handle`.\n *\n * @example\n * transformUrl({\n * handle: file.handle,\n * ops: [resize({ w: 200, h: 200, fit: 'crop' }), output({ format: 'webp' })],\n * })\n * // => \"/resize=w:200,h:200,fit:crop/output=format:webp/<handle>\"\n */\nexport function transformUrl({ handle, ops, apiUrl = '' }: TransformUrlOptions): string {\n const base = apiUrl.replace(/\\/$/, '')\n const chain = ops.map(serializeOp).join('/')\n // The API's transform route requires at least one op segment before the\n // handle; for the unmodified original, use FileResult.url instead.\n return chain ? `${base}/${chain}/${handle}` : `${base}/${handle}`\n}\n\n/**\n * Append a signed read policy to a delivery/transform URL for accounts on the\n * `signed` delivery-protection tier (Private plan, docs/12).\n *\n * The `policy` + `signature` pair is produced SERVER-SIDE by the customer's\n * backend (HMAC over the account's api-key secret, via @uploader/shared). This\n * helper only assembles the URL — the SDK never signs and never sees the secret.\n *\n * @example\n * const url = withSignedPolicy(\n * transformUrl({ handle, ops: [resize({ w: 400 })], apiUrl }),\n * { policy, signature }, // from your backend\n * )\n */\nexport function withSignedPolicy(\n url: string,\n security: { policy: string; signature: string },\n): string {\n const sep = url.includes('?') ? '&' : '?'\n return `${url}${sep}policy=${encodeURIComponent(security.policy)}&signature=${encodeURIComponent(security.signature)}`\n}\n"],"mappings":";AAmEO,IAAM,SAAS,CAAC,YAAuC,EAAE,MAAM,UAAU,OAAO;AAGhF,IAAM,OAAO,CAAC,UAAuE;AAAA,EAC1F,MAAM;AAAA,EACN,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,KAAK;AACpE;AAGO,IAAM,SAAS,CAAC,YAAuC,EAAE,MAAM,UAAU,OAAO;AAGhF,IAAM,OAAO,OAAoB,EAAE,MAAM,QAAQ,QAAQ,CAAC,EAAE;AAG5D,IAAM,OAAO,OAAoB,EAAE,MAAM,QAAQ,QAAQ,CAAC,EAAE;AAG5D,IAAM,UAAU,CAAC,YAAwC,EAAE,MAAM,WAAW,OAAO;AAGnF,IAAM,SAAS,CAAC,YAAuC,EAAE,MAAM,UAAU,OAAO;AAIvF,SAAS,YAAY,IAAyB;AAC5C,UAAQ,GAAG,MAAM;AAAA,IACf,KAAK,UAAU;AACb,YAAM,QAAkB,CAAC;AACzB,UAAI,GAAG,OAAO,MAAM,OAAW,OAAM,KAAK,KAAK,GAAG,OAAO,CAAC,EAAE;AAC5D,UAAI,GAAG,OAAO,MAAM,OAAW,OAAM,KAAK,KAAK,GAAG,OAAO,CAAC,EAAE;AAC5D,UAAI,GAAG,OAAO,QAAQ,OAAW,OAAM,KAAK,OAAO,GAAG,OAAO,GAAG,EAAE;AAClE,aAAO,UAAU,MAAM,KAAK,GAAG,CAAC;AAAA,IAClC;AAAA,IACA,KAAK;AACH,aAAO,YAAY,GAAG,OAAO,GAAG;AAAA,IAClC,KAAK;AACH,aAAO,cAAc,GAAG,OAAO,GAAG;AAAA,IACpC,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,aAAa,GAAG,OAAO,CAAC;AAAA,IACjC,KAAK;AACH,aAAO,iBAAiB,GAAG,OAAO,MAAM;AAAA,EAC5C;AACF;AAyBO,SAAS,aAAa,EAAE,QAAQ,KAAK,SAAS,GAAG,GAAgC;AACtF,QAAM,OAAO,OAAO,QAAQ,OAAO,EAAE;AACrC,QAAM,QAAQ,IAAI,IAAI,WAAW,EAAE,KAAK,GAAG;AAG3C,SAAO,QAAQ,GAAG,IAAI,IAAI,KAAK,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM;AACjE;AAgBO,SAAS,iBACd,KACA,UACQ;AACR,QAAM,MAAM,IAAI,SAAS,GAAG,IAAI,MAAM;AACtC,SAAO,GAAG,GAAG,GAAG,GAAG,UAAU,mBAAmB,SAAS,MAAM,CAAC,cAAc,mBAAmB,SAAS,SAAS,CAAC;AACtH;","names":[]}
@@ -2,7 +2,7 @@
2
2
  * SDK-level option and result types for UploaderClient.
3
3
  *
4
4
  * The upload-contract types below are VENDORED from @uploader/shared so that
5
- * @uploader/react is self-contained for consumers outside this monorepo — one
5
+ * @ibanzajoe/uploader is self-contained for consumers outside this monorepo — one
6
6
  * install, no @uploader/* or zod transitive deps. They mirror the API contract
7
7
  * exactly; `contract.conformance.ts` asserts at typecheck time that they stay
8
8
  * structurally identical to the shared definitions, failing the build on drift.
@@ -151,133 +151,4 @@ declare class UploaderClient {
151
151
  uploadAll(files: Array<File | Blob>, opts?: UploadAllOptions): Promise<PromiseSettledResult<FileResult>[]>;
152
152
  }
153
153
 
154
- /**
155
- * Delivery / transform URL builder.
156
- *
157
- * The API serves transformed derivatives at `GET /<chain>/<handle>`, where
158
- * <chain> is a slash-joined list of ops (e.g. `resize=w:200,h:200,fit:crop`).
159
- * These op builders + `transformUrl()` construct that URL from an uploaded file
160
- * handle, so consumers render an image at any size/format/quality without
161
- * hand-assembling URL strings.
162
- *
163
- * The op/param types and serialization mirror @uploader/shared EXACTLY — the
164
- * API's `parseTransformChain` is the other half of this contract, and
165
- * `contract.conformance.ts` asserts at typecheck time that they stay in sync.
166
- */
167
- type TransformOpName = 'resize' | 'crop' | 'rotate' | 'flip' | 'flop' | 'quality' | 'output';
168
- /** Parameters for the resize operation. */
169
- type ResizeParams = {
170
- w?: number;
171
- h?: number;
172
- fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside' | 'crop';
173
- };
174
- /** Parameters for the crop operation. */
175
- type CropParams = {
176
- /** "x,y,w,h" notation. */
177
- dim: string;
178
- x?: number;
179
- y?: number;
180
- w?: number;
181
- h?: number;
182
- };
183
- /** Parameters for the rotate operation. */
184
- type RotateParams = {
185
- deg: number;
186
- };
187
- /** Parameters for the quality operation. */
188
- type QualityParams = {
189
- n: number;
190
- };
191
- /** Parameters for the output operation. */
192
- type OutputParams = {
193
- format: string;
194
- };
195
- /** A single transform operation with its typed params. */
196
- type TransformOp = {
197
- name: 'resize';
198
- params: ResizeParams;
199
- } | {
200
- name: 'crop';
201
- params: CropParams;
202
- } | {
203
- name: 'rotate';
204
- params: RotateParams;
205
- } | {
206
- name: 'flip';
207
- params: Record<string, never>;
208
- } | {
209
- name: 'flop';
210
- params: Record<string, never>;
211
- } | {
212
- name: 'quality';
213
- params: QualityParams;
214
- } | {
215
- name: 'output';
216
- params: OutputParams;
217
- };
218
- /** An ordered list of transform operations. */
219
- type TransformChain = {
220
- ops: TransformOp[];
221
- };
222
- /** Resize to a width and/or height with an optional fit mode. */
223
- declare const resize: (params: ResizeParams) => TransformOp;
224
- /** Crop a rectangular region: origin (x, y) and size w×h, in source pixels. */
225
- declare const crop: (rect: {
226
- x: number;
227
- y: number;
228
- w: number;
229
- h: number;
230
- }) => TransformOp;
231
- /** Rotate clockwise by `deg` degrees. */
232
- declare const rotate: (params: RotateParams) => TransformOp;
233
- /** Flip vertically (mirror top↔bottom). */
234
- declare const flip: () => TransformOp;
235
- /** Flop horizontally (mirror left↔right). */
236
- declare const flop: () => TransformOp;
237
- /** Set output quality 1–100 (ignored by lossless formats). */
238
- declare const quality: (params: QualityParams) => TransformOp;
239
- /** Convert the output format, e.g. `{ format: 'webp' }`. */
240
- declare const output: (params: OutputParams) => TransformOp;
241
- type TransformUrlOptions = {
242
- /** File handle from an upload (`FileResult.handle`). */
243
- handle: string;
244
- /** Ordered transform ops to apply. Must contain at least one op. */
245
- ops: TransformOp[];
246
- /**
247
- * Base API URL. Defaults to '' so the URL is relative — `/<chain>/<handle>` —
248
- * and resolves same-origin (e.g. proxied to the API). Pass an absolute URL to
249
- * point at a remote API directly.
250
- */
251
- apiUrl?: string;
252
- };
253
- /**
254
- * Build a delivery URL that applies `ops` to the file identified by `handle`.
255
- *
256
- * @example
257
- * transformUrl({
258
- * handle: file.handle,
259
- * ops: [resize({ w: 200, h: 200, fit: 'crop' }), output({ format: 'webp' })],
260
- * })
261
- * // => "/resize=w:200,h:200,fit:crop/output=format:webp/<handle>"
262
- */
263
- declare function transformUrl({ handle, ops, apiUrl }: TransformUrlOptions): string;
264
- /**
265
- * Append a signed read policy to a delivery/transform URL for accounts on the
266
- * `signed` delivery-protection tier (Private plan, docs/12).
267
- *
268
- * The `policy` + `signature` pair is produced SERVER-SIDE by the customer's
269
- * backend (HMAC over the account's api-key secret, via @uploader/shared). This
270
- * helper only assembles the URL — the SDK never signs and never sees the secret.
271
- *
272
- * @example
273
- * const url = withSignedPolicy(
274
- * transformUrl({ handle, ops: [resize({ w: 400 })], apiUrl }),
275
- * { policy, signature }, // from your backend
276
- * )
277
- */
278
- declare function withSignedPolicy(url: string, security: {
279
- policy: string;
280
- signature: string;
281
- }): string;
282
-
283
- export { type CropParams as C, type DeliveryProtection as D, type FileResult as F, type OutputParams as O, type PickerResponse as P, type QualityParams as Q, type ResizeParams as R, type TransformChain as T, type UploadAllOptions as U, type PolicySpec as a, type RotateParams as b, type TransformOp as c, type TransformOpName as d, type TransformUrlOptions as e, type UploadOptions as f, UploaderClient as g, type UploaderClientOptions as h, crop as i, flip as j, flop as k, rotate as l, output as o, quality as q, resize as r, transformUrl as t, withSignedPolicy as w };
154
+ export { type DeliveryProtection as D, type FileResult as F, type PickerResponse as P, type UploadAllOptions as U, type PolicySpec as a, type UploadOptions as b, UploaderClient as c, type UploaderClientOptions as d };