@fedpulse/sdk 1.0.0

package/dist/types/resources/analytics.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 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.
+ */
+import type { HttpClient, ParsedResponse } from '../http.js';
+import type { AnalyticsSummary, AnalyticsChart, AnalyticsEndpoints, AnalyticsLogs, AnalyticsSummaryParams, AnalyticsChartParams, AnalyticsEndpointsParams, AnalyticsLogsParams } from '../types/analytics.js';
+export declare class AnalyticsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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);
+     * ```
+     */
+    summary(params?: AnalyticsSummaryParams): Promise<ParsedResponse<AnalyticsSummary>>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    chart(params?: AnalyticsChartParams): Promise<ParsedResponse<AnalyticsChart>>;
+    /**
+     * 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);
+     * ```
+     */
+    endpoints(params?: AnalyticsEndpointsParams): Promise<ParsedResponse<AnalyticsEndpoints>>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    logs(params?: AnalyticsLogsParams): Promise<ParsedResponse<AnalyticsLogs>>;
+    /**
+     * 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);
+     *   }
+     * }
+     * ```
+     */
+    logPages(params: Omit<AnalyticsLogsParams, 'cursor'>): AsyncGenerator<ParsedResponse<AnalyticsLogs>>;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/types/resources/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/resources/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;;;;;;;;;OAaG;IACG,OAAO,CACX,MAAM,GAAE,sBAA2B,GAClC,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAS5C;;;;;;;;;;;;OAYG;IACG,KAAK,CACT,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAS1C;;;;;;;;;;OAUG;IACG,SAAS,CACb,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAS9C;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CACR,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAczC;;;;;;;;;;;;;;;OAeG;IACI,QAAQ,CACb,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAC1C,cAAc,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;CAgBjD"}

package/dist/types/resources/assistance.d.cts

@@ -0,0 +1,66 @@
+/**
+ * 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
+ */
+import type { HttpClient, ParsedResponse } from '../http.cjs';
+import type { AssistanceListing, AssistanceStats, ListAssistanceParams, GetAssistanceStatsParams } from '../types/assistance.cjs';
+export declare class AssistanceResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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' });
+     * ```
+     */
+    list(params?: ListAssistanceParams): Promise<ParsedResponse<AssistanceListing[]>>;
+    /**
+     * Get aggregated statistics for assistance listings.
+     *
+     * @param params  Optional filter parameters.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.assistance.stats();
+     * ```
+     */
+    stats(params?: GetAssistanceStatsParams): Promise<ParsedResponse<AssistanceStats>>;
+    /**
+     * 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);
+     * ```
+     */
+    get(programNumber: string): Promise<ParsedResponse<AssistanceListing>>;
+    /**
+     * 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);
+     *   }
+     * }
+     * ```
+     */
+    paginate(params: Omit<ListAssistanceParams, 'page'>): AsyncGenerator<ParsedResponse<AssistanceListing[]>>;
+}
+//# sourceMappingURL=assistance.d.ts.map

package/dist/types/resources/assistance.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 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
+ */
+import type { HttpClient, ParsedResponse } from '../http.js';
+import type { AssistanceListing, AssistanceStats, ListAssistanceParams, GetAssistanceStatsParams } from '../types/assistance.js';
+export declare class AssistanceResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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' });
+     * ```
+     */
+    list(params?: ListAssistanceParams): Promise<ParsedResponse<AssistanceListing[]>>;
+    /**
+     * Get aggregated statistics for assistance listings.
+     *
+     * @param params  Optional filter parameters.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.assistance.stats();
+     * ```
+     */
+    stats(params?: GetAssistanceStatsParams): Promise<ParsedResponse<AssistanceStats>>;
+    /**
+     * 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);
+     * ```
+     */
+    get(programNumber: string): Promise<ParsedResponse<AssistanceListing>>;
+    /**
+     * 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);
+     *   }
+     * }
+     * ```
+     */
+    paginate(params: Omit<ListAssistanceParams, 'page'>): AsyncGenerator<ParsedResponse<AssistanceListing[]>>;
+}
+//# sourceMappingURL=assistance.d.ts.map

package/dist/types/resources/assistance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistance.d.ts","sourceRoot":"","sources":["../../../src/resources/assistance.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;;;;;OASG;IACG,IAAI,CACR,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAO/C;;;;;;;;;OASG;IACG,KAAK,CACT,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;IAO3C;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAa5E;;;;;;;;;;;;;OAaG;IACI,QAAQ,CACb,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GACzC,cAAc,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC;CAmBvD"}

package/dist/types/resources/entities.d.cts

@@ -0,0 +1,101 @@
+/**
+ * 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 type { HttpClient, ParsedResponse } from '../http.cjs';
+import type { Entity, EntityStats, EntityExclusionCheckResult, ListEntitiesParams } from '../types/entities.cjs';
+import type { Opportunity } from '../types/opportunities.cjs';
+import type { PaginationParams } from '../types/common.cjs';
+export declare class EntitiesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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',
+     * });
+     * ```
+     */
+    list(params?: ListEntitiesParams): Promise<ParsedResponse<Entity[]>>;
+    /**
+     * 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);
+     * ```
+     */
+    get(uei: string): Promise<ParsedResponse<Entity>>;
+    /**
+     * 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 });
+     * ```
+     */
+    opportunities(uei: string, params?: PaginationParams): Promise<ParsedResponse<Opportunity[]>>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    exclusionCheck(uei: string): Promise<ParsedResponse<EntityExclusionCheckResult>>;
+    /**
+     * Get aggregated entity registration statistics.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.entities.stats();
+     * console.log('Total registered entities:', stats.data.total);
+     * ```
+     */
+    stats(): Promise<ParsedResponse<EntityStats>>;
+    /**
+     * 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);
+     *   }
+     * }
+     * ```
+     */
+    paginate(params: Omit<ListEntitiesParams, 'page'>): AsyncGenerator<ParsedResponse<Entity[]>>;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/types/resources/entities.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 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 type { HttpClient, ParsedResponse } from '../http.js';
+import type { Entity, EntityStats, EntityExclusionCheckResult, ListEntitiesParams } from '../types/entities.js';
+import type { Opportunity } from '../types/opportunities.js';
+import type { PaginationParams } from '../types/common.js';
+export declare class EntitiesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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',
+     * });
+     * ```
+     */
+    list(params?: ListEntitiesParams): Promise<ParsedResponse<Entity[]>>;
+    /**
+     * 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);
+     * ```
+     */
+    get(uei: string): Promise<ParsedResponse<Entity>>;
+    /**
+     * 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 });
+     * ```
+     */
+    opportunities(uei: string, params?: PaginationParams): Promise<ParsedResponse<Opportunity[]>>;
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    exclusionCheck(uei: string): Promise<ParsedResponse<EntityExclusionCheckResult>>;
+    /**
+     * Get aggregated entity registration statistics.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.entities.stats();
+     * console.log('Total registered entities:', stats.data.total);
+     * ```
+     */
+    stats(): Promise<ParsedResponse<EntityStats>>;
+    /**
+     * 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);
+     *   }
+     * }
+     * ```
+     */
+    paginate(params: Omit<ListEntitiesParams, 'page'>): AsyncGenerator<ParsedResponse<Entity[]>>;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/types/resources/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/resources/entities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EACX,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;;;;;;;;;OAaG;IACG,IAAI,CACR,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAOpC;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAOvD;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC;IAQzC;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC;IAStF;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAInD;;;;;;;;;;;;;OAaG;IACI,QAAQ,CACb,MAAM,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,GACvC,cAAc,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;CAmB5C"}

package/dist/types/resources/exclusions.d.cts

@@ -0,0 +1,84 @@
+/**
+ * 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 type { HttpClient, ParsedResponse } from '../http.cjs';
+import type { Exclusion, ExclusionsStats, ListExclusionsParams, BulkComplianceCheckParams, ComplianceCheckResult } from '../types/exclusions.cjs';
+export declare class ExclusionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Search and filter the SAM.gov exclusions database.
+     *
+     * @param params  Filter and pagination parameters.
+     *
+     * @example
+     * ```ts
+     * const result = await client.exclusions.list({ uei: 'ABCDEF123456' });
+     * ```
+     */
+    list(params?: ListExclusionsParams): Promise<ParsedResponse<Exclusion[]>>;
+    /**
+     * Get a single exclusion record by its unique ID.
+     *
+     * @param exclusionId  Internal exclusion identifier.
+     * @throws {NotFoundError} If the exclusion record does not exist.
+     */
+    get(exclusionId: string): Promise<ParsedResponse<Exclusion>>;
+    /**
+     * 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');
+     * }
+     * ```
+     */
+    check(params: BulkComplianceCheckParams): Promise<ParsedResponse<ComplianceCheckResult[]>>;
+    /**
+     * Get aggregated exclusion statistics.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.exclusions.stats();
+     * console.log('Total active exclusions:', stats.data.active);
+     * ```
+     */
+    stats(): Promise<ParsedResponse<ExclusionsStats>>;
+    /**
+     * 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);
+     *   }
+     * }
+     * ```
+     */
+    paginate(params: Omit<ListExclusionsParams, 'page'>): AsyncGenerator<ParsedResponse<Exclusion[]>>;
+}
+//# sourceMappingURL=exclusions.d.ts.map

package/dist/types/resources/exclusions.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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 type { HttpClient, ParsedResponse } from '../http.js';
+import type { Exclusion, ExclusionsStats, ListExclusionsParams, BulkComplianceCheckParams, ComplianceCheckResult } from '../types/exclusions.js';
+export declare class ExclusionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Search and filter the SAM.gov exclusions database.
+     *
+     * @param params  Filter and pagination parameters.
+     *
+     * @example
+     * ```ts
+     * const result = await client.exclusions.list({ uei: 'ABCDEF123456' });
+     * ```
+     */
+    list(params?: ListExclusionsParams): Promise<ParsedResponse<Exclusion[]>>;
+    /**
+     * Get a single exclusion record by its unique ID.
+     *
+     * @param exclusionId  Internal exclusion identifier.
+     * @throws {NotFoundError} If the exclusion record does not exist.
+     */
+    get(exclusionId: string): Promise<ParsedResponse<Exclusion>>;
+    /**
+     * 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');
+     * }
+     * ```
+     */
+    check(params: BulkComplianceCheckParams): Promise<ParsedResponse<ComplianceCheckResult[]>>;
+    /**
+     * Get aggregated exclusion statistics.
+     *
+     * @example
+     * ```ts
+     * const stats = await client.exclusions.stats();
+     * console.log('Total active exclusions:', stats.data.active);
+     * ```
+     */
+    stats(): Promise<ParsedResponse<ExclusionsStats>>;
+    /**
+     * 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);
+     *   }
+     * }
+     * ```
+     */
+    paginate(params: Omit<ListExclusionsParams, 'page'>): AsyncGenerator<ParsedResponse<Exclusion[]>>;
+}
+//# sourceMappingURL=exclusions.d.ts.map

package/dist/types/resources/exclusions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusions.d.ts","sourceRoot":"","sources":["../../../src/resources/exclusions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,IAAI,EAAE,UAAU;IAI5B;;;;;;;;;OASG;IACG,IAAI,CACR,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;IAOvC;;;;;OAKG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IASlE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,KAAK,CACT,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAqBnD;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;IAIvD;;;;;;;;;;;;;OAaG;IACI,QAAQ,CACb,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GACzC,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC;CAmB/C"}

package/dist/types/resources/intelligence.d.cts

@@ -0,0 +1,66 @@
+/**
+ * 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 type { HttpClient, ParsedResponse } from '../http.cjs';
+import type { EntityIntelProfile, MarketAnalysis, CompliancePackage, ComplianceCheckRequestParams } from '../types/intelligence.cjs';
+export declare class IntelligenceResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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);
+     * ```
+     */
+    entityProfile(uei: string): Promise<ParsedResponse<EntityIntelProfile>>;
+    /**
+     * 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);
+     * ```
+     */
+    marketAnalysis(naics: string): Promise<ParsedResponse<MarketAnalysis>>;
+    /**
+     * 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.');
+     * }
+     * ```
+     */
+    complianceCheck(params: ComplianceCheckRequestParams): Promise<ParsedResponse<CompliancePackage>>;
+}
+//# sourceMappingURL=intelligence.d.ts.map