@barndoor-ai/sdk 0.2.0 → 0.2.2

package/dist/exceptions/index.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Exception classes for the Barndoor SDK.
+ *
+ * This module provides a complete hierarchy of error classes that mirror
+ * the Python SDK exceptions exactly, ensuring API compatibility.
+ */
+/**
+ * Base exception for all Barndoor SDK errors.
+ */
+export declare class BarndoorError extends Error {
+    /**
+     * Create a new BarndoorError.
+     * @param message - Error message
+     */
+    constructor(message: string);
+}
+/**
+ * Raised when authentication fails.
+ */
+export declare class AuthenticationError extends BarndoorError {
+    /** Optional error code for specific authentication failures */
+    readonly errorCode: string | null;
+    /**
+     * Create a new AuthenticationError.
+     * @param message - Error message
+     * @param errorCode - Optional error code
+     */
+    constructor(message: string, errorCode?: string | null);
+}
+/**
+ * Raised when token operations fail.
+ */
+export declare class TokenError extends AuthenticationError {
+    /** Optional help text for resolving the error */
+    readonly helpText: string | null;
+    /**
+     * Create a new TokenError.
+     * @param message - Error message
+     * @param helpText - Optional help text
+     */
+    constructor(message: string, helpText?: string | null);
+}
+/**
+ * Raised when a token has expired.
+ */
+export declare class TokenExpiredError extends TokenError {
+}
+/**
+ * Raised when token validation fails.
+ */
+export declare class TokenValidationError extends TokenError {
+}
+/**
+ * Raised when unable to connect to the Barndoor API.
+ */
+export declare class ConnectionError extends BarndoorError {
+    /** The URL that failed to connect */
+    readonly url: string;
+    /** The original error that caused the connection failure */
+    readonly originalError: Error;
+    /**
+     * Create a new ConnectionError.
+     * @param url - The URL that failed to connect
+     * @param originalError - The original error that caused the failure
+     */
+    constructor(url: string, originalError: Error);
+}
+/**
+ * Raised for HTTP error responses.
+ */
+export declare class HTTPError extends BarndoorError {
+    /** HTTP status code */
+    readonly statusCode: number;
+    /** Raw response body */
+    readonly responseBody: string | null;
+    /**
+     * Create a new HTTPError.
+     * @param statusCode - HTTP status code
+     * @param message - Error message
+     * @param responseBody - Raw response body
+     */
+    constructor(statusCode: number, message: string, responseBody?: string | null);
+    /**
+     * Create a user-friendly error message based on HTTP status code.
+     * @private
+     */
+    private static _createUserFriendlyMessage;
+}
+/**
+ * Raised when a requested server is not found.
+ */
+export declare class ServerNotFoundError extends BarndoorError {
+    /** The server identifier that was not found */
+    readonly serverIdentifier: string;
+    /** List of available servers, if provided */
+    readonly availableServers: string[] | null;
+    /**
+     * Create a new ServerNotFoundError.
+     * @param serverIdentifier - The server identifier that was not found
+     * @param availableServers - Optional list of available servers
+     */
+    constructor(serverIdentifier: string, availableServers?: string[] | null);
+}
+/**
+ * Raised when OAuth authentication fails.
+ */
+export declare class OAuthError extends AuthenticationError {
+}
+/**
+ * Raised when there's an issue with SDK configuration.
+ */
+export declare class ConfigurationError extends BarndoorError {
+}
+/**
+ * Raised when an operation times out.
+ */
+export declare class TimeoutError extends BarndoorError {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/exceptions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exceptions/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC;;;OAGG;gBACS,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,+DAA+D;IAC/D,SAAgB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW;CAK7D;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;IACjD,iDAAiD;IACjD,SAAgB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW;CAY5D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;CAAG;AAEpD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;CAAG;AAEvD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,qCAAqC;IACrC,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,SAAgB,aAAa,EAAE,KAAK,CAAC;IAErC;;;;OAIG;gBACS,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK;CAkB9C;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC1C,uBAAuB;IACvB,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,wBAAwB;IACxB,SAAgB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C;;;;;OAKG;gBACS,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,GAAG,IAAW;IAQnF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;CAuB1C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,+CAA+C;IAC/C,SAAgB,gBAAgB,EAAE,MAAM,CAAC;IACzC,6CAA6C;IAC7C,SAAgB,gBAAgB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAElD;;;;OAIG;gBACS,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAM,EAAE,GAAG,IAAW;CAY/E;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;CAAG;AAEtD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;CAAG;AAExD;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;CAAG"}

package/dist/http/client.d.ts

@@ -0,0 +1,82 @@
+/**
+ * HTTP client with retry logic and error handling.
+ *
+ * This module provides a robust HTTP client that mirrors the Python SDK's
+ * HTTP client functionality, including automatic retries, timeout handling,
+ * and proper error conversion.
+ */
+/**
+ * HTTP request options interface.
+ */
+export interface HTTPRequestOptions {
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** JSON body to send */
+    json?: unknown;
+    /** Query parameters */
+    params?: Record<string, string | number | boolean>;
+    /** Additional fetch options */
+    [key: string]: unknown;
+}
+/**
+ * Timeout configuration for HTTP requests.
+ */
+export declare class TimeoutConfig {
+    /** Read timeout in milliseconds */
+    readonly read: number;
+    /** Connect timeout in milliseconds */
+    readonly connect: number;
+    /**
+     * Create a new TimeoutConfig.
+     * @param read - Read timeout in seconds
+     * @param connect - Connect timeout in seconds
+     */
+    constructor(read?: number, connect?: number);
+}
+/**
+ * HTTP client with automatic retries and error handling.
+ *
+ * Provides a consistent interface for making HTTP requests with proper
+ * error handling, timeout management, and retry logic.
+ */
+export declare class HTTPClient {
+    /** Timeout configuration */
+    private readonly timeoutConfig;
+    /** Maximum number of retries */
+    private readonly maxRetries;
+    /** Whether the client has been closed */
+    closed: boolean;
+    /**
+     * Create a new HTTPClient.
+     * @param timeoutConfig - Timeout configuration
+     * @param maxRetries - Maximum number of retries
+     */
+    constructor(timeoutConfig?: TimeoutConfig, maxRetries?: number);
+    /**
+     * Make an HTTP request with retry logic.
+     * @param method - HTTP method
+     * @param url - Request URL
+     * @param options - Request options
+     * @returns Response data
+     */
+    request(method: string, url: string, options?: HTTPRequestOptions): Promise<unknown>;
+    /**
+     * Build URL with query parameters.
+     * @private
+     */
+    private _buildUrl;
+    /**
+     * Sleep for the specified number of milliseconds.
+     * @private
+     */
+    private _sleep;
+    /**
+     * Close the HTTP client and clean up resources.
+     */
+    close(): Promise<void>;
+    /**
+     * Alias for close() to match Python SDK naming.
+     */
+    aclose(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/http/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,wBAAwB;IACxB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,+BAA+B;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,mCAAmC;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC;;;;OAIG;gBACS,IAAI,SAAK,EAAE,OAAO,SAAK;CAIpC;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,yCAAyC;IAClC,MAAM,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;gBACS,aAAa,gBAAsB,EAAE,UAAU,SAAI;IAM/D;;;;;;OAMG;IACU,OAAO,CAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC;IAuJnB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAejB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAGrC"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Barndoor SDK - JavaScript client for the Barndoor Platform API.
+ *
+ * The Barndoor SDK provides a simple, async interface for interacting with
+ * the Barndoor platform, including:
+ *
+ * - User authentication and token management
+ * - MCP server discovery and connection
+ * - OAuth flow handling for third-party integrations
+ * - Agent credential exchange
+ *
+ * Quick Start
+ * -----------
+ * ```javascript
+ * import { BarndoorSDK } from '@barndoor-ai/sdk';
+ *
+ * const sdk = new BarndoorSDK('https://api.barndoor.host', {
+ *   token: 'your_token'
+ * });
+ * const servers = await sdk.listServers();
+ * ```
+ *
+ * For interactive login:
+ * ```javascript
+ * import { loginInteractive } from '@barndoor-ai/sdk';
+ *
+ * const sdk = await loginInteractive();
+ * ```
+ */
+export { BarndoorSDK } from './client';
+export { BarndoorError, AuthenticationError, TokenError, TokenExpiredError, TokenValidationError, ConnectionError, HTTPError, ServerNotFoundError, OAuthError, ConfigurationError, TimeoutError, } from './exceptions';
+export { ServerSummary, ServerDetail, AgentToken } from './models';
+export { loginInteractive, ensureServerConnected, makeMcpConnectionParams, makeMcpClient, } from './quickstart';
+export { PKCEManager, startLocalCallbackServer, loadUserToken, saveUserToken, clearCachedToken, verifyJWTLocal, JWTVerificationResult, isTokenActive, isTokenActiveWithRefresh, validateToken, TokenManager, setTokenLogger, } from './auth';
+export { BarndoorConfig, getStaticConfig, getDynamicConfig, checkTokenOrganization, hasOrganizationInfo, isBrowser, isNode, } from './config';
+export { setLogger, getLogger, createScopedLogger, debug, info, warn, error } from './logging';
+export type { Logger } from './logging';
+export { version } from './version';
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,MAAM,GACP,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}