@beeperbot/sdk 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var zod = require('zod');
 var crypto = require('crypto');
+var zod = require('zod');
 
 // src/client/http.ts
 
@@ -50,6 +50,7 @@ var ErrorCodes = {
   DRAFT_NOT_FOUND: "DRAFT_NOT_FOUND",
   DRAFT_INVALID: "DRAFT_INVALID",
   // Generic
+  NOT_FOUND: "NOT_FOUND",
   UNKNOWN_ERROR: "UNKNOWN_ERROR"
 };
 var RETRYABLE_ERROR_CODES = [
@@ -67,8 +68,7 @@ var HTTP_STATUS_TO_ERROR_CODE = {
   400: ErrorCodes.VALIDATION_ERROR,
   401: ErrorCodes.UNAUTHORIZED,
   403: ErrorCodes.FORBIDDEN,
-  404: ErrorCodes.UNKNOWN_ERROR,
-  // Specific 404s are mapped differently
+  404: ErrorCodes.NOT_FOUND,
   408: ErrorCodes.TIMEOUT,
   429: ErrorCodes.RATE_LIMITED,
   500: ErrorCodes.INTERNAL_ERROR,
@@ -201,16 +201,35 @@ var BeeperError = class _BeeperError extends Error {
    * Create from an HTTP response
    */
   static fromHttpResponse(statusCode, body, requestId) {
-    const rawBody = body;
-    const errorData = rawBody?.error ?? rawBody;
-    const code = errorData?.code ?? ErrorCodes.UNKNOWN_ERROR;
-    const message = errorData?.message ?? `HTTP ${statusCode} error`;
+    let code = ErrorCodes.UNKNOWN_ERROR;
+    let message = `HTTP ${statusCode} error`;
+    let details;
+    if (body && typeof body === "object") {
+      const errorBody = body.error;
+      const parsed = errorBody && typeof errorBody === "object" ? errorBody : body;
+      if (parsed.code && typeof parsed.code === "string") {
+        const knownCodes = Object.values(ErrorCodes);
+        code = knownCodes.includes(parsed.code) ? parsed.code : ErrorCodes.UNKNOWN_ERROR;
+      }
+      if (parsed.message && typeof parsed.message === "string") {
+        message = parsed.message;
+      }
+      if (parsed.details && typeof parsed.details === "object") {
+        details = parsed.details;
+      }
+    }
+    if (code === ErrorCodes.UNKNOWN_ERROR) {
+      const statusFallback = HTTP_STATUS_TO_ERROR_CODE[statusCode];
+      if (statusFallback) {
+        code = statusFallback;
+      }
+    }
     const context = { statusCode };
     if (requestId !== void 0) {
       context.requestId = requestId;
     }
-    if (errorData?.details !== void 0) {
-      context.details = errorData.details;
+    if (details !== void 0) {
+      context.details = details;
     }
     return new _BeeperError({
       code,
@@ -228,22 +247,10 @@ var API_BASE_URLS = {
 };
 var TIMEOUTS = {
   /** Default request timeout */
-  DEFAULT: 3e4,
-  /** Timeout for quote requests */
-  QUOTE: 1e4,
-  /** Timeout for execute requests (longer due to blockchain) */
-  EXECUTE: 6e4,
-  /** Timeout for health checks */
-  HEALTH: 5e3
-};
-var ENDPOINTS = {
-  HEALTH: "/send/health",
-  QUOTES: "/send/quotes",
-  KEYS: "/keys"
+  DEFAULT: 3e4
 };
 var HEADERS = {
   IDEMPOTENCY_KEY: "Idempotency-Key",
-  AUTHORIZATION: "Authorization",
   REQUEST_ID: "X-Request-Id",
   CONTENT_TYPE: "Content-Type"
 };
@@ -536,7 +543,7 @@ var HttpClient = class {
   buildHeaders(options) {
     const headers = {
       [HEADERS.CONTENT_TYPE]: "application/json",
-      [HEADERS.AUTHORIZATION]: `Bearer ${this.config.apiKey}`,
+      "Authorization": `Bearer ${this.config.apiKey}`,
       "User-Agent": `beeper-sdk/${SDK_VERSION}`,
       ...options.headers
     };
@@ -586,8 +593,8 @@ var HttpClient = class {
   mergeSignals(signal1, signal2) {
     const controller = new AbortController();
     const abort = () => controller.abort();
-    signal1.addEventListener("abort", abort);
-    signal2.addEventListener("abort", abort);
+    signal1.addEventListener("abort", abort, { once: true });
+    signal2.addEventListener("abort", abort, { once: true });
     if (signal1.aborted || signal2.aborted) {
       controller.abort();
     }
@@ -595,9 +602,7 @@ var HttpClient = class {
   }
 };
 function generateIdempotencyKey() {
-  const timestamp = Date.now().toString(36);
-  const random = Math.random().toString(36).substring(2, 15);
-  return `${timestamp}-${random}`;
+  return `idk_${crypto.randomUUID()}`;
 }
 
 // src/client/filters.schema.ts
@@ -895,7 +900,7 @@ function generateFilterDocumentation() {
 }
 
 // src/client/AgentClient.ts
-var ENDPOINTS2 = {
+var ENDPOINTS = {
   LOOKUP: "/agent/lookup",
   INTENT: "/agent/intent",
   PRICE: "/agent/price",
@@ -905,8 +910,6 @@ var ENDPOINTS2 = {
 };
 var AgentClient = class {
   http;
-  // @ts-expect-error Reserved for future use
-  _debug;
   constructor(config) {
     if (!config.apiKey) {
       throw BeeperError.validation("API key is required");
@@ -920,7 +923,6 @@ var AgentClient = class {
       ...config.debug && { debug: config.debug }
     });
     this.http = new HttpClient(httpConfig);
-    this._debug = config.debug ?? false;
   }
   /**
    * Look up a user by username, FID, or wallet address
@@ -938,7 +940,7 @@ var AgentClient = class {
   async lookup(identifier) {
     const params = typeof identifier === "number" ? { fid: identifier } : { q: identifier };
     const response = await this.http.get(
-      ENDPOINTS2.LOOKUP,
+      ENDPOINTS.LOOKUP,
       { params }
     );
     return response.data.data;
@@ -958,7 +960,7 @@ var AgentClient = class {
   async getPrice(identifier) {
     const params = typeof identifier === "number" ? { fid: identifier } : { q: identifier };
     const response = await this.http.get(
-      ENDPOINTS2.PRICE,
+      ENDPOINTS.PRICE,
       { params }
     );
     return response.data.data;
@@ -992,7 +994,7 @@ var AgentClient = class {
       throw BeeperError.validation("Amount must be a positive number");
     }
     const response = await this.http.post(
-      ENDPOINTS2.INTENT,
+      ENDPOINTS.INTENT,
       {
         to: input.to,
         amountUsd: amountStr,
@@ -1050,7 +1052,7 @@ var AgentClient = class {
       throw BeeperError.validation("Budget must be a positive number");
     }
     const response = await this.http.post(
-      ENDPOINTS2.ESTIMATE,
+      ENDPOINTS.ESTIMATE,
       {
         filters: input.filters,
         budgetUsd: budgetStr,
@@ -1080,7 +1082,7 @@ var AgentClient = class {
   async preview(input) {
     const limit = Math.min(input.limit ?? 10, 20);
     const response = await this.http.post(
-      ENDPOINTS2.PREVIEW,
+      ENDPOINTS.PREVIEW,
       {
         filters: input.filters,
         limit
@@ -1112,7 +1114,7 @@ var AgentClient = class {
       throw BeeperError.validation("Budget must be a positive number");
     }
     const response = await this.http.post(
-      ENDPOINTS2.BULK_INTENT,
+      ENDPOINTS.BULK_INTENT,
       {
         filters: input.filters,
         budgetUsd: budgetStr,
@@ -1186,9 +1188,6 @@ function getApiKeyEnvironment(apiKey) {
   }
   return null;
 }
-function createAuthorizationHeader(apiKey) {
-  return `Bearer ${apiKey}`;
-}
 function maskApiKey(apiKey) {
   if (!apiKey || apiKey.length < 12) {
     return "***";
@@ -1217,15 +1216,7 @@ var QuoteSchema = zod.z.object({
   depositChainId: zod.z.number(),
   depositTokenAddress: zod.z.string(),
   expiresAt: zod.z.string(),
-  input: zod.z.object({
-    filter: zod.z.record(zod.z.unknown()),
-    tokenAddress: zod.z.string(),
-    chainId: zod.z.number(),
-    amountPerRecipient: zod.z.string(),
-    budgetCap: zod.z.string(),
-    memo: zod.z.string().optional(),
-    metadata: zod.z.record(zod.z.unknown()).optional()
-  }),
+  input: zod.z.record(zod.z.unknown()),
   createdAt: zod.z.string(),
   updatedAt: zod.z.string()
 });
@@ -1250,18 +1241,24 @@ var ConfirmResultSchema = zod.z.object({
   status: zod.z.enum(["confirmed", "pending_verification"]),
   detectedAmount: zod.z.string(),
   sufficient: zod.z.boolean(),
-  blockNumber: zod.z.number(),
-  confirmedAt: zod.z.string()
+  blockNumber: zod.z.number().int().optional(),
+  confirmedAt: zod.z.string().datetime().optional()
 });
 var ExecuteResultSchema = zod.z.object({
   quoteId: zod.z.string(),
-  status: zod.z.enum(["executing", "queued"]),
-  estimatedCompletionAt: zod.z.string(),
-  batchId: zod.z.string()
+  status: zod.z.enum(["executing", "queued", "pending_deployment"]),
+  estimatedCompletionAt: zod.z.string().datetime().optional(),
+  batchId: zod.z.string().optional(),
+  deployment: zod.z.object({
+    to: zod.z.string(),
+    data: zod.z.string(),
+    value: zod.z.string(),
+    chainId: zod.z.number()
+  }).optional()
 });
 var ReceiptSchema = zod.z.object({
   quoteId: zod.z.string(),
-  status: zod.z.enum(["completed", "partial", "failed"]),
+  status: zod.z.enum(["completed", "partial", "failed", "executing"]),
   successCount: zod.z.number(),
   failureCount: zod.z.number(),
   totalSent: zod.z.string(),
@@ -1276,7 +1273,12 @@ var ReceiptSchema = zod.z.object({
       error: zod.z.string().optional()
     })
   ),
-  completedAt: zod.z.string()
+  completedAt: zod.z.string().datetime().optional()
+});
+var ConfirmDeploymentResultSchema = zod.z.object({
+  quoteId: zod.z.string(),
+  status: zod.z.string(),
+  escrowId: zod.z.string().optional()
 });
 var HealthSchema = zod.z.object({
   status: zod.z.enum(["healthy", "degraded", "unhealthy"]),
@@ -1288,7 +1290,7 @@ var HealthSchema = zod.z.object({
     oracle: zod.z.enum(["up", "down"])
   })
 });
-var ENDPOINTS3 = {
+var ENDPOINTS2 = {
   QUOTES: "/api/v1/sdk/send/quotes",
   HEALTH: "/api/v1/sdk/send/health"
 };
@@ -1369,7 +1371,7 @@ var BeeperClient = class {
       ttlSeconds: opts?.ttlSeconds ?? 300
     };
     const response = await this.http.post(
-      ENDPOINTS3.QUOTES,
+      ENDPOINTS2.QUOTES,
       body,
       {},
       QuoteSchema
@@ -1425,7 +1427,7 @@ var BeeperClient = class {
       ttlSeconds: opts?.ttlSeconds ?? 300
     };
     const response = await this.http.post(
-      ENDPOINTS3.QUOTES,
+      ENDPOINTS2.QUOTES,
       body,
       {},
       AttentionQuoteSchema
@@ -1439,7 +1441,7 @@ var BeeperClient = class {
    */
   async getQuote(quoteId) {
     const response = await this.http.get(
-      `${ENDPOINTS3.QUOTES}/${quoteId}`,
+      `${ENDPOINTS2.QUOTES}/${quoteId}`,
       {},
       QuoteSchema
     );
@@ -1459,7 +1461,7 @@ var BeeperClient = class {
       throw BeeperError.validation("Invalid transaction hash format");
     }
     const response = await this.http.post(
-      `${ENDPOINTS3.QUOTES}/${quoteId}/confirm`,
+      `${ENDPOINTS2.QUOTES}/${quoteId}/confirm`,
       { txHash: params.txHash },
       { idempotencyKey: params.idempotencyKey },
       ConfirmResultSchema
@@ -1469,21 +1471,46 @@ var BeeperClient = class {
   /**
    * Triggers execution of the send
    * @param quoteId - The quote ID
-   * @param params - Execution parameters including idempotencyKey
+   * @param params - Execution parameters including idempotencyKey and optional deploymentMode
    * @returns Execution result
    */
   async executeSend(quoteId, params) {
     if (!params.idempotencyKey) {
       throw BeeperError.validation("Idempotency key is required for executeSend");
     }
+    const body = {};
+    if (params.deploymentMode) {
+      body.deploymentMode = params.deploymentMode;
+    }
     const response = await this.http.post(
-      `${ENDPOINTS3.QUOTES}/${quoteId}/execute`,
-      {},
+      `${ENDPOINTS2.QUOTES}/${quoteId}/execute`,
+      body,
       { idempotencyKey: params.idempotencyKey },
       ExecuteResultSchema
     );
     return response.data;
   }
+  /**
+   * Confirms a client-side deployment transaction
+   * @param quoteId - The quote ID
+   * @param input - Deployment confirmation parameters including txHash
+   * @returns Deployment confirmation result
+   */
+  async confirmDeployment(quoteId, input) {
+    if (!quoteId) {
+      throw BeeperError.validation("quoteId is required");
+    }
+    if (!input.txHash) {
+      throw BeeperError.validation("txHash is required");
+    }
+    const response = await this.http.post(
+      `${ENDPOINTS2.QUOTES}/${quoteId}/confirm-deployment`,
+      { txHash: input.txHash },
+      { idempotencyKey: `cdep_${quoteId}_${input.txHash.slice(0, 10)}` },
+      ConfirmDeploymentResultSchema
+    );
+    return response.data;
+  }
   /**
    * Gets the receipt for a completed (or failed) execution
    * @param quoteId - The quote ID
@@ -1491,7 +1518,7 @@ var BeeperClient = class {
    */
   async getReceiptByQuoteId(quoteId) {
     const response = await this.http.get(
-      `${ENDPOINTS3.QUOTES}/${quoteId}/receipt`,
+      `${ENDPOINTS2.QUOTES}/${quoteId}/receipt`,
       {},
       ReceiptSchema
     );
@@ -1537,7 +1564,7 @@ var BeeperClient = class {
    */
   async health() {
     const response = await this.http.get(
-      ENDPOINTS3.HEALTH,
+      ENDPOINTS2.HEALTH,
       {},
       HealthSchema
     );
@@ -2159,6 +2186,18 @@ function updateDraft(draft, updates) {
 function isReadyForQuote(draft) {
   return draft.status === "draft" && draft.name.length > 0 && parseFloat(draft.amount) > 0;
 }
+
+// src/send/validation.ts
+function validateQuoteId(quoteId) {
+  if (!quoteId || typeof quoteId !== "string") {
+    throw BeeperError.validation("quoteId is required");
+  }
+  if (!/^qt_[a-zA-Z0-9]+$/.test(quoteId)) {
+    throw BeeperError.validation(`Invalid quoteId format: ${quoteId}. Expected format: qt_<id>`);
+  }
+}
+
+// src/send/quotes.ts
 var ApiQuoteResponseSchema = zod.z.object({
   id: zod.z.string().regex(/^qt_[a-zA-Z0-9]+$/),
   status: zod.z.enum([
@@ -2201,13 +2240,7 @@ async function createQuote(httpClient, draft, opts) {
   return response.data;
 }
 async function getQuote(httpClient, quoteId) {
-  if (!quoteId.match(/^qt_[a-zA-Z0-9]+$/)) {
-    throw new BeeperError({
-      code: ErrorCodes.VALIDATION_ERROR,
-      message: "Invalid quote ID format. Expected format: qt_xxxxx",
-      retryable: false
-    });
-  }
+  validateQuoteId(quoteId);
   const response = await httpClient.get(
     `/api/v1/sdk/send/quotes/${quoteId}`,
     {},
@@ -2229,7 +2262,11 @@ function getChainId(network) {
     polygon: 137,
     optimism: 10
   };
-  return chainIds[network] ?? 1;
+  const id = chainIds[network];
+  if (id === void 0) {
+    throw BeeperError.validation(`Unsupported network: ${network}`);
+  }
+  return id;
 }
 function getTokenAddress(token, network) {
   const addresses = {
@@ -2248,15 +2285,19 @@ function getTokenAddress(token, network) {
       optimism: "0x94b008aA00579c1307B0EF2c499aD98a8ce58e58"
     }
   };
-  return addresses[token]?.[network] ?? "0x0000000000000000000000000000000000000000";
+  const addr = addresses[token]?.[network];
+  if (!addr) {
+    throw BeeperError.validation(`Unsupported token ${token} on network ${network}`);
+  }
+  return addr;
 }
 var ConfirmDepositResponseSchema = zod.z.object({
   quoteId: zod.z.string(),
   status: zod.z.enum(["confirmed", "pending_verification"]),
   detectedAmount: zod.z.string(),
   sufficient: zod.z.boolean(),
-  blockNumber: zod.z.number().int(),
-  confirmedAt: zod.z.string().datetime()
+  blockNumber: zod.z.number().int().optional(),
+  confirmedAt: zod.z.string().datetime().optional()
 });
 async function confirmDeposit(httpClient, quoteId, params) {
   validateQuoteId(quoteId);
@@ -2295,26 +2336,23 @@ function validateTxHash(txHash) {
     });
   }
 }
-function validateQuoteId(quoteId) {
-  if (!quoteId.match(/^qt_[a-zA-Z0-9]+$/)) {
-    throw new BeeperError({
-      code: ErrorCodes.VALIDATION_ERROR,
-      message: "Invalid quote ID format. Expected format: qt_xxxxx",
-      retryable: false
-    });
-  }
-}
 function generateDepositIdempotencyKey(quoteId) {
   return `confirm-${quoteId}`;
 }
 var ExecuteSendResponseSchema = zod.z.object({
   quoteId: zod.z.string(),
-  status: zod.z.enum(["executing", "queued"]),
-  estimatedCompletionAt: zod.z.string().datetime(),
-  batchId: zod.z.string()
-});
-async function executeSend(httpClient, quoteId, params) {
-  validateQuoteId2(quoteId);
+  status: zod.z.enum(["executing", "queued", "pending_deployment"]),
+  estimatedCompletionAt: zod.z.string().datetime().optional(),
+  batchId: zod.z.string().optional(),
+  deployment: zod.z.object({
+    to: zod.z.string(),
+    data: zod.z.string(),
+    value: zod.z.string(),
+    chainId: zod.z.number()
+  }).optional()
+});
+async function executeSend(httpClient, quoteId, params, options) {
+  validateQuoteId(quoteId);
   if (!params.idempotencyKey || params.idempotencyKey.length === 0) {
     throw new BeeperError({
       code: ErrorCodes.VALIDATION_ERROR,
@@ -2322,10 +2360,13 @@ async function executeSend(httpClient, quoteId, params) {
       retryable: false
     });
   }
+  const body = {};
+  if (options?.deploymentMode) {
+    body.deploymentMode = options.deploymentMode;
+  }
   const response = await httpClient.post(
     `/api/v1/sdk/send/quotes/${quoteId}/execute`,
-    {},
-    // Empty body as per HTTP contract
+    body,
     { idempotencyKey: params.idempotencyKey },
     ExecuteSendResponseSchema
   );
@@ -2335,19 +2376,13 @@ function isExecuting(result) {
   return result.status === "executing" || result.status === "queued";
 }
 function getEstimatedTimeRemaining(result) {
+  if (!result.estimatedCompletionAt) {
+    return 0;
+  }
   const estimatedCompletion = new Date(result.estimatedCompletionAt);
   const now = /* @__PURE__ */ new Date();
   return Math.max(0, estimatedCompletion.getTime() - now.getTime());
 }
-function validateQuoteId2(quoteId) {
-  if (!quoteId.match(/^qt_[a-zA-Z0-9]+$/)) {
-    throw new BeeperError({
-      code: ErrorCodes.VALIDATION_ERROR,
-      message: "Invalid quote ID format. Expected format: qt_xxxxx",
-      retryable: false
-    });
-  }
-}
 function generateExecuteIdempotencyKey(quoteId) {
   return `execute-${quoteId}`;
 }
@@ -2360,25 +2395,19 @@ var ReceiptTransactionSchema = zod.z.object({
 });
 var ApiReceiptResponseSchema = zod.z.object({
   quoteId: zod.z.string(),
-  status: zod.z.enum(["completed", "partial", "failed"]),
+  status: zod.z.enum(["completed", "partial", "failed", "executing"]),
   successCount: zod.z.number().int().min(0),
   failureCount: zod.z.number().int().min(0),
   totalSent: zod.z.string(),
   refundAmount: zod.z.string(),
   refundTxHash: zod.z.string().nullable().optional(),
   transactions: zod.z.array(ReceiptTransactionSchema),
-  completedAt: zod.z.string().datetime()
+  completedAt: zod.z.string().datetime().optional()
 });
 var DEFAULT_MAX_ATTEMPTS = 60;
 var DEFAULT_INTERVAL_MS = 5e3;
 async function getReceipt(httpClient, quoteId) {
-  if (!quoteId.match(/^qt_[a-zA-Z0-9]+$/)) {
-    throw new BeeperError({
-      code: ErrorCodes.VALIDATION_ERROR,
-      message: "Invalid quote ID format. Expected format: qt_xxxxx",
-      retryable: false
-    });
-  }
+  validateQuoteId(quoteId);
   const response = await httpClient.get(
     `/api/v1/sdk/send/quotes/${quoteId}/receipt`,
     {},
@@ -2410,7 +2439,7 @@ async function pollUntilComplete(httpClient, quoteId, opts) {
     }
   }
   throw new BeeperError({
-    code: ErrorCodes.QUOTE_EXPIRED,
+    code: ErrorCodes.TIMEOUT,
     message: `Polling timed out after ${maxAttempts} attempts`,
     context: { details: { quoteId, maxAttempts } },
     retryable: false
@@ -2431,11 +2460,27 @@ function getFailedTransactions(receipt) {
 }
 function sleep(ms, signal) {
   return new Promise((resolve, reject) => {
-    const timeoutId = setTimeout(resolve, ms);
-    signal?.addEventListener("abort", () => {
-      clearTimeout(timeoutId);
-      reject(new Error("Aborted"));
-    });
+    if (signal?.aborted) {
+      reject(new BeeperError({
+        code: ErrorCodes.TIMEOUT,
+        message: "Poll aborted by signal",
+        retryable: false
+      }));
+      return;
+    }
+    const timer = setTimeout(() => {
+      if (signal) signal.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    function onAbort() {
+      clearTimeout(timer);
+      reject(new BeeperError({
+        code: ErrorCodes.TIMEOUT,
+        message: "Poll aborted by signal",
+        retryable: false
+      }));
+    }
+    if (signal) signal.addEventListener("abort", onAbort, { once: true });
   });
 }
 
@@ -2470,7 +2515,7 @@ var FilterExpression = class {
     return FilterBuilder.not(this);
   }
 };
-var FilterBuilder = class {
+var FilterBuilder = class _FilterBuilder {
   // ===========================================================================
   // Logical Combinators
   // ===========================================================================
@@ -2480,7 +2525,7 @@ var FilterBuilder = class {
    */
   static and(filters) {
     if (filters.length === 0) {
-      throw new Error("and() requires at least one filter");
+      throw BeeperError.validation("and() requires at least one filter");
     }
     if (filters.length === 1) {
       return filters[0];
@@ -2495,7 +2540,7 @@ var FilterBuilder = class {
    */
   static or(filters) {
     if (filters.length === 0) {
-      throw new Error("or() requires at least one filter");
+      throw BeeperError.validation("or() requires at least one filter");
     }
     if (filters.length === 1) {
       return filters[0];
@@ -2532,7 +2577,7 @@ var FilterBuilder = class {
    */
   static activeInLastDays(days) {
     if (days < 1 || days > 365) {
-      throw new Error("activeInLastDays must be between 1 and 365");
+      throw BeeperError.validation("activeInLastDays must be between 1 and 365");
     }
     return new FilterExpression({ activeInLastDays: days });
   }
@@ -2545,7 +2590,7 @@ var FilterBuilder = class {
    */
   static neynarScoreMin(score) {
     if (score < 0 || score > 1) {
-      throw new Error("neynarScoreMin must be between 0 and 1");
+      throw BeeperError.validation("neynarScoreMin must be between 0 and 1");
     }
     return new FilterExpression({ neynarScoreMin: score });
   }
@@ -2555,7 +2600,7 @@ var FilterBuilder = class {
    */
   static neynarScoreMax(score) {
     if (score < 0 || score > 1) {
-      throw new Error("neynarScoreMax must be between 0 and 1");
+      throw BeeperError.validation("neynarScoreMax must be between 0 and 1");
     }
     return new FilterExpression({ neynarScoreMax: score });
   }
@@ -2566,10 +2611,10 @@ var FilterBuilder = class {
    */
   static neynarScoreRange(min, max) {
     if (min !== void 0 && (min < 0 || min > 1)) {
-      throw new Error("neynarScoreRange min must be between 0 and 1");
+      throw BeeperError.validation("neynarScoreRange min must be between 0 and 1");
     }
     if (max !== void 0 && (max < 0 || max > 1)) {
-      throw new Error("neynarScoreRange max must be between 0 and 1");
+      throw BeeperError.validation("neynarScoreRange max must be between 0 and 1");
     }
     const range = {};
     if (min !== void 0) range.min = min;
@@ -2584,11 +2629,10 @@ var FilterBuilder = class {
     return new FilterExpression({ spamLabel: label });
   }
   /**
-   * Filter to exclude spam users (convenience method)
-   * @deprecated Use spamLabel('not_spam_only') instead
+   * Convenience method: exclude spam users (shorthand for spamLabel('not_spam_only'))
    */
   static excludeSpam() {
-    return new FilterExpression({ spamLabel: "not_spam_only" });
+    return _FilterBuilder.spamLabel("not_spam_only");
   }
   // ===========================================================================
   // Social Graph Filters (Followers)
@@ -2599,7 +2643,7 @@ var FilterBuilder = class {
    */
   static minFollowers(count) {
     if (count < 0) {
-      throw new Error("minFollowers must be >= 0");
+      throw BeeperError.validation("minFollowers must be >= 0");
     }
     return new FilterExpression({ minFollowers: count });
   }
@@ -2609,7 +2653,7 @@ var FilterBuilder = class {
    */
   static maxFollowers(count) {
     if (count < 0) {
-      throw new Error("maxFollowers must be >= 0");
+      throw BeeperError.validation("maxFollowers must be >= 0");
     }
     return new FilterExpression({ maxFollowers: count });
   }
@@ -2620,10 +2664,10 @@ var FilterBuilder = class {
    */
   static followerRange(min, max) {
     if (min !== void 0 && min < 0) {
-      throw new Error("followerRange min must be >= 0");
+      throw BeeperError.validation("followerRange min must be >= 0");
     }
     if (max !== void 0 && max < 0) {
-      throw new Error("followerRange max must be >= 0");
+      throw BeeperError.validation("followerRange max must be >= 0");
     }
     const range = {};
     if (min !== void 0) range.min = min;
@@ -2636,7 +2680,7 @@ var FilterBuilder = class {
    */
   static followersOf(fid) {
     if (fid < 1) {
-      throw new Error("followersOf FID must be >= 1");
+      throw BeeperError.validation("followersOf FID must be >= 1");
     }
     return new FilterExpression({ followersOf: fid });
   }
@@ -2646,7 +2690,7 @@ var FilterBuilder = class {
    */
   static mutualsWith(fid) {
     if (fid < 1) {
-      throw new Error("mutualsWith FID must be >= 1");
+      throw BeeperError.validation("mutualsWith FID must be >= 1");
     }
     return new FilterExpression({ mutualsWith: fid });
   }
@@ -2659,7 +2703,7 @@ var FilterBuilder = class {
    */
   static maxAttentionPriceUsd(usd) {
     if (usd < 0) {
-      throw new Error("maxAttentionPriceUsd must be >= 0");
+      throw BeeperError.validation("maxAttentionPriceUsd must be >= 0");
     }
     return new FilterExpression({ maxAttentionPriceUsd: usd });
   }
@@ -2672,11 +2716,11 @@ var FilterBuilder = class {
    */
   static tokenHolder(opts) {
     if (!/^0x[a-fA-F0-9]{40}$/.test(opts.tokenAddress)) {
-      throw new Error("tokenAddress must be a valid Ethereum address");
+      throw BeeperError.validation("tokenAddress must be a valid Ethereum address");
     }
     if (opts.minBalance !== void 0) {
       if (!/^[0-9]+$/.test(opts.minBalance)) {
-        throw new Error("minBalance must be a numeric string (wei)");
+        throw BeeperError.validation("minBalance must be a numeric string (wei)");
       }
       return new FilterExpression({
         walletMinBalance: {
@@ -2699,24 +2743,26 @@ var FilterBuilder = class {
    */
   static tokenHolders(opts) {
     if (opts.length === 0) {
-      throw new Error("tokenHolders requires at least one token option");
+      throw BeeperError.validation("tokenHolders requires at least one token option");
     }
     if (opts.length > 10) {
       throw new Error("tokenHolders cannot exceed 10 tokens");
     }
     for (const opt of opts) {
       if (!/^0x[a-fA-F0-9]{40}$/.test(opt.tokenAddress)) {
-        throw new Error("tokenAddress must be a valid Ethereum address");
+        throw BeeperError.validation("tokenAddress must be a valid Ethereum address");
       }
       if (opt.minBalance !== void 0 && !/^[0-9]+$/.test(opt.minBalance)) {
-        throw new Error("minBalance must be a numeric string (wei)");
+        throw BeeperError.validation("minBalance must be a numeric string (wei)");
       }
     }
     return new FilterExpression({
       tokenHolders: opts.map((o) => ({
-        tokenAddress: o.tokenAddress,
-        chainId: o.chainId,
-        ...o.minBalance !== void 0 ? { minBalance: o.minBalance } : {}
+        contractAddress: o.tokenAddress,
+        chain: o.chainId === 8453 ? "base" : "ethereum",
+        tokenStandard: o.tokenStandard ?? "ERC20",
+        ...o.minBalance !== void 0 ? { minBalance: o.minBalance } : {},
+        ...o.tokenId !== void 0 ? { tokenId: o.tokenId } : {}
       }))
     });
   }
@@ -2739,11 +2785,14 @@ var FilterBuilder = class {
         throw new Error("minBalance must be a numeric string (wei)");
       }
     }
+    const chainNames = { 1: "ethereum", 8453: "base", 42161: "arbitrum", 10: "optimism", 137: "polygon" };
     return new FilterExpression({
       cachedTokenHolders: opts.map((o) => ({
-        tokenAddress: o.tokenAddress,
-        chainId: o.chainId,
-        ...o.minBalance !== void 0 ? { minBalance: o.minBalance } : {}
+        contractAddress: o.tokenAddress,
+        chain: chainNames[o.chainId] ?? String(o.chainId),
+        tokenStandard: o.tokenStandard ?? "ERC20",
+        ...o.minBalance !== void 0 ? { minBalance: o.minBalance } : {},
+        ...o.tokenId !== void 0 ? { tokenId: o.tokenId } : {}
       }))
     });
   }
@@ -2805,7 +2854,7 @@ var FilterBuilder = class {
    */
   static minTenureDays(days) {
     if (days < 0) {
-      throw new Error("minTenureDays must be >= 0");
+      throw BeeperError.validation("minTenureDays must be >= 0");
     }
     return new FilterExpression({ minTenureDays: days });
   }
@@ -2825,10 +2874,10 @@ var FilterBuilder = class {
    */
   static userIds(ids) {
     if (ids.length === 0) {
-      throw new Error("userIds requires at least one ID");
+      throw BeeperError.validation("userIds requires at least one ID");
     }
     if (ids.length > 1e3) {
-      throw new Error("userIds cannot exceed 1000 IDs");
+      throw BeeperError.validation("userIds cannot exceed 1000 IDs");
     }
     return new FilterExpression({ userIds: ids });
   }
@@ -2845,10 +2894,10 @@ var FilterBuilder = class {
    */
   static fids(fids) {
     if (fids.length === 0) {
-      throw new Error("fids requires at least one FID");
+      throw BeeperError.validation("fids requires at least one FID");
     }
     if (fids.length > 1e3) {
-      throw new Error("fids cannot exceed 1000 FIDs");
+      throw BeeperError.validation("fids cannot exceed 1000 FIDs");
     }
     return new FilterExpression({ fids });
   }
@@ -2861,7 +2910,7 @@ var FilterBuilder = class {
    */
   static hasTag(tag) {
     if (tag.length > 64) {
-      throw new Error("Tag must be 64 characters or less");
+      throw BeeperError.validation("Tag must be 64 characters or less");
     }
     return new FilterExpression({ hasTag: tag });
   }
@@ -2871,7 +2920,7 @@ var FilterBuilder = class {
    */
   static hasAnyTag(tags) {
     if (tags.length === 0 || tags.length > 20) {
-      throw new Error("hasAnyTag requires 1-20 tags");
+      throw BeeperError.validation("hasAnyTag requires 1-20 tags");
     }
     return new FilterExpression({ hasAnyTag: tags });
   }
@@ -2881,7 +2930,7 @@ var FilterBuilder = class {
    */
   static hasAllTags(tags) {
     if (tags.length === 0 || tags.length > 20) {
-      throw new Error("hasAllTags requires 1-20 tags");
+      throw BeeperError.validation("hasAllTags requires 1-20 tags");
     }
     return new FilterExpression({ hasAllTags: tags });
   }
@@ -2952,17 +3001,17 @@ var FilterBuilder = class {
    */
   static timezones(zones) {
     if (zones.length === 0) {
-      throw new Error("timezones requires at least one timezone");
+      throw BeeperError.validation("timezones requires at least one timezone");
     }
     if (zones.length > 24) {
       throw new Error("timezones cannot exceed 24 entries");
     }
     for (const zone of zones) {
       if (zone.offset < -12 || zone.offset > 14) {
-        throw new Error("timezone offset must be between -12 and 14");
+        throw BeeperError.validation("timezone offset must be between -12 and 14");
       }
       if (zone.range !== void 0 && (zone.range < 0 || zone.range > 12)) {
-        throw new Error("timezone range must be between 0 and 12");
+        throw BeeperError.validation("timezone range must be between 0 and 12");
       }
     }
     return new FilterExpression({ timezones: zones });
@@ -2973,28 +3022,28 @@ var FilterBuilder = class {
    */
   static countries(codes) {
     if (codes.length === 0) {
-      throw new Error("countries requires at least one country code");
+      throw BeeperError.validation("countries requires at least one country code");
     }
     if (codes.length > 50) {
       throw new Error("countries cannot exceed 50 country codes");
     }
     for (const code of codes) {
       if (!/^[A-Z]{2}$/.test(code)) {
-        throw new Error("Country codes must be ISO 3166-1 alpha-2 format (e.g., US, CA, GB)");
+        throw BeeperError.validation("Country codes must be ISO 3166-1 alpha-2 format (e.g., US, CA, GB)");
       }
     }
-    return new FilterExpression({ countries: codes.map((code) => ({ code })) });
+    return new FilterExpression({ countries: codes.map((c) => ({ code: c })) });
   }
   // ===========================================================================
   // Engagement & Quality Filters
   // ===========================================================================
   /**
    * Filter users with quotient score >= minimum
-   * @param score - Minimum quotient score (0-1, where 0.5=Casual, 0.75=Influential, 0.9=Exceptional)
+   * @param score - Minimum quotient score (0-1)
    */
   static quotientScoreMin(score) {
     if (score < 0 || score > 1) {
-      throw new Error("quotientScoreMin must be between 0 and 1");
+      throw BeeperError.validation("quotientScoreMin must be between 0 and 1");
     }
     return new FilterExpression({ quotientScoreMin: score });
   }
@@ -3004,7 +3053,7 @@ var FilterBuilder = class {
    */
   static quotientScoreMax(score) {
     if (score < 0 || score > 1) {
-      throw new Error("quotientScoreMax must be between 0 and 1");
+      throw BeeperError.validation("quotientScoreMax must be between 0 and 1");
     }
     return new FilterExpression({ quotientScoreMax: score });
   }
@@ -3031,7 +3080,7 @@ var FilterBuilder = class {
    */
   static minBatteryPercentage(pct) {
     if (pct < 0 || pct > 100) {
-      throw new Error("minBatteryPercentage must be between 0 and 100");
+      throw BeeperError.validation("minBatteryPercentage must be between 0 and 100");
     }
     return new FilterExpression({ minBatteryPercentage: pct });
   }
@@ -3041,7 +3090,7 @@ var FilterBuilder = class {
    */
   static hasRechargedInLastDays(days) {
     if (days < 1) {
-      throw new Error("hasRechargedInLastDays must be >= 1");
+      throw BeeperError.validation("hasRechargedInLastDays must be >= 1");
     }
     return new FilterExpression({ hasRechargedInLastDays: days });
   }
@@ -3075,7 +3124,7 @@ var FilterBuilder = class {
    */
   static minCastCount(count) {
     if (count < 0) {
-      throw new Error("minCastCount must be >= 0");
+      throw BeeperError.validation("minCastCount must be >= 0");
     }
     return new FilterExpression({ minCastCount: count });
   }
@@ -3089,18 +3138,6 @@ var FilterBuilder = class {
   static orderBy(order) {
     return new FilterExpression({ orderBy: order });
   }
-  /**
-   * Limit the number of results
-   * @param n - Maximum number of results
-   * @deprecated Limit is controlled by budgetCap, not this filter. This method will be removed.
-   */
-  static limit(n) {
-    console.warn("FilterBuilder.limit() is deprecated. Use budgetCap to control result count.");
-    if (n < 1 || n > 1e4) {
-      throw new Error("limit must be between 1 and 10000");
-    }
-    return new FilterExpression({ limit: n });
-  }
 };
 var GasTierSchema = zod.z.enum(["slow", "standard", "fast"]);
 var QuoteOptionsSchema = zod.z.object({
@@ -3220,7 +3257,6 @@ exports.DraftInputSchema = DraftInputSchema;
 exports.DraftSchema = DraftSchema;
 exports.DraftStatusSchema = DraftStatusSchema;
 exports.DraftUpdateSchema = DraftUpdateSchema;
-exports.ENDPOINTS = ENDPOINTS;
 exports.ErrorCodes = ErrorCodes;
 exports.ExcludePingedTodayFilterSchema = ExcludePingedTodayFilterSchema;
 exports.ExcludeUsersFilterSchema = ExcludeUsersFilterSchema;
@@ -3299,7 +3335,6 @@ exports.TokenHolderFilterSchema = TokenHolderFilterSchema;
 exports.TokenTypeSchema = TokenTypeSchema;
 exports.TransferStatusSchema = TransferStatusSchema;
 exports.VerifiedOnlyFilterSchema = VerifiedOnlyFilterSchema;
-exports.createAuthorizationHeader = createAuthorizationHeader;
 exports.createHttpConfig = createHttpConfig;
 exports.default = BeeperClient_default;
 exports.describeFilters = describeFilters;