@teepin/sdk 0.2.1 → 0.3.0

package/README.md

@@ -31,8 +31,7 @@ const teepin = new TeepinClient(); // reads TEEPIN_API_KEY and TEEPIN_BASE_URL
 // or: new TeepinClient({ apiKey: 'tpk_...' })
 ```
 
-Keep your API key on your server. To let a browser download or upload one file, sign a link on your server (see
-[Signed links](#signed-links)).
+Keep your API key on your server.
 
 ## Teepin Inference
 
@@ -142,8 +141,9 @@ This SDK adds the attestation results, billing-safe retries and Teepin's typed e
 
 ## Teepin Storage
 
-Buckets and files, with large uploads in parallel parts. The key needs `storage:read` to read and `storage:write`
-to write.
+Buckets and files. Files are encrypted on this device and sent straight to the storage network, and every byte read
+is verified on this device before it is used: no file byte passes through Teepin's API. The key needs `storage:read`
+to read and `storage:write` to write.
 
 ### Buckets
 
@@ -167,20 +167,29 @@ const info = await teepin.storage.statObject('my-bucket', 'notes.txt'); // size,
 
 ### Large files
 
-Files on disk use `@teepin/sdk/node`. An upload of any size goes in one request up to 16 MiB, and in parallel
-parts above that. Each part is retried on its own and checked against the bytes sent. `resume` continues an upload
-that was cut off. A download fetches ranges in parallel and checks the SHA-256.
+Files on disk use `@teepin/sdk/node`. Files up to 16 MiB are packed together, and larger ones go in parallel
+parts, each retried on its own. A large file's upload is journaled on disk, so `resumeUploads` finishes it after a
+crash or a lost connection; `uploadFiles` uploads many files as one such run. A download fetches ranges in parallel
+and checks the SHA-256.
 
 ```typescript
-import { uploadFile, downloadFile } from '@teepin/sdk/node';
+import { uploadFile, downloadFile, resumeUploads } from '@teepin/sdk/node';
 
 await uploadFile(teepin.storage, 'my-bucket', 'videos/a.mp4', './a.mp4', {
-  resume: true,
   onProgress: (done, total) => console.log(`${done} of ${total}`),
 });
 await downloadFile(teepin.storage, 'my-bucket', 'videos/a.mp4', './copy.mp4');
+
+await resumeUploads(teepin.storage); // finishes what an earlier process left unfinished
 ```
 
+On a slow connection, uploads use smaller requests. The client measures how fast its uploads to storage go (a request
+that gets no answer in time counts too, so a slow connection is noticed from the first requests), and when a request
+would take more than about 4 minutes, packs shrink below 9 MiB, an object too large for one such request (over 5 MiB)
+goes in parts instead of a pack, and new uploads use smaller parts (down to 5 MiB, the smallest allowed). A file that
+still can't be sent, because even 5 MiB parts would be too slow or it would need more than 3,000 parts, throws
+`TooLargeError` with `reason` `"connection_speed"` before anything is sent.
+
 ### List
 
 ```typescript
@@ -191,42 +200,35 @@ for await (const obj of teepin.storage.objects('my-bucket', 'videos/')) console.
 const page = await teepin.storage.listObjects('my-bucket', { prefix: 'videos/', delimiter: '/' });
 ```
 
-### Signed links
-
-Links that work without your key, for a limited time:
-
-```typescript
-const link = await teepin.storage.presignDownload('my-bucket', 'videos/a.mp4', { expiresIn: 3600 });
-console.log(link.url);
-
-const up = await teepin.storage.presignUpload('my-bucket', 'inbox/upload.bin', { maxBytes: 100 * 2 ** 20 });
-// In the browser: one PUT to the link your server signed.
-await fetch(up.url, { method: up.method, headers: up.headers, body: file });
-```
-
 ### Rename, copy and delete
 
 ```typescript
 await teepin.storage.renameObject('my-bucket', 'videos/a.mp4', 'archive/a.mp4'); // instant at any size
-await teepin.storage.copyObject('backup', 'a.mp4', 'my-bucket', 'archive/a.mp4'); // to backup/a.mp4, from my-bucket
+await teepin.storage.copyObject('backup', 'a.mp4', 'my-bucket', 'archive/a.mp4'); // read and uploaded again, to backup/a.mp4
 await teepin.storage.deleteObject('my-bucket', 'notes.txt');
+await teepin.storage.deleteObject('my-bucket', 'notes.txt', { ifMatch: etag }); // only if it still has statObject's etag, else PreconditionFailedError
 await teepin.storage.deleteObjects('my-bucket', ['a.txt', 'b.txt']); // up to 1000 a request
 ```
 
-### The S3 endpoint
+### Share links
 
-Teepin Storage also speaks S3 at `https://s3.teepin.com`, so the AWS CLI, boto3, the AWS SDKs and rclone work
-unchanged. Create an S3 access key in the console (a project's Settings, then S3 access keys). The region is
-`teepin`.
+A share link is a page on the console that anyone holding it can open with no sign-in, to preview or save one
+object, for up to 24 hours (15 minutes by default). It needs `storage:read`. Its token is sealed, so the link names
+no bucket or key, and rides in the URL's fragment (`https://console.teepin.com/l#…`). `openLink` opens one in code,
+with no API key: the bytes come straight from the storage network and are verified on this device. A download that
+began while the link was valid may finish after it expires, for up to 24 hours more.
 
-```bash
-aws configure set aws_access_key_id TPAK... --profile teepin
-aws configure set aws_secret_access_key ... --profile teepin
-aws configure set region teepin --profile teepin
-aws --profile teepin --endpoint-url https://s3.teepin.com s3 ls
-```
+```typescript
+import { openLink } from '@teepin/sdk';
+
+const link = await teepin.storage.createLink('my-bucket', 'reports/q3.pdf', { expiresIn: 3600 });
+console.log(link.url, link.expiresAt);
 
-The buckets are the same ones this SDK and the console show.
+const shared = await openLink(link.url); // InvalidLinkError once it has expired
+console.log(shared.name, shared.size, shared.contentType);
+const body = shared.stream(); // or shared.read(offset, length), or shared.downloadTo(sink)
+shared.close();
+```
 
 ## Errors
 
@@ -234,10 +236,13 @@ Errors from the API are `APIError` subclasses with the API's stable `code`, `sta
 `requestId` (for support):
 
 - `UnauthorizedError` (401), `PaymentRequiredError` (402), `ForbiddenError` (403), `NotFoundError` (404),
-  `ConflictError` (409), `PreconditionFailedError` (412), `TooLargeError` (413), `RateLimitError` (429);
+  `ConflictError` (409), `PreconditionFailedError` (412), `TooLargeError` (413; `reason` is `"connection_speed"`
+  when the connection measured too slow to send a file), `RateLimitError` (429);
 - `ConnectionError` when the server couldn't be reached;
 - `StreamError` and `StreamEndedError` for inference streams;
-- `ChecksumMismatchError`, `ObjectChangedError` and `UploadError` (with `uploadId`, for resuming) for storage.
+- `DataIntegrityError` (with `ChecksumMismatchError` under it), `ObjectChangedError`, `KeyErasedError`,
+  `StorageUnavailableError` and `FileChangedError` for storage, and `InvalidLinkError` (a `ForbiddenError`) for a
+  share link that is damaged or has expired.
 
 Helpers: `isNotFoundError`, `isRateLimitError`, `isInsufficientCreditError`, `isPermissionError` and
 `isRetryable`. Storage calls that fail for a passing reason are retried with backoff, up to `maxRetries` times

package/dist/cjs/client.js

@@ -3,12 +3,13 @@
 // Licensed under the Apache License, Version 2.0
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.backoff = exports.certainlyUnsent = exports.TeepinClient = exports.DEFAULT_BASE_URL = exports.VERSION = void 0;
+const engine_js_1 = require("./direct/engine.js");
 const errors_js_1 = require("./errors.js");
 const inference_js_1 = require("./inference.js");
 const instances_js_1 = require("./instances.js");
 const storage_js_1 = require("./storage.js");
 /** This SDK's version, sent in the User-Agent where the runtime allows it. */
-exports.VERSION = '0.2.1';
+exports.VERSION = '0.3.0';
 /** The public API. */
 exports.DEFAULT_BASE_URL = 'https://api.teepin.com';
 /** An environment variable, where there is an environment (Node, Deno, Bun;
@@ -37,8 +38,17 @@ class TeepinClient {
     inference;
     apiKey;
     projectId;
+    /** Milliseconds one call that is not a transfer may take; also how long a storage read waits for its next bytes. */
     timeout;
     maxRetries;
+    /** Milliseconds a read keeps a data key (ClientConfig.keyCacheTtl); 0 keeps none. */
+    keyCacheTtl;
+    /** Milliseconds an upload waits for storage to come back (ClientConfig.uploadWait); 0 fails at once. */
+    uploadWait;
+    /** The most packs or parts in flight at once (ClientConfig.uploadConcurrency). */
+    uploadConcurrency;
+    /** Where upload runs keep their journals (ClientConfig.stateDir); undefined for the default. */
+    stateDir;
     fetchImpl;
     /** Waits between retries; replaced in tests. */
     sleep = sleep;
@@ -48,6 +58,12 @@ class TeepinClient {
         this.projectId = config.projectId;
         this.timeout = config.timeout ?? 60000;
         this.maxRetries = Math.max(0, config.maxRetries ?? 4);
+        // 0 turns the cache off (every read fetches its key); undefined is the default. NaN keeps none.
+        this.keyCacheTtl = config.keyCacheTtl === undefined ? 600000 : Math.max(0, config.keyCacheTtl) || 0;
+        // 0 is a real choice (don't wait out an outage); only undefined takes the environment's or the default. NaN is 0.
+        this.uploadWait = config.uploadWait === undefined ? (0, engine_js_1.envNumber)(engine_js_1.UPLOAD_WAIT_ENV, engine_js_1.DEFAULT_UPLOAD_WAIT_MS / 1000) * 1000 : Math.max(0, config.uploadWait) || 0;
+        this.uploadConcurrency = Math.max(1, Math.floor(config.uploadConcurrency || (0, engine_js_1.envNumber)(engine_js_1.CONCURRENCY_ENV, engine_js_1.MAX_CONCURRENCY)));
+        this.stateDir = config.stateDir || undefined;
         const f = config.fetch ?? globalThis.fetch;
         if (!f)
             throw new errors_js_1.TeepinError('no fetch: use Node 20 or later, or pass config.fetch');
@@ -87,9 +103,28 @@ class TeepinClient {
         const mode = method === 'GET' || method === 'DELETE' ? 'safe' : 'unsent';
         return (await this.call({ method, path, json, mode })).data;
     }
-    /** An API path as an absolute URL. */
-    absolute(path) {
-        return /^https?:\/\//.test(path) ? path : this.baseUrl + path;
+    /**
+     * Sends a request the control plane signed for the storage network, once: without the API key, and with no retries
+     * (the direct engine decides). Resolves once the answer's headers are in, its body then bounded by signal; throws
+     * ConnectionError when no answer came (an abort throws the signal's reason) and APIError for an error answer.
+     */
+    async sendSigned(req) {
+        let response;
+        try {
+            response = await this.fetchImpl(req.url, { method: req.method, headers: req.headers, body: req.body, signal: req.signal });
+        }
+        catch (err) {
+            if (req.signal?.aborted)
+                throw req.signal.reason ?? err;
+            throw new errors_js_1.ConnectionError(`${req.method} to the storage network: ${err instanceof Error ? err.message : String(err)}`, err);
+        }
+        if (response.status >= 400)
+            throw await decodeError(response);
+        return response;
+    }
+    /** Zeroes the data keys storage reads keep in memory. The client still works: later reads fetch their keys again. */
+    close() {
+        this.storage.close();
     }
     async sendOnce(req, payload) {
         let url = this.baseUrl + req.path;
@@ -154,6 +189,7 @@ async function decodeError(response) {
     let code;
     let type;
     let deleteAfter;
+    let details;
     const text = await response.text().catch(() => '');
     try {
         const body = JSON.parse(text);
@@ -168,6 +204,7 @@ async function decodeError(response) {
             code = body.code;
             if (body.delete_after)
                 deleteAfter = new Date(body.delete_after);
+            details = body;
         }
     }
     catch {
@@ -182,6 +219,7 @@ async function decodeError(response) {
         requestId: response.headers.get('X-Request-ID') ?? undefined,
         retryAfterMs: retry > 0 ? retry * 1000 : undefined,
         deleteAfter,
+        details,
     });
 }
 /** Teepin's own answers that say a billed call was refused before it ran, by status. */

package/dist/cjs/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AAEjD,kDAA0H;AAC1H,2CAA+E;AAC/E,iDAAkD;AAClD,iDAAkD;AAClD,6CAA8C;AAE9C,8EAA8E;AACjE,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B,sBAAsB;AACT,QAAA,gBAAgB,GAAG,wBAAwB,CAAC;AAmGzD;2BAC2B;AAC3B,SAAS,GAAG,CAAC,IAAY;IACvB,MAAM,IAAI,GAAI,UAAyE,CAAC,OAAO,CAAC;IAChG,OAAO,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACxC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAa,YAAY;IACd,OAAO,CAAS;IACzB,2BAA2B;IAClB,SAAS,CAAmB;IACrC,sDAAsD;IAC7C,OAAO,CAAiB;IACjC,oFAAoF;IAC3E,SAAS,CAAmB;IAEpB,MAAM,CAAU;IAChB,SAAS,CAAU;IACpC,oHAAoH;IAC3G,OAAO,CAAS;IAChB,UAAU,CAAS;IAC5B,qFAAqF;IAC5E,WAAW,CAAS;IAC7B,wGAAwG;IAC/F,UAAU,CAAS;IAC5B,kFAAkF;IACzE,iBAAiB,CAAS;IACnC,gGAAgG;IACvF,QAAQ,CAAU;IACV,SAAS,CAAe;IACzC,gDAAgD;IAChD,KAAK,GAAwD,KAAK,CAAC;IAEnE,YAAY,SAAuB,EAAE;QACnC,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,iBAAiB,CAAC,IAAI,wBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,KAAM,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;QACtD,gGAAgG;QAChG,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACrG,kHAAkH;QAClH,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,qBAAS,EAAC,2BAAe,EAAE,kCAAsB,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC3J,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,iBAAiB,IAAI,IAAA,qBAAS,EAAC,2BAAe,EAAE,2BAAe,CAAC,CAAC,CAAC,CAAC;QAC1H,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QAC3C,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,uBAAW,CAAC,sDAAsD,CAAC,CAAC;QACtF,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,+BAAgB,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,2BAAc,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,+BAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAED,oHAAoH;IACpH,KAAK,CAAC,IAAI,CAAC,GAAY;QACrB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QAClE,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,EAAE,EAAE;YACjC,IAAI;gBACF,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAChE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;aACrD;YAAC,OAAO,GAAG,EAAE;gBACZ,IAAI,GAAG,YAAY,uBAAW;oBAAE,GAAG,CAAC,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC;gBAC3D,IAAI,OAAO,IAAI,UAAU,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO;oBAAE,MAAM,GAAG,CAAC;gBACpF,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;aACtE;SACF;IACH,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,IAAI,CAAI,GAAY;QACxB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,EAAE,IAAI,EAAE,SAAc,EAAE,QAAQ,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAM,EAAE,QAAQ,EAAE,CAAC;IACxE,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,OAAO,CAAc,MAAc,EAAE,IAAY,EAAE,IAAc;QACrE,MAAM,IAAI,GAAc,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpF,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,GAAkB;QACjC,IAAI,QAAkB,CAAC;QACvB,IAAI;YACF,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;SAC5H;QAAC,OAAO,GAAG,EAAE;YACZ,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;YACxD,MAAM,IAAI,2BAAe,CAAC,GAAG,GAAG,CAAC,MAAM,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;SAC7H;QACD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qHAAqH;IACrH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,GAAY,EAAE,OAAgB;QACnD,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACzF,IAAI,CAAC,CAAC,MAAM;YAAE,GAAG,IAAI,GAAG,GAAG,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAE7F,MAAM,OAAO,GAA2B,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;QACpE,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7D,IAAI,IAA0B,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,EAAE;YACZ,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACxB,OAAO,CAAC,cAAc,CAAC,KAAK,0BAA0B,CAAC;SACxD;aAAM,IAAI,OAAO,KAAK,SAAS,EAAE;YAChC,IAAI,GAAG,OAAO,CAAC;YACf,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;SAC9C;QACD,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,CAAC,YAAY,CAAC,GAAG,eAAe,eAAO,EAAE,CAAC;QAEpF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5G,IAAI,QAAkB,CAAC;QACvB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI;YACF,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACpF,IAAI,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE;gBACvC,6FAA6F;gBAC7F,SAAS,GAAG,IAAI,CAAC;gBACjB,SAAS,EAAE,CAAC;aACb;iBAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE;gBACvC,8DAA8D;gBAC9D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC;gBACjE,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE;oBAC5C,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;iBAC1B,CAAC,CAAC;aACJ;SACF;QAAC,OAAO,GAAG,EAAE;YACZ,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;YACxD,MAAM,IAAI,2BAAe,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;SAClH;gBAAS;YACR,IAAI,CAAC,SAAS;gBAAE,IAAI,EAAE,CAAC;SACxB;QACD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;CACF;AAhJD,oCAgJC;AAED,KAAK,UAAU,WAAW,CAAC,QAAkB;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,GAAG,QAAQ,CAAC,UAAU,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC/D,IAAI,IAAwB,CAAC;IAC7B,IAAI,IAAwB,CAAC;IAC7B,IAAI,WAA6B,CAAC;IAClC,IAAI,OAA4C,CAAC;IACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACnD,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAI3B,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE;YAChD,yEAAyE;YACzE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;YACxC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;YACpC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;SACxB;aAAM,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE;YAClC,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC;YAChC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACjB,IAAI,IAAI,CAAC,YAAY;gBAAE,WAAW,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjE,OAAO,GAAG,IAA+B,CAAC;SAC3C;KACF;IAAC,MAAM;QACN,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;KACtD;IACD,OAAO,IAAA,oBAAQ,EAAC;QACd,UAAU,EAAE,QAAQ,CAAC,MAAM;QAC3B,OAAO;QACP,IAAI;QACJ,IAAI;QACJ,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS;QAC5D,YAAY,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS;QAClD,WAAW;QACX,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,wFAAwF;AACxF,MAAM,aAAa,GAA6B;IAC9C,GAAG,EAAE,CAAC,gBAAgB,CAAC;IACvB,GAAG,EAAE,CAAC,gBAAgB,CAAC;IACvB,GAAG,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;CAClD,CAAC;AAEF,oGAAoG;AACpG,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAExE;;;;GAIG;AACH,SAAgB,eAAe,CAAC,GAAY,EAAE,KAAK,GAAG,CAAC;IACrD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,CAAC,GAAG,GAA4D,CAAC;IACvE,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpH,OAAO,eAAe,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAND,0CAMC;AAED,SAAS,SAAS,CAAC,GAAY,EAAE,GAAY;IAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE;QACzB,IAAI,GAAG,YAAY,2BAAe;YAAE,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,GAAG,YAAY,oBAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACxC,2GAA2G;QAC3G,OAAO,GAAG,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;KACpF;IACD,IAAI,GAAG,YAAY,2BAAe,EAAE;QAClC,4EAA4E;QAC5E,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,MAAM,CAAC;KACxC;IACD,IAAI,CAAC,CAAC,GAAG,YAAY,oBAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,QAAQ,GAAG,CAAC,UAAU,EAAE;QACtB,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC,CAAC,yDAAyD;QACnE,KAAK,GAAG,EAAE,8DAA8D;YACtE,OAAO,IAAI,CAAC;QACd,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,MAAM,CAAC;KAC1C;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4FAA4F;AAC5F,SAAgB,OAAO,CAAC,OAAe,EAAE,GAAY;IACnD,IAAI,GAAG,YAAY,oBAAQ,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,KAAM,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,EAAE,KAAM,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,GAAG,EAAE,CAAC;AACtC,CAAC;AAJD,0BAIC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAClB,MAA+B,EAC/B,EAAU;IAEV,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,2BAAe,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,IAAI,MAAM,EAAE,OAAO;QAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,EAAE;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/cjs/direct/bytes.js

@@ -0,0 +1,50 @@
+"use strict";
+// Copyright 2026 TEEPIN Project
+// Licensed under the Apache License, Version 2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInt = exports.fromBase64 = exports.utf8 = exports.constantTimeEqual = exports.concat = void 0;
+// Byte helpers the direct-storage formats share.
+/** The bytes of parts, joined into one new array. */
+function concat(parts) {
+    let n = 0;
+    for (const p of parts)
+        n += p.length;
+    const out = new Uint8Array(n);
+    let off = 0;
+    for (const p of parts) {
+        out.set(p, off);
+        off += p.length;
+    }
+    return out;
+}
+exports.concat = concat;
+/** Whether a and b hold the same bytes, in time that depends only on their lengths. */
+function constantTimeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let d = 0;
+    for (let i = 0; i < a.length; i++)
+        d |= a[i] ^ b[i];
+    return d === 0;
+}
+exports.constantTimeEqual = constantTimeEqual;
+/** A string's UTF-8 bytes. */
+function utf8(s) {
+    return new TextEncoder().encode(s);
+}
+exports.utf8 = utf8;
+/** The bytes of a base64 string (atob is in Node 16+ and every browser). */
+function fromBase64(s) {
+    const bin = atob(s);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+exports.fromBase64 = fromBase64;
+/** Whether n is a whole number JavaScript holds exactly. */
+function isInt(n) {
+    return Number.isSafeInteger(n);
+}
+exports.isInt = isInt;
+//# sourceMappingURL=bytes.js.map

package/dist/cjs/direct/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../../src/direct/bytes.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iDAAiD;;;AAEjD,iDAAiD;AAEjD,qDAAqD;AACrD,SAAgB,MAAM,CAAC,KAAmB;IACxC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE;QACrB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChB,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC;KACjB;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAVD,wBAUC;AAED,uFAAuF;AACvF,SAAgB,iBAAiB,CAAC,CAAa,EAAE,CAAa;IAC5D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AALD,8CAKC;AAED,8BAA8B;AAC9B,SAAgB,IAAI,CAAC,CAAS;IAC5B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAFD,oBAEC;AAED,4EAA4E;AAC5E,SAAgB,UAAU,CAAC,CAAS;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC;AACb,CAAC;AALD,gCAKC;AAED,4DAA4D;AAC5D,SAAgB,KAAK,CAAC,CAAS;IAC7B,OAAO,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAFD,sBAEC"}

package/dist/cjs/direct/common.js

@@ -0,0 +1,167 @@
+"use strict";
+// Copyright 2026 TEEPIN Project
+// Licensed under the Apache License, Version 2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Slots = exports.Progress = exports.joinCapped = exports.linked = exports.abortable = exports.Deferred = exports.objectFrom = exports.uuid7 = exports.toBase64 = void 0;
+const str = (v) => (v === undefined || v === null ? '' : String(v));
+const unquote = (etag) => etag.trim().replace(/^W\//, '').replace(/^"|"$/g, '');
+const hex = (b) => Array.from(b, (x) => x.toString(16).padStart(2, '0')).join('');
+/** base64 of bytes (btoa is in Node 16+ and every browser). */
+function toBase64(b) {
+    let s = '';
+    for (let i = 0; i < b.length; i += 0x8000)
+        s += String.fromCharCode(...b.subarray(i, i + 0x8000));
+    return btoa(s);
+}
+exports.toBase64 = toBase64;
+/** A UUIDv7 (RFC 9562): a millisecond timestamp, then random bits, so ids sort by time. */
+function uuid7() {
+    const b = crypto.getRandomValues(new Uint8Array(16));
+    let ms = Date.now();
+    for (let i = 5; i >= 0; i--) {
+        b[i] = ms % 256;
+        ms = Math.floor(ms / 256);
+    }
+    b[6] = (b[6] & 0x0f) | 0x70;
+    b[8] = (b[8] & 0x3f) | 0x80;
+    const h = hex(b);
+    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
+}
+exports.uuid7 = uuid7;
+/** An object from the API's JSON. */
+function objectFrom(raw) {
+    const d = (raw ?? {});
+    const date = (v) => new Date(str(v) || NaN);
+    return {
+        id: str(d.id),
+        key: str(d.key),
+        size: Number(d.size_bytes ?? 0),
+        contentType: d.content_type || undefined,
+        metadata: d.metadata,
+        checksumSha256: d.checksum_sha256 || undefined,
+        etag: unquote(str(d.etag)),
+        partCount: Number(d.part_count ?? 0),
+        status: str(d.status),
+        backend: str(d.backend),
+        createdAt: date(d.created_at),
+        updatedAt: date(d.updated_at),
+        uploadedAt: d.uploaded_at ? date(d.uploaded_at) : undefined,
+    };
+}
+exports.objectFrom = objectFrom;
+/** A promise with its resolve at hand. */
+class Deferred {
+    promise;
+    resolve;
+    settled = false;
+    constructor() {
+        this.promise = new Promise((resolve) => {
+            this.resolve = () => {
+                this.settled = true;
+                resolve();
+            };
+        });
+    }
+}
+exports.Deferred = Deferred;
+/** Resolves when p does, or rejects with signal's reason when it aborts first. */
+function abortable(p, signal) {
+    if (!signal)
+        return p;
+    if (signal.aborted) {
+        p.catch(() => undefined);
+        return Promise.reject(signal.reason);
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(signal.reason);
+        signal.addEventListener('abort', onAbort, { once: true });
+        p.then((v) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(v);
+        }, (err) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(err);
+        });
+    });
+}
+exports.abortable = abortable;
+/** A controller that aborts with parent's reason, and a function that unlinks it once it is no longer needed. */
+function linked(parent) {
+    const ctl = new AbortController();
+    if (!parent)
+        return { ctl, unlink: () => { } };
+    if (parent.aborted) {
+        ctl.abort(parent.reason);
+        return { ctl, unlink: () => { } };
+    }
+    const onAbort = () => ctl.abort(parent.reason);
+    parent.addEventListener('abort', onAbort, { once: true });
+    return { ctl, unlink: () => parent.removeEventListener('abort', onAbort) };
+}
+exports.linked = linked;
+/** Waits for every task to end, at most ms; whether they all did. Tasks never reject here (callers catch their own). */
+async function joinCapped(tasks, ms) {
+    let timer;
+    const capped = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), ms);
+    });
+    try {
+        return await Promise.race([Promise.allSettled(tasks).then(() => true), capped]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+exports.joinCapped = joinCapped;
+/** Bytes done of a total, reported as they go. */
+class Progress {
+    total;
+    fn;
+    done = 0;
+    constructor(total, fn) {
+        this.total = total;
+        this.fn = fn;
+    }
+    add(n) {
+        if (!this.fn || n === 0)
+            return;
+        this.done += n;
+        this.fn(this.done, this.total);
+    }
+}
+exports.Progress = Progress;
+/** A semaphore whose waits an abort ends. */
+class Slots {
+    free;
+    waiters = [];
+    constructor(free) {
+        this.free = free;
+    }
+    async acquire(signal) {
+        for (;;) {
+            signal?.throwIfAborted();
+            if (this.free > 0) {
+                this.free--;
+                return;
+            }
+            let wake;
+            const woken = new Promise((resolve) => (wake = resolve));
+            this.waiters.push(wake);
+            try {
+                await abortable(woken, signal);
+            }
+            catch (err) {
+                this.waiters = this.waiters.filter((w) => w !== wake);
+                if (this.free > 0)
+                    this.waiters.shift()?.(); // a wake-up this call may have taken goes on to the next
+                throw err;
+            }
+        }
+    }
+    release() {
+        this.free++;
+        this.waiters.shift()?.();
+    }
+}
+exports.Slots = Slots;
+//# sourceMappingURL=common.js.map

package/dist/cjs/direct/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/direct/common.ts"],"names":[],"mappings":"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"}

package/dist/cjs/direct/downloads-plan.js

@@ -0,0 +1,127 @@
+"use strict";
+// Copyright 2026 TEEPIN Project
+// Licensed under the Apache License, Version 2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.passing = exports.stopsRun = exports.plan = exports.fold = exports.keyParts = exports.partProblem = exports.UnsafePathError = exports.PART_SUFFIX = void 0;
+// Batch downloads' rules that need no file system (TEEPIN-STORAGE-DESIGN.md sections 19.15 and 22.5): a port of the
+// path rules and the plan in teepin-python's _downloads.py.
+//
+// - Which key can be a path under the destination: every part of it a file name; on Windows also without the
+//   characters Windows refuses, a device name (with any extension) or a trailing dot or space, on every OS, since a
+//   folder may be shared with Windows.
+// - Which keys would land on one file: the same path, or paths that differ only by case where names ignore case.
+// - Which errors leave an object to go on with later (pending), and which stop a whole run.
+//
+// The node entry (src/node/downloads.ts) does the rest: the files, the links, the journal. Nothing here imports a Node
+// module.
+const errors_js_1 = require("../errors.js");
+/** A download is written into its target's path with this added, and renamed into place only when whole. */
+exports.PART_SUFFIX = '.teepin-part';
+/** A key that can't be written under the destination: not a safe path, a link leading out, or another key's file. */
+class UnsafePathError extends errors_js_1.TeepinError {
+    constructor(message) {
+        super(message);
+        this.name = 'UnsafePathError';
+    }
+}
+exports.UnsafePathError = UnsafePathError;
+/** Windows' device names: a file named one of these, with any extension, is the device (CON, COM1, ...). */
+const WIN_RESERVED = new Set(['CON', 'PRN', 'AUX', 'NUL', ...['COM', 'LPT'].flatMap((p) => [...'0123456789\u00b9\u00b2\u00b3'].map((d) => p + d))]);
+/** Characters Windows doesn't allow in a file name. */
+const WIN_BAD = new Set([...'<>:"|?*\\', ...Array.from({ length: 31 }, (_, i) => String.fromCharCode(i + 1))]);
+/**
+ * Why one part of a key's path can't be a file name ("" when it can). On Windows also: its forbidden characters, a
+ * device name with or without an extension, and a trailing dot or space, which Windows drops, so the file would land
+ * under another name than the key's.
+ */
+function partProblem(part, windows) {
+    if (part === '' || part === '.' || part === '..')
+        return "an empty, '.' or '..' part";
+    if (part.includes('\0'))
+        return 'a NUL character';
+    if (windows) {
+        if ([...part].some((c) => WIN_BAD.has(c)))
+            return "a character Windows doesn't allow in a file name";
+        if (part.endsWith('.') || part.endsWith(' '))
+            return 'a name ending in a dot or a space, which Windows would drop';
+        if (WIN_RESERVED.has(part.split('.')[0].replace(/ +$/, '').toUpperCase()))
+            return 'a name Windows keeps for a device';
+    }
+    return '';
+}
+exports.partProblem = partProblem;
+/** A key's path split into its parts, each checked by partProblem: UnsafePathError for the first that can't be a name. */
+function keyParts(rel, windows) {
+    const parts = rel.split('/');
+    for (const part of parts) {
+        const why = partProblem(part, windows);
+        if (why)
+            throw new UnsafePathError(`${JSON.stringify(rel)} isn't a safe path under the destination: ${why}`);
+    }
+    return parts;
+}
+exports.keyParts = keyParts;
+/** A path as names that ignore case see it (NFC, then upper and lower case, so a sharp s and "SS" are one), or as it is. */
+function fold(path, insensitive) {
+    return insensitive ? path.normalize('NFC').toUpperCase().toLowerCase() : path;
+}
+exports.fold = fold;
+/**
+ * (key, relative path) pairs to the plan: folder markers skipped, keys that aren't safe paths failed, and a key whose
+ * file another key already takes failed.
+ */
+async function plan(pairs, paths) {
+    const entries = [];
+    const collisions = [];
+    const seen = new Map(); // folded path -> the key going there
+    for (const [key, rel] of pairs) {
+        if (rel === '' || rel.endsWith('/')) {
+            const path = paths.shown(rel);
+            entries.push({ key, path, result: { key, path, status: 'skipped', resumed: false } });
+            continue;
+        }
+        let path;
+        try {
+            path = await paths.target(keyParts(rel, paths.windows), rel);
+        }
+        catch (err) {
+            if (!(err instanceof UnsafePathError))
+                throw err;
+            const shown = paths.shown(rel);
+            entries.push({ key, path: shown, result: { key, path: shown, status: 'failed', error: err, resumed: false } });
+            continue;
+        }
+        // Two keys that differ only by case are one file where names ignore case, and so would their part files be.
+        const norm = fold(path, paths.insensitive);
+        const other = seen.get(norm);
+        if (other !== undefined) {
+            if (other === key)
+                continue; // the same key twice
+            const error = new UnsafePathError(`${JSON.stringify(key)} and ${JSON.stringify(other)} both go to ${path}`);
+            collisions.push({ key, path, status: 'failed', error, resumed: false });
+            continue;
+        }
+        seen.set(norm, key);
+        entries.push({ key, path });
+    }
+    return { entries, collisions };
+}
+exports.plan = plan;
+/** Errors that stop a whole run: what's left stays pending, to run again (a revoked key, no credit). */
+function stopsRun(err) {
+    return err instanceof errors_js_1.UnauthorizedError || err instanceof errors_js_1.ForbiddenError || err instanceof errors_js_1.PaymentRequiredError;
+}
+exports.stopsRun = stopsRun;
+/**
+ * An error after which an object's download is kept, to go on with later: one that stops the run, the network, a busy
+ * or failing service, or the local disk (full, say: any failed system call).
+ */
+function passing(err) {
+    if (stopsRun(err) || err instanceof errors_js_1.ConnectionError)
+        return true;
+    if (err instanceof errors_js_1.APIError)
+        return err.statusCode === 429 || err.statusCode >= 500;
+    return err instanceof Error && 'syscall' in err && typeof err.syscall === 'string';
+}
+exports.passing = passing;
+//# sourceMappingURL=downloads-plan.js.map