zorihq 0.10.1 → 0.11.1

package/src/resources/v1/revenue/cohort.ts

@@ -0,0 +1,111 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Cohort extends APIResource {
+  /**
+   * Analyze revenue metrics for a specific cohort of visitors, including total
+   * revenue, conversion rates, and time to first purchase
+   *
+   * @example
+   * ```ts
+   * const response = await client.v1.revenue.cohort.getMetrics({
+   *   project_id: 'project_id',
+   *   visitor_ids: ['string'],
+   * });
+   * ```
+   */
+  getMetrics(body: CohortGetMetricsParams, options?: RequestOptions): APIPromise<CohortGetMetricsResponse> {
+    return this._client.post('/api/v1/revenue/cohort/metrics', { body, ...options });
+  }
+}
+
+export interface CohortGetMetricsResponse {
+  /**
+   * Customers with only visitor_id
+   */
+  anonymous_customers?: number;
+
+  avg_order_value?: number;
+
+  avg_payments_per_customer?: number;
+
+  avg_revenue_per_customer?: number;
+
+  avg_revenue_per_visitor?: number;
+
+  /**
+   * Time metrics
+   */
+  avg_time_to_first_purchase_hours?: number;
+
+  /**
+   * paying_customers / total_customers \* 100
+   */
+  conversion_rate?: number;
+
+  currency?: string;
+
+  /**
+   * Customer identity mapping
+   */
+  identified_customers?: number;
+
+  /**
+   * Median time to first payment
+   */
+  median_time_to_first_purchase_hours?: number;
+
+  /**
+   * Unique customer identities who made payments
+   */
+  paying_customers?: number;
+
+  /**
+   * Total unique customer identities in cohort
+   */
+  total_customers?: number;
+
+  /**
+   * Payment metrics
+   */
+  total_payments?: number;
+
+  /**
+   * Revenue metrics
+   */
+  total_revenue?: number;
+
+  /**
+   * Cohort size
+   */
+  total_visitors?: number;
+
+  /**
+   * paying_customers / total_visitors \* 100
+   */
+  visitor_conversion_rate?: number;
+}
+
+export interface CohortGetMetricsParams {
+  project_id: string;
+
+  /**
+   * List of visitor IDs to analyze
+   */
+  visitor_ids: Array<string>;
+
+  /**
+   * Optional: filter by payment date
+   */
+  time_range?: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+}
+
+export declare namespace Cohort {
+  export {
+    type CohortGetMetricsResponse as CohortGetMetricsResponse,
+    type CohortGetMetricsParams as CohortGetMetricsParams,
+  };
+}

package/src/resources/v1/revenue/index.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Attribution, type AttributionByOriginParams, type AttributionByUtmParams } from './attribution';
+export { Cohort, type CohortGetMetricsResponse, type CohortGetMetricsParams } from './cohort';
 export { Conversion, type ConversionMetricsParams } from './conversion';
 export { Customers, type CustomerProfileParams, type CustomerTopParams } from './customers';
 export {

package/src/resources/v1/revenue/revenue.ts

@@ -3,6 +3,8 @@
 import { APIResource } from '../../../core/resource';
 import * as AttributionAPI from './attribution';
 import { Attribution, AttributionByOriginParams, AttributionByUtmParams } from './attribution';
+import * as CohortAPI from './cohort';
+import { Cohort, CohortGetMetricsParams, CohortGetMetricsResponse } from './cohort';
 import * as ConversionAPI from './conversion';
 import { Conversion, ConversionMetricsParams } from './conversion';
 import * as CustomersAPI from './customers';
@@ -14,6 +16,7 @@ export class Revenue extends APIResource {
   attribution: AttributionAPI.Attribution = new AttributionAPI.Attribution(this._client);
   customers: CustomersAPI.Customers = new CustomersAPI.Customers(this._client);
   conversion: ConversionAPI.Conversion = new ConversionAPI.Conversion(this._client);
+  cohort: CohortAPI.Cohort = new CohortAPI.Cohort(this._client);
 
   /**
    * Get key revenue metrics including total revenue, conversion rate, and average
@@ -258,6 +261,11 @@ export interface TopCustomer {
 
   currency?: string;
 
+  /**
+   * Resolved customer identity (user_id > external_id > visitor_id)
+   */
+  customer_id?: string;
+
   email?: string;
 
   external_id?: string;
@@ -281,7 +289,15 @@ export interface TopCustomer {
 
   user_id?: string;
 
+  /**
+   * Representative visitor_id for this customer
+   */
   visitor_id?: string;
+
+  /**
+   * All visitor_ids for this customer
+   */
+  visitor_ids?: Array<string>;
 }
 
 export interface TopCustomersResponse {
@@ -346,6 +362,7 @@ export interface RevenueTimelineParams {
 Revenue.Attribution = Attribution;
 Revenue.Customers = Customers;
 Revenue.Conversion = Conversion;
+Revenue.Cohort = Cohort;
 
 export declare namespace Revenue {
   export {
@@ -379,4 +396,10 @@ export declare namespace Revenue {
   };
 
   export { Conversion as Conversion, type ConversionMetricsParams as ConversionMetricsParams };
+
+  export {
+    Cohort as Cohort,
+    type CohortGetMetricsResponse as CohortGetMetricsResponse,
+    type CohortGetMetricsParams as CohortGetMetricsParams,
+  };
 }

package/src/resources/v1/v1.ts

@@ -1,21 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as PaymentProvidersAPI from './payment-providers';
-import {
-  CreatePaymentProviderRequest,
-  ListPaymentProvidersResponse,
-  PaymentProviderCreateParams,
-  PaymentProviderDeleteResponse,
-  PaymentProviderInstructionsParams,
-  PaymentProviderListParams,
-  PaymentProviderResponse,
-  PaymentProviderUpdateParams,
-  PaymentProviders,
-  ProviderField,
-  ProviderInstructionsResponse,
-  UpdatePaymentProviderRequest,
-} from './payment-providers';
+import * as AuthAPI from './auth';
+import { Auth, AuthLoginParams, LoginRequest, LoginResponse } from './auth';
 import * as ProjectsAPI from './projects';
 import {
   CreateProjectRequest,
@@ -60,6 +47,21 @@ import {
   VisitorsByDeviceResponse,
   VisitorsByOriginResponse,
 } from './analytics/analytics';
+import * as PaymentProvidersAPI from './payment-providers/payment-providers';
+import {
+  CreatePaymentProviderRequest,
+  ListPaymentProvidersResponse,
+  PaymentProviderCreateParams,
+  PaymentProviderDeleteResponse,
+  PaymentProviderInstructionsParams,
+  PaymentProviderListParams,
+  PaymentProviderResponse,
+  PaymentProviderUpdateParams,
+  PaymentProviders,
+  ProviderField,
+  ProviderInstructionsResponse,
+  UpdatePaymentProviderRequest,
+} from './payment-providers/payment-providers';
 import * as RevenueAPI from './revenue/revenue';
 import {
   AttributionByOriginResponse,
@@ -81,6 +83,7 @@ import {
 } from './revenue/revenue';
 
 export class V1 extends APIResource {
+  auth: AuthAPI.Auth = new AuthAPI.Auth(this._client);
   analytics: AnalyticsAPI.Analytics = new AnalyticsAPI.Analytics(this._client);
   revenue: RevenueAPI.Revenue = new RevenueAPI.Revenue(this._client);
   projects: ProjectsAPI.Projects = new ProjectsAPI.Projects(this._client);
@@ -89,12 +92,20 @@ export class V1 extends APIResource {
   );
 }
 
+V1.Auth = Auth;
 V1.Analytics = Analytics;
 V1.Revenue = Revenue;
 V1.Projects = Projects;
 V1.PaymentProviders = PaymentProviders;
 
 export declare namespace V1 {
+  export {
+    Auth as Auth,
+    type LoginRequest as LoginRequest,
+    type LoginResponse as LoginResponse,
+    type AuthLoginParams as AuthLoginParams,
+  };
+
   export {
     Analytics as Analytics,
     type ActiveUsersResponse as ActiveUsersResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.10.1'; // x-release-please-version
+export const VERSION = '0.11.1'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.10.1";
+export declare const VERSION = "0.11.1";
 //# 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.10.1'; // x-release-please-version
+exports.VERSION = '0.11.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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