@teepin/sdk 0.2.1 → 0.3.0-rc.1

package/dist/types/storage.d.ts

@@ -1,5 +1,8 @@
 import type { TeepinClient } from './client.js';
+import { ObjectFile } from './direct/reads.js';
+import { DirectUploads } from './direct/uploads.js';
 import { type DownloadOptions, type DownloadSink, type UploadBody, type UploadOptions } from './transfer.js';
+export { ObjectFile } from './direct/reads.js';
 /** A bucket of the project. */
 export interface Bucket {
     id: string;
@@ -61,6 +64,10 @@ export interface PutObjectOptions {
     ifMatch?: string;
     /** Write only if no object is at the key. */
     ifNoneMatch?: boolean;
+    /**
+     * Stops the call. An object a pack has already taken may still be saved: its pack is shared with other putObject
+     * calls, and goes on.
+     */
     signal?: AbortSignal;
 }
 /** An inclusive byte range; end undefined means to the end. */
@@ -68,6 +75,15 @@ export interface ByteRange {
     start: number;
     end?: number;
 }
+export interface DeleteObjectOptions {
+    /**
+     * Delete only if the object still has this ETag (quoted or not; "*" for any object), checked in the same step as the
+     * delete: otherwise PreconditionFailedError (412) and nothing is deleted. A move passes the ETag it checked, so a
+     * write that lands in between survives.
+     */
+    ifMatch?: string;
+    signal?: AbortSignal;
+}
 export interface GetObjectOptions {
     range?: ByteRange;
     /** Resolve to null when the object still has this ETag (304). */
@@ -92,6 +108,12 @@ export interface ObjectResponse extends ObjectInfo {
     bytes(): Promise<Uint8Array>;
     text(): Promise<string>;
 }
+export interface OpenObjectOptions {
+    /** Windows fetched ahead of a reader reading straight on (default 2); up to prefetch + 2 windows are held in memory. */
+    prefetch?: number;
+    /** Aborting it stops every read of the object, as close() does. */
+    signal?: AbortSignal;
+}
 /** One key deleteObjects could not delete. */
 export interface DeleteError {
     key: string;
@@ -103,16 +125,21 @@ export interface DeleteResult {
     deleted: string[];
     errors: DeleteError[];
 }
-/** A link that works without a credential until expiresAt. */
-export interface SignedUrl {
+/**
+ * A share link (section 26): a console page anyone holding url can open, to preview or save the object, until
+ * expiresAt. Its sealed token is url's fragment (<console>/l#<token>), never sent to the console's host.
+ */
+export interface ShareLink {
     url: string;
+    /** The second it stops opening. */
     expiresAt: Date;
 }
-/** A single-use upload link: one successful PUT of url with headers. */
-export interface SignedUpload extends SignedUrl {
-    method: string;
-    headers: Record<string, string>;
-    maxBytes: number;
+export interface CreateLinkOptions {
+    /** Seconds the link opens for: 1 to 86,400 (24 hours); default 900 (15 minutes). */
+    expiresIn?: number;
+    /** "inline" (the default): the page previews the object where it safely can; "attachment": it saves the file. */
+    disposition?: 'inline' | 'attachment';
+    signal?: AbortSignal;
 }
 /** An upload in parts that has not been completed. */
 export interface Upload {
@@ -123,37 +150,44 @@ export interface Upload {
     createdAt: Date;
     /** When it is cancelled if not completed (7 days). */
     expiresAt: Date;
-    /** Filled by listParts. */
-    parts: Part[];
 }
-/** A part the server has received. */
-export interface Part {
-    number: number;
-    size: number;
-    /** The MD5 of the part, in hex; completeUpload needs it. */
-    etag: string;
-    uploadedAt?: Date;
-}
-/** The rules of uploads in parts. */
+/**
+ * Earlier releases' rules for uploads in parts, which partSize and computeETag use to match the ETag of an object
+ * uploaded in parts before the direct path. Uploads now follow the direct path's own rules (at most 3,000 parts).
+ */
 export declare const MIN_PART_SIZE: number;
 export declare const MAX_PART_SIZE: number;
 export declare const MAX_PARTS = 10000;
+/** The largest object Teepin Storage holds (5 TiB). */
 export declare const MAX_OBJECT_SIZE: number;
 export declare function parseObject(raw: unknown): StorageObject;
-export declare function quote(etag: string): string;
 export declare function unquote(etag: string): string;
 /**
- * Teepin Storage. Each method is one API call, named after the route in the
- * API reference (/v1/openapi.json); upload and download are the high-level
- * way to move data of any size.
+ * Teepin Storage: buckets, objects and transfers. upload and download are the
+ * high-level way to move data of any size.
  *
  * Every method sends your API key, so call them from a backend you control.
- * To let a browser download or upload one object without the key, sign a
- * link with presignDownload or presignUpload and hand it only that.
+ *
+ * Reads come straight from the storage network, each byte verified on this
+ * device before it is used (TEEPIN-STORAGE-DESIGN.md section 22.5). Writes are
+ * encrypted on this device and sent straight to the storage network too
+ * (section 22.4): small objects in packs, large ones in parts. No file byte
+ * passes through Teepin's API.
  */
 export declare class StorageService {
     readonly client: TeepinClient;
+    private directReads?;
+    private uploadEngine?;
     constructor(client: TeepinClient);
+    /** Reads through read sessions, made on first use. */
+    private get reads();
+    /**
+     * The direct upload engine, made on first use: putObject's shared packs and the node entry's upload runs. Internal:
+     * @teepin/sdk/node gives it the disk.
+     */
+    get directUploads(): DirectUploads;
+    /** Zeroes the data keys kept for reads (TeepinClient.close calls it). */
+    close(): void;
     private call;
     /** Whether the account's stored data is on hold. */
     getHold(signal?: AbortSignal): Promise<StorageHold>;
@@ -176,18 +210,28 @@ export declare class StorageService {
      */
     objects(bucket: string, prefix?: string, signal?: AbortSignal): AsyncGenerator<StorageObject>;
     /**
-     * Uploads an object in one request (up to 5 GiB). It is retried after a
-     * passing failure. upload handles data of any size.
+     * Stores an object, encrypted on this device: in a pack shared with the other putObject calls waiting at the same
+     * time (up to 16 MiB), or in parts straight to the storage network above that; an empty one is written by the API
+     * alone, with no bytes. The call returns once its object is committed. upload also takes streams.
      */
     putObject(bucket: string, key: string, body: Blob | ArrayBuffer | ArrayBufferView | string, opts?: PutObjectOptions): Promise<StorageObject>;
     /** An object's details without its bytes. */
     statObject(bucket: string, key: string, signal?: AbortSignal): Promise<StorageObject>;
-    /** An object's download headers without its bytes. */
+    /** An object's download headers without its bytes, built from statObject. */
     headObject(bucket: string, key: string, signal?: AbortSignal): Promise<ObjectInfo>;
-    /** Streams an object's bytes, or one range. Resolves to null when ifNoneMatch matched. */
+    /**
+     * Streams an object's bytes, or one range. Resolves to null when ifNoneMatch matched.
+     *
+     * The bytes come from the storage network, each verified before the body yields it (a whole read's SHA-256 as its
+     * last bytes arrive: ChecksumMismatchError), and ifNoneMatch asks the object's details first, so a match signs and
+     * bills nothing. Read the body to its end or cancel it: that frees the read and zeroes its copy of the data key.
+     */
     getObject(bucket: string, key: string, opts?: GetObjectOptions): Promise<ObjectResponse | null>;
-    /** Deletes an object. */
-    deleteObject(bucket: string, key: string, signal?: AbortSignal): Promise<void>;
+    /**
+     * Deletes an object; with ifMatch, only if it still has that ETag (PreconditionFailedError otherwise). An AbortSignal
+     * in place of the options is taken as before.
+     */
+    deleteObject(bucket: string, key: string, opts?: DeleteObjectOptions | AbortSignal): Promise<void>;
     /**
      * Deletes many objects, 1000 to a request; each key succeeds or fails on
      * its own. A key already gone is in errors with code object_not_found.
@@ -201,61 +245,60 @@ export declare class StorageService {
     /**
      * Copies srcBucket/srcKey (any bucket of the project) to bucket/key. The
      * bytes are read and written again, so a copy is billed as a download as
-     * well as the stored copy.
+     * well as the stored copy. The conditions are on the destination.
+     *
+     * The copy is made on this device (section 23.6): the object is read (every
+     * byte verified) and uploaded anew, packed or in parts, streamed under the
+     * upload's memory bound. It keeps the source's content type and metadata.
      */
     copyObject(bucket: string, key: string, srcBucket: string, srcKey: string, opts?: {
         ifMatch?: string;
         ifNoneMatch?: boolean;
         signal?: AbortSignal;
     }): Promise<StorageObject>;
-    /** Signs a link that downloads one object: up to 24 hours (default 15 minutes). */
-    presignDownload(bucket: string, key: string, opts?: {
-        expiresIn?: number;
-        attachment?: boolean;
-        signal?: AbortSignal;
-    }): Promise<SignedUrl>;
-    /** Signs a link a browser can upload one object to, once: up to 1 hour (default 15 minutes), at most maxBytes (default 5 GiB). */
-    presignUpload(bucket: string, key: string, opts?: {
-        expiresIn?: number;
-        maxBytes?: number;
-        contentType?: string;
-        signal?: AbortSignal;
-    }): Promise<SignedUpload>;
-    /** Starts an upload in parts. upload does all of it for you. */
-    createUpload(bucket: string, key: string, opts?: {
-        contentType?: string;
-        metadata?: Record<string, string>;
-        signal?: AbortSignal;
-    }): Promise<Upload>;
-    /** Sends part number (1 to 10000) of an upload; sending a number again replaces it. */
-    uploadPart(bucket: string, uploadId: string, number: number, data: Uint8Array | Blob, signal?: AbortSignal): Promise<Part>;
-    /** An upload and the parts received so far, in order. */
-    listParts(bucket: string, uploadId: string, signal?: AbortSignal): Promise<Upload>;
+    /**
+     * Makes a share link to an object that exists now: a console page anyone holding it can open with no sign-in, to
+     * preview or save the object, until it expires. It opens whatever is at the key when it is opened, and stops opening
+     * when the object is deleted or the account's stored data is on hold. The link carries its own credential, so share
+     * it only with those who may read the object. openLink opens one in code.
+     */
+    createLink(bucket: string, key: string, opts?: CreateLinkOptions): Promise<ShareLink>;
     /** A bucket's open uploads under prefix, oldest first. */
     listUploads(bucket: string, prefix?: string, signal?: AbortSignal): Promise<Upload[]>;
-    /** Assembles the parts named, in ascending order, into the object. */
-    completeUpload(bucket: string, uploadId: string, parts: {
-        number: number;
-        etag: string;
-    }[], signal?: AbortSignal): Promise<StorageObject>;
     /** Cancels an upload and drops its parts. */
     abortUpload(bucket: string, uploadId: string, signal?: AbortSignal): Promise<void>;
     /**
-     * Stores data at bucket/key: in one request up to 16 MiB, in parallel parts
-     * above that. Each part is retried on its own, and the stored object's
-     * ETag is checked against the bytes sent.
+     * Stores data at bucket/key, encrypted on this device: packed (shared with putObject's calls) up to 16 MiB, in
+     * parallel parts straight to the storage network above that, and a stream of unknown size read a part ahead and sent
+     * as it is read (its parts held in memory: at most (concurrency + 3) of them). Each part is retried on its own.
      *
      * ```ts
      * await teepin.storage.upload('my-bucket', 'videos/a.mp4', file, { onProgress: (done, total) => {} });
      * ```
      */
     upload(bucket: string, key: string, body: UploadBody, opts?: UploadOptions): Promise<StorageObject>;
-    /** Downloads an object into memory, large ones as parallel ranges, checked against its SHA-256. */
+    /**
+     * Downloads an object into memory, as parallel ranges: the storage network's read windows, every byte verified before
+     * it is written, and the whole object checked against its SHA-256 (a mismatch is tried once more before
+     * ChecksumMismatchError).
+     */
     download(bucket: string, key: string, opts?: DownloadOptions): Promise<{
         object: StorageObject;
         data: Uint8Array;
     }>;
-    /** Downloads an object into sink (a file, in @teepin/sdk/node), as parallel ranges pinned to one version. */
+    /**
+     * Downloads an object into sink (a file, in @teepin/sdk/node), as parallel ranges pinned to one version. Every byte is
+     * verified before it is written (the whole object's SHA-256 too, when it is read in one range).
+     */
     downloadTo(bucket: string, key: string, sink: DownloadSink, opts?: DownloadOptions): Promise<StorageObject>;
+    /**
+     * Opens an object for reading at any offset: read(offset, length), size, info and close(). Reading straight on
+     * fetches a window at a time (64 MiB on the storage network) with the next prefetch windows ahead, so up to
+     * prefetch + 2 windows are held in memory; a read somewhere else fetches only what it needs. Every byte is verified
+     * before it is read, and every window comes from the version first opened: ObjectChangedError if the object is
+     * replaced while it is read. Close it when done: that zeroes its copy of the data key.
+     */
+    openObject(bucket: string, key: string, opts?: OpenObjectOptions): Promise<ObjectFile>;
+    private downloadParams;
 }
 //# sourceMappingURL=storage.d.ts.map

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

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

package/dist/types/transfer.d.ts

@@ -1,5 +1,4 @@
-import { type StorageObject, type StorageService } from './storage.js';
-/** The part size of uploads in parts and of parallel download ranges. */
+/** The part size of uploads in parts, unless asked for. */
 export declare const DEFAULT_PART_SIZE: number;
 /** upload sends larger data in parts. */
 export declare const MULTIPART_THRESHOLD: number;
@@ -17,22 +16,21 @@ export type UploadBody = string | ArrayBuffer | ArrayBufferView | Blob | UploadS
 export interface UploadOptions {
     contentType?: string;
     metadata?: Record<string, string>;
-    /** Bytes per part (default 16 MiB, at least 5 MiB). */
+    /** Bytes per part (default 16 MiB, or 64 MiB for a stream with no expectedSize; at least 5 MiB). */
     partSize?: number;
-    /** Parts sent at once (default 8). */
+    /** A stream's parts sent at once (default 4); other uploads follow the client's uploadConcurrency. */
     concurrency?: number;
     /** Bytes sent so far and the total (-1 for a stream); advances as parts finish. */
     onProgress?: (done: number, total: number) => void;
     /**
-     * Continue an earlier, unfinished upload of the same key: parts the server
-     * already holds are skipped when their MD5 matches. A failed upload is then
-     * left open (for 7 days) to be resumed, instead of cancelled.
+     * A stream's expected size in bytes, a hint: it chooses the part size, so a stream larger than 3,000 of the default
+     * 64 MiB parts can be sent.
      */
-    resume?: boolean;
+    expectedSize?: number;
     signal?: AbortSignal;
 }
 export interface DownloadOptions {
-    /** Bytes per range fetched at once (default 16 MiB). */
+    /** Bytes per range fetched at once. Ranges are the storage network's read windows (64 MiB), which a smaller partSize splits. */
     partSize?: number;
     /** Ranges fetched at once (default 8). */
     concurrency?: number;
@@ -46,27 +44,20 @@ export interface DownloadSink {
     write(offset: number, data: Uint8Array): void | Promise<void>;
 }
 /**
- * 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 declare function partSize(size: number, want?: number): number;
 /** The SHA-256 of data, in hex. */
 export declare function sha256Hex(data: Uint8Array): Promise<string>;
 /**
- * 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 declare function computeETag(source: UploadSource, partBytes: number, parts: number): Promise<string>;
 /** An UploadSource over bytes or a Blob. */
 export declare function sourceOf(body: Exclude<UploadBody, ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>>): UploadSource;
-export declare function upload(s: StorageService, bucket: string, key: string, body: UploadBody, opts?: UploadOptions): Promise<StorageObject>;
-/** Downloads into memory and checks objects stored in one request against their SHA-256. For large files use downloadTo. */
-export declare function download(s: StorageService, bucket: string, key: string, opts?: DownloadOptions): Promise<{
-    object: StorageObject;
-    data: Uint8Array;
-}>;
-/** 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 declare function downloadTo(s: StorageService, bucket: string, key: string, sink: DownloadSink, opts?: DownloadOptions): Promise<StorageObject>;
 //# sourceMappingURL=transfer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/transfer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/transfer.ts"],"names":[],"mappings":"AAUA,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,QAAe,CAAC;AAC9C,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,QAAe,CAAC;AAChD,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3D;AAED,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,IAAI,GAAG,YAAY,GAAG,cAAc,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AAE/I,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,gIAAgI;IAChI,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CAIvD;AAID,mCAAmC;AACnC,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjE;AAYD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzG;AAED,4CAA4C;AAC5C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,YAAY,CAYxH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teepin/sdk",
-  "version": "0.2.1",
+  "version": "0.3.0-rc.1",
   "description": "Official TypeScript/JavaScript SDK for Teepin Web Services: Teepin Inference (AI models in confidential enclaves, OpenAI-compatible) and Teepin Storage, for Node 20+ and browsers",
   "files": [
     "dist",
@@ -10,7 +10,7 @@
   "scripts": {
     "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/package-types.mjs",
     "prepare": "npm run build",
-    "test": "npm run build && node --test test/storage.test.mjs test/inference.test.mjs test/config.test.mjs",
+    "test": "npm run build && node --test test/storage.test.mjs test/inference.test.mjs test/config.test.mjs test/formats.test.mjs test/fake-direct.test.mjs test/engine.test.mjs test/journal.test.mjs test/sha256.test.mjs test/reads.test.mjs test/downloads.test.mjs test/uploads.test.mjs test/uploads-large.test.mjs test/upload-journal.test.mjs test/links.test.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.examples.json"
   },
   "keywords": [