@galva-io/galva-admin-node 1.0.0-dev

package/README.md

@@ -0,0 +1,218 @@
+# Galva Admin Node SDK
+
+TypeScript SDK for integrating with Galva Admin API. This SDK provides a type-safe way to sync billing events and manage user data.
+
+## Installation
+
+```bash
+npm install galva-admin-node
+```
+
+## Quick Start
+
+```typescript
+import galvaAdmin from 'galva-admin-node';
+
+const galva = galvaAdmin({
+  apiKey: 'your-api-key-here',
+  baseUrl: 'https://api.galva.io', // optional
+  debug: true // optional, enables logging
+});
+```
+
+## Usage Examples
+
+### Track a Purchase
+
+```typescript
+await galva.trackPurchase({
+  id: 'evt_123',
+  endUserId: 'user_456',
+  appIdentifier: 'com.example.app',
+  productIdentifier: 'premium_monthly',
+  planIdentifier: 'monthly',
+  platform: 'ios',
+  eventTimestamp: new Date().toISOString(),
+  purchasedAt: new Date().toISOString(),
+  expiresAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString(),
+  isTrial: false
+});
+```
+
+### Track a Renewal
+
+```typescript
+await galva.trackRenewal({
+  id: 'evt_124',
+  endUserId: 'user_456',
+  appIdentifier: 'com.example.app',
+  productIdentifier: 'premium_monthly',
+  planIdentifier: 'monthly',
+  platform: 'ios',
+  eventTimestamp: new Date().toISOString(),
+  purchasedAt: new Date().toISOString(),
+  expiresAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString()
+});
+```
+
+### Track a Cancellation
+
+```typescript
+await galva.trackCancellation({
+  id: 'evt_125',
+  endUserId: 'user_456',
+  appIdentifier: 'com.example.app',
+  productIdentifier: 'premium_monthly',
+  planIdentifier: 'monthly',
+  platform: 'ios',
+  eventTimestamp: new Date().toISOString(),
+  cancelReason: 'too_expensive',
+  expiresAt: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString()
+});
+```
+
+### Identify a User
+
+```typescript
+await galva.identify({
+  userId: 'user_456',
+  email: 'user@example.com',
+  name: 'John Doe',
+  attributes: {
+    plan: 'premium',
+    signupDate: '2024-01-01',
+    referralSource: 'organic'
+  }
+});
+```
+
+### Sync Multiple Events (Batch)
+
+```typescript
+const events = [
+  {
+    id: 'evt_126',
+    type: 'initial-purchase' as const,
+    endUserId: 'user_789',
+    appIdentifier: 'com.example.app',
+    productIdentifier: 'premium_yearly',
+    planIdentifier: 'yearly',
+    platform: 'android' as const,
+    eventTimestamp: new Date().toISOString(),
+    purchasedAt: new Date().toISOString(),
+    expiresAt: new Date(Date.now() + 365 * 24 * 60 * 60 * 1000).toISOString()
+  },
+  // ... more events
+];
+
+await galva.syncEvents(events);
+```
+
+### Queue Events for Batch Processing
+
+```typescript
+// Queue events (they'll be automatically batched)
+galva.queueEvent({
+  id: 'evt_127',
+  type: 'renewal',
+  endUserId: 'user_123',
+  appIdentifier: 'com.example.app',
+  productIdentifier: 'premium_monthly',
+  planIdentifier: 'monthly',
+  platform: 'stripe',
+  eventTimestamp: new Date().toISOString(),
+  purchasedAt: new Date().toISOString()
+}, {
+  maxBatchSize: 50,    // Flush after 50 events
+  flushInterval: 10000 // Flush every 10 seconds
+});
+
+// Manually flush queued events
+await galva.flush();
+```
+
+## API Reference
+
+### Configuration
+
+```typescript
+interface GalvaConfig {
+  apiKey: string;       // Required: Your API key
+  baseUrl?: string;     // Optional: API base URL (default: https://api.galva.io)
+  timeout?: number;     // Optional: Request timeout in ms (default: 30000)
+  debug?: boolean;      // Optional: Enable debug logging (default: false)
+}
+```
+
+### Methods
+
+#### Event Tracking
+
+- `trackPurchase(event)` - Track an initial purchase event
+- `trackRenewal(event)` - Track a subscription renewal
+- `trackCancellation(event)` - Track a subscription cancellation
+- `trackBillingIssue(event)` - Track a billing issue
+- `trackExpiration(event)` - Track a subscription expiration
+- `trackUpgrade(event)` - Track a plan upgrade
+- `trackRefund(event)` - Track a refund
+
+#### Generic Event Methods
+
+- `syncEvent(event)` - Sync a single billing event
+- `syncEvents(events)` - Batch sync multiple events
+- `queueEvent(event, options?)` - Queue an event for batch processing
+- `flush()` - Manually flush the event queue
+
+#### User Management
+
+- `identify(userData)` - Identify a user and sync their attributes
+- `getUserStatus(userId)` - Get a user's subscription status
+
+#### Utility
+
+- `healthCheck()` - Check API health status
+
+### Event Types
+
+The SDK supports the following billing event types:
+
+- `initial-purchase` - New subscription or trial
+- `renewal` - Subscription renewal
+- `cancellation` - Subscription cancellation
+- `billing-issue` - Payment failure or issue
+- `expiration` - Subscription expiration
+- `upgraded` - Plan upgrade
+- `refund` - Refund processed
+- `resubscribe` - User resubscribed
+- `transfer` - Subscription transferred between users
+- `grace_period_start` - Grace period started
+
+### Error Handling
+
+```typescript
+import { GalvaError } from 'galva-admin-node';
+
+try {
+  await galva.trackPurchase(eventData);
+} catch (error) {
+  if (error instanceof GalvaError) {
+    console.error('Galva API Error:', {
+      code: error.code,
+      message: error.message,
+      statusCode: error.statusCode,
+      details: error.details
+    });
+  } else {
+    console.error('Unexpected error:', error);
+  }
+}
+```
+
+## Requirements
+
+- Node.js 18.0 or higher (for native fetch support)
+- TypeScript 5.0 or higher (for development)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,4 @@
+'use strict';var googleapis=require('googleapis'),paddleNodeSdk=require('@paddle/paddle-node-sdk');var T=n=>{let e=new googleapis.google.auth.JWT({email:n.email,key:n.key.replace(/\\n/g,`
+`),scopes:["https://www.googleapis.com/auth/androidpublisher"]});return googleapis.google.androidpublisher({version:"v3",auth:e})},p=class{static async getSubscription(e,t,a){return await T({email:a.email,key:a.key}).purchases.subscriptionsv2.get({token:e,packageName:t})}};var u=(o=>(o.TIMEZONE="$gv_timezone",o.LANGUAGE_CODE="$gv_languageCode",o.EMAIL="$gv_email",o.FULL_NAME="$gv_fullName",o.FIRST_NAME="$gv_firstName",o.LAST_NAME="$gv_lastName",o.COUNTRY="$gv_country",o.TOTAL_LIFETIME_VALUE="$gv_totalLifetimeValue",o))(u||{}),N={$gv_timezone:"timezone",$gv_languageCode:"languageCode",$gv_email:"email",$gv_fullName:"fullName",$gv_firstName:"firstName",$gv_lastName:"lastName",$gv_country:"country",$gv_totalLifetimeValue:"totalLifetimeValue"},m={timezone:"$gv_timezone",languageCode:"$gv_languageCode",email:"$gv_email",fullName:"$gv_fullName",firstName:"$gv_firstName",lastName:"$gv_lastName",country:"$gv_country",totalLifetimeValue:"$gv_totalLifetimeValue"};var s=class n extends Error{code;constructor(e){super(e.message),this.name="GalvaError",this.code=e.code,Error.captureStackTrace&&Error.captureStackTrace(this,n);}static from(e){if(e instanceof n)return e;let t=e instanceof Error?e.message:"An unknown error occurred";return new n({code:"UNKNOWN_ERROR",message:t})}};var A="https://api.galva.io",U="https://api.galva.dev",c=class{config;baseUrl;constructor(e){let t=e?.apiKey||process.env.GALVA_API_KEY;if(!t)throw new s({code:"MISSING_API_KEY",message:"API key is required. Provide it in options or set GALVA_API_KEY env variable."});this.config={apiKey:t,environment:e?.environment||(process.env.NODE_ENV==="development"?"development":"production"),timeout:e?.timeout||1e4},this.baseUrl=this.config.environment==="development"?U:A;}async sendRequest(e,t,a){let r=`${this.baseUrl}${t}`,i=new AbortController,l=setTimeout(()=>i.abort(),this.config.timeout);try{let d=await fetch(r,{method:e,headers:{"Content-Type":"application/json","x-api-key":this.config.apiKey},body:a?JSON.stringify(a):void 0,signal:i.signal});if(!d.ok){let o=await d.json();throw new s(o)}}catch(d){throw d instanceof s?d:d instanceof Error&&d.name==="AbortError"?new s({code:"TIMEOUT",message:`Request timed out after ${this.config.timeout}ms`}):s.from(d)}finally{clearTimeout(l);}}endUser={identify:async(e,t)=>{await this.sendRequest("POST","/endUsers:identify",{endUserId:e,timestamp:t?.timestamp,context:t?.context,traits:t?.traits});},updateDefaultInfo:async(e,t)=>{let a={};for(let[r,i]of Object.entries(t))if(i!==void 0){let l=m[r];a[l]=i;}await this.sendRequest("POST","/endUsers:identify",{endUserId:e,traits:a});}}},E=class extends c{credentials;constructor(e,t){super(e),this.credentials=t;}billingEvent={appstore:async(e,t,a)=>{if(!this.credentials.appstore)throw new s({code:"MISSING_CREDENTIALS",message:"App Store credentials are required. Provide them in withCredentials()."});await this.sendRequest("POST","/endUsers/billingEvents",{platform:"appstore",endUserId:e,payload:{signedPayload:t,appAppleId:this.credentials.appstore.appAppleId,bundleId:this.credentials.appstore.bundleId,env:this.config.environment},options:a});},playstore:async(e,t)=>{if(!this.credentials.playstore)throw new s({code:"MISSING_CREDENTIALS",message:"Play Store credentials are required. Provide them in withCredentials()."});let a=Buffer.from(t,"base64").toString(),r=null;try{r=JSON.parse(a);}catch{throw new s({code:"INVALID_PAYLOAD",message:"Invalid base64 payload: unable to parse JSON."})}if(!r||typeof r!="object")throw new s({code:"INVALID_PAYLOAD",message:"Decoded payload is not a valid JSON object."});if(!("subscriptionNotification"in r))throw new s({code:"INVALID_PAYLOAD",message:"Decoded payload does not contain subscriptionNotification field."});let i=await p.getSubscription(r.subscriptionNotification.purchaseToken,r.packageName,this.credentials.playstore),l={...r,subscriptionNotification:{...r.subscriptionNotification,subscriptionPurchase:i.data}};await this.sendRequest("POST","/endUsers/billingEvents",{platform:"playstore",endUserId:e,payload:l});},paddle:async(e,t,a)=>{if(!this.credentials.paddle)throw new s({code:"MISSING_CREDENTIALS",message:"Paddle credentials are required. Provide them in withCredentials()."});let r=new paddleNodeSdk.Paddle(this.credentials.paddle.apiKey),i;try{i=await r.webhooks.unmarshal(t,this.credentials.paddle.secretKey,a);}catch(l){throw new s({code:"INVALID_WEBHOOK",message:`Invalid Paddle webhook data: ${l.message}`})}await this.sendRequest("POST","/endUsers/billingEvents",{platform:"paddle",endUserId:e,payload:i});}}},g=class extends c{constructor(e){super(e);}billingEvent={appstore:async(e,t,a)=>{let{signedPayload:r,bundleId:i,appAppleId:l}=t;await this.sendRequest("POST","/endUsers/billingEvents",{platform:"appstore",endUserId:e,payload:{signedPayload:r,appAppleId:l,bundleId:i,env:this.config.environment},options:a});},playstore:async(e,t)=>{await this.sendRequest("POST","/endUsers/billingEvents",{platform:"playstore",endUserId:e,payload:t});},paddle:async(e,t)=>{await this.sendRequest("POST","/endUsers/billingEvents",{platform:"paddle",endUserId:e,payload:t});}};withCredentials(e){return new E(this.config,e)}};
+exports.END_USER_DEFAULT_INFO_TO_TRAIT_MAP=m;exports.END_USER_DEFAULT_TRAIT_MAP=N;exports.EndUserDefaultTraitName=u;exports.Galva=g;exports.GalvaError=s;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/playstore.ts","../src/types/endUser.ts","../src/types/error.ts","../src/galva.ts"],"names":["authentication","payload","jwtClient","google","PlaystoreService","token","packageName","cred","EndUserDefaultTraitName","END_USER_DEFAULT_TRAIT_MAP","END_USER_DEFAULT_INFO_TO_TRAIT_MAP","GalvaError","_GalvaError","response","error","message","PRODUCTION_API_URL","DEVELOPMENT_API_URL","GalvaBase","options","apiKey","method","endpoint","data","url","controller","timeoutId","errorResponse","endUserId","defaultInfo","traits","key","value","traitName","GalvaWithCreds","config","credentials","signedPayload","base64Payload","decodedPayloadString","decodedPayload","subscription","finalPayload","rawBody","signature","paddle","Paddle","eventData","Galva","bundleId","appAppleId","eventEntity"],"mappings":"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","file":"index.cjs","sourcesContent":["import { PlaystoreCredentials } from '@/galva';\nimport { google } from 'googleapis';\n\nconst authentication = (payload: { email: string; key: string }) => {\n  const jwtClient = new google.auth.JWT({\n    email: payload.email,\n    key: payload.key.replace(/\\\\n/g, '\\n'),\n    scopes: ['https://www.googleapis.com/auth/androidpublisher'],\n  });\n  return google.androidpublisher({\n    version: 'v3',\n    auth: jwtClient,\n  });\n};\n\nexport class PlaystoreService {\n  static async getSubscription(\n    token: string,\n    packageName: string,\n    cred: PlaystoreCredentials,\n  ): Promise<any> {\n    const client = authentication({\n      email: cred.email,\n      key: cred.key,\n    });\n\n    const result = await client.purchases.subscriptionsv2.get({\n      token,\n      packageName,\n    });\n\n    return result;\n  }\n}\n","/**\n * Default trait names for end user profiles.\n * Use these constants for type-safe access to built-in traits.\n */\nexport enum EndUserDefaultTraitName {\n  TIMEZONE = \"$gv_timezone\",\n  LANGUAGE_CODE = \"$gv_languageCode\",\n  EMAIL = \"$gv_email\",\n  FULL_NAME = \"$gv_fullName\",\n  FIRST_NAME = \"$gv_firstName\",\n  LAST_NAME = \"$gv_lastName\",\n  COUNTRY = \"$gv_country\",\n  TOTAL_LIFETIME_VALUE = \"$gv_totalLifetimeValue\",\n}\n\n/**\n * Built-in trait types with their expected value types.\n */\nexport interface EndUserDefaultTraits {\n  [EndUserDefaultTraitName.TIMEZONE]?: string;\n  [EndUserDefaultTraitName.LANGUAGE_CODE]?: string;\n  [EndUserDefaultTraitName.EMAIL]?: string;\n  [EndUserDefaultTraitName.FULL_NAME]?: string;\n  [EndUserDefaultTraitName.FIRST_NAME]?: string;\n  [EndUserDefaultTraitName.LAST_NAME]?: string;\n  [EndUserDefaultTraitName.COUNTRY]?: string;\n  [EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE]?: number;\n}\n\n/**\n * End user traits combining default traits with arbitrary custom traits.\n */\nexport type EndUserTraits = EndUserDefaultTraits & Record<string, any>;\n\n/**\n * Friendly parameter names for updating end user default info.\n * Maps to the underlying $gv_ prefixed trait names.\n */\nexport interface EndUserDefaultInfo {\n  timezone?: string;\n  languageCode?: string;\n  email?: string;\n  fullName?: string;\n  firstName?: string;\n  lastName?: string;\n  country?: string;\n  totalLifetimeValue?: number;\n}\n\n/**\n * Mapping from friendly parameter names to original trait names.\n * TypeScript ensures this mapping contains all keys from EndUserDefaultTraitName.\n */\nexport const END_USER_DEFAULT_TRAIT_MAP: Record<\n  EndUserDefaultTraitName,\n  keyof EndUserDefaultInfo\n> = {\n  [EndUserDefaultTraitName.TIMEZONE]: \"timezone\",\n  [EndUserDefaultTraitName.LANGUAGE_CODE]: \"languageCode\",\n  [EndUserDefaultTraitName.EMAIL]: \"email\",\n  [EndUserDefaultTraitName.FULL_NAME]: \"fullName\",\n  [EndUserDefaultTraitName.FIRST_NAME]: \"firstName\",\n  [EndUserDefaultTraitName.LAST_NAME]: \"lastName\",\n  [EndUserDefaultTraitName.COUNTRY]: \"country\",\n  [EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE]: \"totalLifetimeValue\",\n};\n\n/**\n * Reverse mapping from friendly parameter names to trait names.\n * TypeScript ensures this mapping contains all keys from EndUserDefaultInfo.\n */\nexport const END_USER_DEFAULT_INFO_TO_TRAIT_MAP: Record<\n  keyof EndUserDefaultInfo,\n  EndUserDefaultTraitName\n> = {\n  timezone: EndUserDefaultTraitName.TIMEZONE,\n  languageCode: EndUserDefaultTraitName.LANGUAGE_CODE,\n  email: EndUserDefaultTraitName.EMAIL,\n  fullName: EndUserDefaultTraitName.FULL_NAME,\n  firstName: EndUserDefaultTraitName.FIRST_NAME,\n  lastName: EndUserDefaultTraitName.LAST_NAME,\n  country: EndUserDefaultTraitName.COUNTRY,\n  totalLifetimeValue: EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE,\n};\n","/**\n * Error response structure from Galva API.\n */\nexport interface GalvaErrorResponse {\n  code: string;\n  message: string;\n}\n\n/**\n * Custom error class for Galva SDK errors.\n * Extends Error with additional properties from API error responses.\n */\nexport class GalvaError extends Error {\n  /** Error code from the API (e.g., 'BAD_REQUEST', 'UNAUTHORIZED') */\n  readonly code: string;\n\n  constructor(response: GalvaErrorResponse) {\n    super(response.message);\n    this.name = \"GalvaError\";\n    this.code = response.code;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, GalvaError);\n    }\n  }\n\n  /**\n   * Creates a GalvaError from an unknown error.\n   * If the error is already a GalvaError, returns it as-is.\n   * Otherwise, wraps it in a GalvaError with UNKNOWN_ERROR code.\n   */\n  static from(error: unknown): GalvaError {\n    if (error instanceof GalvaError) {\n      return error;\n    }\n\n    const message =\n      error instanceof Error ? error.message : \"An unknown error occurred\";\n\n    return new GalvaError({\n      code: \"UNKNOWN_ERROR\",\n      message,\n    });\n  }\n}\n","import { PlaystoreDeveloperNotification } from './types/playstore';\nimport { PlaystoreService } from './services/playstore';\nimport { EventEntity, Paddle } from '@paddle/paddle-node-sdk';\nimport type { EndUserTraits, EndUserDefaultInfo } from './types/endUser';\nimport { END_USER_DEFAULT_INFO_TO_TRAIT_MAP } from './types/endUser';\nimport { GalvaError } from './types/error';\n\nexport type {\n  EndUserDefaultTraits,\n  EndUserTraits,\n  EndUserDefaultInfo,\n} from './types/endUser';\nexport {\n  EndUserDefaultTraitName,\n  END_USER_DEFAULT_TRAIT_MAP,\n  END_USER_DEFAULT_INFO_TO_TRAIT_MAP,\n} from './types/endUser';\nexport { GalvaError } from './types/error';\nexport type { GalvaErrorResponse } from './types/error';\n\nexport interface GalvaOptions {\n  /**\n   * Defaults to 'production'. Falls back to NODE_ENV.\n   * @type {('production' | 'development')}\n   */\n  environment?: 'production' | 'development';\n\n  /**\n   * API key from Galva dashboard. Falls back to GALVA_API_KEY env var.\n   * @type {string}\n   */\n  apiKey?: string;\n\n  /**\n   * Request timeout in ms. Defaults to 10000.\n   * @type {number}\n   */\n  timeout?: number;\n}\n\n/**\n * Credentials for authenticating with the Google Play Store API.\n *\n * @interface PlaystoreCredentials\n */\nexport interface PlaystoreCredentials {\n  /** Service account email address */\n  email: string;\n  /** Service account private key */\n  key: string;\n}\n\n/**\n * Credentials for authenticating and verifying Paddle webhooks.\n *\n * @interface PaddleCredentials\n */\nexport interface PaddleCredentials {\n  /** Paddle API key */\n  apiKey: string;\n  /** Webhook secret key for signature verification */\n  secretKey: string;\n}\n\n/**\n * Credentials for Apple App Store.\n *\n * @interface AppstoreCredentials\n */\nexport interface AppstoreCredentials {\n  /** The app's bundle identifier (e.g., 'com.example.app') */\n  bundleId: string;\n  /** The app's Apple ID from App Store Connect */\n  appAppleId: number;\n}\n\n/**\n * Credentials configuration for withCredentials method.\n *\n * @interface CredentialsConfig\n */\nexport interface CredentialsConfig {\n  /** App Store credentials */\n  appstore?: AppstoreCredentials;\n  /** Play Store service account credentials */\n  playstore?: PlaystoreCredentials;\n  /** Paddle API credentials */\n  paddle?: PaddleCredentials;\n}\n\nconst PRODUCTION_API_URL = 'https://api.galva.io';\nconst DEVELOPMENT_API_URL = 'https://api.galva.dev';\n\n/**\n * Base Galva SDK client with end user management methods.\n * @class GalvaBase\n */\nclass GalvaBase {\n  protected config: GalvaOptions;\n  protected readonly baseUrl: string;\n\n  /**\n   * @param {GalvaOptions} [options] - Configuration options\n   * @throws {GalvaError} If API key is not provided\n   */\n  constructor(options?: GalvaOptions) {\n    const apiKey = options?.apiKey || process.env.GALVA_API_KEY;\n    if (!apiKey) {\n      throw new GalvaError({\n        code: 'MISSING_API_KEY',\n        message:\n          'API key is required. Provide it in options or set GALVA_API_KEY env variable.',\n      });\n    }\n\n    this.config = {\n      apiKey: apiKey,\n      environment:\n        options?.environment ||\n        (process.env.NODE_ENV === 'development' ? 'development' : 'production'),\n      timeout: options?.timeout || 10000,\n    };\n    this.baseUrl =\n      this.config.environment === 'development'\n        ? DEVELOPMENT_API_URL\n        : PRODUCTION_API_URL;\n  }\n\n  protected async sendRequest(\n    method: 'POST' | 'GET',\n    endpoint: string,\n    data?: unknown,\n  ): Promise<void> {\n    const url = `${this.baseUrl}${endpoint}`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: {\n          'Content-Type': 'application/json',\n          'x-api-key': this.config.apiKey!,\n        },\n        body: data ? JSON.stringify(data) : undefined,\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const errorResponse = await response.json();\n        throw new GalvaError(errorResponse);\n      }\n    } catch (error) {\n      if (error instanceof GalvaError) {\n        throw error;\n      }\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new GalvaError({\n          code: 'TIMEOUT',\n          message: `Request timed out after ${this.config.timeout}ms`,\n        });\n      }\n      throw GalvaError.from(error);\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /** End user management methods. */\n  public endUser = {\n    /**\n     * Identifies an end user with optional traits and context.\n     * @param {string} endUserId - End user ID in your system\n     * @param {Object} [options] - Identification data\n     * @param {string} [options.timestamp] - ISO 8601 timestamp\n     * @param {Record<string, any>} [options.context] - Additional context\n     * @param {EndUserTraits} [options.traits] - User traits. Use EndUserDefaultTraitName for built-in traits.\n     * @throws {GalvaError} If API request fails\n     * @example\n     * ```typescript\n     * await galva.endUser.identify('user-123', {\n     *   traits: { [EndUserDefaultTraitName.EMAIL]: 'user@example.com' },\n     * });\n     * ```\n     */\n    identify: async (\n      endUserId: string,\n      options?: {\n        timestamp?: string;\n        context?: Record<string, any>;\n        traits?: EndUserTraits;\n      },\n    ): Promise<void> => {\n      await this.sendRequest('POST', '/endUsers:identify', {\n        endUserId,\n        timestamp: options?.timestamp,\n        context: options?.context,\n        traits: options?.traits,\n      });\n    },\n\n    /**\n     * Updates an end user's default profile info.\n     * @param {string} endUserId - End user ID in your system\n     * @param {EndUserDefaultInfo} defaultInfo - Profile info to update\n     * @throws {GalvaError} If API request fails\n     * @example\n     * ```typescript\n     * await galva.endUser.updateDefaultInfo('user-123', {\n     *   email: 'user@example.com',\n     *   fullName: 'John Doe',\n     * });\n     * ```\n     */\n    updateDefaultInfo: async (\n      endUserId: string,\n      defaultInfo: EndUserDefaultInfo,\n    ): Promise<void> => {\n      const traits: EndUserTraits = {};\n\n      for (const [key, value] of Object.entries(defaultInfo)) {\n        if (value !== undefined) {\n          const traitName =\n            END_USER_DEFAULT_INFO_TO_TRAIT_MAP[key as keyof EndUserDefaultInfo];\n          traits[traitName] = value;\n        }\n      }\n\n      await this.sendRequest('POST', '/endUsers:identify', {\n        endUserId,\n        traits,\n      });\n    },\n  };\n}\n\nclass GalvaWithCreds extends GalvaBase {\n  // private config: GalvaOptions;\n  // private readonly baseUrl: string;\n  private credentials: CredentialsConfig;\n\n  /**\n   * @internal Use `galva.withCredentials(...)` instead.\n   */\n  constructor(config: GalvaOptions, credentials: CredentialsConfig) {\n    super(config);\n    // this.config = config;\n    // this.baseUrl = baseUrl;\n    this.credentials = credentials;\n  }\n\n  /**\n   * Billing event handlers with credential support.\n   * @property {Function} appstore - App Store events (signed payload only)\n   * @property {Function} playstore - Play Store events (raw base64 payload)\n   * @property {Function} paddle - Paddle events (raw body with verification)\n   */\n  public billingEvent = {\n    /**\n     * Tracks an App Store billing event. Uses credentials from withCredentials().\n     * @param {string} endUserId - End user ID\n     * @param {string} signedPayload - Signed payload from Apple\n     * @param {Record<string, any>} [options] - Additional options\n     * @returns {Promise<void>}\n     * @throws {GalvaError} If credentials missing or API fails\n     * @example\n     * ```typescript\n     * await galvaWithCreds.billingEvent.appstore('user-123', signedPayload);\n     * ```\n     */\n    appstore: async (\n      endUserId: string,\n      signedPayload: string,\n      options?: Record<string, any>,\n    ): Promise<void> => {\n      if (!this.credentials.appstore) {\n        throw new GalvaError({\n          code: 'MISSING_CREDENTIALS',\n          message:\n            'App Store credentials are required. Provide them in withCredentials().',\n        });\n      }\n\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'appstore',\n        endUserId,\n        payload: {\n          signedPayload,\n          appAppleId: this.credentials.appstore.appAppleId,\n          bundleId: this.credentials.appstore.bundleId,\n          env: this.config.environment,\n        },\n        options,\n      });\n    },\n\n    /**\n     * Tracks a Play Store billing event. Decodes payload and fetches subscription details.\n     * @param {string} endUserId - End user ID\n     * @param {string} base64Payload - Base64 payload from Pub/Sub\n     * @returns {Promise<void>}\n     * @throws {GalvaError} If credentials missing or API fails\n     * @example\n     * ```typescript\n     * await galvaWithCreds.billingEvent.playstore('user-123', base64Payload);\n     * ```\n     */\n    playstore: async (\n      endUserId: string,\n      base64Payload: string,\n    ): Promise<void> => {\n      if (!this.credentials.playstore) {\n        throw new GalvaError({\n          code: 'MISSING_CREDENTIALS',\n          message:\n            'Play Store credentials are required. Provide them in withCredentials().',\n        });\n      }\n\n      const decodedPayloadString = Buffer.from(\n        base64Payload,\n        'base64',\n      ).toString();\n      let decodedPayload: PlaystoreDeveloperNotification | null = null;\n      try {\n        decodedPayload = JSON.parse(decodedPayloadString);\n      } catch (error) {\n        throw new GalvaError({\n          code: 'INVALID_PAYLOAD',\n          message: 'Invalid base64 payload: unable to parse JSON.',\n        });\n      }\n\n      if (!decodedPayload || typeof decodedPayload !== 'object') {\n        throw new GalvaError({\n          code: 'INVALID_PAYLOAD',\n          message: 'Decoded payload is not a valid JSON object.',\n        });\n      }\n\n      if (!('subscriptionNotification' in decodedPayload)) {\n        throw new GalvaError({\n          code: 'INVALID_PAYLOAD',\n          message:\n            'Decoded payload does not contain subscriptionNotification field.',\n        });\n      }\n\n      const subscription = await PlaystoreService.getSubscription(\n        decodedPayload.subscriptionNotification.purchaseToken,\n        decodedPayload.packageName,\n        this.credentials.playstore,\n      );\n\n      const finalPayload: PlaystoreDeveloperNotification = {\n        ...decodedPayload,\n        subscriptionNotification: {\n          ...decodedPayload.subscriptionNotification,\n          subscriptionPurchase: subscription.data,\n        },\n      };\n\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'playstore',\n        endUserId,\n        payload: finalPayload,\n      });\n    },\n\n    /**\n     * Tracks a Paddle billing event. Verifies signature and unmarshals the event.\n     * @param {string} endUserId - End user ID\n     * @param {string} rawBody - Raw body from Paddle webhook\n     * @param {string} signature - Paddle-Signature header value\n     * @returns {Promise<void>}\n     * @throws {GalvaError} If credentials missing or API fails\n     * @example\n     * ```typescript\n     * await galvaWithCreds.billingEvent.paddle('user-123', rawBody, signature);\n     * ```\n     */\n    paddle: async (\n      endUserId: string,\n      rawBody: string,\n      signature: string,\n    ): Promise<void> => {\n      if (!this.credentials.paddle) {\n        throw new GalvaError({\n          code: 'MISSING_CREDENTIALS',\n          message:\n            'Paddle credentials are required. Provide them in withCredentials().',\n        });\n      }\n\n      const paddle = new Paddle(this.credentials.paddle.apiKey);\n      let eventData: EventEntity;\n\n      try {\n        eventData = await paddle.webhooks.unmarshal(\n          rawBody,\n          this.credentials.paddle.secretKey,\n          signature,\n        );\n      } catch (error) {\n        throw new GalvaError({\n          code: 'INVALID_WEBHOOK',\n          message: `Invalid Paddle webhook data: ${(error as Error).message}`,\n        });\n      }\n\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'paddle',\n        endUserId,\n        payload: eventData,\n      });\n    },\n  };\n}\n\nexport class Galva extends GalvaBase {\n  constructor(options?: GalvaOptions) {\n    super(options);\n  }\n\n  /**\n   * Billing event handlers for different payment platforms.\n   * @property {Function} appstore - App Store events\n   * @property {Function} playstore - Play Store events (decoded payload)\n   * @property {Function} paddle - Paddle events (verified event)\n   */\n  public billingEvent = {\n    /**\n     * Tracks an App Store billing event.\n     * @param {string} endUserId - End user ID\n     * @param {Object} payload - App Store notification payload\n     * @param {string} payload.signedPayload - Signed payload from Apple\n     * @param {string} payload.bundleId - App bundle identifier\n     * @param {number} payload.appAppleId - App Apple ID\n     * @param {Record<string, any>} [options] - Additional options\n     * @throws {GalvaError} If API request fails\n     * @example\n     * ```typescript\n     * await galva.billingEvent.appstore('user-123', {\n     *   signedPayload,\n     *   bundleId: 'com.example.app',\n     *   appAppleId: 123456789\n     * });\n     * ```\n     */\n    appstore: async (\n      endUserId: string,\n      payload: {\n        signedPayload: string;\n        bundleId: string;\n        appAppleId: number;\n      },\n      options?: Record<string, any>,\n    ): Promise<void> => {\n      const { signedPayload, bundleId, appAppleId } = payload;\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'appstore',\n        endUserId,\n        payload: {\n          signedPayload,\n          appAppleId: appAppleId,\n          bundleId: bundleId,\n          env: this.config.environment,\n        },\n        options,\n      });\n    },\n\n    /**\n     * Tracks a Play Store billing event with decoded notification.\n     * @param {string} endUserId - End user ID\n     * @param {PlaystoreDeveloperNotification} payload - Decoded developer notification\n     * @returns {Promise<void>}\n     * @example\n     * ```typescript\n     * await galva.billingEvent.playstore('user-123', decodedNotification);\n     * ```\n     */\n    playstore: async (\n      endUserId: string,\n      payload: PlaystoreDeveloperNotification,\n    ): Promise<void> => {\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'playstore',\n        endUserId,\n        payload,\n      });\n    },\n\n    /**\n     * Tracks a Paddle billing event with verified event entity.\n     * @param {string} endUserId - End user ID\n     * @param {EventEntity} eventEntity - Verified Paddle event\n     * @returns {Promise<void>}\n     * @example\n     * ```typescript\n     * await galva.billingEvent.paddle('user-123', verifiedEvent);\n     * ```\n     */\n    paddle: async (\n      endUserId: string,\n      eventEntity: EventEntity,\n    ): Promise<void> => {\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'paddle',\n        endUserId,\n        payload: eventEntity,\n      });\n    },\n  };\n\n  withCredentials(credentials: CredentialsConfig) {\n    return new GalvaWithCreds(this.config, credentials);\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,344 @@
+import { androidpublisher_v3 } from 'googleapis';
+import { EventEntity } from '@paddle/paddle-node-sdk';
+
+interface PlaystoreOneTimeProductNotification {
+    version: string;
+    notificationType: number;
+    purchaseToken: string;
+    sku: string;
+}
+interface PlaystoreVoidedPurchaseNotification {
+    purchaseToken: string;
+    orderId: string;
+    productType: number;
+    refundType: number;
+}
+interface PlaystoreSubscriptionNotification {
+    version: string;
+    notificationType: number;
+    purchaseToken: string;
+    subscriptionPurchase: androidpublisher_v3.Schema$SubscriptionPurchaseV2;
+}
+interface PlaystoreTestNotification {
+    version: string;
+}
+interface PlaystoreDeveloperNotificationBase {
+    version: string;
+    packageName: string;
+    eventTimeMillis: number;
+}
+type PlaystoreDeveloperNotification = (PlaystoreDeveloperNotificationBase & {
+    subscriptionNotification: PlaystoreSubscriptionNotification;
+}) | (PlaystoreDeveloperNotificationBase & {
+    oneTimeProductNotification: PlaystoreOneTimeProductNotification;
+}) | (PlaystoreDeveloperNotificationBase & {
+    voidedPurchaseNotification: PlaystoreVoidedPurchaseNotification;
+}) | (PlaystoreDeveloperNotificationBase & {
+    testNotification: PlaystoreTestNotification;
+});
+
+/**
+ * Default trait names for end user profiles.
+ * Use these constants for type-safe access to built-in traits.
+ */
+declare enum EndUserDefaultTraitName {
+    TIMEZONE = "$gv_timezone",
+    LANGUAGE_CODE = "$gv_languageCode",
+    EMAIL = "$gv_email",
+    FULL_NAME = "$gv_fullName",
+    FIRST_NAME = "$gv_firstName",
+    LAST_NAME = "$gv_lastName",
+    COUNTRY = "$gv_country",
+    TOTAL_LIFETIME_VALUE = "$gv_totalLifetimeValue"
+}
+/**
+ * Built-in trait types with their expected value types.
+ */
+interface EndUserDefaultTraits {
+    [EndUserDefaultTraitName.TIMEZONE]?: string;
+    [EndUserDefaultTraitName.LANGUAGE_CODE]?: string;
+    [EndUserDefaultTraitName.EMAIL]?: string;
+    [EndUserDefaultTraitName.FULL_NAME]?: string;
+    [EndUserDefaultTraitName.FIRST_NAME]?: string;
+    [EndUserDefaultTraitName.LAST_NAME]?: string;
+    [EndUserDefaultTraitName.COUNTRY]?: string;
+    [EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE]?: number;
+}
+/**
+ * End user traits combining default traits with arbitrary custom traits.
+ */
+type EndUserTraits = EndUserDefaultTraits & Record<string, any>;
+/**
+ * Friendly parameter names for updating end user default info.
+ * Maps to the underlying $gv_ prefixed trait names.
+ */
+interface EndUserDefaultInfo {
+    timezone?: string;
+    languageCode?: string;
+    email?: string;
+    fullName?: string;
+    firstName?: string;
+    lastName?: string;
+    country?: string;
+    totalLifetimeValue?: number;
+}
+/**
+ * Mapping from friendly parameter names to original trait names.
+ * TypeScript ensures this mapping contains all keys from EndUserDefaultTraitName.
+ */
+declare const END_USER_DEFAULT_TRAIT_MAP: Record<EndUserDefaultTraitName, keyof EndUserDefaultInfo>;
+/**
+ * Reverse mapping from friendly parameter names to trait names.
+ * TypeScript ensures this mapping contains all keys from EndUserDefaultInfo.
+ */
+declare const END_USER_DEFAULT_INFO_TO_TRAIT_MAP: Record<keyof EndUserDefaultInfo, EndUserDefaultTraitName>;
+
+/**
+ * Error response structure from Galva API.
+ */
+interface GalvaErrorResponse {
+    code: string;
+    message: string;
+}
+/**
+ * Custom error class for Galva SDK errors.
+ * Extends Error with additional properties from API error responses.
+ */
+declare class GalvaError extends Error {
+    /** Error code from the API (e.g., 'BAD_REQUEST', 'UNAUTHORIZED') */
+    readonly code: string;
+    constructor(response: GalvaErrorResponse);
+    /**
+     * Creates a GalvaError from an unknown error.
+     * If the error is already a GalvaError, returns it as-is.
+     * Otherwise, wraps it in a GalvaError with UNKNOWN_ERROR code.
+     */
+    static from(error: unknown): GalvaError;
+}
+
+interface GalvaOptions {
+    /**
+     * Defaults to 'production'. Falls back to NODE_ENV.
+     * @type {('production' | 'development')}
+     */
+    environment?: 'production' | 'development';
+    /**
+     * API key from Galva dashboard. Falls back to GALVA_API_KEY env var.
+     * @type {string}
+     */
+    apiKey?: string;
+    /**
+     * Request timeout in ms. Defaults to 10000.
+     * @type {number}
+     */
+    timeout?: number;
+}
+/**
+ * Credentials for authenticating with the Google Play Store API.
+ *
+ * @interface PlaystoreCredentials
+ */
+interface PlaystoreCredentials {
+    /** Service account email address */
+    email: string;
+    /** Service account private key */
+    key: string;
+}
+/**
+ * Credentials for authenticating and verifying Paddle webhooks.
+ *
+ * @interface PaddleCredentials
+ */
+interface PaddleCredentials {
+    /** Paddle API key */
+    apiKey: string;
+    /** Webhook secret key for signature verification */
+    secretKey: string;
+}
+/**
+ * Credentials for Apple App Store.
+ *
+ * @interface AppstoreCredentials
+ */
+interface AppstoreCredentials {
+    /** The app's bundle identifier (e.g., 'com.example.app') */
+    bundleId: string;
+    /** The app's Apple ID from App Store Connect */
+    appAppleId: number;
+}
+/**
+ * Credentials configuration for withCredentials method.
+ *
+ * @interface CredentialsConfig
+ */
+interface CredentialsConfig {
+    /** App Store credentials */
+    appstore?: AppstoreCredentials;
+    /** Play Store service account credentials */
+    playstore?: PlaystoreCredentials;
+    /** Paddle API credentials */
+    paddle?: PaddleCredentials;
+}
+/**
+ * Base Galva SDK client with end user management methods.
+ * @class GalvaBase
+ */
+declare class GalvaBase {
+    protected config: GalvaOptions;
+    protected readonly baseUrl: string;
+    /**
+     * @param {GalvaOptions} [options] - Configuration options
+     * @throws {GalvaError} If API key is not provided
+     */
+    constructor(options?: GalvaOptions);
+    protected sendRequest(method: 'POST' | 'GET', endpoint: string, data?: unknown): Promise<void>;
+    /** End user management methods. */
+    endUser: {
+        /**
+         * Identifies an end user with optional traits and context.
+         * @param {string} endUserId - End user ID in your system
+         * @param {Object} [options] - Identification data
+         * @param {string} [options.timestamp] - ISO 8601 timestamp
+         * @param {Record<string, any>} [options.context] - Additional context
+         * @param {EndUserTraits} [options.traits] - User traits. Use EndUserDefaultTraitName for built-in traits.
+         * @throws {GalvaError} If API request fails
+         * @example
+         * ```typescript
+         * await galva.endUser.identify('user-123', {
+         *   traits: { [EndUserDefaultTraitName.EMAIL]: 'user@example.com' },
+         * });
+         * ```
+         */
+        identify: (endUserId: string, options?: {
+            timestamp?: string;
+            context?: Record<string, any>;
+            traits?: EndUserTraits;
+        }) => Promise<void>;
+        /**
+         * Updates an end user's default profile info.
+         * @param {string} endUserId - End user ID in your system
+         * @param {EndUserDefaultInfo} defaultInfo - Profile info to update
+         * @throws {GalvaError} If API request fails
+         * @example
+         * ```typescript
+         * await galva.endUser.updateDefaultInfo('user-123', {
+         *   email: 'user@example.com',
+         *   fullName: 'John Doe',
+         * });
+         * ```
+         */
+        updateDefaultInfo: (endUserId: string, defaultInfo: EndUserDefaultInfo) => Promise<void>;
+    };
+}
+declare class GalvaWithCreds extends GalvaBase {
+    private credentials;
+    /**
+     * @internal Use `galva.withCredentials(...)` instead.
+     */
+    constructor(config: GalvaOptions, credentials: CredentialsConfig);
+    /**
+     * Billing event handlers with credential support.
+     * @property {Function} appstore - App Store events (signed payload only)
+     * @property {Function} playstore - Play Store events (raw base64 payload)
+     * @property {Function} paddle - Paddle events (raw body with verification)
+     */
+    billingEvent: {
+        /**
+         * Tracks an App Store billing event. Uses credentials from withCredentials().
+         * @param {string} endUserId - End user ID
+         * @param {string} signedPayload - Signed payload from Apple
+         * @param {Record<string, any>} [options] - Additional options
+         * @returns {Promise<void>}
+         * @throws {GalvaError} If credentials missing or API fails
+         * @example
+         * ```typescript
+         * await galvaWithCreds.billingEvent.appstore('user-123', signedPayload);
+         * ```
+         */
+        appstore: (endUserId: string, signedPayload: string, options?: Record<string, any>) => Promise<void>;
+        /**
+         * Tracks a Play Store billing event. Decodes payload and fetches subscription details.
+         * @param {string} endUserId - End user ID
+         * @param {string} base64Payload - Base64 payload from Pub/Sub
+         * @returns {Promise<void>}
+         * @throws {GalvaError} If credentials missing or API fails
+         * @example
+         * ```typescript
+         * await galvaWithCreds.billingEvent.playstore('user-123', base64Payload);
+         * ```
+         */
+        playstore: (endUserId: string, base64Payload: string) => Promise<void>;
+        /**
+         * Tracks a Paddle billing event. Verifies signature and unmarshals the event.
+         * @param {string} endUserId - End user ID
+         * @param {string} rawBody - Raw body from Paddle webhook
+         * @param {string} signature - Paddle-Signature header value
+         * @returns {Promise<void>}
+         * @throws {GalvaError} If credentials missing or API fails
+         * @example
+         * ```typescript
+         * await galvaWithCreds.billingEvent.paddle('user-123', rawBody, signature);
+         * ```
+         */
+        paddle: (endUserId: string, rawBody: string, signature: string) => Promise<void>;
+    };
+}
+declare class Galva extends GalvaBase {
+    constructor(options?: GalvaOptions);
+    /**
+     * Billing event handlers for different payment platforms.
+     * @property {Function} appstore - App Store events
+     * @property {Function} playstore - Play Store events (decoded payload)
+     * @property {Function} paddle - Paddle events (verified event)
+     */
+    billingEvent: {
+        /**
+         * Tracks an App Store billing event.
+         * @param {string} endUserId - End user ID
+         * @param {Object} payload - App Store notification payload
+         * @param {string} payload.signedPayload - Signed payload from Apple
+         * @param {string} payload.bundleId - App bundle identifier
+         * @param {number} payload.appAppleId - App Apple ID
+         * @param {Record<string, any>} [options] - Additional options
+         * @throws {GalvaError} If API request fails
+         * @example
+         * ```typescript
+         * await galva.billingEvent.appstore('user-123', {
+         *   signedPayload,
+         *   bundleId: 'com.example.app',
+         *   appAppleId: 123456789
+         * });
+         * ```
+         */
+        appstore: (endUserId: string, payload: {
+            signedPayload: string;
+            bundleId: string;
+            appAppleId: number;
+        }, options?: Record<string, any>) => Promise<void>;
+        /**
+         * Tracks a Play Store billing event with decoded notification.
+         * @param {string} endUserId - End user ID
+         * @param {PlaystoreDeveloperNotification} payload - Decoded developer notification
+         * @returns {Promise<void>}
+         * @example
+         * ```typescript
+         * await galva.billingEvent.playstore('user-123', decodedNotification);
+         * ```
+         */
+        playstore: (endUserId: string, payload: PlaystoreDeveloperNotification) => Promise<void>;
+        /**
+         * Tracks a Paddle billing event with verified event entity.
+         * @param {string} endUserId - End user ID
+         * @param {EventEntity} eventEntity - Verified Paddle event
+         * @returns {Promise<void>}
+         * @example
+         * ```typescript
+         * await galva.billingEvent.paddle('user-123', verifiedEvent);
+         * ```
+         */
+        paddle: (endUserId: string, eventEntity: EventEntity) => Promise<void>;
+    };
+    withCredentials(credentials: CredentialsConfig): GalvaWithCreds;
+}
+
+export { type AppstoreCredentials, type CredentialsConfig, END_USER_DEFAULT_INFO_TO_TRAIT_MAP, END_USER_DEFAULT_TRAIT_MAP, type EndUserDefaultInfo, EndUserDefaultTraitName, type EndUserDefaultTraits, type EndUserTraits, Galva, GalvaError, type GalvaErrorResponse, type GalvaOptions, type PaddleCredentials, type PlaystoreCredentials };

package/dist/index.d.ts

@@ -0,0 +1,344 @@
+import { androidpublisher_v3 } from 'googleapis';
+import { EventEntity } from '@paddle/paddle-node-sdk';
+
+interface PlaystoreOneTimeProductNotification {
+    version: string;
+    notificationType: number;
+    purchaseToken: string;
+    sku: string;
+}
+interface PlaystoreVoidedPurchaseNotification {
+    purchaseToken: string;
+    orderId: string;
+    productType: number;
+    refundType: number;
+}
+interface PlaystoreSubscriptionNotification {
+    version: string;
+    notificationType: number;
+    purchaseToken: string;
+    subscriptionPurchase: androidpublisher_v3.Schema$SubscriptionPurchaseV2;
+}
+interface PlaystoreTestNotification {
+    version: string;
+}
+interface PlaystoreDeveloperNotificationBase {
+    version: string;
+    packageName: string;
+    eventTimeMillis: number;
+}
+type PlaystoreDeveloperNotification = (PlaystoreDeveloperNotificationBase & {
+    subscriptionNotification: PlaystoreSubscriptionNotification;
+}) | (PlaystoreDeveloperNotificationBase & {
+    oneTimeProductNotification: PlaystoreOneTimeProductNotification;
+}) | (PlaystoreDeveloperNotificationBase & {
+    voidedPurchaseNotification: PlaystoreVoidedPurchaseNotification;
+}) | (PlaystoreDeveloperNotificationBase & {
+    testNotification: PlaystoreTestNotification;
+});
+
+/**
+ * Default trait names for end user profiles.
+ * Use these constants for type-safe access to built-in traits.
+ */
+declare enum EndUserDefaultTraitName {
+    TIMEZONE = "$gv_timezone",
+    LANGUAGE_CODE = "$gv_languageCode",
+    EMAIL = "$gv_email",
+    FULL_NAME = "$gv_fullName",
+    FIRST_NAME = "$gv_firstName",
+    LAST_NAME = "$gv_lastName",
+    COUNTRY = "$gv_country",
+    TOTAL_LIFETIME_VALUE = "$gv_totalLifetimeValue"
+}
+/**
+ * Built-in trait types with their expected value types.
+ */
+interface EndUserDefaultTraits {
+    [EndUserDefaultTraitName.TIMEZONE]?: string;
+    [EndUserDefaultTraitName.LANGUAGE_CODE]?: string;
+    [EndUserDefaultTraitName.EMAIL]?: string;
+    [EndUserDefaultTraitName.FULL_NAME]?: string;
+    [EndUserDefaultTraitName.FIRST_NAME]?: string;
+    [EndUserDefaultTraitName.LAST_NAME]?: string;
+    [EndUserDefaultTraitName.COUNTRY]?: string;
+    [EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE]?: number;
+}
+/**
+ * End user traits combining default traits with arbitrary custom traits.
+ */
+type EndUserTraits = EndUserDefaultTraits & Record<string, any>;
+/**
+ * Friendly parameter names for updating end user default info.
+ * Maps to the underlying $gv_ prefixed trait names.
+ */
+interface EndUserDefaultInfo {
+    timezone?: string;
+    languageCode?: string;
+    email?: string;
+    fullName?: string;
+    firstName?: string;
+    lastName?: string;
+    country?: string;
+    totalLifetimeValue?: number;
+}
+/**
+ * Mapping from friendly parameter names to original trait names.
+ * TypeScript ensures this mapping contains all keys from EndUserDefaultTraitName.
+ */
+declare const END_USER_DEFAULT_TRAIT_MAP: Record<EndUserDefaultTraitName, keyof EndUserDefaultInfo>;
+/**
+ * Reverse mapping from friendly parameter names to trait names.
+ * TypeScript ensures this mapping contains all keys from EndUserDefaultInfo.
+ */
+declare const END_USER_DEFAULT_INFO_TO_TRAIT_MAP: Record<keyof EndUserDefaultInfo, EndUserDefaultTraitName>;
+
+/**
+ * Error response structure from Galva API.
+ */
+interface GalvaErrorResponse {
+    code: string;
+    message: string;
+}
+/**
+ * Custom error class for Galva SDK errors.
+ * Extends Error with additional properties from API error responses.
+ */
+declare class GalvaError extends Error {
+    /** Error code from the API (e.g., 'BAD_REQUEST', 'UNAUTHORIZED') */
+    readonly code: string;
+    constructor(response: GalvaErrorResponse);
+    /**
+     * Creates a GalvaError from an unknown error.
+     * If the error is already a GalvaError, returns it as-is.
+     * Otherwise, wraps it in a GalvaError with UNKNOWN_ERROR code.
+     */
+    static from(error: unknown): GalvaError;
+}
+
+interface GalvaOptions {
+    /**
+     * Defaults to 'production'. Falls back to NODE_ENV.
+     * @type {('production' | 'development')}
+     */
+    environment?: 'production' | 'development';
+    /**
+     * API key from Galva dashboard. Falls back to GALVA_API_KEY env var.
+     * @type {string}
+     */
+    apiKey?: string;
+    /**
+     * Request timeout in ms. Defaults to 10000.
+     * @type {number}
+     */
+    timeout?: number;
+}
+/**
+ * Credentials for authenticating with the Google Play Store API.
+ *
+ * @interface PlaystoreCredentials
+ */
+interface PlaystoreCredentials {
+    /** Service account email address */
+    email: string;
+    /** Service account private key */
+    key: string;
+}
+/**
+ * Credentials for authenticating and verifying Paddle webhooks.
+ *
+ * @interface PaddleCredentials
+ */
+interface PaddleCredentials {
+    /** Paddle API key */
+    apiKey: string;
+    /** Webhook secret key for signature verification */
+    secretKey: string;
+}
+/**
+ * Credentials for Apple App Store.
+ *
+ * @interface AppstoreCredentials
+ */
+interface AppstoreCredentials {
+    /** The app's bundle identifier (e.g., 'com.example.app') */
+    bundleId: string;
+    /** The app's Apple ID from App Store Connect */
+    appAppleId: number;
+}
+/**
+ * Credentials configuration for withCredentials method.
+ *
+ * @interface CredentialsConfig
+ */
+interface CredentialsConfig {
+    /** App Store credentials */
+    appstore?: AppstoreCredentials;
+    /** Play Store service account credentials */
+    playstore?: PlaystoreCredentials;
+    /** Paddle API credentials */
+    paddle?: PaddleCredentials;
+}
+/**
+ * Base Galva SDK client with end user management methods.
+ * @class GalvaBase
+ */
+declare class GalvaBase {
+    protected config: GalvaOptions;
+    protected readonly baseUrl: string;
+    /**
+     * @param {GalvaOptions} [options] - Configuration options
+     * @throws {GalvaError} If API key is not provided
+     */
+    constructor(options?: GalvaOptions);
+    protected sendRequest(method: 'POST' | 'GET', endpoint: string, data?: unknown): Promise<void>;
+    /** End user management methods. */
+    endUser: {
+        /**
+         * Identifies an end user with optional traits and context.
+         * @param {string} endUserId - End user ID in your system
+         * @param {Object} [options] - Identification data
+         * @param {string} [options.timestamp] - ISO 8601 timestamp
+         * @param {Record<string, any>} [options.context] - Additional context
+         * @param {EndUserTraits} [options.traits] - User traits. Use EndUserDefaultTraitName for built-in traits.
+         * @throws {GalvaError} If API request fails
+         * @example
+         * ```typescript
+         * await galva.endUser.identify('user-123', {
+         *   traits: { [EndUserDefaultTraitName.EMAIL]: 'user@example.com' },
+         * });
+         * ```
+         */
+        identify: (endUserId: string, options?: {
+            timestamp?: string;
+            context?: Record<string, any>;
+            traits?: EndUserTraits;
+        }) => Promise<void>;
+        /**
+         * Updates an end user's default profile info.
+         * @param {string} endUserId - End user ID in your system
+         * @param {EndUserDefaultInfo} defaultInfo - Profile info to update
+         * @throws {GalvaError} If API request fails
+         * @example
+         * ```typescript
+         * await galva.endUser.updateDefaultInfo('user-123', {
+         *   email: 'user@example.com',
+         *   fullName: 'John Doe',
+         * });
+         * ```
+         */
+        updateDefaultInfo: (endUserId: string, defaultInfo: EndUserDefaultInfo) => Promise<void>;
+    };
+}
+declare class GalvaWithCreds extends GalvaBase {
+    private credentials;
+    /**
+     * @internal Use `galva.withCredentials(...)` instead.
+     */
+    constructor(config: GalvaOptions, credentials: CredentialsConfig);
+    /**
+     * Billing event handlers with credential support.
+     * @property {Function} appstore - App Store events (signed payload only)
+     * @property {Function} playstore - Play Store events (raw base64 payload)
+     * @property {Function} paddle - Paddle events (raw body with verification)
+     */
+    billingEvent: {
+        /**
+         * Tracks an App Store billing event. Uses credentials from withCredentials().
+         * @param {string} endUserId - End user ID
+         * @param {string} signedPayload - Signed payload from Apple
+         * @param {Record<string, any>} [options] - Additional options
+         * @returns {Promise<void>}
+         * @throws {GalvaError} If credentials missing or API fails
+         * @example
+         * ```typescript
+         * await galvaWithCreds.billingEvent.appstore('user-123', signedPayload);
+         * ```
+         */
+        appstore: (endUserId: string, signedPayload: string, options?: Record<string, any>) => Promise<void>;
+        /**
+         * Tracks a Play Store billing event. Decodes payload and fetches subscription details.
+         * @param {string} endUserId - End user ID
+         * @param {string} base64Payload - Base64 payload from Pub/Sub
+         * @returns {Promise<void>}
+         * @throws {GalvaError} If credentials missing or API fails
+         * @example
+         * ```typescript
+         * await galvaWithCreds.billingEvent.playstore('user-123', base64Payload);
+         * ```
+         */
+        playstore: (endUserId: string, base64Payload: string) => Promise<void>;
+        /**
+         * Tracks a Paddle billing event. Verifies signature and unmarshals the event.
+         * @param {string} endUserId - End user ID
+         * @param {string} rawBody - Raw body from Paddle webhook
+         * @param {string} signature - Paddle-Signature header value
+         * @returns {Promise<void>}
+         * @throws {GalvaError} If credentials missing or API fails
+         * @example
+         * ```typescript
+         * await galvaWithCreds.billingEvent.paddle('user-123', rawBody, signature);
+         * ```
+         */
+        paddle: (endUserId: string, rawBody: string, signature: string) => Promise<void>;
+    };
+}
+declare class Galva extends GalvaBase {
+    constructor(options?: GalvaOptions);
+    /**
+     * Billing event handlers for different payment platforms.
+     * @property {Function} appstore - App Store events
+     * @property {Function} playstore - Play Store events (decoded payload)
+     * @property {Function} paddle - Paddle events (verified event)
+     */
+    billingEvent: {
+        /**
+         * Tracks an App Store billing event.
+         * @param {string} endUserId - End user ID
+         * @param {Object} payload - App Store notification payload
+         * @param {string} payload.signedPayload - Signed payload from Apple
+         * @param {string} payload.bundleId - App bundle identifier
+         * @param {number} payload.appAppleId - App Apple ID
+         * @param {Record<string, any>} [options] - Additional options
+         * @throws {GalvaError} If API request fails
+         * @example
+         * ```typescript
+         * await galva.billingEvent.appstore('user-123', {
+         *   signedPayload,
+         *   bundleId: 'com.example.app',
+         *   appAppleId: 123456789
+         * });
+         * ```
+         */
+        appstore: (endUserId: string, payload: {
+            signedPayload: string;
+            bundleId: string;
+            appAppleId: number;
+        }, options?: Record<string, any>) => Promise<void>;
+        /**
+         * Tracks a Play Store billing event with decoded notification.
+         * @param {string} endUserId - End user ID
+         * @param {PlaystoreDeveloperNotification} payload - Decoded developer notification
+         * @returns {Promise<void>}
+         * @example
+         * ```typescript
+         * await galva.billingEvent.playstore('user-123', decodedNotification);
+         * ```
+         */
+        playstore: (endUserId: string, payload: PlaystoreDeveloperNotification) => Promise<void>;
+        /**
+         * Tracks a Paddle billing event with verified event entity.
+         * @param {string} endUserId - End user ID
+         * @param {EventEntity} eventEntity - Verified Paddle event
+         * @returns {Promise<void>}
+         * @example
+         * ```typescript
+         * await galva.billingEvent.paddle('user-123', verifiedEvent);
+         * ```
+         */
+        paddle: (endUserId: string, eventEntity: EventEntity) => Promise<void>;
+    };
+    withCredentials(credentials: CredentialsConfig): GalvaWithCreds;
+}
+
+export { type AppstoreCredentials, type CredentialsConfig, END_USER_DEFAULT_INFO_TO_TRAIT_MAP, END_USER_DEFAULT_TRAIT_MAP, type EndUserDefaultInfo, EndUserDefaultTraitName, type EndUserDefaultTraits, type EndUserTraits, Galva, GalvaError, type GalvaErrorResponse, type GalvaOptions, type PaddleCredentials, type PlaystoreCredentials };

package/dist/index.js

@@ -0,0 +1,4 @@
+import {google}from'googleapis';import {Paddle}from'@paddle/paddle-node-sdk';var T=n=>{let e=new google.auth.JWT({email:n.email,key:n.key.replace(/\\n/g,`
+`),scopes:["https://www.googleapis.com/auth/androidpublisher"]});return google.androidpublisher({version:"v3",auth:e})},p=class{static async getSubscription(e,t,a){return await T({email:a.email,key:a.key}).purchases.subscriptionsv2.get({token:e,packageName:t})}};var u=(o=>(o.TIMEZONE="$gv_timezone",o.LANGUAGE_CODE="$gv_languageCode",o.EMAIL="$gv_email",o.FULL_NAME="$gv_fullName",o.FIRST_NAME="$gv_firstName",o.LAST_NAME="$gv_lastName",o.COUNTRY="$gv_country",o.TOTAL_LIFETIME_VALUE="$gv_totalLifetimeValue",o))(u||{}),N={$gv_timezone:"timezone",$gv_languageCode:"languageCode",$gv_email:"email",$gv_fullName:"fullName",$gv_firstName:"firstName",$gv_lastName:"lastName",$gv_country:"country",$gv_totalLifetimeValue:"totalLifetimeValue"},m={timezone:"$gv_timezone",languageCode:"$gv_languageCode",email:"$gv_email",fullName:"$gv_fullName",firstName:"$gv_firstName",lastName:"$gv_lastName",country:"$gv_country",totalLifetimeValue:"$gv_totalLifetimeValue"};var s=class n extends Error{code;constructor(e){super(e.message),this.name="GalvaError",this.code=e.code,Error.captureStackTrace&&Error.captureStackTrace(this,n);}static from(e){if(e instanceof n)return e;let t=e instanceof Error?e.message:"An unknown error occurred";return new n({code:"UNKNOWN_ERROR",message:t})}};var A="https://api.galva.io",U="https://api.galva.dev",c=class{config;baseUrl;constructor(e){let t=e?.apiKey||process.env.GALVA_API_KEY;if(!t)throw new s({code:"MISSING_API_KEY",message:"API key is required. Provide it in options or set GALVA_API_KEY env variable."});this.config={apiKey:t,environment:e?.environment||(process.env.NODE_ENV==="development"?"development":"production"),timeout:e?.timeout||1e4},this.baseUrl=this.config.environment==="development"?U:A;}async sendRequest(e,t,a){let r=`${this.baseUrl}${t}`,i=new AbortController,l=setTimeout(()=>i.abort(),this.config.timeout);try{let d=await fetch(r,{method:e,headers:{"Content-Type":"application/json","x-api-key":this.config.apiKey},body:a?JSON.stringify(a):void 0,signal:i.signal});if(!d.ok){let o=await d.json();throw new s(o)}}catch(d){throw d instanceof s?d:d instanceof Error&&d.name==="AbortError"?new s({code:"TIMEOUT",message:`Request timed out after ${this.config.timeout}ms`}):s.from(d)}finally{clearTimeout(l);}}endUser={identify:async(e,t)=>{await this.sendRequest("POST","/endUsers:identify",{endUserId:e,timestamp:t?.timestamp,context:t?.context,traits:t?.traits});},updateDefaultInfo:async(e,t)=>{let a={};for(let[r,i]of Object.entries(t))if(i!==void 0){let l=m[r];a[l]=i;}await this.sendRequest("POST","/endUsers:identify",{endUserId:e,traits:a});}}},E=class extends c{credentials;constructor(e,t){super(e),this.credentials=t;}billingEvent={appstore:async(e,t,a)=>{if(!this.credentials.appstore)throw new s({code:"MISSING_CREDENTIALS",message:"App Store credentials are required. Provide them in withCredentials()."});await this.sendRequest("POST","/endUsers/billingEvents",{platform:"appstore",endUserId:e,payload:{signedPayload:t,appAppleId:this.credentials.appstore.appAppleId,bundleId:this.credentials.appstore.bundleId,env:this.config.environment},options:a});},playstore:async(e,t)=>{if(!this.credentials.playstore)throw new s({code:"MISSING_CREDENTIALS",message:"Play Store credentials are required. Provide them in withCredentials()."});let a=Buffer.from(t,"base64").toString(),r=null;try{r=JSON.parse(a);}catch{throw new s({code:"INVALID_PAYLOAD",message:"Invalid base64 payload: unable to parse JSON."})}if(!r||typeof r!="object")throw new s({code:"INVALID_PAYLOAD",message:"Decoded payload is not a valid JSON object."});if(!("subscriptionNotification"in r))throw new s({code:"INVALID_PAYLOAD",message:"Decoded payload does not contain subscriptionNotification field."});let i=await p.getSubscription(r.subscriptionNotification.purchaseToken,r.packageName,this.credentials.playstore),l={...r,subscriptionNotification:{...r.subscriptionNotification,subscriptionPurchase:i.data}};await this.sendRequest("POST","/endUsers/billingEvents",{platform:"playstore",endUserId:e,payload:l});},paddle:async(e,t,a)=>{if(!this.credentials.paddle)throw new s({code:"MISSING_CREDENTIALS",message:"Paddle credentials are required. Provide them in withCredentials()."});let r=new Paddle(this.credentials.paddle.apiKey),i;try{i=await r.webhooks.unmarshal(t,this.credentials.paddle.secretKey,a);}catch(l){throw new s({code:"INVALID_WEBHOOK",message:`Invalid Paddle webhook data: ${l.message}`})}await this.sendRequest("POST","/endUsers/billingEvents",{platform:"paddle",endUserId:e,payload:i});}}},g=class extends c{constructor(e){super(e);}billingEvent={appstore:async(e,t,a)=>{let{signedPayload:r,bundleId:i,appAppleId:l}=t;await this.sendRequest("POST","/endUsers/billingEvents",{platform:"appstore",endUserId:e,payload:{signedPayload:r,appAppleId:l,bundleId:i,env:this.config.environment},options:a});},playstore:async(e,t)=>{await this.sendRequest("POST","/endUsers/billingEvents",{platform:"playstore",endUserId:e,payload:t});},paddle:async(e,t)=>{await this.sendRequest("POST","/endUsers/billingEvents",{platform:"paddle",endUserId:e,payload:t});}};withCredentials(e){return new E(this.config,e)}};
+export{m as END_USER_DEFAULT_INFO_TO_TRAIT_MAP,N as END_USER_DEFAULT_TRAIT_MAP,u as EndUserDefaultTraitName,g as Galva,s as GalvaError};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services/playstore.ts","../src/types/endUser.ts","../src/types/error.ts","../src/galva.ts"],"names":["authentication","payload","jwtClient","google","PlaystoreService","token","packageName","cred","EndUserDefaultTraitName","END_USER_DEFAULT_TRAIT_MAP","END_USER_DEFAULT_INFO_TO_TRAIT_MAP","GalvaError","_GalvaError","response","error","message","PRODUCTION_API_URL","DEVELOPMENT_API_URL","GalvaBase","options","apiKey","method","endpoint","data","url","controller","timeoutId","errorResponse","endUserId","defaultInfo","traits","key","value","traitName","GalvaWithCreds","config","credentials","signedPayload","base64Payload","decodedPayloadString","decodedPayload","subscription","finalPayload","rawBody","signature","paddle","Paddle","eventData","Galva","bundleId","appAppleId","eventEntity"],"mappings":"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","file":"index.js","sourcesContent":["import { PlaystoreCredentials } from '@/galva';\nimport { google } from 'googleapis';\n\nconst authentication = (payload: { email: string; key: string }) => {\n  const jwtClient = new google.auth.JWT({\n    email: payload.email,\n    key: payload.key.replace(/\\\\n/g, '\\n'),\n    scopes: ['https://www.googleapis.com/auth/androidpublisher'],\n  });\n  return google.androidpublisher({\n    version: 'v3',\n    auth: jwtClient,\n  });\n};\n\nexport class PlaystoreService {\n  static async getSubscription(\n    token: string,\n    packageName: string,\n    cred: PlaystoreCredentials,\n  ): Promise<any> {\n    const client = authentication({\n      email: cred.email,\n      key: cred.key,\n    });\n\n    const result = await client.purchases.subscriptionsv2.get({\n      token,\n      packageName,\n    });\n\n    return result;\n  }\n}\n","/**\n * Default trait names for end user profiles.\n * Use these constants for type-safe access to built-in traits.\n */\nexport enum EndUserDefaultTraitName {\n  TIMEZONE = \"$gv_timezone\",\n  LANGUAGE_CODE = \"$gv_languageCode\",\n  EMAIL = \"$gv_email\",\n  FULL_NAME = \"$gv_fullName\",\n  FIRST_NAME = \"$gv_firstName\",\n  LAST_NAME = \"$gv_lastName\",\n  COUNTRY = \"$gv_country\",\n  TOTAL_LIFETIME_VALUE = \"$gv_totalLifetimeValue\",\n}\n\n/**\n * Built-in trait types with their expected value types.\n */\nexport interface EndUserDefaultTraits {\n  [EndUserDefaultTraitName.TIMEZONE]?: string;\n  [EndUserDefaultTraitName.LANGUAGE_CODE]?: string;\n  [EndUserDefaultTraitName.EMAIL]?: string;\n  [EndUserDefaultTraitName.FULL_NAME]?: string;\n  [EndUserDefaultTraitName.FIRST_NAME]?: string;\n  [EndUserDefaultTraitName.LAST_NAME]?: string;\n  [EndUserDefaultTraitName.COUNTRY]?: string;\n  [EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE]?: number;\n}\n\n/**\n * End user traits combining default traits with arbitrary custom traits.\n */\nexport type EndUserTraits = EndUserDefaultTraits & Record<string, any>;\n\n/**\n * Friendly parameter names for updating end user default info.\n * Maps to the underlying $gv_ prefixed trait names.\n */\nexport interface EndUserDefaultInfo {\n  timezone?: string;\n  languageCode?: string;\n  email?: string;\n  fullName?: string;\n  firstName?: string;\n  lastName?: string;\n  country?: string;\n  totalLifetimeValue?: number;\n}\n\n/**\n * Mapping from friendly parameter names to original trait names.\n * TypeScript ensures this mapping contains all keys from EndUserDefaultTraitName.\n */\nexport const END_USER_DEFAULT_TRAIT_MAP: Record<\n  EndUserDefaultTraitName,\n  keyof EndUserDefaultInfo\n> = {\n  [EndUserDefaultTraitName.TIMEZONE]: \"timezone\",\n  [EndUserDefaultTraitName.LANGUAGE_CODE]: \"languageCode\",\n  [EndUserDefaultTraitName.EMAIL]: \"email\",\n  [EndUserDefaultTraitName.FULL_NAME]: \"fullName\",\n  [EndUserDefaultTraitName.FIRST_NAME]: \"firstName\",\n  [EndUserDefaultTraitName.LAST_NAME]: \"lastName\",\n  [EndUserDefaultTraitName.COUNTRY]: \"country\",\n  [EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE]: \"totalLifetimeValue\",\n};\n\n/**\n * Reverse mapping from friendly parameter names to trait names.\n * TypeScript ensures this mapping contains all keys from EndUserDefaultInfo.\n */\nexport const END_USER_DEFAULT_INFO_TO_TRAIT_MAP: Record<\n  keyof EndUserDefaultInfo,\n  EndUserDefaultTraitName\n> = {\n  timezone: EndUserDefaultTraitName.TIMEZONE,\n  languageCode: EndUserDefaultTraitName.LANGUAGE_CODE,\n  email: EndUserDefaultTraitName.EMAIL,\n  fullName: EndUserDefaultTraitName.FULL_NAME,\n  firstName: EndUserDefaultTraitName.FIRST_NAME,\n  lastName: EndUserDefaultTraitName.LAST_NAME,\n  country: EndUserDefaultTraitName.COUNTRY,\n  totalLifetimeValue: EndUserDefaultTraitName.TOTAL_LIFETIME_VALUE,\n};\n","/**\n * Error response structure from Galva API.\n */\nexport interface GalvaErrorResponse {\n  code: string;\n  message: string;\n}\n\n/**\n * Custom error class for Galva SDK errors.\n * Extends Error with additional properties from API error responses.\n */\nexport class GalvaError extends Error {\n  /** Error code from the API (e.g., 'BAD_REQUEST', 'UNAUTHORIZED') */\n  readonly code: string;\n\n  constructor(response: GalvaErrorResponse) {\n    super(response.message);\n    this.name = \"GalvaError\";\n    this.code = response.code;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, GalvaError);\n    }\n  }\n\n  /**\n   * Creates a GalvaError from an unknown error.\n   * If the error is already a GalvaError, returns it as-is.\n   * Otherwise, wraps it in a GalvaError with UNKNOWN_ERROR code.\n   */\n  static from(error: unknown): GalvaError {\n    if (error instanceof GalvaError) {\n      return error;\n    }\n\n    const message =\n      error instanceof Error ? error.message : \"An unknown error occurred\";\n\n    return new GalvaError({\n      code: \"UNKNOWN_ERROR\",\n      message,\n    });\n  }\n}\n","import { PlaystoreDeveloperNotification } from './types/playstore';\nimport { PlaystoreService } from './services/playstore';\nimport { EventEntity, Paddle } from '@paddle/paddle-node-sdk';\nimport type { EndUserTraits, EndUserDefaultInfo } from './types/endUser';\nimport { END_USER_DEFAULT_INFO_TO_TRAIT_MAP } from './types/endUser';\nimport { GalvaError } from './types/error';\n\nexport type {\n  EndUserDefaultTraits,\n  EndUserTraits,\n  EndUserDefaultInfo,\n} from './types/endUser';\nexport {\n  EndUserDefaultTraitName,\n  END_USER_DEFAULT_TRAIT_MAP,\n  END_USER_DEFAULT_INFO_TO_TRAIT_MAP,\n} from './types/endUser';\nexport { GalvaError } from './types/error';\nexport type { GalvaErrorResponse } from './types/error';\n\nexport interface GalvaOptions {\n  /**\n   * Defaults to 'production'. Falls back to NODE_ENV.\n   * @type {('production' | 'development')}\n   */\n  environment?: 'production' | 'development';\n\n  /**\n   * API key from Galva dashboard. Falls back to GALVA_API_KEY env var.\n   * @type {string}\n   */\n  apiKey?: string;\n\n  /**\n   * Request timeout in ms. Defaults to 10000.\n   * @type {number}\n   */\n  timeout?: number;\n}\n\n/**\n * Credentials for authenticating with the Google Play Store API.\n *\n * @interface PlaystoreCredentials\n */\nexport interface PlaystoreCredentials {\n  /** Service account email address */\n  email: string;\n  /** Service account private key */\n  key: string;\n}\n\n/**\n * Credentials for authenticating and verifying Paddle webhooks.\n *\n * @interface PaddleCredentials\n */\nexport interface PaddleCredentials {\n  /** Paddle API key */\n  apiKey: string;\n  /** Webhook secret key for signature verification */\n  secretKey: string;\n}\n\n/**\n * Credentials for Apple App Store.\n *\n * @interface AppstoreCredentials\n */\nexport interface AppstoreCredentials {\n  /** The app's bundle identifier (e.g., 'com.example.app') */\n  bundleId: string;\n  /** The app's Apple ID from App Store Connect */\n  appAppleId: number;\n}\n\n/**\n * Credentials configuration for withCredentials method.\n *\n * @interface CredentialsConfig\n */\nexport interface CredentialsConfig {\n  /** App Store credentials */\n  appstore?: AppstoreCredentials;\n  /** Play Store service account credentials */\n  playstore?: PlaystoreCredentials;\n  /** Paddle API credentials */\n  paddle?: PaddleCredentials;\n}\n\nconst PRODUCTION_API_URL = 'https://api.galva.io';\nconst DEVELOPMENT_API_URL = 'https://api.galva.dev';\n\n/**\n * Base Galva SDK client with end user management methods.\n * @class GalvaBase\n */\nclass GalvaBase {\n  protected config: GalvaOptions;\n  protected readonly baseUrl: string;\n\n  /**\n   * @param {GalvaOptions} [options] - Configuration options\n   * @throws {GalvaError} If API key is not provided\n   */\n  constructor(options?: GalvaOptions) {\n    const apiKey = options?.apiKey || process.env.GALVA_API_KEY;\n    if (!apiKey) {\n      throw new GalvaError({\n        code: 'MISSING_API_KEY',\n        message:\n          'API key is required. Provide it in options or set GALVA_API_KEY env variable.',\n      });\n    }\n\n    this.config = {\n      apiKey: apiKey,\n      environment:\n        options?.environment ||\n        (process.env.NODE_ENV === 'development' ? 'development' : 'production'),\n      timeout: options?.timeout || 10000,\n    };\n    this.baseUrl =\n      this.config.environment === 'development'\n        ? DEVELOPMENT_API_URL\n        : PRODUCTION_API_URL;\n  }\n\n  protected async sendRequest(\n    method: 'POST' | 'GET',\n    endpoint: string,\n    data?: unknown,\n  ): Promise<void> {\n    const url = `${this.baseUrl}${endpoint}`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n    try {\n      const response = await fetch(url, {\n        method,\n        headers: {\n          'Content-Type': 'application/json',\n          'x-api-key': this.config.apiKey!,\n        },\n        body: data ? JSON.stringify(data) : undefined,\n        signal: controller.signal,\n      });\n\n      if (!response.ok) {\n        const errorResponse = await response.json();\n        throw new GalvaError(errorResponse);\n      }\n    } catch (error) {\n      if (error instanceof GalvaError) {\n        throw error;\n      }\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new GalvaError({\n          code: 'TIMEOUT',\n          message: `Request timed out after ${this.config.timeout}ms`,\n        });\n      }\n      throw GalvaError.from(error);\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  /** End user management methods. */\n  public endUser = {\n    /**\n     * Identifies an end user with optional traits and context.\n     * @param {string} endUserId - End user ID in your system\n     * @param {Object} [options] - Identification data\n     * @param {string} [options.timestamp] - ISO 8601 timestamp\n     * @param {Record<string, any>} [options.context] - Additional context\n     * @param {EndUserTraits} [options.traits] - User traits. Use EndUserDefaultTraitName for built-in traits.\n     * @throws {GalvaError} If API request fails\n     * @example\n     * ```typescript\n     * await galva.endUser.identify('user-123', {\n     *   traits: { [EndUserDefaultTraitName.EMAIL]: 'user@example.com' },\n     * });\n     * ```\n     */\n    identify: async (\n      endUserId: string,\n      options?: {\n        timestamp?: string;\n        context?: Record<string, any>;\n        traits?: EndUserTraits;\n      },\n    ): Promise<void> => {\n      await this.sendRequest('POST', '/endUsers:identify', {\n        endUserId,\n        timestamp: options?.timestamp,\n        context: options?.context,\n        traits: options?.traits,\n      });\n    },\n\n    /**\n     * Updates an end user's default profile info.\n     * @param {string} endUserId - End user ID in your system\n     * @param {EndUserDefaultInfo} defaultInfo - Profile info to update\n     * @throws {GalvaError} If API request fails\n     * @example\n     * ```typescript\n     * await galva.endUser.updateDefaultInfo('user-123', {\n     *   email: 'user@example.com',\n     *   fullName: 'John Doe',\n     * });\n     * ```\n     */\n    updateDefaultInfo: async (\n      endUserId: string,\n      defaultInfo: EndUserDefaultInfo,\n    ): Promise<void> => {\n      const traits: EndUserTraits = {};\n\n      for (const [key, value] of Object.entries(defaultInfo)) {\n        if (value !== undefined) {\n          const traitName =\n            END_USER_DEFAULT_INFO_TO_TRAIT_MAP[key as keyof EndUserDefaultInfo];\n          traits[traitName] = value;\n        }\n      }\n\n      await this.sendRequest('POST', '/endUsers:identify', {\n        endUserId,\n        traits,\n      });\n    },\n  };\n}\n\nclass GalvaWithCreds extends GalvaBase {\n  // private config: GalvaOptions;\n  // private readonly baseUrl: string;\n  private credentials: CredentialsConfig;\n\n  /**\n   * @internal Use `galva.withCredentials(...)` instead.\n   */\n  constructor(config: GalvaOptions, credentials: CredentialsConfig) {\n    super(config);\n    // this.config = config;\n    // this.baseUrl = baseUrl;\n    this.credentials = credentials;\n  }\n\n  /**\n   * Billing event handlers with credential support.\n   * @property {Function} appstore - App Store events (signed payload only)\n   * @property {Function} playstore - Play Store events (raw base64 payload)\n   * @property {Function} paddle - Paddle events (raw body with verification)\n   */\n  public billingEvent = {\n    /**\n     * Tracks an App Store billing event. Uses credentials from withCredentials().\n     * @param {string} endUserId - End user ID\n     * @param {string} signedPayload - Signed payload from Apple\n     * @param {Record<string, any>} [options] - Additional options\n     * @returns {Promise<void>}\n     * @throws {GalvaError} If credentials missing or API fails\n     * @example\n     * ```typescript\n     * await galvaWithCreds.billingEvent.appstore('user-123', signedPayload);\n     * ```\n     */\n    appstore: async (\n      endUserId: string,\n      signedPayload: string,\n      options?: Record<string, any>,\n    ): Promise<void> => {\n      if (!this.credentials.appstore) {\n        throw new GalvaError({\n          code: 'MISSING_CREDENTIALS',\n          message:\n            'App Store credentials are required. Provide them in withCredentials().',\n        });\n      }\n\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'appstore',\n        endUserId,\n        payload: {\n          signedPayload,\n          appAppleId: this.credentials.appstore.appAppleId,\n          bundleId: this.credentials.appstore.bundleId,\n          env: this.config.environment,\n        },\n        options,\n      });\n    },\n\n    /**\n     * Tracks a Play Store billing event. Decodes payload and fetches subscription details.\n     * @param {string} endUserId - End user ID\n     * @param {string} base64Payload - Base64 payload from Pub/Sub\n     * @returns {Promise<void>}\n     * @throws {GalvaError} If credentials missing or API fails\n     * @example\n     * ```typescript\n     * await galvaWithCreds.billingEvent.playstore('user-123', base64Payload);\n     * ```\n     */\n    playstore: async (\n      endUserId: string,\n      base64Payload: string,\n    ): Promise<void> => {\n      if (!this.credentials.playstore) {\n        throw new GalvaError({\n          code: 'MISSING_CREDENTIALS',\n          message:\n            'Play Store credentials are required. Provide them in withCredentials().',\n        });\n      }\n\n      const decodedPayloadString = Buffer.from(\n        base64Payload,\n        'base64',\n      ).toString();\n      let decodedPayload: PlaystoreDeveloperNotification | null = null;\n      try {\n        decodedPayload = JSON.parse(decodedPayloadString);\n      } catch (error) {\n        throw new GalvaError({\n          code: 'INVALID_PAYLOAD',\n          message: 'Invalid base64 payload: unable to parse JSON.',\n        });\n      }\n\n      if (!decodedPayload || typeof decodedPayload !== 'object') {\n        throw new GalvaError({\n          code: 'INVALID_PAYLOAD',\n          message: 'Decoded payload is not a valid JSON object.',\n        });\n      }\n\n      if (!('subscriptionNotification' in decodedPayload)) {\n        throw new GalvaError({\n          code: 'INVALID_PAYLOAD',\n          message:\n            'Decoded payload does not contain subscriptionNotification field.',\n        });\n      }\n\n      const subscription = await PlaystoreService.getSubscription(\n        decodedPayload.subscriptionNotification.purchaseToken,\n        decodedPayload.packageName,\n        this.credentials.playstore,\n      );\n\n      const finalPayload: PlaystoreDeveloperNotification = {\n        ...decodedPayload,\n        subscriptionNotification: {\n          ...decodedPayload.subscriptionNotification,\n          subscriptionPurchase: subscription.data,\n        },\n      };\n\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'playstore',\n        endUserId,\n        payload: finalPayload,\n      });\n    },\n\n    /**\n     * Tracks a Paddle billing event. Verifies signature and unmarshals the event.\n     * @param {string} endUserId - End user ID\n     * @param {string} rawBody - Raw body from Paddle webhook\n     * @param {string} signature - Paddle-Signature header value\n     * @returns {Promise<void>}\n     * @throws {GalvaError} If credentials missing or API fails\n     * @example\n     * ```typescript\n     * await galvaWithCreds.billingEvent.paddle('user-123', rawBody, signature);\n     * ```\n     */\n    paddle: async (\n      endUserId: string,\n      rawBody: string,\n      signature: string,\n    ): Promise<void> => {\n      if (!this.credentials.paddle) {\n        throw new GalvaError({\n          code: 'MISSING_CREDENTIALS',\n          message:\n            'Paddle credentials are required. Provide them in withCredentials().',\n        });\n      }\n\n      const paddle = new Paddle(this.credentials.paddle.apiKey);\n      let eventData: EventEntity;\n\n      try {\n        eventData = await paddle.webhooks.unmarshal(\n          rawBody,\n          this.credentials.paddle.secretKey,\n          signature,\n        );\n      } catch (error) {\n        throw new GalvaError({\n          code: 'INVALID_WEBHOOK',\n          message: `Invalid Paddle webhook data: ${(error as Error).message}`,\n        });\n      }\n\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'paddle',\n        endUserId,\n        payload: eventData,\n      });\n    },\n  };\n}\n\nexport class Galva extends GalvaBase {\n  constructor(options?: GalvaOptions) {\n    super(options);\n  }\n\n  /**\n   * Billing event handlers for different payment platforms.\n   * @property {Function} appstore - App Store events\n   * @property {Function} playstore - Play Store events (decoded payload)\n   * @property {Function} paddle - Paddle events (verified event)\n   */\n  public billingEvent = {\n    /**\n     * Tracks an App Store billing event.\n     * @param {string} endUserId - End user ID\n     * @param {Object} payload - App Store notification payload\n     * @param {string} payload.signedPayload - Signed payload from Apple\n     * @param {string} payload.bundleId - App bundle identifier\n     * @param {number} payload.appAppleId - App Apple ID\n     * @param {Record<string, any>} [options] - Additional options\n     * @throws {GalvaError} If API request fails\n     * @example\n     * ```typescript\n     * await galva.billingEvent.appstore('user-123', {\n     *   signedPayload,\n     *   bundleId: 'com.example.app',\n     *   appAppleId: 123456789\n     * });\n     * ```\n     */\n    appstore: async (\n      endUserId: string,\n      payload: {\n        signedPayload: string;\n        bundleId: string;\n        appAppleId: number;\n      },\n      options?: Record<string, any>,\n    ): Promise<void> => {\n      const { signedPayload, bundleId, appAppleId } = payload;\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'appstore',\n        endUserId,\n        payload: {\n          signedPayload,\n          appAppleId: appAppleId,\n          bundleId: bundleId,\n          env: this.config.environment,\n        },\n        options,\n      });\n    },\n\n    /**\n     * Tracks a Play Store billing event with decoded notification.\n     * @param {string} endUserId - End user ID\n     * @param {PlaystoreDeveloperNotification} payload - Decoded developer notification\n     * @returns {Promise<void>}\n     * @example\n     * ```typescript\n     * await galva.billingEvent.playstore('user-123', decodedNotification);\n     * ```\n     */\n    playstore: async (\n      endUserId: string,\n      payload: PlaystoreDeveloperNotification,\n    ): Promise<void> => {\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'playstore',\n        endUserId,\n        payload,\n      });\n    },\n\n    /**\n     * Tracks a Paddle billing event with verified event entity.\n     * @param {string} endUserId - End user ID\n     * @param {EventEntity} eventEntity - Verified Paddle event\n     * @returns {Promise<void>}\n     * @example\n     * ```typescript\n     * await galva.billingEvent.paddle('user-123', verifiedEvent);\n     * ```\n     */\n    paddle: async (\n      endUserId: string,\n      eventEntity: EventEntity,\n    ): Promise<void> => {\n      await this.sendRequest('POST', '/endUsers/billingEvents', {\n        platform: 'paddle',\n        endUserId,\n        payload: eventEntity,\n      });\n    },\n  };\n\n  withCredentials(credentials: CredentialsConfig) {\n    return new GalvaWithCreds(this.config, credentials);\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@galva-io/galva-admin-node",
+  "version": "1.0.0-dev",
+  "description": "Node.js SDK for Galva Admin API",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "keywords": [
+    "galva",
+    "admin",
+    "sdk",
+    "billing",
+    "subscription",
+    "api"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@paddle/paddle-node-sdk": "^3.6.0",
+    "@types/node": "^20.19.33",
+    "googleapis": "^171.4.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@paddle/paddle-node-sdk": "^3.6.0",
+    "googleapis": "^171.4.0"
+  }
+}