autumn-js 0.1.49 → 0.1.50

package/dist/libraries/react/hooks/usePricingTableBase.js

@@ -459,6 +459,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 {
@@ -519,11 +539,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.
    * 
@@ -906,12 +928,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");
@@ -944,8 +960,7 @@ var AttachParamsSchema = import_v47.z.object({
   entity_data: import_v47.z.any().optional(),
   checkout_session_params: import_v47.z.record(import_v47.z.string(), import_v47.z.any()).optional(),
   reward: import_v47.z.string().optional(),
-  invoice: import_v47.z.boolean().optional(),
-  new_billing_subscription: import_v47.z.boolean().optional()
+  invoice: import_v47.z.boolean().optional()
 });
 var AttachResultSchema = import_v47.z.object({
   checkout_url: import_v47.z.string().optional(),
@@ -974,12 +989,68 @@ var CheckoutParamsSchema = import_v47.z.object({
   customer_data: CustomerDataSchema.optional(),
   entity_data: import_v47.z.any().optional(),
   checkout_session_params: import_v47.z.record(import_v47.z.string(), import_v47.z.any()).optional(),
-  reward: import_v47.z.string().optional(),
-  new_billing_subscription: import_v47.z.boolean().optional()
+  reward: import_v47.z.string().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";
@@ -987,21 +1058,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/usePricingTableBase.tsx

package/dist/libraries/react/hooks/usePricingTableBase.mjs

@@ -2,8 +2,8 @@
 
 import {
   usePricingTableBase
-} from "../chunk-VWRMGYHF.mjs";
-import "../chunk-B6C26BAU.mjs";
+} from "../chunk-ZTM7O3QH.mjs";
+import "../chunk-SP5G7NCG.mjs";
 export {
   usePricingTableBase
 };

package/dist/libraries/react/hooks/useProductsBase.d.mts

@@ -1,11 +1,12 @@
-import { P as Product } from '../prodTypes-C4aZSZfO.mjs';
-import { A as AutumnClient } from '../ReactAutumnClient-BFsdUmZR.mjs';
+import { P as Product } from '../prodTypes-DVvNGoR7.mjs';
+import { A as AutumnClient } from '../ReactAutumnClient-CRqMIWBm.mjs';
 import 'zod/v4';
 import '../error-DHbclCVh.mjs';
-import '../genTypes-B5_6Pu_4.mjs';
-import '../attachTypes-BNlJ6XXa.mjs';
-import '../cusTypes-RU0fmR-t.mjs';
-import '../entTypes-SfJb3hb2.mjs';
+import '../entTypes-DnM96qsh.mjs';
+import '../cusTypes-BugnOlMR.mjs';
+import '../attachTypes-LC2oFUhU.mjs';
+import '../eventTypes-MwzIb0X5.mjs';
+import '../client/types/clientAnalyticsTypes.mjs';
 
 declare const useProductsBase: ({ client }: {
     client: AutumnClient;

package/dist/libraries/react/hooks/useProductsBase.d.ts

@@ -1,11 +1,12 @@
-import { P as Product } from '../prodTypes-C4aZSZfO.js';
-import { A as AutumnClient } from '../ReactAutumnClient-C2DYluBM.js';
+import { P as Product } from '../prodTypes-DVvNGoR7.js';
+import { A as AutumnClient } from '../ReactAutumnClient-ByLjLgNq.js';
 import 'zod/v4';
 import '../error-DHbclCVh.js';
-import '../genTypes-CY6GNiAn.js';
-import '../attachTypes-eg914-6v.js';
-import '../cusTypes-D3QQXjif.js';
-import '../entTypes-CiODXSok.js';
+import '../entTypes-Dk2qzC19.js';
+import '../cusTypes-DjKY5YzO.js';
+import '../attachTypes-LWj2dkge.js';
+import '../eventTypes-MwzIb0X5.js';
+import '../client/types/clientAnalyticsTypes.js';
 
 declare const useProductsBase: ({ client }: {
     client: AutumnClient;

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

@@ -308,13 +308,6 @@ interface SetupPaymentResult {
     customer_id: string;
     url: string;
 }
-type QueryResult = {
-    list: Array<{
-        period: number;
-    } & {
-        [key: string]: number;
-    }>;
-};
 
 declare const AttachFeatureOptionsSchema: z.ZodObject<{
     feature_id: z.ZodString;
@@ -357,7 +350,6 @@ declare const CheckoutParamsSchema$1: z.ZodObject<{
     entity_data: z.ZodOptional<z.ZodAny>;
     checkout_session_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     reward: z.ZodOptional<z.ZodString>;
-    new_billing_subscription: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type CheckoutParams$1 = z.infer<typeof CheckoutParamsSchema$1>;
 type CheckoutResult = {
@@ -381,6 +373,14 @@ type CheckoutResult = {
     };
 };
 
+type QueryResult = {
+    list: Array<{
+        period: number;
+    } & {
+        [key: string]: number | Record<string, number>;
+    }>;
+};
+
 type Success<T> = {
     data: T;
     error: null;
@@ -488,7 +488,6 @@ declare const AttachParamsSchema: z.ZodObject<{
     openInNewTab: z.ZodOptional<z.ZodBoolean>;
     reward: z.ZodOptional<z.ZodString>;
     checkoutSessionParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    newBillingSubscription: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type AttachParams = z.infer<typeof AttachParamsSchema>;
 declare const CheckoutParamsSchema: z.ZodObject<{
@@ -507,7 +506,6 @@ declare const CheckoutParamsSchema: z.ZodObject<{
     freeTrial: z.ZodOptional<z.ZodBoolean>;
     checkoutSessionParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     reward: z.ZodOptional<z.ZodString>;
-    newBillingSubscription: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type CheckoutParams = z.infer<typeof CheckoutParamsSchema>;
 
@@ -557,10 +555,66 @@ declare const QueryParamsSchema: z.ZodObject<{
         "30d": "30d";
         "90d": "90d";
         last_cycle: "last_cycle";
+        "1bc": "1bc";
+        "3bc": "3bc";
     }>>;
 }, z.core.$strip>;
 type QueryParams = z.infer<typeof QueryParamsSchema>;
 
+declare const EventListParamsSchema: z.ZodObject<{
+    starting_after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<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 EventListParams = z.infer<typeof EventListParamsSchema>;
+declare const EventAggregationParamsSchema: z.ZodObject<{
+    customer_id: z.ZodString;
+    feature_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>;
+    group_by: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodEnum<{
+        "24h": "24h";
+        "7d": "7d";
+        "30d": "30d";
+        "90d": "90d";
+        last_cycle: "last_cycle";
+        "1bc": "1bc";
+        "3bc": "3bc";
+    }>>;
+    bin_size: z.ZodDefault<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 EventAggregationParams = z.infer<typeof EventAggregationParamsSchema>;
+type FlatAggregatedRow = {
+    period: number;
+    [featureName: string]: number;
+};
+type GroupedAggregatedRow = {
+    period: number;
+} & {
+    [featureName: string]: Record<string, number>;
+};
+type AggregatedEventRow = FlatAggregatedRow | GroupedAggregatedRow;
+declare const EventAggregationTotalSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    count: z.ZodNumber;
+    sum: z.ZodNumber;
+}, z.core.$strip>>;
+type EventAggregationTotal = z.infer<typeof EventAggregationTotalSchema>;
+type EventAggregationResponse = {
+    list: AggregatedEventRow[];
+    total: EventAggregationTotal;
+};
+
 declare const CreateEntityParamsSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
@@ -739,7 +793,7 @@ declare const useAnalytics: (params: QueryParams) => {
     data: ({
         period: number;
     } & {
-        [key: string]: number;
+        [key: string]: number | Record<string, number>;
     })[] | undefined;
     isLoading: boolean;
     error: AutumnError | undefined;
@@ -755,6 +809,44 @@ declare const usePaywall: ({ featureId, entityId, }: {
     isLoading: boolean;
 };
 
+declare const useListEvents: (params: EventListParams) => {
+    list: {
+        id: string;
+        timestamp: number;
+        event_name: string;
+        customer_id: string;
+        value: number;
+        properties: Record<string, never>;
+    }[] | undefined;
+    hasMore: boolean | undefined;
+    nextCursor: string | null | undefined;
+    isLoading: boolean;
+    error: AutumnError | undefined;
+    refetch: swr.KeyedMutator<{
+        list: {
+            id: string;
+            timestamp: number;
+            event_name: string;
+            customer_id: string;
+            value: number;
+            properties: Record<string, never>;
+        }[];
+        has_more: boolean;
+        next_cursor: string | null;
+    }>;
+};
+
+declare const useAggregateEvents: (params: EventAggregationParams) => {
+    list: AggregatedEventRow[] | undefined;
+    total: Record<string, {
+        count: number;
+        sum: number;
+    }> | undefined;
+    isLoading: boolean;
+    error: AutumnError | undefined;
+    refetch: swr.KeyedMutator<EventAggregationResponse>;
+};
+
 interface CheckoutDialogProps {
     open: boolean;
     setOpen: (open: boolean) => void;
@@ -778,4 +870,4 @@ declare function PricingTable({ productDetails, }: {
 /** @deprecated */
 declare const useAutumn: () => void;
 
-export { ReactAutumnProvider as AutumnProvider, CheckoutDialog, PaywallDialog, PricingTable, type PricingTableProduct, type ProductDetails, useAnalytics, useAutumn, useCustomer, useEntity, usePaywall, usePricingTable };
+export { ReactAutumnProvider as AutumnProvider, CheckoutDialog, PaywallDialog, PricingTable, type PricingTableProduct, type ProductDetails, useAggregateEvents, useAnalytics, useAutumn, useCustomer, useEntity, useListEvents, usePaywall, usePricingTable };

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

@@ -308,13 +308,6 @@ interface SetupPaymentResult {
     customer_id: string;
     url: string;
 }
-type QueryResult = {
-    list: Array<{
-        period: number;
-    } & {
-        [key: string]: number;
-    }>;
-};
 
 declare const AttachFeatureOptionsSchema: z.ZodObject<{
     feature_id: z.ZodString;
@@ -357,7 +350,6 @@ declare const CheckoutParamsSchema$1: z.ZodObject<{
     entity_data: z.ZodOptional<z.ZodAny>;
     checkout_session_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     reward: z.ZodOptional<z.ZodString>;
-    new_billing_subscription: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type CheckoutParams$1 = z.infer<typeof CheckoutParamsSchema$1>;
 type CheckoutResult = {
@@ -381,6 +373,14 @@ type CheckoutResult = {
     };
 };
 
+type QueryResult = {
+    list: Array<{
+        period: number;
+    } & {
+        [key: string]: number | Record<string, number>;
+    }>;
+};
+
 type Success<T> = {
     data: T;
     error: null;
@@ -488,7 +488,6 @@ declare const AttachParamsSchema: z.ZodObject<{
     openInNewTab: z.ZodOptional<z.ZodBoolean>;
     reward: z.ZodOptional<z.ZodString>;
     checkoutSessionParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    newBillingSubscription: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type AttachParams = z.infer<typeof AttachParamsSchema>;
 declare const CheckoutParamsSchema: z.ZodObject<{
@@ -507,7 +506,6 @@ declare const CheckoutParamsSchema: z.ZodObject<{
     freeTrial: z.ZodOptional<z.ZodBoolean>;
     checkoutSessionParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     reward: z.ZodOptional<z.ZodString>;
-    newBillingSubscription: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type CheckoutParams = z.infer<typeof CheckoutParamsSchema>;
 
@@ -557,10 +555,66 @@ declare const QueryParamsSchema: z.ZodObject<{
         "30d": "30d";
         "90d": "90d";
         last_cycle: "last_cycle";
+        "1bc": "1bc";
+        "3bc": "3bc";
     }>>;
 }, z.core.$strip>;
 type QueryParams = z.infer<typeof QueryParamsSchema>;
 
+declare const EventListParamsSchema: z.ZodObject<{
+    starting_after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<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 EventListParams = z.infer<typeof EventListParamsSchema>;
+declare const EventAggregationParamsSchema: z.ZodObject<{
+    customer_id: z.ZodString;
+    feature_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>;
+    group_by: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodEnum<{
+        "24h": "24h";
+        "7d": "7d";
+        "30d": "30d";
+        "90d": "90d";
+        last_cycle: "last_cycle";
+        "1bc": "1bc";
+        "3bc": "3bc";
+    }>>;
+    bin_size: z.ZodDefault<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 EventAggregationParams = z.infer<typeof EventAggregationParamsSchema>;
+type FlatAggregatedRow = {
+    period: number;
+    [featureName: string]: number;
+};
+type GroupedAggregatedRow = {
+    period: number;
+} & {
+    [featureName: string]: Record<string, number>;
+};
+type AggregatedEventRow = FlatAggregatedRow | GroupedAggregatedRow;
+declare const EventAggregationTotalSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    count: z.ZodNumber;
+    sum: z.ZodNumber;
+}, z.core.$strip>>;
+type EventAggregationTotal = z.infer<typeof EventAggregationTotalSchema>;
+type EventAggregationResponse = {
+    list: AggregatedEventRow[];
+    total: EventAggregationTotal;
+};
+
 declare const CreateEntityParamsSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodOptional<z.ZodString>;
@@ -739,7 +793,7 @@ declare const useAnalytics: (params: QueryParams) => {
     data: ({
         period: number;
     } & {
-        [key: string]: number;
+        [key: string]: number | Record<string, number>;
     })[] | undefined;
     isLoading: boolean;
     error: AutumnError | undefined;
@@ -755,6 +809,44 @@ declare const usePaywall: ({ featureId, entityId, }: {
     isLoading: boolean;
 };
 
+declare const useListEvents: (params: EventListParams) => {
+    list: {
+        id: string;
+        timestamp: number;
+        event_name: string;
+        customer_id: string;
+        value: number;
+        properties: Record<string, never>;
+    }[] | undefined;
+    hasMore: boolean | undefined;
+    nextCursor: string | null | undefined;
+    isLoading: boolean;
+    error: AutumnError | undefined;
+    refetch: swr.KeyedMutator<{
+        list: {
+            id: string;
+            timestamp: number;
+            event_name: string;
+            customer_id: string;
+            value: number;
+            properties: Record<string, never>;
+        }[];
+        has_more: boolean;
+        next_cursor: string | null;
+    }>;
+};
+
+declare const useAggregateEvents: (params: EventAggregationParams) => {
+    list: AggregatedEventRow[] | undefined;
+    total: Record<string, {
+        count: number;
+        sum: number;
+    }> | undefined;
+    isLoading: boolean;
+    error: AutumnError | undefined;
+    refetch: swr.KeyedMutator<EventAggregationResponse>;
+};
+
 interface CheckoutDialogProps {
     open: boolean;
     setOpen: (open: boolean) => void;
@@ -778,4 +870,4 @@ declare function PricingTable({ productDetails, }: {
 /** @deprecated */
 declare const useAutumn: () => void;
 
-export { ReactAutumnProvider as AutumnProvider, CheckoutDialog, PaywallDialog, PricingTable, type PricingTableProduct, type ProductDetails, useAnalytics, useAutumn, useCustomer, useEntity, usePaywall, usePricingTable };
+export { ReactAutumnProvider as AutumnProvider, CheckoutDialog, PaywallDialog, PricingTable, type PricingTableProduct, type ProductDetails, useAggregateEvents, useAnalytics, useAutumn, useCustomer, useEntity, useListEvents, usePaywall, usePricingTable };