pounce-agent-data 1.0.1 → 2.0.0

package/dist/index.d.ts

@@ -1,204 +1,146 @@
 /**
- * Pounce Agent Data SDK - TypeScript Client
- *
- * Minimal client for the Pounce Agent Data API.
- * Supports recent signals, semantic search, signal details, and SSE streaming.
+ * Pounce Agent Data SDK — TypeScript client for the Pounce v2 Entity API.
  *
  * @example
- * ```typescript
- * import { PounceAgentDataClient } from '@pounce/agent-data';
- *
- * const client = new PounceAgentDataClient({ apiKey: 'pounce_live_xxx' });
- *
- * // Recent signals
- * const { json, rateLimit } = await client.recentSignals({ limit: 10, category: 'saas' });
+ * ```ts
+ * import { PounceClient } from 'pounce-agent-data';
  *
- * // Semantic search
- * const results = await client.search('AI companies in healthcare', { limit: 20 });
- *
- * // Stream new signals
- * for await (const signal of client.stream({ minScore: 70 })) {
- *   console.log(signal);
- * }
+ * const client = new PounceClient({ apiKey: 'your_key' });
+ * const { data } = await client.search({ q: 'AI companies', country: 'CH' });
+ * data.items.forEach(c => console.log(c.canonical_name, c.primary_domain));
  * ```
  */
-type RateLimitInfo = {
-    limit?: number;
-    remaining?: number;
-    resetUnix?: number;
-};
-type Signal = {
-    signalId: string;
-    domain: string;
-    companyName?: string | null;
-    category?: string | null;
-    subcategory?: string | null;
-    signalScore: number;
-    trustScore?: number | null;
-    intentTags?: string[] | null;
-    techStack?: string[] | null;
-    country?: string | null;
-    description?: string | null;
-    detectedAt?: string | null;
-    uiUrl?: string | null;
-};
-type AgentDataRecentSignal = {
+export interface EntitySummary {
     id: number;
-    signal_id?: string;
-    domain: string;
-    tld: string;
-    title?: string | null;
-    description?: string | null;
-    h1?: string | null;
-    category?: string | null;
-    subcategory?: string | null;
-    business_type?: string | null;
-    signal_score: number;
-    signal_grade?: string | null;
-    tech_stack?: string[] | null;
-    intent_tags?: string[] | null;
-    hosting_provider?: string | null;
-    country?: string | null;
-    has_real_content: boolean;
-    scanned_at?: string | null;
-    discovered_at: string;
-    ui_url?: string | null;
-};
-type RecentSignalsResponse = {
-    items: AgentDataRecentSignal[];
-    count: number;
-    has_more?: boolean;
-};
-type SemanticSearchItem = {
-    signal_id: string;
-    domain: string;
-    company_name?: string | null;
-    category?: string | null;
-    signal_score: number;
-    similarity: number;
-    snippet?: string | null;
-    intent_tags?: string[] | null;
-    country?: string | null;
-    ui_url?: string | null;
-};
-type SemanticSearchResponse = {
-    items: SemanticSearchItem[];
-    count: number;
-    query_tokens?: number;
-};
-type SignalDetailResponse = {
-    signal_id: string;
-    domain: string;
-    company_name?: string | null;
-    category?: string | null;
-    subcategory?: string | null;
-    signal_score: number;
-    trust_score?: number | null;
-    intent_tags?: string[] | null;
-    tech_stack?: string[] | null;
-    country?: string | null;
-    description?: string | null;
-    social_links?: Record<string, string> | null;
-    detected_at?: string | null;
-    ui_url?: string | null;
-};
-type AgentDataUsageResponse = {
-    api_key_prefix: string;
-    usage: {
-        period_start: string;
-        period_end: string;
-        used: number;
-        limit: number;
-        remaining: number;
-        reset_at: string;
-    };
-};
-type RecentSignalsOptions = {
-    hours?: number;
-    limit?: number;
-    minScore?: number;
-    category?: string;
-    country?: string;
-    tlds?: string[];
-};
-type SemanticSearchOptions = {
-    limit?: number;
-    minScore?: number;
-    category?: string;
-    country?: string;
-    tlds?: string[];
-};
-type StreamOptions = {
-    minScore?: number;
-    category?: string;
-    since?: string;
-};
-declare class PounceAgentDataClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    constructor(options: {
-        apiKey: string;
-        baseUrl?: string;
-    });
-    private extractRateLimit;
-    private getJson;
-    private postJson;
-    /**
-     * Get recent B2B signals.
-     */
-    recentSignals(options?: RecentSignalsOptions): Promise<{
-        json: RecentSignalsResponse;
-        rateLimit: RateLimitInfo;
+    canonical_name: string | null;
+    country: string | null;
+    city: string | null;
+    trust_tier: number;
+    quality_score: number;
+    primary_domain: string | null;
+    categories: Record<string, unknown> | null;
+    first_seen_at: string | null;
+}
+export interface SemanticSearchItem extends EntitySummary {
+    description: string | null;
+    employee_estimate: number | null;
+    relevance_score: number;
+}
+export interface EntityDetail extends EntitySummary {
+    legal_name: string | null;
+    lei: string | null;
+    region: string | null;
+    tech_stack: Record<string, unknown> | null;
+    keywords: string[] | null;
+    description: string | null;
+    employee_estimate: number | null;
+    revenue_estimate_usd: number | null;
+    founded_year: number | null;
+    legal_form: string | null;
+    is_verified: boolean;
+    intent_signals: Record<string, unknown> | null;
+    social_links: Record<string, string> | null;
+    last_enriched_at: string | null;
+    domains: Array<{
+        domain: string;
+        is_primary: boolean;
+        source: string | null;
     }>;
-    /**
-     * Semantic search for signals using natural language.
-     *
-     * @param query - Natural language search query
-     * @param options - Search options
-     *
-     * @example
-     * ```typescript
-     * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
-     * for (const item of json.items) {
-     *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
-     * }
-     * ```
-     */
-    search(query: string, options?: SemanticSearchOptions): Promise<{
-        json: SemanticSearchResponse;
-        rateLimit: RateLimitInfo;
+    registrations: Array<{
+        registry: string;
+        registry_id: string;
+        legal_name: string | null;
     }>;
-    /**
-     * Get full details for a specific signal.
-     */
-    signalDetail(signalId: string): Promise<{
-        json: SignalDetailResponse;
-        rateLimit: RateLimitInfo;
+    financials: Array<{
+        source: string;
+        fiscal_year: number | null;
+        revenue: number | null;
     }>;
-    /**
-     * Get API usage information for your account.
-     */
-    usage(): Promise<{
-        json: AgentDataUsageResponse;
-        rateLimit: RateLimitInfo;
+    connections: Array<{
+        connected_entity_id: number;
+        connection_type: string;
     }>;
-    /**
-     * Stream new signals in real-time via SSE.
-     *
-     * @param options - Stream options
-     *
-     * @example
-     * ```typescript
-     * for await (const signal of client.stream({ minScore: 70 })) {
-     *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
-     * }
-     * ```
-     *
-     * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
-     */
-    stream(options?: StreamOptions): AsyncGenerator<Signal, void, unknown>;
-    private parseSignal;
 }
-declare const PounceClient: typeof PounceAgentDataClient;
-
-export { type AgentDataRecentSignal, type AgentDataUsageResponse, PounceAgentDataClient, PounceClient, type RateLimitInfo, type RecentSignalsOptions, type RecentSignalsResponse, type SemanticSearchItem, type SemanticSearchOptions, type SemanticSearchResponse, type Signal, type SignalDetailResponse, type StreamOptions };
+export interface SearchResponse {
+    items: EntitySummary[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface SemanticSearchResponse {
+    items: SemanticSearchItem[];
+    total: number;
+    query: string;
+}
+export interface BulkResponse {
+    items: EntitySummary[];
+    not_found: string[];
+}
+export interface MatchScoreResponse {
+    entity_a_id: number;
+    entity_b_id: number;
+    score: number;
+    grade: string;
+    dimensions: {
+        offering_fit: number;
+        timing: number;
+        trust: number;
+        reciprocity: number;
+    };
+    evidence: string[];
+}
+export interface StatsResponse {
+    total_entities: number;
+    verified_entities: number;
+    countries_covered: number;
+    api_version: string;
+}
+export interface RateLimitInfo {
+    remaining: number;
+    creditsUsed: number;
+}
+export interface ApiResponse<T> {
+    data: T;
+    rateLimit: RateLimitInfo;
+}
+export declare class PounceError extends Error {
+    statusCode: number;
+    detail: unknown;
+    constructor(statusCode: number, detail: unknown);
+}
+export interface PounceClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export declare class PounceClient {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor(options?: PounceClientOptions);
+    private request;
+    /** Search companies with filters (1 credit). */
+    search(options?: {
+        q?: string;
+        country?: string;
+        category?: string;
+        minTrustTier?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<ApiResponse<SearchResponse>>;
+    /** AI semantic search by natural language (2 credits). */
+    semanticSearch(query: string, options?: {
+        country?: string;
+        limit?: number;
+    }): Promise<ApiResponse<SemanticSearchResponse>>;
+    /** Look up a company by domain (1 credit). */
+    lookup(domain: string): Promise<ApiResponse<EntitySummary>>;
+    /** Get full company profile by ID (1 credit). */
+    detail(entityId: number): Promise<ApiResponse<EntityDetail>>;
+    /** Bulk lookup by domains, max 100 (1 credit per found). */
+    bulkLookup(domains: string[]): Promise<ApiResponse<BulkResponse>>;
+    /** Compute match score between two companies (3 credits, Business+). */
+    matchScore(entityAId: number, entityBId: number): Promise<ApiResponse<MatchScoreResponse>>;
+    /** Get public platform statistics (free, no auth). */
+    stats(): Promise<ApiResponse<StatsResponse>>;
+}

package/dist/index.js

@@ -1,244 +1,127 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  PounceAgentDataClient: () => PounceAgentDataClient,
-  PounceClient: () => PounceClient
-});
-module.exports = __toCommonJS(index_exports);
-var PounceAgentDataClient = class {
-  apiKey;
-  baseUrl;
-  constructor(options) {
-    this.apiKey = options.apiKey;
-    this.baseUrl = (options.baseUrl ?? "https://api.pounce.ch").replace(/\/$/, "");
-    if (!this.apiKey.startsWith("pounce_live_")) {
-      throw new Error("Invalid API key format (expected pounce_live_...)");
+/**
+ * Pounce Agent Data SDK — TypeScript client for the Pounce v2 Entity API.
+ *
+ * @example
+ * ```ts
+ * import { PounceClient } from 'pounce-agent-data';
+ *
+ * const client = new PounceClient({ apiKey: 'your_key' });
+ * const { data } = await client.search({ q: 'AI companies', country: 'CH' });
+ * data.items.forEach(c => console.log(c.canonical_name, c.primary_domain));
+ * ```
+ */
+const API_BASE = 'https://api.pounce.ch';
+const V2_PREFIX = '/api/v1/v2';
+export class PounceError extends Error {
+    constructor(statusCode, detail) {
+        super(`Pounce API error ${statusCode}: ${JSON.stringify(detail)}`);
+        this.statusCode = statusCode;
+        this.detail = detail;
+        this.name = 'PounceError';
     }
-  }
-  extractRateLimit(res) {
-    return {
-      limit: res.headers.get("X-RateLimit-Limit") ? Number(res.headers.get("X-RateLimit-Limit")) : void 0,
-      remaining: res.headers.get("X-RateLimit-Remaining") ? Number(res.headers.get("X-RateLimit-Remaining")) : void 0,
-      resetUnix: res.headers.get("X-RateLimit-Reset") ? Number(res.headers.get("X-RateLimit-Reset")) : void 0
-    };
-  }
-  async getJson(path, params) {
-    const url = new URL(this.baseUrl + path);
-    if (params) {
-      for (const [k, v] of Object.entries(params)) {
-        if (v !== void 0) url.searchParams.set(k, String(v));
-      }
+}
+export class PounceClient {
+    constructor(options = {}) {
+        this.apiKey = options.apiKey || process.env.POUNCE_API_KEY || '';
+        this.baseUrl = (options.baseUrl || process.env.POUNCE_API_BASE || API_BASE).replace(/\/$/, '');
+        this.timeout = options.timeout || 30000;
     }
-    const res = await fetch(url.toString(), {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        Accept: "application/json"
-      }
-    });
-    const rateLimit = this.extractRateLimit(res);
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`HTTP ${res.status}: ${text}`);
+    async request(method, path, options) {
+        let url = `${this.baseUrl}${V2_PREFIX}${path}`;
+        if (options?.params) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(options.params)) {
+                if (value !== undefined && value !== null) {
+                    searchParams.set(key, String(value));
+                }
+            }
+            const qs = searchParams.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                    'User-Agent': 'pounce-agent-data/2.0.0 typescript',
+                },
+                body: options?.body ? JSON.stringify(options.body) : undefined,
+                signal: controller.signal,
+            });
+            const rateLimit = {
+                remaining: parseInt(response.headers.get('x-ratelimit-remaining') || '-1', 10),
+                creditsUsed: parseInt(response.headers.get('x-credits-used') || '0', 10),
+            };
+            if (!response.ok) {
+                let detail;
+                try {
+                    detail = await response.json();
+                }
+                catch {
+                    detail = await response.text();
+                }
+                throw new PounceError(response.status, detail);
+            }
+            const data = (await response.json());
+            return { data, rateLimit };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
     }
-    const json = await res.json();
-    return { json, rateLimit };
-  }
-  async postJson(path, body) {
-    const url = new URL(this.baseUrl + path);
-    const res = await fetch(url.toString(), {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        Accept: "application/json",
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
-    });
-    const rateLimit = this.extractRateLimit(res);
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`HTTP ${res.status}: ${text}`);
+    /** Search companies with filters (1 credit). */
+    async search(options = {}) {
+        const params = {
+            limit: options.limit || 25,
+            offset: options.offset || 0,
+            min_trust_tier: options.minTrustTier || 3,
+        };
+        if (options.q)
+            params.q = options.q;
+        if (options.country)
+            params.country = options.country.toUpperCase();
+        if (options.category)
+            params.category = options.category;
+        return this.request('GET', '/entities/search', { params });
     }
-    const json = await res.json();
-    return { json, rateLimit };
-  }
-  // ---------------------------------------------------------------------------
-  // Public API Methods
-  // ---------------------------------------------------------------------------
-  /**
-   * Get recent B2B signals.
-   */
-  async recentSignals(options = {}) {
-    const { hours = 24, limit = 100, minScore = 50, category, country, tlds } = options;
-    return this.getJson("/api/v1/agent-data/signals/recent", {
-      hours,
-      limit,
-      min_score: minScore,
-      category,
-      country,
-      tlds: tlds?.join(",")
-    });
-  }
-  /**
-   * Semantic search for signals using natural language.
-   *
-   * @param query - Natural language search query
-   * @param options - Search options
-   *
-   * @example
-   * ```typescript
-   * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
-   * for (const item of json.items) {
-   *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
-   * }
-   * ```
-   */
-  async search(query, options = {}) {
-    const { limit = 20, minScore = 50, category, country, tlds } = options;
-    const body = {
-      query,
-      limit,
-      min_score: minScore
-    };
-    const filters = {};
-    if (category) filters.category = category;
-    if (country) filters.country = country;
-    if (tlds) filters.tlds = tlds;
-    if (Object.keys(filters).length > 0) body.filters = filters;
-    return this.postJson(
-      "/api/v1/agent-data/search/semantic",
-      body
-    );
-  }
-  /**
-   * Get full details for a specific signal.
-   */
-  async signalDetail(signalId) {
-    return this.getJson(
-      `/api/v1/agent-data/signals/${encodeURIComponent(signalId)}`
-    );
-  }
-  /**
-   * Get API usage information for your account.
-   */
-  async usage() {
-    return this.getJson("/api/v1/agent-data/usage");
-  }
-  /**
-   * Stream new signals in real-time via SSE.
-   *
-   * @param options - Stream options
-   *
-   * @example
-   * ```typescript
-   * for await (const signal of client.stream({ minScore: 70 })) {
-   *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
-   * }
-   * ```
-   *
-   * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
-   */
-  async *stream(options = {}) {
-    const { minScore = 50, category, since } = options;
-    const url = new URL(`${this.baseUrl}/api/v1/agent-data/streams/signals`);
-    url.searchParams.set("min_score", String(minScore));
-    if (category) url.searchParams.set("category", category);
-    if (since) url.searchParams.set("since", since);
-    const res = await fetch(url.toString(), {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        Accept: "text/event-stream"
-      }
-    });
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`HTTP ${res.status}: ${text}`);
+    /** AI semantic search by natural language (2 credits). */
+    async semanticSearch(query, options) {
+        return this.request('POST', '/entities/search/semantic', {
+            body: {
+                query,
+                country: options?.country?.toUpperCase(),
+                limit: options?.limit || 25,
+            },
+        });
     }
-    if (!res.body) {
-      throw new Error("Response body is null");
+    /** Look up a company by domain (1 credit). */
+    async lookup(domain) {
+        return this.request('GET', '/entities/lookup', {
+            params: { domain },
+        });
     }
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    let eventType = null;
-    let dataBuffer = [];
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split("\n");
-        buffer = lines.pop() ?? "";
-        for (const line of lines) {
-          const trimmed = line.replace(/\r$/, "");
-          if (!trimmed) {
-            if (eventType === "signal" && dataBuffer.length > 0) {
-              try {
-                const rawData = dataBuffer.join("\n");
-                const parsed = JSON.parse(rawData);
-                yield this.parseSignal(parsed);
-              } catch {
-              }
-            }
-            eventType = null;
-            dataBuffer = [];
-            continue;
-          }
-          if (trimmed.startsWith(":")) {
-            continue;
-          }
-          if (trimmed.startsWith("event:")) {
-            eventType = trimmed.slice(6).trim();
-          } else if (trimmed.startsWith("data:")) {
-            dataBuffer.push(trimmed.slice(5).trim());
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
+    /** Get full company profile by ID (1 credit). */
+    async detail(entityId) {
+        return this.request('GET', `/entities/${entityId}`);
+    }
+    /** Bulk lookup by domains, max 100 (1 credit per found). */
+    async bulkLookup(domains) {
+        return this.request('POST', '/entities/bulk', {
+            body: { domains: domains.slice(0, 100) },
+        });
+    }
+    /** Compute match score between two companies (3 credits, Business+). */
+    async matchScore(entityAId, entityBId) {
+        return this.request('POST', '/matching/score', {
+            body: { entity_a_id: entityAId, entity_b_id: entityBId },
+        });
+    }
+    /** Get public platform statistics (free, no auth). */
+    async stats() {
+        return this.request('GET', '/stats');
     }
-  }
-  parseSignal(raw) {
-    return {
-      signalId: raw.signal_id ?? String(raw.id),
-      domain: raw.domain,
-      companyName: raw.title,
-      category: raw.category,
-      subcategory: raw.subcategory,
-      signalScore: raw.signal_score,
-      intentTags: raw.intent_tags,
-      techStack: raw.tech_stack,
-      country: raw.country,
-      description: raw.description,
-      detectedAt: raw.discovered_at ?? raw.scanned_at,
-      uiUrl: raw.ui_url
-    };
-  }
-};
-var PounceClient = PounceAgentDataClient;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  PounceAgentDataClient,
-  PounceClient
-});
+}

package/package.json

@@ -1,46 +1,37 @@
 {
   "name": "pounce-agent-data",
-  "version": "1.0.1",
-  "description": "TypeScript SDK for the Pounce Agent Data API - B2B company signals for AI agents",
+  "version": "2.0.0",
+  "description": "TypeScript SDK for the Pounce v2 Entity API — search, look up, and enrich 59M+ verified B2B companies.",
   "main": "dist/index.js",
-  "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsc",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
     "pounce",
     "b2b",
-    "signals",
-    "ai",
-    "agents",
+    "companies",
     "api",
-    "sdk"
+    "sdk",
+    "ai",
+    "agents"
   ],
-  "author": "Pounce Signal Intelligence <hello@pounce.ch>",
+  "author": "Pounce",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://gitlab.pounce.ch/pounce/pounce.git",
-    "directory": "sdk/ts"
-  },
-  "homepage": "https://pounce.ch/developers",
   "devDependencies": {
-    "tsup": "^8.0.0",
+    "@types/node": "^25.3.0",
     "typescript": "^5.0.0"
   },
   "engines": {
     "node": ">=18.0.0"
-  }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.pounce.ch/pounce/pounce.git"
+  },
+  "homepage": "https://pounce.ch/developers"
 }

package/README.md

@@ -1,62 +0,0 @@
-# Pounce Agent Data SDK
-
-TypeScript SDK for the [Pounce Agent Data API](https://pounce.ch/developers) - Connect your AI agents to 500k+ B2B company signals.
-
-## Installation
-
-```bash
-npm install pounce-agent-data
-```
-
-## Quick Start
-
-```typescript
-import { PounceClient } from 'pounce-agent-data';
-
-const client = new PounceClient({ apiKey: 'pounce_live_xxx' });
-
-// Recent signals
-const { json } = await client.recentSignals({ limit: 10, category: 'saas' });
-for (const item of json.items) {
-  console.log(`${item.domain}: ${item.signal_score}`);
-}
-
-// Semantic search
-const results = await client.search('AI startups in healthcare', { limit: 20 });
-for (const item of results.json.items) {
-  console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
-}
-
-// Stream new signals (real-time)
-for await (const signal of client.stream({ minScore: 70 })) {
-  console.log(`New: ${signal.domain} (score=${signal.signalScore})`);
-}
-```
-
-## API Key
-
-Get your API key:
-1. Sign up at [pounce.ch](https://pounce.ch)
-2. Subscribe to Pro ($49/month) or Business ($149/month)
-3. Generate API key in **Settings → API Access**
-
-## Rate Limits
-
-| Tier | Requests/month |
-|------|----------------|
-| Pro | 1,000 |
-| Business | 10,000 |
-
-## Documentation
-
-- [API Documentation](https://pounce.ch/developers)
-- [Skill File](https://pounce.ch/skill.md)
-- [API Reference](https://api.pounce.ch/docs#/agent-data)
-
-## Support
-
-- Email: hello@pounce.ch
-
-## License
-
-MIT

package/dist/index.d.mts

@@ -1,204 +0,0 @@
-/**
- * Pounce Agent Data SDK - TypeScript Client
- *
- * Minimal client for the Pounce Agent Data API.
- * Supports recent signals, semantic search, signal details, and SSE streaming.
- *
- * @example
- * ```typescript
- * import { PounceAgentDataClient } from '@pounce/agent-data';
- *
- * const client = new PounceAgentDataClient({ apiKey: 'pounce_live_xxx' });
- *
- * // Recent signals
- * const { json, rateLimit } = await client.recentSignals({ limit: 10, category: 'saas' });
- *
- * // Semantic search
- * const results = await client.search('AI companies in healthcare', { limit: 20 });
- *
- * // Stream new signals
- * for await (const signal of client.stream({ minScore: 70 })) {
- *   console.log(signal);
- * }
- * ```
- */
-type RateLimitInfo = {
-    limit?: number;
-    remaining?: number;
-    resetUnix?: number;
-};
-type Signal = {
-    signalId: string;
-    domain: string;
-    companyName?: string | null;
-    category?: string | null;
-    subcategory?: string | null;
-    signalScore: number;
-    trustScore?: number | null;
-    intentTags?: string[] | null;
-    techStack?: string[] | null;
-    country?: string | null;
-    description?: string | null;
-    detectedAt?: string | null;
-    uiUrl?: string | null;
-};
-type AgentDataRecentSignal = {
-    id: number;
-    signal_id?: string;
-    domain: string;
-    tld: string;
-    title?: string | null;
-    description?: string | null;
-    h1?: string | null;
-    category?: string | null;
-    subcategory?: string | null;
-    business_type?: string | null;
-    signal_score: number;
-    signal_grade?: string | null;
-    tech_stack?: string[] | null;
-    intent_tags?: string[] | null;
-    hosting_provider?: string | null;
-    country?: string | null;
-    has_real_content: boolean;
-    scanned_at?: string | null;
-    discovered_at: string;
-    ui_url?: string | null;
-};
-type RecentSignalsResponse = {
-    items: AgentDataRecentSignal[];
-    count: number;
-    has_more?: boolean;
-};
-type SemanticSearchItem = {
-    signal_id: string;
-    domain: string;
-    company_name?: string | null;
-    category?: string | null;
-    signal_score: number;
-    similarity: number;
-    snippet?: string | null;
-    intent_tags?: string[] | null;
-    country?: string | null;
-    ui_url?: string | null;
-};
-type SemanticSearchResponse = {
-    items: SemanticSearchItem[];
-    count: number;
-    query_tokens?: number;
-};
-type SignalDetailResponse = {
-    signal_id: string;
-    domain: string;
-    company_name?: string | null;
-    category?: string | null;
-    subcategory?: string | null;
-    signal_score: number;
-    trust_score?: number | null;
-    intent_tags?: string[] | null;
-    tech_stack?: string[] | null;
-    country?: string | null;
-    description?: string | null;
-    social_links?: Record<string, string> | null;
-    detected_at?: string | null;
-    ui_url?: string | null;
-};
-type AgentDataUsageResponse = {
-    api_key_prefix: string;
-    usage: {
-        period_start: string;
-        period_end: string;
-        used: number;
-        limit: number;
-        remaining: number;
-        reset_at: string;
-    };
-};
-type RecentSignalsOptions = {
-    hours?: number;
-    limit?: number;
-    minScore?: number;
-    category?: string;
-    country?: string;
-    tlds?: string[];
-};
-type SemanticSearchOptions = {
-    limit?: number;
-    minScore?: number;
-    category?: string;
-    country?: string;
-    tlds?: string[];
-};
-type StreamOptions = {
-    minScore?: number;
-    category?: string;
-    since?: string;
-};
-declare class PounceAgentDataClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    constructor(options: {
-        apiKey: string;
-        baseUrl?: string;
-    });
-    private extractRateLimit;
-    private getJson;
-    private postJson;
-    /**
-     * Get recent B2B signals.
-     */
-    recentSignals(options?: RecentSignalsOptions): Promise<{
-        json: RecentSignalsResponse;
-        rateLimit: RateLimitInfo;
-    }>;
-    /**
-     * Semantic search for signals using natural language.
-     *
-     * @param query - Natural language search query
-     * @param options - Search options
-     *
-     * @example
-     * ```typescript
-     * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
-     * for (const item of json.items) {
-     *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
-     * }
-     * ```
-     */
-    search(query: string, options?: SemanticSearchOptions): Promise<{
-        json: SemanticSearchResponse;
-        rateLimit: RateLimitInfo;
-    }>;
-    /**
-     * Get full details for a specific signal.
-     */
-    signalDetail(signalId: string): Promise<{
-        json: SignalDetailResponse;
-        rateLimit: RateLimitInfo;
-    }>;
-    /**
-     * Get API usage information for your account.
-     */
-    usage(): Promise<{
-        json: AgentDataUsageResponse;
-        rateLimit: RateLimitInfo;
-    }>;
-    /**
-     * Stream new signals in real-time via SSE.
-     *
-     * @param options - Stream options
-     *
-     * @example
-     * ```typescript
-     * for await (const signal of client.stream({ minScore: 70 })) {
-     *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
-     * }
-     * ```
-     *
-     * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
-     */
-    stream(options?: StreamOptions): AsyncGenerator<Signal, void, unknown>;
-    private parseSignal;
-}
-declare const PounceClient: typeof PounceAgentDataClient;
-
-export { type AgentDataRecentSignal, type AgentDataUsageResponse, PounceAgentDataClient, PounceClient, type RateLimitInfo, type RecentSignalsOptions, type RecentSignalsResponse, type SemanticSearchItem, type SemanticSearchOptions, type SemanticSearchResponse, type Signal, type SignalDetailResponse, type StreamOptions };

package/dist/index.mjs

@@ -1,218 +0,0 @@
-// src/index.ts
-var PounceAgentDataClient = class {
-  apiKey;
-  baseUrl;
-  constructor(options) {
-    this.apiKey = options.apiKey;
-    this.baseUrl = (options.baseUrl ?? "https://api.pounce.ch").replace(/\/$/, "");
-    if (!this.apiKey.startsWith("pounce_live_")) {
-      throw new Error("Invalid API key format (expected pounce_live_...)");
-    }
-  }
-  extractRateLimit(res) {
-    return {
-      limit: res.headers.get("X-RateLimit-Limit") ? Number(res.headers.get("X-RateLimit-Limit")) : void 0,
-      remaining: res.headers.get("X-RateLimit-Remaining") ? Number(res.headers.get("X-RateLimit-Remaining")) : void 0,
-      resetUnix: res.headers.get("X-RateLimit-Reset") ? Number(res.headers.get("X-RateLimit-Reset")) : void 0
-    };
-  }
-  async getJson(path, params) {
-    const url = new URL(this.baseUrl + path);
-    if (params) {
-      for (const [k, v] of Object.entries(params)) {
-        if (v !== void 0) url.searchParams.set(k, String(v));
-      }
-    }
-    const res = await fetch(url.toString(), {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        Accept: "application/json"
-      }
-    });
-    const rateLimit = this.extractRateLimit(res);
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`HTTP ${res.status}: ${text}`);
-    }
-    const json = await res.json();
-    return { json, rateLimit };
-  }
-  async postJson(path, body) {
-    const url = new URL(this.baseUrl + path);
-    const res = await fetch(url.toString(), {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        Accept: "application/json",
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
-    });
-    const rateLimit = this.extractRateLimit(res);
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`HTTP ${res.status}: ${text}`);
-    }
-    const json = await res.json();
-    return { json, rateLimit };
-  }
-  // ---------------------------------------------------------------------------
-  // Public API Methods
-  // ---------------------------------------------------------------------------
-  /**
-   * Get recent B2B signals.
-   */
-  async recentSignals(options = {}) {
-    const { hours = 24, limit = 100, minScore = 50, category, country, tlds } = options;
-    return this.getJson("/api/v1/agent-data/signals/recent", {
-      hours,
-      limit,
-      min_score: minScore,
-      category,
-      country,
-      tlds: tlds?.join(",")
-    });
-  }
-  /**
-   * Semantic search for signals using natural language.
-   *
-   * @param query - Natural language search query
-   * @param options - Search options
-   *
-   * @example
-   * ```typescript
-   * const { json } = await client.search('AI startups in healthcare', { limit: 10 });
-   * for (const item of json.items) {
-   *   console.log(`${item.domain}: similarity=${item.similarity.toFixed(2)}`);
-   * }
-   * ```
-   */
-  async search(query, options = {}) {
-    const { limit = 20, minScore = 50, category, country, tlds } = options;
-    const body = {
-      query,
-      limit,
-      min_score: minScore
-    };
-    const filters = {};
-    if (category) filters.category = category;
-    if (country) filters.country = country;
-    if (tlds) filters.tlds = tlds;
-    if (Object.keys(filters).length > 0) body.filters = filters;
-    return this.postJson(
-      "/api/v1/agent-data/search/semantic",
-      body
-    );
-  }
-  /**
-   * Get full details for a specific signal.
-   */
-  async signalDetail(signalId) {
-    return this.getJson(
-      `/api/v1/agent-data/signals/${encodeURIComponent(signalId)}`
-    );
-  }
-  /**
-   * Get API usage information for your account.
-   */
-  async usage() {
-    return this.getJson("/api/v1/agent-data/usage");
-  }
-  /**
-   * Stream new signals in real-time via SSE.
-   *
-   * @param options - Stream options
-   *
-   * @example
-   * ```typescript
-   * for await (const signal of client.stream({ minScore: 70 })) {
-   *   console.log(`New signal: ${signal.domain} (score=${signal.signalScore})`);
-   * }
-   * ```
-   *
-   * @note This is an async generator. Make sure to handle connection errors and reconnect if needed.
-   */
-  async *stream(options = {}) {
-    const { minScore = 50, category, since } = options;
-    const url = new URL(`${this.baseUrl}/api/v1/agent-data/streams/signals`);
-    url.searchParams.set("min_score", String(minScore));
-    if (category) url.searchParams.set("category", category);
-    if (since) url.searchParams.set("since", since);
-    const res = await fetch(url.toString(), {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        Accept: "text/event-stream"
-      }
-    });
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`HTTP ${res.status}: ${text}`);
-    }
-    if (!res.body) {
-      throw new Error("Response body is null");
-    }
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    let eventType = null;
-    let dataBuffer = [];
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split("\n");
-        buffer = lines.pop() ?? "";
-        for (const line of lines) {
-          const trimmed = line.replace(/\r$/, "");
-          if (!trimmed) {
-            if (eventType === "signal" && dataBuffer.length > 0) {
-              try {
-                const rawData = dataBuffer.join("\n");
-                const parsed = JSON.parse(rawData);
-                yield this.parseSignal(parsed);
-              } catch {
-              }
-            }
-            eventType = null;
-            dataBuffer = [];
-            continue;
-          }
-          if (trimmed.startsWith(":")) {
-            continue;
-          }
-          if (trimmed.startsWith("event:")) {
-            eventType = trimmed.slice(6).trim();
-          } else if (trimmed.startsWith("data:")) {
-            dataBuffer.push(trimmed.slice(5).trim());
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-  }
-  parseSignal(raw) {
-    return {
-      signalId: raw.signal_id ?? String(raw.id),
-      domain: raw.domain,
-      companyName: raw.title,
-      category: raw.category,
-      subcategory: raw.subcategory,
-      signalScore: raw.signal_score,
-      intentTags: raw.intent_tags,
-      techStack: raw.tech_stack,
-      country: raw.country,
-      description: raw.description,
-      detectedAt: raw.discovered_at ?? raw.scanned_at,
-      uiUrl: raw.ui_url
-    };
-  }
-};
-var PounceClient = PounceAgentDataClient;
-export {
-  PounceAgentDataClient,
-  PounceClient
-};