@fedpulse/sdk 1.0.3 → 1.0.5

package/README.md

@@ -44,7 +44,7 @@ const client = new FedPulse({ apiKey: process.env.FEDPULSE_API_KEY! });
 
 // Search opportunities
 const result = await client.opportunities.list({
-  keyword: 'cybersecurity',
+  q: 'cybersecurity',
   naics: ['541519', '541512'],
   postedAfter: '2025-01-01',
   limit: 25,
@@ -74,7 +74,7 @@ Never hard-code keys in source — use environment variables.
 
 ```ts
 // List / search opportunities
-await client.opportunities.list({ keyword: 'cloud', naics: ['541512'] });
+await client.opportunities.list({ q: 'cloud', naics: ['541512'] });
 
 // Retrieve a single opportunity
 await client.opportunities.get('abc123-notice-id');
@@ -155,22 +155,74 @@ await client.intelligence.marketAnalysis('541512');
 await client.intelligence.complianceCheck({ uei: 'ABCDEF123456' });
 ```
 
+### `client.assistance`
+
+Federal grants and assistance listings (CFDA programs).
+
+```ts
+// Search listings
+await client.assistance.list({ keyword: 'broadband', agency: 'USDA' });
+
+// Retrieve one by CFDA program number (format: "XX.XXX")
+await client.assistance.get('10.001');
+
+// Aggregated stats
+await client.assistance.stats();
+
+// Auto-paginate all listings
+for await (const page of client.assistance.paginate({ agency: 'HHS' })) {
+  console.log(page.data);
+}
+```
+
+### `client.analytics`
+
+Per-user API usage analytics — scoped to the authenticated key.
+
+```ts
+// KPI totals (requests today, this month, error rates)
+await client.analytics.summary({ range: '30d' });
+
+// Per-day breakdown for charting (up to 90 days)
+await client.analytics.chart({ range: '30d' });
+
+// Top endpoints by request volume and P95 latency
+await client.analytics.endpoints({ range: '7d' });
+
+// Paginated raw request log
+await client.analytics.logs({ limit: 20 });
+```
+
 ### `client.webhooks`
 
 ```ts
 // List configured webhooks
 await client.webhooks.list();
 
+// Get a single webhook
+await client.webhooks.get('wh-uuid');
+
 // Create
 await client.webhooks.create({ url: 'https://example.com/hook', events: ['opportunity.new'] });
 
 // Update / delete
-await client.webhooks.update('wh_id', { active: false });
-await client.webhooks.delete('wh_id');
+await client.webhooks.update('wh-uuid', { active: false });
+await client.webhooks.delete('wh-uuid');
+
+// Send a test event to the endpoint immediately
+await client.webhooks.test('wh-uuid');
+
+// Resume a paused webhook (auto-paused after 5 consecutive failures)
+await client.webhooks.resume('wh-uuid');
 
 // Deliveries log
-await client.webhooks.listDeliveries('wh_id');
-await client.webhooks.getDelivery('wh_id', 'delivery-id');
+await client.webhooks.listDeliveries('wh-uuid', { status: 'failed' });
+await client.webhooks.getDelivery('wh-uuid', 'delivery-uuid');
+
+// Auto-paginate all delivery history
+for await (const page of client.webhooks.deliveryPages('wh-uuid', { status: 'failed' })) {
+  console.log(page.data);
+}
 ```
 
 ---

package/dist/cjs/resources/assistance.cjs

@@ -2,10 +2,10 @@
 /**
  * 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)
+ * Wraps all /v1/assistance-listings endpoints:
+ *   - list      GET /v1/assistance-listings
+ *   - stats     GET /v1/assistance-listings/stats
+ *   - get       GET /v1/assistance-listings/:number   (CFDA program number)
  *   - paginate  auto-paginates over the list endpoint
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -26,7 +26,7 @@ class AssistanceResource {
      * ```
      */
     async list(params = {}) {
-        return this.http.get('/v1/assistance', params);
+        return this.http.get('/v1/assistance-listings', params);
     }
     /**
      * Get aggregated statistics for assistance listings.
@@ -39,7 +39,7 @@ class AssistanceResource {
      * ```
      */
     async stats(params = {}) {
-        return this.http.get('/v1/assistance/stats', params);
+        return this.http.get('/v1/assistance-listings/stats', params);
     }
     /**
      * Get a single assistance listing by its CFDA program number.
@@ -61,7 +61,7 @@ class AssistanceResource {
         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)}`);
+        return this.http.get(`/v1/assistance-listings/${encodeURIComponent(trimmed)}`);
     }
     /**
      * Async generator that automatically paginates over all matching assistance listings.

package/dist/esm/resources/assistance.js

@@ -1,10 +1,10 @@
 /**
  * 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)
+ * Wraps all /v1/assistance-listings endpoints:
+ *   - list      GET /v1/assistance-listings
+ *   - stats     GET /v1/assistance-listings/stats
+ *   - get       GET /v1/assistance-listings/:number   (CFDA program number)
  *   - paginate  auto-paginates over the list endpoint
  */
 export class AssistanceResource {
@@ -23,7 +23,7 @@ export class AssistanceResource {
      * ```
      */
     async list(params = {}) {
-        return this.http.get('/v1/assistance', params);
+        return this.http.get('/v1/assistance-listings', params);
     }
     /**
      * Get aggregated statistics for assistance listings.
@@ -36,7 +36,7 @@ export class AssistanceResource {
      * ```
      */
     async stats(params = {}) {
-        return this.http.get('/v1/assistance/stats', params);
+        return this.http.get('/v1/assistance-listings/stats', params);
     }
     /**
      * Get a single assistance listing by its CFDA program number.
@@ -58,7 +58,7 @@ export class AssistanceResource {
         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)}`);
+        return this.http.get(`/v1/assistance-listings/${encodeURIComponent(trimmed)}`);
     }
     /**
      * Async generator that automatically paginates over all matching assistance listings.

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

@@ -1 +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"}
+{"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,yBAAyB,EACzB,MAAiC,CAClC,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CACT,SAAmC,EAAE;QAErC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,+BAA+B,EAC/B,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,2BAA2B,kBAAkB,CAAC,OAAO,CAAC,EAAE,CACzD,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/types/resources/assistance.d.cts

@@ -1,10 +1,10 @@
 /**
  * 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)
+ * Wraps all /v1/assistance-listings endpoints:
+ *   - list      GET /v1/assistance-listings
+ *   - stats     GET /v1/assistance-listings/stats
+ *   - get       GET /v1/assistance-listings/:number   (CFDA program number)
  *   - paginate  auto-paginates over the list endpoint
  */
 import type { HttpClient, ParsedResponse } from '../http.cjs';

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

@@ -1,10 +1,10 @@
 /**
  * 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)
+ * Wraps all /v1/assistance-listings endpoints:
+ *   - list      GET /v1/assistance-listings
+ *   - stats     GET /v1/assistance-listings/stats
+ *   - get       GET /v1/assistance-listings/:number   (CFDA program number)
  *   - paginate  auto-paginates over the list endpoint
  */
 import type { HttpClient, ParsedResponse } from '../http.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedpulse/sdk",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Official JavaScript/TypeScript SDK for the FedPulse API — federal contracts, exclusions, entities, assistance listings, and market intelligence.",
   "keywords": [
     "fedpulse",