@growth-loop/sdk 0.1.1 → 0.1.2

package/dist/{client-CC-8sBba.d.ts → client-CUopXrmX.d.ts}

@@ -1,4 +1,4 @@
-import { Properties, EventContext, IngestPayload } from '@growth/shared';
+import { Properties, EventContext, EventSource, IngestPayload } from '@growth/shared';
 
 interface Transport {
     send(url: string, payload: IngestPayload, headers: Record<string, string>): Promise<void>;
@@ -9,6 +9,10 @@ interface GrowthOptions {
     flushInterval?: number;
     batchSize?: number;
     defaultContext?: EventContext;
+    /** Where events originate. Browser/web by default; createServerClient overrides to 'server'. */
+    source?: EventSource;
+    /** Pre-existing session id (e.g. from cookie/sessionStorage). Browser client wires this automatically. */
+    sessionId?: string;
     transport?: Transport;
     onError?: (error: Error) => void;
     debug?: boolean;
@@ -30,6 +34,7 @@ interface GrowthClient {
     group(groupType: string, groupKey: string, properties?: Properties): void;
     setContext(context: EventContext): void;
     setDistinctId(id: string): void;
+    setSessionId(id: string): void;
     flush(): Promise<void>;
     shutdown(): Promise<void>;
 }
@@ -41,12 +46,15 @@ declare class Growth implements GrowthClient {
     private readonly queue;
     private readonly onError;
     private readonly debug;
+    private readonly source;
     private context;
     private distinctId;
+    private sessionId;
     private flushTimer;
     private closed;
     constructor(options: GrowthOptions);
     setDistinctId(id: string): void;
+    setSessionId(id: string): void;
     setContext(context: EventContext): void;
     track(name: string, properties?: Properties, options?: TrackOptions): void;
     identify(options: IdentifyOptions): void;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { G as GrowthClient, T as TrackOptions } from './client-CC-8sBba.js';
-export { a as Growth, b as GrowthOptions, I as IdentifyOptions, c as Transport, d as createClient } from './client-CC-8sBba.js';
+import { G as GrowthClient, T as TrackOptions } from './client-CUopXrmX.js';
+export { a as Growth, b as GrowthOptions, I as IdentifyOptions, c as Transport, d as createClient } from './client-CUopXrmX.js';
 import { Properties } from '@growth/shared';
 export { EventContext, Properties, TrackEvent } from '@growth/shared';
 
@@ -43,6 +43,28 @@ declare function step(growth: GrowthClient, funnelStep: string, properties?: Pro
  *   <button onClick={growth.button('login_clicked', onLogin)}>Login</button>
  */
 declare function button<TArgs extends unknown[], TRet>(growth: GrowthClient, name: string, handler?: (...args: TArgs) => TRet, properties?: Properties): (...args: TArgs) => TRet | undefined;
+interface RevenueOptions extends TrackOptions {
+    currency?: string;
+    plan?: string;
+    interval?: 'month' | 'year' | 'one_time';
+    properties?: Properties;
+}
+/**
+ * Emit a revenue event with the cents amount normalized as `amount_cents`.
+ *
+ * The API maps `amount_cents` straight into ClickHouse's `revenue_cents` column
+ * for any event whose name is in the spec-cased list (`subscription_created`,
+ * `subscription_canceled`, `purchase_completed`, etc.). Calling `growth.track()`
+ * directly works too, but founders mis-name the field as `amount`, `price`, or
+ * `total` more often than not — using this helper prevents MRR breakage.
+ *
+ *   growth.revenue('subscription_created', 2900, {
+ *     currency: 'usd', plan: 'pro', interval: 'month', distinctId: userId,
+ *   });
+ *
+ *   growth.revenue('refund_issued', -2900, { distinctId: userId });
+ */
+declare function revenue(growth: GrowthClient, event: string, amountCents: number, options?: RevenueOptions): void;
 /**
  * Adds the helpers above as methods on a Growth client instance. Call once
  * after constructing the client and the API surface becomes:
@@ -55,7 +77,8 @@ interface GrowthInstrumented extends GrowthClient {
     span: <TArgs extends unknown[], TRet>(name: string, fn: (...args: TArgs) => TRet | Promise<TRet>, options?: SpanOptions) => (...args: TArgs) => Promise<TRet>;
     step: (funnelStep: string, properties?: Properties, options?: TrackOptions) => void;
     button: <TArgs extends unknown[], TRet>(name: string, handler?: (...args: TArgs) => TRet, properties?: Properties) => (...args: TArgs) => TRet | undefined;
+    revenue: (event: string, amountCents: number, options?: RevenueOptions) => void;
 }
 declare function instrument(growth: GrowthClient): GrowthInstrumented;
 
-export { GrowthClient, type GrowthInstrumented, type SpanOptions, TrackOptions, button, instrument, span, step };
+export { GrowthClient, type GrowthInstrumented, type RevenueOptions, type SpanOptions, TrackOptions, button, instrument, revenue, span, step };

package/dist/index.js

@@ -4206,7 +4206,7 @@ var Queue = class {
 
 // src/version.ts
 var SDK_NAME = "growth-js";
-var SDK_VERSION = "0.0.1";
+var SDK_VERSION = "0.1.2";
 
 // src/client.ts
 var DEFAULT_HOST = "https://api.growth-loop.dev";
@@ -4222,8 +4222,10 @@ var Growth = class {
   queue;
   onError;
   debug;
+  source;
   context;
   distinctId;
+  sessionId;
   flushTimer = null;
   closed = false;
   constructor(options) {
@@ -4235,6 +4237,8 @@ var Growth = class {
     this.transport = options.transport ?? fetchTransport;
     this.context = options.defaultContext ?? {};
     this.distinctId = generateId();
+    this.sessionId = options.sessionId;
+    this.source = options.source ?? "web";
     this.onError = options.onError ?? (() => {
     });
     this.debug = options.debug ?? false;
@@ -4255,6 +4259,9 @@ var Growth = class {
   setDistinctId(id) {
     this.distinctId = id;
   }
+  setSessionId(id) {
+    this.sessionId = id;
+  }
   setContext(context) {
     this.context = { ...this.context, ...context };
   }
@@ -4263,8 +4270,9 @@ var Growth = class {
     const event = {
       name,
       distinct_id: options?.distinctId ?? this.distinctId,
+      ...this.sessionId ? { session_id: this.sessionId } : {},
       timestamp: (options?.timestamp ?? /* @__PURE__ */ new Date()).toISOString(),
-      source: "web",
+      source: this.source,
       properties,
       context: { ...this.context, ...options?.context }
     };
@@ -4368,14 +4376,29 @@ function button(growth, name, handler, properties) {
     return handler?.(...args);
   };
 }
+function revenue(growth, event, amountCents, options) {
+  const props = {
+    amount_cents: amountCents,
+    currency: options?.currency ?? "usd"
+  };
+  if (options?.plan) props.plan = options.plan;
+  if (options?.interval) props.interval = options.interval;
+  if (options?.properties) Object.assign(props, options.properties);
+  growth.track(event, props, {
+    distinctId: options?.distinctId,
+    timestamp: options?.timestamp,
+    context: options?.context
+  });
+}
 function instrument(growth) {
   const g = growth;
   g.span = (name, fn, options) => span(growth, name, fn, options);
   g.step = (funnelStep, properties, options) => step(growth, funnelStep, properties, options);
   g.button = (name, handler, properties) => button(growth, name, handler, properties);
+  g.revenue = (event, amountCents, options) => revenue(growth, event, amountCents, options);
   return g;
 }
 
-export { Growth, button, createClient, instrument, span, step };
+export { Growth, button, createClient, instrument, revenue, span, step };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map