@teepin/sdk 0.2.1 → 0.3.0

package/dist/esm/transfer.js

@@ -1,18 +1,20 @@
 // Copyright 2026 TEEPIN Project
 // Licensed under the Apache License, Version 2.0
-import { backoff } from './client.js';
-import { ChecksumMismatchError, ConnectionError, errorCode, isRetryable, ObjectChangedError, TeepinError, UploadError, } from './errors.js';
-import { md5Hex } from './md5.js';
-import { MAX_OBJECT_SIZE, MAX_PART_SIZE, MAX_PARTS, MIN_PART_SIZE } from './storage.js';
-/** The part size of uploads in parts and of parallel download ranges. */
+import { Sha256 } from './direct/sha256.js';
+import { TeepinError } from './errors.js';
+import { MAX_PART_SIZE, MAX_PARTS, MIN_PART_SIZE } from './storage.js';
+/** computeETag hashes a whole source in reads of this size, so a file of any size is never held in memory at once. */
+const ETAG_READ = 8 * 2 ** 20;
+/** The part size of uploads in parts, unless asked for. */
 export const DEFAULT_PART_SIZE = 16 * 2 ** 20;
 /** upload sends larger data in parts. */
 export const MULTIPART_THRESHOLD = 16 * 2 ** 20;
 /** How many parts or ranges move at once. */
 export const DEFAULT_CONCURRENCY = 8;
 /**
- * The part size an upload of size bytes uses when want is asked for: at
- * least MIN_PART_SIZE, doubled until the parts fit in MAX_PARTS.
+ * The part size earlier releases' uploads in parts used for size bytes when want was asked for: at least
+ * MIN_PART_SIZE, doubled until the parts fit in MAX_PARTS. With computeETag it matches the ETag of an object uploaded
+ * in parts before the direct path (one ending in "-<parts>"); objects uploaded now have their SHA-256 as their ETag.
  */
 export function partSize(size, want = 0) {
     let p = Math.max(want || DEFAULT_PART_SIZE, MIN_PART_SIZE);
@@ -34,14 +36,18 @@ async function composite(parts) {
     return `${await sha256Hex(all)}-${parts.length}`;
 }
 /**
- * The ETag Teepin gives source: the SHA-256 when parts is 0, or for an
- * upload in parts of partBytes the SHA-256 of the parts' SHA-256s with
- * "-<parts>". Compare with StorageObject.etag to tell whether local data and
- * an object hold the same bytes.
+ * The ETag Teepin gives source: its SHA-256 when parts is 0, which is every object uploaded now however it was sent.
+ * An object uploaded in parts by an earlier release has the SHA-256 of its parts' SHA-256s with "-<parts>": pass the
+ * part size it used (partSize) and its part count. Compare with StorageObject.etag to tell whether local data and an
+ * object hold the same bytes.
  */
 export async function computeETag(source, partBytes, parts) {
-    if (parts === 0)
-        return sha256Hex(await source.read(0, source.size));
+    if (parts === 0) {
+        const h = new Sha256();
+        for (let off = 0; off < source.size; off += ETAG_READ)
+            h.update(await source.read(off, Math.min(ETAG_READ, source.size - off)));
+        return h.hexDigest();
+    }
     if (Math.ceil(source.size / partBytes) !== parts)
         throw new TeepinError(`${source.size} bytes in parts of ${partBytes} is not ${parts} parts`);
     const sums = [];
@@ -65,340 +71,4 @@ export function sourceOf(body) {
     }
     return body;
 }
-function isStream(body) {
-    if (typeof ReadableStream !== 'undefined' && body instanceof ReadableStream)
-        return true;
-    return typeof body === 'object' && body !== null && Symbol.asyncIterator in body && !('read' in body && 'size' in body);
-}
-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);
-    }
-}
-/** Runs fn for each item, n at a time, stopping at the first error, which it throws. */
-async function parallel(items, n, signal, fn) {
-    const ctl = new AbortController();
-    const onAbort = () => ctl.abort(signal?.reason);
-    signal?.addEventListener('abort', onAbort, { once: true });
-    let next = 0;
-    let failure;
-    const worker = async () => {
-        while (next < items.length && failure === undefined && !ctl.signal.aborted) {
-            const item = items[next++];
-            try {
-                await fn(item, ctl.signal);
-            }
-            catch (err) {
-                if (failure === undefined)
-                    failure = err;
-                ctl.abort(err);
-            }
-        }
-    };
-    try {
-        await Promise.all(Array.from({ length: Math.min(n, items.length) }, worker));
-    }
-    finally {
-        signal?.removeEventListener('abort', onAbort);
-    }
-    if (failure !== undefined)
-        throw failure;
-    if (signal?.aborted)
-        throw signal.reason;
-}
-export async function upload(s, bucket, key, body, opts = {}) {
-    if (isStream(body))
-        return uploadStream(s, bucket, key, body, opts);
-    const src = sourceOf(body);
-    const contentType = opts.contentType || src.type;
-    if (src.size > MAX_OBJECT_SIZE)
-        throw new TeepinError(`${src.size} bytes is over the 5 TiB an object may hold`);
-    if (src.size <= MULTIPART_THRESHOLD) {
-        const bytes = await src.read(0, src.size);
-        return putVerified(s, bucket, key, bytes, contentType, opts);
-    }
-    return uploadParts(s, bucket, key, src, contentType, opts);
-}
-async function putVerified(s, bucket, key, bytes, contentType, opts) {
-    const want = await sha256Hex(bytes);
-    const obj = await s.putObject(bucket, key, bytes, { contentType, metadata: opts.metadata, signal: opts.signal });
-    if (obj.etag && obj.etag !== want)
-        throw new ChecksumMismatchError(`stored ${obj.etag}, sent ${want}`);
-    opts.onProgress?.(bytes.length, bytes.length);
-    return obj;
-}
-async function uploadParts(s, bucket, key, src, contentType, opts) {
-    const size = partSize(src.size, opts.partSize);
-    const n = Math.ceil(src.size / size);
-    const span = (num) => {
-        const off = (num - 1) * size;
-        return [off, Math.min(size, src.size - off)];
-    };
-    const progress = new Progress(src.size, opts.onProgress);
-    const sums = new Array(n + 1);
-    let up;
-    if (opts.resume)
-        up = await resumable(s, bucket, key, contentType, src, n, span, sums, progress, opts.signal);
-    up ??= await s.createUpload(bucket, key, { contentType, metadata: opts.metadata, signal: opts.signal });
-    const id = up.id;
-    const todo = [];
-    for (let num = 1; num <= n; num++)
-        if (!sums[num])
-            todo.push(num);
-    try {
-        await parallel(todo, opts.concurrency ?? DEFAULT_CONCURRENCY, opts.signal, async (num, signal) => {
-            const [off, len] = span(num);
-            const bytes = await src.read(off, len);
-            const md5 = md5Hex(bytes);
-            const part = await s.uploadPart(bucket, id, num, bytes, signal);
-            if (part.etag !== md5)
-                throw new ChecksumMismatchError(`part ${num}: the server received MD5 ${part.etag}, sent ${md5}`);
-            sums[num] = { md5, sha256: await sha256Raw(bytes) };
-            progress.add(len);
-        });
-    }
-    catch (err) {
-        throw await failUpload(s, bucket, id, !!opts.resume, err);
-    }
-    const parts = [];
-    const shas = [];
-    for (let num = 1; num <= n; num++) {
-        parts.push({ number: num, etag: sums[num].md5 });
-        shas.push(sums[num].sha256);
-    }
-    return complete(s, bucket, key, id, parts, await composite(shas), !!opts.resume, opts.signal);
-}
-async function complete(s, bucket, key, id, parts, want, keep, signal) {
-    let obj;
-    try {
-        obj = await s.completeUpload(bucket, id, parts, signal);
-    }
-    catch (err) {
-        if (isRetryable(err) || errorCode(err) === 'upload_not_found') {
-            // The answer may have been lost after the object was made.
-            const got = await s.statObject(bucket, key, signal).catch(() => null);
-            if (got && got.etag === want)
-                return got;
-        }
-        throw await failUpload(s, bucket, id, keep, err);
-    }
-    if (obj.etag !== want)
-        throw new ChecksumMismatchError(`stored ${obj.etag}, sent ${want}`);
-    return obj;
-}
-async function failUpload(s, bucket, id, keep, err) {
-    if (!keep)
-        await s.abortUpload(bucket, id).catch(() => undefined);
-    return new UploadError(id, err);
-}
-/** The newest open upload of key this data can continue, with sums filled for parts it already holds with the same bytes. */
-async function resumable(s, bucket, key, contentType, src, n, span, sums, progress, signal) {
-    const ups = await s.listUploads(bucket, key, signal);
-    for (let i = ups.length - 1; i >= 0; i--) {
-        if (ups[i].key !== key || (contentType && ups[i].contentType !== contentType))
-            continue;
-        let up;
-        try {
-            up = await s.listParts(bucket, ups[i].id, signal);
-        }
-        catch (err) {
-            if (errorCode(err) === 'upload_not_found')
-                continue; // completed, cancelled or expired meanwhile
-            throw err;
-        }
-        for (const p of up.parts) {
-            if (p.number < 1 || p.number > n)
-                continue;
-            const [off, len] = span(p.number);
-            if (p.size !== len)
-                continue; // another part size: sent again
-            const bytes = await src.read(off, len);
-            if (md5Hex(bytes) === p.etag) {
-                sums[p.number] = { md5: p.etag, sha256: await sha256Raw(bytes) };
-                progress.add(len);
-            }
-        }
-        return up;
-    }
-    return undefined;
-}
-async function* chunksOf(body) {
-    if (typeof ReadableStream !== 'undefined' && body instanceof ReadableStream) {
-        const reader = body.getReader();
-        try {
-            for (;;) {
-                const { done, value } = await reader.read();
-                if (done)
-                    return;
-                if (value?.length)
-                    yield value;
-            }
-        }
-        finally {
-            reader.releaseLock();
-        }
-    }
-    else {
-        for await (const c of body)
-            if (c?.length)
-                yield c;
-    }
-}
-/** Reads a stream into parts of size bytes (the last may be shorter). */
-async function* partsOf(body, size) {
-    let buf = new Uint8Array(size);
-    let filled = 0;
-    for await (let chunk of chunksOf(body)) {
-        while (chunk.length) {
-            const take = Math.min(size - filled, chunk.length);
-            buf.set(chunk.subarray(0, take), filled);
-            filled += take;
-            chunk = chunk.subarray(take);
-            if (filled === size) {
-                yield buf;
-                buf = new Uint8Array(size);
-                filled = 0;
-            }
-        }
-    }
-    if (filled)
-        yield buf.subarray(0, filled);
-}
-/** Sends a stream of unknown size: what fits in one part in one request, the rest in parts, concurrency at a time. */
-async function uploadStream(s, bucket, key, body, opts) {
-    const size = Math.max(opts.partSize || DEFAULT_PART_SIZE, MIN_PART_SIZE);
-    const parts = partsOf(body, size);
-    const first = await parts.next();
-    const firstBytes = first.done ? new Uint8Array() : first.value;
-    const second = firstBytes.length === size ? await parts.next() : { done: true, value: undefined };
-    if (second.done)
-        return putVerified(s, bucket, key, firstBytes, opts.contentType, opts);
-    const progress = new Progress(-1, opts.onProgress);
-    const up = await s.createUpload(bucket, key, { contentType: opts.contentType, metadata: opts.metadata, signal: opts.signal });
-    const sums = [];
-    const inflight = new Set();
-    let failure;
-    const ctl = new AbortController();
-    opts.signal?.addEventListener('abort', () => ctl.abort(opts.signal?.reason), { once: true });
-    const send = (num, bytes) => {
-        const p = (async () => {
-            const md5 = md5Hex(bytes);
-            const part = await s.uploadPart(bucket, up.id, num, bytes, ctl.signal);
-            if (part.etag !== md5)
-                throw new ChecksumMismatchError(`part ${num}`);
-            sums[num - 1] = { md5, sha256: await sha256Raw(bytes) };
-            progress.add(bytes.length);
-        })().catch((err) => {
-            failure ??= err;
-            ctl.abort(err);
-        });
-        inflight.add(p);
-        p.finally(() => inflight.delete(p));
-    };
-    try {
-        let num = 0;
-        const queue = async (bytes) => {
-            if (++num > MAX_PARTS)
-                throw new TeepinError(`the stream is over ${MAX_PARTS} parts of ${size} bytes; raise partSize`);
-            while (inflight.size >= (opts.concurrency ?? DEFAULT_CONCURRENCY))
-                await Promise.race(inflight);
-            if (failure !== undefined)
-                throw failure;
-            send(num, bytes);
-        };
-        await queue(firstBytes);
-        await queue(second.value);
-        for await (const bytes of { [Symbol.asyncIterator]: () => parts }) {
-            if (failure !== undefined)
-                break;
-            await queue(bytes);
-        }
-        await Promise.all(inflight);
-        if (failure !== undefined)
-            throw failure;
-    }
-    catch (err) {
-        await Promise.allSettled(inflight);
-        throw await failUpload(s, bucket, up.id, false, failure ?? err);
-    }
-    const list = sums.map((x, i) => ({ number: i + 1, etag: x.md5 }));
-    return complete(s, bucket, key, up.id, list, await composite(sums.map((x) => x.sha256)), false, opts.signal);
-}
-/** Copies length bytes of obj from start into write, continuing where it broke off after a passing failure. */
-async function fetchRange(s, bucket, key, obj, start, length, write, progress, signal) {
-    let done = 0;
-    for (let attempt = 0; length > 0; attempt++) {
-        try {
-            const r = await s.getObject(bucket, key, { range: { start: start + done, end: start + length - 1 }, ifMatch: obj.etag, signal });
-            const reader = r.body.getReader();
-            try {
-                for (;;) {
-                    let chunk;
-                    try {
-                        chunk = await reader.read();
-                    }
-                    catch (err) {
-                        if (signal?.aborted)
-                            throw signal.reason;
-                        throw new ConnectionError('the download broke off', err);
-                    }
-                    if (chunk.done)
-                        break;
-                    await write(start + done, chunk.value);
-                    done += chunk.value.length;
-                    progress.add(chunk.value.length);
-                }
-            }
-            finally {
-                reader.releaseLock();
-            }
-            if (done < length)
-                throw new ConnectionError('the download ended early');
-            return;
-        }
-        catch (err) {
-            if (err instanceof ObjectChangedError || !isRetryable(err) || attempt >= s.client.maxRetries || signal?.aborted)
-                throw err;
-            await s.client.sleep(backoff(attempt, err), signal);
-        }
-    }
-}
-/** Stats the object, opens a writer for it, and fetches it as ranges, concurrency at a time. */
-async function fetchAll(s, bucket, key, open, opts) {
-    const obj = await s.statObject(bucket, key, opts.signal);
-    const write = open(obj);
-    const size = opts.partSize || DEFAULT_PART_SIZE;
-    const progress = new Progress(obj.size, opts.onProgress);
-    const ranges = [];
-    for (let off = 0; off < obj.size; off += size)
-        ranges.push(off);
-    await parallel(ranges, opts.concurrency ?? DEFAULT_CONCURRENCY, opts.signal, (off, signal) => fetchRange(s, bucket, key, obj, off, Math.min(size, obj.size - off), write, progress, signal));
-    return obj;
-}
-/** Downloads into memory and checks objects stored in one request against their SHA-256. For large files use downloadTo. */
-export async function download(s, bucket, key, opts = {}) {
-    let data = new Uint8Array();
-    const object = await fetchAll(s, bucket, key, (obj) => {
-        data = new Uint8Array(obj.size);
-        return (off, chunk) => data.set(chunk, off);
-    }, opts);
-    if (!opts.skipVerify && object.partCount === 0 && object.checksumSha256 && (await sha256Hex(data)) !== object.checksumSha256) {
-        throw new ChecksumMismatchError();
-    }
-    return { object, data };
-}
-/** Downloads into sink, as parallel ranges pinned to one version of the object. Does not check the checksum; @teepin/sdk/node's downloadFile does. */
-export async function downloadTo(s, bucket, key, sink, opts = {}) {
-    return fetchAll(s, bucket, key, () => (off, chunk) => sink.write(off, chunk), opts);
-}
 //# sourceMappingURL=transfer.js.map

package/dist/esm/transfer.js.map

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

package/dist/types/client.d.ts

@@ -2,7 +2,7 @@ import { InferenceService } from './inference.js';
 import { InstancesService } from './instances.js';
 import { StorageService } from './storage.js';
 /** This SDK's version, sent in the User-Agent where the runtime allows it. */
-export declare const VERSION = "0.2.1";
+export declare const VERSION = "0.3.0";
 /** The public API. */
 export declare const DEFAULT_BASE_URL = "https://api.teepin.com";
 /** Client configuration. Usually nothing: the key and address come from the
@@ -23,6 +23,32 @@ export interface ClientConfig {
     maxRetries?: number;
     /** The fetch to use (default: the global one). */
     fetch?: typeof fetch;
+    /**
+     * Milliseconds a read keeps an object's data key in memory, so later reads of the same version needn't fetch it
+     * (default 600000; 0 keeps none). Keys are zeroed on expiry and on close().
+     */
+    keyCacheTtl?: number;
+    /**
+     * Milliseconds an upload waits for an unavailable storage network or control plane before StorageUnavailableError
+     * (default: the TEEPIN_UPLOAD_WAIT environment variable in seconds, else 600000). 0 fails at once.
+     */
+    uploadWait?: number;
+    /** The most packs or parts an upload has in flight at once (default: TEEPIN_UPLOAD_CONCURRENCY, else 32). */
+    uploadConcurrency?: number;
+    /**
+     * Where @teepin/sdk/node's upload runs keep their journals (default: TEEPIN_STATE_DIR, else the OS's state
+     * directory: $XDG_STATE_HOME/teepin, ~/Library/Application Support/teepin or %LOCALAPPDATA%\teepin).
+     */
+    stateDir?: string;
+}
+/** One request to a URL the control plane signed: the storage network's. */
+export interface SignedRequest {
+    method: string;
+    url: string;
+    /** Sent exactly as signed. */
+    headers: Record<string, string>;
+    body?: BodyInit;
+    signal?: AbortSignal;
 }
 /** When a failed request may be sent again. */
 export type RetryMode = 
@@ -91,8 +117,17 @@ export declare class TeepinClient {
     readonly inference: InferenceService;
     private readonly apiKey?;
     private readonly projectId?;
-    private readonly timeout;
+    /** Milliseconds one call that is not a transfer may take; also how long a storage read waits for its next bytes. */
+    readonly timeout: number;
     readonly maxRetries: number;
+    /** Milliseconds a read keeps a data key (ClientConfig.keyCacheTtl); 0 keeps none. */
+    readonly keyCacheTtl: number;
+    /** Milliseconds an upload waits for storage to come back (ClientConfig.uploadWait); 0 fails at once. */
+    readonly uploadWait: number;
+    /** The most packs or parts in flight at once (ClientConfig.uploadConcurrency). */
+    readonly uploadConcurrency: number;
+    /** Where upload runs keep their journals (ClientConfig.stateDir); undefined for the default. */
+    readonly stateDir?: string;
     private readonly fetchImpl;
     /** Waits between retries; replaced in tests. */
     sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
@@ -106,8 +141,14 @@ export declare class TeepinClient {
     }>;
     /** The JSON call the compute API uses. */
     request<T = unknown>(method: string, path: string, json?: unknown): Promise<T>;
-    /** An API path as an absolute URL. */
-    absolute(path: string): string;
+    /**
+     * 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.
+     */
+    sendSigned(req: SignedRequest): Promise<Response>;
+    /** Zeroes the data keys storage reads keep in memory. The client still works: later reads fetch their keys again. */
+    close(): void;
     private sendOnce;
 }
 /**

package/dist/types/client.d.ts.map

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

package/dist/types/direct/bytes.d.ts

@@ -0,0 +1,11 @@
+/** The bytes of parts, joined into one new array. */
+export declare function concat(parts: Uint8Array[]): Uint8Array;
+/** Whether a and b hold the same bytes, in time that depends only on their lengths. */
+export declare function constantTimeEqual(a: Uint8Array, b: Uint8Array): boolean;
+/** A string's UTF-8 bytes. */
+export declare function utf8(s: string): Uint8Array;
+/** The bytes of a base64 string (atob is in Node 16+ and every browser). */
+export declare function fromBase64(s: string): Uint8Array;
+/** Whether n is a whole number JavaScript holds exactly. */
+export declare function isInt(n: number): boolean;
+//# sourceMappingURL=bytes.d.ts.map

package/dist/types/direct/bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../src/direct/bytes.ts"],"names":[],"mappings":"AAKA,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,CAUtD;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAKvE;AAED,8BAA8B;AAC9B,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAE1C;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAKhD;AAED,4DAA4D;AAC5D,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAExC"}

package/dist/types/direct/common.d.ts

@@ -0,0 +1,47 @@
+import type { StorageObject } from '../storage.js';
+/** Plain JSON, as the API answers it. */
+export type Json = Record<string, unknown>;
+/** base64 of bytes (btoa is in Node 16+ and every browser). */
+export declare function toBase64(b: Uint8Array): string;
+/** A UUIDv7 (RFC 9562): a millisecond timestamp, then random bits, so ids sort by time. */
+export declare function uuid7(): string;
+/** An object from the API's JSON. */
+export declare function objectFrom(raw: unknown): StorageObject;
+/** A promise with its resolve at hand. */
+export declare class Deferred {
+    readonly promise: Promise<void>;
+    resolve: () => void;
+    settled: boolean;
+    constructor();
+}
+/** Resolves when p does, or rejects with signal's reason when it aborts first. */
+export declare function abortable<T>(p: Promise<T>, signal?: AbortSignal): Promise<T>;
+/** A controller that aborts with parent's reason, and a function that unlinks it once it is no longer needed. */
+export declare function linked(parent?: AbortSignal): {
+    ctl: AbortController;
+    unlink: () => void;
+};
+/** Waits for every task to end, at most ms; whether they all did. Tasks never reject here (callers catch their own). */
+export declare function joinCapped(tasks: readonly Promise<unknown>[], ms: number): Promise<boolean>;
+/** Bytes done of a total, reported as they go. */
+export declare class Progress {
+    private readonly total;
+    private readonly fn?;
+    private done;
+    constructor(total: number, fn?: ((done: number, total: number) => void) | undefined);
+    add(n: number): void;
+}
+/** What waits are charged to: a pack, a large upload or a stream (uploadWait bounds each). */
+export interface Waits {
+    waited: number;
+    throttled: boolean;
+}
+/** A semaphore whose waits an abort ends. */
+export declare class Slots {
+    private free;
+    private waiters;
+    constructor(free: number);
+    acquire(signal?: AbortSignal): Promise<void>;
+    release(): void;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/types/direct/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/direct/common.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAMnD,yCAAyC;AACzC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAI9C;AAED,2FAA2F;AAC3F,wBAAgB,KAAK,IAAI,MAAM,CAW9B;AAED,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAkBtD;AAED,0CAA0C;AAC1C,qBAAa,QAAQ;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,EAAG,MAAM,IAAI,CAAC;IACrB,OAAO,UAAS;;CAUjB;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAoB5E;AAED,iHAAiH;AACjH,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAUzF;AAED,wHAAwH;AACxH,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjG;AAED,kDAAkD;AAClD,qBAAa,QAAQ;IAGjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IAHtB,OAAO,CAAC,IAAI,CAAK;gBAEE,KAAK,EAAE,MAAM,EACb,EAAE,CAAC,UAAS,MAAM,SAAS,MAAM,KAAK,IAAI,aAAA;IAG7D,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAKrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,6CAA6C;AAC7C,qBAAa,KAAK;IAEJ,OAAO,CAAC,IAAI;IADxB,OAAO,CAAC,OAAO,CAAyB;gBACpB,IAAI,EAAE,MAAM;IAE1B,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlD,OAAO,IAAI,IAAI;CAIhB"}