zorihq 0.19.1 → 0.21.0

package/src/resources/v1/analytics/llm.ts

@@ -0,0 +1,99 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as AnalyticsAPI from './analytics';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Llm extends APIResource {
+  /**
+   * Get a paginated list of LLM traces with optional filters (name, user_id,
+   * session_id, model)
+   *
+   * @example
+   * ```ts
+   * const llmTracesListResponse =
+   *   await client.v1.analytics.llm.traces({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  traces(query: LlmTracesParams, options?: RequestOptions): APIPromise<AnalyticsAPI.LlmTracesListResponse> {
+    return this._client.get('/api/v1/analytics/llm/traces', { query, ...options });
+  }
+
+  /**
+   * Get unique names, user_ids, session_ids, and models to populate filter dropdowns
+   *
+   * @example
+   * ```ts
+   * const llmTraceFilterOptionsResponse =
+   *   await client.v1.analytics.llm.tracesFilterOptions({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  tracesFilterOptions(
+    query: LlmTracesFilterOptionsParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.LlmTraceFilterOptionsResponse> {
+    return this._client.get('/api/v1/analytics/llm/traces/filter-options', { query, ...options });
+  }
+}
+
+export interface LlmTracesParams {
+  project_id: string;
+
+  time_range: 'last_hour' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+
+  customer_id?: string;
+
+  limit?: number;
+
+  model?: string;
+
+  name?: string;
+
+  offset?: number;
+
+  referrer?: string;
+
+  session_id?: string;
+
+  user_id?: string;
+
+  utmtag?: string;
+
+  utmtagValue?: string;
+
+  visitor_id?: string;
+}
+
+export interface LlmTracesFilterOptionsParams {
+  project_id: string;
+
+  time_range: 'last_hour' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+
+  customer_id?: string;
+
+  limit?: number;
+
+  offset?: number;
+
+  referrer?: string;
+
+  utmtag?: string;
+
+  utmtagValue?: string;
+
+  visitor_id?: string;
+}
+
+export declare namespace Llm {
+  export {
+    type LlmTracesParams as LlmTracesParams,
+    type LlmTracesFilterOptionsParams as LlmTracesFilterOptionsParams,
+  };
+}

package/src/resources/v1/analytics/tiles.ts

@@ -80,6 +80,42 @@ export class Tiles extends APIResource {
     return this._client.get('/api/v1/analytics/tiles/exit-pages', { query, ...options });
   }
 
+  /**
+   * Get total LLM cost for current period compared to the previous period
+   *
+   * @example
+   * ```ts
+   * const llmCostResponse =
+   *   await client.v1.analytics.tiles.llmCost({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  llmCost(query: TileLlmCostParams, options?: RequestOptions): APIPromise<AnalyticsAPI.LlmCostResponse> {
+    return this._client.get('/api/v1/analytics/tiles/llm-cost', { query, ...options });
+  }
+
+  /**
+   * Get top 3 most expensive LLM models for current period compared to the previous
+   * period
+   *
+   * @example
+   * ```ts
+   * const llmTopModelsCostResponse =
+   *   await client.v1.analytics.tiles.llmTopModelsCost({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  llmTopModelsCost(
+    query: TileLlmTopModelsCostParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.LlmTopModelsCostResponse> {
+    return this._client.get('/api/v1/analytics/tiles/llm-top-models-cost', { query, ...options });
+  }
+
   /**
    * Get monthly active user count (last 30 days) compared to the previous month
    *
@@ -405,6 +441,46 @@ export interface TileExitPagesParams {
   visitor_id?: string;
 }
 
+export interface TileLlmCostParams {
+  project_id: string;
+
+  time_range: 'last_hour' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+
+  customer_id?: string;
+
+  limit?: number;
+
+  offset?: number;
+
+  referrer?: string;
+
+  utmtag?: string;
+
+  utmtagValue?: string;
+
+  visitor_id?: string;
+}
+
+export interface TileLlmTopModelsCostParams {
+  project_id: string;
+
+  time_range: 'last_hour' | 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+
+  customer_id?: string;
+
+  limit?: number;
+
+  offset?: number;
+
+  referrer?: string;
+
+  utmtag?: string;
+
+  utmtagValue?: string;
+
+  visitor_id?: string;
+}
+
 export interface TileMauParams {
   project_id: string;
 
@@ -671,6 +747,8 @@ export declare namespace Tiles {
     type TileDauParams as TileDauParams,
     type TileEntryPagesParams as TileEntryPagesParams,
     type TileExitPagesParams as TileExitPagesParams,
+    type TileLlmCostParams as TileLlmCostParams,
+    type TileLlmTopModelsCostParams as TileLlmTopModelsCostParams,
     type TileMauParams as TileMauParams,
     type TilePagesPerSessionParams as TilePagesPerSessionParams,
     type TileReturnRateParams as TileReturnRateParams,

package/src/resources/v1/index.ts

@@ -16,6 +16,12 @@ export {
   type EventsOverTimeDataPoint,
   type ExitPagesData,
   type ExitPagesResponse,
+  type LlmCostResponse,
+  type LlmModelCostData,
+  type LlmTopModelsCostResponse,
+  type LlmTraceFilterOptionsResponse,
+  type LlmTraceItem,
+  type LlmTracesListResponse,
   type ManualIdentifyRequest,
   type ManualIdentifyResponse,
   type MauResponse,
@@ -65,6 +71,7 @@ export {
   type Project,
   type ProjectResponse,
   type UpdateProjectRequest,
+  type ProjectCreateResponse,
   type ProjectDeleteResponse,
   type ProjectCreateParams,
   type ProjectUpdateParams,

package/src/resources/v1/projects.ts

@@ -7,17 +7,18 @@ import { path } from '../../internal/utils/path';
 
 export class Projects extends APIResource {
   /**
-   * Create a new project for the authenticated user's organization
+   * Create a new project for the authenticated user's organization. The response
+   * includes Langfuse API keys for LLM trace ingestion.
    *
    * @example
    * ```ts
-   * const projectResponse = await client.v1.projects.create({
+   * const project = await client.v1.projects.create({
    *   name: 'My Awesome Project',
    *   website_url: 'https://example.com',
    * });
    * ```
    */
-  create(body: ProjectCreateParams, options?: RequestOptions): APIPromise<ProjectResponse> {
+  create(body: ProjectCreateParams, options?: RequestOptions): APIPromise<ProjectCreateResponse> {
     return this._client.post('/api/v1/projects', { body, ...options });
   }
 
@@ -98,6 +99,14 @@ export interface Project {
 
   first_event_received_at?: string;
 
+  /**
+   * Langfuse-compatible API keys for LLM trace ingestion (used to accept OpenRouter
+   * traces)
+   */
+  langfuse_public_key?: string;
+
+  langfuse_secret_key?: string;
+
   name?: string;
 
   organization_id?: string;
@@ -118,6 +127,14 @@ export interface ProjectResponse {
 
   first_event_received_at?: string;
 
+  /**
+   * Langfuse-compatible API keys for LLM trace ingestion (used to accept OpenRouter
+   * traces)
+   */
+  langfuse_public_key?: string;
+
+  langfuse_secret_key?: string;
+
   name?: string;
 
   organization_id?: string;
@@ -135,6 +152,34 @@ export interface UpdateProjectRequest {
   website_url?: string;
 }
 
+export interface ProjectCreateResponse {
+  id?: string;
+
+  allow_local_host?: boolean;
+
+  created_at?: string;
+
+  domain?: string;
+
+  first_event_received_at?: string;
+
+  /**
+   * Langfuse-compatible API keys for LLM trace ingestion (used to accept OpenRouter
+   * traces)
+   */
+  langfuse_public_key?: string;
+
+  langfuse_secret_key?: string;
+
+  name?: string;
+
+  organization_id?: string;
+
+  project_token?: string;
+
+  updated_at?: string;
+}
+
 export type ProjectDeleteResponse = { [key: string]: string };
 
 export interface ProjectCreateParams {
@@ -160,6 +205,7 @@ export declare namespace Projects {
     type Project as Project,
     type ProjectResponse as ProjectResponse,
     type UpdateProjectRequest as UpdateProjectRequest,
+    type ProjectCreateResponse as ProjectCreateResponse,
     type ProjectDeleteResponse as ProjectDeleteResponse,
     type ProjectCreateParams as ProjectCreateParams,
     type ProjectUpdateParams as ProjectUpdateParams,

package/src/resources/v1/v1.ts

@@ -9,6 +9,7 @@ import {
   ListProjectsResponse,
   Project,
   ProjectCreateParams,
+  ProjectCreateResponse,
   ProjectDeleteResponse,
   ProjectResponse,
   ProjectUpdateParams,
@@ -33,6 +34,12 @@ import {
   EventsOverTimeDataPoint,
   ExitPagesData,
   ExitPagesResponse,
+  LlmCostResponse,
+  LlmModelCostData,
+  LlmTopModelsCostResponse,
+  LlmTraceFilterOptionsResponse,
+  LlmTraceItem,
+  LlmTracesListResponse,
   ManualIdentifyRequest,
   ManualIdentifyResponse,
   MauResponse,
@@ -134,6 +141,12 @@ export declare namespace V1 {
     type EventsOverTimeDataPoint as EventsOverTimeDataPoint,
     type ExitPagesData as ExitPagesData,
     type ExitPagesResponse as ExitPagesResponse,
+    type LlmCostResponse as LlmCostResponse,
+    type LlmModelCostData as LlmModelCostData,
+    type LlmTopModelsCostResponse as LlmTopModelsCostResponse,
+    type LlmTraceFilterOptionsResponse as LlmTraceFilterOptionsResponse,
+    type LlmTraceItem as LlmTraceItem,
+    type LlmTracesListResponse as LlmTracesListResponse,
     type ManualIdentifyRequest as ManualIdentifyRequest,
     type ManualIdentifyResponse as ManualIdentifyResponse,
     type MauResponse as MauResponse,
@@ -188,6 +201,7 @@ export declare namespace V1 {
     type Project as Project,
     type ProjectResponse as ProjectResponse,
     type UpdateProjectRequest as UpdateProjectRequest,
+    type ProjectCreateResponse as ProjectCreateResponse,
     type ProjectDeleteResponse as ProjectDeleteResponse,
     type ProjectCreateParams as ProjectCreateParams,
     type ProjectUpdateParams as ProjectUpdateParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.19.1'; // x-release-please-version
+export const VERSION = '0.21.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.19.1";
+export declare const VERSION = "0.21.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.19.1";
+export declare const VERSION = "0.21.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.19.1'; // x-release-please-version
+exports.VERSION = '0.21.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.19.1'; // x-release-please-version
+export const VERSION = '0.21.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map