autumn-js 0.1.49 → 0.1.51-beta.0

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

@@ -8,17 +8,18 @@ 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,
   CustomerExpandEnum,
   QueryRangeEnum
-} from "./chunk-2ACQRE64.mjs";
+} from "./chunk-SXD4RGCT.mjs";
 import "./chunk-2TEL6LR5.mjs";
 import "./chunk-KSG3E4Q2.mjs";
 
@@ -30,7 +31,7 @@ import {
   createEndpoint
 } from "better-call";
 import { findRoute } from "rou3";
-import { z as z5 } from "zod/v4";
+import { z as z6 } from "zod/v4";
 
 // src/libraries/react/client/types/clientAttachTypes.ts
 import { z } from "zod/v4";
@@ -130,13 +131,77 @@ var QueryParamsSchema = z3.object({
   range: QueryRangeEnum.optional()
 });
 
-// src/libraries/react/client/types/clientReferralTypes.ts
+// src/libraries/react/client/types/clientAnalyticsTypes.ts
 import { z as z4 } from "zod/v4";
-var CreateReferralCodeParamsSchema = z4.object({
-  programId: z4.string()
+var PaginationDefaults = {
+  Limit: 100,
+  MaxLimit: 1e3
+};
+var CursorPaginationQuerySchema = z4.object({
+  starting_after: z4.string().optional().describe("Cursor for pagination. Use next_cursor from previous response."),
+  limit: z4.coerce.number().int().min(1).max(PaginationDefaults.MaxLimit).optional().describe(
+    `Number of items to return. Default ${PaginationDefaults.Limit}, max ${PaginationDefaults.MaxLimit}.`
+  )
+});
+var EventListParamsSchema = CursorPaginationQuerySchema.extend({
+  customer_id: z4.string().describe("Filter events by customer ID"),
+  feature_id: z4.string().min(1).or(z4.array(z4.string().min(1))).describe("Filter by specific feature ID(s)"),
+  time_range: z4.object({
+    start: z4.coerce.number().optional().describe("Filter events after this timestamp (epoch milliseconds)"),
+    end: z4.coerce.number().optional().describe("Filter events before this timestamp (epoch milliseconds)")
+  }).optional().describe("Filter events by time range")
+});
+var EventListItemSchema = z4.object({
+  id: z4.string().describe("Event ID (KSUID)"),
+  timestamp: z4.number().describe("Event timestamp (epoch milliseconds)"),
+  event_name: z4.string().describe("Name of the event"),
+  customer_id: z4.string().describe("Customer identifier"),
+  value: z4.number().describe("Event value/count"),
+  properties: z4.object({}).describe("Event properties (JSONB)")
+});
+var EventListResponseSchema = z4.object({
+  list: z4.array(EventListItemSchema).describe("Array of events for current page"),
+  has_more: z4.boolean().describe("Whether more results exist after this page"),
+  next_cursor: z4.string().nullable().describe("Opaque cursor for next page. Null if no more results.")
+});
+var RangeEnumSchema = z4.enum([
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "last_cycle",
+  "1bc",
+  "3bc"
+]);
+var BinSizeEnumSchema = z4.enum(["day", "hour"]).default("day");
+var EventAggregationParamsSchema = z4.object({
+  customer_id: z4.string().min(1).describe("Customer ID to aggregate events for"),
+  feature_id: z4.string().min(1).or(z4.array(z4.string().min(1))).describe("Feature ID(s) to aggregate"),
+  group_by: z4.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: z4.object({
+    start: z4.number().describe("Start timestamp (epoch milliseconds)"),
+    end: z4.number().describe("End timestamp (epoch milliseconds)")
+  }).optional().describe("Custom time range (mutually exclusive with range)")
+});
+var EventAggregationTotalSchema = z4.record(
+  z4.string(),
+  z4.object({
+    count: z4.number(),
+    sum: z4.number()
+  })
+);
+
+// src/libraries/react/client/types/clientReferralTypes.ts
+import { z as z5 } from "zod/v4";
+var CreateReferralCodeParamsSchema = z5.object({
+  programId: z5.string()
 });
-var RedeemReferralCodeParamsSchema = z4.object({
-  code: z4.string()
+var RedeemReferralCodeParamsSchema = z5.object({
+  code: z5.string()
 });
 
 // src/libraries/backend/better-auth.ts
@@ -258,9 +323,9 @@ var autumn = (options) => {
         {
           method: "POST",
           use: [],
-          body: z5.object({
-            errorOnNotFound: z5.boolean().optional(),
-            expand: z5.array(CustomerExpandEnum).optional()
+          body: z6.object({
+            errorOnNotFound: z6.boolean().optional(),
+            expand: z6.array(CustomerExpandEnum).optional()
           }),
           metadata: {
             isAction: false
@@ -401,6 +466,24 @@ var autumn = (options) => {
           use: []
         },
         async (ctx) => await handleReq({ ctx, options, method: "DELETE" })
+      ),
+      listEvents: createAuthEndpoint(
+        "/autumn/events/list",
+        {
+          method: "POST",
+          use: [],
+          body: EventListParamsSchema
+        },
+        async (ctx) => await handleReq({ ctx, options, method: "POST" })
+      ),
+      aggregateEvents: createAuthEndpoint(
+        "/autumn/events/aggregate",
+        {
+          method: "POST",
+          use: [],
+          body: EventAggregationParamsSchema
+        },
+        async (ctx) => await handleReq({ ctx, options, method: "POST" })
       )
     }
   };

package/dist/libraries/backend/chunk-6KBN5J3Q.mjs

@@ -0,0 +1,51 @@
+import {
+  withAuth
+} from "./chunk-LOGELPCS.mjs";
+import {
+  BASE_PATH
+} from "./chunk-KSG3E4Q2.mjs";
+
+// src/libraries/backend/routes/analyticsRoutes.ts
+import { addRoute } from "rou3";
+var sanitizeBody = (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({
+      ...sanitizeBody(body),
+      customer_id
+    });
+  }
+});
+var aggregateEventsHandler = withAuth({
+  fn: async ({
+    autumn,
+    customer_id,
+    body
+  }) => {
+    return await autumn.events.aggregate({
+      ...sanitizeBody(body),
+      customer_id
+    });
+  }
+});
+var addAnalyticsRoutes = (router) => {
+  addRoute(router, "POST", `${BASE_PATH}/events/list`, {
+    handler: listEventsHandler
+  });
+  addRoute(router, "POST", `${BASE_PATH}/events/aggregate`, {
+    handler: aggregateEventsHandler
+  });
+};
+
+export {
+  addAnalyticsRoutes
+};

package/dist/libraries/backend/{chunk-GUWG5XU3.mjs → chunk-7J2QIGRJ.mjs}

@@ -1,6 +1,6 @@
 import {
   withAuth
-} from "./chunk-JYK2MUUW.mjs";
+} from "./chunk-LOGELPCS.mjs";
 
 // src/libraries/backend/routes/entityRoutes.ts
 import { addRoute } from "rou3";

package/dist/libraries/backend/{chunk-S3DYAAI4.mjs → chunk-IIBWHZIF.mjs}

@@ -1,6 +1,6 @@
 import {
   withAuth
-} from "./chunk-JYK2MUUW.mjs";
+} from "./chunk-LOGELPCS.mjs";
 import {
   BASE_PATH
 } from "./chunk-KSG3E4Q2.mjs";

package/dist/libraries/backend/{chunk-JYK2MUUW.mjs → chunk-LOGELPCS.mjs}

@@ -1,7 +1,7 @@
 import {
   toBackendError,
   toBackendRes
-} from "./chunk-2ACQRE64.mjs";
+} from "./chunk-SXD4RGCT.mjs";
 import {
   logger
 } from "./chunk-2TEL6LR5.mjs";

package/dist/libraries/backend/{chunk-AVZDE6BQ.mjs → chunk-LSUV3XYF.mjs}

@@ -1,21 +1,24 @@
-import {
-  addGenRoutes
-} from "./chunk-M4JDQD3E.mjs";
 import {
   addProductRoutes
-} from "./chunk-S3DYAAI4.mjs";
+} from "./chunk-IIBWHZIF.mjs";
 import {
   addReferralRoutes
-} from "./chunk-KQFBSKKB.mjs";
+} from "./chunk-XUDFX2TX.mjs";
+import {
+  addAnalyticsRoutes
+} from "./chunk-6KBN5J3Q.mjs";
 import {
   addEntityRoutes
-} from "./chunk-GUWG5XU3.mjs";
+} from "./chunk-7J2QIGRJ.mjs";
+import {
+  addGenRoutes
+} from "./chunk-XNHNC4PS.mjs";
 import {
   withAuth
-} from "./chunk-JYK2MUUW.mjs";
+} from "./chunk-LOGELPCS.mjs";
 import {
   fetchPricingTable
-} from "./chunk-2ACQRE64.mjs";
+} from "./chunk-SXD4RGCT.mjs";
 import {
   BASE_PATH
 } from "./chunk-KSG3E4Q2.mjs";
@@ -81,6 +84,7 @@ var createRouterWithOptions = () => {
   addEntityRoutes(router);
   addReferralRoutes(router);
   addProductRoutes(router);
+  addAnalyticsRoutes(router);
   return router;
 };
 

package/dist/libraries/backend/{chunk-2ACQRE64.mjs → chunk-SXD4RGCT.mjs}

@@ -387,6 +387,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 {
@@ -447,11 +467,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.
    * 
@@ -834,12 +856,6 @@ var CheckParamsSchema = z5.object({
   with_preview: z5.boolean().optional(),
   entity_data: EntityDataSchema.optional()
 });
-var QueryRangeEnum = z5.enum(["24h", "7d", "30d", "90d", "last_cycle"]);
-var QueryParamsSchema = z5.object({
-  customer_id: z5.string(),
-  feature_id: z5.string().or(z5.array(z5.string())),
-  range: QueryRangeEnum.optional()
-});
 
 // src/sdk/components/componentMethods.ts
 var fetchPricingTable = async ({
@@ -930,8 +946,65 @@ var CheckoutParamsSchema = z7.object({
   new_billing_subscription: z7.boolean().optional()
 });
 
-// src/sdk/features/featureTypes.ts
+// src/sdk/general/cursorTypes.ts
 import { z as z8 } from "zod/v4";
+var PaginationDefaults = {
+  Limit: 100,
+  MaxLimit: 1e3
+};
+var CursorPaginationQuerySchema = z8.object({
+  starting_after: z8.string().optional(),
+  limit: z8.coerce.number().int().min(1).max(PaginationDefaults.MaxLimit).default(PaginationDefaults.Limit).optional()
+});
+var createCursorPaginatedResponseSchema = (itemSchema) => z8.object({
+  list: z8.array(itemSchema),
+  has_more: z8.boolean(),
+  next_cursor: z8.string().nullable()
+});
+
+// src/sdk/events/eventTypes.ts
+import { z as z9 } from "zod/v4";
+var QueryRangeEnum = z9.enum([
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "last_cycle",
+  "1bc",
+  "3bc"
+]);
+var BinSizeEnum = z9.enum(["day", "hour"]);
+var QueryParamsSchema = z9.object({
+  customer_id: z9.string(),
+  feature_id: z9.string().or(z9.array(z9.string())),
+  range: QueryRangeEnum.optional(),
+  group_by: z9.string().startsWith("properties.").optional(),
+  bin_size: BinSizeEnum.optional(),
+  custom_range: z9.object({
+    start: z9.number(),
+    end: z9.number()
+  }).optional()
+});
+var LogParamsSchema = CursorPaginationQuerySchema.extend({
+  customer_id: z9.string(),
+  feature_id: z9.string().or(z9.array(z9.string())),
+  time_range: z9.object({
+    start: z9.coerce.number().optional(),
+    end: z9.coerce.number().optional()
+  }).optional()
+});
+var EventLogSchema = z9.object({
+  id: z9.string().describe("Event ID (KSUID)"),
+  timestamp: z9.number().describe("Event timestamp (epoch milliseconds)"),
+  event_name: z9.string().describe("Name of the event"),
+  customer_id: z9.string().describe("Customer identifier"),
+  value: z9.number().describe("Event value/count"),
+  properties: z9.object({}).describe("Event properties (JSONB)")
+});
+var EventLogResponseSchema = createCursorPaginatedResponseSchema(EventLogSchema);
+
+// src/sdk/features/featureTypes.ts
+import { z as z10 } from "zod/v4";
 var FeatureType = /* @__PURE__ */ ((FeatureType2) => {
   FeatureType2["Boolean"] = "boolean";
   FeatureType2["SingleUse"] = "single_use";
@@ -939,21 +1012,21 @@ var FeatureType = /* @__PURE__ */ ((FeatureType2) => {
   FeatureType2["CreditSystem"] = "credit_system";
   return FeatureType2;
 })(FeatureType || {});
-var FeatureSchema = z8.object({
-  id: z8.string(),
-  name: z8.string(),
-  type: z8.enum(FeatureType),
-  display: z8.object({
-    singular: z8.string(),
-    plural: z8.string()
+var FeatureSchema = z10.object({
+  id: z10.string(),
+  name: z10.string(),
+  type: z10.enum(FeatureType),
+  display: z10.object({
+    singular: z10.string(),
+    plural: z10.string()
   }).nullish(),
-  credit_schema: z8.array(
-    z8.object({
-      metered_feature_id: z8.string(),
-      credit_cost: z8.number()
+  credit_schema: z10.array(
+    z10.object({
+      metered_feature_id: z10.string(),
+      credit_cost: z10.number()
     })
   ).nullish(),
-  archived: z8.boolean()
+  archived: z10.boolean()
 });
 
 // src/libraries/backend/utils/backendRes.ts
@@ -982,8 +1055,8 @@ var toBackendError = ({
 export {
   Autumn,
   CustomerExpandEnum,
-  QueryRangeEnum,
   fetchPricingTable,
+  QueryRangeEnum,
   toBackendRes,
   toBackendError
 };

package/dist/libraries/backend/{chunk-M4JDQD3E.mjs → chunk-XNHNC4PS.mjs}

@@ -1,6 +1,6 @@
 import {
   withAuth
-} from "./chunk-JYK2MUUW.mjs";
+} from "./chunk-LOGELPCS.mjs";
 import {
   BASE_PATH
 } from "./chunk-KSG3E4Q2.mjs";

package/dist/libraries/backend/{chunk-KQFBSKKB.mjs → chunk-XUDFX2TX.mjs}

@@ -1,6 +1,6 @@
 import {
   withAuth
-} from "./chunk-JYK2MUUW.mjs";
+} from "./chunk-LOGELPCS.mjs";
 import {
   BASE_PATH
 } from "./chunk-KSG3E4Q2.mjs";