@hostr/upload 0.1.0

package/dist/node/hasher.d.ts

@@ -0,0 +1,2 @@
+import type { Hasher } from '../core/types.js';
+export declare const nodeHasher: Hasher;

package/dist/node/index.d.ts

@@ -0,0 +1,43 @@
+import type { FileSource, HttpTransport, StateStore } from '../core/types.js';
+import { type Upload } from '../core/upload.js';
+export { createUploadSession, mintUploadToken } from '../api/client.js';
+export { NetworkError, ApiError } from '../api/client.js';
+export { IntegrityError } from '../core/engine.js';
+export { nodeHasher } from './hasher.js';
+export type { Upload } from '../core/upload.js';
+/** Opens `path` and holds the `FileHandle` open for the adapter's lifetime;
+ *  callers must `close()` it when done (createUpload does this implicitly
+ *  never — it hands the FileSource to the engine, which only ever reads).
+ *  Identity is `path:size:mtimeMs-floored` so a relaunch against the same
+ *  file resolves to the same session, and a modified file (different size
+ *  or mtime) correctly starts a fresh one. */
+export declare function nodeFileSource(path: string): Promise<FileSource>;
+/** One file per key under `dir`, created on first write. Keys are sanitized
+ *  to filesystem-safe names — collisions between distinct keys that
+ *  sanitize identically are possible but not a concern in practice (session
+ *  keys are namespaced storage keys, not arbitrary user input). */
+export declare function fileStateStore(dir: string): StateStore;
+/** Default transport: a plain `fetch` PUT. Node's `fetch` exposes no
+ *  upload-progress events, so `onProgress` is documented (not simulated) to
+ *  fire exactly once, with the full body length, after the PUT resolves —
+ *  callers wanting finer-grained progress must supply their own `transport`. */
+export declare function nodeTransport(fetchFn?: typeof fetch): HttpTransport;
+export type CreateUploadOptions = {
+    endpoint: string;
+    uploadToken: string;
+    assetId: string;
+    /** Filesystem path to the file to upload. */
+    file: string;
+    /** Directory for the persisted session; defaults to `${os.tmpdir()}/hostr-upload`. */
+    stateDir?: string;
+    concurrency?: number;
+    checksum?: 'sha256' | 'none';
+    onTokenExpired?: (assetId: string) => Promise<string>;
+    /** Advanced: override the fetch implementation used for API calls and the
+     *  default transport's PUTs. Mainly for tests. */
+    fetchFn?: typeof fetch;
+    /** Advanced: override the PUT transport entirely (e.g. to inject failures
+     *  or corruption in tests) instead of the default `fetch`-based one. */
+    transport?: HttpTransport;
+};
+export declare function createUpload(opts: CreateUploadOptions): Promise<Upload>;