@cardanowall/sdk-ts 0.2.0 → 0.4.0

package/dist/client/index.d.cts

@@ -1,8 +1,8 @@
 import { PoeRecord, SigEntry } from '@cardanowall/poe-standard';
-import { F as FetchImpl, A as AccountBalance, Q as QuoteInput, q as QuoteResponse, B as UploadsInput, D as UploadsResponse, k as PublishInput, o as PublishResponse, f as PublishBatchInput, g as PublishBatchResponse, j as PublishContentInput, n as PublishPrehashedInput, p as PublishSealedInput, l as PublishMerkleInput, m as PublishMerkleResponse, u as RecordsListInput, v as RecordsListResponse, R as RecordResource, b as PoeVerifyInput, L as Label309ClientConfig, y as UploadFailureEntry } from '../types-DGsZTMuZ.cjs';
-export { C as ConformanceProfile, P as PoeItemResponse, a as PoeStatus, c as PublishBatchEntry, d as PublishBatchFailureEntry, e as PublishBatchFailureError, h as PublishBatchResultEntry, i as PublishBatchSuccessEntry, r as RecordScheme, s as RecordSignature, t as RecordStatus, S as Signer, w as StorageTarget, x as SupportedHashAlg, U as UploadEntry, z as UploadSuccessEntry } from '../types-DGsZTMuZ.cjs';
-import { g as VerifyReport } from '../types-CLXdbjqr.cjs';
-import '../fetch-outbound-BT5-NiYN.cjs';
+import { F as FetchImpl, A as AccountBalance, Q as QuoteInput, q as QuoteResponse, a0 as UploadsInput, a1 as UploadsResponse, K as UploadResumableInput, M as UploadResumableResult, k as PublishInput, o as PublishResponse, f as PublishBatchInput, g as PublishBatchResponse, j as PublishContentInput, n as PublishPrehashedInput, p as PublishSealedInput, l as PublishMerkleInput, m as PublishMerkleResponse, u as RecordsListInput, v as RecordsListResponse, R as RecordResource, b as PoeVerifyInput, L as Label309ClientConfig, J as UploadFailureEntry } from '../types-Dp4wUSFI.cjs';
+export { C as ConformanceProfile, P as PoeItemResponse, a as PoeStatus, c as PublishBatchEntry, d as PublishBatchFailureEntry, e as PublishBatchFailureError, h as PublishBatchResultEntry, i as PublishBatchSuccessEntry, r as RecordScheme, s as RecordSignature, t as RecordStatus, w as ResumableSource, x as ResumableSourceInput, S as Signer, y as StorageTarget, z as SupportedHashAlg, U as UploadAttemptCommitted, B as UploadAttemptReleaseReason, D as UploadAttemptReleased, E as UploadAttemptReserved, G as UploadAttemptState, H as UploadAttemptStatus, I as UploadEntry, N as UploadSessionAcceptedResponse, O as UploadSessionChunkResponse, T as UploadSessionCompleteResponse, V as UploadSessionCompletedResponse, W as UploadSessionCreateRequest, X as UploadSessionCreateResponse, Y as UploadSessionDeduplicatedResponse, Z as UploadSessionState, _ as UploadSessionStatus, $ as UploadSuccessEntry, a2 as toResumableSource } from '../types-Dp4wUSFI.cjs';
+import { g as VerifyReport } from '../types-Cexm4VH9.cjs';
+import '../fetch-outbound-dOK3ZxYa.cjs';
 
 type OffHostSignErrorCode = 'INVALID_PUBKEY_LENGTH' | 'INVALID_SIGNATURE_LENGTH';
 declare class OffHostSignError extends Error {
@@ -98,6 +98,36 @@ declare class PoeNamespace {
      * file as a `PartialUploadError`.
      */
     uploads(input: UploadsInput): Promise<UploadsResponse>;
+    /**
+     * Upload a single file of any size, choosing the ingress path by size.
+     *
+     * A file at or below `threshold` (default ~48 MiB) is sent with the unchanged
+     * single-shot `uploads()` multipart call. A larger file is uploaded as a
+     * resumable, content-addressed session: the helper streams the whole-file
+     * SHA-256 once (never buffering a multi-GB file), creates a session, PUTs each
+     * chunk (several in parallel, retrying a failed chunk), then completes —
+     * polling the shared attempt endpoint when completion is accepted
+     * asynchronously. Both paths converge on one `ar://` URI.
+     *
+     * The chunk size is the server's authoritative `chunk_bytes` from the create
+     * response, clamped to its `max_chunk_bytes` ceiling; the client's `chunkBytes`
+     * is only a request. A create-time dedup hit returns the existing URI without
+     * uploading; a `402` funding error is surfaced as a typed error.
+     *
+     * The `source` works in both runtimes: a `Blob`/`File` in the browser, a
+     * `Uint8Array`, a filesystem path string, or a pre-adapted `ResumableSource`
+     * on the server. To resume an interrupted upload, pass the prior `sessionId`;
+     * the helper GETs its status and uploads only the missing chunks.
+     */
+    uploadResumable(input: UploadResumableInput): Promise<UploadResumableResult>;
+    /**
+     * Upload exactly one blob via the single-shot multipart route and resolve its
+     * `ar://` URI. Backs the small-file branch of `uploadResumable`; it shares the
+     * `uploads()` wire shape but takes one blob and an optional abort signal, and
+     * surfaces a per-file failure as a `PartialUploadError` (the resumable helper
+     * promises a single resolved URI, unlike the raw `uploads()` passthrough).
+     */
+    private readonly singleShotUpload;
     /**
      * Submit a single finalised canonical-CBOR record to Cardano. Caller is
      * responsible for constructing the record bytes (use `publishContent` /
@@ -226,6 +256,13 @@ declare class PartialUploadError extends Error {
     get failedIndices(): ReadonlyArray<number>;
 }
 
+declare const DEFAULT_RESUMABLE_THRESHOLD_BYTES = 50331648;
+declare const DEFAULT_RESUMABLE_CHUNK_BYTES = 50331648;
+declare class ResumableUploadError extends Error {
+    readonly code: 'SHA256_MISMATCH' | 'SESSION_FAILED' | 'ATTEMPT_FAILED' | 'ATTEMPT_POLL_TIMEOUT' | 'CHUNK_UPLOAD_FAILED' | 'ABORTED';
+    constructor(code: ResumableUploadError['code'], message: string);
+}
+
 /** RFC 7807 per-field error entry. */
 interface ProblemErrorEntry {
     /** Dotted JSON path of the offending field; empty for body-level errors. */
@@ -394,4 +431,4 @@ interface ParseHttpErrorArgs {
 }
 declare function parseHttpError(args: ParseHttpErrorArgs): Label309HttpError;
 
-export { AccountBalance, AccountNamespace, type AssembleCoseSign1Args, type AssembleCoseSign1Result, BatchEmptyError, BatchTooLargeError, FetchImpl, ForbiddenError, IdempotencyConflictError, InsufficientFundsError, InsufficientScopeError, InternalServerError, InvalidBodyError, InvalidClientConfigError, Label309Client, Label309ClientConfig, Label309HttpError, type Label309HttpErrorInit, MalformedCborError, NotFoundError, OffHostSignError, type OffHostSignErrorCode, PartialUploadError, PoeNamespace, PoeVerifyInput, type PrepareSigStructureArgs, type PrepareSigStructureHashedResult, type PrepareSigStructureResult, type ProblemDetails, type ProblemErrorEntry, PublishBatchInput, PublishBatchResponse, PublishContentInput, PublishError, PublishInput, PublishMerkleInput, PublishMerkleResponse, PublishPrehashedInput, PublishResponse, PublishSealedInput, QuoteAlreadyConsumedError, QuoteExpiredError, QuoteInput, QuoteNotFoundError, QuoteResponse, RateLimitedError, RecordNotFoundError, RecordResource, RecordsListInput, RecordsListResponse, RecordsNamespace, ServiceUnavailableError, UnauthorizedError, UploadFailureEntry, UploadsInput, UploadsResponse, ValidationFailedError, assembleCoseSign1, assembleCoseSign1Hashed, buildToSign, parseHttpError, prepareSigStructure, prepareSigStructureHashed };
+export { AccountBalance, AccountNamespace, type AssembleCoseSign1Args, type AssembleCoseSign1Result, BatchEmptyError, BatchTooLargeError, DEFAULT_RESUMABLE_CHUNK_BYTES, DEFAULT_RESUMABLE_THRESHOLD_BYTES, FetchImpl, ForbiddenError, IdempotencyConflictError, InsufficientFundsError, InsufficientScopeError, InternalServerError, InvalidBodyError, InvalidClientConfigError, Label309Client, Label309ClientConfig, Label309HttpError, type Label309HttpErrorInit, MalformedCborError, NotFoundError, OffHostSignError, type OffHostSignErrorCode, PartialUploadError, PoeNamespace, PoeVerifyInput, type PrepareSigStructureArgs, type PrepareSigStructureHashedResult, type PrepareSigStructureResult, type ProblemDetails, type ProblemErrorEntry, PublishBatchInput, PublishBatchResponse, PublishContentInput, PublishError, PublishInput, PublishMerkleInput, PublishMerkleResponse, PublishPrehashedInput, PublishResponse, PublishSealedInput, QuoteAlreadyConsumedError, QuoteExpiredError, QuoteInput, QuoteNotFoundError, QuoteResponse, RateLimitedError, RecordNotFoundError, RecordResource, RecordsListInput, RecordsListResponse, RecordsNamespace, ResumableUploadError, ServiceUnavailableError, UnauthorizedError, UploadFailureEntry, UploadResumableInput, UploadResumableResult, UploadsInput, UploadsResponse, ValidationFailedError, assembleCoseSign1, assembleCoseSign1Hashed, buildToSign, parseHttpError, prepareSigStructure, prepareSigStructureHashed };

package/dist/client/index.d.ts

@@ -1,8 +1,8 @@
 import { PoeRecord, SigEntry } from '@cardanowall/poe-standard';
-import { F as FetchImpl, A as AccountBalance, Q as QuoteInput, q as QuoteResponse, B as UploadsInput, D as UploadsResponse, k as PublishInput, o as PublishResponse, f as PublishBatchInput, g as PublishBatchResponse, j as PublishContentInput, n as PublishPrehashedInput, p as PublishSealedInput, l as PublishMerkleInput, m as PublishMerkleResponse, u as RecordsListInput, v as RecordsListResponse, R as RecordResource, b as PoeVerifyInput, L as Label309ClientConfig, y as UploadFailureEntry } from '../types-DGsZTMuZ.js';
-export { C as ConformanceProfile, P as PoeItemResponse, a as PoeStatus, c as PublishBatchEntry, d as PublishBatchFailureEntry, e as PublishBatchFailureError, h as PublishBatchResultEntry, i as PublishBatchSuccessEntry, r as RecordScheme, s as RecordSignature, t as RecordStatus, S as Signer, w as StorageTarget, x as SupportedHashAlg, U as UploadEntry, z as UploadSuccessEntry } from '../types-DGsZTMuZ.js';
-import { g as VerifyReport } from '../types-B8Q3gW54.js';
-import '../fetch-outbound-BT5-NiYN.js';
+import { F as FetchImpl, A as AccountBalance, Q as QuoteInput, q as QuoteResponse, a0 as UploadsInput, a1 as UploadsResponse, K as UploadResumableInput, M as UploadResumableResult, k as PublishInput, o as PublishResponse, f as PublishBatchInput, g as PublishBatchResponse, j as PublishContentInput, n as PublishPrehashedInput, p as PublishSealedInput, l as PublishMerkleInput, m as PublishMerkleResponse, u as RecordsListInput, v as RecordsListResponse, R as RecordResource, b as PoeVerifyInput, L as Label309ClientConfig, J as UploadFailureEntry } from '../types-Dp4wUSFI.js';
+export { C as ConformanceProfile, P as PoeItemResponse, a as PoeStatus, c as PublishBatchEntry, d as PublishBatchFailureEntry, e as PublishBatchFailureError, h as PublishBatchResultEntry, i as PublishBatchSuccessEntry, r as RecordScheme, s as RecordSignature, t as RecordStatus, w as ResumableSource, x as ResumableSourceInput, S as Signer, y as StorageTarget, z as SupportedHashAlg, U as UploadAttemptCommitted, B as UploadAttemptReleaseReason, D as UploadAttemptReleased, E as UploadAttemptReserved, G as UploadAttemptState, H as UploadAttemptStatus, I as UploadEntry, N as UploadSessionAcceptedResponse, O as UploadSessionChunkResponse, T as UploadSessionCompleteResponse, V as UploadSessionCompletedResponse, W as UploadSessionCreateRequest, X as UploadSessionCreateResponse, Y as UploadSessionDeduplicatedResponse, Z as UploadSessionState, _ as UploadSessionStatus, $ as UploadSuccessEntry, a2 as toResumableSource } from '../types-Dp4wUSFI.js';
+import { g as VerifyReport } from '../types-CgoBub9J.js';
+import '../fetch-outbound-dOK3ZxYa.js';
 
 type OffHostSignErrorCode = 'INVALID_PUBKEY_LENGTH' | 'INVALID_SIGNATURE_LENGTH';
 declare class OffHostSignError extends Error {
@@ -98,6 +98,36 @@ declare class PoeNamespace {
      * file as a `PartialUploadError`.
      */
     uploads(input: UploadsInput): Promise<UploadsResponse>;
+    /**
+     * Upload a single file of any size, choosing the ingress path by size.
+     *
+     * A file at or below `threshold` (default ~48 MiB) is sent with the unchanged
+     * single-shot `uploads()` multipart call. A larger file is uploaded as a
+     * resumable, content-addressed session: the helper streams the whole-file
+     * SHA-256 once (never buffering a multi-GB file), creates a session, PUTs each
+     * chunk (several in parallel, retrying a failed chunk), then completes —
+     * polling the shared attempt endpoint when completion is accepted
+     * asynchronously. Both paths converge on one `ar://` URI.
+     *
+     * The chunk size is the server's authoritative `chunk_bytes` from the create
+     * response, clamped to its `max_chunk_bytes` ceiling; the client's `chunkBytes`
+     * is only a request. A create-time dedup hit returns the existing URI without
+     * uploading; a `402` funding error is surfaced as a typed error.
+     *
+     * The `source` works in both runtimes: a `Blob`/`File` in the browser, a
+     * `Uint8Array`, a filesystem path string, or a pre-adapted `ResumableSource`
+     * on the server. To resume an interrupted upload, pass the prior `sessionId`;
+     * the helper GETs its status and uploads only the missing chunks.
+     */
+    uploadResumable(input: UploadResumableInput): Promise<UploadResumableResult>;
+    /**
+     * Upload exactly one blob via the single-shot multipart route and resolve its
+     * `ar://` URI. Backs the small-file branch of `uploadResumable`; it shares the
+     * `uploads()` wire shape but takes one blob and an optional abort signal, and
+     * surfaces a per-file failure as a `PartialUploadError` (the resumable helper
+     * promises a single resolved URI, unlike the raw `uploads()` passthrough).
+     */
+    private readonly singleShotUpload;
     /**
      * Submit a single finalised canonical-CBOR record to Cardano. Caller is
      * responsible for constructing the record bytes (use `publishContent` /
@@ -226,6 +256,13 @@ declare class PartialUploadError extends Error {
     get failedIndices(): ReadonlyArray<number>;
 }
 
+declare const DEFAULT_RESUMABLE_THRESHOLD_BYTES = 50331648;
+declare const DEFAULT_RESUMABLE_CHUNK_BYTES = 50331648;
+declare class ResumableUploadError extends Error {
+    readonly code: 'SHA256_MISMATCH' | 'SESSION_FAILED' | 'ATTEMPT_FAILED' | 'ATTEMPT_POLL_TIMEOUT' | 'CHUNK_UPLOAD_FAILED' | 'ABORTED';
+    constructor(code: ResumableUploadError['code'], message: string);
+}
+
 /** RFC 7807 per-field error entry. */
 interface ProblemErrorEntry {
     /** Dotted JSON path of the offending field; empty for body-level errors. */
@@ -394,4 +431,4 @@ interface ParseHttpErrorArgs {
 }
 declare function parseHttpError(args: ParseHttpErrorArgs): Label309HttpError;
 
-export { AccountBalance, AccountNamespace, type AssembleCoseSign1Args, type AssembleCoseSign1Result, BatchEmptyError, BatchTooLargeError, FetchImpl, ForbiddenError, IdempotencyConflictError, InsufficientFundsError, InsufficientScopeError, InternalServerError, InvalidBodyError, InvalidClientConfigError, Label309Client, Label309ClientConfig, Label309HttpError, type Label309HttpErrorInit, MalformedCborError, NotFoundError, OffHostSignError, type OffHostSignErrorCode, PartialUploadError, PoeNamespace, PoeVerifyInput, type PrepareSigStructureArgs, type PrepareSigStructureHashedResult, type PrepareSigStructureResult, type ProblemDetails, type ProblemErrorEntry, PublishBatchInput, PublishBatchResponse, PublishContentInput, PublishError, PublishInput, PublishMerkleInput, PublishMerkleResponse, PublishPrehashedInput, PublishResponse, PublishSealedInput, QuoteAlreadyConsumedError, QuoteExpiredError, QuoteInput, QuoteNotFoundError, QuoteResponse, RateLimitedError, RecordNotFoundError, RecordResource, RecordsListInput, RecordsListResponse, RecordsNamespace, ServiceUnavailableError, UnauthorizedError, UploadFailureEntry, UploadsInput, UploadsResponse, ValidationFailedError, assembleCoseSign1, assembleCoseSign1Hashed, buildToSign, parseHttpError, prepareSigStructure, prepareSigStructureHashed };
+export { AccountBalance, AccountNamespace, type AssembleCoseSign1Args, type AssembleCoseSign1Result, BatchEmptyError, BatchTooLargeError, DEFAULT_RESUMABLE_CHUNK_BYTES, DEFAULT_RESUMABLE_THRESHOLD_BYTES, FetchImpl, ForbiddenError, IdempotencyConflictError, InsufficientFundsError, InsufficientScopeError, InternalServerError, InvalidBodyError, InvalidClientConfigError, Label309Client, Label309ClientConfig, Label309HttpError, type Label309HttpErrorInit, MalformedCborError, NotFoundError, OffHostSignError, type OffHostSignErrorCode, PartialUploadError, PoeNamespace, PoeVerifyInput, type PrepareSigStructureArgs, type PrepareSigStructureHashedResult, type PrepareSigStructureResult, type ProblemDetails, type ProblemErrorEntry, PublishBatchInput, PublishBatchResponse, PublishContentInput, PublishError, PublishInput, PublishMerkleInput, PublishMerkleResponse, PublishPrehashedInput, PublishResponse, PublishSealedInput, QuoteAlreadyConsumedError, QuoteExpiredError, QuoteInput, QuoteNotFoundError, QuoteResponse, RateLimitedError, RecordNotFoundError, RecordResource, RecordsListInput, RecordsListResponse, RecordsNamespace, ResumableUploadError, ServiceUnavailableError, UnauthorizedError, UploadFailureEntry, UploadResumableInput, UploadResumableResult, UploadsInput, UploadsResponse, ValidationFailedError, assembleCoseSign1, assembleCoseSign1Hashed, buildToSign, parseHttpError, prepareSigStructure, prepareSigStructureHashed };