@fedpulse/sdk 1.0.0

package/dist/esm/index.js

@@ -0,0 +1,40 @@
+/**
+ * @fedpulse/sdk — Official JavaScript/TypeScript SDK for the FedPulse API.
+ *
+ * Quick start:
+ * ```ts
+ * import { FedPulse } from '@fedpulse/sdk';
+ *
+ * const client = new FedPulse({ apiKey: process.env.FEDPULSE_API_KEY! });
+ *
+ * const { data } = await client.opportunities.list({ q: 'cloud', naics: '541512' });
+ * console.log(data[0].title);
+ * ```
+ *
+ * Webhook verification:
+ * ```ts
+ * const payload = FedPulse.verifyWebhook({
+ *   rawBody: req.body,
+ *   signatureHeader: req.headers['x-fedpulse-signature'],
+ *   timestampHeader: req.headers['x-fedpulse-timestamp'],
+ *   secret: process.env.FEDPULSE_WEBHOOK_SECRET!,
+ * });
+ * ```
+ */
+// ── Main client ────────────────────────────────────────────────────────────────
+export { FedPulse, WebhookVerificationError } from './client.js';
+// ── Error classes ──────────────────────────────────────────────────────────────
+export { FedPulseError, AuthenticationError, PermissionError, NotFoundError, ValidationError, RateLimitError, ServerError, NetworkError, TimeoutError, RetryExhaustedError, } from './errors.js';
+// ── HTTP client (advanced usage) ───────────────────────────────────────────────
+export { HttpClient, buildQueryParams } from './http.js';
+// ── Domain resources ───────────────────────────────────────────────────────────
+export { OpportunitiesResource } from './resources/opportunities.js';
+export { ExclusionsResource } from './resources/exclusions.js';
+export { EntitiesResource } from './resources/entities.js';
+export { IntelligenceResource } from './resources/intelligence.js';
+export { AssistanceResource } from './resources/assistance.js';
+export { AnalyticsResource } from './resources/analytics.js';
+export { WebhooksResource } from './resources/webhooks.js';
+// ── Webhook utilities ──────────────────────────────────────────────────────────
+export { verifyWebhook, extractWebhookHeaders } from './webhooks-verify.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,kFAAkF;AAElF,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGjE,kFAAkF;AAElF,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,kFAAkF;AAElF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGzD,kFAAkF;AAElF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,kFAAkF;AAElF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/resources/analytics.js

@@ -0,0 +1,131 @@
+/**
+ * Analytics resource client.
+ *
+ * Wraps all /v1/analytics endpoints (per-user API usage analytics):
+ *   - summary    GET /v1/analytics/summary
+ *   - chart      GET /v1/analytics/chart
+ *   - endpoints  GET /v1/analytics/endpoints
+ *   - logs       GET /v1/analytics/logs
+ *   - logPages   async generator over the logs endpoint
+ *
+ * All results are scoped to the authenticated user — no cross-user visibility.
+ */
+export class AnalyticsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Get KPI summary totals for the authenticated user.
+     *
+     * Returns: requests today, this month, in range, 4xx/5xx counts and rates.
+     * Analytics data is never cached — always returns live counts.
+     *
+     * @param params  Optional key-scoping and time range.
+     *
+     * @example
+     * ```ts
+     * const summary = await client.analytics.summary({ range: '7d' });
+     * console.log('Requests last 7d:', summary.data.requestsInRange);
+     * ```
+     */
+    async summary(params = {}) {
+        validateAnalyticsParams(params);
+        return this.http.get('/v1/analytics/summary', params, { cacheTtlMs: 0 });
+    }
+    /**
+     * Get per-day request counts broken down by success / 4xx / 5xx.
+     *
+     * @param params  Optional key-scoping and time range.
+     *
+     * @example
+     * ```ts
+     * const chart = await client.analytics.chart({ range: '30d' });
+     * for (const day of chart.data.days) {
+     *   console.log(day.date, day.total);
+     * }
+     * ```
+     */
+    async chart(params = {}) {
+        validateAnalyticsParams(params);
+        return this.http.get('/v1/analytics/chart', params, { cacheTtlMs: 0 });
+    }
+    /**
+     * Get top-10 endpoints by request volume and by P95 latency.
+     *
+     * @param params  Optional key-scoping and time range.
+     *
+     * @example
+     * ```ts
+     * const endpoints = await client.analytics.endpoints({ range: '7d' });
+     * console.log('Slowest endpoint:', endpoints.data.byLatency[0]?.endpoint);
+     * ```
+     */
+    async endpoints(params = {}) {
+        validateAnalyticsParams(params);
+        return this.http.get('/v1/analytics/endpoints', params, { cacheTtlMs: 0 });
+    }
+    /**
+     * Get paginated API request logs for the authenticated user.
+     *
+     * Supports cursor-based pagination via the `cursor` parameter.
+     * Maximum `limit` is 1000.
+     *
+     * @param params  Filter and pagination parameters.
+     *
+     * @example
+     * ```ts
+     * const logs = await client.analytics.logs({ limit: 50, status: '4xx' });
+     * for (const entry of logs.data.items) {
+     *   console.log(entry.method, entry.endpoint, entry.statusCode);
+     * }
+     * ```
+     */
+    async logs(params = {}) {
+        if (params.limit !== undefined) {
+            if (!Number.isInteger(params.limit) || params.limit < 1 || params.limit > 1000) {
+                throw new Error('limit must be an integer between 1 and 1000');
+            }
+        }
+        validateAnalyticsParams(params);
+        return this.http.get('/v1/analytics/logs', params, { cacheTtlMs: 0 });
+    }
+    /**
+     * Async generator that automatically paginates through all log entries.
+     *
+     * Uses cursor-based pagination. Yields one page at a time.
+     *
+     * @param params  Same parameters as `logs()`. Do not pass `cursor`.
+     *
+     * @example
+     * ```ts
+     * for await (const page of client.analytics.logPages({ range: '7d' })) {
+     *   for (const entry of page.data.items) {
+     *     console.log(entry.requestId, entry.statusCode);
+     *   }
+     * }
+     * ```
+     */
+    async *logPages(params) {
+        let cursor = undefined;
+        let hasMore = true;
+        while (hasMore) {
+            const result = await this.logs({
+                ...params,
+                ...(cursor !== undefined ? { cursor } : {}),
+            });
+            yield result;
+            const logs = result.data;
+            cursor = logs.nextCursor ?? undefined;
+            hasMore = logs.hasNextPage && cursor !== undefined;
+        }
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────────────────
+const VALID_RANGES = new Set(['24h', '7d', '30d', '90d']);
+function validateAnalyticsParams(params) {
+    if (params.range !== undefined && !VALID_RANGES.has(params.range)) {
+        throw new Error(`range must be one of: 24h, 7d, 30d, 90d. Got: "${params.range}"`);
+    }
+}
+//# sourceMappingURL=analytics.js.map

package/dist/esm/resources/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/resources/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,MAAM,OAAO,iBAAiB;IACX,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,OAAO,CACX,SAAiC,EAAE;QAEnC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,uBAAuB,EACvB,MAAiC,EACjC,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,KAAK,CACT,SAA+B,EAAE;QAEjC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,qBAAqB,EACrB,MAAiC,EACjC,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,CACb,SAAmC,EAAE;QAErC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,yBAAyB,EACzB,MAAiC,EACjC,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,IAAI,CACR,SAA8B,EAAE;QAEhC,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC;gBAC/E,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,oBAAoB,EACpB,MAAiC,EACjC,EAAE,UAAU,EAAE,CAAC,EAAE,CAClB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,CAAC,QAAQ,CACb,MAA2C;QAE3C,IAAI,MAAM,GAAuB,SAAS,CAAC;QAC3C,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,OAAO,OAAO,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;gBAC7B,GAAG,MAAM;gBACT,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC,CAAC;YACH,MAAM,MAAM,CAAC;YAEb,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACzB,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC;YACtC,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,KAAK,SAAS,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AAED,kFAAkF;AAElF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE1D,SAAS,uBAAuB,CAAC,MAA0B;IACzD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CACb,kDAAkD,MAAM,CAAC,KAAK,GAAG,CAClE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/esm/resources/assistance.js

@@ -0,0 +1,98 @@
+/**
+ * Assistance Listings resource client.
+ *
+ * Wraps all /v1/assistance endpoints:
+ *   - list      GET /v1/assistance
+ *   - stats     GET /v1/assistance/stats
+ *   - get       GET /v1/assistance/:number   (CFDA program number)
+ *   - paginate  auto-paginates over the list endpoint
+ */
+export class AssistanceResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Search and filter federal assistance listings (CFDA programs).
+     *
+     * @param params  Filter and pagination parameters.
+     *
+     * @example
+     * ```ts
+     * const result = await client.assistance.list({ agency: 'Department of Energy' });
+     * ```
+     */
+    async list(params = {}) {
+        return this.http.get('/v1/assistance', params);
+    }
+    /**
+     * Get aggregated statistics for assistance listings.
+     *
+     * @param params  Optional filter parameters.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.assistance.stats();
+     * ```
+     */
+    async stats(params = {}) {
+        return this.http.get('/v1/assistance/stats', params);
+    }
+    /**
+     * Get a single assistance listing by its CFDA program number.
+     *
+     * @param programNumber  CFDA program number in "XX.XXX" format (e.g. "17.002").
+     * @throws {NotFoundError} If the program number does not exist.
+     *
+     * @example
+     * ```ts
+     * const listing = await client.assistance.get('84.048');
+     * console.log(listing.data.programTitle);
+     * ```
+     */
+    async get(programNumber) {
+        if (!programNumber || typeof programNumber !== 'string' || programNumber.trim() === '') {
+            throw new Error('programNumber must be a non-empty string');
+        }
+        const trimmed = programNumber.trim();
+        if (!/^\d{2}\.\d{3}$/.test(trimmed)) {
+            throw new Error('programNumber must be in "XX.XXX" format (e.g. "17.002")');
+        }
+        return this.http.get(`/v1/assistance/${encodeURIComponent(trimmed)}`);
+    }
+    /**
+     * Async generator that automatically paginates over all matching assistance listings.
+     *
+     * @param params  Same filter parameters as `list()`. Do not pass `page`.
+     *
+     * @example
+     * ```ts
+     * for await (const page of client.assistance.paginate({ agency: 'HHS' })) {
+     *   for (const listing of page.data) {
+     *     console.log(listing.programNumber, listing.programTitle);
+     *   }
+     * }
+     * ```
+     */
+    async *paginate(params) {
+        let page = 1;
+        let hasMore = true;
+        while (hasMore) {
+            const result = await this.list({ ...params, page });
+            yield result;
+            const pagination = result.pagination;
+            if (pagination === null) {
+                hasMore = false;
+            }
+            else if ('hasNextPage' in pagination) {
+                hasMore = pagination.hasNextPage;
+                if (hasMore)
+                    page++;
+            }
+            else {
+                hasMore = false;
+            }
+        }
+    }
+}
+//# sourceMappingURL=assistance.js.map

package/dist/esm/resources/assistance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistance.js","sourceRoot":"","sources":["../../../src/resources/assistance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CACR,SAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,gBAAgB,EAChB,MAAiC,CAClC,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CACT,SAAmC,EAAE;QAErC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,sBAAsB,EACtB,MAAiC,CAClC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAC,aAAqB;QAC7B,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvF,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAChD,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,CAAC,QAAQ,CACb,MAA0C;QAE1C,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,OAAO,OAAO,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,MAAM,CAAC;YAEb,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACrC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;iBAAM,IAAI,aAAa,IAAI,UAAU,EAAE,CAAC;gBACvC,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;gBACjC,IAAI,OAAO;oBAAE,IAAI,EAAE,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/entities.js

@@ -0,0 +1,146 @@
+/**
+ * Entities resource client.
+ *
+ * Wraps all /v1/entities endpoints:
+ *   - list                 GET /v1/entities
+ *   - get                  GET /v1/entities/:uei
+ *   - opportunities        GET /v1/entities/:uei/opportunities
+ *   - exclusionCheck       GET /v1/entities/:uei/exclusion-check
+ *   - stats                GET /v1/entities/stats
+ *   - paginate             auto-paginates over the list endpoint
+ */
+import { ValidationError } from '../errors.js';
+export class EntitiesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Search and filter SAM.gov registered entities (vendors).
+     *
+     * @param params  Filter and pagination parameters.
+     *
+     * @example
+     * ```ts
+     * const result = await client.entities.list({
+     *   naics: '541512',
+     *   certification: '8A',
+     *   state: 'VA',
+     * });
+     * ```
+     */
+    async list(params = {}) {
+        return this.http.get('/v1/entities', params);
+    }
+    /**
+     * Get the full SAM.gov registration profile for a vendor by UEI.
+     *
+     * @param uei  Unique Entity Identifier (12-char alphanumeric).
+     * @throws {NotFoundError} If the entity does not exist.
+     *
+     * @example
+     * ```ts
+     * const entity = await client.entities.get('ABCDEF123456');
+     * console.log(entity.data.legalBusinessName);
+     * ```
+     */
+    async get(uei) {
+        validateUei(uei);
+        return this.http.get(`/v1/entities/${encodeURIComponent(uei.trim().toUpperCase())}`);
+    }
+    /**
+     * Get awarded contract opportunities linked to a vendor.
+     *
+     * @param uei     Unique Entity Identifier.
+     * @param params  Pagination parameters.
+     * @throws {NotFoundError} If the entity does not exist.
+     *
+     * @example
+     * ```ts
+     * const contracts = await client.entities.opportunities('ABCDEF123456', { limit: 10 });
+     * ```
+     */
+    async opportunities(uei, params = {}) {
+        validateUei(uei);
+        return this.http.get(`/v1/entities/${encodeURIComponent(uei.trim().toUpperCase())}/opportunities`, params);
+    }
+    /**
+     * Check whether a vendor is currently excluded (debarred) from federal contracts.
+     *
+     * @param uei  Unique Entity Identifier.
+     * @throws {NotFoundError} If the entity does not exist.
+     *
+     * @example
+     * ```ts
+     * const check = await client.entities.exclusionCheck('ABCDEF123456');
+     * if (check.data.excluded) {
+     *   console.warn('Vendor is EXCLUDED!', check.data.exclusion);
+     * }
+     * ```
+     */
+    async exclusionCheck(uei) {
+        validateUei(uei);
+        return this.http.get(`/v1/entities/${encodeURIComponent(uei.trim().toUpperCase())}/exclusion-check`, {}, { cacheTtlMs: 0 } // Never cache exclusion checks — compliance-critical.
+        );
+    }
+    /**
+     * Get aggregated entity registration statistics.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.entities.stats();
+     * console.log('Total registered entities:', stats.data.total);
+     * ```
+     */
+    async stats() {
+        return this.http.get('/v1/entities/stats');
+    }
+    /**
+     * Async generator that automatically paginates over all matching entities.
+     *
+     * @param params  Same filter parameters as `list()`. Do not pass `page`.
+     *
+     * @example
+     * ```ts
+     * for await (const page of client.entities.paginate({ naics: '541512' })) {
+     *   for (const entity of page.data) {
+     *     console.log(entity.legalBusinessName);
+     *   }
+     * }
+     * ```
+     */
+    async *paginate(params) {
+        let page = 1;
+        let hasMore = true;
+        while (hasMore) {
+            const result = await this.list({ ...params, page });
+            yield result;
+            const pagination = result.pagination;
+            if (pagination === null) {
+                hasMore = false;
+            }
+            else if ('hasNextPage' in pagination) {
+                hasMore = pagination.hasNextPage;
+                if (hasMore)
+                    page++;
+            }
+            else {
+                hasMore = false;
+            }
+        }
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────────────────
+/**
+ * Validate UEI format: 12-character alphanumeric string.
+ * @throws {Error} If UEI is invalid.
+ */
+function validateUei(uei) {
+    if (!uei || typeof uei !== 'string' || uei.trim() === '') {
+        throw new ValidationError({ message: 'uei must be a non-empty string', status: 400 });
+    }
+    if (!/^[A-Za-z0-9]{12}$/.test(uei.trim())) {
+        throw new ValidationError({ message: 'uei must be a 12-character alphanumeric string (e.g. ABCDEF123456)', status: 400 });
+    }
+}
+//# sourceMappingURL=entities.js.map

package/dist/esm/resources/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../../src/resources/entities.ts"],"names":[],"mappings":"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"}

package/dist/esm/resources/exclusions.js

@@ -0,0 +1,132 @@
+/**
+ * Exclusions resource client.
+ *
+ * Wraps all /v1/exclusions endpoints:
+ *   - list           GET /v1/exclusions
+ *   - get            GET /v1/exclusions/:exclusionId
+ *   - check          POST /v1/exclusions/check  (bulk compliance)
+ *   - stats          GET /v1/exclusions/stats
+ *   - paginate       auto-paginates over the list endpoint
+ */
+import { ValidationError } from '../errors.js';
+export class ExclusionsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Search and filter the SAM.gov exclusions database.
+     *
+     * @param params  Filter and pagination parameters.
+     *
+     * @example
+     * ```ts
+     * const result = await client.exclusions.list({ uei: 'ABCDEF123456' });
+     * ```
+     */
+    async list(params = {}) {
+        return this.http.get('/v1/exclusions', params);
+    }
+    /**
+     * Get a single exclusion record by its unique ID.
+     *
+     * @param exclusionId  Internal exclusion identifier.
+     * @throws {NotFoundError} If the exclusion record does not exist.
+     */
+    async get(exclusionId) {
+        if (!exclusionId || typeof exclusionId !== 'string' || exclusionId.trim() === '') {
+            throw new ValidationError({ message: 'exclusionId must be a non-empty string', status: 400 });
+        }
+        return this.http.get(`/v1/exclusions/${encodeURIComponent(exclusionId.trim())}`);
+    }
+    /**
+     * Bulk compliance check — verify up to 100 entities against the exclusions database.
+     *
+     * Each entity must include at least one of: `uei`, `cage`, or `name`.
+     * When `fuzzyMatch` is true (default), name matching uses trigram similarity.
+     *
+     * @param params  List of entities and fuzzy-match flag.
+     * @returns Per-entity exclusion status with match confidence scores.
+     * @throws {ValidationError} If more than 100 entities are provided.
+     *
+     * @example
+     * ```ts
+     * const result = await client.exclusions.check({
+     *   entities: [
+     *     { uei: 'ABCDEF123456' },
+     *     { name: 'Acme Corporation' },
+     *   ],
+     * });
+     * for (const item of result.data) {
+     *   console.log(item.input.name, '->', item.excluded ? 'EXCLUDED' : 'OK');
+     * }
+     * ```
+     */
+    async check(params) {
+        if (!Array.isArray(params.entities)) {
+            throw new ValidationError({ message: 'entities must be an array', status: 400 });
+        }
+        if (params.entities.length === 0) {
+            throw new ValidationError({ message: 'entities array must contain at least one entry', status: 400 });
+        }
+        if (params.entities.length > 100) {
+            throw new ValidationError({ message: 'entities array must not exceed 100 entries', status: 400 });
+        }
+        for (const [i, entity] of params.entities.entries()) {
+            if (!entity.uei && !entity.cage && !entity.name) {
+                throw new ValidationError({
+                    message: `entities[${i}] must include at least one of: uei, cage, name`,
+                    status: 400,
+                });
+            }
+        }
+        return this.http.post('/v1/exclusions/check', params);
+    }
+    /**
+     * Get aggregated exclusion statistics.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.exclusions.stats();
+     * console.log('Total active exclusions:', stats.data.active);
+     * ```
+     */
+    async stats() {
+        return this.http.get('/v1/exclusions/stats');
+    }
+    /**
+     * Async generator that automatically paginates over all matching exclusions.
+     *
+     * @param params  Same filter parameters as `list()`. Do not pass `page`.
+     *
+     * @example
+     * ```ts
+     * for await (const page of client.exclusions.paginate({ agency: 'DEPT OF DEFENSE' })) {
+     *   for (const exc of page.data) {
+     *     console.log(exc.name, exc.effectiveDate);
+     *   }
+     * }
+     * ```
+     */
+    async *paginate(params) {
+        let page = 1;
+        let hasMore = true;
+        while (hasMore) {
+            const result = await this.list({ ...params, page });
+            yield result;
+            const pagination = result.pagination;
+            if (pagination === null) {
+                hasMore = false;
+            }
+            else if ('hasNextPage' in pagination) {
+                hasMore = pagination.hasNextPage;
+                if (hasMore)
+                    page++;
+            }
+            else {
+                hasMore = false;
+            }
+        }
+    }
+}
+//# sourceMappingURL=exclusions.js.map

package/dist/esm/resources/exclusions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusions.js","sourceRoot":"","sources":["../../../src/resources/exclusions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/C,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CACR,SAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,gBAAgB,EAChB,MAAiC,CAClC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,WAAmB;QAC3B,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjF,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAC3D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,KAAK,CACT,MAAiC;QAEjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,gDAAgD,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACxG,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACjC,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChD,MAAM,IAAI,eAAe,CAAC;oBACxB,OAAO,EAAE,YAAY,CAAC,iDAAiD;oBACvE,MAAM,EAAE,GAAG;iBACZ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA0B,sBAAsB,EAAE,MAAM,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,sBAAsB,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,CAAC,QAAQ,CACb,MAA0C;QAE1C,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,OAAO,OAAO,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,MAAM,CAAC;YAEb,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACrC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;iBAAM,IAAI,aAAa,IAAI,UAAU,EAAE,CAAC;gBACvC,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC;gBACjC,IAAI,OAAO;oBAAE,IAAI,EAAE,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/intelligence.js

@@ -0,0 +1,93 @@
+/**
+ * Intelligence resource client.
+ *
+ * Wraps all /v1/intelligence endpoints:
+ *   - entityProfile     GET /v1/intelligence/entity/:uei
+ *   - marketAnalysis    GET /v1/intelligence/market/:naics
+ *   - complianceCheck   POST /v1/intelligence/compliance-check
+ */
+import { ValidationError } from '../errors.js';
+export class IntelligenceResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Get a comprehensive 360° intelligence profile for a vendor.
+     *
+     * Aggregates: contract history, agency relationships, certifications,
+     * exclusion status, and risk indicators into a single response.
+     *
+     * @param uei  Unique Entity Identifier (12-char alphanumeric).
+     * @throws {NotFoundError} If the entity does not exist in SAM.gov.
+     *
+     * @example
+     * ```ts
+     * const profile = await client.intelligence.entityProfile('ABCDEF123456');
+     * console.log('Contract count:', profile.data.contractCount);
+     * console.log('Risk:', profile.data.riskLevel);
+     * ```
+     */
+    async entityProfile(uei) {
+        if (!uei || typeof uei !== 'string' || uei.trim() === '') {
+            throw new ValidationError({ message: 'uei must be a non-empty string', status: 400 });
+        }
+        if (!/^[A-Za-z0-9]{12}$/.test(uei.trim())) {
+            throw new ValidationError({ message: 'uei must be a 12-character alphanumeric string', status: 400 });
+        }
+        return this.http.get(`/v1/intelligence/entity/${encodeURIComponent(uei.trim().toUpperCase())}`);
+    }
+    /**
+     * Get a market analysis for a specific NAICS code.
+     *
+     * Returns: top awardees, top agencies, set-aside breakdown, active solicitations,
+     * total market size, and recent award trends.
+     *
+     * @param naics  2–6 digit NAICS code (more digits = more specific market segment).
+     *
+     * @example
+     * ```ts
+     * const market = await client.intelligence.marketAnalysis('541512');
+     * console.log('Market size (cents):', market.data.totalMarketSize);
+     * console.log('Top awardee:', market.data.topAwardees[0]?.name);
+     * ```
+     */
+    async marketAnalysis(naics) {
+        if (!naics || typeof naics !== 'string' || naics.trim() === '') {
+            throw new ValidationError({ message: 'naics must be a non-empty string', status: 400 });
+        }
+        if (!/^\d{2,6}$/.test(naics.trim())) {
+            throw new ValidationError({ message: 'naics must be a numeric string of 2 to 6 digits (e.g. "541512")', status: 400 });
+        }
+        return this.http.get(`/v1/intelligence/market/${encodeURIComponent(naics.trim())}`);
+    }
+    /**
+     * Perform a full compliance check for a vendor.
+     *
+     * Returns: exclusion status, SAM.gov registration status, risk score,
+     * and risk indicators in one API call.
+     *
+     * @param params  Object containing the UEI to check.
+     * @throws {NotFoundError} If the entity does not exist in SAM.gov.
+     *
+     * @example
+     * ```ts
+     * const compliance = await client.intelligence.complianceCheck({ uei: 'ABCDEF123456' });
+     * if (compliance.data.excluded || compliance.data.riskLevel === 'high') {
+     *   console.warn('Do not contract with this vendor.');
+     * }
+     * ```
+     */
+    async complianceCheck(params) {
+        if (!params.uei || typeof params.uei !== 'string' || params.uei.trim() === '') {
+            throw new ValidationError({ message: 'params.uei must be a non-empty string', status: 400 });
+        }
+        if (!/^[A-Za-z0-9]{12}$/.test(params.uei.trim())) {
+            throw new ValidationError({ message: 'params.uei must be a 12-character alphanumeric string', status: 400 });
+        }
+        return this.http.post('/v1/intelligence/compliance-check', {
+            uei: params.uei.trim().toUpperCase(),
+        });
+    }
+}
+//# sourceMappingURL=intelligence.js.map

package/dist/esm/resources/intelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence.js","sourceRoot":"","sources":["../../../src/resources/intelligence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS/C,MAAM,OAAO,oBAAoB;IACd,IAAI,CAAa;IAElC,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACzD,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,gDAAgD,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACxG,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,2BAA2B,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,cAAc,CAAC,KAAa;QAChC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/D,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,iEAAiE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACzH,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,2BAA2B,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,eAAe,CACnB,MAAoC;QAEpC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC9E,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,uDAAuD,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAoB,mCAAmC,EAAE;YAC5E,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;CACF"}