autumn-js 0.1.49 → 0.1.51-beta.0

package/dist/libraries/react/AutumnContext.js

@@ -475,6 +475,26 @@ var getFeature = async ({
   return instance.get(`/features/${id}`);
 };
 
+// src/sdk/events/eventMethods.ts
+var eventMethods = (instance) => {
+  return {
+    list: (params) => staticWrapper(handleEventList, instance, { params }),
+    aggregate: (params) => staticWrapper(handleEventAggregate, instance, { params })
+  };
+};
+var handleEventList = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/events/list", params);
+};
+var handleEventAggregate = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/events/aggregate", params);
+};
+
 // src/sdk/client.ts
 var LATEST_API_VERSION = "1.2";
 var Autumn = class {
@@ -535,11 +555,13 @@ var Autumn = class {
   static entities = entityMethods();
   static referrals = referralMethods();
   static features = featureMethods();
+  static events = eventMethods();
   customers = customerMethods(this);
   products = productMethods(this);
   entities = entityMethods(this);
   referrals = referralMethods(this);
   features = featureMethods(this);
+  events = eventMethods(this);
   /**
    * Initiates a checkout flow for a product purchase.
    * 
@@ -922,12 +944,6 @@ var CheckParamsSchema = import_v45.z.object({
   with_preview: import_v45.z.boolean().optional(),
   entity_data: EntityDataSchema.optional()
 });
-var QueryRangeEnum = import_v45.z.enum(["24h", "7d", "30d", "90d", "last_cycle"]);
-var QueryParamsSchema = import_v45.z.object({
-  customer_id: import_v45.z.string(),
-  feature_id: import_v45.z.string().or(import_v45.z.array(import_v45.z.string())),
-  range: QueryRangeEnum.optional()
-});
 
 // src/sdk/referrals/referralTypes.ts
 var import_v46 = require("zod/v4");
@@ -994,8 +1010,65 @@ var CheckoutParamsSchema = import_v47.z.object({
   new_billing_subscription: import_v47.z.boolean().optional()
 });
 
-// src/sdk/features/featureTypes.ts
+// src/sdk/general/cursorTypes.ts
 var import_v48 = require("zod/v4");
+var PaginationDefaults = {
+  Limit: 100,
+  MaxLimit: 1e3
+};
+var CursorPaginationQuerySchema = import_v48.z.object({
+  starting_after: import_v48.z.string().optional(),
+  limit: import_v48.z.coerce.number().int().min(1).max(PaginationDefaults.MaxLimit).default(PaginationDefaults.Limit).optional()
+});
+var createCursorPaginatedResponseSchema = (itemSchema) => import_v48.z.object({
+  list: import_v48.z.array(itemSchema),
+  has_more: import_v48.z.boolean(),
+  next_cursor: import_v48.z.string().nullable()
+});
+
+// src/sdk/events/eventTypes.ts
+var import_v49 = require("zod/v4");
+var QueryRangeEnum = import_v49.z.enum([
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "last_cycle",
+  "1bc",
+  "3bc"
+]);
+var BinSizeEnum = import_v49.z.enum(["day", "hour"]);
+var QueryParamsSchema = import_v49.z.object({
+  customer_id: import_v49.z.string(),
+  feature_id: import_v49.z.string().or(import_v49.z.array(import_v49.z.string())),
+  range: QueryRangeEnum.optional(),
+  group_by: import_v49.z.string().startsWith("properties.").optional(),
+  bin_size: BinSizeEnum.optional(),
+  custom_range: import_v49.z.object({
+    start: import_v49.z.number(),
+    end: import_v49.z.number()
+  }).optional()
+});
+var LogParamsSchema = CursorPaginationQuerySchema.extend({
+  customer_id: import_v49.z.string(),
+  feature_id: import_v49.z.string().or(import_v49.z.array(import_v49.z.string())),
+  time_range: import_v49.z.object({
+    start: import_v49.z.coerce.number().optional(),
+    end: import_v49.z.coerce.number().optional()
+  }).optional()
+});
+var EventLogSchema = import_v49.z.object({
+  id: import_v49.z.string().describe("Event ID (KSUID)"),
+  timestamp: import_v49.z.number().describe("Event timestamp (epoch milliseconds)"),
+  event_name: import_v49.z.string().describe("Name of the event"),
+  customer_id: import_v49.z.string().describe("Customer identifier"),
+  value: import_v49.z.number().describe("Event value/count"),
+  properties: import_v49.z.object({}).describe("Event properties (JSONB)")
+});
+var EventLogResponseSchema = createCursorPaginatedResponseSchema(EventLogSchema);
+
+// src/sdk/features/featureTypes.ts
+var import_v410 = require("zod/v4");
 var FeatureType = /* @__PURE__ */ ((FeatureType2) => {
   FeatureType2["Boolean"] = "boolean";
   FeatureType2["SingleUse"] = "single_use";
@@ -1003,21 +1076,21 @@ var FeatureType = /* @__PURE__ */ ((FeatureType2) => {
   FeatureType2["CreditSystem"] = "credit_system";
   return FeatureType2;
 })(FeatureType || {});
-var FeatureSchema = import_v48.z.object({
-  id: import_v48.z.string(),
-  name: import_v48.z.string(),
-  type: import_v48.z.enum(FeatureType),
-  display: import_v48.z.object({
-    singular: import_v48.z.string(),
-    plural: import_v48.z.string()
+var FeatureSchema = import_v410.z.object({
+  id: import_v410.z.string(),
+  name: import_v410.z.string(),
+  type: import_v410.z.enum(FeatureType),
+  display: import_v410.z.object({
+    singular: import_v410.z.string(),
+    plural: import_v410.z.string()
   }).nullish(),
-  credit_schema: import_v48.z.array(
-    import_v48.z.object({
-      metered_feature_id: import_v48.z.string(),
-      credit_cost: import_v48.z.number()
+  credit_schema: import_v410.z.array(
+    import_v410.z.object({
+      metered_feature_id: import_v410.z.string(),
+      credit_cost: import_v410.z.number()
     })
   ).nullish(),
-  archived: import_v48.z.boolean()
+  archived: import_v410.z.boolean()
 });
 
 // src/libraries/react/errorUtils/logFetchError.ts
@@ -1135,6 +1208,16 @@ async function redeemCode(params) {
   return res;
 }
 
+// src/libraries/react/client/clientAnalyticsMethods.ts
+async function eventListMethod(params) {
+  const res = await this.post(`${this.prefix}/events/list`, params);
+  return res;
+}
+async function eventAggregateMethod(params) {
+  const res = await this.post(`${this.prefix}/events/aggregate`, params);
+  return res;
+}
+
 // src/libraries/react/client/ReactAutumnClient.tsx
 var AutumnClient = class {
   backendUrl;
@@ -1334,6 +1417,10 @@ var AutumnClient = class {
   products = {
     list: listProductsMethod.bind(this)
   };
+  events = {
+    list: eventListMethod.bind(this),
+    aggregate: eventAggregateMethod.bind(this)
+  };
 };
 
 // src/libraries/react/AutumnContext.tsx

package/dist/libraries/react/AutumnContext.mjs

@@ -3,16 +3,17 @@
 import {
   AutumnContext,
   useAutumnContext
-} from "./chunk-QXNGODGB.mjs";
-import "./chunk-OX6N6HG4.mjs";
+} from "./chunk-MMQEFIIA.mjs";
+import "./chunk-CW2P27OH.mjs";
+import "./chunk-OYBOLAL5.mjs";
 import "./chunk-3HZWPY3Y.mjs";
 import "./chunk-V575SGOW.mjs";
 import "./chunk-SUENW2KS.mjs";
 import "./chunk-JVCOY7ZL.mjs";
 import "./chunk-CIBQ4BJU.mjs";
-import "./chunk-B6C26BAU.mjs";
+import "./chunk-DGAVISJ7.mjs";
+import "./chunk-XDQLJ7QR.mjs";
 import "./chunk-WFFVOEUG.mjs";
-import "./chunk-OYBOLAL5.mjs";
 export {
   AutumnContext,
   useAutumnContext

package/dist/libraries/react/BaseAutumnProvider.d.mts

@@ -1,12 +1,13 @@
 import React__default from 'react';
-import { I as IAutumnClient } from './ReactAutumnClient-BFsdUmZR.mjs';
+import { I as IAutumnClient } from './ReactAutumnClient-BRRv7HFB.mjs';
 import './error-DHbclCVh.mjs';
-import './genTypes-B5_6Pu_4.mjs';
-import './prodTypes-C4aZSZfO.mjs';
+import './entTypes-DnM96qsh.mjs';
+import './prodTypes-DVvNGoR7.mjs';
 import 'zod/v4';
-import './attachTypes-BNlJ6XXa.mjs';
-import './cusTypes-RU0fmR-t.mjs';
-import './entTypes-SfJb3hb2.mjs';
+import './cusTypes-BugnOlMR.mjs';
+import './attachTypes-BHC3WC5D.mjs';
+import './eventTypes-MwzIb0X5.mjs';
+import './client/types/clientAnalyticsTypes.mjs';
 
 declare function BaseAutumnProvider({ client, children, AutumnContext, }: {
     client: IAutumnClient;

package/dist/libraries/react/BaseAutumnProvider.d.ts

@@ -1,12 +1,13 @@
 import React__default from 'react';
-import { I as IAutumnClient } from './ReactAutumnClient-C2DYluBM.js';
+import { I as IAutumnClient } from './ReactAutumnClient-Dvb5n8ps.js';
 import './error-DHbclCVh.js';
-import './genTypes-CY6GNiAn.js';
-import './prodTypes-C4aZSZfO.js';
+import './entTypes-Dk2qzC19.js';
+import './prodTypes-DVvNGoR7.js';
 import 'zod/v4';
-import './attachTypes-eg914-6v.js';
-import './cusTypes-D3QQXjif.js';
-import './entTypes-CiODXSok.js';
+import './cusTypes-DjKY5YzO.js';
+import './attachTypes-YaaK-7xS.js';
+import './eventTypes-MwzIb0X5.js';
+import './client/types/clientAnalyticsTypes.js';
 
 declare function BaseAutumnProvider({ client, children, AutumnContext, }: {
     client: IAutumnClient;

package/dist/libraries/react/BaseAutumnProvider.js

@@ -479,6 +479,26 @@ var getFeature = async ({
   return instance.get(`/features/${id}`);
 };
 
+// src/sdk/events/eventMethods.ts
+var eventMethods = (instance) => {
+  return {
+    list: (params) => staticWrapper(handleEventList, instance, { params }),
+    aggregate: (params) => staticWrapper(handleEventAggregate, instance, { params })
+  };
+};
+var handleEventList = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/events/list", params);
+};
+var handleEventAggregate = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/events/aggregate", params);
+};
+
 // src/sdk/client.ts
 var LATEST_API_VERSION = "1.2";
 var Autumn = class {
@@ -539,11 +559,13 @@ var Autumn = class {
   static entities = entityMethods();
   static referrals = referralMethods();
   static features = featureMethods();
+  static events = eventMethods();
   customers = customerMethods(this);
   products = productMethods(this);
   entities = entityMethods(this);
   referrals = referralMethods(this);
   features = featureMethods(this);
+  events = eventMethods(this);
   /**
    * Initiates a checkout flow for a product purchase.
    * 
@@ -926,12 +948,6 @@ var CheckParamsSchema = import_v45.z.object({
   with_preview: import_v45.z.boolean().optional(),
   entity_data: EntityDataSchema.optional()
 });
-var QueryRangeEnum = import_v45.z.enum(["24h", "7d", "30d", "90d", "last_cycle"]);
-var QueryParamsSchema = import_v45.z.object({
-  customer_id: import_v45.z.string(),
-  feature_id: import_v45.z.string().or(import_v45.z.array(import_v45.z.string())),
-  range: QueryRangeEnum.optional()
-});
 
 // src/sdk/referrals/referralTypes.ts
 var import_v46 = require("zod/v4");
@@ -998,8 +1014,65 @@ var CheckoutParamsSchema = import_v47.z.object({
   new_billing_subscription: import_v47.z.boolean().optional()
 });
 
-// src/sdk/features/featureTypes.ts
+// src/sdk/general/cursorTypes.ts
 var import_v48 = require("zod/v4");
+var PaginationDefaults = {
+  Limit: 100,
+  MaxLimit: 1e3
+};
+var CursorPaginationQuerySchema = import_v48.z.object({
+  starting_after: import_v48.z.string().optional(),
+  limit: import_v48.z.coerce.number().int().min(1).max(PaginationDefaults.MaxLimit).default(PaginationDefaults.Limit).optional()
+});
+var createCursorPaginatedResponseSchema = (itemSchema) => import_v48.z.object({
+  list: import_v48.z.array(itemSchema),
+  has_more: import_v48.z.boolean(),
+  next_cursor: import_v48.z.string().nullable()
+});
+
+// src/sdk/events/eventTypes.ts
+var import_v49 = require("zod/v4");
+var QueryRangeEnum = import_v49.z.enum([
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "last_cycle",
+  "1bc",
+  "3bc"
+]);
+var BinSizeEnum = import_v49.z.enum(["day", "hour"]);
+var QueryParamsSchema = import_v49.z.object({
+  customer_id: import_v49.z.string(),
+  feature_id: import_v49.z.string().or(import_v49.z.array(import_v49.z.string())),
+  range: QueryRangeEnum.optional(),
+  group_by: import_v49.z.string().startsWith("properties.").optional(),
+  bin_size: BinSizeEnum.optional(),
+  custom_range: import_v49.z.object({
+    start: import_v49.z.number(),
+    end: import_v49.z.number()
+  }).optional()
+});
+var LogParamsSchema = CursorPaginationQuerySchema.extend({
+  customer_id: import_v49.z.string(),
+  feature_id: import_v49.z.string().or(import_v49.z.array(import_v49.z.string())),
+  time_range: import_v49.z.object({
+    start: import_v49.z.coerce.number().optional(),
+    end: import_v49.z.coerce.number().optional()
+  }).optional()
+});
+var EventLogSchema = import_v49.z.object({
+  id: import_v49.z.string().describe("Event ID (KSUID)"),
+  timestamp: import_v49.z.number().describe("Event timestamp (epoch milliseconds)"),
+  event_name: import_v49.z.string().describe("Name of the event"),
+  customer_id: import_v49.z.string().describe("Customer identifier"),
+  value: import_v49.z.number().describe("Event value/count"),
+  properties: import_v49.z.object({}).describe("Event properties (JSONB)")
+});
+var EventLogResponseSchema = createCursorPaginatedResponseSchema(EventLogSchema);
+
+// src/sdk/features/featureTypes.ts
+var import_v410 = require("zod/v4");
 var FeatureType = /* @__PURE__ */ ((FeatureType2) => {
   FeatureType2["Boolean"] = "boolean";
   FeatureType2["SingleUse"] = "single_use";
@@ -1007,21 +1080,21 @@ var FeatureType = /* @__PURE__ */ ((FeatureType2) => {
   FeatureType2["CreditSystem"] = "credit_system";
   return FeatureType2;
 })(FeatureType || {});
-var FeatureSchema = import_v48.z.object({
-  id: import_v48.z.string(),
-  name: import_v48.z.string(),
-  type: import_v48.z.enum(FeatureType),
-  display: import_v48.z.object({
-    singular: import_v48.z.string(),
-    plural: import_v48.z.string()
+var FeatureSchema = import_v410.z.object({
+  id: import_v410.z.string(),
+  name: import_v410.z.string(),
+  type: import_v410.z.enum(FeatureType),
+  display: import_v410.z.object({
+    singular: import_v410.z.string(),
+    plural: import_v410.z.string()
   }).nullish(),
-  credit_schema: import_v48.z.array(
-    import_v48.z.object({
-      metered_feature_id: import_v48.z.string(),
-      credit_cost: import_v48.z.number()
+  credit_schema: import_v410.z.array(
+    import_v410.z.object({
+      metered_feature_id: import_v410.z.string(),
+      credit_cost: import_v410.z.number()
     })
   ).nullish(),
-  archived: import_v48.z.boolean()
+  archived: import_v410.z.boolean()
 });
 
 // src/libraries/react/hooks/helpers/handleCheck.ts
@@ -1302,6 +1375,16 @@ async function redeemCode(params) {
   return res;
 }
 
+// src/libraries/react/client/clientAnalyticsMethods.ts
+async function eventListMethod(params) {
+  const res = await this.post(`${this.prefix}/events/list`, params);
+  return res;
+}
+async function eventAggregateMethod(params) {
+  const res = await this.post(`${this.prefix}/events/aggregate`, params);
+  return res;
+}
+
 // src/libraries/react/client/ReactAutumnClient.tsx
 var AutumnClient = class {
   backendUrl;
@@ -1501,6 +1584,10 @@ var AutumnClient = class {
   products = {
     list: listProductsMethod.bind(this)
   };
+  events = {
+    list: eventListMethod.bind(this),
+    aggregate: eventAggregateMethod.bind(this)
+  };
 };
 
 // src/libraries/react/AutumnContext.tsx
@@ -1905,7 +1992,7 @@ var useCustomerBase = ({
     client = context.client;
   }
   const baseUrl = client?.backendUrl || "";
-  const queryKey = ["customer", baseUrl, params?.expand];
+  const queryKey = ["customer", baseUrl, params?.expand, ...params?.extraQueryKeys || []];
   const fetchCustomer = async () => {
     const { data, error: error2 } = await client.createCustomer({
       errorOnNotFound: params?.errorOnNotFound,

package/dist/libraries/react/BaseAutumnProvider.mjs

@@ -3,22 +3,23 @@
 "use client";
 import {
   BaseAutumnProvider
-} from "./chunk-VLUYKW5V.mjs";
+} from "./chunk-AH5UXJQR.mjs";
 import "./chunk-RFSQBGLO.mjs";
-import "./chunk-DQYNN6TC.mjs";
-import "./chunk-L47NULL3.mjs";
-import "./chunk-CKJ75O47.mjs";
-import "./chunk-VWRMGYHF.mjs";
-import "./chunk-QXNGODGB.mjs";
-import "./chunk-OX6N6HG4.mjs";
+import "./chunk-YVLVYSSI.mjs";
+import "./chunk-6DWDNMEZ.mjs";
+import "./chunk-RV2GW3AO.mjs";
+import "./chunk-SJ2WHSCW.mjs";
+import "./chunk-MMQEFIIA.mjs";
+import "./chunk-CW2P27OH.mjs";
+import "./chunk-OYBOLAL5.mjs";
 import "./chunk-3HZWPY3Y.mjs";
 import "./chunk-V575SGOW.mjs";
 import "./chunk-SUENW2KS.mjs";
 import "./chunk-JVCOY7ZL.mjs";
 import "./chunk-CIBQ4BJU.mjs";
-import "./chunk-B6C26BAU.mjs";
+import "./chunk-DGAVISJ7.mjs";
+import "./chunk-XDQLJ7QR.mjs";
 import "./chunk-WFFVOEUG.mjs";
-import "./chunk-OYBOLAL5.mjs";
 export {
   BaseAutumnProvider
 };

package/dist/libraries/react/{ReactAutumnClient-BFsdUmZR.d.mts → ReactAutumnClient-BRRv7HFB.d.mts}

@@ -1,9 +1,10 @@
 import { A as AutumnError } from './error-DHbclCVh.mjs';
-import { a as CheckResult, S as SetupPaymentResult, Q as QueryResult } from './genTypes-B5_6Pu_4.mjs';
-import { C as CheckoutResult } from './attachTypes-BNlJ6XXa.mjs';
-import { P as Product } from './prodTypes-C4aZSZfO.mjs';
-import { C as CustomerData, a as CreateCustomerParams, b as Customer, B as BillingPortalResult } from './cusTypes-RU0fmR-t.mjs';
-import { E as Entity, D as DeleteEntityResult } from './entTypes-SfJb3hb2.mjs';
+import { a as CheckResult, S as SetupPaymentResult, E as Entity, D as DeleteEntityResult } from './entTypes-DnM96qsh.mjs';
+import { C as CheckoutResult } from './attachTypes-BHC3WC5D.mjs';
+import { Q as QueryResult } from './eventTypes-MwzIb0X5.mjs';
+import { P as Product } from './prodTypes-DVvNGoR7.mjs';
+import { C as CustomerData, a as CreateCustomerParams, b as Customer, B as BillingPortalResult } from './cusTypes-BugnOlMR.mjs';
+import { EventListParams, EventListResponse, EventAggregationParams, EventAggregationResponse } from './client/types/clientAnalyticsTypes.mjs';
 
 type Success<T> = {
     data: T;
@@ -93,6 +94,10 @@ interface IAutumnClient {
             list: Product[];
         }>;
     };
+    events: {
+        list(params: EventListParams): AutumnPromise<EventListResponse>;
+        aggregate(params: EventAggregationParams): AutumnPromise<EventAggregationResponse>;
+    };
 }
 declare class AutumnClient implements IAutumnClient {
     readonly backendUrl?: string;
@@ -227,7 +232,7 @@ declare class AutumnClient implements IAutumnClient {
     }) => AutumnPromise<SetupPaymentResult>;
     query: (params: {
         featureId: string | string[];
-        range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | undefined;
+        range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | "1bc" | "3bc" | undefined;
     }) => AutumnPromise<QueryResult>;
     entities: {
         create: (params: {
@@ -257,6 +262,40 @@ declare class AutumnClient implements IAutumnClient {
             list: Product[];
         }>;
     };
+    events: {
+        list: (params: {
+            customer_id: string;
+            feature_id: string | string[];
+            starting_after?: string | undefined;
+            limit?: number | undefined;
+            time_range?: {
+                start?: number | undefined;
+                end?: number | undefined;
+            } | undefined;
+        }) => AutumnPromise<{
+            list: {
+                id: string;
+                timestamp: number;
+                event_name: string;
+                customer_id: string;
+                value: number;
+                properties: Record<string, never>;
+            }[];
+            has_more: boolean;
+            next_cursor: string | null;
+        }>;
+        aggregate: (params: {
+            customer_id: string;
+            feature_id: string | string[];
+            bin_size: "day" | "hour";
+            group_by?: string | undefined;
+            range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | "1bc" | "3bc" | undefined;
+            custom_range?: {
+                start: number;
+                end: number;
+            } | undefined;
+        }) => AutumnPromise<EventAggregationResponse>;
+    };
 }
 
 export { AutumnClient as A, type CreateReferralCodeResult as C, type ErrorResponse as E, type IAutumnClient as I, type OmitCustomerType as O, type RedeemReferralCodeResult as R, type Success as S, type AutumnPromise as a, type AutumnClientConfig as b };

package/dist/libraries/react/{ReactAutumnClient-C2DYluBM.d.ts → ReactAutumnClient-Dvb5n8ps.d.ts}

@@ -1,9 +1,10 @@
 import { A as AutumnError } from './error-DHbclCVh.js';
-import { a as CheckResult, S as SetupPaymentResult, Q as QueryResult } from './genTypes-CY6GNiAn.js';
-import { C as CheckoutResult } from './attachTypes-eg914-6v.js';
-import { P as Product } from './prodTypes-C4aZSZfO.js';
-import { C as CustomerData, a as CreateCustomerParams, b as Customer, B as BillingPortalResult } from './cusTypes-D3QQXjif.js';
-import { E as Entity, D as DeleteEntityResult } from './entTypes-CiODXSok.js';
+import { a as CheckResult, S as SetupPaymentResult, E as Entity, D as DeleteEntityResult } from './entTypes-Dk2qzC19.js';
+import { C as CheckoutResult } from './attachTypes-YaaK-7xS.js';
+import { Q as QueryResult } from './eventTypes-MwzIb0X5.js';
+import { P as Product } from './prodTypes-DVvNGoR7.js';
+import { C as CustomerData, a as CreateCustomerParams, b as Customer, B as BillingPortalResult } from './cusTypes-DjKY5YzO.js';
+import { EventListParams, EventListResponse, EventAggregationParams, EventAggregationResponse } from './client/types/clientAnalyticsTypes.js';
 
 type Success<T> = {
     data: T;
@@ -93,6 +94,10 @@ interface IAutumnClient {
             list: Product[];
         }>;
     };
+    events: {
+        list(params: EventListParams): AutumnPromise<EventListResponse>;
+        aggregate(params: EventAggregationParams): AutumnPromise<EventAggregationResponse>;
+    };
 }
 declare class AutumnClient implements IAutumnClient {
     readonly backendUrl?: string;
@@ -227,7 +232,7 @@ declare class AutumnClient implements IAutumnClient {
     }) => AutumnPromise<SetupPaymentResult>;
     query: (params: {
         featureId: string | string[];
-        range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | undefined;
+        range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | "1bc" | "3bc" | undefined;
     }) => AutumnPromise<QueryResult>;
     entities: {
         create: (params: {
@@ -257,6 +262,40 @@ declare class AutumnClient implements IAutumnClient {
             list: Product[];
         }>;
     };
+    events: {
+        list: (params: {
+            customer_id: string;
+            feature_id: string | string[];
+            starting_after?: string | undefined;
+            limit?: number | undefined;
+            time_range?: {
+                start?: number | undefined;
+                end?: number | undefined;
+            } | undefined;
+        }) => AutumnPromise<{
+            list: {
+                id: string;
+                timestamp: number;
+                event_name: string;
+                customer_id: string;
+                value: number;
+                properties: Record<string, never>;
+            }[];
+            has_more: boolean;
+            next_cursor: string | null;
+        }>;
+        aggregate: (params: {
+            customer_id: string;
+            feature_id: string | string[];
+            bin_size: "day" | "hour";
+            group_by?: string | undefined;
+            range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | "1bc" | "3bc" | undefined;
+            custom_range?: {
+                start: number;
+                end: number;
+            } | undefined;
+        }) => AutumnPromise<EventAggregationResponse>;
+    };
 }
 
 export { AutumnClient as A, type CreateReferralCodeResult as C, type ErrorResponse as E, type IAutumnClient as I, type OmitCustomerType as O, type RedeemReferralCodeResult as R, type Success as S, type AutumnPromise as a, type AutumnClientConfig as b };

package/dist/libraries/react/ReactAutumnProvider.d.mts

@@ -1,6 +1,6 @@
-import { C as CustomerData } from './cusTypes-RU0fmR-t.mjs';
+import { C as CustomerData } from './cusTypes-BugnOlMR.mjs';
 import React__default from 'react';
-import './prodTypes-C4aZSZfO.mjs';
+import './prodTypes-DVvNGoR7.mjs';
 import 'zod/v4';
 
 declare const ReactAutumnProvider: ({ children, getBearerToken, convex, backendUrl, customerData, includeCredentials, betterAuthUrl, headers, convexApi, pathPrefix, }: {

package/dist/libraries/react/ReactAutumnProvider.d.ts

@@ -1,6 +1,6 @@
-import { C as CustomerData } from './cusTypes-D3QQXjif.js';
+import { C as CustomerData } from './cusTypes-DjKY5YzO.js';
 import React__default from 'react';
-import './prodTypes-C4aZSZfO.js';
+import './prodTypes-DVvNGoR7.js';
 import 'zod/v4';
 
 declare const ReactAutumnProvider: ({ children, getBearerToken, convex, backendUrl, customerData, includeCredentials, betterAuthUrl, headers, convexApi, pathPrefix, }: {