@beeperbot/sdk 0.2.0 → 0.2.2

package/README.md

@@ -1,4 +1,4 @@
-# @beeper/sdk
+# @beeperbot/sdk
 
 TypeScript SDK for [beep.works](https://beep.works) — the attention layer on Base.
 
@@ -7,7 +7,7 @@ Send paid messages (beeps) to Farcaster users. Look up users, check prices, run
 ## Install
 
 ```bash
-npm install @beeper/sdk
+npm install @beeperbot/sdk
 ```
 
 ## Quick Start — AI Agent
@@ -15,7 +15,7 @@ npm install @beeper/sdk
 The `AgentClient` is the simplest way to integrate beeps into your AI agent or bot.
 
 ```typescript
-import { AgentClient } from '@beeper/sdk';
+import { AgentClient } from '@beeperbot/sdk';
 
 const agent = new AgentClient({
   apiKey: process.env.BEEPER_API_KEY!, // bpk_live_...
@@ -247,7 +247,7 @@ Use filters with `estimate`, `preview`, and `createBulkIntent`.
 For the full deposit → execute → receipt flow:
 
 ```typescript
-import { BeeperClient } from '@beeper/sdk';
+import { BeeperClient } from '@beeperbot/sdk';
 
 const client = new BeeperClient({
   apiKey: process.env.BEEPER_API_KEY!,
@@ -282,7 +282,7 @@ const receipt = await client.pollUntilCompleteByQuoteId(quote.id);
 ## Error Handling
 
 ```typescript
-import { BeeperError, ErrorCodes } from '@beeper/sdk';
+import { BeeperError, ErrorCodes } from '@beeperbot/sdk';
 
 try {
   await agent.lookup('nonexistent');

package/dist/index.cjs

@@ -908,8 +908,16 @@ var ENDPOINTS = {
   PREVIEW: "/agent/preview",
   BULK_INTENT: "/agent/bulk-intent"
 };
-var AgentClient = class {
+var AgentClient = class _AgentClient {
   http;
+  static CHAIN_ID_MAP = {
+    base: 8453,
+    ethereum: 1,
+    mainnet: 1,
+    arbitrum: 42161,
+    polygon: 137,
+    optimism: 10
+  };
   constructor(config) {
     if (!config.apiKey) {
       throw BeeperError.validation("API key is required");
@@ -924,6 +932,62 @@ var AgentClient = class {
     });
     this.http = new HttpClient(httpConfig);
   }
+  /**
+   * Normalize filters for agent endpoints (accepts flexible shapes from other builders)
+   */
+  normalizeFilters(filters) {
+    const normalized = { ...filters };
+    const stripEmptyArray = (key) => {
+      const val = normalized[key];
+      if (Array.isArray(val) && val.length === 0) {
+        delete normalized[key];
+      }
+    };
+    const stripZero = (key) => {
+      const val = normalized[key];
+      if (typeof val === "number" && val === 0) {
+        delete normalized[key];
+      }
+    };
+    if (normalized.platform === "all") delete normalized.platform;
+    if (normalized.spamLabel === "all") delete normalized.spamLabel;
+    stripZero("minFollowers");
+    stripZero("maxFollowers");
+    stripZero("activeInLastDays");
+    stripZero("minBatteryPercentage");
+    stripZero("hasRechargedInLastDays");
+    stripZero("maxAttentionPriceUsd");
+    if (normalized.neynarScoreMin === 0) delete normalized.neynarScoreMin;
+    if (normalized.neynarScoreMax === 1) delete normalized.neynarScoreMax;
+    if (normalized.quotientScoreMin === 0) delete normalized.quotientScoreMin;
+    if (normalized.quotientScoreMax === 1) delete normalized.quotientScoreMax;
+    if (Array.isArray(normalized.countries)) {
+      normalized.countries = normalized.countries.map((c) => typeof c === "string" ? c : c?.code).filter((c) => typeof c === "string" && c.trim().length > 0).map((c) => c.trim().toUpperCase());
+    }
+    stripEmptyArray("countries");
+    if (Array.isArray(normalized.tokenHolders)) {
+      normalized.tokenHolders = normalized.tokenHolders.map((holder) => {
+        if (!holder) return null;
+        if ("tokenAddress" in holder && "chainId" in holder) return holder;
+        const contractAddress = holder.contractAddress;
+        const chain = holder.chain;
+        const minBalance = holder.minBalance;
+        if (!contractAddress || chain == null) return null;
+        const chainId = typeof chain === "number" ? chain : _AgentClient.CHAIN_ID_MAP[String(chain).toLowerCase()] ?? Number(chain);
+        if (!Number.isFinite(chainId)) return null;
+        return {
+          tokenAddress: contractAddress,
+          chainId,
+          ...minBalance ? { minBalance } : {}
+        };
+      }).filter((holder) => !!holder);
+    }
+    stripEmptyArray("tokenHolders");
+    stripEmptyArray("signalTokens");
+    stripEmptyArray("fids");
+    stripEmptyArray("userIds");
+    return normalized;
+  }
   /**
    * Look up a user by username, FID, or wallet address
    *
@@ -1054,7 +1118,7 @@ var AgentClient = class {
     const response = await this.http.post(
       ENDPOINTS.ESTIMATE,
       {
-        filters: input.filters,
+        filters: this.normalizeFilters(input.filters),
         budgetUsd: budgetStr,
         message: input.message
       }
@@ -1084,7 +1148,7 @@ var AgentClient = class {
     const response = await this.http.post(
       ENDPOINTS.PREVIEW,
       {
-        filters: input.filters,
+        filters: this.normalizeFilters(input.filters),
         limit
       }
     );
@@ -1116,7 +1180,7 @@ var AgentClient = class {
     const response = await this.http.post(
       ENDPOINTS.BULK_INTENT,
       {
-        filters: input.filters,
+        filters: this.normalizeFilters(input.filters),
         budgetUsd: budgetStr,
         message: input.message,
         chainId: input.chainId ?? 8453
@@ -1198,6 +1262,7 @@ function maskApiKey(apiKey) {
 }
 
 // src/client/BeeperClient.ts
+var ALLOWED_REWARD_TYPES = ["guaranteed", "lottery", "fcfs"];
 var QuoteSchema = zod.z.object({
   id: zod.z.string(),
   status: zod.z.enum([
@@ -1404,6 +1469,16 @@ var BeeperClient = class {
     if (input.message.length > 1e3) {
       throw BeeperError.validation("Message must be 1000 characters or less");
     }
+    if (input.rewardType !== void 0) {
+      if (input.rewardType.trim().length === 0) {
+        throw BeeperError.validation("rewardType must be a non-empty string");
+      }
+      if (!ALLOWED_REWARD_TYPES.includes(input.rewardType)) {
+        throw BeeperError.validation(
+          `rewardType must be one of: ${ALLOWED_REWARD_TYPES.join(", ")}`
+        );
+      }
+    }
     if (!input.recipientFids?.length && !input.filter) {
       throw BeeperError.validation("Must provide either recipientFids or filter");
     }
@@ -1422,6 +1497,7 @@ var BeeperClient = class {
       filter: input.filter,
       budgetUSD: input.budgetUSD,
       rewardType: input.rewardType ?? "guaranteed",
+      mode: "attention_marketplace",
       memo: input.memo,
       metadata: input.metadata,
       ttlSeconds: opts?.ttlSeconds ?? 300
@@ -2785,11 +2861,10 @@ var FilterBuilder = class _FilterBuilder {
         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) => ({
         contractAddress: o.tokenAddress,
-        chain: chainNames[o.chainId] ?? String(o.chainId),
+        chain: o.chainId === 8453 ? "base" : "ethereum",
         tokenStandard: o.tokenStandard ?? "ERC20",
         ...o.minBalance !== void 0 ? { minBalance: o.minBalance } : {},
         ...o.tokenId !== void 0 ? { tokenId: o.tokenId } : {}