zorihq 0.1.0 → 0.3.0

package/resources/v1/v1.mjs

@@ -4,13 +4,17 @@ import * as AuthAPI from "./auth.mjs";
 import { Auth, } from "./auth.mjs";
 import * as ProjectsAPI from "./projects.mjs";
 import { Projects, } from "./projects.mjs";
+import * as AnalyticsAPI from "./analytics/analytics.mjs";
+import { Analytics, } from "./analytics/analytics.mjs";
 export class V1 extends APIResource {
     constructor() {
         super(...arguments);
+        this.analytics = new AnalyticsAPI.Analytics(this._client);
         this.projects = new ProjectsAPI.Projects(this._client);
         this.auth = new AuthAPI.Auth(this._client);
     }
 }
+V1.Analytics = Analytics;
 V1.Projects = Projects;
 V1.Auth = Auth;
 //# sourceMappingURL=v1.mjs.map

package/resources/v1/v1.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"v1.mjs","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,OAAO;OACZ,EAEL,IAAI,GAUL;OACM,KAAK,WAAW;OAChB,EAQL,QAAQ,GAET;AAED,MAAM,OAAO,EAAG,SAAQ,WAAW;IAAnC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;CAAA;AAED,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACvB,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC"}
+{"version":3,"file":"v1.mjs","sourceRoot":"","sources":["../../src/resources/v1/v1.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,OAAO;OACZ,EAEL,IAAI,GAUL;OACM,KAAK,WAAW;OAChB,EAQL,QAAQ,GAET;OACM,KAAK,YAAY;OACjB,EACL,SAAS,GAgBV;AAED,MAAM,OAAO,EAAG,SAAQ,WAAW;IAAnC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;CAAA;AAED,EAAE,CAAC,SAAS,GAAG,SAAS,CAAC;AACzB,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACvB,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC"}

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

@@ -0,0 +1,199 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as EventsAPI from './events';
+import { EventRecentParams, Events } from './events';
+import * as VisitorsAPI from './visitors';
+import {
+  VisitorByCountryParams,
+  VisitorByDeviceParams,
+  VisitorByOriginParams,
+  VisitorProfileParams,
+  VisitorTimelineParams,
+  VisitorTopParams,
+  Visitors,
+} from './visitors';
+
+export class Analytics extends APIResource {
+  visitors: VisitorsAPI.Visitors = new VisitorsAPI.Visitors(this._client);
+  events: EventsAPI.Events = new EventsAPI.Events(this._client);
+}
+
+export interface CountryDataPoint {
+  country_code?: string;
+
+  unique_visitors?: number;
+}
+
+export interface EventsOverTimeDataPoint {
+  event_count?: number;
+
+  timestamp?: string;
+}
+
+export interface OriginDataPoint {
+  origin?: string;
+
+  unique_visitors?: number;
+}
+
+export interface RecentEvent {
+  browser_name?: string;
+
+  client_timestamp_utc?: string;
+
+  device_type?: string;
+
+  event_name?: string;
+
+  location_city?: string;
+
+  location_country_iso?: string;
+
+  page_path?: string;
+
+  page_url?: string;
+
+  referrer_url?: string;
+
+  visitor_id?: string;
+}
+
+export interface RecentEventsResponse {
+  events?: Array<RecentEvent>;
+
+  total?: number;
+}
+
+export interface TopVisitor {
+  browser_name?: string;
+
+  device_type?: string;
+
+  event_count?: number;
+
+  first_seen?: string;
+
+  last_seen?: string;
+
+  location_city?: string;
+
+  location_country_iso?: string;
+
+  visitor_id?: string;
+}
+
+export interface TopVisitorsResponse {
+  total?: number;
+
+  visitors?: Array<TopVisitor>;
+}
+
+export interface UniqueVisitorsDataPoint {
+  desktop?: number;
+
+  mobile?: number;
+
+  timestamp?: string;
+}
+
+export interface UniqueVisitorsTimelineResponse {
+  data?: Array<UniqueVisitorsDataPoint>;
+}
+
+export interface VisitorDataPoint {
+  desktop?: number;
+
+  mobile?: number;
+
+  tablet?: number;
+
+  timestamp?: string;
+
+  unknown?: number;
+}
+
+export interface VisitorEvent {
+  browser_name?: string;
+
+  client_timestamp_utc?: string;
+
+  device_type?: string;
+
+  event_name?: string;
+
+  page_path?: string;
+
+  page_url?: string;
+
+  referrer_url?: string;
+}
+
+export interface VisitorProfileResponse {
+  events?: Array<VisitorEvent>;
+
+  events_over_time?: Array<EventsOverTimeDataPoint>;
+
+  first_referrer_url?: string;
+
+  first_seen?: string;
+
+  first_traffic_origin?: string;
+
+  last_seen?: string;
+
+  location_city?: string;
+
+  location_country_iso?: string;
+
+  total_events?: number;
+
+  visitor_id?: string;
+}
+
+export interface VisitorsByCountryResponse {
+  data?: Array<CountryDataPoint>;
+}
+
+export interface VisitorsByDeviceResponse {
+  data?: Array<VisitorDataPoint>;
+}
+
+export interface VisitorsByOriginResponse {
+  data?: Array<OriginDataPoint>;
+}
+
+Analytics.Visitors = Visitors;
+Analytics.Events = Events;
+
+export declare namespace Analytics {
+  export {
+    type CountryDataPoint as CountryDataPoint,
+    type EventsOverTimeDataPoint as EventsOverTimeDataPoint,
+    type OriginDataPoint as OriginDataPoint,
+    type RecentEvent as RecentEvent,
+    type RecentEventsResponse as RecentEventsResponse,
+    type TopVisitor as TopVisitor,
+    type TopVisitorsResponse as TopVisitorsResponse,
+    type UniqueVisitorsDataPoint as UniqueVisitorsDataPoint,
+    type UniqueVisitorsTimelineResponse as UniqueVisitorsTimelineResponse,
+    type VisitorDataPoint as VisitorDataPoint,
+    type VisitorEvent as VisitorEvent,
+    type VisitorProfileResponse as VisitorProfileResponse,
+    type VisitorsByCountryResponse as VisitorsByCountryResponse,
+    type VisitorsByDeviceResponse as VisitorsByDeviceResponse,
+    type VisitorsByOriginResponse as VisitorsByOriginResponse,
+  };
+
+  export {
+    Visitors as Visitors,
+    type VisitorByCountryParams as VisitorByCountryParams,
+    type VisitorByDeviceParams as VisitorByDeviceParams,
+    type VisitorByOriginParams as VisitorByOriginParams,
+    type VisitorProfileParams as VisitorProfileParams,
+    type VisitorTimelineParams as VisitorTimelineParams,
+    type VisitorTopParams as VisitorTopParams,
+  };
+
+  export { Events as Events, type EventRecentParams as EventRecentParams };
+}

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

@@ -0,0 +1,39 @@
+// 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 Events extends APIResource {
+  /**
+   * Get a list of the most recent events (default: 15 events)
+   *
+   * @example
+   * ```ts
+   * const recentEventsResponse =
+   *   await client.v1.analytics.events.recent({
+   *     project_id: 'project_id',
+   *   });
+   * ```
+   */
+  recent(query: EventRecentParams, options?: RequestOptions): APIPromise<AnalyticsAPI.RecentEventsResponse> {
+    return this._client.get('/api/v1/analytics/events/recent', { query, ...options });
+  }
+}
+
+export interface EventRecentParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Maximum number of events to return (default: 15)
+   */
+  limit?: number;
+}
+
+export declare namespace Events {
+  export { type EventRecentParams as EventRecentParams };
+}

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

@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Analytics,
+  type CountryDataPoint,
+  type EventsOverTimeDataPoint,
+  type OriginDataPoint,
+  type RecentEvent,
+  type RecentEventsResponse,
+  type TopVisitor,
+  type TopVisitorsResponse,
+  type UniqueVisitorsDataPoint,
+  type UniqueVisitorsTimelineResponse,
+  type VisitorDataPoint,
+  type VisitorEvent,
+  type VisitorProfileResponse,
+  type VisitorsByCountryResponse,
+  type VisitorsByDeviceResponse,
+  type VisitorsByOriginResponse,
+} from './analytics';
+export { Events, type EventRecentParams } from './events';
+export {
+  Visitors,
+  type VisitorByCountryParams,
+  type VisitorByDeviceParams,
+  type VisitorByOriginParams,
+  type VisitorProfileParams,
+  type VisitorTimelineParams,
+  type VisitorTopParams,
+} from './visitors';

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

@@ -0,0 +1,210 @@
+// 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 Visitors extends APIResource {
+  /**
+   * Get unique visitor counts grouped by country code
+   *
+   * @example
+   * ```ts
+   * const visitorsByCountryResponse =
+   *   await client.v1.analytics.visitors.byCountry({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  byCountry(
+    query: VisitorByCountryParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.VisitorsByCountryResponse> {
+    return this._client.get('/api/v1/analytics/visitors/country', { query, ...options });
+  }
+
+  /**
+   * Get visitor counts grouped by device type (mobile, desktop, tablet) over a
+   * specified time range
+   *
+   * @example
+   * ```ts
+   * const visitorsByDeviceResponse =
+   *   await client.v1.analytics.visitors.byDevice({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  byDevice(
+    query: VisitorByDeviceParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.VisitorsByDeviceResponse> {
+    return this._client.get('/api/v1/analytics/visitors/device', { query, ...options });
+  }
+
+  /**
+   * Get unique visitor counts grouped by referrer domain (traffic source)
+   *
+   * @example
+   * ```ts
+   * const visitorsByOriginResponse =
+   *   await client.v1.analytics.visitors.byOrigin({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  byOrigin(
+    query: VisitorByOriginParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.VisitorsByOriginResponse> {
+    return this._client.get('/api/v1/analytics/visitors/origin', { query, ...options });
+  }
+
+  /**
+   * Get detailed information about a specific visitor including their event history
+   * and aggregated statistics
+   *
+   * @example
+   * ```ts
+   * const visitorProfileResponse =
+   *   await client.v1.analytics.visitors.profile({
+   *     project_id: 'project_id',
+   *     visitor_id: 'visitor_id',
+   *   });
+   * ```
+   */
+  profile(
+    query: VisitorProfileParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.VisitorProfileResponse> {
+    return this._client.get('/api/v1/analytics/visitors/profile', { query, ...options });
+  }
+
+  /**
+   * Get unique visitor counts over time, split by mobile and desktop devices for
+   * chart visualization
+   *
+   * @example
+   * ```ts
+   * const uniqueVisitorsTimelineResponse =
+   *   await client.v1.analytics.visitors.timeline({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  timeline(
+    query: VisitorTimelineParams,
+    options?: RequestOptions,
+  ): APIPromise<AnalyticsAPI.UniqueVisitorsTimelineResponse> {
+    return this._client.get('/api/v1/analytics/visitors/timeline', { query, ...options });
+  }
+
+  /**
+   * Get a list of the most active visitors ranked by event count
+   *
+   * @example
+   * ```ts
+   * const topVisitorsResponse =
+   *   await client.v1.analytics.visitors.top({
+   *     project_id: 'project_id',
+   *     time_range: 'last_hour',
+   *   });
+   * ```
+   */
+  top(query: VisitorTopParams, options?: RequestOptions): APIPromise<AnalyticsAPI.TopVisitorsResponse> {
+    return this._client.get('/api/v1/analytics/visitors/top', { query, ...options });
+  }
+}
+
+export interface VisitorByCountryParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Time range
+   */
+  time_range: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+}
+
+export interface VisitorByDeviceParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Time range
+   */
+  time_range: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+}
+
+export interface VisitorByOriginParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Time range
+   */
+  time_range: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+}
+
+export interface VisitorProfileParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Visitor ID
+   */
+  visitor_id: string;
+}
+
+export interface VisitorTimelineParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Time range
+   */
+  time_range: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+}
+
+export interface VisitorTopParams {
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Time range
+   */
+  time_range: 'last_hour' | 'today' | 'last_7_days' | 'last_30_days' | 'last_90_days';
+
+  /**
+   * Maximum number of visitors to return (default: 50)
+   */
+  limit?: number;
+}
+
+export declare namespace Visitors {
+  export {
+    type VisitorByCountryParams as VisitorByCountryParams,
+    type VisitorByDeviceParams as VisitorByDeviceParams,
+    type VisitorByOriginParams as VisitorByOriginParams,
+    type VisitorProfileParams as VisitorProfileParams,
+    type VisitorTimelineParams as VisitorTimelineParams,
+    type VisitorTopParams as VisitorTopParams,
+  };
+}

package/src/resources/v1/analytics.ts

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

package/src/resources/v1/index.ts

@@ -1,5 +1,23 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Analytics,
+  type CountryDataPoint,
+  type EventsOverTimeDataPoint,
+  type OriginDataPoint,
+  type RecentEvent,
+  type RecentEventsResponse,
+  type TopVisitor,
+  type TopVisitorsResponse,
+  type UniqueVisitorsDataPoint,
+  type UniqueVisitorsTimelineResponse,
+  type VisitorDataPoint,
+  type VisitorEvent,
+  type VisitorProfileResponse,
+  type VisitorsByCountryResponse,
+  type VisitorsByDeviceResponse,
+  type VisitorsByOriginResponse,
+} from './analytics/index';
 export {
   Auth,
   type Account,

package/src/resources/v1/projects.ts

@@ -93,6 +93,8 @@ export interface Project {
 
   allow_local_host?: boolean;
 
+  created_at?: string;
+
   domain?: string;
 
   first_event_received_at?: string;
@@ -102,6 +104,10 @@ export interface Project {
   organization?: AuthAPI.Organization;
 
   organization_id?: string;
+
+  project_token?: string;
+
+  updated_at?: string;
 }
 
 export interface ProjectResponse {
@@ -109,6 +115,8 @@ export interface ProjectResponse {
 
   allow_local_host?: boolean;
 
+  created_at?: string;
+
   domain?: string;
 
   first_event_received_at?: string;
@@ -118,6 +126,10 @@ export interface ProjectResponse {
   organization?: AuthAPI.Organization;
 
   organization_id?: string;
+
+  project_token?: string;
+
+  updated_at?: string;
 }
 
 export interface UpdateProjectRequest {

package/src/resources/v1/v1.ts

@@ -27,16 +27,56 @@ import {
   Projects,
   UpdateProjectRequest,
 } from './projects';
+import * as AnalyticsAPI from './analytics/analytics';
+import {
+  Analytics,
+  CountryDataPoint,
+  EventsOverTimeDataPoint,
+  OriginDataPoint,
+  RecentEvent,
+  RecentEventsResponse,
+  TopVisitor,
+  TopVisitorsResponse,
+  UniqueVisitorsDataPoint,
+  UniqueVisitorsTimelineResponse,
+  VisitorDataPoint,
+  VisitorEvent,
+  VisitorProfileResponse,
+  VisitorsByCountryResponse,
+  VisitorsByDeviceResponse,
+  VisitorsByOriginResponse,
+} from './analytics/analytics';
 
 export class V1 extends APIResource {
+  analytics: AnalyticsAPI.Analytics = new AnalyticsAPI.Analytics(this._client);
   projects: ProjectsAPI.Projects = new ProjectsAPI.Projects(this._client);
   auth: AuthAPI.Auth = new AuthAPI.Auth(this._client);
 }
 
+V1.Analytics = Analytics;
 V1.Projects = Projects;
 V1.Auth = Auth;
 
 export declare namespace V1 {
+  export {
+    Analytics as Analytics,
+    type CountryDataPoint as CountryDataPoint,
+    type EventsOverTimeDataPoint as EventsOverTimeDataPoint,
+    type OriginDataPoint as OriginDataPoint,
+    type RecentEvent as RecentEvent,
+    type RecentEventsResponse as RecentEventsResponse,
+    type TopVisitor as TopVisitor,
+    type TopVisitorsResponse as TopVisitorsResponse,
+    type UniqueVisitorsDataPoint as UniqueVisitorsDataPoint,
+    type UniqueVisitorsTimelineResponse as UniqueVisitorsTimelineResponse,
+    type VisitorDataPoint as VisitorDataPoint,
+    type VisitorEvent as VisitorEvent,
+    type VisitorProfileResponse as VisitorProfileResponse,
+    type VisitorsByCountryResponse as VisitorsByCountryResponse,
+    type VisitorsByDeviceResponse as VisitorsByDeviceResponse,
+    type VisitorsByOriginResponse as VisitorsByOriginResponse,
+  };
+
   export {
     Projects as Projects,
     type CreateProjectRequest as CreateProjectRequest,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0'; // x-release-please-version
+export const VERSION = '0.3.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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