@cobbl-ai/sdk 0.1.0

package/src/errors.ts

@@ -0,0 +1,70 @@
+/**
+ * Error types that can be thrown by the Cobbl SDK
+ */
+export type CobblErrorCode =
+  | 'INVALID_CONFIG'
+  | 'INVALID_REQUEST'
+  | 'UNAUTHORIZED'
+  | 'NOT_FOUND'
+  | 'RATE_LIMIT_EXCEEDED'
+  | 'SERVER_ERROR'
+  | 'NETWORK_ERROR'
+  | 'API_ERROR'
+
+/**
+ * Custom error class for Cobbl SDK errors
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.runPrompt('my-prompt', { topic: 'test' })
+ * } catch (error) {
+ *   if (error instanceof CobblError) {
+ *     console.error(`Error [${error.code}]: ${error.message}`)
+ *     console.error('Details:', error.details)
+ *   }
+ * }
+ * ```
+ */
+export class CobblError extends Error {
+  /**
+   * Error code indicating the type of error
+   */
+  public readonly code: CobblErrorCode
+
+  /**
+   * Additional details about the error (e.g., missing variables, validation issues)
+   */
+  public readonly details?: unknown
+
+  constructor(message: string, code: CobblErrorCode, details?: unknown) {
+    super(message)
+    this.name = 'CobblError'
+    this.code = code
+    this.details = details
+
+    // Maintains proper stack trace for where error was thrown (V8 only)
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, CobblError)
+    }
+  }
+
+  /**
+   * Check if an error is a CobblError
+   */
+  static isCobblError(error: unknown): error is CobblError {
+    return error instanceof CobblError
+  }
+
+  /**
+   * Convert error to JSON-serializable object
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      details: this.details,
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,43 @@
+/**
+ * Cobbl SDK
+ *
+ * A lightweight SDK for interacting with the Cobbl platform.
+ *
+ * @example
+ * ```typescript
+ * import { CobblClient } from '@cobbl-ai/sdk'
+ *
+ * const client = new CobblClient({
+ *   apiKey: process.env.COBBL_API_KEY
+ * })
+ *
+ * // Run a prompt
+ * const result = await client.runPrompt('sales_summary', {
+ *   topic: 'Q4 Results',
+ *   tone: 'friendly'
+ * })
+ *
+ * // Submit feedback
+ * await client.submitFeedback({
+ *   runId: result.runId,
+ *   helpful: 'not_helpful',
+ *   userFeedback: 'Too formal'
+ * })
+ * ```
+ */
+
+export { CobblClient } from './client'
+export { CobblError } from './errors'
+export type { CobblErrorCode } from './errors'
+export type {
+  CobblConfig,
+  TokenUsage,
+  RunPromptResponse,
+  Helpful,
+  FeedbackSubmission,
+  SubmitFeedbackResponse,
+  PromptInput,
+  PromptVersionClient,
+  Provider,
+  VariableConfig,
+} from './types'

package/src/types.ts

@@ -0,0 +1,94 @@
+/**
+ * Type definitions for the Cobbl SDK
+ */
+
+import type { PromptVersionClient, TokenUsage, Helpful } from '@prompti/shared'
+
+/**
+ * Configuration options for the CobblClient
+ */
+export interface CobblConfig {
+  /**
+   * Your Cobbl API key
+   * @required
+   */
+  apiKey: string
+}
+
+/**
+ * Response from running a prompt
+ */
+export interface RunPromptResponse {
+  /**
+   * Unique ID for this prompt run - use this to link feedback
+   */
+  runId: string
+
+  /**
+   * The AI-generated output
+   */
+  output: string
+
+  /**
+   * Token usage statistics
+   */
+  tokenUsage: TokenUsage
+
+  /**
+   * The rendered prompt that was sent to the LLM (with variables substituted)
+   */
+  renderedPrompt: string
+
+  /**
+   * Information about the prompt version that was used
+   */
+  promptVersion: PromptVersionClient
+}
+
+/**
+ * Feedback submission data
+ */
+export interface FeedbackSubmission {
+  /**
+   * The run ID from a previous runPrompt call
+   * @required
+   */
+  runId: string
+
+  /**
+   * Whether the output was helpful
+   * @required
+   */
+  helpful: Helpful
+
+  /**
+   * Detailed feedback message from the user
+   * @required
+   */
+  userFeedback: string
+}
+
+/**
+ * Response from submitting feedback
+ */
+export interface SubmitFeedbackResponse {
+  /**
+   * Unique ID for the created feedback item
+   */
+  feedbackId: string
+
+  /**
+   * Success message
+   */
+  message: string
+}
+
+// Re-export commonly used types from shared
+export type {
+  PromptInput,
+  PromptVersionClient,
+  Provider,
+  VariableConfig,
+  TokenUsage,
+  Helpful,
+} from '@prompti/shared'