zorihq 0.11.0 → 0.11.1

package/src/resources/v1/payment-providers.ts

@@ -1,230 +1,3 @@
 // 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';
-import { path } from '../../internal/utils/path';
-
-export class PaymentProviders extends APIResource {
-  /**
-   * Connect a new payment provider to a project
-   *
-   * @example
-   * ```ts
-   * const paymentProviderResponse =
-   *   await client.v1.paymentProviders.create({
-   *     api_key: 'sk_test_xxxxx',
-   *     project_id: '550e8400-e29b-41d4-a716-446655440000',
-   *     provider_type: 'stripe',
-   *     webhook_secret: 'whsec_xxxxx',
-   *   });
-   * ```
-   */
-  create(body: PaymentProviderCreateParams, options?: RequestOptions): APIPromise<PaymentProviderResponse> {
-    return this._client.post('/api/v1/payment-providers', { body, ...options });
-  }
-
-  /**
-   * Update payment provider credentials or settings
-   *
-   * @example
-   * ```ts
-   * const paymentProviderResponse =
-   *   await client.v1.paymentProviders.update('id');
-   * ```
-   */
-  update(
-    id: string,
-    body: PaymentProviderUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<PaymentProviderResponse> {
-    return this._client.put(path`/api/v1/payment-providers/${id}`, { body, ...options });
-  }
-
-  /**
-   * Get all payment providers for the organization
-   *
-   * @example
-   * ```ts
-   * const listPaymentProvidersResponse =
-   *   await client.v1.paymentProviders.list();
-   * ```
-   */
-  list(
-    query: PaymentProviderListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ListPaymentProvidersResponse> {
-    return this._client.get('/api/v1/payment-providers', { query, ...options });
-  }
-
-  /**
-   * Disconnect a payment provider from a project
-   *
-   * @example
-   * ```ts
-   * const paymentProvider =
-   *   await client.v1.paymentProviders.delete('id');
-   * ```
-   */
-  delete(id: string, options?: RequestOptions): APIPromise<PaymentProviderDeleteResponse> {
-    return this._client.delete(path`/api/v1/payment-providers/${id}`, options);
-  }
-
-  /**
-   * Get a single payment provider by ID
-   *
-   * @example
-   * ```ts
-   * const paymentProviderResponse =
-   *   await client.v1.paymentProviders.get('id');
-   * ```
-   */
-  get(id: string, options?: RequestOptions): APIPromise<PaymentProviderResponse> {
-    return this._client.get(path`/api/v1/payment-providers/${id}`, options);
-  }
-
-  /**
-   * Get instructions for connecting a payment provider (OAuth URL or manual
-   * credentials)
-   *
-   * @example
-   * ```ts
-   * const providerInstructionsResponse =
-   *   await client.v1.paymentProviders.instructions({
-   *     provider_type: 'stripe',
-   *   });
-   * ```
-   */
-  instructions(
-    query: PaymentProviderInstructionsParams,
-    options?: RequestOptions,
-  ): APIPromise<ProviderInstructionsResponse> {
-    return this._client.get('/api/v1/payment-providers/instructions', { query, ...options });
-  }
-}
-
-export interface CreatePaymentProviderRequest {
-  api_key: string;
-
-  project_id: string;
-
-  provider_type: 'stripe' | 'paddle' | 'paypal' | 'lemon_squeezy' | 'square';
-
-  webhook_secret: string;
-}
-
-export interface ListPaymentProvidersResponse {
-  providers?: Array<PaymentProviderResponse>;
-
-  total?: number;
-}
-
-export interface PaymentProviderResponse {
-  id?: string;
-
-  created_at?: string;
-
-  is_active?: boolean;
-
-  last_synced_at?: string;
-
-  organization_id?: string;
-
-  project_id?: string;
-
-  provider_type?: 'stripe' | 'paddle' | 'paypal' | 'lemon_squeezy' | 'square';
-
-  updated_at?: string;
-}
-
-export interface ProviderField {
-  help_text?: string;
-
-  label?: string;
-
-  name?: string;
-
-  placeholder?: string;
-
-  required?: boolean;
-
-  type?: string;
-}
-
-export interface ProviderInstructionsResponse {
-  /**
-   * "oauth" or "manual"
-   */
-  connection_method?: string;
-
-  fields?: Array<ProviderField>;
-
-  instructions?: string;
-
-  oauth_url?: string;
-
-  provider_type?: 'stripe' | 'paddle' | 'paypal' | 'lemon_squeezy' | 'square';
-}
-
-export interface UpdatePaymentProviderRequest {
-  api_key?: string;
-
-  is_active?: boolean;
-
-  webhook_secret?: string;
-}
-
-export type PaymentProviderDeleteResponse = { [key: string]: string };
-
-export interface PaymentProviderCreateParams {
-  api_key: string;
-
-  project_id: string;
-
-  provider_type: 'stripe' | 'paddle' | 'paypal' | 'lemon_squeezy' | 'square';
-
-  webhook_secret: string;
-}
-
-export interface PaymentProviderUpdateParams {
-  api_key?: string;
-
-  is_active?: boolean;
-
-  webhook_secret?: string;
-}
-
-export interface PaymentProviderListParams {
-  /**
-   * Filter by project ID
-   */
-  project_id?: string;
-}
-
-export interface PaymentProviderInstructionsParams {
-  /**
-   * Provider type
-   */
-  provider_type: 'stripe' | 'paddle' | 'paypal' | 'lemon_squeezy' | 'square';
-
-  /**
-   * Project ID (required for Stripe Connect)
-   */
-  project_id?: string;
-}
-
-export declare namespace PaymentProviders {
-  export {
-    type CreatePaymentProviderRequest as CreatePaymentProviderRequest,
-    type ListPaymentProvidersResponse as ListPaymentProvidersResponse,
-    type PaymentProviderResponse as PaymentProviderResponse,
-    type ProviderField as ProviderField,
-    type ProviderInstructionsResponse as ProviderInstructionsResponse,
-    type UpdatePaymentProviderRequest as UpdatePaymentProviderRequest,
-    type PaymentProviderDeleteResponse as PaymentProviderDeleteResponse,
-    type PaymentProviderCreateParams as PaymentProviderCreateParams,
-    type PaymentProviderUpdateParams as PaymentProviderUpdateParams,
-    type PaymentProviderListParams as PaymentProviderListParams,
-    type PaymentProviderInstructionsParams as PaymentProviderInstructionsParams,
-  };
-}
+export * from './payment-providers/index';

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

@@ -3,21 +3,6 @@
 import { APIResource } from '../../core/resource';
 import * as AuthAPI from './auth';
 import { Auth, AuthLoginParams, LoginRequest, LoginResponse } from './auth';
-import * as PaymentProvidersAPI from './payment-providers';
-import {
-  CreatePaymentProviderRequest,
-  ListPaymentProvidersResponse,
-  PaymentProviderCreateParams,
-  PaymentProviderDeleteResponse,
-  PaymentProviderInstructionsParams,
-  PaymentProviderListParams,
-  PaymentProviderResponse,
-  PaymentProviderUpdateParams,
-  PaymentProviders,
-  ProviderField,
-  ProviderInstructionsResponse,
-  UpdatePaymentProviderRequest,
-} from './payment-providers';
 import * as ProjectsAPI from './projects';
 import {
   CreateProjectRequest,
@@ -62,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,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.11.0'; // 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.11.0";
+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.11.0";
+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.11.0'; // 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.11.0'; // x-release-please-version
+export const VERSION = '0.11.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map