@tritonium/api-client 2.1.0

package/README.md

@@ -0,0 +1,313 @@
+# @tritonium/api-client
+
+Official TypeScript/JavaScript SDK for the Tritonium API - Customer feedback analytics platform.
+
+## Installation
+
+```bash
+npm install @tritonium/api-client
+```
+
+## Quick Start
+
+### Using API Key Authentication
+
+```typescript
+import { configureApiKey, AppsService } from '@tritonium/api-client';
+
+// Configure authentication
+configureApiKey('trtn_live_your_key_here');
+
+// Make API calls
+const apps = await AppsService.getApps();
+console.log(apps);
+```
+
+### Using Bearer Token (JWT)
+
+```typescript
+import { configureBearerToken, AppsService } from '@tritonium/api-client';
+
+// Configure with Cognito JWT token
+configureBearerToken('your_jwt_token');
+
+// Make API calls
+const apps = await AppsService.getApps();
+```
+
+## Authentication
+
+The SDK supports two authentication methods:
+
+### API Key Authentication
+
+Best for server-side applications and integrations.
+
+```typescript
+import { configureApiKey } from '@tritonium/api-client/auth';
+
+configureApiKey('trtn_live_abc123...');
+
+// Or with a custom base URL
+configureApiKey('trtn_test_abc123...', 'https://staging-api.tritonium.com');
+```
+
+### Bearer Token Authentication
+
+Best for applications with existing Cognito authentication.
+
+```typescript
+import { configureBearerToken } from '@tritonium/api-client/auth';
+
+configureBearerToken('eyJhbGciOiJSUzI1NiIs...');
+```
+
+### Advanced Configuration
+
+```typescript
+import { configure, getConfiguration, clearAuth } from '@tritonium/api-client/auth';
+
+// Configure with multiple options
+configure({
+  apiKey: 'trtn_live_abc123...',
+  baseUrl: 'https://staging-api.tritonium.com',
+  headers: { 'X-Custom-Header': 'value' },
+});
+
+// Check current configuration
+const config = getConfiguration();
+console.log(config.hasApiKey); // true
+
+// Clear authentication
+clearAuth();
+```
+
+## Webhook Verification
+
+Verify incoming webhooks from Tritonium to ensure they're authentic.
+
+```typescript
+import express from 'express';
+import {
+  verifyWebhook,
+  WebhookVerificationError,
+  EventTypes,
+} from '@tritonium/api-client/webhooks';
+
+const app = express();
+const WEBHOOK_SECRET = 'whsec_your_secret';
+
+app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
+  try {
+    const event = verifyWebhook({
+      payload: req.body,
+      signature: req.headers['x-tritonium-signature'] as string,
+      timestamp: req.headers['x-tritonium-timestamp'] as string,
+      secret: WEBHOOK_SECRET,
+    });
+
+    switch (event.eventType) {
+      case EventTypes.REVIEW_RECEIVED:
+        console.log('New review:', event.data);
+        break;
+      case EventTypes.ALERT_TRIGGERED:
+        console.log('Alert:', event.data);
+        break;
+      case EventTypes.CRISIS_DETECTED:
+        console.log('Crisis detected:', event.data);
+        break;
+    }
+
+    res.json({ status: 'ok' });
+  } catch (e) {
+    if (e instanceof WebhookVerificationError) {
+      console.error('Webhook verification failed:', e.message);
+      res.status(401).json({ error: e.message });
+    } else {
+      throw e;
+    }
+  }
+});
+```
+
+### Webhook Event Types
+
+| Event Type | Description |
+|------------|-------------|
+| `review.received` | New review was received |
+| `alert.triggered` | Alert rule was triggered |
+| `crisis.detected` | Crisis event was detected |
+| `insight.generated` | New insight was generated |
+| `analysis.completed` | Analysis job completed |
+| `test.ping` | Test webhook (manual trigger) |
+
+### Typed Event Data
+
+```typescript
+import type {
+  ReviewReceivedData,
+  AlertTriggeredData,
+  CrisisDetectedData,
+} from '@tritonium/api-client/webhooks';
+
+// Type-safe event handling
+const event = verifyWebhook<ReviewReceivedData>({ ... });
+console.log(event.data.review_id);
+console.log(event.data.rating);
+```
+
+## Available Services
+
+| Service | Description |
+|---------|-------------|
+| `AppsService` | Manage connected apps and platforms |
+| `ReviewsService` | Access and manage reviews |
+| `AlertsService` | Configure and manage alerts |
+| `InsightsService` | Access generated insights |
+| `IntegrationsService` | Manage integrations (Slack, etc.) |
+| `RatingsService` | Access ratings and analytics |
+| `PredictionsService` | ML predictions and forecasting |
+| `BillingService` | Subscription and billing |
+| `CredentialsService` | Manage API credentials (Admin) |
+| `WorkflowsService` | Workflow automation |
+| `UsersService` | User management |
+| `HealthService` | API health checks |
+
+### Service Examples
+
+**Managing Apps:**
+```typescript
+import { AppsService } from '@tritonium/api-client';
+
+// List all connected apps
+const apps = await AppsService.getApps();
+
+// Connect a new app
+const newApp = await AppsService.connectApp({
+  platform: 'app_store',
+  external_app_id: '123456789',
+  credential_id: 'cred-abc'
+});
+
+// Trigger review sync
+await AppsService.syncReviews({ app_uuid: 'app-123' });
+```
+
+**Working with Reviews:**
+```typescript
+import { ReviewsService } from '@tritonium/api-client';
+
+// Get reviews with filters
+const reviews = await ReviewsService.getReviews({
+  app_uuid: 'app-123',
+  rating_min: 1,
+  rating_max: 3,
+  limit: 50
+});
+
+// Generate AI reply suggestion
+const reply = await ReviewsService.generateReply({
+  app_uuid: 'app-123',
+  review_id: 'review-456'
+});
+
+// Post reply to store
+await ReviewsService.postReply({
+  app_uuid: 'app-123',
+  review_id: 'review-456',
+  text: reply.suggested_text
+});
+```
+
+**Predictions & Forecasting:**
+```typescript
+import { PredictionsService } from '@tritonium/api-client';
+
+// Get rating forecast
+const forecast = await PredictionsService.getRatingForecast({
+  app_uuid: 'app-123',
+  horizon: 30
+});
+console.log(`Predicted rating: ${forecast.forecasted_rating}`);
+
+// Estimate feature impact
+const impact = await PredictionsService.estimateFeatureImpact({
+  app_uuid: 'app-123',
+  feature_type: 'bug_fix',
+  affected_topics: ['crashes', 'performance']
+});
+```
+
+**Managing Credentials (Admin only):**
+```typescript
+import { CredentialsService } from '@tritonium/api-client';
+
+// List credentials
+const credentials = await CredentialsService.listCredentials();
+
+// Create new credential
+await CredentialsService.createCredential({
+  name: 'App Store Connect',
+  platform: 'app_store',
+  credentials: {
+    key_id: 'ABC123',
+    issuer_id: 'xxx-yyy-zzz',
+    private_key: '-----BEGIN PRIVATE KEY-----...'
+  }
+});
+```
+
+**Workflow Automation:**
+```typescript
+import { WorkflowsService } from '@tritonium/api-client';
+
+// List workflow templates
+const templates = await WorkflowsService.listTemplates();
+
+// Create workflow from template
+const workflow = await WorkflowsService.createFromTemplate({
+  name: 'Daily Digest',
+  template_id: 'weekly-digest',
+  config: {
+    schedule: '0 9 * * *',
+    channels: ['slack']
+  }
+});
+
+// Pause a workflow
+await WorkflowsService.pauseWorkflow({ workflow_id: workflow.id });
+```
+
+## Error Handling
+
+```typescript
+import { ApiError } from '@tritonium/api-client';
+
+try {
+  const apps = await AppsService.getApps();
+} catch (error) {
+  if (error instanceof ApiError) {
+    console.error(`API Error ${error.status}: ${error.message}`);
+    console.error('Response body:', error.body);
+  } else {
+    throw error;
+  }
+}
+```
+
+## TypeScript Support
+
+This SDK is written in TypeScript and includes full type definitions. All models and services are fully typed.
+
+```typescript
+import type { AppSummary, ReviewSummary, Alert } from '@tritonium/api-client';
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- TypeScript >= 5.0 (for TypeScript users)
+
+## License
+
+MIT

package/dist/auth.d.mts

@@ -0,0 +1,86 @@
+/**
+ * Authentication helpers for the Tritonium API.
+ *
+ * This module provides utilities for API key authentication and token management.
+ *
+ * @example
+ * ```typescript
+ * import { configureApiKey, configureBearerToken } from './auth';
+ *
+ * // Using API key
+ * configureApiKey('trtn_live_your_key_here');
+ *
+ * // Using Bearer token
+ * configureBearerToken('your_jwt_token');
+ * ```
+ */
+/**
+ * Configure the SDK to use API key authentication.
+ *
+ * @param apiKey - Your Tritonium API key (starts with trtn_live_ or trtn_test_)
+ * @param baseUrl - Optional custom base URL (defaults to production)
+ *
+ * @example
+ * ```typescript
+ * import { configureApiKey } from '@tritonium/api-client/auth';
+ * import { AppsService } from '@tritonium/api-client';
+ *
+ * configureApiKey('trtn_live_abc123...');
+ *
+ * const apps = await AppsService.getApps();
+ * ```
+ */
+declare function configureApiKey(apiKey: string, baseUrl?: string): void;
+/**
+ * Configure the SDK to use Bearer token authentication.
+ *
+ * @param token - Your Cognito JWT access token
+ * @param baseUrl - Optional custom base URL (defaults to production)
+ *
+ * @example
+ * ```typescript
+ * import { configureBearerToken } from '@tritonium/api-client/auth';
+ * import { AppsService } from '@tritonium/api-client';
+ *
+ * configureBearerToken('eyJhbGciOiJSUzI1NiIs...');
+ *
+ * const apps = await AppsService.getApps();
+ * ```
+ */
+declare function configureBearerToken(token: string, baseUrl?: string): void;
+/**
+ * Configure the SDK with custom settings.
+ *
+ * @param config - Configuration options
+ *
+ * @example
+ * ```typescript
+ * import { configure } from '@tritonium/api-client/auth';
+ *
+ * configure({
+ *   apiKey: 'trtn_live_abc123...',
+ *   baseUrl: 'https://staging-api.tritonium.com',
+ *   headers: { 'X-Custom-Header': 'value' },
+ * });
+ * ```
+ */
+declare function configure(config: {
+    apiKey?: string;
+    token?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+}): void;
+/**
+ * Get the current configuration.
+ */
+declare function getConfiguration(): {
+    baseUrl: string;
+    hasApiKey: boolean;
+    hasToken: boolean;
+};
+/**
+ * Clear all authentication configuration.
+ */
+declare function clearAuth(): void;
+
+export { clearAuth, configure, configureApiKey, configureBearerToken, getConfiguration };

package/dist/auth.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Authentication helpers for the Tritonium API.
+ *
+ * This module provides utilities for API key authentication and token management.
+ *
+ * @example
+ * ```typescript
+ * import { configureApiKey, configureBearerToken } from './auth';
+ *
+ * // Using API key
+ * configureApiKey('trtn_live_your_key_here');
+ *
+ * // Using Bearer token
+ * configureBearerToken('your_jwt_token');
+ * ```
+ */
+/**
+ * Configure the SDK to use API key authentication.
+ *
+ * @param apiKey - Your Tritonium API key (starts with trtn_live_ or trtn_test_)
+ * @param baseUrl - Optional custom base URL (defaults to production)
+ *
+ * @example
+ * ```typescript
+ * import { configureApiKey } from '@tritonium/api-client/auth';
+ * import { AppsService } from '@tritonium/api-client';
+ *
+ * configureApiKey('trtn_live_abc123...');
+ *
+ * const apps = await AppsService.getApps();
+ * ```
+ */
+declare function configureApiKey(apiKey: string, baseUrl?: string): void;
+/**
+ * Configure the SDK to use Bearer token authentication.
+ *
+ * @param token - Your Cognito JWT access token
+ * @param baseUrl - Optional custom base URL (defaults to production)
+ *
+ * @example
+ * ```typescript
+ * import { configureBearerToken } from '@tritonium/api-client/auth';
+ * import { AppsService } from '@tritonium/api-client';
+ *
+ * configureBearerToken('eyJhbGciOiJSUzI1NiIs...');
+ *
+ * const apps = await AppsService.getApps();
+ * ```
+ */
+declare function configureBearerToken(token: string, baseUrl?: string): void;
+/**
+ * Configure the SDK with custom settings.
+ *
+ * @param config - Configuration options
+ *
+ * @example
+ * ```typescript
+ * import { configure } from '@tritonium/api-client/auth';
+ *
+ * configure({
+ *   apiKey: 'trtn_live_abc123...',
+ *   baseUrl: 'https://staging-api.tritonium.com',
+ *   headers: { 'X-Custom-Header': 'value' },
+ * });
+ * ```
+ */
+declare function configure(config: {
+    apiKey?: string;
+    token?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+}): void;
+/**
+ * Get the current configuration.
+ */
+declare function getConfiguration(): {
+    baseUrl: string;
+    hasApiKey: boolean;
+    hasToken: boolean;
+};
+/**
+ * Clear all authentication configuration.
+ */
+declare function clearAuth(): void;
+
+export { clearAuth, configure, configureApiKey, configureBearerToken, getConfiguration };

package/dist/auth.js

@@ -0,0 +1,77 @@
+'use strict';
+
+// core/OpenAPI.ts
+var OpenAPI = {
+  BASE: "https://api.tritonium.com",
+  TOKEN: void 0,
+  HEADERS: void 0};
+
+// auth.ts
+function configureApiKey(apiKey, baseUrl = "https://api.tritonium.com") {
+  OpenAPI.BASE = baseUrl;
+  const existingHeaders = typeof OpenAPI.HEADERS === "object" && OpenAPI.HEADERS !== null ? OpenAPI.HEADERS : {};
+  OpenAPI.HEADERS = {
+    ...existingHeaders,
+    "X-API-Key": apiKey
+  };
+  if (OpenAPI.TOKEN) {
+    OpenAPI.TOKEN = void 0;
+  }
+}
+function configureBearerToken(token, baseUrl = "https://api.tritonium.com") {
+  OpenAPI.BASE = baseUrl;
+  OpenAPI.TOKEN = token;
+  if (OpenAPI.HEADERS && "X-API-Key" in OpenAPI.HEADERS) {
+    const { "X-API-Key": _, ...rest } = OpenAPI.HEADERS;
+    OpenAPI.HEADERS = rest;
+  }
+}
+function configure(config) {
+  if (config.baseUrl) {
+    OpenAPI.BASE = config.baseUrl;
+  }
+  if (config.apiKey) {
+    OpenAPI.HEADERS = {
+      ...OpenAPI.HEADERS,
+      ...config.headers,
+      "X-API-Key": config.apiKey
+    };
+    OpenAPI.TOKEN = void 0;
+  } else if (config.token) {
+    OpenAPI.TOKEN = config.token;
+    OpenAPI.HEADERS = {
+      ...OpenAPI.HEADERS,
+      ...config.headers
+    };
+  } else if (config.headers) {
+    OpenAPI.HEADERS = {
+      ...OpenAPI.HEADERS,
+      ...config.headers
+    };
+  }
+}
+function getConfiguration() {
+  const headers = OpenAPI.HEADERS;
+  const hasApiKey = typeof headers === "object" && headers !== null && "X-API-Key" in headers;
+  return {
+    baseUrl: OpenAPI.BASE,
+    hasApiKey,
+    hasToken: Boolean(OpenAPI.TOKEN)
+  };
+}
+function clearAuth() {
+  OpenAPI.TOKEN = void 0;
+  const headers = OpenAPI.HEADERS;
+  if (typeof headers === "object" && headers !== null && "X-API-Key" in headers) {
+    const { "X-API-Key": _, ...rest } = headers;
+    OpenAPI.HEADERS = rest;
+  }
+}
+
+exports.clearAuth = clearAuth;
+exports.configure = configure;
+exports.configureApiKey = configureApiKey;
+exports.configureBearerToken = configureBearerToken;
+exports.getConfiguration = getConfiguration;
+//# sourceMappingURL=auth.js.map
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../core/OpenAPI.ts","../auth.ts"],"names":[],"mappings":";;;AAqBO,IAAM,OAAA,GAAyB;AAAA,EAClC,IAAA,EAAM,2BAAA;AAAA,EAIN,KAAA,EAAO,MAAA;AAAA,EAGP,OAAA,EAAS,MAEb,CAAA;;;ACIO,SAAS,eAAA,CACd,MAAA,EACA,OAAA,GAAkB,2BAAA,EACZ;AACN,EAAA,OAAA,CAAQ,IAAA,GAAO,OAAA;AACf,EAAA,MAAM,eAAA,GAAkB,OAAO,OAAA,CAAQ,OAAA,KAAY,QAAA,IAAY,QAAQ,OAAA,KAAY,IAAA,GAAO,OAAA,CAAQ,OAAA,GAAU,EAAC;AAC7G,EAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,IAChB,GAAG,eAAA;AAAA,IACH,WAAA,EAAa;AAAA,GACf;AAEA,EAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,IAAA,OAAA,CAAQ,KAAA,GAAQ,MAAA;AAAA,EAClB;AACF;AAkBO,SAAS,oBAAA,CACd,KAAA,EACA,OAAA,GAAkB,2BAAA,EACZ;AACN,EAAA,OAAA,CAAQ,IAAA,GAAO,OAAA;AACf,EAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA;AAEhB,EAAA,IAAI,OAAA,CAAQ,OAAA,IAAW,WAAA,IAAe,OAAA,CAAQ,OAAA,EAAS;AACrD,IAAA,MAAM,EAAE,WAAA,EAAa,CAAA,EAAG,GAAG,IAAA,KAAS,OAAA,CAAQ,OAAA;AAC5C,IAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAAA,EACpB;AACF;AAkBO,SAAS,UAAU,MAAA,EAKjB;AACP,EAAA,IAAI,OAAO,OAAA,EAAS;AAClB,IAAA,OAAA,CAAQ,OAAO,MAAA,CAAO,OAAA;AAAA,EACxB;AAEA,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,MAChB,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,GAAG,MAAA,CAAO,OAAA;AAAA,MACV,aAAa,MAAA,CAAO;AAAA,KACtB;AACA,IAAA,OAAA,CAAQ,KAAA,GAAQ,MAAA;AAAA,EAClB,CAAA,MAAA,IAAW,OAAO,KAAA,EAAO;AACvB,IAAA,OAAA,CAAQ,QAAQ,MAAA,CAAO,KAAA;AACvB,IAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,MAChB,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,GAAG,MAAA,CAAO;AAAA,KACZ;AAAA,EACF,CAAA,MAAA,IAAW,OAAO,OAAA,EAAS;AACzB,IAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,MAChB,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,GAAG,MAAA,CAAO;AAAA,KACZ;AAAA,EACF;AACF;AAKO,SAAS,gBAAA,GAId;AACA,EAAA,MAAM,UAAU,OAAA,CAAQ,OAAA;AACxB,EAAA,MAAM,YAAY,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,QAAQ,WAAA,IAAe,OAAA;AACpF,EAAA,OAAO;AAAA,IACL,SAAS,OAAA,CAAQ,IAAA;AAAA,IACjB,SAAA;AAAA,IACA,QAAA,EAAU,OAAA,CAAQ,OAAA,CAAQ,KAAK;AAAA,GACjC;AACF;AAKO,SAAS,SAAA,GAAkB;AAChC,EAAA,OAAA,CAAQ,KAAA,GAAQ,MAAA;AAChB,EAAA,MAAM,UAAU,OAAA,CAAQ,OAAA;AACxB,EAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,IAAA,IAAQ,eAAe,OAAA,EAAS;AAC7E,IAAA,MAAM,EAAE,WAAA,EAAa,CAAA,EAAG,GAAG,MAAK,GAAI,OAAA;AACpC,IAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAAA,EACpB;AACF","file":"auth.js","sourcesContent":["/* generated using openapi-typescript-codegen -- do not edit */\n/* istanbul ignore file */\n/* tslint:disable */\n/* eslint-disable */\nimport type { ApiRequestOptions } from './ApiRequestOptions';\n\ntype Resolver<T> = (options: ApiRequestOptions) => Promise<T>;\ntype Headers = Record<string, string>;\n\nexport type OpenAPIConfig = {\n    BASE: string;\n    VERSION: string;\n    WITH_CREDENTIALS: boolean;\n    CREDENTIALS: 'include' | 'omit' | 'same-origin';\n    TOKEN?: string | Resolver<string> | undefined;\n    USERNAME?: string | Resolver<string> | undefined;\n    PASSWORD?: string | Resolver<string> | undefined;\n    HEADERS?: Headers | Resolver<Headers> | undefined;\n    ENCODE_PATH?: ((path: string) => string) | undefined;\n};\n\nexport const OpenAPI: OpenAPIConfig = {\n    BASE: 'https://api.tritonium.com',\n    VERSION: '1.0.0',\n    WITH_CREDENTIALS: false,\n    CREDENTIALS: 'include',\n    TOKEN: undefined,\n    USERNAME: undefined,\n    PASSWORD: undefined,\n    HEADERS: undefined,\n    ENCODE_PATH: undefined,\n};\n","/**\n * Authentication helpers for the Tritonium API.\n *\n * This module provides utilities for API key authentication and token management.\n *\n * @example\n * ```typescript\n * import { configureApiKey, configureBearerToken } from './auth';\n *\n * // Using API key\n * configureApiKey('trtn_live_your_key_here');\n *\n * // Using Bearer token\n * configureBearerToken('your_jwt_token');\n * ```\n */\n\nimport { OpenAPI } from './core/OpenAPI';\n\n/**\n * Configure the SDK to use API key authentication.\n *\n * @param apiKey - Your Tritonium API key (starts with trtn_live_ or trtn_test_)\n * @param baseUrl - Optional custom base URL (defaults to production)\n *\n * @example\n * ```typescript\n * import { configureApiKey } from '@tritonium/api-client/auth';\n * import { AppsService } from '@tritonium/api-client';\n *\n * configureApiKey('trtn_live_abc123...');\n *\n * const apps = await AppsService.getApps();\n * ```\n */\nexport function configureApiKey(\n  apiKey: string,\n  baseUrl: string = 'https://api.tritonium.com'\n): void {\n  OpenAPI.BASE = baseUrl;\n  const existingHeaders = typeof OpenAPI.HEADERS === 'object' && OpenAPI.HEADERS !== null ? OpenAPI.HEADERS : {};\n  OpenAPI.HEADERS = {\n    ...existingHeaders,\n    'X-API-Key': apiKey,\n  };\n  // Remove Bearer token if switching to API key\n  if (OpenAPI.TOKEN) {\n    OpenAPI.TOKEN = undefined;\n  }\n}\n\n/**\n * Configure the SDK to use Bearer token authentication.\n *\n * @param token - Your Cognito JWT access token\n * @param baseUrl - Optional custom base URL (defaults to production)\n *\n * @example\n * ```typescript\n * import { configureBearerToken } from '@tritonium/api-client/auth';\n * import { AppsService } from '@tritonium/api-client';\n *\n * configureBearerToken('eyJhbGciOiJSUzI1NiIs...');\n *\n * const apps = await AppsService.getApps();\n * ```\n */\nexport function configureBearerToken(\n  token: string,\n  baseUrl: string = 'https://api.tritonium.com'\n): void {\n  OpenAPI.BASE = baseUrl;\n  OpenAPI.TOKEN = token;\n  // Remove API key header if switching to Bearer\n  if (OpenAPI.HEADERS && 'X-API-Key' in OpenAPI.HEADERS) {\n    const { 'X-API-Key': _, ...rest } = OpenAPI.HEADERS;\n    OpenAPI.HEADERS = rest;\n  }\n}\n\n/**\n * Configure the SDK with custom settings.\n *\n * @param config - Configuration options\n *\n * @example\n * ```typescript\n * import { configure } from '@tritonium/api-client/auth';\n *\n * configure({\n *   apiKey: 'trtn_live_abc123...',\n *   baseUrl: 'https://staging-api.tritonium.com',\n *   headers: { 'X-Custom-Header': 'value' },\n * });\n * ```\n */\nexport function configure(config: {\n  apiKey?: string;\n  token?: string;\n  baseUrl?: string;\n  headers?: Record<string, string>;\n}): void {\n  if (config.baseUrl) {\n    OpenAPI.BASE = config.baseUrl;\n  }\n\n  if (config.apiKey) {\n    OpenAPI.HEADERS = {\n      ...OpenAPI.HEADERS,\n      ...config.headers,\n      'X-API-Key': config.apiKey,\n    };\n    OpenAPI.TOKEN = undefined;\n  } else if (config.token) {\n    OpenAPI.TOKEN = config.token;\n    OpenAPI.HEADERS = {\n      ...OpenAPI.HEADERS,\n      ...config.headers,\n    };\n  } else if (config.headers) {\n    OpenAPI.HEADERS = {\n      ...OpenAPI.HEADERS,\n      ...config.headers,\n    };\n  }\n}\n\n/**\n * Get the current configuration.\n */\nexport function getConfiguration(): {\n  baseUrl: string;\n  hasApiKey: boolean;\n  hasToken: boolean;\n} {\n  const headers = OpenAPI.HEADERS;\n  const hasApiKey = typeof headers === 'object' && headers !== null && 'X-API-Key' in headers;\n  return {\n    baseUrl: OpenAPI.BASE,\n    hasApiKey,\n    hasToken: Boolean(OpenAPI.TOKEN),\n  };\n}\n\n/**\n * Clear all authentication configuration.\n */\nexport function clearAuth(): void {\n  OpenAPI.TOKEN = undefined;\n  const headers = OpenAPI.HEADERS;\n  if (typeof headers === 'object' && headers !== null && 'X-API-Key' in headers) {\n    const { 'X-API-Key': _, ...rest } = headers;\n    OpenAPI.HEADERS = rest;\n  }\n}\n"]}

package/dist/auth.mjs

@@ -0,0 +1,71 @@
+// core/OpenAPI.ts
+var OpenAPI = {
+  BASE: "https://api.tritonium.com",
+  TOKEN: void 0,
+  HEADERS: void 0};
+
+// auth.ts
+function configureApiKey(apiKey, baseUrl = "https://api.tritonium.com") {
+  OpenAPI.BASE = baseUrl;
+  const existingHeaders = typeof OpenAPI.HEADERS === "object" && OpenAPI.HEADERS !== null ? OpenAPI.HEADERS : {};
+  OpenAPI.HEADERS = {
+    ...existingHeaders,
+    "X-API-Key": apiKey
+  };
+  if (OpenAPI.TOKEN) {
+    OpenAPI.TOKEN = void 0;
+  }
+}
+function configureBearerToken(token, baseUrl = "https://api.tritonium.com") {
+  OpenAPI.BASE = baseUrl;
+  OpenAPI.TOKEN = token;
+  if (OpenAPI.HEADERS && "X-API-Key" in OpenAPI.HEADERS) {
+    const { "X-API-Key": _, ...rest } = OpenAPI.HEADERS;
+    OpenAPI.HEADERS = rest;
+  }
+}
+function configure(config) {
+  if (config.baseUrl) {
+    OpenAPI.BASE = config.baseUrl;
+  }
+  if (config.apiKey) {
+    OpenAPI.HEADERS = {
+      ...OpenAPI.HEADERS,
+      ...config.headers,
+      "X-API-Key": config.apiKey
+    };
+    OpenAPI.TOKEN = void 0;
+  } else if (config.token) {
+    OpenAPI.TOKEN = config.token;
+    OpenAPI.HEADERS = {
+      ...OpenAPI.HEADERS,
+      ...config.headers
+    };
+  } else if (config.headers) {
+    OpenAPI.HEADERS = {
+      ...OpenAPI.HEADERS,
+      ...config.headers
+    };
+  }
+}
+function getConfiguration() {
+  const headers = OpenAPI.HEADERS;
+  const hasApiKey = typeof headers === "object" && headers !== null && "X-API-Key" in headers;
+  return {
+    baseUrl: OpenAPI.BASE,
+    hasApiKey,
+    hasToken: Boolean(OpenAPI.TOKEN)
+  };
+}
+function clearAuth() {
+  OpenAPI.TOKEN = void 0;
+  const headers = OpenAPI.HEADERS;
+  if (typeof headers === "object" && headers !== null && "X-API-Key" in headers) {
+    const { "X-API-Key": _, ...rest } = headers;
+    OpenAPI.HEADERS = rest;
+  }
+}
+
+export { clearAuth, configure, configureApiKey, configureBearerToken, getConfiguration };
+//# sourceMappingURL=auth.mjs.map
+//# sourceMappingURL=auth.mjs.map

package/dist/auth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../core/OpenAPI.ts","../auth.ts"],"names":[],"mappings":";AAqBO,IAAM,OAAA,GAAyB;AAAA,EAClC,IAAA,EAAM,2BAAA;AAAA,EAIN,KAAA,EAAO,MAAA;AAAA,EAGP,OAAA,EAAS,MAEb,CAAA;;;ACIO,SAAS,eAAA,CACd,MAAA,EACA,OAAA,GAAkB,2BAAA,EACZ;AACN,EAAA,OAAA,CAAQ,IAAA,GAAO,OAAA;AACf,EAAA,MAAM,eAAA,GAAkB,OAAO,OAAA,CAAQ,OAAA,KAAY,QAAA,IAAY,QAAQ,OAAA,KAAY,IAAA,GAAO,OAAA,CAAQ,OAAA,GAAU,EAAC;AAC7G,EAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,IAChB,GAAG,eAAA;AAAA,IACH,WAAA,EAAa;AAAA,GACf;AAEA,EAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,IAAA,OAAA,CAAQ,KAAA,GAAQ,MAAA;AAAA,EAClB;AACF;AAkBO,SAAS,oBAAA,CACd,KAAA,EACA,OAAA,GAAkB,2BAAA,EACZ;AACN,EAAA,OAAA,CAAQ,IAAA,GAAO,OAAA;AACf,EAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA;AAEhB,EAAA,IAAI,OAAA,CAAQ,OAAA,IAAW,WAAA,IAAe,OAAA,CAAQ,OAAA,EAAS;AACrD,IAAA,MAAM,EAAE,WAAA,EAAa,CAAA,EAAG,GAAG,IAAA,KAAS,OAAA,CAAQ,OAAA;AAC5C,IAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAAA,EACpB;AACF;AAkBO,SAAS,UAAU,MAAA,EAKjB;AACP,EAAA,IAAI,OAAO,OAAA,EAAS;AAClB,IAAA,OAAA,CAAQ,OAAO,MAAA,CAAO,OAAA;AAAA,EACxB;AAEA,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,MAChB,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,GAAG,MAAA,CAAO,OAAA;AAAA,MACV,aAAa,MAAA,CAAO;AAAA,KACtB;AACA,IAAA,OAAA,CAAQ,KAAA,GAAQ,MAAA;AAAA,EAClB,CAAA,MAAA,IAAW,OAAO,KAAA,EAAO;AACvB,IAAA,OAAA,CAAQ,QAAQ,MAAA,CAAO,KAAA;AACvB,IAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,MAChB,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,GAAG,MAAA,CAAO;AAAA,KACZ;AAAA,EACF,CAAA,MAAA,IAAW,OAAO,OAAA,EAAS;AACzB,IAAA,OAAA,CAAQ,OAAA,GAAU;AAAA,MAChB,GAAG,OAAA,CAAQ,OAAA;AAAA,MACX,GAAG,MAAA,CAAO;AAAA,KACZ;AAAA,EACF;AACF;AAKO,SAAS,gBAAA,GAId;AACA,EAAA,MAAM,UAAU,OAAA,CAAQ,OAAA;AACxB,EAAA,MAAM,YAAY,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,QAAQ,WAAA,IAAe,OAAA;AACpF,EAAA,OAAO;AAAA,IACL,SAAS,OAAA,CAAQ,IAAA;AAAA,IACjB,SAAA;AAAA,IACA,QAAA,EAAU,OAAA,CAAQ,OAAA,CAAQ,KAAK;AAAA,GACjC;AACF;AAKO,SAAS,SAAA,GAAkB;AAChC,EAAA,OAAA,CAAQ,KAAA,GAAQ,MAAA;AAChB,EAAA,MAAM,UAAU,OAAA,CAAQ,OAAA;AACxB,EAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,IAAA,IAAQ,eAAe,OAAA,EAAS;AAC7E,IAAA,MAAM,EAAE,WAAA,EAAa,CAAA,EAAG,GAAG,MAAK,GAAI,OAAA;AACpC,IAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAAA,EACpB;AACF","file":"auth.mjs","sourcesContent":["/* generated using openapi-typescript-codegen -- do not edit */\n/* istanbul ignore file */\n/* tslint:disable */\n/* eslint-disable */\nimport type { ApiRequestOptions } from './ApiRequestOptions';\n\ntype Resolver<T> = (options: ApiRequestOptions) => Promise<T>;\ntype Headers = Record<string, string>;\n\nexport type OpenAPIConfig = {\n    BASE: string;\n    VERSION: string;\n    WITH_CREDENTIALS: boolean;\n    CREDENTIALS: 'include' | 'omit' | 'same-origin';\n    TOKEN?: string | Resolver<string> | undefined;\n    USERNAME?: string | Resolver<string> | undefined;\n    PASSWORD?: string | Resolver<string> | undefined;\n    HEADERS?: Headers | Resolver<Headers> | undefined;\n    ENCODE_PATH?: ((path: string) => string) | undefined;\n};\n\nexport const OpenAPI: OpenAPIConfig = {\n    BASE: 'https://api.tritonium.com',\n    VERSION: '1.0.0',\n    WITH_CREDENTIALS: false,\n    CREDENTIALS: 'include',\n    TOKEN: undefined,\n    USERNAME: undefined,\n    PASSWORD: undefined,\n    HEADERS: undefined,\n    ENCODE_PATH: undefined,\n};\n","/**\n * Authentication helpers for the Tritonium API.\n *\n * This module provides utilities for API key authentication and token management.\n *\n * @example\n * ```typescript\n * import { configureApiKey, configureBearerToken } from './auth';\n *\n * // Using API key\n * configureApiKey('trtn_live_your_key_here');\n *\n * // Using Bearer token\n * configureBearerToken('your_jwt_token');\n * ```\n */\n\nimport { OpenAPI } from './core/OpenAPI';\n\n/**\n * Configure the SDK to use API key authentication.\n *\n * @param apiKey - Your Tritonium API key (starts with trtn_live_ or trtn_test_)\n * @param baseUrl - Optional custom base URL (defaults to production)\n *\n * @example\n * ```typescript\n * import { configureApiKey } from '@tritonium/api-client/auth';\n * import { AppsService } from '@tritonium/api-client';\n *\n * configureApiKey('trtn_live_abc123...');\n *\n * const apps = await AppsService.getApps();\n * ```\n */\nexport function configureApiKey(\n  apiKey: string,\n  baseUrl: string = 'https://api.tritonium.com'\n): void {\n  OpenAPI.BASE = baseUrl;\n  const existingHeaders = typeof OpenAPI.HEADERS === 'object' && OpenAPI.HEADERS !== null ? OpenAPI.HEADERS : {};\n  OpenAPI.HEADERS = {\n    ...existingHeaders,\n    'X-API-Key': apiKey,\n  };\n  // Remove Bearer token if switching to API key\n  if (OpenAPI.TOKEN) {\n    OpenAPI.TOKEN = undefined;\n  }\n}\n\n/**\n * Configure the SDK to use Bearer token authentication.\n *\n * @param token - Your Cognito JWT access token\n * @param baseUrl - Optional custom base URL (defaults to production)\n *\n * @example\n * ```typescript\n * import { configureBearerToken } from '@tritonium/api-client/auth';\n * import { AppsService } from '@tritonium/api-client';\n *\n * configureBearerToken('eyJhbGciOiJSUzI1NiIs...');\n *\n * const apps = await AppsService.getApps();\n * ```\n */\nexport function configureBearerToken(\n  token: string,\n  baseUrl: string = 'https://api.tritonium.com'\n): void {\n  OpenAPI.BASE = baseUrl;\n  OpenAPI.TOKEN = token;\n  // Remove API key header if switching to Bearer\n  if (OpenAPI.HEADERS && 'X-API-Key' in OpenAPI.HEADERS) {\n    const { 'X-API-Key': _, ...rest } = OpenAPI.HEADERS;\n    OpenAPI.HEADERS = rest;\n  }\n}\n\n/**\n * Configure the SDK with custom settings.\n *\n * @param config - Configuration options\n *\n * @example\n * ```typescript\n * import { configure } from '@tritonium/api-client/auth';\n *\n * configure({\n *   apiKey: 'trtn_live_abc123...',\n *   baseUrl: 'https://staging-api.tritonium.com',\n *   headers: { 'X-Custom-Header': 'value' },\n * });\n * ```\n */\nexport function configure(config: {\n  apiKey?: string;\n  token?: string;\n  baseUrl?: string;\n  headers?: Record<string, string>;\n}): void {\n  if (config.baseUrl) {\n    OpenAPI.BASE = config.baseUrl;\n  }\n\n  if (config.apiKey) {\n    OpenAPI.HEADERS = {\n      ...OpenAPI.HEADERS,\n      ...config.headers,\n      'X-API-Key': config.apiKey,\n    };\n    OpenAPI.TOKEN = undefined;\n  } else if (config.token) {\n    OpenAPI.TOKEN = config.token;\n    OpenAPI.HEADERS = {\n      ...OpenAPI.HEADERS,\n      ...config.headers,\n    };\n  } else if (config.headers) {\n    OpenAPI.HEADERS = {\n      ...OpenAPI.HEADERS,\n      ...config.headers,\n    };\n  }\n}\n\n/**\n * Get the current configuration.\n */\nexport function getConfiguration(): {\n  baseUrl: string;\n  hasApiKey: boolean;\n  hasToken: boolean;\n} {\n  const headers = OpenAPI.HEADERS;\n  const hasApiKey = typeof headers === 'object' && headers !== null && 'X-API-Key' in headers;\n  return {\n    baseUrl: OpenAPI.BASE,\n    hasApiKey,\n    hasToken: Boolean(OpenAPI.TOKEN),\n  };\n}\n\n/**\n * Clear all authentication configuration.\n */\nexport function clearAuth(): void {\n  OpenAPI.TOKEN = undefined;\n  const headers = OpenAPI.HEADERS;\n  if (typeof headers === 'object' && headers !== null && 'X-API-Key' in headers) {\n    const { 'X-API-Key': _, ...rest } = headers;\n    OpenAPI.HEADERS = rest;\n  }\n}\n"]}