@ardrive/turbo-sdk 1.42.0 → 1.43.0-alpha.2

package/lib/types/common/chunked.d.ts

@@ -1,5 +1,5 @@
 import { Readable } from 'stream';
-import { ByteCount, TurboChunkingMode, TurboLogger, TurboUploadDataItemResponse, UploadSignedDataItemParams } from '../types.js';
+import { ByteCount, TurboChunkingMode, TurboLogger, TurboUploadDataItemResponse, UploadSignedDataItemParams, X402RequestCredentials } from '../types.js';
 import { TurboHTTPService } from './http.js';
 export declare const defaultMaxChunkConcurrency = 5;
 export declare const maxChunkByteCount: number;
@@ -13,12 +13,32 @@ export declare class ChunkedUploader {
     private chunkByteCount;
     private readonly maxChunkConcurrency;
     private readonly maxFinalizeMs;
+    /**
+     * The upload id of an x402 upload we have ALREADY PAID FOR.
+     *
+     * `uploadFile` retries a failed upload up to 6 times, and a retry re-enters
+     * `upload()` on this same instance. Without this memo each retry opens a
+     * NEW paid upload, so one 12 MiB upload whose finalization timed out billed
+     * the customer five times over — observed, not theoretical. The payment is
+     * bound to an upload id, so a retry must resume THAT upload, never buy
+     * another. Deliberately not reset on failure: re-paying is never the right
+     * recovery, and an upload that cannot be resumed is refunded server-side.
+     */
+    private paidUploadId;
     private readonly http;
     private readonly token;
     private readonly logger;
     readonly shouldUseChunkUploader: boolean;
     private maxBacklogQueue;
-    constructor({ http, token, maxChunkConcurrency, maxFinalizeMs, chunkByteCount, logger, chunkingMode, dataItemByteCount, }: {
+    private x402;
+    private x402RefundIdentity;
+    /**
+     * The size declared at create. For x402 this is what gets PAID FOR, so it
+     * must be the real serialized size — the service reconciles against the bytes
+     * that actually arrive and penalises an under-declaration.
+     */
+    private dataItemByteCount;
+    constructor({ http, token, maxChunkConcurrency, maxFinalizeMs, chunkByteCount, logger, chunkingMode, dataItemByteCount, x402, x402RefundIdentity, }: {
         maxFinalizeMs?: number;
         http: TurboHTTPService;
         token: string;
@@ -27,12 +47,37 @@ export declare class ChunkedUploader {
         maxChunkConcurrency?: number;
         chunkingMode?: TurboChunkingMode;
         dataItemByteCount: ByteCount;
+        /** Pay for this upload with x402 instead of Turbo Credits. */
+        x402?: X402RequestCredentials;
+        /**
+         * The TURBO wallet credited if the upload delivers fewer bytes than were
+         * paid for. Deliberately not derived from the x402 signer: the wallet that
+         * PAYS in USDC and the wallet that receives Turbo Credits are allowed to
+         * differ, and silently conflating them would send a refund to the wrong
+         * place.
+         */
+        x402RefundIdentity?: {
+            address: string;
+            signatureType: number;
+        };
     });
     private shouldChunkUpload;
     private assertChunkParams;
     /**
      * Initialize or resume an upload session, returning the upload ID.
      */
+    /**
+     * Open a multipart upload paid for with x402.
+     *
+     * The bundler settles the payment at CREATE, before accepting a single chunk
+     * — so an unpaid upload never consumes storage. That is why the size is
+     * declared here and the money moves here, not at finalize.
+     *
+     * The 402 handshake is delegated to `wrapFetchWithPayment`, the same
+     * mechanism the single-shot x402 POST already uses, so the signer and the
+     * spend cap behave identically on both paths.
+     */
+    private initPaidUpload;
     private initUpload;
     upload({ dataItemSizeFactory, dataItemStreamFactory, dataItemOpts, signal, events, }: UploadSignedDataItemParams): Promise<TurboUploadDataItemResponse>;
     private toGiB;

package/lib/types/common/chunked.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunked.d.ts","sourceRoot":"","sources":["../../../src/common/chunked.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,EACL,SAAS,EAET,iBAAiB,EACjB,WAAW,EAEX,2BAA2B,EAC3B,0BAA0B,EAG3B,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAK7C,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAK5C,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAChD,eAAO,MAAM,iBAAiB,QAAU,CAAC;AACzC,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAKvD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC,SAAgB,sBAAsB,EAAE,OAAO,CAAC;IAChD,OAAO,CAAC,eAAe,CAAS;gBAEpB,EACV,IAAI,EACJ,KAAK,EACL,mBAAgD,EAChD,aAAa,EACb,cAAsC,EACtC,MAAuB,EACvB,YAAqB,EACrB,iBAAiB,GAClB,EAAE;QACD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,gBAAgB,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,YAAY,CAAC,EAAE,iBAAiB,CAAC;QACjC,iBAAiB,EAAE,SAAS,CAAC;KAC9B;IAqBD,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,iBAAiB;IAwDzB;;OAEG;YACW,UAAU;IAqBX,MAAM,CAAC,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,MAAM,EACN,MAAM,GACP,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAwHpE,OAAO,CAAC,KAAK;YAIC,cAAc;CAoG7B;AAED;;;GAGG;AACH,wBAAuB,eAAe,CACpC,MAAM,EAAE,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,EAC7C,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAMvC;AACD,wBAAuB,uBAAuB,CAC5C,MAAM,EAAE,QAAQ,EAChB,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAkDvC;AAED,wBAAuB,6BAA6B,CAClD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAyDvC"}
+{"version":3,"file":"chunked.d.ts","sourceRoot":"","sources":["../../../src/common/chunked.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,EACL,SAAS,EAET,iBAAiB,EACjB,WAAW,EAEX,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EAGvB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAK7C,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAK5C,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAChD,eAAO,MAAM,iBAAiB,QAAU,CAAC;AACzC,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAKvD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAEnD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC,SAAgB,sBAAsB,EAAE,OAAO,CAAC;IAChD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,kBAAkB,CAEZ;IACd;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAAY;gBAEzB,EACV,IAAI,EACJ,KAAK,EACL,mBAAgD,EAChD,aAAa,EACb,cAAsC,EACtC,MAAuB,EACvB,YAAqB,EACrB,iBAAiB,EACjB,IAAI,EACJ,kBAAkB,GACnB,EAAE;QACD,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,gBAAgB,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,YAAY,CAAC,EAAE,iBAAiB,CAAC;QACjC,iBAAiB,EAAE,SAAS,CAAC;QAC7B,8DAA8D;QAC9D,IAAI,CAAC,EAAE,sBAAsB,CAAC;QAC9B;;;;;;WAMG;QACH,kBAAkB,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC;KACjE;IAwBD,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,iBAAiB;IAwDzB;;OAEG;IACH;;;;;;;;;;OAUG;YACW,cAAc;YAwCd,UAAU;IAwBX,MAAM,CAAC,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,MAAM,EACN,MAAM,GACP,EAAE,0BAA0B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAwHpE,OAAO,CAAC,KAAK;YAIC,cAAc;CAoG7B;AAED;;;GAGG;AACH,wBAAuB,eAAe,CACpC,MAAM,EAAE,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,EAC7C,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAMvC;AACD,wBAAuB,uBAAuB,CAC5C,MAAM,EAAE,QAAQ,EAChB,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAkDvC;AAED,wBAAuB,6BAA6B,CAClD,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAyDvC"}

package/lib/types/common/folderIndex.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ChainFolderUploadIndexParams, ComposeFolderUploadIndexParams, TurboFolderUploadIndex } from '../types.js';
+/**
+ * An in-memory folder index.
+ *
+ * On its own it only deduplicates identical files within a single
+ * `uploadFolder` call, which `uploadFolder` already does. Its real use is as
+ * the writable floor of a {@link composeFolderIndex} stack, or seeded from a
+ * mapping the caller persisted itself.
+ */
+export declare function createMemoryFolderIndex(seed?: Record<string, string>): TurboFolderUploadIndex;
+/**
+ * Rebuilds a folder index by sweeping the uploader's own past uploads over a
+ * gateway's GraphQL endpoint, filtering on the `File-SHA256` tag that
+ * index-backed uploads always write.
+ *
+ * Read only, and the only layer that survives a fresh checkout on a machine
+ * that has never deployed before -- a CI runner, most obviously.
+ *
+ * Known limitation: gateways index an upload minutes after it lands, so two
+ * machines deploying the same new file at the same moment will each pay for it
+ * once. The manifest is correct either way; only the bill is affected, and only
+ * for genuinely new bytes.
+ */
+export declare function createChainFolderIndex({ owner, appName, gatewayUrl, hashTagName, maxPages, pageSize, timeoutMs, fetchImpl, logger, }: ChainFolderUploadIndexParams): TurboFolderUploadIndex;
+/**
+ * Layers folder indexes: reads fall through in order, writes go to every layer
+ * that is not read only.
+ *
+ * The usual stack is a local cache in front of a chain index -- the cache
+ * answers instantly on a developer machine, and the chain index is what a CI
+ * runner with an empty working directory falls back to.
+ *
+ * A layer that throws is skipped, not propagated. That is the whole point of
+ * stacking them: a full disk under the file layer must not stop the memory
+ * layer from holding ids the run has already paid for, and an unreachable
+ * gateway must not stop the local cache from answering.
+ */
+export declare function composeFolderIndex(layers: (TurboFolderUploadIndex | undefined)[], { logger }?: ComposeFolderUploadIndexParams): TurboFolderUploadIndex;
+//# sourceMappingURL=folderIndex.d.ts.map

package/lib/types/common/folderIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folderIndex.d.ts","sourceRoot":"","sources":["../../../src/common/folderIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAEL,4BAA4B,EAC5B,8BAA8B,EAC9B,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAkIrB;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAChC,sBAAsB,CAmBxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,OAAO,EACP,UAAkC,EAClC,WAAgC,EAChC,QAAa,EACb,QAAc,EACd,SAAkB,EAClB,SAAiB,EACjB,MAAM,GACP,EAAE,4BAA4B,GAAG,sBAAsB,CAkLvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,CAAC,sBAAsB,GAAG,SAAS,CAAC,EAAE,EAC9C,EAAE,MAAM,EAAE,GAAE,8BAAmC,GAC9C,sBAAsB,CAsIxB"}

package/lib/types/common/http.d.ts

@@ -21,6 +21,18 @@ export interface RetryConfig {
     onRetry: (retryCount: number, error: unknown) => void;
 }
 export declare const defaultRetryConfig: (logger?: TurboLogger) => RetryConfig;
+/**
+ * Canonical x402 upload routes on the upload service.
+ *
+ * These were previously `/x402/data-item/{signed,unsigned}`. The service
+ * renamed them to `/x402/upload/*` and kept a `data-item/signed` alias, but not
+ * a `data-item/unsigned` one — so every unsigned x402 upload 404ed. Both
+ * canonical paths are served by all released upload-service versions.
+ */
+export declare const x402UploadEndpoints: {
+    readonly signed: "/x402/upload/signed";
+    readonly unsigned: "/x402/upload/unsigned";
+};
 export declare class TurboHTTPService implements TurboHTTPServiceInterface {
     protected baseURL: string;
     protected logger: TurboLogger;
@@ -30,19 +42,30 @@ export declare class TurboHTTPService implements TurboHTTPServiceInterface {
         retryConfig: RetryConfig;
         logger: TurboLogger;
     });
-    get<T>({ endpoint, signal, allowedStatuses, headers, }: {
+    get<T>({ endpoint, signal, allowedStatuses, headers, x402Options, }: {
         endpoint: `/${string}`;
         signal?: AbortSignal;
         allowedStatuses?: number[];
         headers?: Partial<TurboSignedRequestHeaders> & Record<string, string>;
+        /**
+         * Pay for this GET with x402. Used by the chunked uploader's create call,
+         * which the bundler answers with a 402 because a multipart upload is paid
+         * for BEFORE any chunk is accepted.
+         *
+         * Delegates to the same `wrapFetchWithPayment` the POST path uses, so the
+         * signer, the spend cap and the retry semantics are identical rather than
+         * a second implementation that can drift.
+         */
+        x402Options?: X402RequestCredentials;
     }): Promise<T>;
-    post<T>({ endpoint, signal, allowedStatuses, headers, data, x402Options, }: {
+    post<T>({ endpoint, signal, allowedStatuses, headers, data, x402Options, retry, }: {
         endpoint: `/${string}`;
         signal?: AbortSignal;
         allowedStatuses?: number[];
         headers?: Partial<TurboSignedRequestHeaders> & Record<string, string>;
         data: Readable | Buffer | ReadableStream | Uint8Array;
         x402Options?: X402RequestCredentials;
+        retry?: boolean;
     }): Promise<T>;
     private tryRequest;
     private withRetry;

package/lib/types/common/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,WAQzD,CAAC;AAOH,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;gBAEvB,EACV,GAAG,EACH,MAAM,EACN,WAAwC,GACzC,EAAE;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,WAAW,CAAC;QACzB,MAAM,EAAE,WAAW,CAAC;KACrB;IAMK,GAAG,CAAC,CAAC,EAAE,EACX,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,GACR,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvE,GAAG,OAAO,CAAC,CAAC,CAAC;IAYR,IAAI,CAAC,CAAC,EAAE,EACZ,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,EACP,IAAI,EACJ,WAAW,GACZ,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,CAAC;QACtD,WAAW,CAAC,EAAE,sBAAsB,CAAC;KACtC,GAAG,OAAO,CAAC,CAAC,CAAC;YAiCA,UAAU;YA6BV,SAAS;YAsCT,QAAQ;CA8CvB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,kBAAkB,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,WAQzD,CAAC;AAOH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;gBAEvB,EACV,GAAG,EACH,MAAM,EACN,WAAwC,GACzC,EAAE;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,WAAW,CAAC;QACzB,MAAM,EAAE,WAAW,CAAC;KACrB;IAMK,GAAG,CAAC,CAAC,EAAE,EACX,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,EACP,WAAW,GACZ,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtE;;;;;;;;WAQG;QACH,WAAW,CAAC,EAAE,sBAAsB,CAAC;KACtC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwCR,IAAI,CAAC,CAAC,EAAE,EACZ,QAAQ,EACR,MAAM,EACN,eAA4B,EAC5B,OAAO,EACP,IAAI,EACJ,WAAW,EACX,KAAY,GACb,EAAE;QACD,QAAQ,EAAE,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtE,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,CAAC;QACtD,WAAW,CAAC,EAAE,sBAAsB,CAAC;QAIrC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,CAAC,CAAC;YAmCA,UAAU;YA6BV,SAAS;YAsCT,QAAQ;CA+CvB"}

package/lib/types/common/index.d.ts

@@ -14,8 +14,11 @@
  * limitations under the License.
  */
 export * from './upload.js';
+export * from './folderIndex.js';
 export * from './payment.js';
+export * from './arnsActions.js';
 export * from './turbo.js';
 export * from './currency.js';
 export * from './token/index.js';
+export * from '../utils/errors.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC"}

package/lib/types/common/payment.d.ts

@@ -1,4 +1,4 @@
-import { Currency, GetCreditShareApprovalsResponse, TokenTools, TokenType, TurboAuthenticatedPaymentServiceConfiguration, TurboAuthenticatedPaymentServiceInterface, TurboBalanceResponse, TurboCheckoutSessionParams, TurboCheckoutSessionResponse, TurboCountriesResponse, TurboCryptoFundResponse, TurboCurrenciesResponse, TurboDataItemSigner, TurboFiatEstimateForBytesResponse, TurboFiatToArResponse, TurboFundWithTokensParams, TurboLogger, TurboPaymentIntentParams, TurboPaymentIntentResponse, TurboPriceResponse, TurboRatesResponse, TurboSignedRequestHeaders, TurboSubmitFundTxResponse, TurboTokenPriceForBytesResponse, TurboUnauthenticatedPaymentServiceConfiguration, TurboUnauthenticatedPaymentServiceInterface, TurboWincForFiatParams, TurboWincForFiatResponse, TurboWincForTokenParams, TurboWincForTokenResponse, UserAddress } from '../types.js';
+import { ArNSAction, ArNSActionCompleted, ArNSActionPriceResponse, ArNSActionResult, ArNSFiatPurchaseQuoteParams, ArNSFiatPurchaseQuoteResponse, ArNSNameType, ArNSOwnerSigner, ArNSPriceParams, ArNSPriceResponse, ArNSPurchaseParams, ArNSPurchaseStatusResponse, AuthenticatedArNSFiatPurchaseQuoteParams, Currency, GetCreditShareApprovalsResponse, TokenTools, TokenType, TurboArNSNamesResponse, TurboAuthenticatedPaymentServiceConfiguration, TurboAuthenticatedPaymentServiceInterface, TurboBalanceResponse, TurboCheckoutSessionParams, TurboCheckoutSessionResponse, TurboCountriesResponse, TurboCryptoFundResponse, TurboCurrenciesResponse, TurboDataItemSigner, TurboFiatEstimateForBytesResponse, TurboFiatToArResponse, TurboFreeStatusResponse, TurboFundWithTokensParams, TurboLogger, TurboPaymentHistoryParams, TurboPaymentHistoryResponse, TurboPaymentIntentParams, TurboPaymentIntentResponse, TurboPriceResponse, TurboRatesResponse, TurboSignedRequestHeaders, TurboSubmitFundTxResponse, TurboTokenPriceForBytesResponse, TurboUnauthenticatedPaymentServiceConfiguration, TurboUnauthenticatedPaymentServiceInterface, TurboWincForFiatParams, TurboWincForFiatResponse, TurboWincForTokenParams, TurboWincForTokenResponse, UserAddress } from '../types.js';
 import { TurboHTTPService } from './http.js';
 export declare const developmentPaymentServiceURL = "https://payment.ardrive.dev";
 export declare const defaultPaymentServiceURL = "https://payment.ardrive.io";
@@ -9,6 +9,19 @@ export declare class TurboUnauthenticatedPaymentService implements TurboUnauthen
     private url;
     constructor({ url, logger, retryConfig, token, }: TurboUnauthenticatedPaymentServiceConfiguration);
     getBalance(address: string): Promise<TurboBalanceResponse>;
+    getFreeStatus(address: string): Promise<TurboFreeStatusResponse>;
+    /**
+     * Returns the ArNS names a wallet owns or controls -- both custodial names
+     * bought via Turbo's ArNS-with-credits feature (Turbo may spawn and hold
+     * the ANT on the caller's behalf, depending on the buy) and self-custody
+     * names, in one list. See `TurboArNSName` for field semantics, including
+     * the `custodial` flag distinguishing the two.
+     *
+     * To read a name's current records or lease/expiration state, use
+     * `@ar.io/sdk` directly against the returned `antId` -- it talks to the
+     * chain directly and needs no round-trip through this SDK/backend.
+     */
+    getArNSNames(address: string): Promise<TurboArNSNamesResponse>;
     getFiatRates(): Promise<TurboRatesResponse>;
     getFiatToAR({ currency, }: {
         currency: Currency;
@@ -20,6 +33,60 @@ export declare class TurboUnauthenticatedPaymentService implements TurboUnauthen
     }): Promise<TurboPriceResponse[]>;
     getWincForFiat({ amount, promoCodes, nativeAddress, }: TurboWincForFiatParams): Promise<TurboWincForFiatResponse>;
     getWincForToken({ tokenAmount, }: TurboWincForTokenParams): Promise<TurboWincForTokenResponse>;
+    getArNSPriceForName(params: ArNSPriceParams): Promise<ArNSPriceResponse>;
+    /**
+     * Preview the flat credits margin one of the eight non-purchase actions
+     * (everything except Buy-Name/Extend-Lease/Upgrade-Name/
+     * Increase-Undername-Limit) will debit, without creating it. Those four
+     * purchase actions are priced by `getArNSPriceForName` instead — their
+     * cost is dominated by the ARIO purchase, not this margin, so this route
+     * rejects them.
+     *
+     * No signature required: this mirrors `getArNSPriceForName`'s read-only,
+     * unauthenticated shape rather than `getArNSActionStatus`'s (which happens
+     * to live on the authenticated client today despite needing no signature
+     * either).
+     */
+    getArNSActionPrice(action: ArNSAction): Promise<ArNSActionPriceResponse>;
+    /**
+     * Fail fast (client-side) on malformed ArNS requests so JS callers that bypass
+     * the compile-time intent unions get a clear `ProvidedInputError` instead of an
+     * opaque service 4xx. Enforces the required fields per intent:
+     *  - `Buy-Name`: `type` ('lease' | 'permabuy'); leases also need `years`.
+     *    `processId` is OPTIONAL — omit it to have the bundler custodially
+     *    provision the ANT (Turbo owns it), supply it for a user-owned ANT.
+     *  - `Extend-Lease`: positive `years`
+     *  - `Increase-Undername-Limit`: positive `increaseQty`
+     *  - `Upgrade-Name`: just `name`
+     */
+    protected validateArNSPurchaseParams(params: ArNSPriceParams): void;
+    getArNSPurchaseStatus({ nonce, }: {
+        nonce: string;
+    }): Promise<ArNSPurchaseStatusResponse>;
+    protected buildArNSPurchaseQuery(input: ArNSPurchaseParams): string;
+    /**
+     * Quote a fiat (Stripe) ArNS purchase — buy a name with a credit card in one
+     * step, with no Turbo Credits top-up in between.
+     *
+     * Returns the recorded `purchaseQuote` (its `nonce` is what
+     * `getArNSPurchaseStatus` polls) plus the Stripe `paymentSession` to complete
+     * payment with. For `payment-intent`, confirm client-side with
+     * `stripe.confirmCardPayment(paymentSession.client_secret, ...)`, then poll
+     * the nonce until the purchase reports success or failure.
+     *
+     * Throws {@link FiatPaymentsDisabledError} when the service has Stripe turned
+     * off (normal in the testnet sandbox) so callers can fall back to the
+     * credit-paid path without string-matching a generic 503.
+     */
+    getArNSFiatPurchaseQuote(params: ArNSFiatPurchaseQuoteParams): Promise<ArNSFiatPurchaseQuoteResponse>;
+    /**
+     * Query string for a fiat quote. Distinct from `buildArNSPurchaseQuery`
+     * because this route takes `uiMode` + its paired URLs and has no `paidBy`
+     * (fiat has no delegated payer), and because promo codes must be REPEATED
+     * params here: the service reads them with `parseQueryParams`, which treats a
+     * comma-joined string as one code rather than several.
+     */
+    protected buildArNSFiatQuoteQuery(params: ArNSFiatPurchaseQuoteParams, promoCodes: string[]): string;
     protected appendPromoCodesToQuery(promoCodes: string[]): string;
     getTurboCryptoWallets(): Promise<Record<TokenType, string>>;
     protected getCheckout({ amount, owner, promoCodes, uiMode, ...callbackUrls }: TurboCheckoutSessionParams, type?: 'checkout-session' | 'payment-intent', headers?: TurboSignedRequestHeaders): Promise<TurboCheckoutSessionResponse>;
@@ -44,6 +111,229 @@ export declare class TurboAuthenticatedPaymentService extends TurboUnauthenticat
     protected readonly tokenTools: TokenTools | undefined;
     constructor({ url, retryConfig, signer, logger, token, tokenTools, }: TurboAuthenticatedPaymentServiceConfiguration);
     getBalance(userAddress?: string): Promise<TurboBalanceResponse>;
+    /**
+     * Quote a fiat (Stripe) ArNS purchase. `address` defaults to this signer's
+     * native address — the wallet that will own the name — so the common case
+     * needs no address at all. Pass one explicitly to buy on another wallet's
+     * behalf; the route takes the destination as a path param and requires no
+     * signature, which is why it is available unauthenticated too.
+     */
+    getArNSFiatPurchaseQuote(params: AuthenticatedArNSFiatPurchaseQuoteParams): Promise<ArNSFiatPurchaseQuoteResponse>;
+    getFreeStatus(userAddress?: string): Promise<TurboFreeStatusResponse>;
+    /**
+     * The signer's OWN completed top-up history (crypto + fiat), merged newest
+     * first and keyset-paginated. This is a SIGNED GET: unlike `getBalance` /
+     * `getFreeStatus` (which name a wallet by `?address=`), payment history is
+     * self-scoped and returns only the rows belonging to the signing wallet — the
+     * service reads the address from the signature, never a query param.
+     *
+     * We sign the bare nonce (no action-binding of `limit`/`cursor`) to match the
+     * service's `verifySignature` middleware; the pagination params ride in the
+     * query string. Pass `cursor` from a prior response to fetch the next page.
+     */
+    getPaymentHistory({ limit, cursor, }?: TurboPaymentHistoryParams): Promise<TurboPaymentHistoryResponse>;
+    /**
+     * Buy / extend / upgrade an ArNS name, paying with the signer's Turbo credit
+     * balance. The bundler performs the on-chain ARIO purchase and debits credits;
+     * a `402` (FailedRequestError.status === 402) indicates insufficient credits.
+     */
+    /**
+     * Create an action. Returns `completed` or `awaiting-signature`.
+     *
+     * Credits are debited HERE, not at `/sign`. Capture the returned `nonce`
+     * before prompting for a signature: it is the idempotency key, and polling
+     * it is how you resume. Never re-create an action to "retry" — that debits
+     * a second time. An abandoned action is refunded automatically.
+     */
+    createArNSAction(action: ArNSAction, params?: Record<string, unknown>, ownerProof?: {
+        owner: ArNSOwnerSigner;
+        message: string;
+    }): Promise<ArNSActionResult>;
+    /**
+     * Submit the owner-signed transaction for an `awaiting-signature` action.
+     *
+     * `signedTransaction` is the FULL serialized transaction, base64 — not just
+     * the signature. Replaying a completed action returns `alreadyCompleted:
+     * true` rather than buying twice, so this is safe to call again if a
+     * response is lost.
+     */
+    signArNSAction(nonce: string, signedTransaction: string): Promise<ArNSActionCompleted>;
+    /**
+     * Status of an action by nonce. Open — no signature required — so it works
+     * from a status page or callback handler that never holds the payer's key.
+     *
+     * Terminal success carries `messageId`; terminal failure carries
+     * `failedDate`.
+     */
+    getArNSActionStatus(nonce: string): Promise<ArNSActionResult & {
+        failedDate?: string;
+    }>;
+    /**
+     * Run an action to a terminal state, signing if the server asks for it.
+     *
+     * This is the two-shape branch, once, in one place — so callers cannot
+     * hardcode which actions need a signature and break when a customer
+     * exercises ownership.
+     */
+    private completeArNSAction;
+    /**
+     * Buy a name. The ANT is minted straight to `owner` — Turbo never holds it.
+     *
+     * This is the ONLY action that always needs the owner's signature:
+     * `ario_ant::initialize` is the one instruction in the whole lifecycle that
+     * requires the ANT owner's key. The customer signs once, here, and never
+     * again unless they change controllers or transfer the name.
+     *
+     * The owner needs a Solana key to sign with, NOT a funded one — Turbo pays
+     * every lamport of fee and rent.
+     */
+    buyArNSName({ name, owner, type, years, paidBy, onNonce, }: {
+        name: string;
+        owner: ArNSOwnerSigner;
+        type?: ArNSNameType;
+        years?: number;
+        paidBy?: UserAddress | UserAddress[];
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /** Extend a lease. Permissionless on chain — no owner signature needed. */
+    extendArNSLease({ name, years, paidBy, onNonce, }: {
+        name: string;
+        years: number;
+        paidBy?: UserAddress | UserAddress[];
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /** Upgrade a lease to a permanent name. No owner signature needed. */
+    upgradeArNSName({ name, paidBy, onNonce, }: {
+        name: string;
+        paidBy?: UserAddress | UserAddress[];
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /** Raise the undername limit. No owner signature needed. */
+    increaseArNSUndernameLimit({ name, increaseQty, paidBy, onNonce, }: {
+        name: string;
+        increaseQty: number;
+        paidBy?: UserAddress | UserAddress[];
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /**
+     * Point a name (or undername) at an Arweave transaction.
+     *
+     * Costs a small credit margin — never SOL, which Turbo sponsors. Completes in one call while Turbo is
+     * a controller of the ANT, and returns `awaiting-signature` once the customer
+     * has revoked Turbo, at which point `owner` signs it themselves. Both paths
+     * are handled here.
+     *
+     * The owner proof is required EITHER WAY: Turbo is directing its own
+     * controller authority over an asset someone else owns, so nothing on chain
+     * records the owner's consent and we demand it. It is a MESSAGE signature,
+     * not a transaction — cheap and offline, but still a wallet prompt.
+     */
+    setArNSRecord({ antId, owner, transactionId, undername, ttlSeconds, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        transactionId: string;
+        undername?: string;
+        ttlSeconds?: number;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /** Remove a record (an undername). Costs credits, never SOL. */
+    removeArNSRecord({ antId, owner, undername, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        undername: string;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /**
+     * Edit a RECORD's metadata — its display name, logo, description, keywords.
+     *
+     * Costs a small credit margin (never SOL), and is owner-or-controller on
+     * chain, so it behaves exactly like
+     * {@link setArNSRecord}: Turbo-alone while it is a controller, owner-signed
+     * after a revoke.
+     *
+     * Fields are TRI-STATE. Omit one to leave it unchanged; pass `null` to clear
+     * it. Those are bound distinctly by the owner proof, so "clear the
+     * description" and "set it to empty" are different authorizations.
+     *
+     * Note this is RECORD metadata. ANT-level metadata (the ANT's own name,
+     * ticker, description, keywords, logo) is NOT sponsored and stays on the
+     * direct-signer path via `@ar.io/sdk`.
+     */
+    setArNSRecordMetadata({ antId, owner, undername, displayName, recordLogo, recordDescription, recordKeywords, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        undername?: string;
+        displayName?: string | null;
+        recordLogo?: string | null;
+        recordDescription?: string | null;
+        recordKeywords?: string[] | null;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /** Clear a record's metadata. Costs credits, never SOL; same two-shape rules. */
+    removeArNSRecordMetadata({ antId, owner, undername, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        undername: string;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /**
+     * Hand ONE record to another address.
+     *
+     * Distinct from {@link transferArNSAnt}, which hands over the whole ANT and
+     * every record on it. Confusing the two gives away far more than intended.
+     */
+    transferArNSRecord({ antId, owner, undername, target, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        undername: string;
+        target: string;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /**
+     * Grant controller rights on the ANT. Omit `target` for Turbo itself, which
+     * is what makes `setArNSRecord` a single call.
+     *
+     * Owner-signed: changing an ANT's access control is an owner-only
+     * instruction. Costs a small credit margin; Turbo funds the ACL page growth
+     * in SOL.
+     */
+    addArNSController({ antId, owner, target, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        target?: string;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /**
+     * Revoke controller rights — the escape hatch that keeps "Turbo is not a
+     * custodian" honest.
+     *
+     * Always available, and needs nothing from Turbo but the fee. Costs a small
+     * credit margin rather than SOL.
+     * After revoking, `setArNSRecord` keeps working: it simply starts returning
+     * `awaiting-signature` so the owner signs their own record writes.
+     */
+    removeArNSController({ antId, owner, target, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        target?: string;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /**
+     * Hand the ANT to a new owner. Irreversible: after this lands, `owner` no
+     * longer controls the name. Owner-signed, and sponsored like the rest.
+     */
+    transferArNSAnt({ antId, owner, target, onNonce, }: {
+        antId: string;
+        owner: ArNSOwnerSigner;
+        target: string;
+        onNonce?: (nonce: string) => void | Promise<void>;
+    }): Promise<ArNSActionCompleted>;
+    /**
+     * Defaults to the signer's own address when `userAddress` is omitted
+     * (`null`/`undefined`). Passing `''` does NOT trigger this default --
+     * mirrors `getBalance`'s existing behavior above.
+     */
+    getArNSNames(userAddress?: string): Promise<TurboArNSNamesResponse>;
     getCreditShareApprovals({ userAddress, }: {
         userAddress?: string;
     }): Promise<GetCreditShareApprovalsResponse>;

package/lib/types/common/payment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/common/payment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/common/payment.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,6BAA6B,EAC7B,YAAY,EACZ,eAAe,EAEf,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wCAAwC,EACxC,QAAQ,EACR,+BAA+B,EAE/B,UAAU,EACV,SAAS,EAET,sBAAsB,EACtB,6CAA6C,EAC7C,yCAAyC,EACzC,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,iCAAiC,EACjC,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EAEzB,WAAW,EACX,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAE1B,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,+CAA+C,EAC/C,2CAA2C,EAC3C,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EACzB,WAAW,EAIZ,MAAM,aAAa,CAAC;AAgBrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAI7C,eAAO,MAAM,4BAA4B,gCAAgC,CAAC;AAC1E,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AAErE,qBAAa,kCACX,YAAW,2CAA2C;IAEtD,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACjD,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IACpC,OAAO,CAAC,GAAG,CAAS;gBAER,EACV,GAA8B,EAC9B,MAAuB,EACvB,WAAwC,EACxC,KAAiB,GAClB,EAAE,+CAA+C;IAWrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmB1D,aAAa,CACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,uBAAuB,CAAC;IAUnC;;;;;;;;;;OAUG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAM9D,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAM3C,WAAW,CAAC,EACjB,QAAQ,GACT,EAAE;QACD,QAAQ,EAAE,QAAQ,CAAC;KACpB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAM3B,qBAAqB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAMxD,sBAAsB,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAMpD,cAAc,CAAC,EAC1B,KAAK,GACN,EAAE;QACD,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAW1B,cAAc,CAAC,EACpB,MAAM,EACN,UAAe,EACf,aAA6B,GAC9B,EAAE,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAUhD,eAAe,CAAC,EAC3B,WAAW,GACZ,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAclD,mBAAmB,CAC9B,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAoB7B;;;;;;;;;;;;OAYG;IACU,kBAAkB,CAC7B,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,uBAAuB,CAAC;IAMnC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,0BAA0B,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAgE5D,qBAAqB,CAAC,EAC3B,KAAK,GACN,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAMvC,SAAS,CAAC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM;IAuBnE;;;;;;;;;;;;;OAaG;IACU,wBAAwB,CACnC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,6BAA6B,CAAC;IAsDzC;;;;;;OAMG;IACH,SAAS,CAAC,uBAAuB,CAC/B,MAAM,EAAE,2BAA2B,EACnC,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM;IAmCT,SAAS,CAAC,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM;IAKlD,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;cAQxD,WAAW,CACzB,EACE,MAAM,EACN,KAAK,EACL,UAAe,EACf,MAAiB,EACjB,GAAG,YAAY,EAChB,EAAE,0BAA0B,EAC7B,IAAI,GAAE,kBAAkB,GAAG,gBAAqC,EAChE,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC,4BAA4B,CAAC;IA2CjC,qBAAqB,CAC1B,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,4BAA4B,CAAC;IAI3B,qBAAqB,CAAC,EACjC,IAAI,GACL,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAoDzB,uBAAuB,CAAC,EACnC,WAAW,GACZ,EAAE;QACD,WAAW,EAAE,WAAW,CAAC;KAC1B,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAqB/B,uBAAuB,CAAC,EACnC,SAAS,EACT,QAAQ,GACT,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,QAAQ,CAAC;KACpB,GAAG,OAAO,CAAC,iCAAiC,CAAC;IA8BjC,qBAAqB,CAAC,EACjC,SAAS,GACV,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAuB/B,mBAAmB,CAC9B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;CAMvC;AAED,qBAAa,gCACX,SAAQ,kCACR,YAAW,yCAAyC;IAEpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAC/C,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;gBAE1C,EACV,GAA8B,EAC9B,WAAW,EACX,MAAM,EACN,MAAuB,EACvB,KAAiB,EACjB,UAAU,GACX,EAAE,6CAA6C;IAMnC,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAK5E;;;;;;OAMG;IACU,wBAAwB,CACnC,MAAM,EAAE,wCAAwC,GAC/C,OAAO,CAAC,6BAA6B,CAAC;IAQ5B,aAAa,CACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,uBAAuB,CAAC;IAKnC;;;;;;;;;;OAUG;IACU,iBAAiB,CAAC,EAC7B,KAAK,EACL,MAAM,GACP,GAAE,yBAA8B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAiBxE;;;;OAIG;IAkBH;;;;;;;OAOG;IACU,gBAAgB,CAC3B,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,gBAAgB,CAAC;IAsC5B;;;;;;;OAOG;IACU,cAAc,CACzB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAY/B;;;;;;OAMG;IACU,mBAAmB,CAC9B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAMtD;;;;;;OAMG;YACW,kBAAkB;IAiChC;;;;;;;;;;OAUG;IACU,WAAW,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,IAAc,EACd,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,eAAe,CAAC;QACvB,IAAI,CAAC,EAAE,YAAY,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAehC,2EAA2E;IAC9D,eAAe,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAShC,sEAAsE;IACzD,eAAe,CAAC,EAC3B,IAAI,EACJ,MAAM,EACN,OAAO,GACR,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAShC,4DAA4D;IAC/C,0BAA0B,CAAC,EACtC,IAAI,EACJ,WAAW,EACX,MAAM,EACN,OAAO,GACR,EAAE;QACD,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAShC;;;;;;;;;;;;OAYG;IACU,aAAa,CAAC,EACzB,KAAK,EACL,KAAK,EACL,aAAa,EACb,SAAe,EACf,UAAiB,EACjB,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqBhC,gEAAgE;IACnD,gBAAgB,CAAC,EAC5B,KAAK,EACL,KAAK,EACL,SAAS,EACT,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUhC;;;;;;;;;;;;;;;OAeG;IACU,qBAAqB,CAAC,EACjC,KAAK,EACL,KAAK,EACL,SAAe,EACf,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2BhC,iFAAiF;IACpE,wBAAwB,CAAC,EACpC,KAAK,EACL,KAAK,EACL,SAAS,EACT,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUhC;;;;;OAKG;IACU,kBAAkB,CAAC,EAC9B,KAAK,EACL,KAAK,EACL,SAAS,EACT,MAAM,EACN,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUhC;;;;;;;OAOG;IACU,iBAAiB,CAAC,EAC7B,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAahC;;;;;;;;OAQG;IACU,oBAAoB,CAAC,EAChC,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAahC;;;OAGG;IACU,eAAe,CAAC,EAC3B,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,eAAe,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAShC;;;;OAIG;IACU,YAAY,CACvB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,sBAAsB,CAAC;IAKrB,uBAAuB,CAAC,EACnC,WAAW,GACZ,EAAE;QACD,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,+BAA+B,CAAC;IAK/B,cAAc,CAAC,EAC1B,MAAM,EACN,UAAe,GAChB,EAAE,sBAAsB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAQhD,qBAAqB,CAChC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,4BAA4B,CAAC;YAI1B,sBAAsB;IAYvB,eAAe,CAAC,EAC3B,aAAiB,EACjB,WAAW,EAAE,YAAY,EACzB,6BAA6B,GAC9B,EAAE,yBAAyB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CA0DhE"}

package/lib/types/common/signer.d.ts

@@ -1,6 +1,6 @@
 import { Signer as ArbundleSigner } from '@dha-team/arbundles';
 import { Signer as x402Signer } from 'x402-fetch';
-import { FileStreamFactory, NativeAddress, SendTxWithSignerParams, TokenType, TurboDataItemSigner, TurboDataItemSignerParams, TurboFileFactory, TurboLogger, TurboSignedDataItemFactory, TurboSigner, WalletAdapter } from '../types.js';
+import { FileStreamFactory, NativeAddress, SendTxWithSignerParams, TokenType, TurboDataItemSigner, TurboDataItemSignerParams, TurboFileFactory, TurboLogger, TurboSignedDataItemFactory, TurboSignedRequestHeaders, TurboSigner, WalletAdapter } from '../types.js';
 /**
  * Abstract class for signing TurboDataItems.
  */
@@ -12,16 +12,22 @@ export declare abstract class TurboDataItemAbstractSigner implements TurboDataIt
     constructor({ signer, logger, token, walletAdapter, }: TurboDataItemSignerParams);
     abstract signDataItem({ fileStreamFactory, fileSizeFactory, dataItemOpts, emitter, }: TurboFileFactory<FileStreamFactory>): Promise<TurboSignedDataItemFactory>;
     private ownerToNativeAddress;
-    generateSignedRequestHeaders(): Promise<{
-        'x-public-key': string;
-        'x-nonce': string;
-        'x-signature': string;
-    }>;
+    generateSignedRequestHeaders(nonce?: string, additionalData?: string): Promise<TurboSignedRequestHeaders>;
     getPublicKey(): Promise<Buffer>;
     getNativeAddress(): Promise<NativeAddress>;
     /** Let the signer handle sending tx for better compat with cross chain libraries/web wallets */
     sendTransaction({ target, amount, gatewayUrl, turboCreditDestinationAddress, }: SendTxWithSignerParams): Promise<string>;
     signData(dataToSign: Uint8Array): Promise<Uint8Array>;
 }
+/**
+ * Builds the wallet client x402-fetch signs payment authorizations with.
+ *
+ * The chain matters because `wrapFetchWithPayment` maps `walletClient.chain.id`
+ * to a network name and prefers the matching entry in the service's `accepts`
+ * list. The upload service advertises Base mainnet (`base`), and x402 support
+ * here is limited to `base-usdc`, so mainnet is the correct default. Callers
+ * needing another network can supply their own signer via
+ * `X402Funding({ signer })`.
+ */
 export declare function makeX402Signer(arbundlesSigner: ArbundleSigner): Promise<x402Signer>;
 //# sourceMappingURL=signer.d.ts.map

package/lib/types/common/signer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../../src/common/signer.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkB/D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC1B,WAAW,EACX,aAAa,EAGd,MAAM,aAAa,CAAC;AAUrB;;GAEG;AACH,8BAAsB,2BACpB,YAAW,mBAAmB;IAEvB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAEhD,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC;gBAEf,EACV,MAAM,EACN,MAAuB,EACvB,KAAK,EACL,aAAa,GACd,EAAE,yBAAyB;IAO5B,QAAQ,CAAC,YAAY,CAAC,EACpB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,OAAO,GACR,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAE5E,OAAO,CAAC,oBAAoB;IAgCf,4BAA4B;;;;;IAY5B,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAOvD,gGAAgG;IACnF,eAAe,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,UAAU,EACV,6BAA6B,GAC9B,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuF9B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAgBnE;AAED,wBAAsB,cAAc,CAClC,eAAe,EAAE,cAAc,GAC9B,OAAO,CAAC,UAAU,CAAC,CAsCrB"}
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../../src/common/signer.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkB/D,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,EACX,aAAa,EAGd,MAAM,aAAa,CAAC;AAUrB;;GAEG;AACH,8BAAsB,2BACpB,YAAW,mBAAmB;IAEvB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAEhD,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC;gBAEf,EACV,MAAM,EACN,MAAuB,EACvB,KAAK,EACL,aAAa,GACd,EAAE,yBAAyB;IAO5B,QAAQ,CAAC,YAAY,CAAC,EACpB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,OAAO,GACR,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAE5E,OAAO,CAAC,oBAAoB;IA+Bf,4BAA4B,CAGvC,KAAK,GAAE,MAAwC,EAM/C,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,yBAAyB,CAAC;IAexB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAOvD,gGAAgG;IACnF,eAAe,CAAC,EAC3B,MAAM,EACN,MAAM,EACN,UAAU,EACV,6BAA6B,GAC9B,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuF9B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAgBnE;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,eAAe,EAAE,cAAc,GAC9B,OAAO,CAAC,UAAU,CAAC,CAsCrB"}

package/lib/types/common/token/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/common/token/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAEL,YAAY,EACZ,SAAS,EAEV,MAAM,gBAAgB,CAAC;AAcxB,eAAO,MAAM,eAAe,EAAE,YAsBpB,CAAC;AAMX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAaxC,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,SAAS,EACT,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,CAc/B,CAAC;AAEX,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/common/token/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAEL,YAAY,EACZ,SAAS,EAEV,MAAM,gBAAgB,CAAC;AAUxB,eAAO,MAAM,eAAe,EAAE,YAepB,CAAC;AAMX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAYxC,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,MAAM,CACjC,SAAS,EACT,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,CAa/B,CAAC;AAEX,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}