@gelatocloud/gasless 0.0.5 → 0.0.6

package/_dist/types/payment.d.ts

@@ -1,17 +1,5 @@
-import { type Address } from 'viem';
-export declare enum PaymentType {
-    Token = "token",
-    Sponsored = "sponsored"
-}
-export type TokenPayment = {
-    type: PaymentType.Token;
-    address: Address;
-};
 export type SponsoredPayment = {
-    type: PaymentType.Sponsored;
+    type: 'sponsored';
 };
-export type Payment = TokenPayment | SponsoredPayment;
-export declare const sponsored: () => Payment;
-export declare const token: (address: Address) => Payment;
-export declare const native: () => Payment;
+export declare const sponsored: () => SponsoredPayment;
 //# sourceMappingURL=payment.d.ts.map

package/_dist/types/payment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../types/payment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAe,MAAM,MAAM,CAAC;AAEjD,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,SAAS,cAAc;CACxB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEtD,eAAO,MAAM,SAAS,QAAO,OAA4C,CAAC;AAE1E,eAAO,MAAM,KAAK,GAAI,SAAS,OAAO,KAAG,OAAiD,CAAC;AAE3F,eAAO,MAAM,MAAM,QAAO,OAA8D,CAAC"}
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../types/payment.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,SAAS,QAAO,gBAA2C,CAAC"}

package/_dist/types/payment.js

@@ -1,16 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.native = exports.token = exports.sponsored = exports.PaymentType = void 0;
-const viem_1 = require("viem");
-var PaymentType;
-(function (PaymentType) {
-    PaymentType["Token"] = "token";
-    PaymentType["Sponsored"] = "sponsored";
-})(PaymentType || (exports.PaymentType = PaymentType = {}));
-const sponsored = () => ({ type: PaymentType.Sponsored });
+exports.sponsored = void 0;
+const sponsored = () => ({ type: 'sponsored' });
 exports.sponsored = sponsored;
-const token = (address) => ({ address, type: PaymentType.Token });
-exports.token = token;
-const native = () => ({ address: viem_1.zeroAddress, type: PaymentType.Token });
-exports.native = native;
 //# sourceMappingURL=payment.js.map

package/_dist/types/payment.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../types/payment.ts"],"names":[],"mappings":";;;AAAA,+BAAiD;AAEjD,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,sCAAuB,CAAA;AACzB,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB;AAaM,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;AAA7D,QAAA,SAAS,aAAoD;AAEnE,MAAM,KAAK,GAAG,CAAC,OAAgB,EAAW,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;AAA9E,QAAA,KAAK,SAAyE;AAEpF,MAAM,MAAM,GAAG,GAAY,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAW,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;AAA5E,QAAA,MAAM,UAAsE"}
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../types/payment.ts"],"names":[],"mappings":";;;AAIO,MAAM,SAAS,GAAG,GAAqB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AAA5D,QAAA,SAAS,aAAmD"}

package/_dist/types/schema.d.ts

@@ -7,4 +7,36 @@ export declare const evmTokenSchema: z.ZodObject<{
     decimals: z.ZodNumber;
 }, z.core.$strip>;
 export type EvmToken = z.infer<typeof evmTokenSchema>;
+/**
+ * Schema for transaction log entries
+ */
+export declare const logSchema: z.ZodObject<{
+    address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    topics: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+}, z.core.$strip>;
+/**
+ * Schema for transaction receipts
+ */
+export declare const receiptSchema: z.ZodObject<{
+    blockHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    blockNumber: z.ZodCoercedBigInt<unknown>;
+    gasUsed: z.ZodCoercedBigInt<unknown>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        data: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+        topics: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>>;
+    }, z.core.$strip>>>;
+    transactionHash: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+}, z.core.$strip>;
+/**
+ * Base schema for all status responses
+ */
+export declare const baseStatusSchema: z.ZodObject<{
+    chainId: z.ZodCoercedNumber<unknown>;
+    createdAt: z.ZodNumber;
+}, z.core.$strip>;
+export type Log = z.infer<typeof logSchema>;
+export type TransactionReceipt = z.infer<typeof receiptSchema>;
+export type BaseStatus = z.infer<typeof baseStatusSchema>;
 //# sourceMappingURL=schema.d.ts.map

package/_dist/types/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../types/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,aAAa,+DAGO,CAAC;AAElC,eAAO,MAAM,eAAe,+DAGK,CAAC;AAElC,eAAO,MAAM,gBAAgB,+DAGS,CAAC;AAEvC,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../types/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,aAAa,+DAGO,CAAC;AAElC,eAAO,MAAM,eAAe,+DAGK,CAAC;AAElC,eAAO,MAAM,gBAAgB,+DAGS,CAAC;AAEvC,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;iBAIpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;iBAMxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAGH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAC5C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/_dist/types/schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.evmTokenSchema = exports.evmAddressSchema = exports.hexData32Schema = exports.hexDataSchema = void 0;
+exports.baseStatusSchema = exports.receiptSchema = exports.logSchema = exports.evmTokenSchema = exports.evmAddressSchema = exports.hexData32Schema = exports.hexDataSchema = void 0;
 const viem_1 = require("viem");
 const zod_1 = require("zod");
 const hexData32Pattern = /^0x([0-9a-fA-F][0-9a-fA-F]){32}$/;
@@ -22,4 +22,29 @@ exports.evmTokenSchema = zod_1.z.object({
     address: exports.evmAddressSchema,
     decimals: zod_1.z.number()
 });
+/**
+ * Schema for transaction log entries
+ */
+exports.logSchema = zod_1.z.object({
+    address: exports.evmAddressSchema,
+    data: exports.hexDataSchema,
+    topics: zod_1.z.array(exports.hexData32Schema)
+});
+/**
+ * Schema for transaction receipts
+ */
+exports.receiptSchema = zod_1.z.object({
+    blockHash: exports.hexData32Schema,
+    blockNumber: zod_1.z.coerce.bigint(),
+    gasUsed: zod_1.z.coerce.bigint(),
+    logs: zod_1.z.array(exports.logSchema).optional(),
+    transactionHash: exports.hexData32Schema
+});
+/**
+ * Base schema for all status responses
+ */
+exports.baseStatusSchema = zod_1.z.object({
+    chainId: zod_1.z.coerce.number(),
+    createdAt: zod_1.z.number()
+});
 //# sourceMappingURL=schema.js.map

package/_dist/types/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../types/schema.ts"],"names":[],"mappings":";;;AAAA,+BAA4C;AAC5C,6BAAwB;AAExB,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAC5D,MAAM,cAAc,GAAG,+BAA+B,CAAC;AACvD,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAEhD,QAAA,aAAa,GAAG,OAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;KACxD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAU,CAAC,CAAC;AAErB,QAAA,eAAe,GAAG,OAAC;KAC7B,MAAM,EAAE;KACR,KAAK,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;KAClE,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAU,CAAC,CAAC;AAErB,QAAA,gBAAgB,GAAG,OAAC;KAC9B,MAAM,EAAE;KACR,KAAK,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KAChE,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,iBAAU,EAAC,GAAG,CAAC,CAAC,CAAC;AAE1B,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,wBAAgB;IACzB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../types/schema.ts"],"names":[],"mappings":";;;AAAA,+BAA4C;AAC5C,6BAAwB;AAExB,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAC5D,MAAM,cAAc,GAAG,+BAA+B,CAAC;AACvD,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAEhD,QAAA,aAAa,GAAG,OAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;KACxD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAU,CAAC,CAAC;AAErB,QAAA,eAAe,GAAG,OAAC;KAC7B,MAAM,EAAE;KACR,KAAK,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;KAClE,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAU,CAAC,CAAC;AAErB,QAAA,gBAAgB,GAAG,OAAC;KAC9B,MAAM,EAAE;KACR,KAAK,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KAChE,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,iBAAU,EAAC,GAAG,CAAC,CAAC,CAAC;AAE1B,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,wBAAgB;IACzB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,SAAS,GAAG,OAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,wBAAgB;IACzB,IAAI,EAAE,qBAAa;IACnB,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,uBAAe,CAAC;CACjC,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,uBAAe;IAC1B,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE;IAC9B,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE;IAC1B,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,iBAAS,CAAC,CAAC,QAAQ,EAAE;IACnC,eAAe,EAAE,uBAAe;CACjC,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC,MAAM,EAAE;IAC1B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}

package/_dist/utils/errors.d.ts

@@ -0,0 +1,20 @@
+import type { Hex } from 'viem';
+/**
+ * Extracts the transaction/operation ID from an error
+ *
+ * Expected error structure:
+ * ```json
+ * {
+ *   "error": {
+ *     "code": -X,
+ *     "data": "0x... (transaction/operation hash)",
+ *     "message": "..."
+ *   }
+ * }
+ * ```
+ *
+ * @param error - The error to check
+ * @returns The ID of the transaction/operation or undefined if not found
+ */
+export declare function retrieveIdFromError(error: unknown): Hex | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/_dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGhC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAoBnE"}

package/_dist/utils/errors.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retrieveIdFromError = retrieveIdFromError;
+const schema_js_1 = require("../types/schema.js");
+/**
+ * Extracts the transaction/operation ID from an error
+ *
+ * Expected error structure:
+ * ```json
+ * {
+ *   "error": {
+ *     "code": -X,
+ *     "data": "0x... (transaction/operation hash)",
+ *     "message": "..."
+ *   }
+ * }
+ * ```
+ *
+ * @param error - The error to check
+ * @returns The ID of the transaction/operation or undefined if not found
+ */
+function retrieveIdFromError(error) {
+    // Type guard: check if error is an object
+    if (typeof error !== 'object' || error === null) {
+        return undefined;
+    }
+    const err = error;
+    const data = err['data'];
+    // Validate that id/userOperationHash exists and is a string (transaction/operation hash)
+    if (typeof data !== 'string' || data.length === 0) {
+        return undefined;
+    }
+    try {
+        return schema_js_1.hexData32Schema.parse(data);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/_dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../utils/errors.ts"],"names":[],"mappings":";;AAoBA,kDAoBC;AAvCD,kDAAqD;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAChD,0CAA0C;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAW,CAAC;IAEnC,yFAAyF;IACzF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,2BAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/_dist/utils/index.d.ts

@@ -1,3 +1,5 @@
+export * from './errors.js';
 export * from './payment.js';
 export * from './serialize.js';
+export * from './withTimeout.js';
 //# sourceMappingURL=index.d.ts.map

package/_dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/_dist/utils/index.js

@@ -14,6 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errors.js"), exports);
 __exportStar(require("./payment.js"), exports);
 __exportStar(require("./serialize.js"), exports);
+__exportStar(require("./withTimeout.js"), exports);
 //# sourceMappingURL=index.js.map

package/_dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B;AAC7B,iDAA+B;AAC/B,mDAAiC"}

package/_dist/utils/withTimeout.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Error thrown when a polling operation times out
+ */
+export declare class TimeoutError extends Error {
+    constructor(message: string);
+}
+export declare const MIN_POLLING_INTERVAL = 100;
+export declare const MAX_POLLING_INTERVAL = 300000;
+export declare const MIN_TIMEOUT = 1000;
+export declare const MAX_TIMEOUT = 600000;
+/**
+ * Options for configuring the withTimeout polling behavior
+ */
+export interface WithTimeoutOptions<T> {
+    /**
+     * Function to check if polling should continue
+     * Return true to continue polling, false to return the result
+     *
+     * @example
+     * // Continue polling while status is pending
+     * shouldContinue: (status) => status.status === StatusCode.Pending
+     *
+     * @example
+     * // Continue polling while result is null
+     * shouldContinue: (result) => result === null
+     */
+    shouldContinue: (result: T) => boolean;
+    /**
+     * Polling interval in milliseconds
+     * Must be between 100ms and 300000ms (5 minutes)
+     */
+    pollingInterval: number;
+    /**
+     * Maximum time to wait before timing out in milliseconds
+     * Must not exceed 600000ms (10 minutes)
+     */
+    timeout: number;
+    /**
+     * Error message for timeout
+     * @default "Timeout waiting for result"
+     */
+    timeoutErrorMessage?: string;
+}
+/**
+ * Wraps a polling operation with configurable timeout logic
+ *
+ * This utility provides a consistent pattern for polling operations across the codebase.
+ * It repeatedly calls the provided function until either:
+ * - The shouldContinue callback returns false (success)
+ * - The timeout is exceeded (throws TimeoutError)
+ *
+ * If the poll function throws an error, it will propagate immediately and stop polling.
+ * This means the poll function should handle "not ready yet" cases by returning a value
+ * that shouldContinue can check, rather than throwing an error.
+ *
+ * @template T - The type of result returned by the polling function
+ * @param pollFn - Async function to call repeatedly
+ * @param options - Configuration options for polling behavior
+ * @returns The result from pollFn when shouldContinue returns false
+ * @throws {TimeoutError} When timeout is exceeded
+ * @throws Any error thrown by pollFn is propagated immediately
+ *
+ * @example
+ * // Poll for a status to complete
+ * const status = await withTimeout(
+ *   () => getStatus(client, params),
+ *   {
+ *     shouldContinue: (s) => s.status === StatusCode.Pending,
+ *     pollingInterval: 100,
+ *     timeout: 10000,
+ *     timeoutErrorMessage: 'Timeout waiting for status'
+ *   }
+ * );
+ */
+export declare function withTimeout<T>(pollFn: () => Promise<T>, options: WithTimeoutOptions<T>): Promise<T>;
+//# sourceMappingURL=withTimeout.d.ts.map

package/_dist/utils/withTimeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withTimeout.d.ts","sourceRoot":"","sources":["../../utils/withTimeout.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAGD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,SAAS,CAAC;AAC3C,eAAO,MAAM,WAAW,OAAO,CAAC;AAChC,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAEvC;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAiDZ"}

package/_dist/utils/withTimeout.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_TIMEOUT = exports.MIN_TIMEOUT = exports.MAX_POLLING_INTERVAL = exports.MIN_POLLING_INTERVAL = exports.TimeoutError = void 0;
+exports.withTimeout = withTimeout;
+/**
+ * Error thrown when a polling operation times out
+ */
+class TimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = TimeoutError;
+// Validation constants for polling parameters
+exports.MIN_POLLING_INTERVAL = 100; // 100ms minimum
+exports.MAX_POLLING_INTERVAL = 300000; // 5 minutes maximum
+exports.MIN_TIMEOUT = 1000; // 1 second minimum
+exports.MAX_TIMEOUT = 600000; // 10 minutes maximum
+/**
+ * Wraps a polling operation with configurable timeout logic
+ *
+ * This utility provides a consistent pattern for polling operations across the codebase.
+ * It repeatedly calls the provided function until either:
+ * - The shouldContinue callback returns false (success)
+ * - The timeout is exceeded (throws TimeoutError)
+ *
+ * If the poll function throws an error, it will propagate immediately and stop polling.
+ * This means the poll function should handle "not ready yet" cases by returning a value
+ * that shouldContinue can check, rather than throwing an error.
+ *
+ * @template T - The type of result returned by the polling function
+ * @param pollFn - Async function to call repeatedly
+ * @param options - Configuration options for polling behavior
+ * @returns The result from pollFn when shouldContinue returns false
+ * @throws {TimeoutError} When timeout is exceeded
+ * @throws Any error thrown by pollFn is propagated immediately
+ *
+ * @example
+ * // Poll for a status to complete
+ * const status = await withTimeout(
+ *   () => getStatus(client, params),
+ *   {
+ *     shouldContinue: (s) => s.status === StatusCode.Pending,
+ *     pollingInterval: 100,
+ *     timeout: 10000,
+ *     timeoutErrorMessage: 'Timeout waiting for status'
+ *   }
+ * );
+ */
+async function withTimeout(pollFn, options) {
+    const { shouldContinue, pollingInterval, timeout, timeoutErrorMessage = 'Timeout waiting for result' } = options;
+    // Input validation to prevent DoS attacks and type confusion
+    if (!Number.isFinite(pollingInterval) || !Number.isInteger(pollingInterval)) {
+        throw new Error('pollingInterval must be a finite integer');
+    }
+    if (pollingInterval < exports.MIN_POLLING_INTERVAL) {
+        throw new Error(`pollingInterval must be at least ${exports.MIN_POLLING_INTERVAL}ms`);
+    }
+    if (pollingInterval > exports.MAX_POLLING_INTERVAL) {
+        throw new Error(`pollingInterval cannot exceed ${exports.MAX_POLLING_INTERVAL}ms`);
+    }
+    if (!Number.isFinite(timeout) || !Number.isInteger(timeout)) {
+        throw new Error('timeout must be a finite integer');
+    }
+    if (timeout < exports.MIN_TIMEOUT) {
+        throw new Error(`timeout must be at least ${exports.MIN_TIMEOUT}ms`);
+    }
+    if (timeout > exports.MAX_TIMEOUT) {
+        throw new Error(`timeout cannot exceed ${exports.MAX_TIMEOUT}ms`);
+    }
+    const startTime = Date.now();
+    while (true) {
+        // Poll first to ensure at least one attempt
+        const result = await pollFn();
+        // Check if we should continue polling or return
+        if (!shouldContinue(result)) {
+            return result;
+        }
+        // Check timeout AFTER getting result (more accurate)
+        const elapsed = Date.now() - startTime;
+        if (elapsed > timeout) {
+            throw new TimeoutError(`${timeoutErrorMessage} (exceeded timeout of ${timeout}ms)`);
+        }
+        // Wait before next poll
+        await new Promise((resolve) => setTimeout(resolve, pollingInterval));
+    }
+}
+//# sourceMappingURL=withTimeout.js.map

package/_dist/utils/withTimeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withTimeout.js","sourceRoot":"","sources":["../../utils/withTimeout.ts"],"names":[],"mappings":";;;AAoFA,kCAoDC;AAxID;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,8CAA8C;AACjC,QAAA,oBAAoB,GAAG,GAAG,CAAC,CAAC,gBAAgB;AAC5C,QAAA,oBAAoB,GAAG,MAAM,CAAC,CAAC,oBAAoB;AACnD,QAAA,WAAW,GAAG,IAAI,CAAC,CAAC,mBAAmB;AACvC,QAAA,WAAW,GAAG,MAAM,CAAC,CAAC,qBAAqB;AAuCxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACI,KAAK,UAAU,WAAW,CAC/B,MAAwB,EACxB,OAA8B;IAE9B,MAAM,EACJ,cAAc,EACd,eAAe,EACf,OAAO,EACP,mBAAmB,GAAG,4BAA4B,EACnD,GAAG,OAAO,CAAC;IAEZ,6DAA6D;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,eAAe,GAAG,4BAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,oCAAoC,4BAAoB,IAAI,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,eAAe,GAAG,4BAAoB,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,iCAAiC,4BAAoB,IAAI,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,GAAG,mBAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4BAA4B,mBAAW,IAAI,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,GAAG,mBAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yBAAyB,mBAAW,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACZ,4CAA4C;QAC5C,MAAM,MAAM,GAAG,MAAM,MAAM,EAAE,CAAC;QAE9B,gDAAgD;QAChD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,qDAAqD;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACvC,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,YAAY,CAAC,GAAG,mBAAmB,yBAAyB,OAAO,KAAK,CAAC,CAAC;QACtF,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gelatocloud/gasless",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "author": "Gelato",
   "license": "MIT",
   "description": "Gelato Gasless SDK: All-in-one solution for gasless transactions",

package/_dist/relayer/evm/actions/waitForInclusion.d.ts

@@ -1,4 +0,0 @@
-import type { Transport } from 'viem';
-import type { GetStatusParameters, TransactionReceipt } from './getStatus.js';
-export declare const waitForInclusion: (client: ReturnType<Transport>, parameters: GetStatusParameters) => Promise<TransactionReceipt>;
-//# sourceMappingURL=waitForInclusion.d.ts.map

package/_dist/relayer/evm/actions/waitForInclusion.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"waitForInclusion.d.ts","sourceRoot":"","sources":["../../../../relayer/evm/actions/waitForInclusion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAI9E,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,UAAU,CAAC,SAAS,CAAC,EAC7B,YAAY,mBAAmB,KAC9B,OAAO,CAAC,kBAAkB,CAI5B,CAAC"}

package/_dist/relayer/evm/actions/waitForInclusion.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"waitForInclusion.js","sourceRoot":"","sources":["../../../../relayer/evm/actions/waitForInclusion.ts"],"names":[],"mappings":";;;AAGA,uEAAiE;AACjE,yDAAmD;AAE5C,MAAM,gBAAgB,GAAG,KAAK,EACnC,MAA6B,EAC7B,UAA+B,EACF,EAAE;IAC/B,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAa,EAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEvD,OAAO,IAAA,8CAAoB,EAAC,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC,CAAC;AAPW,QAAA,gBAAgB,oBAO3B"}