@aguardic/sdk 0.1.0

package/README.md

@@ -0,0 +1,193 @@
+# @aguardic/sdk
+
+Official TypeScript SDK for the [Aguardic](https://aguardic.com) governance API.
+
+## Installation
+
+```bash
+npm install @aguardic/sdk
+# or
+pnpm add @aguardic/sdk
+# or
+yarn add @aguardic/sdk
+```
+
+**Requirements:** Node.js 18+
+
+## Quick Start
+
+```typescript
+import Aguardic from "@aguardic/sdk";
+
+const aguardic = new Aguardic("ag_live_xxxxx");
+
+const result = await aguardic.evaluate({
+  input: { content: "Transfer $50,000 to account 12345" },
+  targetKey: "bank-transfer",
+});
+
+if (result.enforcementAction === "BLOCK") {
+  console.log("Blocked:", result.violations);
+}
+```
+
+## Configuration
+
+```typescript
+// Simple — API key only
+const aguardic = new Aguardic("ag_live_xxxxx");
+
+// Advanced — full options
+const aguardic = new Aguardic({
+  apiKey: "ag_live_xxxxx",
+  baseUrl: "https://api.aguardic.com/v1", // default
+  timeout: 30000, // default, in milliseconds
+});
+```
+
+## API Reference
+
+### `aguardic.evaluate(params)`
+
+Evaluate content against your bound policies.
+
+```typescript
+const result = await aguardic.evaluate({
+  input: { content: "User message to check" },
+  targetKey: "chat-message", // optional — route to specific policies
+  correlationId: "req-123", // optional — for tracking
+  sessionId: "sess-abc", // optional — for session-based evaluation
+});
+
+// result.outcome: 'ALLOW' | 'DENY' | 'FLAG'
+// result.enforcementAction: 'ALLOW' | 'WARN' | 'BLOCK' | 'APPROVAL_REQUIRED'
+// result.violations: Violation[]
+```
+
+### `aguardic.sessions.create(params?)`
+
+Create an evaluation session for multi-step interactions.
+
+```typescript
+const session = await aguardic.sessions.create({
+  metadata: { agentId: "support-bot" },
+});
+// session.id, session.status
+```
+
+### `aguardic.sessions.get(sessionId)`
+
+Get session details including all actions.
+
+```typescript
+const detail = await aguardic.sessions.get(session.id);
+// detail.actions, detail.actionCount, detail.toolsUsed
+```
+
+### `aguardic.sessions.end(sessionId, params?)`
+
+End an active session.
+
+```typescript
+const summary = await aguardic.sessions.end(session.id, {
+  status: "COMPLETED", // or 'TERMINATED'
+});
+```
+
+### `aguardic.reviews.get(reviewId)`
+
+Get a review request by ID (for approval flows).
+
+```typescript
+const review = await aguardic.reviews.get(result.reviewRequestId);
+// review.status: 'PENDING' | 'APPROVED' | 'REJECTED' | 'EXPIRED' | 'CANCELLED'
+```
+
+### `aguardic.reviews.getByCorrelation(correlationId)`
+
+Get a review request by correlation ID.
+
+```typescript
+const review = await aguardic.reviews.getByCorrelation("req-123");
+```
+
+## Error Handling
+
+The SDK throws typed errors for different HTTP status codes:
+
+```typescript
+import { AguardicError, AuthenticationError, ValidationError } from "@aguardic/sdk";
+
+try {
+  await aguardic.evaluate({ input: { content: "test" } });
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    // 401 — invalid API key
+  } else if (error instanceof ValidationError) {
+    // 400 — invalid request body
+  } else if (error instanceof AguardicError) {
+    // Any API error
+    console.log(error.statusCode, error.errors);
+  }
+}
+```
+
+**Error classes:**
+
+| Class | Status Code |
+|-------|-------------|
+| `ValidationError` | 400 |
+| `AuthenticationError` | 401 |
+| `ForbiddenError` | 403 |
+| `NotFoundError` | 404 |
+| `RateLimitError` | 429 |
+| `ServerError` | 500+ |
+
+## Full Example — AI Agent Guardrails
+
+```typescript
+import Aguardic from "@aguardic/sdk";
+
+const aguardic = new Aguardic(process.env.AGUARDIC_API_KEY!);
+
+async function runAgent() {
+  // Start a session
+  const session = await aguardic.sessions.create({
+    metadata: { agentId: "support-bot", userId: "user-456" },
+  });
+
+  // Check each action before executing
+  const result = await aguardic.evaluate({
+    input: {
+      tool: "send_email",
+      to: "customer@example.com",
+      subject: "Account update",
+      body: "Your password has been reset.",
+    },
+    sessionId: session.id,
+    targetKey: "send_email",
+  });
+
+  if (result.enforcementAction === "BLOCK") {
+    console.log("Action blocked:", result.violations);
+    return;
+  }
+
+  if (result.enforcementAction === "APPROVAL_REQUIRED") {
+    // Poll for approval
+    const review = await aguardic.reviews.get(result.reviewRequestId!);
+    console.log("Waiting for approval:", review.status);
+    return;
+  }
+
+  // Action allowed — proceed
+  await sendEmail(/* ... */);
+
+  // End session when done
+  await aguardic.sessions.end(session.id);
+}
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,148 @@
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    timeout: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(options: HttpClientOptions);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    private request;
+    private throwError;
+}
+
+interface AguardicOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+interface EvaluateParams {
+    input: Record<string, any>;
+    targetKey?: string;
+    targetMetadata?: Record<string, any>;
+    correlationId?: string;
+    callbackUrl?: string;
+    sessionId?: string;
+}
+interface EvaluateResponse {
+    outcome: "ALLOW" | "DENY" | "FLAG";
+    enforcementAction: "ALLOW" | "WARN" | "BLOCK" | "APPROVAL_REQUIRED";
+    evaluationRunId: string | null;
+    reviewRequestId: string | null;
+    pollUrl: string | null;
+    sessionId: string | null;
+    violations: Violation[];
+}
+interface Violation {
+    id: string;
+    ruleId: string;
+    ruleName: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | null;
+    resolvedAction: "BLOCK" | "APPROVAL_REQUIRED" | "WARN" | "LOG" | null;
+    explanation: string | null;
+    field: string | null;
+    snippet: string | null;
+}
+interface CreateSessionParams {
+    entityId?: string;
+    externalSessionId?: string;
+    expiresAt?: string;
+    metadata?: Record<string, any>;
+}
+interface Session {
+    id: string;
+    status: "ACTIVE" | "COMPLETED" | "EXPIRED" | "TERMINATED";
+    entityId: string | null;
+    externalSessionId: string | null;
+    startedAt: string;
+    expiresAt: string | null;
+    metadata: Record<string, any> | null;
+}
+interface EndSessionParams {
+    status?: "COMPLETED" | "TERMINATED";
+}
+interface EndSessionResponse {
+    id: string;
+    status: string;
+    endedAt: string;
+    actionCount: number;
+    dataTags: string[];
+    toolsUsed: string[];
+}
+interface ReviewRequest {
+    id: string;
+    status: "PENDING" | "APPROVED" | "REJECTED" | "EXPIRED" | "CANCELLED";
+    decidedAt: string | null;
+    decidedByUserId: string | null;
+    decisionComment: string | null;
+    expiresAt: string | null;
+    correlationId: string | null;
+    createdAt: string;
+}
+
+declare class ReviewsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    get(reviewId: string): Promise<ReviewRequest>;
+    getByCorrelation(correlationId: string): Promise<ReviewRequest>;
+}
+
+declare class SessionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params?: CreateSessionParams): Promise<Session>;
+    end(sessionId: string, params?: EndSessionParams): Promise<EndSessionResponse>;
+}
+
+declare class Aguardic {
+    readonly sessions: SessionsResource;
+    readonly reviews: ReviewsResource;
+    private readonly evaluateResource;
+    constructor(apiKeyOrOptions: string | AguardicOptions);
+    evaluate(params: EvaluateParams): Promise<EvaluateResponse>;
+}
+
+declare class AguardicError extends Error {
+    readonly statusCode: number;
+    readonly errors: Array<{
+        message: string;
+    }>;
+    constructor(statusCode: number, errors: Array<{
+        message: string;
+    }>, message?: string);
+}
+declare class ValidationError extends AguardicError {
+    constructor(errors: Array<{
+        message: string;
+    }>);
+}
+declare class AuthenticationError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class ForbiddenError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class NotFoundError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class RateLimitError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class ServerError extends AguardicError {
+    constructor(statusCode?: number, errors?: Array<{
+        message: string;
+    }>);
+}
+
+export { Aguardic, AguardicError, type AguardicOptions, AuthenticationError, type CreateSessionParams, type EndSessionParams, type EndSessionResponse, type EvaluateParams, type EvaluateResponse, ForbiddenError, NotFoundError, RateLimitError, type ReviewRequest, ServerError, type Session, ValidationError, type Violation, Aguardic as default };

package/dist/index.d.ts

@@ -0,0 +1,148 @@
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+    timeout: number;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(options: HttpClientOptions);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    private request;
+    private throwError;
+}
+
+interface AguardicOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+interface EvaluateParams {
+    input: Record<string, any>;
+    targetKey?: string;
+    targetMetadata?: Record<string, any>;
+    correlationId?: string;
+    callbackUrl?: string;
+    sessionId?: string;
+}
+interface EvaluateResponse {
+    outcome: "ALLOW" | "DENY" | "FLAG";
+    enforcementAction: "ALLOW" | "WARN" | "BLOCK" | "APPROVAL_REQUIRED";
+    evaluationRunId: string | null;
+    reviewRequestId: string | null;
+    pollUrl: string | null;
+    sessionId: string | null;
+    violations: Violation[];
+}
+interface Violation {
+    id: string;
+    ruleId: string;
+    ruleName: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL" | null;
+    resolvedAction: "BLOCK" | "APPROVAL_REQUIRED" | "WARN" | "LOG" | null;
+    explanation: string | null;
+    field: string | null;
+    snippet: string | null;
+}
+interface CreateSessionParams {
+    entityId?: string;
+    externalSessionId?: string;
+    expiresAt?: string;
+    metadata?: Record<string, any>;
+}
+interface Session {
+    id: string;
+    status: "ACTIVE" | "COMPLETED" | "EXPIRED" | "TERMINATED";
+    entityId: string | null;
+    externalSessionId: string | null;
+    startedAt: string;
+    expiresAt: string | null;
+    metadata: Record<string, any> | null;
+}
+interface EndSessionParams {
+    status?: "COMPLETED" | "TERMINATED";
+}
+interface EndSessionResponse {
+    id: string;
+    status: string;
+    endedAt: string;
+    actionCount: number;
+    dataTags: string[];
+    toolsUsed: string[];
+}
+interface ReviewRequest {
+    id: string;
+    status: "PENDING" | "APPROVED" | "REJECTED" | "EXPIRED" | "CANCELLED";
+    decidedAt: string | null;
+    decidedByUserId: string | null;
+    decisionComment: string | null;
+    expiresAt: string | null;
+    correlationId: string | null;
+    createdAt: string;
+}
+
+declare class ReviewsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    get(reviewId: string): Promise<ReviewRequest>;
+    getByCorrelation(correlationId: string): Promise<ReviewRequest>;
+}
+
+declare class SessionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params?: CreateSessionParams): Promise<Session>;
+    end(sessionId: string, params?: EndSessionParams): Promise<EndSessionResponse>;
+}
+
+declare class Aguardic {
+    readonly sessions: SessionsResource;
+    readonly reviews: ReviewsResource;
+    private readonly evaluateResource;
+    constructor(apiKeyOrOptions: string | AguardicOptions);
+    evaluate(params: EvaluateParams): Promise<EvaluateResponse>;
+}
+
+declare class AguardicError extends Error {
+    readonly statusCode: number;
+    readonly errors: Array<{
+        message: string;
+    }>;
+    constructor(statusCode: number, errors: Array<{
+        message: string;
+    }>, message?: string);
+}
+declare class ValidationError extends AguardicError {
+    constructor(errors: Array<{
+        message: string;
+    }>);
+}
+declare class AuthenticationError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class ForbiddenError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class NotFoundError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class RateLimitError extends AguardicError {
+    constructor(errors?: Array<{
+        message: string;
+    }>);
+}
+declare class ServerError extends AguardicError {
+    constructor(statusCode?: number, errors?: Array<{
+        message: string;
+    }>);
+}
+
+export { Aguardic, AguardicError, type AguardicOptions, AuthenticationError, type CreateSessionParams, type EndSessionParams, type EndSessionResponse, type EvaluateParams, type EvaluateResponse, ForbiddenError, NotFoundError, RateLimitError, type ReviewRequest, ServerError, type Session, ValidationError, type Violation, Aguardic as default };

package/dist/index.js

@@ -0,0 +1,241 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Aguardic: () => Aguardic,
+  AguardicError: () => AguardicError,
+  AuthenticationError: () => AuthenticationError,
+  ForbiddenError: () => ForbiddenError,
+  NotFoundError: () => NotFoundError,
+  RateLimitError: () => RateLimitError,
+  ServerError: () => ServerError,
+  ValidationError: () => ValidationError,
+  default: () => Aguardic
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var AguardicError = class extends Error {
+  statusCode;
+  errors;
+  constructor(statusCode, errors, message) {
+    const msg = message || errors.map((e) => e.message).join(", ") || "Unknown error";
+    super(msg);
+    this.name = "AguardicError";
+    this.statusCode = statusCode;
+    this.errors = errors;
+  }
+};
+var ValidationError = class extends AguardicError {
+  constructor(errors) {
+    super(400, errors);
+    this.name = "ValidationError";
+  }
+};
+var AuthenticationError = class extends AguardicError {
+  constructor(errors = [{ message: "Unauthorized" }]) {
+    super(401, errors);
+    this.name = "AuthenticationError";
+  }
+};
+var ForbiddenError = class extends AguardicError {
+  constructor(errors = [{ message: "Forbidden" }]) {
+    super(403, errors);
+    this.name = "ForbiddenError";
+  }
+};
+var NotFoundError = class extends AguardicError {
+  constructor(errors = [{ message: "Not found" }]) {
+    super(404, errors);
+    this.name = "NotFoundError";
+  }
+};
+var RateLimitError = class extends AguardicError {
+  constructor(errors = [{ message: "Rate limit exceeded" }]) {
+    super(429, errors);
+    this.name = "RateLimitError";
+  }
+};
+var ServerError = class extends AguardicError {
+  constructor(statusCode = 500, errors = [{ message: "Internal server error" }]) {
+    super(statusCode, errors);
+    this.name = "ServerError";
+  }
+};
+
+// src/http.ts
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.timeout = options.timeout;
+  }
+  async get(path) {
+    return this.request("GET", path);
+  }
+  async post(path, body) {
+    return this.request("POST", path, body);
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const headers = {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json"
+      };
+      const init = {
+        method,
+        headers,
+        signal: controller.signal
+      };
+      if (body !== void 0) {
+        init.body = JSON.stringify(body);
+      }
+      const response = await fetch(url, init);
+      const json = await response.json();
+      if (!response.ok) {
+        this.throwError(response.status, json);
+      }
+      return json.data;
+    } catch (error) {
+      if (error instanceof AguardicError) throw error;
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new AguardicError(0, [
+          { message: `Request timed out after ${this.timeout}ms` }
+        ]);
+      }
+      throw new AguardicError(0, [
+        {
+          message: error instanceof Error ? error.message : "Unknown network error"
+        }
+      ]);
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  throwError(statusCode, body) {
+    const errors = body?.errors ?? body?.message ? [{ message: body.message }] : [{ message: `Request failed with status ${statusCode}` }];
+    switch (statusCode) {
+      case 400:
+        throw new ValidationError(errors);
+      case 401:
+        throw new AuthenticationError(errors);
+      case 403:
+        throw new ForbiddenError(errors);
+      case 404:
+        throw new NotFoundError(errors);
+      case 429:
+        throw new RateLimitError(errors);
+      default:
+        if (statusCode >= 500) {
+          throw new ServerError(statusCode, errors);
+        }
+        throw new AguardicError(statusCode, errors);
+    }
+  }
+};
+
+// src/resources/evaluate.ts
+var EvaluateResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // Evaluate content against bound policies
+  async evaluate(params) {
+    return this.http.post("/evaluate", params);
+  }
+};
+
+// src/resources/reviews.ts
+var ReviewsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // Get a review request by ID
+  async get(reviewId) {
+    return this.http.get(`/reviews/${reviewId}`);
+  }
+  // Get a review request by correlation ID
+  async getByCorrelation(correlationId) {
+    return this.http.get(
+      `/reviews/by-correlation/${correlationId}`
+    );
+  }
+};
+
+// src/resources/sessions.ts
+var SessionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // Create a new evaluation session
+  async create(params = {}) {
+    return this.http.post("/evaluation-sessions", params);
+  }
+  // End an active session
+  async end(sessionId, params = {}) {
+    return this.http.post(
+      `/evaluation-sessions/${sessionId}/end`,
+      params
+    );
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.aguardic.com/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var Aguardic = class {
+  sessions;
+  reviews;
+  evaluateResource;
+  constructor(apiKeyOrOptions) {
+    const options = typeof apiKeyOrOptions === "string" ? { apiKey: apiKeyOrOptions } : apiKeyOrOptions;
+    const http = new HttpClient({
+      apiKey: options.apiKey,
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+      timeout: options.timeout ?? DEFAULT_TIMEOUT
+    });
+    this.evaluateResource = new EvaluateResource(http);
+    this.sessions = new SessionsResource(http);
+    this.reviews = new ReviewsResource(http);
+  }
+  // Evaluate content against bound policies
+  async evaluate(params) {
+    return this.evaluateResource.evaluate(params);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Aguardic,
+  AguardicError,
+  AuthenticationError,
+  ForbiddenError,
+  NotFoundError,
+  RateLimitError,
+  ServerError,
+  ValidationError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/resources/evaluate.ts","../src/resources/reviews.ts","../src/resources/sessions.ts","../src/client.ts"],"sourcesContent":["export { Aguardic } from \"./client\";\nexport type {\n  AguardicOptions,\n  CreateSessionParams,\n  EndSessionParams,\n  EndSessionResponse,\n  EvaluateParams,\n  EvaluateResponse,\n  ReviewRequest,\n  Session,\n  Violation,\n} from \"./types\";\nexport {\n  AguardicError,\n  AuthenticationError,\n  ForbiddenError,\n  NotFoundError,\n  RateLimitError,\n  ServerError,\n  ValidationError,\n} from \"./errors\";\n\n// Default export for convenience: import Aguardic from '@aguardic/sdk'\nexport { Aguardic as default } from \"./client\";\n","export class AguardicError extends Error {\n  readonly statusCode: number;\n  readonly errors: Array<{ message: string }>;\n\n  constructor(\n    statusCode: number,\n    errors: Array<{ message: string }>,\n    message?: string,\n  ) {\n    const msg =\n      message || errors.map((e) => e.message).join(\", \") || \"Unknown error\";\n    super(msg);\n    this.name = \"AguardicError\";\n    this.statusCode = statusCode;\n    this.errors = errors;\n  }\n}\n\n// 400\nexport class ValidationError extends AguardicError {\n  constructor(errors: Array<{ message: string }>) {\n    super(400, errors);\n    this.name = \"ValidationError\";\n  }\n}\n\n// 401\nexport class AuthenticationError extends AguardicError {\n  constructor(errors: Array<{ message: string }> = [{ message: \"Unauthorized\" }]) {\n    super(401, errors);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n// 403\nexport class ForbiddenError extends AguardicError {\n  constructor(errors: Array<{ message: string }> = [{ message: \"Forbidden\" }]) {\n    super(403, errors);\n    this.name = \"ForbiddenError\";\n  }\n}\n\n// 404\nexport class NotFoundError extends AguardicError {\n  constructor(errors: Array<{ message: string }> = [{ message: \"Not found\" }]) {\n    super(404, errors);\n    this.name = \"NotFoundError\";\n  }\n}\n\n// 429\nexport class RateLimitError extends AguardicError {\n  constructor(\n    errors: Array<{ message: string }> = [{ message: \"Rate limit exceeded\" }],\n  ) {\n    super(429, errors);\n    this.name = \"RateLimitError\";\n  }\n}\n\n// 500+\nexport class ServerError extends AguardicError {\n  constructor(\n    statusCode: number = 500,\n    errors: Array<{ message: string }> = [{ message: \"Internal server error\" }],\n  ) {\n    super(statusCode, errors);\n    this.name = \"ServerError\";\n  }\n}\n","import {\n  AguardicError,\n  AuthenticationError,\n  ForbiddenError,\n  NotFoundError,\n  RateLimitError,\n  ServerError,\n  ValidationError,\n} from \"./errors\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  timeout: number;\n}\n\n// Internal HTTP client — unwraps { success, statusCode, data } response wrapper\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.timeout = options.timeout;\n  }\n\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    return this.request<T>(\"POST\", path, body);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const headers: Record<string, string> = {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n      };\n\n      const init: RequestInit = {\n        method,\n        headers,\n        signal: controller.signal,\n      };\n\n      if (body !== undefined) {\n        init.body = JSON.stringify(body);\n      }\n\n      const response = await fetch(url, init);\n      const json = await response.json();\n\n      if (!response.ok) {\n        this.throwError(response.status, json);\n      }\n\n      // Unwrap { success, statusCode, data } wrapper\n      return json.data as T;\n    } catch (error: unknown) {\n      if (error instanceof AguardicError) throw error;\n\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new AguardicError(0, [\n          { message: `Request timed out after ${this.timeout}ms` },\n        ]);\n      }\n\n      throw new AguardicError(0, [\n        {\n          message:\n            error instanceof Error ? error.message : \"Unknown network error\",\n        },\n      ]);\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private throwError(statusCode: number, body: any): never {\n    const errors: Array<{ message: string }> = body?.errors ??\n      body?.message\n        ? [{ message: body.message }]\n        : [{ message: `Request failed with status ${statusCode}` }];\n\n    switch (statusCode) {\n      case 400:\n        throw new ValidationError(errors);\n      case 401:\n        throw new AuthenticationError(errors);\n      case 403:\n        throw new ForbiddenError(errors);\n      case 404:\n        throw new NotFoundError(errors);\n      case 429:\n        throw new RateLimitError(errors);\n      default:\n        if (statusCode >= 500) {\n          throw new ServerError(statusCode, errors);\n        }\n        throw new AguardicError(statusCode, errors);\n    }\n  }\n}\n","import type { HttpClient } from \"../http\";\nimport type { EvaluateParams, EvaluateResponse } from \"../types\";\n\nexport class EvaluateResource {\n  constructor(private readonly http: HttpClient) {}\n\n  // Evaluate content against bound policies\n  async evaluate(params: EvaluateParams): Promise<EvaluateResponse> {\n    return this.http.post<EvaluateResponse>(\"/evaluate\", params);\n  }\n}\n","import type { HttpClient } from \"../http\";\nimport type { ReviewRequest } from \"../types\";\n\nexport class ReviewsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  // Get a review request by ID\n  async get(reviewId: string): Promise<ReviewRequest> {\n    return this.http.get<ReviewRequest>(`/reviews/${reviewId}`);\n  }\n\n  // Get a review request by correlation ID\n  async getByCorrelation(correlationId: string): Promise<ReviewRequest> {\n    return this.http.get<ReviewRequest>(\n      `/reviews/by-correlation/${correlationId}`,\n    );\n  }\n}\n","import type { HttpClient } from \"../http\";\nimport type {\n  CreateSessionParams,\n  EndSessionParams,\n  EndSessionResponse,\n  Session,\n} from \"../types\";\n\nexport class SessionsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  // Create a new evaluation session\n  async create(params: CreateSessionParams = {}): Promise<Session> {\n    return this.http.post<Session>(\"/evaluation-sessions\", params);\n  }\n\n  // End an active session\n  async end(\n    sessionId: string,\n    params: EndSessionParams = {},\n  ): Promise<EndSessionResponse> {\n    return this.http.post<EndSessionResponse>(\n      `/evaluation-sessions/${sessionId}/end`,\n      params,\n    );\n  }\n}\n","import { HttpClient } from \"./http\";\nimport { EvaluateResource } from \"./resources/evaluate\";\nimport { ReviewsResource } from \"./resources/reviews\";\nimport { SessionsResource } from \"./resources/sessions\";\nimport type { AguardicOptions, EvaluateParams, EvaluateResponse } from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://api.aguardic.com/v1\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class Aguardic {\n  readonly sessions: SessionsResource;\n  readonly reviews: ReviewsResource;\n\n  private readonly evaluateResource: EvaluateResource;\n\n  constructor(apiKeyOrOptions: string | AguardicOptions) {\n    const options =\n      typeof apiKeyOrOptions === \"string\"\n        ? { apiKey: apiKeyOrOptions }\n        : apiKeyOrOptions;\n\n    const http = new HttpClient({\n      apiKey: options.apiKey,\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      timeout: options.timeout ?? DEFAULT_TIMEOUT,\n    });\n\n    this.evaluateResource = new EvaluateResource(http);\n    this.sessions = new SessionsResource(http);\n    this.reviews = new ReviewsResource(http);\n  }\n\n  // Evaluate content against bound policies\n  async evaluate(params: EvaluateParams): Promise<EvaluateResponse> {\n    return this.evaluateResource.evaluate(params);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,207 @@
+// src/errors.ts
+var AguardicError = class extends Error {
+  statusCode;
+  errors;
+  constructor(statusCode, errors, message) {
+    const msg = message || errors.map((e) => e.message).join(", ") || "Unknown error";
+    super(msg);
+    this.name = "AguardicError";
+    this.statusCode = statusCode;
+    this.errors = errors;
+  }
+};
+var ValidationError = class extends AguardicError {
+  constructor(errors) {
+    super(400, errors);
+    this.name = "ValidationError";
+  }
+};
+var AuthenticationError = class extends AguardicError {
+  constructor(errors = [{ message: "Unauthorized" }]) {
+    super(401, errors);
+    this.name = "AuthenticationError";
+  }
+};
+var ForbiddenError = class extends AguardicError {
+  constructor(errors = [{ message: "Forbidden" }]) {
+    super(403, errors);
+    this.name = "ForbiddenError";
+  }
+};
+var NotFoundError = class extends AguardicError {
+  constructor(errors = [{ message: "Not found" }]) {
+    super(404, errors);
+    this.name = "NotFoundError";
+  }
+};
+var RateLimitError = class extends AguardicError {
+  constructor(errors = [{ message: "Rate limit exceeded" }]) {
+    super(429, errors);
+    this.name = "RateLimitError";
+  }
+};
+var ServerError = class extends AguardicError {
+  constructor(statusCode = 500, errors = [{ message: "Internal server error" }]) {
+    super(statusCode, errors);
+    this.name = "ServerError";
+  }
+};
+
+// src/http.ts
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.timeout = options.timeout;
+  }
+  async get(path) {
+    return this.request("GET", path);
+  }
+  async post(path, body) {
+    return this.request("POST", path, body);
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const headers = {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json"
+      };
+      const init = {
+        method,
+        headers,
+        signal: controller.signal
+      };
+      if (body !== void 0) {
+        init.body = JSON.stringify(body);
+      }
+      const response = await fetch(url, init);
+      const json = await response.json();
+      if (!response.ok) {
+        this.throwError(response.status, json);
+      }
+      return json.data;
+    } catch (error) {
+      if (error instanceof AguardicError) throw error;
+      if (error instanceof DOMException && error.name === "AbortError") {
+        throw new AguardicError(0, [
+          { message: `Request timed out after ${this.timeout}ms` }
+        ]);
+      }
+      throw new AguardicError(0, [
+        {
+          message: error instanceof Error ? error.message : "Unknown network error"
+        }
+      ]);
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  throwError(statusCode, body) {
+    const errors = body?.errors ?? body?.message ? [{ message: body.message }] : [{ message: `Request failed with status ${statusCode}` }];
+    switch (statusCode) {
+      case 400:
+        throw new ValidationError(errors);
+      case 401:
+        throw new AuthenticationError(errors);
+      case 403:
+        throw new ForbiddenError(errors);
+      case 404:
+        throw new NotFoundError(errors);
+      case 429:
+        throw new RateLimitError(errors);
+      default:
+        if (statusCode >= 500) {
+          throw new ServerError(statusCode, errors);
+        }
+        throw new AguardicError(statusCode, errors);
+    }
+  }
+};
+
+// src/resources/evaluate.ts
+var EvaluateResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // Evaluate content against bound policies
+  async evaluate(params) {
+    return this.http.post("/evaluate", params);
+  }
+};
+
+// src/resources/reviews.ts
+var ReviewsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // Get a review request by ID
+  async get(reviewId) {
+    return this.http.get(`/reviews/${reviewId}`);
+  }
+  // Get a review request by correlation ID
+  async getByCorrelation(correlationId) {
+    return this.http.get(
+      `/reviews/by-correlation/${correlationId}`
+    );
+  }
+};
+
+// src/resources/sessions.ts
+var SessionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // Create a new evaluation session
+  async create(params = {}) {
+    return this.http.post("/evaluation-sessions", params);
+  }
+  // End an active session
+  async end(sessionId, params = {}) {
+    return this.http.post(
+      `/evaluation-sessions/${sessionId}/end`,
+      params
+    );
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.aguardic.com/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var Aguardic = class {
+  sessions;
+  reviews;
+  evaluateResource;
+  constructor(apiKeyOrOptions) {
+    const options = typeof apiKeyOrOptions === "string" ? { apiKey: apiKeyOrOptions } : apiKeyOrOptions;
+    const http = new HttpClient({
+      apiKey: options.apiKey,
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+      timeout: options.timeout ?? DEFAULT_TIMEOUT
+    });
+    this.evaluateResource = new EvaluateResource(http);
+    this.sessions = new SessionsResource(http);
+    this.reviews = new ReviewsResource(http);
+  }
+  // Evaluate content against bound policies
+  async evaluate(params) {
+    return this.evaluateResource.evaluate(params);
+  }
+};
+export {
+  Aguardic,
+  AguardicError,
+  AuthenticationError,
+  ForbiddenError,
+  NotFoundError,
+  RateLimitError,
+  ServerError,
+  ValidationError,
+  Aguardic as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/evaluate.ts","../src/resources/reviews.ts","../src/resources/sessions.ts","../src/client.ts"],"sourcesContent":["export class AguardicError extends Error {\n  readonly statusCode: number;\n  readonly errors: Array<{ message: string }>;\n\n  constructor(\n    statusCode: number,\n    errors: Array<{ message: string }>,\n    message?: string,\n  ) {\n    const msg =\n      message || errors.map((e) => e.message).join(\", \") || \"Unknown error\";\n    super(msg);\n    this.name = \"AguardicError\";\n    this.statusCode = statusCode;\n    this.errors = errors;\n  }\n}\n\n// 400\nexport class ValidationError extends AguardicError {\n  constructor(errors: Array<{ message: string }>) {\n    super(400, errors);\n    this.name = \"ValidationError\";\n  }\n}\n\n// 401\nexport class AuthenticationError extends AguardicError {\n  constructor(errors: Array<{ message: string }> = [{ message: \"Unauthorized\" }]) {\n    super(401, errors);\n    this.name = \"AuthenticationError\";\n  }\n}\n\n// 403\nexport class ForbiddenError extends AguardicError {\n  constructor(errors: Array<{ message: string }> = [{ message: \"Forbidden\" }]) {\n    super(403, errors);\n    this.name = \"ForbiddenError\";\n  }\n}\n\n// 404\nexport class NotFoundError extends AguardicError {\n  constructor(errors: Array<{ message: string }> = [{ message: \"Not found\" }]) {\n    super(404, errors);\n    this.name = \"NotFoundError\";\n  }\n}\n\n// 429\nexport class RateLimitError extends AguardicError {\n  constructor(\n    errors: Array<{ message: string }> = [{ message: \"Rate limit exceeded\" }],\n  ) {\n    super(429, errors);\n    this.name = \"RateLimitError\";\n  }\n}\n\n// 500+\nexport class ServerError extends AguardicError {\n  constructor(\n    statusCode: number = 500,\n    errors: Array<{ message: string }> = [{ message: \"Internal server error\" }],\n  ) {\n    super(statusCode, errors);\n    this.name = \"ServerError\";\n  }\n}\n","import {\n  AguardicError,\n  AuthenticationError,\n  ForbiddenError,\n  NotFoundError,\n  RateLimitError,\n  ServerError,\n  ValidationError,\n} from \"./errors\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  timeout: number;\n}\n\n// Internal HTTP client — unwraps { success, statusCode, data } response wrapper\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.timeout = options.timeout;\n  }\n\n  async get<T>(path: string): Promise<T> {\n    return this.request<T>(\"GET\", path);\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    return this.request<T>(\"POST\", path, body);\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const headers: Record<string, string> = {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n      };\n\n      const init: RequestInit = {\n        method,\n        headers,\n        signal: controller.signal,\n      };\n\n      if (body !== undefined) {\n        init.body = JSON.stringify(body);\n      }\n\n      const response = await fetch(url, init);\n      const json = await response.json();\n\n      if (!response.ok) {\n        this.throwError(response.status, json);\n      }\n\n      // Unwrap { success, statusCode, data } wrapper\n      return json.data as T;\n    } catch (error: unknown) {\n      if (error instanceof AguardicError) throw error;\n\n      if (error instanceof DOMException && error.name === \"AbortError\") {\n        throw new AguardicError(0, [\n          { message: `Request timed out after ${this.timeout}ms` },\n        ]);\n      }\n\n      throw new AguardicError(0, [\n        {\n          message:\n            error instanceof Error ? error.message : \"Unknown network error\",\n        },\n      ]);\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private throwError(statusCode: number, body: any): never {\n    const errors: Array<{ message: string }> = body?.errors ??\n      body?.message\n        ? [{ message: body.message }]\n        : [{ message: `Request failed with status ${statusCode}` }];\n\n    switch (statusCode) {\n      case 400:\n        throw new ValidationError(errors);\n      case 401:\n        throw new AuthenticationError(errors);\n      case 403:\n        throw new ForbiddenError(errors);\n      case 404:\n        throw new NotFoundError(errors);\n      case 429:\n        throw new RateLimitError(errors);\n      default:\n        if (statusCode >= 500) {\n          throw new ServerError(statusCode, errors);\n        }\n        throw new AguardicError(statusCode, errors);\n    }\n  }\n}\n","import type { HttpClient } from \"../http\";\nimport type { EvaluateParams, EvaluateResponse } from \"../types\";\n\nexport class EvaluateResource {\n  constructor(private readonly http: HttpClient) {}\n\n  // Evaluate content against bound policies\n  async evaluate(params: EvaluateParams): Promise<EvaluateResponse> {\n    return this.http.post<EvaluateResponse>(\"/evaluate\", params);\n  }\n}\n","import type { HttpClient } from \"../http\";\nimport type { ReviewRequest } from \"../types\";\n\nexport class ReviewsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  // Get a review request by ID\n  async get(reviewId: string): Promise<ReviewRequest> {\n    return this.http.get<ReviewRequest>(`/reviews/${reviewId}`);\n  }\n\n  // Get a review request by correlation ID\n  async getByCorrelation(correlationId: string): Promise<ReviewRequest> {\n    return this.http.get<ReviewRequest>(\n      `/reviews/by-correlation/${correlationId}`,\n    );\n  }\n}\n","import type { HttpClient } from \"../http\";\nimport type {\n  CreateSessionParams,\n  EndSessionParams,\n  EndSessionResponse,\n  Session,\n} from \"../types\";\n\nexport class SessionsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  // Create a new evaluation session\n  async create(params: CreateSessionParams = {}): Promise<Session> {\n    return this.http.post<Session>(\"/evaluation-sessions\", params);\n  }\n\n  // End an active session\n  async end(\n    sessionId: string,\n    params: EndSessionParams = {},\n  ): Promise<EndSessionResponse> {\n    return this.http.post<EndSessionResponse>(\n      `/evaluation-sessions/${sessionId}/end`,\n      params,\n    );\n  }\n}\n","import { HttpClient } from \"./http\";\nimport { EvaluateResource } from \"./resources/evaluate\";\nimport { ReviewsResource } from \"./resources/reviews\";\nimport { SessionsResource } from \"./resources/sessions\";\nimport type { AguardicOptions, EvaluateParams, EvaluateResponse } from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://api.aguardic.com/v1\";\nconst DEFAULT_TIMEOUT = 30_000;\n\nexport class Aguardic {\n  readonly sessions: SessionsResource;\n  readonly reviews: ReviewsResource;\n\n  private readonly evaluateResource: EvaluateResource;\n\n  constructor(apiKeyOrOptions: string | AguardicOptions) {\n    const options =\n      typeof apiKeyOrOptions === \"string\"\n        ? { apiKey: apiKeyOrOptions }\n        : apiKeyOrOptions;\n\n    const http = new HttpClient({\n      apiKey: options.apiKey,\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      timeout: options.timeout ?? DEFAULT_TIMEOUT,\n    });\n\n    this.evaluateResource = new EvaluateResource(http);\n    this.sessions = new SessionsResource(http);\n    this.reviews = new ReviewsResource(http);\n  }\n\n  // Evaluate content against bound policies\n  async evaluate(params: EvaluateParams): Promise<EvaluateResponse> {\n    return this.evaluateResource.evaluate(params);\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@aguardic/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the Aguardic governance API",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}