autumn-js 0.1.49 → 0.1.51-beta.0

package/dist/libraries/backend/better-auth.js

@@ -457,6 +457,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 {
@@ -517,11 +537,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.
    * 
@@ -904,12 +926,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 ({
@@ -1000,8 +1016,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";
@@ -1009,135 +1082,199 @@ 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/better-auth.ts
 var import_api2 = require("better-auth/api");
 var import_plugins = require("better-auth/plugins");
 var import_better_call = require("better-call");
-var import_rou36 = require("rou3");
-var import_v413 = require("zod/v4");
+var import_rou37 = require("rou3");
+var import_v416 = require("zod/v4");
 
 // src/libraries/react/client/types/clientAttachTypes.ts
-var import_v49 = require("zod/v4");
-var AttachFeatureOptionsSchema2 = import_v49.z.object({
-  featureId: import_v49.z.string(),
-  quantity: import_v49.z.number()
-});
-var AttachParamsSchema2 = import_v49.z.object({
-  productId: import_v49.z.string().optional(),
-  entityId: import_v49.z.string().optional(),
-  options: import_v49.z.array(AttachFeatureOptionsSchema2).optional(),
-  productIds: import_v49.z.array(import_v49.z.string()).optional(),
-  freeTrial: import_v49.z.boolean().optional(),
-  successUrl: import_v49.z.string().optional(),
-  metadata: import_v49.z.record(import_v49.z.string(), import_v49.z.string()).optional(),
-  forceCheckout: import_v49.z.boolean().optional(),
+var import_v411 = require("zod/v4");
+var AttachFeatureOptionsSchema2 = import_v411.z.object({
+  featureId: import_v411.z.string(),
+  quantity: import_v411.z.number()
+});
+var AttachParamsSchema2 = import_v411.z.object({
+  productId: import_v411.z.string().optional(),
+  entityId: import_v411.z.string().optional(),
+  options: import_v411.z.array(AttachFeatureOptionsSchema2).optional(),
+  productIds: import_v411.z.array(import_v411.z.string()).optional(),
+  freeTrial: import_v411.z.boolean().optional(),
+  successUrl: import_v411.z.string().optional(),
+  metadata: import_v411.z.record(import_v411.z.string(), import_v411.z.string()).optional(),
+  forceCheckout: import_v411.z.boolean().optional(),
   /**
    * @deprecated This field is deprecated and will be removed in a future version.
    */
-  dialog: import_v49.z.any().optional().describe(
+  dialog: import_v411.z.any().optional().describe(
     "DEPRECATED: This field is deprecated and will be removed in a future version. Please use the checkout() method instead."
   ),
-  entityData: import_v49.z.any().optional(),
-  openInNewTab: import_v49.z.boolean().optional(),
-  reward: import_v49.z.string().optional(),
-  checkoutSessionParams: import_v49.z.record(import_v49.z.string(), import_v49.z.any()).optional(),
-  newBillingSubscription: import_v49.z.boolean().optional()
-});
-var CheckoutParamsSchema2 = import_v49.z.object({
-  productId: import_v49.z.string().optional(),
-  productIds: import_v49.z.array(import_v49.z.string()).optional(),
-  entityId: import_v49.z.string().optional(),
-  entityData: import_v49.z.any().optional(),
-  options: import_v49.z.array(AttachFeatureOptionsSchema2).optional(),
-  successUrl: import_v49.z.string().optional(),
-  openInNewTab: import_v49.z.boolean().optional(),
-  dialog: import_v49.z.any().optional(),
-  forceCheckout: import_v49.z.boolean().optional(),
-  freeTrial: import_v49.z.boolean().optional(),
-  checkoutSessionParams: import_v49.z.record(import_v49.z.string(), import_v49.z.any()).optional(),
-  reward: import_v49.z.string().optional(),
-  newBillingSubscription: import_v49.z.boolean().optional()
+  entityData: import_v411.z.any().optional(),
+  openInNewTab: import_v411.z.boolean().optional(),
+  reward: import_v411.z.string().optional(),
+  checkoutSessionParams: import_v411.z.record(import_v411.z.string(), import_v411.z.any()).optional(),
+  newBillingSubscription: import_v411.z.boolean().optional()
+});
+var CheckoutParamsSchema2 = import_v411.z.object({
+  productId: import_v411.z.string().optional(),
+  productIds: import_v411.z.array(import_v411.z.string()).optional(),
+  entityId: import_v411.z.string().optional(),
+  entityData: import_v411.z.any().optional(),
+  options: import_v411.z.array(AttachFeatureOptionsSchema2).optional(),
+  successUrl: import_v411.z.string().optional(),
+  openInNewTab: import_v411.z.boolean().optional(),
+  dialog: import_v411.z.any().optional(),
+  forceCheckout: import_v411.z.boolean().optional(),
+  freeTrial: import_v411.z.boolean().optional(),
+  checkoutSessionParams: import_v411.z.record(import_v411.z.string(), import_v411.z.any()).optional(),
+  reward: import_v411.z.string().optional(),
+  newBillingSubscription: import_v411.z.boolean().optional()
 });
 
 // src/libraries/react/client/types/clientEntTypes.ts
-var import_v410 = require("zod/v4");
-var CreateEntityParamsSchema = import_v410.z.object({
-  id: import_v410.z.string(),
-  name: import_v410.z.string().optional(),
-  featureId: import_v410.z.string()
+var import_v412 = require("zod/v4");
+var CreateEntityParamsSchema = import_v412.z.object({
+  id: import_v412.z.string(),
+  name: import_v412.z.string().optional(),
+  featureId: import_v412.z.string()
 });
-var GetEntityParamsSchema = import_v410.z.object({
-  expand: import_v410.z.array(import_v410.z.string()).optional()
+var GetEntityParamsSchema = import_v412.z.object({
+  expand: import_v412.z.array(import_v412.z.string()).optional()
 });
-var EntityDataParamsSchema = import_v410.z.object({
-  name: import_v410.z.string().optional(),
-  featureId: import_v410.z.string()
+var EntityDataParamsSchema = import_v412.z.object({
+  name: import_v412.z.string().optional(),
+  featureId: import_v412.z.string()
 });
 
 // src/libraries/react/client/types/clientGenTypes.ts
-var import_v411 = require("zod/v4");
-var CancelParamsSchema2 = import_v411.z.object({
-  productId: import_v411.z.string(),
-  entityId: import_v411.z.string().optional(),
-  cancelImmediately: import_v411.z.boolean().optional()
+var import_v413 = require("zod/v4");
+var CancelParamsSchema2 = import_v413.z.object({
+  productId: import_v413.z.string(),
+  entityId: import_v413.z.string().optional(),
+  cancelImmediately: import_v413.z.boolean().optional()
 });
-var CheckParamsSchema2 = import_v411.z.object({
-  featureId: import_v411.z.string().optional(),
-  productId: import_v411.z.string().optional(),
-  entityId: import_v411.z.string().optional(),
-  requiredBalance: import_v411.z.number().optional(),
-  sendEvent: import_v411.z.boolean().optional(),
-  withPreview: import_v411.z.boolean().optional(),
-  dialog: import_v411.z.any().optional(),
-  entityData: import_v411.z.any().optional(),
-  properties: import_v411.z.record(import_v411.z.string(), import_v411.z.any()).optional()
+var CheckParamsSchema2 = import_v413.z.object({
+  featureId: import_v413.z.string().optional(),
+  productId: import_v413.z.string().optional(),
+  entityId: import_v413.z.string().optional(),
+  requiredBalance: import_v413.z.number().optional(),
+  sendEvent: import_v413.z.boolean().optional(),
+  withPreview: import_v413.z.boolean().optional(),
+  dialog: import_v413.z.any().optional(),
+  entityData: import_v413.z.any().optional(),
+  properties: import_v413.z.record(import_v413.z.string(), import_v413.z.any()).optional()
 });
-var TrackParamsSchema2 = import_v411.z.object({
-  featureId: import_v411.z.string().optional(),
-  eventName: import_v411.z.string().optional(),
-  entityId: import_v411.z.string().optional(),
-  value: import_v411.z.number().optional(),
-  idempotencyKey: import_v411.z.string().optional(),
-  entityData: import_v411.z.any().optional()
+var TrackParamsSchema2 = import_v413.z.object({
+  featureId: import_v413.z.string().optional(),
+  eventName: import_v413.z.string().optional(),
+  entityId: import_v413.z.string().optional(),
+  value: import_v413.z.number().optional(),
+  idempotencyKey: import_v413.z.string().optional(),
+  entityData: import_v413.z.any().optional()
 });
-var OpenBillingPortalParamsSchema = import_v411.z.object({
-  returnUrl: import_v411.z.string().optional(),
-  openInNewTab: import_v411.z.boolean().optional()
+var OpenBillingPortalParamsSchema = import_v413.z.object({
+  returnUrl: import_v413.z.string().optional(),
+  openInNewTab: import_v413.z.boolean().optional()
 });
-var SetupPaymentParamsSchema = import_v411.z.object({
-  successUrl: import_v411.z.string().optional(),
-  checkoutSessionParams: import_v411.z.record(import_v411.z.string(), import_v411.z.any()).optional(),
-  openInNewTab: import_v411.z.boolean().optional()
+var SetupPaymentParamsSchema = import_v413.z.object({
+  successUrl: import_v413.z.string().optional(),
+  checkoutSessionParams: import_v413.z.record(import_v413.z.string(), import_v413.z.any()).optional(),
+  openInNewTab: import_v413.z.boolean().optional()
 });
-var QueryParamsSchema2 = import_v411.z.object({
-  featureId: import_v411.z.string().or(import_v411.z.array(import_v411.z.string())),
+var QueryParamsSchema2 = import_v413.z.object({
+  featureId: import_v413.z.string().or(import_v413.z.array(import_v413.z.string())),
   range: QueryRangeEnum.optional()
 });
 
+// src/libraries/react/client/types/clientAnalyticsTypes.ts
+var import_v414 = require("zod/v4");
+var PaginationDefaults2 = {
+  Limit: 100,
+  MaxLimit: 1e3
+};
+var CursorPaginationQuerySchema2 = import_v414.z.object({
+  starting_after: import_v414.z.string().optional().describe("Cursor for pagination. Use next_cursor from previous response."),
+  limit: import_v414.z.coerce.number().int().min(1).max(PaginationDefaults2.MaxLimit).optional().describe(
+    `Number of items to return. Default ${PaginationDefaults2.Limit}, max ${PaginationDefaults2.MaxLimit}.`
+  )
+});
+var EventListParamsSchema = CursorPaginationQuerySchema2.extend({
+  customer_id: import_v414.z.string().describe("Filter events by customer ID"),
+  feature_id: import_v414.z.string().min(1).or(import_v414.z.array(import_v414.z.string().min(1))).describe("Filter by specific feature ID(s)"),
+  time_range: import_v414.z.object({
+    start: import_v414.z.coerce.number().optional().describe("Filter events after this timestamp (epoch milliseconds)"),
+    end: import_v414.z.coerce.number().optional().describe("Filter events before this timestamp (epoch milliseconds)")
+  }).optional().describe("Filter events by time range")
+});
+var EventListItemSchema = import_v414.z.object({
+  id: import_v414.z.string().describe("Event ID (KSUID)"),
+  timestamp: import_v414.z.number().describe("Event timestamp (epoch milliseconds)"),
+  event_name: import_v414.z.string().describe("Name of the event"),
+  customer_id: import_v414.z.string().describe("Customer identifier"),
+  value: import_v414.z.number().describe("Event value/count"),
+  properties: import_v414.z.object({}).describe("Event properties (JSONB)")
+});
+var EventListResponseSchema = import_v414.z.object({
+  list: import_v414.z.array(EventListItemSchema).describe("Array of events for current page"),
+  has_more: import_v414.z.boolean().describe("Whether more results exist after this page"),
+  next_cursor: import_v414.z.string().nullable().describe("Opaque cursor for next page. Null if no more results.")
+});
+var RangeEnumSchema = import_v414.z.enum([
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "last_cycle",
+  "1bc",
+  "3bc"
+]);
+var BinSizeEnumSchema = import_v414.z.enum(["day", "hour"]).default("day");
+var EventAggregationParamsSchema = import_v414.z.object({
+  customer_id: import_v414.z.string().min(1).describe("Customer ID to aggregate events for"),
+  feature_id: import_v414.z.string().min(1).or(import_v414.z.array(import_v414.z.string().min(1))).describe("Feature ID(s) to aggregate"),
+  group_by: import_v414.z.string().startsWith("properties.").optional().describe("Group results by a property field (e.g., 'properties.region')"),
+  range: RangeEnumSchema.optional().describe(
+    "Predefined time range. One of: 24h, 7d, 30d, 90d, last_cycle, 1bc, 3bc"
+  ),
+  bin_size: BinSizeEnumSchema.describe("Bin size for aggregation: 'day' or 'hour'"),
+  custom_range: import_v414.z.object({
+    start: import_v414.z.number().describe("Start timestamp (epoch milliseconds)"),
+    end: import_v414.z.number().describe("End timestamp (epoch milliseconds)")
+  }).optional().describe("Custom time range (mutually exclusive with range)")
+});
+var EventAggregationTotalSchema = import_v414.z.record(
+  import_v414.z.string(),
+  import_v414.z.object({
+    count: import_v414.z.number(),
+    sum: import_v414.z.number()
+  })
+);
+
 // src/libraries/react/client/types/clientReferralTypes.ts
-var import_v412 = require("zod/v4");
-var CreateReferralCodeParamsSchema2 = import_v412.z.object({
-  programId: import_v412.z.string()
+var import_v415 = require("zod/v4");
+var CreateReferralCodeParamsSchema2 = import_v415.z.object({
+  programId: import_v415.z.string()
 });
-var RedeemReferralCodeParamsSchema2 = import_v412.z.object({
-  code: import_v412.z.string()
+var RedeemReferralCodeParamsSchema2 = import_v415.z.object({
+  code: import_v415.z.string()
 });
 
 // src/libraries/backend/utils/backendRes.ts
@@ -1404,7 +1541,7 @@ var addGenRoutes = (router2) => {
 };
 
 // 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");
@@ -1532,6 +1669,47 @@ var addProductRoutes = async (router2) => {
   });
 };
 
+// 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: autumn2,
+    customer_id,
+    body
+  }) => {
+    return await autumn2.events.list({
+      ...sanitizeBody2(body),
+      customer_id
+    });
+  }
+});
+var aggregateEventsHandler = withAuth({
+  fn: async ({
+    autumn: autumn2,
+    customer_id,
+    body
+  }) => {
+    return await autumn2.events.aggregate({
+      ...sanitizeBody2(body),
+      customer_id
+    });
+  }
+});
+var addAnalyticsRoutes = (router2) => {
+  (0, import_rou35.addRoute)(router2, "POST", `${BASE_PATH}/events/list`, {
+    handler: listEventsHandler
+  });
+  (0, import_rou35.addRoute)(router2, "POST", `${BASE_PATH}/events/aggregate`, {
+    handler: aggregateEventsHandler
+  });
+};
+
 // src/libraries/backend/routes/backendRouter.ts
 var sanitizeCustomerBody = (body) => {
   let bodyCopy = { ...body };
@@ -1570,8 +1748,8 @@ var getPricingTableHandler = withAuth({
   requireCustomer: false
 });
 var createRouterWithOptions = () => {
-  const router2 = (0, import_rou35.createRouter)();
-  (0, import_rou35.addRoute)(router2, "POST", `${BASE_PATH}/cors`, {
+  const router2 = (0, import_rou36.createRouter)();
+  (0, import_rou36.addRoute)(router2, "POST", `${BASE_PATH}/cors`, {
     handler: () => {
       return {
         body: {
@@ -1581,10 +1759,10 @@ var createRouterWithOptions = () => {
       };
     }
   });
-  (0, import_rou35.addRoute)(router2, "POST", `${BASE_PATH}/customers`, {
+  (0, import_rou36.addRoute)(router2, "POST", `${BASE_PATH}/customers`, {
     handler: createCustomerHandler
   });
-  (0, import_rou35.addRoute)(router2, "GET", `${BASE_PATH}/components/pricing_table`, {
+  (0, import_rou36.addRoute)(router2, "GET", `${BASE_PATH}/components/pricing_table`, {
     handler: getPricingTableHandler,
     requireCustomer: false
   });
@@ -1592,6 +1770,7 @@ var createRouterWithOptions = () => {
   addEntityRoutes(router2);
   addReferralRoutes(router2);
   addProductRoutes(router2);
+  addAnalyticsRoutes(router2);
   return router2;
 };
 
@@ -1750,7 +1929,7 @@ var handleReq = async ({
   }
   const rest = ctx.path.split("/autumn/")[1];
   const pathname = `/api/autumn/${betterAuthPathMap[rest] || rest}`;
-  const match = (0, import_rou36.findRoute)(router, method, pathname);
+  const match = (0, import_rou37.findRoute)(router, method, pathname);
   if (!match) return ctx.json({ error: "Not found" }, { status: 404 });
   const { data } = match;
   const { handler } = data;
@@ -1828,9 +2007,9 @@ var autumn = (options) => {
         {
           method: "POST",
           use: [],
-          body: import_v413.z.object({
-            errorOnNotFound: import_v413.z.boolean().optional(),
-            expand: import_v413.z.array(CustomerExpandEnum).optional()
+          body: import_v416.z.object({
+            errorOnNotFound: import_v416.z.boolean().optional(),
+            expand: import_v416.z.array(CustomerExpandEnum).optional()
           }),
           metadata: {
             isAction: false
@@ -1971,6 +2150,24 @@ var autumn = (options) => {
           use: []
         },
         async (ctx) => await handleReq({ ctx, options, method: "DELETE" })
+      ),
+      listEvents: (0, import_plugins.createAuthEndpoint)(
+        "/autumn/events/list",
+        {
+          method: "POST",
+          use: [],
+          body: EventListParamsSchema
+        },
+        async (ctx) => await handleReq({ ctx, options, method: "POST" })
+      ),
+      aggregateEvents: (0, import_plugins.createAuthEndpoint)(
+        "/autumn/events/aggregate",
+        {
+          method: "POST",
+          use: [],
+          body: EventAggregationParamsSchema
+        },
+        async (ctx) => await handleReq({ ctx, options, method: "POST" })
       )
     }
   };