brigent-sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,356 @@
+export type DeploymentType = "api" | "fullstack" | "frontend" | "worker" | "static_site" | "database_only" | "cron";
+export type SourceMethod = "code" | "docker_image" | "git_repo";
+export type Runtime = "node" | "python" | "go" | "rust" | "deno" | "bun";
+export type DurationMode = "ephemeral" | "persistent";
+export type BudgetAction = "pause" | "terminate" | "notify";
+export type DeploymentStatus = "pending" | "provisioning" | "building" | "deploying" | "health_checking" | "live" | "paused" | "terminating" | "terminated" | "failed";
+export type Region = "us-west" | "us-east" | "eu-west" | "ap-southeast";
+export interface DeployRequest {
+    type: DeploymentType;
+    name: string;
+    source: {
+        method: SourceMethod;
+        runtime?: Runtime;
+        entry_point?: string;
+        code?: string;
+        image?: string;
+        repo_url?: string;
+        branch?: string;
+        build_command?: string;
+    };
+    resources?: {
+        database?: boolean | {
+            engine: "postgres";
+            extensions?: string[];
+        };
+        cache?: boolean | {
+            max_memory_mb: number;
+        };
+        storage?: boolean | {
+            max_gb: number;
+        };
+    };
+    duration_mode?: DurationMode;
+    budget_cap_usdc?: string;
+    on_budget_exhausted?: BudgetAction;
+    health_check_path?: string;
+    env_vars?: Record<string, string>;
+    idempotency_key?: string;
+    region?: Region;
+}
+export interface DeployResponse {
+    deployment_id: string;
+    status: "provisioning";
+    estimated_ready_seconds: number;
+    status_url: string;
+    cost_estimate: {
+        setup_usdc: string;
+        hourly_usdc: string;
+        monthly_estimate_usdc: string;
+    };
+}
+export interface ResourceStatus {
+    status: string;
+    provider_class?: string;
+    engine?: string;
+}
+export interface DeploymentDetail {
+    deployment_id: string;
+    name: string;
+    type: DeploymentType;
+    status: DeploymentStatus;
+    url?: string;
+    resources: {
+        compute: ResourceStatus;
+        database?: ResourceStatus;
+        cache?: ResourceStatus;
+        storage?: ResourceStatus;
+        domain: ResourceStatus;
+    };
+    budget: {
+        cap_usdc: string;
+        spent_usdc: string;
+        remaining_usdc: string;
+    };
+    created_at: string;
+    live_at?: string;
+    terminated_at?: string;
+    failure_reason?: string;
+}
+export interface DeploymentListItem {
+    deployment_id: string;
+    name: string;
+    type: DeploymentType;
+    status: DeploymentStatus;
+    url?: string;
+    created_at: string;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    total: number;
+    page: number;
+    per_page: number;
+}
+export interface CostEstimate {
+    setup_usdc: string;
+    hourly_usdc: string;
+    monthly_estimate_usdc: string;
+    breakdown: CostLineItem[];
+}
+export interface CostLineItem {
+    resource: string;
+    unit: string;
+    unit_price_usdc: string;
+    quantity: number;
+    subtotal_usdc: string;
+}
+export interface BudgetStatus {
+    cap_usdc: string;
+    spent_usdc: string;
+    remaining_usdc: string;
+    percent_used: number;
+}
+export interface CostResponse {
+    deployment_id: string;
+    budget: BudgetStatus;
+    billing_events: BillingEvent[];
+    current_rates: CostEstimate | null;
+}
+export interface BillingEvent {
+    id: string;
+    event_type: string;
+    amount_usdc: string;
+    created_at: string;
+}
+export interface LogEntry {
+    timestamp: string;
+    message: string;
+    level?: string;
+}
+export interface ScaleConfig {
+    replicas?: number;
+    cpu?: number;
+    memory_mb?: number;
+}
+export interface ApiKeyCreateParams {
+    name: string;
+    scopes?: string[];
+    budget_limit?: number;
+    expires_in_days?: number;
+    rate_limit_tier?: string;
+}
+export interface ApiKeyResponse {
+    id: string;
+    key: string;
+    name: string;
+    scopes: string[];
+    rate_limit_tier: string;
+    created_at: string;
+    expires_at?: string;
+    budget_limit: number | null;
+}
+export interface ApiKeyListItem {
+    id: string;
+    name: string;
+    scopes: string[];
+    rate_limit_tier: string;
+    created_at: string;
+    expires_at?: string;
+    budget_limit: number | null;
+    revoked_at: string | null;
+    active: boolean;
+}
+export interface WebhookCreateParams {
+    url: string;
+    events: string[];
+}
+export interface WebhookUpdateParams {
+    url?: string;
+    events?: string[];
+    active?: boolean;
+}
+export interface WebhookResponse {
+    id: string;
+    url: string;
+    events: string[];
+    secret: string;
+    active: boolean;
+    created_at: string;
+}
+export interface WebhookListItem {
+    id: string;
+    url: string;
+    events: string[];
+    active: boolean;
+    created_at: string;
+}
+export interface HealthResponse {
+    status: string;
+    service: string;
+    version: string;
+    timestamp: string;
+}
+export interface ReadinessResponse {
+    status: "ok" | "degraded";
+    service: string;
+    version: string;
+    components: Record<string, {
+        status: string;
+    }>;
+    timestamp: string;
+}
+export interface BrigentClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+/** Error codes returned by the Brigent server API */
+export type ServerErrorCode = "INVALID_REQUEST" | "INVALID_SOURCE" | "UNAUTHORIZED" | "PAYMENT_REQUIRED" | "FORBIDDEN" | "DEPLOYMENT_NOT_FOUND" | "NOT_FOUND" | "CONFLICT" | "IDEMPOTENCY_CONFLICT" | "BUDGET_TOO_LOW" | "RATE_LIMITED" | "INTERNAL_ERROR" | "PROVIDER_UNAVAILABLE" | "CAPACITY_EXHAUSTED";
+/** Error codes generated by the SDK client (not from server) */
+export type SdkErrorCode = "UNKNOWN" | "SSE_CONNECTION_FAILED" | "SSE_NO_BODY" | "DEPLOYMENT_FAILED" | "DEPLOYMENT_TERMINATED" | "MONITOR_TIMEOUT";
+/** All possible error codes (server + SDK client) */
+export type ErrorCode = ServerErrorCode | SdkErrorCode;
+export interface BrigentErrorBody {
+    error: {
+        code: ErrorCode;
+        message: string;
+        suggested_action: string;
+        documentation_url: string;
+        retry_after_seconds?: number;
+        details?: Record<string, unknown>;
+    };
+    request_id: string;
+}
+export interface AnalyticsOverview {
+    total_deployments: number;
+    active_deployments: number;
+    total_spend_usdc: string;
+    deployment_type_breakdown: Array<{
+        type: DeploymentType;
+        count: number;
+    }>;
+    generated_at: string;
+}
+export interface MetricsSnapshot {
+    timestamp: string;
+    cpu_percent: number;
+    memory_mb: number;
+    memory_limit_mb: number;
+    network_rx_bytes: number;
+    network_tx_bytes: number;
+}
+export interface UsageMetrics {
+    cpu_percent?: number;
+    memory_mb?: number;
+    storage_gb?: number;
+    requests?: number;
+    egress_gb?: number;
+}
+export interface DeploymentMetrics {
+    deployment_id: string;
+    metrics: MetricsSnapshot;
+    usage: UsageMetrics;
+    retrieved_at: string;
+}
+export interface AuditLogEntry {
+    id: string;
+    action: string;
+    deployment_id: string | null;
+    request_summary: string;
+    response_status: number;
+    ip_address: string | null;
+    created_at: string;
+}
+export interface AuditLogOptions {
+    action?: string;
+    since?: string;
+    page?: number;
+    per_page?: number;
+}
+export interface BillingSummary {
+    period: {
+        start: string | null;
+        end: string | null;
+    };
+    total_usdc: string;
+    billed_deployments: number;
+    top_deployments: Array<{
+        deployment_id: string;
+        name: string;
+        type: DeploymentType;
+        status: DeploymentStatus;
+        total_usdc: string;
+    }>;
+}
+export interface BillingSummaryOptions {
+    since?: string;
+    until?: string;
+}
+export interface TemplateCreateParams {
+    name: string;
+    description?: string;
+    deployment_type: DeploymentType;
+    config: Record<string, unknown>;
+    is_public?: boolean;
+}
+export interface TemplateResponse {
+    id: string;
+    name: string;
+    description: string | null;
+    deployment_type: DeploymentType;
+    config: Record<string, unknown>;
+    is_public: boolean;
+    is_own: boolean;
+    created_at: string;
+}
+export interface CustomDomainResponse {
+    deployment_id: string;
+    fqdn: string;
+    domain: string;
+    status: "assigned";
+}
+export interface WebhookDeliveryItem {
+    id: string;
+    event_type: string;
+    event_id: string;
+    status: string;
+    attempts: number;
+    last_error: string | null;
+    created_at: string;
+    delivered_at: string | null;
+}
+export interface PricingTier {
+    name: string;
+    display_name: string;
+    price_multiplier: number;
+    monthly_base_usdc: string;
+    features: Record<string, boolean>;
+    limits: Record<string, number>;
+    rate_limits: {
+        deploys_per_hour: number;
+        gets_per_minute: number;
+    };
+}
+export interface PricingResponse {
+    tiers: PricingTier[];
+}
+export interface TierResponse {
+    tier: string;
+    display_name: string;
+    price_multiplier: number;
+    monthly_base_usdc: string;
+    features: Record<string, boolean>;
+    limits: Record<string, number>;
+    rate_limits: {
+        deploys_per_hour: number;
+        gets_per_minute: number;
+    };
+}
+export interface DeploymentEvent {
+    deployment_id: string;
+    status: string;
+    previous_status?: string;
+    timestamp: string;
+    failure_reason?: string;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+// SDK Type Definitions
+// These mirror the server-side types without importing from server code.
+export {};

package/dist/webhooks.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Verify a webhook signature from Brigent.
+ * The signature is sent in the X-Brigent-Signature header.
+ *
+ * @param payload - The raw request body as a string
+ * @param signature - The X-Brigent-Signature header value
+ * @param secret - The webhook secret (whsec_...)
+ * @returns true if the signature is valid
+ */
+export declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;

package/dist/webhooks.js

@@ -0,0 +1,17 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+/**
+ * Verify a webhook signature from Brigent.
+ * The signature is sent in the X-Brigent-Signature header.
+ *
+ * @param payload - The raw request body as a string
+ * @param signature - The X-Brigent-Signature header value
+ * @param secret - The webhook secret (whsec_...)
+ * @returns true if the signature is valid
+ */
+export function verifyWebhookSignature(payload, signature, secret) {
+    const expected = createHmac("sha256", secret).update(payload).digest("hex");
+    // Use timing-safe comparison to prevent timing attacks
+    if (expected.length !== signature.length)
+        return false;
+    return timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(signature, "hex"));
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "brigent-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Brigent Agent-Native Infrastructure Platform",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "brigent",
+    "ai-agent",
+    "infrastructure",
+    "deployment",
+    "paas",
+    "sdk",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/balflee/brigent.git",
+    "directory": "sdk"
+  },
+  "homepage": "https://github.com/balflee/brigent/tree/main/sdk#readme",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}