zorihq 0.8.0 → 0.9.0

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

@@ -0,0 +1,385 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as AttributionAPI from './attribution';
+import { Attribution, AttributionByOriginParams, AttributionByUtmParams } from './attribution';
+import * as ConversionAPI from './conversion';
+import { Conversion, ConversionMetricsParams } from './conversion';
+import * as CustomersAPI from './customers';
+import { CustomerProfileParams, CustomerTopParams, Customers } from './customers';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+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);
+
+  /**
+   * Get key revenue metrics including total revenue, conversion rate, and average
+   * order value
+   *
+   * @example
+   * ```ts
+   * const dashboardResponse = await client.v1.revenue.dashboard(
+   *   { project_id: 'project_id', time_range: 'last_hour' },
+   * );
+   * ```
+   */
+  dashboard(query: RevenueDashboardParams, options?: RequestOptions): APIPromise<DashboardResponse> {
+    return this._client.get('/api/v1/revenue/dashboard', { query, ...options });
+  }
+
+  /**
+   * Get revenue metrics over time for chart visualization
+   *
+   * @example
+   * ```ts
+   * const timelineResponse = await client.v1.revenue.timeline({
+   *   project_id: 'project_id',
+   *   time_range: 'last_hour',
+   * });
+   * ```
+   */
+  timeline(query: RevenueTimelineParams, options?: RequestOptions): APIPromise<TimelineResponse> {
+    return this._client.get('/api/v1/revenue/timeline', { query, ...options });
+  }
+}
+
+export interface AttributionByOriginResponse {
+  data?: Array<OriginAttributionDataPoint>;
+}
+
+export interface AttributionByUtmResponse {
+  data?: Array<UtmAttributionDataPoint>;
+}
+
+export interface ConversionMetricsResponse {
+  avg_purchases_per_customer?: number;
+
+  /**
+   * Time to conversion
+   */
+  avg_time_to_first_purchase_hours?: number;
+
+  /**
+   * % of visitors who paid
+   */
+  conversion_rate?: number;
+
+  /**
+   * Customer value
+   */
+  customer_lifetime_value?: number;
+
+  median_time_to_first_purchase_hours?: number;
+
+  paying_customers?: number;
+
+  /**
+   * Repeat purchase metrics
+   */
+  repeat_purchase_rate?: number;
+
+  /**
+   * Funnel metrics
+   */
+  total_visitors?: number;
+}
+
+export interface CustomerProfileResponse {
+  avg_order_value?: number;
+
+  currency?: string;
+
+  email?: string;
+
+  external_id?: string;
+
+  first_payment_date?: string;
+
+  /**
+   * Attribution
+   */
+  first_traffic_origin?: string;
+
+  first_utm_campaign?: string;
+
+  first_utm_medium?: string;
+
+  first_utm_source?: string;
+
+  last_payment_date?: string;
+
+  name?: string;
+
+  payment_count?: number;
+
+  /**
+   * Payment history
+   */
+  payments?: Array<Payment>;
+
+  /**
+   * Revenue over time (last 90 days)
+   */
+  revenue_over_time?: Array<RevenueOverTimeDataPoint>;
+
+  /**
+   * Revenue summary
+   */
+  total_revenue?: number;
+
+  user_id?: string;
+
+  /**
+   * Identity
+   */
+  visitor_id?: string;
+}
+
+export interface DashboardResponse {
+  /**
+   * Average metrics
+   */
+  avg_order_value?: number;
+
+  /**
+   * Average revenue per paying customer
+   */
+  avg_revenue_per_customer?: number;
+
+  avg_revenue_per_identified_customer?: number;
+
+  /**
+   * Average revenue per session
+   */
+  avg_revenue_per_session?: number;
+
+  /**
+   * % of visitors who paid
+   */
+  conversion_rate?: number;
+
+  currency?: string;
+
+  identified_customer_revenue?: number;
+
+  /**
+   * Identified customers (have email/user_id)
+   */
+  identified_customers?: number;
+
+  /**
+   * Customer metrics
+   */
+  paying_customers?: number;
+
+  /**
+   * Count of successful payments
+   */
+  total_payments?: number;
+
+  /**
+   * Core revenue metrics
+   */
+  total_revenue?: number;
+}
+
+export interface OriginAttributionDataPoint {
+  /**
+   * Average revenue per paying customer
+   */
+  avg_revenue_per_customer?: number;
+
+  /**
+   * paying_customers / unique_visitors \* 100
+   */
+  conversion_rate?: number;
+
+  currency?: string;
+
+  origin?: string;
+
+  paying_customers?: number;
+
+  payment_count?: number;
+
+  revenue_percentage?: number;
+
+  /**
+   * Revenue in smallest currency unit (cents)
+   */
+  total_revenue?: number;
+
+  unique_visitors?: number;
+}
+
+export interface Payment {
+  amount?: number;
+
+  currency?: string;
+
+  payment_id?: string;
+
+  payment_timestamp?: string;
+
+  product_name?: string;
+
+  provider_type?: string;
+
+  status?: string;
+}
+
+export interface RevenueOverTimeDataPoint {
+  payment_count?: number;
+
+  timestamp?: string;
+
+  total_revenue?: number;
+}
+
+export interface TimelineDataPoint {
+  currency?: string;
+
+  payment_count?: number;
+
+  timestamp?: string;
+
+  /**
+   * Revenue in smallest currency unit (cents)
+   */
+  total_revenue?: number;
+}
+
+export interface TimelineResponse {
+  data?: Array<TimelineDataPoint>;
+}
+
+export interface TopCustomer {
+  avg_order_value?: number;
+
+  currency?: string;
+
+  email?: string;
+
+  external_id?: string;
+
+  first_payment_date?: string;
+
+  first_traffic_origin?: string;
+
+  last_payment_date?: string;
+
+  location_country_iso?: string;
+
+  name?: string;
+
+  payment_count?: number;
+
+  /**
+   * Total revenue in smallest currency unit (cents)
+   */
+  total_revenue?: number;
+
+  user_id?: string;
+
+  visitor_id?: string;
+}
+
+export interface TopCustomersResponse {
+  customers?: Array<TopCustomer>;
+
+  total?: number;
+}
+
+export interface UtmAttributionDataPoint {
+  /**
+   * Average revenue per paying customer
+   */
+  avg_revenue_per_customer?: number;
+
+  /**
+   * paying_customers / unique_visitors \* 100
+   */
+  conversion_rate?: number;
+
+  currency?: string;
+
+  paying_customers?: number;
+
+  payment_count?: number;
+
+  revenue_percentage?: number;
+
+  /**
+   * Revenue in smallest currency unit (cents)
+   */
+  total_revenue?: number;
+
+  unique_visitors?: number;
+
+  utm_value?: string;
+}
+
+export interface RevenueDashboardParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Time range
+   */
+  time_range: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+}
+
+export interface RevenueTimelineParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Time range
+   */
+  time_range: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+}
+
+Revenue.Attribution = Attribution;
+Revenue.Customers = Customers;
+Revenue.Conversion = Conversion;
+
+export declare namespace Revenue {
+  export {
+    type AttributionByOriginResponse as AttributionByOriginResponse,
+    type AttributionByUtmResponse as AttributionByUtmResponse,
+    type ConversionMetricsResponse as ConversionMetricsResponse,
+    type CustomerProfileResponse as CustomerProfileResponse,
+    type DashboardResponse as DashboardResponse,
+    type OriginAttributionDataPoint as OriginAttributionDataPoint,
+    type Payment as Payment,
+    type RevenueOverTimeDataPoint as RevenueOverTimeDataPoint,
+    type TimelineDataPoint as TimelineDataPoint,
+    type TimelineResponse as TimelineResponse,
+    type TopCustomer as TopCustomer,
+    type TopCustomersResponse as TopCustomersResponse,
+    type UtmAttributionDataPoint as UtmAttributionDataPoint,
+    type RevenueDashboardParams as RevenueDashboardParams,
+    type RevenueTimelineParams as RevenueTimelineParams,
+  };
+
+  export {
+    Attribution as Attribution,
+    type AttributionByOriginParams as AttributionByOriginParams,
+    type AttributionByUtmParams as AttributionByUtmParams,
+  };
+
+  export {
+    Customers as Customers,
+    type CustomerProfileParams as CustomerProfileParams,
+    type CustomerTopParams as CustomerTopParams,
+  };
+
+  export { Conversion as Conversion, type ConversionMetricsParams as ConversionMetricsParams };
+}

package/src/resources/v1/revenue.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './revenue/index';

package/src/resources/v1/v1.ts

@@ -59,26 +59,41 @@ import {
   RecentEvent,
   RecentEventsResponse,
   ReturnRateResponse,
-  RevenueByUtmResponse,
-  RevenueTimelineDataPoint,
-  RevenueTimelineResponse,
   SessionMetricsResponse,
   TopVisitor,
   TopVisitorsResponse,
   UniqueVisitorsDataPoint,
   UniqueVisitorsTimelineResponse,
-  UtmRevenueDataPoint,
   VisitorDataPoint,
   VisitorEvent,
-  VisitorPayment,
   VisitorProfileResponse,
   VisitorsByCountryResponse,
   VisitorsByDeviceResponse,
   VisitorsByOriginResponse,
 } from './analytics/analytics';
+import * as RevenueAPI from './revenue/revenue';
+import {
+  AttributionByOriginResponse,
+  AttributionByUtmResponse,
+  ConversionMetricsResponse,
+  CustomerProfileResponse,
+  DashboardResponse,
+  OriginAttributionDataPoint,
+  Payment,
+  Revenue,
+  RevenueDashboardParams,
+  RevenueOverTimeDataPoint,
+  RevenueTimelineParams,
+  TimelineDataPoint,
+  TimelineResponse,
+  TopCustomer,
+  TopCustomersResponse,
+  UtmAttributionDataPoint,
+} from './revenue/revenue';
 
 export class V1 extends APIResource {
   analytics: AnalyticsAPI.Analytics = new AnalyticsAPI.Analytics(this._client);
+  revenue: RevenueAPI.Revenue = new RevenueAPI.Revenue(this._client);
   projects: ProjectsAPI.Projects = new ProjectsAPI.Projects(this._client);
   auth: AuthAPI.Auth = new AuthAPI.Auth(this._client);
   paymentProviders: PaymentProvidersAPI.PaymentProviders = new PaymentProvidersAPI.PaymentProviders(
@@ -87,6 +102,7 @@ export class V1 extends APIResource {
 }
 
 V1.Analytics = Analytics;
+V1.Revenue = Revenue;
 V1.Projects = Projects;
 V1.Auth = Auth;
 V1.PaymentProviders = PaymentProviders;
@@ -110,18 +126,13 @@ export declare namespace V1 {
     type RecentEvent as RecentEvent,
     type RecentEventsResponse as RecentEventsResponse,
     type ReturnRateResponse as ReturnRateResponse,
-    type RevenueByUtmResponse as RevenueByUtmResponse,
-    type RevenueTimelineDataPoint as RevenueTimelineDataPoint,
-    type RevenueTimelineResponse as RevenueTimelineResponse,
     type SessionMetricsResponse as SessionMetricsResponse,
     type TopVisitor as TopVisitor,
     type TopVisitorsResponse as TopVisitorsResponse,
     type UniqueVisitorsDataPoint as UniqueVisitorsDataPoint,
     type UniqueVisitorsTimelineResponse as UniqueVisitorsTimelineResponse,
-    type UtmRevenueDataPoint as UtmRevenueDataPoint,
     type VisitorDataPoint as VisitorDataPoint,
     type VisitorEvent as VisitorEvent,
-    type VisitorPayment as VisitorPayment,
     type VisitorProfileResponse as VisitorProfileResponse,
     type VisitorsByCountryResponse as VisitorsByCountryResponse,
     type VisitorsByDeviceResponse as VisitorsByDeviceResponse,
@@ -129,6 +140,25 @@ export declare namespace V1 {
     type AnalyticsDashboardParams as AnalyticsDashboardParams,
   };
 
+  export {
+    Revenue as Revenue,
+    type AttributionByOriginResponse as AttributionByOriginResponse,
+    type AttributionByUtmResponse as AttributionByUtmResponse,
+    type ConversionMetricsResponse as ConversionMetricsResponse,
+    type CustomerProfileResponse as CustomerProfileResponse,
+    type DashboardResponse as DashboardResponse,
+    type OriginAttributionDataPoint as OriginAttributionDataPoint,
+    type Payment as Payment,
+    type RevenueOverTimeDataPoint as RevenueOverTimeDataPoint,
+    type TimelineDataPoint as TimelineDataPoint,
+    type TimelineResponse as TimelineResponse,
+    type TopCustomer as TopCustomer,
+    type TopCustomersResponse as TopCustomersResponse,
+    type UtmAttributionDataPoint as UtmAttributionDataPoint,
+    type RevenueDashboardParams as RevenueDashboardParams,
+    type RevenueTimelineParams as RevenueTimelineParams,
+  };
+
   export {
     Projects as Projects,
     type CreateProjectRequest as CreateProjectRequest,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.8.0'; // x-release-please-version
+export const VERSION = '0.9.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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

package/resources/v1/analytics/revenue.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"revenue.d.mts","sourceRoot":"","sources":["../../../src/resources/v1/analytics/revenue.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC,oBAAoB,CAAC;IAIzG;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,YAAY,CAAC,uBAAuB,CAAC;CAGpD;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;IAEpF;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;CACrF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/resources/v1/analytics/revenue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"revenue.d.ts","sourceRoot":"","sources":["../../../src/resources/v1/analytics/revenue.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,YAAY;OACjB,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC,oBAAoB,CAAC;IAIzG;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,YAAY,CAAC,uBAAuB,CAAC;CAGpD;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;IAEpF;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;CACrF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,qBAAqB,IAAI,qBAAqB,GACpD,CAAC;CACH"}

package/resources/v1/analytics/revenue.js

@@ -1,39 +0,0 @@
-"use strict";
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Revenue = void 0;
-const resource_1 = require("../../../core/resource.js");
-class Revenue extends resource_1.APIResource {
-    /**
-     * Get revenue metrics grouped by UTM source, medium, or campaign
-     *
-     * @example
-     * ```ts
-     * const revenueByUtmResponse =
-     *   await client.v1.analytics.revenue.byUtm({
-     *     project_id: 'project_id',
-     *     time_range: 'last_hour',
-     *   });
-     * ```
-     */
-    byUtm(query, options) {
-        return this._client.get('/api/v1/analytics/revenue/by-utm', { query, ...options });
-    }
-    /**
-     * Get revenue metrics over time for chart visualization
-     *
-     * @example
-     * ```ts
-     * const revenueTimelineResponse =
-     *   await client.v1.analytics.revenue.timeline({
-     *     project_id: 'project_id',
-     *     time_range: 'last_hour',
-     *   });
-     * ```
-     */
-    timeline(query, options) {
-        return this._client.get('/api/v1/analytics/revenue/timeline', { query, ...options });
-    }
-}
-exports.Revenue = Revenue;
-//# sourceMappingURL=revenue.js.map

package/resources/v1/analytics/revenue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"revenue.js","sourceRoot":"","sources":["../../../src/resources/v1/analytics/revenue.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAKrD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAyB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,KAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;CACF;AAnCD,0BAmCC"}

package/resources/v1/analytics/revenue.mjs

@@ -1,35 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-import { APIResource } from "../../../core/resource.mjs";
-export class Revenue extends APIResource {
-    /**
-     * Get revenue metrics grouped by UTM source, medium, or campaign
-     *
-     * @example
-     * ```ts
-     * const revenueByUtmResponse =
-     *   await client.v1.analytics.revenue.byUtm({
-     *     project_id: 'project_id',
-     *     time_range: 'last_hour',
-     *   });
-     * ```
-     */
-    byUtm(query, options) {
-        return this._client.get('/api/v1/analytics/revenue/by-utm', { query, ...options });
-    }
-    /**
-     * Get revenue metrics over time for chart visualization
-     *
-     * @example
-     * ```ts
-     * const revenueTimelineResponse =
-     *   await client.v1.analytics.revenue.timeline({
-     *     project_id: 'project_id',
-     *     time_range: 'last_hour',
-     *   });
-     * ```
-     */
-    timeline(query, options) {
-        return this._client.get('/api/v1/analytics/revenue/timeline', { query, ...options });
-    }
-}
-//# sourceMappingURL=revenue.mjs.map

package/resources/v1/analytics/revenue.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"revenue.mjs","sourceRoot":"","sources":["../../../src/resources/v1/analytics/revenue.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAKtB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAyB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,QAAQ,CACN,KAA4B,EAC5B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;CACF"}