autumn-js 0.1.49 → 0.1.51-beta.0

package/dist/libraries/backend/next.js

@@ -33,7 +33,7 @@ __export(next_exports, {
   autumnHandler: () => autumnHandler
 });
 module.exports = __toCommonJS(next_exports);
-var import_rou36 = require("rou3");
+var import_rou37 = require("rou3");
 
 // src/sdk/error.ts
 var AutumnError = class _AutumnError extends Error {
@@ -458,6 +458,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 {
@@ -518,11 +538,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.
    * 
@@ -905,12 +927,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/components/componentMethods.ts
 var fetchPricingTable = async ({
@@ -1001,8 +1017,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";
@@ -1010,21 +1083,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/backend/next.ts
@@ -1294,7 +1367,7 @@ var addGenRoutes = (router) => {
 };
 
 // src/libraries/backend/routes/backendRouter.ts
-var import_rou35 = require("rou3");
+var import_rou36 = require("rou3");
 
 // src/libraries/backend/routes/entityRoutes.ts
 var import_rou32 = require("rou3");
@@ -1422,6 +1495,47 @@ var addProductRoutes = async (router) => {
   });
 };
 
+// src/libraries/backend/routes/analyticsRoutes.ts
+var import_rou35 = require("rou3");
+var sanitizeBody2 = (body) => {
+  const bodyCopy = { ...body };
+  delete bodyCopy.customer_id;
+  delete bodyCopy.customer_data;
+  return bodyCopy;
+};
+var listEventsHandler = withAuth({
+  fn: async ({
+    autumn,
+    customer_id,
+    body
+  }) => {
+    return await autumn.events.list({
+      ...sanitizeBody2(body),
+      customer_id
+    });
+  }
+});
+var aggregateEventsHandler = withAuth({
+  fn: async ({
+    autumn,
+    customer_id,
+    body
+  }) => {
+    return await autumn.events.aggregate({
+      ...sanitizeBody2(body),
+      customer_id
+    });
+  }
+});
+var addAnalyticsRoutes = (router) => {
+  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/events/list`, {
+    handler: listEventsHandler
+  });
+  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/events/aggregate`, {
+    handler: aggregateEventsHandler
+  });
+};
+
 // src/libraries/backend/routes/backendRouter.ts
 var sanitizeCustomerBody = (body) => {
   let bodyCopy = { ...body };
@@ -1460,8 +1574,8 @@ var getPricingTableHandler = withAuth({
   requireCustomer: false
 });
 var createRouterWithOptions = () => {
-  const router = (0, import_rou35.createRouter)();
-  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/cors`, {
+  const router = (0, import_rou36.createRouter)();
+  (0, import_rou36.addRoute)(router, "POST", `${BASE_PATH}/cors`, {
     handler: () => {
       return {
         body: {
@@ -1471,10 +1585,10 @@ var createRouterWithOptions = () => {
       };
     }
   });
-  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/customers`, {
+  (0, import_rou36.addRoute)(router, "POST", `${BASE_PATH}/customers`, {
     handler: createCustomerHandler
   });
-  (0, import_rou35.addRoute)(router, "GET", `${BASE_PATH}/components/pricing_table`, {
+  (0, import_rou36.addRoute)(router, "GET", `${BASE_PATH}/components/pricing_table`, {
     handler: getPricingTableHandler,
     requireCustomer: false
   });
@@ -1482,6 +1596,7 @@ var createRouterWithOptions = () => {
   addEntityRoutes(router);
   addReferralRoutes(router);
   addProductRoutes(router);
+  addAnalyticsRoutes(router);
   return router;
 };
 
@@ -1533,7 +1648,7 @@ function autumnHandler(options) {
     }
     const searchParams = Object.fromEntries(url.searchParams);
     const pathname = url.pathname;
-    const match = (0, import_rou36.findRoute)(router, method, pathname);
+    const match = (0, import_rou37.findRoute)(router, method, pathname);
     if (!match) {
       if (isPagesRouter) {
         return response.status(404).json({ error: "Not found" });

package/dist/libraries/backend/next.mjs

@@ -3,15 +3,16 @@ import {
 } from "./chunk-UNZHJTEY.mjs";
 import {
   createRouterWithOptions
-} from "./chunk-AVZDE6BQ.mjs";
-import "./chunk-M4JDQD3E.mjs";
-import "./chunk-S3DYAAI4.mjs";
-import "./chunk-KQFBSKKB.mjs";
-import "./chunk-GUWG5XU3.mjs";
-import "./chunk-JYK2MUUW.mjs";
+} from "./chunk-LSUV3XYF.mjs";
+import "./chunk-IIBWHZIF.mjs";
+import "./chunk-XUDFX2TX.mjs";
+import "./chunk-6KBN5J3Q.mjs";
+import "./chunk-7J2QIGRJ.mjs";
+import "./chunk-XNHNC4PS.mjs";
+import "./chunk-LOGELPCS.mjs";
 import {
   Autumn
-} from "./chunk-2ACQRE64.mjs";
+} from "./chunk-SXD4RGCT.mjs";
 import "./chunk-2TEL6LR5.mjs";
 import {
   autumnApiUrl

package/dist/libraries/backend/react-router.js

@@ -33,7 +33,7 @@ __export(react_router_exports, {
   autumnHandler: () => autumnHandler
 });
 module.exports = __toCommonJS(react_router_exports);
-var import_rou36 = require("rou3");
+var import_rou37 = require("rou3");
 
 // src/sdk/error.ts
 var AutumnError = class _AutumnError extends Error {
@@ -458,6 +458,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 {
@@ -518,11 +538,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.
    * 
@@ -905,12 +927,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/components/componentMethods.ts
 var fetchPricingTable = async ({
@@ -1001,8 +1017,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";
@@ -1010,21 +1083,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/backend/utils/backendRes.ts
@@ -1291,7 +1364,7 @@ var addGenRoutes = (router) => {
 };
 
 // src/libraries/backend/routes/backendRouter.ts
-var import_rou35 = require("rou3");
+var import_rou36 = require("rou3");
 
 // src/libraries/backend/routes/entityRoutes.ts
 var import_rou32 = require("rou3");
@@ -1419,6 +1492,47 @@ var addProductRoutes = async (router) => {
   });
 };
 
+// src/libraries/backend/routes/analyticsRoutes.ts
+var import_rou35 = require("rou3");
+var sanitizeBody2 = (body) => {
+  const bodyCopy = { ...body };
+  delete bodyCopy.customer_id;
+  delete bodyCopy.customer_data;
+  return bodyCopy;
+};
+var listEventsHandler = withAuth({
+  fn: async ({
+    autumn,
+    customer_id,
+    body
+  }) => {
+    return await autumn.events.list({
+      ...sanitizeBody2(body),
+      customer_id
+    });
+  }
+});
+var aggregateEventsHandler = withAuth({
+  fn: async ({
+    autumn,
+    customer_id,
+    body
+  }) => {
+    return await autumn.events.aggregate({
+      ...sanitizeBody2(body),
+      customer_id
+    });
+  }
+});
+var addAnalyticsRoutes = (router) => {
+  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/events/list`, {
+    handler: listEventsHandler
+  });
+  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/events/aggregate`, {
+    handler: aggregateEventsHandler
+  });
+};
+
 // src/libraries/backend/routes/backendRouter.ts
 var sanitizeCustomerBody = (body) => {
   let bodyCopy = { ...body };
@@ -1457,8 +1571,8 @@ var getPricingTableHandler = withAuth({
   requireCustomer: false
 });
 var createRouterWithOptions = () => {
-  const router = (0, import_rou35.createRouter)();
-  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/cors`, {
+  const router = (0, import_rou36.createRouter)();
+  (0, import_rou36.addRoute)(router, "POST", `${BASE_PATH}/cors`, {
     handler: () => {
       return {
         body: {
@@ -1468,10 +1582,10 @@ var createRouterWithOptions = () => {
       };
     }
   });
-  (0, import_rou35.addRoute)(router, "POST", `${BASE_PATH}/customers`, {
+  (0, import_rou36.addRoute)(router, "POST", `${BASE_PATH}/customers`, {
     handler: createCustomerHandler
   });
-  (0, import_rou35.addRoute)(router, "GET", `${BASE_PATH}/components/pricing_table`, {
+  (0, import_rou36.addRoute)(router, "GET", `${BASE_PATH}/components/pricing_table`, {
     handler: getPricingTableHandler,
     requireCustomer: false
   });
@@ -1479,6 +1593,7 @@ var createRouterWithOptions = () => {
   addEntityRoutes(router);
   addReferralRoutes(router);
   addProductRoutes(router);
+  addAnalyticsRoutes(router);
   return router;
 };
 
@@ -1515,7 +1630,7 @@ function autumnHandler(options) {
     const url = new URL(args.request.url);
     const searchParams = Object.fromEntries(url.searchParams);
     const pathname = url.pathname;
-    const match = (0, import_rou36.findRoute)(router, method, pathname);
+    const match = (0, import_rou37.findRoute)(router, method, pathname);
     if (!match) {
       throw new Response("Not found", { status: 404 });
     }

package/dist/libraries/backend/react-router.mjs

@@ -3,15 +3,16 @@ import {
 } from "./chunk-UNZHJTEY.mjs";
 import {
   createRouterWithOptions
-} from "./chunk-AVZDE6BQ.mjs";
-import "./chunk-M4JDQD3E.mjs";
-import "./chunk-S3DYAAI4.mjs";
-import "./chunk-KQFBSKKB.mjs";
-import "./chunk-GUWG5XU3.mjs";
-import "./chunk-JYK2MUUW.mjs";
+} from "./chunk-LSUV3XYF.mjs";
+import "./chunk-IIBWHZIF.mjs";
+import "./chunk-XUDFX2TX.mjs";
+import "./chunk-6KBN5J3Q.mjs";
+import "./chunk-7J2QIGRJ.mjs";
+import "./chunk-XNHNC4PS.mjs";
+import "./chunk-LOGELPCS.mjs";
 import {
   Autumn
-} from "./chunk-2ACQRE64.mjs";
+} from "./chunk-SXD4RGCT.mjs";
 import "./chunk-2TEL6LR5.mjs";
 import {
   autumnApiUrl

package/dist/libraries/backend/{referralTypes-F3k5nHMu.d.ts → referralTypes-BZPktYsA.d.ts}

@@ -380,25 +380,6 @@ interface SetupPaymentResult {
     customer_id: string;
     url: string;
 }
-declare const QueryParamsSchema: z.ZodObject<{
-    customer_id: z.ZodString;
-    feature_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>;
-    range: z.ZodOptional<z.ZodEnum<{
-        "24h": "24h";
-        "7d": "7d";
-        "30d": "30d";
-        "90d": "90d";
-        last_cycle: "last_cycle";
-    }>>;
-}, z.core.$strip>;
-type QueryParams = z.infer<typeof QueryParamsSchema>;
-type QueryResult = {
-    list: Array<{
-        period: number;
-    } & {
-        [key: string]: number;
-    }>;
-};
 
 declare const AttachFeatureOptionsSchema: z.ZodObject<{
     feature_id: z.ZodString;
@@ -474,6 +455,48 @@ type CheckoutResult = {
     };
 };
 
+declare const QueryParamsSchema: z.ZodObject<{
+    customer_id: z.ZodString;
+    feature_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>;
+    range: z.ZodOptional<z.ZodEnum<{
+        "24h": "24h";
+        "7d": "7d";
+        "30d": "30d";
+        "90d": "90d";
+        last_cycle: "last_cycle";
+        "1bc": "1bc";
+        "3bc": "3bc";
+    }>>;
+    group_by: z.ZodOptional<z.ZodString>;
+    bin_size: z.ZodOptional<z.ZodEnum<{
+        day: "day";
+        hour: "hour";
+    }>>;
+    custom_range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type QueryParams = z.infer<typeof QueryParamsSchema>;
+type QueryResult = {
+    list: Array<{
+        period: number;
+    } & {
+        [key: string]: number | Record<string, number>;
+    }>;
+};
+declare const LogParamsSchema: z.ZodObject<{
+    starting_after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
+    customer_id: z.ZodString;
+    feature_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>;
+    time_range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        end: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type LogParams = z.infer<typeof LogParamsSchema>;
+
 declare enum FeatureType {
     Boolean = "boolean",
     SingleUse = "single_use",
@@ -568,6 +591,21 @@ declare class Autumn {
             }[] | null | undefined;
         }, AutumnError>>;
     };
+    static events: {
+        list: (params: LogParams) => Promise<Result<{
+            list: {
+                id: string;
+                timestamp: number;
+                event_name: string;
+                customer_id: string;
+                value: number;
+                properties: Record<string, never>;
+            }[];
+            has_more: boolean;
+            next_cursor: string | null;
+        }, AutumnError>>;
+        aggregate: (params: QueryParams) => Promise<Result<QueryResult, AutumnError>>;
+    };
     customers: {
         list: (params?: ListCustomersParams) => Promise<Result<{
             list: Customer[];
@@ -621,6 +659,21 @@ declare class Autumn {
             }[] | null | undefined;
         }, AutumnError>>;
     };
+    events: {
+        list: (params: LogParams) => Promise<Result<{
+            list: {
+                id: string;
+                timestamp: number;
+                event_name: string;
+                customer_id: string;
+                value: number;
+                properties: Record<string, never>;
+            }[];
+            has_more: boolean;
+            next_cursor: string | null;
+        }, AutumnError>>;
+        aggregate: (params: QueryParams) => Promise<Result<QueryResult, AutumnError>>;
+    };
     /**
      * Initiates a checkout flow for a product purchase.
      *