@agentuity/webhook 1.0.54

package/AGENTS.md

@@ -0,0 +1,39 @@
+# Agent Guidelines for @agentuity/webhook
+
+## Package Overview
+
+Standalone package for the Agentuity Webhook service. Provides a simple, ergonomic client for creating and managing webhook endpoints.
+
+## Commands
+
+- **Build**: `bun run build`
+- **Typecheck**: `bun run typecheck`
+- **Clean**: `rm -rf dist`
+
+## Architecture
+
+- **Runtime**: Node.js and Bun compatible
+- **Exports**: WebhookClient and all types from @agentuity/core/webhook
+- **Dependencies**: @agentuity/core, @agentuity/server, zod
+
+## Usage
+
+```typescript
+import { WebhookClient } from '@agentuity/webhook';
+
+const client = new WebhookClient();
+
+// Create a webhook
+const { webhook } = await client.create({ name: 'GitHub Events' });
+
+// Add a destination
+await client.createDestination(webhook.id, {
+  type: 'url',
+  config: { url: 'https://example.com/webhook' }
+});
+```
+
+## Publishing
+
+1. Run `bun run build`
+2. Must publish **after** @agentuity/core

package/README.md

@@ -0,0 +1,64 @@
+# @agentuity/webhook
+
+A standalone package for the Agentuity Webhook service.
+
+## Installation
+
+```bash
+npm install @agentuity/webhook
+```
+
+## Quick Start
+
+```typescript
+import { WebhookClient } from '@agentuity/webhook';
+
+const client = new WebhookClient();
+
+// Create a webhook
+const { webhook } = await client.create({
+  name: 'GitHub Events',
+  description: 'Receives GitHub webhook events'
+});
+
+console.log('Ingest URL:', webhook.url);
+
+// Add a destination
+await client.createDestination(webhook.id, {
+  type: 'url',
+  config: { url: 'https://example.com/webhook' }
+});
+
+// List receipts
+const { receipts } = await client.listReceipts(webhook.id);
+for (const receipt of receipts) {
+  console.log(`Received: ${receipt.id} at ${receipt.date}`);
+}
+
+// Check delivery status
+const { deliveries } = await client.listDeliveries(webhook.id);
+for (const d of deliveries) {
+  console.log(`${d.status} → ${d.webhook_destination_id}`);
+}
+```
+
+## Configuration
+
+```typescript
+const client = new WebhookClient({
+  apiKey: 'your-api-key',
+  url: 'https://api.agentuity.com',
+});
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AGENTUITY_SDK_KEY` | API key for authentication | Required |
+| `AGENTUITY_REGION` | Region for API endpoints | `usc` |
+| `AGENTUITY_WEBHOOK_URL` | Override Webhook API URL | Auto-detected |
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+export { WebhookService, type Webhook, type WebhookDestination, type WebhookDelivery, type WebhookReceipt, type CreateWebhookRequest, type CreateWebhookDestinationRequest, type UpdateWebhookRequest, type WebhookApiOptions, type WebhookDeliveryStatus, type WebhookDestinationType, type WebhookAnalyticsGranularity, type WebhookAnalyticsOptions, type WebhookAnalyticsSummary, type WebhookOrgAnalytics, type WebhookTimePeriod, type WebhookTimeSeriesData, type WebhookTimeSeriesPoint, type CreateWebhookParams, type UpdateWebhookParams, type CreateWebhookDestinationParams, type WebhookListResult, type WebhookGetResult, type WebhookCreateResult, type UpdateWebhookResult, type CreateDestinationResult, type ListDestinationsResult, type WebhookReceiptListResult, type WebhookDeliveryListResult, WebhookSchema, WebhookDestinationSchema, WebhookDeliverySchema, WebhookReceiptSchema, CreateWebhookRequestSchema, CreateWebhookDestinationRequestSchema, UpdateWebhookRequestSchema, WebhookApiOptionsSchema, WebhookDeliveryStatusSchema, WebhookDestinationTypeSchema, WebhookAnalyticsGranularitySchema, WebhookAnalyticsOptionsSchema, WebhookAnalyticsSummarySchema, WebhookOrgAnalyticsSchema, WebhookTimePeriodSchema, WebhookTimeSeriesDataSchema, WebhookTimeSeriesPointSchema, WebhookNotFoundError, WebhookDestinationNotFoundError, WebhookDeliveryNotFoundError, WebhookReceiptNotFoundError, WebhookError, } from '@agentuity/core/webhook';
+import { type CreateWebhookParams, type UpdateWebhookParams, type CreateWebhookDestinationParams, type WebhookCreateResult, type WebhookListResult, type WebhookGetResult, type UpdateWebhookResult, type CreateDestinationResult, type ListDestinationsResult, type WebhookReceiptListResult, type WebhookDeliveryListResult, type WebhookOrgAnalytics, type WebhookReceipt } from '@agentuity/core/webhook';
+import { type Logger } from '@agentuity/server';
+import { z } from 'zod';
+export declare const WebhookClientOptionsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+    logger: z.ZodOptional<z.ZodCustom<Logger, Logger>>;
+}, z.core.$strip>;
+export type WebhookClientOptions = z.infer<typeof WebhookClientOptionsSchema>;
+export declare class WebhookClient {
+    #private;
+    constructor(options?: WebhookClientOptions);
+    create(params: CreateWebhookParams): Promise<WebhookCreateResult>;
+    list(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<WebhookListResult>;
+    get(webhookId: string): Promise<WebhookGetResult>;
+    update(webhookId: string, params: UpdateWebhookParams): Promise<UpdateWebhookResult>;
+    delete(webhookId: string): Promise<void>;
+    createDestination(webhookId: string, params: CreateWebhookDestinationParams): Promise<CreateDestinationResult>;
+    listDestinations(webhookId: string): Promise<ListDestinationsResult>;
+    deleteDestination(webhookId: string, destinationId: string): Promise<void>;
+    listReceipts(webhookId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<WebhookReceiptListResult>;
+    getReceipt(webhookId: string, receiptId: string): Promise<WebhookReceipt>;
+    listDeliveries(webhookId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<WebhookDeliveryListResult>;
+    retryDelivery(webhookId: string, deliveryId: string): Promise<void>;
+    getOrgAnalytics(options?: {
+        start?: string;
+        end?: string;
+        granularity?: string;
+    }): Promise<WebhookOrgAnalytics>;
+    getOrgTimeSeries(options?: {
+        start?: string;
+        end?: string;
+        granularity?: string;
+    }): Promise<{
+        period: {
+            start: string;
+            end: string;
+            granularity?: string;
+        };
+        series: Array<{
+            timestamp: string;
+            received: number;
+            delivered: number;
+            failed: number;
+        }>;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,76 @@
+export { WebhookService, WebhookSchema, WebhookDestinationSchema, WebhookDeliverySchema, WebhookReceiptSchema, CreateWebhookRequestSchema, CreateWebhookDestinationRequestSchema, UpdateWebhookRequestSchema, WebhookApiOptionsSchema, WebhookDeliveryStatusSchema, WebhookDestinationTypeSchema, WebhookAnalyticsGranularitySchema, WebhookAnalyticsOptionsSchema, WebhookAnalyticsSummarySchema, WebhookOrgAnalyticsSchema, WebhookTimePeriodSchema, WebhookTimeSeriesDataSchema, WebhookTimeSeriesPointSchema, WebhookNotFoundError, WebhookDestinationNotFoundError, WebhookDeliveryNotFoundError, WebhookReceiptNotFoundError, WebhookError, } from '@agentuity/core/webhook';
+import { WebhookService, } from '@agentuity/core/webhook';
+import { createServerFetchAdapter, buildClientHeaders } from '@agentuity/server';
+import { createMinimalLogger } from '@agentuity/core';
+import { getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { z } from 'zod';
+const isLogger = (val) => typeof val === 'object' &&
+    val !== null &&
+    ['info', 'warn', 'error', 'debug', 'trace'].every((m) => typeof val[m] === 'function');
+export const WebhookClientOptionsSchema = z.object({
+    apiKey: z.string().optional().describe('API key for authentication'),
+    url: z.string().optional().describe('Base URL for the Webhook API'),
+    orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+    logger: z.custom(isLogger).optional().describe('Custom logger instance'),
+});
+export class WebhookClient {
+    #service;
+    constructor(options = {}) {
+        const validatedOptions = WebhookClientOptionsSchema.parse(options);
+        const apiKey = validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
+        const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+        const serviceUrls = getServiceUrls(region);
+        const url = validatedOptions.url || getEnv('AGENTUITY_WEBHOOK_URL') || serviceUrls.catalyst;
+        const logger = validatedOptions.logger ?? createMinimalLogger();
+        const headers = buildClientHeaders({
+            apiKey,
+            orgId: validatedOptions.orgId,
+        });
+        const adapter = createServerFetchAdapter({ headers }, logger);
+        this.#service = new WebhookService(url, adapter);
+    }
+    async create(params) {
+        return this.#service.create(params);
+    }
+    async list(params) {
+        return this.#service.list(params);
+    }
+    async get(webhookId) {
+        return this.#service.get(webhookId);
+    }
+    async update(webhookId, params) {
+        return this.#service.update(webhookId, params);
+    }
+    async delete(webhookId) {
+        return this.#service.delete(webhookId);
+    }
+    async createDestination(webhookId, params) {
+        return this.#service.createDestination(webhookId, params);
+    }
+    async listDestinations(webhookId) {
+        return this.#service.listDestinations(webhookId);
+    }
+    async deleteDestination(webhookId, destinationId) {
+        return this.#service.deleteDestination(webhookId, destinationId);
+    }
+    async listReceipts(webhookId, params) {
+        return this.#service.listReceipts(webhookId, params);
+    }
+    async getReceipt(webhookId, receiptId) {
+        return this.#service.getReceipt(webhookId, receiptId);
+    }
+    async listDeliveries(webhookId, params) {
+        return this.#service.listDeliveries(webhookId, params);
+    }
+    async retryDelivery(webhookId, deliveryId) {
+        return this.#service.retryDelivery(webhookId, deliveryId);
+    }
+    async getOrgAnalytics(options) {
+        return this.#service.getOrgAnalytics(options);
+    }
+    async getOrgTimeSeries(options) {
+        return this.#service.getOrgTimeSeries(options);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@agentuity/webhook",
+	"version": "1.0.54",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"AGENTS.md",
+		"README.md",
+		"src",
+		"dist"
+	],
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "bunx tsc --build --force",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@agentuity/core": "1.0.54",
+		"@agentuity/server": "1.0.54",
+		"zod": "^4.3.5"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/node": "^22.0.0",
+		"bun-types": "latest",
+		"typescript": "^5.9.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false
+}

package/src/index.ts

@@ -0,0 +1,190 @@
+export {
+	WebhookService,
+	type Webhook,
+	type WebhookDestination,
+	type WebhookDelivery,
+	type WebhookReceipt,
+	type CreateWebhookRequest,
+	type CreateWebhookDestinationRequest,
+	type UpdateWebhookRequest,
+	type WebhookApiOptions,
+	type WebhookDeliveryStatus,
+	type WebhookDestinationType,
+	type WebhookAnalyticsGranularity,
+	type WebhookAnalyticsOptions,
+	type WebhookAnalyticsSummary,
+	type WebhookOrgAnalytics,
+	type WebhookTimePeriod,
+	type WebhookTimeSeriesData,
+	type WebhookTimeSeriesPoint,
+	type CreateWebhookParams,
+	type UpdateWebhookParams,
+	type CreateWebhookDestinationParams,
+	type WebhookListResult,
+	type WebhookGetResult,
+	type WebhookCreateResult,
+	type UpdateWebhookResult,
+	type CreateDestinationResult,
+	type ListDestinationsResult,
+	type WebhookReceiptListResult,
+	type WebhookDeliveryListResult,
+	WebhookSchema,
+	WebhookDestinationSchema,
+	WebhookDeliverySchema,
+	WebhookReceiptSchema,
+	CreateWebhookRequestSchema,
+	CreateWebhookDestinationRequestSchema,
+	UpdateWebhookRequestSchema,
+	WebhookApiOptionsSchema,
+	WebhookDeliveryStatusSchema,
+	WebhookDestinationTypeSchema,
+	WebhookAnalyticsGranularitySchema,
+	WebhookAnalyticsOptionsSchema,
+	WebhookAnalyticsSummarySchema,
+	WebhookOrgAnalyticsSchema,
+	WebhookTimePeriodSchema,
+	WebhookTimeSeriesDataSchema,
+	WebhookTimeSeriesPointSchema,
+	WebhookNotFoundError,
+	WebhookDestinationNotFoundError,
+	WebhookDeliveryNotFoundError,
+	WebhookReceiptNotFoundError,
+	WebhookError,
+} from '@agentuity/core/webhook';
+
+import {
+	WebhookService,
+	type CreateWebhookParams,
+	type UpdateWebhookParams,
+	type CreateWebhookDestinationParams,
+	type WebhookCreateResult,
+	type WebhookListResult,
+	type WebhookGetResult,
+	type UpdateWebhookResult,
+	type CreateDestinationResult,
+	type ListDestinationsResult,
+	type WebhookReceiptListResult,
+	type WebhookDeliveryListResult,
+	type WebhookOrgAnalytics,
+	type WebhookReceipt,
+} from '@agentuity/core/webhook';
+import { createServerFetchAdapter, buildClientHeaders, type Logger } from '@agentuity/server';
+import { createMinimalLogger } from '@agentuity/core';
+import { getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { z } from 'zod';
+
+const isLogger = (val: unknown): val is Logger =>
+	typeof val === 'object' &&
+	val !== null &&
+	['info', 'warn', 'error', 'debug', 'trace'].every(
+		(m) => typeof (val as Record<string, unknown>)[m] === 'function'
+	);
+
+export const WebhookClientOptionsSchema = z.object({
+	apiKey: z.string().optional().describe('API key for authentication'),
+	url: z.string().optional().describe('Base URL for the Webhook API'),
+	orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+	logger: z.custom<Logger>(isLogger).optional().describe('Custom logger instance'),
+});
+export type WebhookClientOptions = z.infer<typeof WebhookClientOptionsSchema>;
+
+export class WebhookClient {
+	readonly #service: WebhookService;
+
+	constructor(options: WebhookClientOptions = {}) {
+		const validatedOptions = WebhookClientOptionsSchema.parse(options);
+		const apiKey =
+			validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
+		const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+		const serviceUrls = getServiceUrls(region);
+
+		const url = validatedOptions.url || getEnv('AGENTUITY_WEBHOOK_URL') || serviceUrls.catalyst;
+
+		const logger = validatedOptions.logger ?? createMinimalLogger();
+
+		const headers = buildClientHeaders({
+			apiKey,
+			orgId: validatedOptions.orgId,
+		});
+
+		const adapter = createServerFetchAdapter({ headers }, logger);
+		this.#service = new WebhookService(url, adapter);
+	}
+
+	async create(params: CreateWebhookParams): Promise<WebhookCreateResult> {
+		return this.#service.create(params);
+	}
+
+	async list(params?: { limit?: number; offset?: number }): Promise<WebhookListResult> {
+		return this.#service.list(params);
+	}
+
+	async get(webhookId: string): Promise<WebhookGetResult> {
+		return this.#service.get(webhookId);
+	}
+
+	async update(webhookId: string, params: UpdateWebhookParams): Promise<UpdateWebhookResult> {
+		return this.#service.update(webhookId, params);
+	}
+
+	async delete(webhookId: string): Promise<void> {
+		return this.#service.delete(webhookId);
+	}
+
+	async createDestination(
+		webhookId: string,
+		params: CreateWebhookDestinationParams
+	): Promise<CreateDestinationResult> {
+		return this.#service.createDestination(webhookId, params);
+	}
+
+	async listDestinations(webhookId: string): Promise<ListDestinationsResult> {
+		return this.#service.listDestinations(webhookId);
+	}
+
+	async deleteDestination(webhookId: string, destinationId: string): Promise<void> {
+		return this.#service.deleteDestination(webhookId, destinationId);
+	}
+
+	async listReceipts(
+		webhookId: string,
+		params?: { limit?: number; offset?: number }
+	): Promise<WebhookReceiptListResult> {
+		return this.#service.listReceipts(webhookId, params);
+	}
+
+	async getReceipt(webhookId: string, receiptId: string): Promise<WebhookReceipt> {
+		return this.#service.getReceipt(webhookId, receiptId);
+	}
+
+	async listDeliveries(
+		webhookId: string,
+		params?: { limit?: number; offset?: number }
+	): Promise<WebhookDeliveryListResult> {
+		return this.#service.listDeliveries(webhookId, params);
+	}
+
+	async retryDelivery(webhookId: string, deliveryId: string): Promise<void> {
+		return this.#service.retryDelivery(webhookId, deliveryId);
+	}
+
+	async getOrgAnalytics(options?: {
+		start?: string;
+		end?: string;
+		granularity?: string;
+	}): Promise<WebhookOrgAnalytics> {
+		return this.#service.getOrgAnalytics(options);
+	}
+
+	async getOrgTimeSeries(options?: {
+		start?: string;
+		end?: string;
+		granularity?: string;
+	}): Promise<{
+		period: { start: string; end: string; granularity?: string };
+		series: Array<{ timestamp: string; received: number; delivered: number; failed: number }>;
+	}> {
+		return this.#service.getOrgTimeSeries(options);
+	}
+}