@cobbl-ai/sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,236 @@
+'use strict';
+
+// src/errors.ts
+var CobblError = class _CobblError extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.name = "CobblError";
+    this.code = code;
+    this.details = details;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _CobblError);
+    }
+  }
+  /**
+   * Check if an error is a CobblError
+   */
+  static isCobblError(error) {
+    return error instanceof _CobblError;
+  }
+  /**
+   * Convert error to JSON-serializable object
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      details: this.details
+    };
+  }
+};
+
+// src/client.ts
+var REQUEST_TIMEOUT_MS = 3e4;
+var CobblClient = class {
+  /**
+   * Initialize the Cobbl SDK client
+   *
+   * @param config - Configuration object
+   * @param config.apiKey - Your Cobbl API key
+   *
+   * @example
+   * ```typescript
+   * const client = new CobblClient({
+   *   apiKey: process.env.COBBL_API_KEY
+   * })
+   * ```
+   */
+  constructor(config) {
+    if (!config.apiKey || config.apiKey.trim().length === 0) {
+      throw new CobblError("API key is required", "INVALID_CONFIG");
+    }
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Execute a prompt with the given input variables
+   *
+   * @param promptSlug - The unique slug identifier for the prompt
+   * @param input - Input variables to populate the prompt template
+   * @returns Promise containing the prompt execution results
+   *
+   * @throws {CobblError} When the request fails or API returns an error
+   *
+   * @example
+   * ```typescript
+   * const result = await client.runPrompt('sales_summary', {
+   *   topic: 'Q4 Results',
+   *   tone: 'friendly',
+   *   audience: 'investors'
+   * })
+   *
+   * console.log(result.output) // AI-generated response
+   * console.log(result.runId) // Save this to link feedback later
+   * ```
+   */
+  async runPrompt(promptSlug, input) {
+    if (!promptSlug || promptSlug.trim().length === 0) {
+      throw new CobblError("promptSlug is required", "INVALID_REQUEST");
+    }
+    try {
+      const response = await this.makeRequest("/prompt/run", {
+        method: "POST",
+        body: JSON.stringify({
+          promptSlug: promptSlug.trim(),
+          input
+        })
+      });
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return {
+        runId: data.runId,
+        output: data.output,
+        tokenUsage: data.tokenUsage,
+        renderedPrompt: data.renderedPrompt,
+        promptVersion: data.promptVersion
+      };
+    } catch (error) {
+      if (error instanceof CobblError) {
+        throw error;
+      }
+      throw new CobblError(
+        `Failed to run prompt: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "NETWORK_ERROR"
+      );
+    }
+  }
+  /**
+   * Submit user feedback for a prompt run
+   *
+   * @param feedback - Feedback submission data
+   * @param feedback.runId - The run ID from a previous runPrompt call
+   * @param feedback.helpful - Whether the output was helpful ('helpful' or 'not_helpful')
+   * @param feedback.userFeedback - Detailed feedback message from the user
+   * @returns Promise containing the created feedback ID
+   *
+   * @throws {CobblError} When the request fails or API returns an error
+   *
+   * @example
+   * ```typescript
+   * await client.submitFeedback({
+   *   runId: result.runId,
+   *   helpful: 'not_helpful',
+   *   userFeedback: 'The response was too formal and lengthy'
+   * })
+   * ```
+   */
+  async submitFeedback(feedback) {
+    if (!feedback.runId || feedback.runId.trim().length === 0) {
+      throw new CobblError("runId is required", "INVALID_REQUEST");
+    }
+    if (!feedback.userFeedback || feedback.userFeedback.trim().length === 0) {
+      throw new CobblError("userFeedback is required", "INVALID_REQUEST");
+    }
+    if (!feedback.helpful || !["helpful", "not_helpful"].includes(feedback.helpful)) {
+      throw new CobblError(
+        'helpful must be either "helpful" or "not_helpful"',
+        "INVALID_REQUEST"
+      );
+    }
+    try {
+      const response = await this.makeRequest("/feedback", {
+        method: "POST",
+        body: JSON.stringify({
+          runId: feedback.runId.trim(),
+          helpful: feedback.helpful,
+          userFeedback: feedback.userFeedback.trim()
+        })
+      });
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return {
+        feedbackId: data.feedbackId,
+        message: data.message
+      };
+    } catch (error) {
+      if (error instanceof CobblError) {
+        throw error;
+      }
+      throw new CobblError(
+        `Failed to submit feedback: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "NETWORK_ERROR"
+      );
+    }
+  }
+  /**
+   * Make an HTTP request to the Cobbl API
+   * @private
+   */
+  async makeRequest(path, options) {
+    const baseUrl = process.env.COBBL_API_URL || "https://api.cobbl.ai";
+    const url = `${baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`,
+          ...options.headers
+        },
+        signal: controller.signal
+      });
+      return response;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Handle error responses from the API
+   * @private
+   */
+  async handleErrorResponse(response) {
+    let errorData;
+    try {
+      errorData = await response.json();
+    } catch {
+      throw new CobblError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        "API_ERROR",
+        { status: response.status }
+      );
+    }
+    const message = errorData.error || errorData.message || "Unknown error";
+    const details = errorData.details;
+    switch (response.status) {
+      case 400:
+        throw new CobblError(message, "INVALID_REQUEST", details);
+      case 401:
+        throw new CobblError(message, "UNAUTHORIZED", details);
+      case 404:
+        throw new CobblError(message, "NOT_FOUND", details);
+      case 429:
+        throw new CobblError(message, "RATE_LIMIT_EXCEEDED", details);
+      case 500:
+      case 502:
+      case 503:
+      case 504:
+        throw new CobblError(message, "SERVER_ERROR", details);
+      default:
+        throw new CobblError(message, "API_ERROR", {
+          status: response.status,
+          ...details
+        });
+    }
+  }
+};
+
+exports.CobblClient = CobblClient;
+exports.CobblError = CobblError;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Error types that can be thrown by the Cobbl SDK\n */\nexport type CobblErrorCode =\n  | 'INVALID_CONFIG'\n  | 'INVALID_REQUEST'\n  | 'UNAUTHORIZED'\n  | 'NOT_FOUND'\n  | 'RATE_LIMIT_EXCEEDED'\n  | 'SERVER_ERROR'\n  | 'NETWORK_ERROR'\n  | 'API_ERROR'\n\n/**\n * Custom error class for Cobbl SDK errors\n *\n * @example\n * ```typescript\n * try {\n *   await client.runPrompt('my-prompt', { topic: 'test' })\n * } catch (error) {\n *   if (error instanceof CobblError) {\n *     console.error(`Error [${error.code}]: ${error.message}`)\n *     console.error('Details:', error.details)\n *   }\n * }\n * ```\n */\nexport class CobblError extends Error {\n  /**\n   * Error code indicating the type of error\n   */\n  public readonly code: CobblErrorCode\n\n  /**\n   * Additional details about the error (e.g., missing variables, validation issues)\n   */\n  public readonly details?: unknown\n\n  constructor(message: string, code: CobblErrorCode, details?: unknown) {\n    super(message)\n    this.name = 'CobblError'\n    this.code = code\n    this.details = details\n\n    // Maintains proper stack trace for where error was thrown (V8 only)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, CobblError)\n    }\n  }\n\n  /**\n   * Check if an error is a CobblError\n   */\n  static isCobblError(error: unknown): error is CobblError {\n    return error instanceof CobblError\n  }\n\n  /**\n   * Convert error to JSON-serializable object\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      details: this.details,\n    }\n  }\n}\n","/**\n * CobblClient - SDK for the Cobbl platform\n *\n * Provides methods to run prompts and submit feedback to the Cobbl API.\n */\n\nimport type { PromptInput, PromptVersionClient } from '@prompti/shared'\nimport type {\n  RunPromptResponse,\n  SubmitFeedbackResponse,\n  CobblConfig,\n  TokenUsage,\n  FeedbackSubmission,\n} from './types'\nimport { CobblError } from './errors'\n\nconst REQUEST_TIMEOUT_MS = 30_000\n\nexport class CobblClient {\n  private readonly apiKey: string\n\n  /**\n   * Initialize the Cobbl SDK client\n   *\n   * @param config - Configuration object\n   * @param config.apiKey - Your Cobbl API key\n   *\n   * @example\n   * ```typescript\n   * const client = new CobblClient({\n   *   apiKey: process.env.COBBL_API_KEY\n   * })\n   * ```\n   */\n  constructor(config: CobblConfig) {\n    if (!config.apiKey || config.apiKey.trim().length === 0) {\n      throw new CobblError('API key is required', 'INVALID_CONFIG')\n    }\n\n    this.apiKey = config.apiKey\n  }\n\n  /**\n   * Execute a prompt with the given input variables\n   *\n   * @param promptSlug - The unique slug identifier for the prompt\n   * @param input - Input variables to populate the prompt template\n   * @returns Promise containing the prompt execution results\n   *\n   * @throws {CobblError} When the request fails or API returns an error\n   *\n   * @example\n   * ```typescript\n   * const result = await client.runPrompt('sales_summary', {\n   *   topic: 'Q4 Results',\n   *   tone: 'friendly',\n   *   audience: 'investors'\n   * })\n   *\n   * console.log(result.output) // AI-generated response\n   * console.log(result.runId) // Save this to link feedback later\n   * ```\n   */\n  async runPrompt(\n    promptSlug: string,\n    input: PromptInput\n  ): Promise<RunPromptResponse> {\n    if (!promptSlug || promptSlug.trim().length === 0) {\n      throw new CobblError('promptSlug is required', 'INVALID_REQUEST')\n    }\n\n    try {\n      const response = await this.makeRequest('/prompt/run', {\n        method: 'POST',\n        body: JSON.stringify({\n          promptSlug: promptSlug.trim(),\n          input,\n        }),\n      })\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response)\n      }\n\n      const data = (await response.json()) as {\n        runId: string\n        output: string\n        tokenUsage: TokenUsage\n        renderedPrompt: string\n        promptVersion: PromptVersionClient\n      }\n\n      return {\n        runId: data.runId,\n        output: data.output,\n        tokenUsage: data.tokenUsage,\n        renderedPrompt: data.renderedPrompt,\n        promptVersion: data.promptVersion,\n      }\n    } catch (error) {\n      if (error instanceof CobblError) {\n        throw error\n      }\n      throw new CobblError(\n        `Failed to run prompt: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        'NETWORK_ERROR'\n      )\n    }\n  }\n\n  /**\n   * Submit user feedback for a prompt run\n   *\n   * @param feedback - Feedback submission data\n   * @param feedback.runId - The run ID from a previous runPrompt call\n   * @param feedback.helpful - Whether the output was helpful ('helpful' or 'not_helpful')\n   * @param feedback.userFeedback - Detailed feedback message from the user\n   * @returns Promise containing the created feedback ID\n   *\n   * @throws {CobblError} When the request fails or API returns an error\n   *\n   * @example\n   * ```typescript\n   * await client.submitFeedback({\n   *   runId: result.runId,\n   *   helpful: 'not_helpful',\n   *   userFeedback: 'The response was too formal and lengthy'\n   * })\n   * ```\n   */\n  async submitFeedback(\n    feedback: FeedbackSubmission\n  ): Promise<SubmitFeedbackResponse> {\n    if (!feedback.runId || feedback.runId.trim().length === 0) {\n      throw new CobblError('runId is required', 'INVALID_REQUEST')\n    }\n\n    if (!feedback.userFeedback || feedback.userFeedback.trim().length === 0) {\n      throw new CobblError('userFeedback is required', 'INVALID_REQUEST')\n    }\n\n    if (\n      !feedback.helpful ||\n      !['helpful', 'not_helpful'].includes(feedback.helpful)\n    ) {\n      throw new CobblError(\n        'helpful must be either \"helpful\" or \"not_helpful\"',\n        'INVALID_REQUEST'\n      )\n    }\n\n    try {\n      const response = await this.makeRequest('/feedback', {\n        method: 'POST',\n        body: JSON.stringify({\n          runId: feedback.runId.trim(),\n          helpful: feedback.helpful,\n          userFeedback: feedback.userFeedback.trim(),\n        }),\n      })\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response)\n      }\n\n      const data = (await response.json()) as {\n        feedbackId: string\n        message: string\n      }\n\n      return {\n        feedbackId: data.feedbackId,\n        message: data.message,\n      }\n    } catch (error) {\n      if (error instanceof CobblError) {\n        throw error\n      }\n      throw new CobblError(\n        `Failed to submit feedback: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        'NETWORK_ERROR'\n      )\n    }\n  }\n\n  /**\n   * Make an HTTP request to the Cobbl API\n   * @private\n   */\n  private async makeRequest(\n    path: string,\n    options: RequestInit\n  ): Promise<Response> {\n    const baseUrl = process.env.COBBL_API_URL || 'https://api.cobbl.ai'\n    const url = `${baseUrl}${path}`\n\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS)\n\n    try {\n      const response = await fetch(url, {\n        ...options,\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${this.apiKey}`,\n          ...options.headers,\n        },\n        signal: controller.signal,\n      })\n\n      return response\n    } finally {\n      clearTimeout(timeoutId)\n    }\n  }\n\n  /**\n   * Handle error responses from the API\n   * @private\n   */\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let errorData: any\n    try {\n      errorData = await response.json()\n    } catch {\n      throw new CobblError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        'API_ERROR',\n        { status: response.status }\n      )\n    }\n\n    const message = errorData.error || errorData.message || 'Unknown error'\n    const details = errorData.details\n\n    switch (response.status) {\n      case 400:\n        throw new CobblError(message, 'INVALID_REQUEST', details)\n      case 401:\n        throw new CobblError(message, 'UNAUTHORIZED', details)\n      case 404:\n        throw new CobblError(message, 'NOT_FOUND', details)\n      case 429:\n        throw new CobblError(message, 'RATE_LIMIT_EXCEEDED', details)\n      case 500:\n      case 502:\n      case 503:\n      case 504:\n        throw new CobblError(message, 'SERVER_ERROR', details)\n      default:\n        throw new CobblError(message, 'API_ERROR', {\n          status: response.status,\n          ...details,\n        })\n    }\n  }\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,233 @@
+// src/errors.ts
+var CobblError = class _CobblError extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.name = "CobblError";
+    this.code = code;
+    this.details = details;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _CobblError);
+    }
+  }
+  /**
+   * Check if an error is a CobblError
+   */
+  static isCobblError(error) {
+    return error instanceof _CobblError;
+  }
+  /**
+   * Convert error to JSON-serializable object
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      details: this.details
+    };
+  }
+};
+
+// src/client.ts
+var REQUEST_TIMEOUT_MS = 3e4;
+var CobblClient = class {
+  /**
+   * Initialize the Cobbl SDK client
+   *
+   * @param config - Configuration object
+   * @param config.apiKey - Your Cobbl API key
+   *
+   * @example
+   * ```typescript
+   * const client = new CobblClient({
+   *   apiKey: process.env.COBBL_API_KEY
+   * })
+   * ```
+   */
+  constructor(config) {
+    if (!config.apiKey || config.apiKey.trim().length === 0) {
+      throw new CobblError("API key is required", "INVALID_CONFIG");
+    }
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Execute a prompt with the given input variables
+   *
+   * @param promptSlug - The unique slug identifier for the prompt
+   * @param input - Input variables to populate the prompt template
+   * @returns Promise containing the prompt execution results
+   *
+   * @throws {CobblError} When the request fails or API returns an error
+   *
+   * @example
+   * ```typescript
+   * const result = await client.runPrompt('sales_summary', {
+   *   topic: 'Q4 Results',
+   *   tone: 'friendly',
+   *   audience: 'investors'
+   * })
+   *
+   * console.log(result.output) // AI-generated response
+   * console.log(result.runId) // Save this to link feedback later
+   * ```
+   */
+  async runPrompt(promptSlug, input) {
+    if (!promptSlug || promptSlug.trim().length === 0) {
+      throw new CobblError("promptSlug is required", "INVALID_REQUEST");
+    }
+    try {
+      const response = await this.makeRequest("/prompt/run", {
+        method: "POST",
+        body: JSON.stringify({
+          promptSlug: promptSlug.trim(),
+          input
+        })
+      });
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return {
+        runId: data.runId,
+        output: data.output,
+        tokenUsage: data.tokenUsage,
+        renderedPrompt: data.renderedPrompt,
+        promptVersion: data.promptVersion
+      };
+    } catch (error) {
+      if (error instanceof CobblError) {
+        throw error;
+      }
+      throw new CobblError(
+        `Failed to run prompt: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "NETWORK_ERROR"
+      );
+    }
+  }
+  /**
+   * Submit user feedback for a prompt run
+   *
+   * @param feedback - Feedback submission data
+   * @param feedback.runId - The run ID from a previous runPrompt call
+   * @param feedback.helpful - Whether the output was helpful ('helpful' or 'not_helpful')
+   * @param feedback.userFeedback - Detailed feedback message from the user
+   * @returns Promise containing the created feedback ID
+   *
+   * @throws {CobblError} When the request fails or API returns an error
+   *
+   * @example
+   * ```typescript
+   * await client.submitFeedback({
+   *   runId: result.runId,
+   *   helpful: 'not_helpful',
+   *   userFeedback: 'The response was too formal and lengthy'
+   * })
+   * ```
+   */
+  async submitFeedback(feedback) {
+    if (!feedback.runId || feedback.runId.trim().length === 0) {
+      throw new CobblError("runId is required", "INVALID_REQUEST");
+    }
+    if (!feedback.userFeedback || feedback.userFeedback.trim().length === 0) {
+      throw new CobblError("userFeedback is required", "INVALID_REQUEST");
+    }
+    if (!feedback.helpful || !["helpful", "not_helpful"].includes(feedback.helpful)) {
+      throw new CobblError(
+        'helpful must be either "helpful" or "not_helpful"',
+        "INVALID_REQUEST"
+      );
+    }
+    try {
+      const response = await this.makeRequest("/feedback", {
+        method: "POST",
+        body: JSON.stringify({
+          runId: feedback.runId.trim(),
+          helpful: feedback.helpful,
+          userFeedback: feedback.userFeedback.trim()
+        })
+      });
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return {
+        feedbackId: data.feedbackId,
+        message: data.message
+      };
+    } catch (error) {
+      if (error instanceof CobblError) {
+        throw error;
+      }
+      throw new CobblError(
+        `Failed to submit feedback: ${error instanceof Error ? error.message : "Unknown error"}`,
+        "NETWORK_ERROR"
+      );
+    }
+  }
+  /**
+   * Make an HTTP request to the Cobbl API
+   * @private
+   */
+  async makeRequest(path, options) {
+    const baseUrl = process.env.COBBL_API_URL || "https://api.cobbl.ai";
+    const url = `${baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`,
+          ...options.headers
+        },
+        signal: controller.signal
+      });
+      return response;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Handle error responses from the API
+   * @private
+   */
+  async handleErrorResponse(response) {
+    let errorData;
+    try {
+      errorData = await response.json();
+    } catch {
+      throw new CobblError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        "API_ERROR",
+        { status: response.status }
+      );
+    }
+    const message = errorData.error || errorData.message || "Unknown error";
+    const details = errorData.details;
+    switch (response.status) {
+      case 400:
+        throw new CobblError(message, "INVALID_REQUEST", details);
+      case 401:
+        throw new CobblError(message, "UNAUTHORIZED", details);
+      case 404:
+        throw new CobblError(message, "NOT_FOUND", details);
+      case 429:
+        throw new CobblError(message, "RATE_LIMIT_EXCEEDED", details);
+      case 500:
+      case 502:
+      case 503:
+      case 504:
+        throw new CobblError(message, "SERVER_ERROR", details);
+      default:
+        throw new CobblError(message, "API_ERROR", {
+          status: response.status,
+          ...details
+        });
+    }
+  }
+};
+
+export { CobblClient, CobblError };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Error types that can be thrown by the Cobbl SDK\n */\nexport type CobblErrorCode =\n  | 'INVALID_CONFIG'\n  | 'INVALID_REQUEST'\n  | 'UNAUTHORIZED'\n  | 'NOT_FOUND'\n  | 'RATE_LIMIT_EXCEEDED'\n  | 'SERVER_ERROR'\n  | 'NETWORK_ERROR'\n  | 'API_ERROR'\n\n/**\n * Custom error class for Cobbl SDK errors\n *\n * @example\n * ```typescript\n * try {\n *   await client.runPrompt('my-prompt', { topic: 'test' })\n * } catch (error) {\n *   if (error instanceof CobblError) {\n *     console.error(`Error [${error.code}]: ${error.message}`)\n *     console.error('Details:', error.details)\n *   }\n * }\n * ```\n */\nexport class CobblError extends Error {\n  /**\n   * Error code indicating the type of error\n   */\n  public readonly code: CobblErrorCode\n\n  /**\n   * Additional details about the error (e.g., missing variables, validation issues)\n   */\n  public readonly details?: unknown\n\n  constructor(message: string, code: CobblErrorCode, details?: unknown) {\n    super(message)\n    this.name = 'CobblError'\n    this.code = code\n    this.details = details\n\n    // Maintains proper stack trace for where error was thrown (V8 only)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, CobblError)\n    }\n  }\n\n  /**\n   * Check if an error is a CobblError\n   */\n  static isCobblError(error: unknown): error is CobblError {\n    return error instanceof CobblError\n  }\n\n  /**\n   * Convert error to JSON-serializable object\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      details: this.details,\n    }\n  }\n}\n","/**\n * CobblClient - SDK for the Cobbl platform\n *\n * Provides methods to run prompts and submit feedback to the Cobbl API.\n */\n\nimport type { PromptInput, PromptVersionClient } from '@prompti/shared'\nimport type {\n  RunPromptResponse,\n  SubmitFeedbackResponse,\n  CobblConfig,\n  TokenUsage,\n  FeedbackSubmission,\n} from './types'\nimport { CobblError } from './errors'\n\nconst REQUEST_TIMEOUT_MS = 30_000\n\nexport class CobblClient {\n  private readonly apiKey: string\n\n  /**\n   * Initialize the Cobbl SDK client\n   *\n   * @param config - Configuration object\n   * @param config.apiKey - Your Cobbl API key\n   *\n   * @example\n   * ```typescript\n   * const client = new CobblClient({\n   *   apiKey: process.env.COBBL_API_KEY\n   * })\n   * ```\n   */\n  constructor(config: CobblConfig) {\n    if (!config.apiKey || config.apiKey.trim().length === 0) {\n      throw new CobblError('API key is required', 'INVALID_CONFIG')\n    }\n\n    this.apiKey = config.apiKey\n  }\n\n  /**\n   * Execute a prompt with the given input variables\n   *\n   * @param promptSlug - The unique slug identifier for the prompt\n   * @param input - Input variables to populate the prompt template\n   * @returns Promise containing the prompt execution results\n   *\n   * @throws {CobblError} When the request fails or API returns an error\n   *\n   * @example\n   * ```typescript\n   * const result = await client.runPrompt('sales_summary', {\n   *   topic: 'Q4 Results',\n   *   tone: 'friendly',\n   *   audience: 'investors'\n   * })\n   *\n   * console.log(result.output) // AI-generated response\n   * console.log(result.runId) // Save this to link feedback later\n   * ```\n   */\n  async runPrompt(\n    promptSlug: string,\n    input: PromptInput\n  ): Promise<RunPromptResponse> {\n    if (!promptSlug || promptSlug.trim().length === 0) {\n      throw new CobblError('promptSlug is required', 'INVALID_REQUEST')\n    }\n\n    try {\n      const response = await this.makeRequest('/prompt/run', {\n        method: 'POST',\n        body: JSON.stringify({\n          promptSlug: promptSlug.trim(),\n          input,\n        }),\n      })\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response)\n      }\n\n      const data = (await response.json()) as {\n        runId: string\n        output: string\n        tokenUsage: TokenUsage\n        renderedPrompt: string\n        promptVersion: PromptVersionClient\n      }\n\n      return {\n        runId: data.runId,\n        output: data.output,\n        tokenUsage: data.tokenUsage,\n        renderedPrompt: data.renderedPrompt,\n        promptVersion: data.promptVersion,\n      }\n    } catch (error) {\n      if (error instanceof CobblError) {\n        throw error\n      }\n      throw new CobblError(\n        `Failed to run prompt: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        'NETWORK_ERROR'\n      )\n    }\n  }\n\n  /**\n   * Submit user feedback for a prompt run\n   *\n   * @param feedback - Feedback submission data\n   * @param feedback.runId - The run ID from a previous runPrompt call\n   * @param feedback.helpful - Whether the output was helpful ('helpful' or 'not_helpful')\n   * @param feedback.userFeedback - Detailed feedback message from the user\n   * @returns Promise containing the created feedback ID\n   *\n   * @throws {CobblError} When the request fails or API returns an error\n   *\n   * @example\n   * ```typescript\n   * await client.submitFeedback({\n   *   runId: result.runId,\n   *   helpful: 'not_helpful',\n   *   userFeedback: 'The response was too formal and lengthy'\n   * })\n   * ```\n   */\n  async submitFeedback(\n    feedback: FeedbackSubmission\n  ): Promise<SubmitFeedbackResponse> {\n    if (!feedback.runId || feedback.runId.trim().length === 0) {\n      throw new CobblError('runId is required', 'INVALID_REQUEST')\n    }\n\n    if (!feedback.userFeedback || feedback.userFeedback.trim().length === 0) {\n      throw new CobblError('userFeedback is required', 'INVALID_REQUEST')\n    }\n\n    if (\n      !feedback.helpful ||\n      !['helpful', 'not_helpful'].includes(feedback.helpful)\n    ) {\n      throw new CobblError(\n        'helpful must be either \"helpful\" or \"not_helpful\"',\n        'INVALID_REQUEST'\n      )\n    }\n\n    try {\n      const response = await this.makeRequest('/feedback', {\n        method: 'POST',\n        body: JSON.stringify({\n          runId: feedback.runId.trim(),\n          helpful: feedback.helpful,\n          userFeedback: feedback.userFeedback.trim(),\n        }),\n      })\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response)\n      }\n\n      const data = (await response.json()) as {\n        feedbackId: string\n        message: string\n      }\n\n      return {\n        feedbackId: data.feedbackId,\n        message: data.message,\n      }\n    } catch (error) {\n      if (error instanceof CobblError) {\n        throw error\n      }\n      throw new CobblError(\n        `Failed to submit feedback: ${error instanceof Error ? error.message : 'Unknown error'}`,\n        'NETWORK_ERROR'\n      )\n    }\n  }\n\n  /**\n   * Make an HTTP request to the Cobbl API\n   * @private\n   */\n  private async makeRequest(\n    path: string,\n    options: RequestInit\n  ): Promise<Response> {\n    const baseUrl = process.env.COBBL_API_URL || 'https://api.cobbl.ai'\n    const url = `${baseUrl}${path}`\n\n    const controller = new AbortController()\n    const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS)\n\n    try {\n      const response = await fetch(url, {\n        ...options,\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${this.apiKey}`,\n          ...options.headers,\n        },\n        signal: controller.signal,\n      })\n\n      return response\n    } finally {\n      clearTimeout(timeoutId)\n    }\n  }\n\n  /**\n   * Handle error responses from the API\n   * @private\n   */\n  private async handleErrorResponse(response: Response): Promise<never> {\n    let errorData: any\n    try {\n      errorData = await response.json()\n    } catch {\n      throw new CobblError(\n        `HTTP ${response.status}: ${response.statusText}`,\n        'API_ERROR',\n        { status: response.status }\n      )\n    }\n\n    const message = errorData.error || errorData.message || 'Unknown error'\n    const details = errorData.details\n\n    switch (response.status) {\n      case 400:\n        throw new CobblError(message, 'INVALID_REQUEST', details)\n      case 401:\n        throw new CobblError(message, 'UNAUTHORIZED', details)\n      case 404:\n        throw new CobblError(message, 'NOT_FOUND', details)\n      case 429:\n        throw new CobblError(message, 'RATE_LIMIT_EXCEEDED', details)\n      case 500:\n      case 502:\n      case 503:\n      case 504:\n        throw new CobblError(message, 'SERVER_ERROR', details)\n      default:\n        throw new CobblError(message, 'API_ERROR', {\n          status: response.status,\n          ...details,\n        })\n    }\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@cobbl-ai/sdk",
+  "version": "0.1.0",
+  "description": "Cobbl SDK - Close the Loop on LLM Prompt Feedback",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "src/**/*",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "keywords": [
+    "prompt",
+    "llm",
+    "ai",
+    "feedback",
+    "promptops",
+    "sdk",
+    "openai",
+    "anthropic",
+    "prompt-engineering"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@prompti/shared": "0.1.0"
+  },
+  "devDependencies": {
+    "@jest/test-sequencer": "29.7.0",
+    "@types/jest": "29.5.12",
+    "@types/node": "^18.0.0",
+    "dts-bundle-generator": "^9.0.0",
+    "jest": "29.7.0",
+    "ts-jest": "^29.4.5",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && dts-bundle-generator -o dist/index.d.ts src/index.ts --no-check && dts-bundle-generator -o dist/index.d.mts src/index.ts --no-check",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "pnpm jest",
+    "test:watch": "pnpm jest --watch",
+    "test:coverage": "pnpm jest --coverage"
+  }
+}