@walkeros/server-destination-datamanager 0.4.0 → 0.4.2

package/dist/examples/index.mjs

@@ -4,89 +4,81 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/examples/mapping.ts
-var mapping_exports = {};
-__export(mapping_exports, {
-  Lead: () => Lead,
-  PageView: () => PageView,
-  Purchase: () => Purchase,
-  mapping: () => mapping,
-  userDataMapping: () => userDataMapping
+// src/examples/auth.ts
+var auth_exports = {};
+__export(auth_exports, {
+  awsLambda: () => awsLambda,
+  customScopes: () => customScopes,
+  dockerKubernetes: () => dockerKubernetes,
+  gcpCloudFunctions: () => gcpCloudFunctions,
+  localDevelopment: () => localDevelopment
 });
-import { isObject } from "@walkeros/core";
-var Purchase = {
-  name: "purchase",
-  data: {
-    map: {
-      // Required fields
-      transactionId: "data.id",
-      conversionValue: "data.total",
-      currency: { key: "data.currency", value: "USD" },
-      eventName: { value: "purchase" },
-      // User identification
-      userId: "user.id",
-      email: "user.id",
-      // Will be hashed automatically
-      // Attribution identifiers (captured by browser source from URL)
-      gclid: "context.gclid",
-      // Google Click ID
-      gbraid: "context.gbraid",
-      // iOS attribution
-      wbraid: "context.wbraid",
-      // Web-to-app
-      // Shopping cart data
-      cartData: {
-        map: {
-          items: {
-            loop: [
-              "nested",
-              {
-                condition: (entity) => isObject(entity) && entity.entity === "product",
-                map: {
-                  merchantProductId: "data.id",
-                  price: "data.price",
-                  quantity: { key: "data.quantity", value: 1 }
-                }
-              }
-            ]
-          }
-        }
+var awsLambda = {
+  settings: {
+    credentials: {
+      client_email: process.env.GOOGLE_CLIENT_EMAIL || "",
+      private_key: (process.env.GOOGLE_PRIVATE_KEY || "").replace(/\\n/g, "\n")
+    },
+    destinations: [
+      {
+        operatingAccount: {
+          accountId: "123-456-7890",
+          accountType: "GOOGLE_ADS"
+        },
+        productDestinationId: "AW-CONVERSION-123"
       }
-    }
+    ]
   }
 };
-var Lead = {
-  name: "generate_lead",
-  data: {
-    map: {
-      eventName: { value: "generate_lead" },
-      conversionValue: { value: 10 },
-      currency: { value: "USD" }
-    }
+var gcpCloudFunctions = {
+  settings: {
+    // No auth config needed - ADC works automatically on GCP!
+    destinations: [
+      {
+        operatingAccount: {
+          accountId: "123-456-7890",
+          accountType: "GOOGLE_ADS"
+        },
+        productDestinationId: "AW-CONVERSION-123"
+      }
+    ]
   }
 };
-var PageView = {
-  name: "page_view",
-  data: {
-    map: {
-      eventName: { value: "page_view" }
-    }
+var localDevelopment = {
+  settings: {
+    keyFilename: "./service-account.json",
+    destinations: [
+      {
+        operatingAccount: {
+          accountId: "123-456-7890",
+          accountType: "GOOGLE_ADS"
+        },
+        productDestinationId: "AW-CONVERSION-123"
+      }
+    ]
   }
 };
-var mapping = {
-  order: {
-    complete: Purchase
-  },
-  lead: {
-    submit: Lead
-  },
-  page: {
-    view: PageView
+var dockerKubernetes = {
+  settings: {
+    // No explicit config - ADC uses GOOGLE_APPLICATION_CREDENTIALS env var
+    destinations: [
+      {
+        operatingAccount: {
+          accountId: "123-456-7890",
+          accountType: "GOOGLE_ADS"
+        },
+        productDestinationId: "AW-CONVERSION-123"
+      }
+    ]
   }
 };
-var userDataMapping = {
+var customScopes = {
   settings: {
-    accessToken: "ya29.c.xxx",
+    credentials: {
+      client_email: process.env.GOOGLE_CLIENT_EMAIL || "",
+      private_key: (process.env.GOOGLE_PRIVATE_KEY || "").replace(/\\n/g, "\n")
+    },
+    scopes: ["https://www.googleapis.com/auth/datamanager"],
     destinations: [
       {
         operatingAccount: {
@@ -96,18 +88,7 @@ var userDataMapping = {
         productDestinationId: "AW-CONVERSION-123"
       }
     ]
-  },
-  data: {
-    map: {
-      email: "user.id",
-      phone: "data.phone",
-      firstName: "data.firstName",
-      lastName: "data.lastName",
-      regionCode: "data.country",
-      postalCode: "data.zip"
-    }
-  },
-  mapping
+  }
 };
 
 // src/examples/basic.ts
@@ -120,7 +101,10 @@ __export(basic_exports, {
 });
 var minimal = {
   settings: {
-    accessToken: "ya29.c.xxx",
+    credentials: {
+      client_email: "service-account@project.iam.gserviceaccount.com",
+      private_key: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+    },
     destinations: [
       {
         operatingAccount: {
@@ -134,7 +118,10 @@ var minimal = {
 };
 var complete = {
   settings: {
-    accessToken: "ya29.c.xxx",
+    credentials: {
+      client_email: "service-account@project.iam.gserviceaccount.com",
+      private_key: "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+    },
     destinations: [
       {
         operatingAccount: {
@@ -151,7 +138,6 @@ var complete = {
         productDestinationId: "G-XXXXXXXXXX"
       }
     ],
-    eventSource: "WEB",
     batchSize: 100,
     batchInterval: 5e3,
     validateOnly: false,
@@ -169,16 +155,10 @@ var complete = {
     userId: "user.id",
     clientId: "user.device",
     sessionAttributes: "context.sessionAttributes"
-  },
-  data: {
-    map: {
-      eventSource: { value: "WEB" }
-    }
   }
 };
 var ga4 = {
   settings: {
-    accessToken: "ya29.c.xxx",
     destinations: [
       {
         operatingAccount: {
@@ -187,13 +167,12 @@ var ga4 = {
         },
         productDestinationId: "G-XXXXXXXXXX"
       }
-    ],
-    eventSource: "WEB"
+    ]
   }
 };
 var debug = {
   settings: {
-    accessToken: "ya29.c.xxx",
+    keyFilename: "./service-account.json",
     destinations: [
       {
         operatingAccount: {
@@ -202,12 +181,117 @@ var debug = {
         },
         productDestinationId: "AW-CONVERSION-123"
       }
-    ],
-    logLevel: "debug"
-    // Shows all API calls and responses
+    ]
+  }
+};
+
+// src/examples/mapping.ts
+var mapping_exports = {};
+__export(mapping_exports, {
+  Lead: () => Lead,
+  PageView: () => PageView,
+  Purchase: () => Purchase,
+  mapping: () => mapping,
+  userDataMapping: () => userDataMapping
+});
+import { isObject } from "@walkeros/core";
+var Purchase = {
+  name: "purchase",
+  data: {
+    map: {
+      // Required fields
+      transactionId: "data.id",
+      conversionValue: "data.total",
+      currency: { key: "data.currency", value: "USD" },
+      eventName: { value: "purchase" },
+      // User identification
+      userId: "user.id",
+      email: "user.id",
+      // Will be hashed automatically
+      // Attribution identifiers (captured by browser source from URL)
+      gclid: "context.gclid",
+      // Google Click ID
+      gbraid: "context.gbraid",
+      // iOS attribution
+      wbraid: "context.wbraid",
+      // Web-to-app
+      // Shopping cart data
+      cartData: {
+        map: {
+          items: {
+            loop: [
+              "nested",
+              {
+                condition: (entity) => isObject(entity) && entity.entity === "product",
+                map: {
+                  merchantProductId: "data.id",
+                  price: "data.price",
+                  quantity: { key: "data.quantity", value: 1 }
+                }
+              }
+            ]
+          }
+        }
+      }
+    }
+  }
+};
+var Lead = {
+  name: "generate_lead",
+  data: {
+    map: {
+      eventName: { value: "generate_lead" },
+      conversionValue: { value: 10 },
+      currency: { value: "USD" }
+    }
+  }
+};
+var PageView = {
+  name: "page_view",
+  data: {
+    map: {
+      eventName: { value: "page_view" }
+    }
+  }
+};
+var mapping = {
+  order: {
+    complete: Purchase
+  },
+  lead: {
+    submit: Lead
+  },
+  page: {
+    view: PageView
   }
 };
+var userDataMapping = {
+  settings: {
+    keyFilename: "./service-account.json",
+    destinations: [
+      {
+        operatingAccount: {
+          accountId: "123-456-7890",
+          accountType: "GOOGLE_ADS"
+        },
+        productDestinationId: "AW-CONVERSION-123"
+      }
+    ]
+  },
+  data: {
+    map: {
+      email: "user.id",
+      phone: "data.phone",
+      firstName: "data.firstName",
+      lastName: "data.lastName",
+      regionCode: "data.country",
+      postalCode: "data.zip"
+    }
+  },
+  mapping
+};
 export {
+  auth_exports as auth,
   basic_exports as basic,
   mapping_exports as mapping
 };

package/dist/index.d.mts

@@ -1,14 +1,29 @@
 import { Destination as Destination$1, Mapping as Mapping$1 } from '@walkeros/core';
 import { DestinationServer } from '@walkeros/server-core';
-
-type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
+import { OAuth2Client } from 'google-auth-library';
 
 interface Settings {
-    /** OAuth 2.0 access token with datamanager scope */
-    accessToken: string;
+    /**
+     * Service account credentials (client_email + private_key)
+     * Recommended for serverless environments (AWS Lambda, Docker, etc.)
+     */
+    credentials?: {
+        client_email: string;
+        private_key: string;
+    };
+    /**
+     * Path to service account JSON file
+     * For local development or environments with filesystem access
+     */
+    keyFilename?: string;
+    /**
+     * OAuth scopes for Data Manager API
+     * @default ['https://www.googleapis.com/auth/datamanager']
+     */
+    scopes?: string[];
     /** Array of destination accounts and conversion actions/user lists */
     destinations: Destination[];
-    /** Default event source if not specified per event */
+    /** Event source for all events. Defaults to WEB if not specified */
     eventSource?: EventSource;
     /** Maximum number of events to batch before sending (max 2000) */
     batchSize?: number;
@@ -22,8 +37,6 @@ interface Settings {
     consent?: Consent;
     /** Test event code for debugging (optional) */
     testEventCode?: string;
-    /** Log level for debugging (optional) */
-    logLevel?: LogLevel;
     /** Guided helpers: User data mapping (applies to all events) */
     userData?: Mapping$1.Map;
     /** Guided helper: First-party user ID */
@@ -45,14 +58,26 @@ interface Mapping {
 }
 interface Env extends DestinationServer.Env {
     fetch?: typeof fetch;
+    authClient?: OAuth2Client | null;
 }
-type Types = Destination$1.Types<Settings, Mapping, Env>;
+type InitSettings = Partial<Settings>;
+type Types = Destination$1.Types<Settings, Mapping, Env, InitSettings>;
 interface DestinationInterface extends DestinationServer.Destination<Types> {
     init: DestinationServer.InitFn<Types>;
 }
 type Config = {
     settings: Settings;
 } & DestinationServer.Config<Types>;
+/**
+ * Config after validation - settings is guaranteed to exist with required fields
+ * Use this type after calling getConfig() to get proper type narrowing
+ * After validation, eventSource is always set (defaults to 'WEB')
+ */
+type ValidatedConfig = Omit<Config, 'settings'> & {
+    settings: Settings & {
+        eventSource: EventSource;
+    };
+};
 type InitFn = DestinationServer.InitFn<Types>;
 type PushFn = DestinationServer.PushFn<Types>;
 type PartialConfig = DestinationServer.PartialConfig<Types>;
@@ -64,21 +89,27 @@ type Rules = Mapping$1.Rules<Rule>;
  * https://developers.google.com/data-manager/api/reference/rest/v1/Destination
  */
 interface Destination {
-    /** Operating account details */
-    operatingAccount: OperatingAccount;
+    /** Reference identifier for this destination */
+    reference?: string;
+    /** Login account (account initiating the request) */
+    loginAccount?: ProductAccount;
+    /** Linked account (child account linked to login account) */
+    linkedAccount?: ProductAccount;
+    /** Operating account (account where data is sent) */
+    operatingAccount?: ProductAccount;
     /** Product-specific destination ID (conversion action or user list) */
-    productDestinationId: string;
+    productDestinationId?: string;
 }
 /**
- * Operating account information
+ * Product account information
  */
-interface OperatingAccount {
+interface ProductAccount {
     /** Account ID (e.g., "123-456-7890" for Google Ads) */
     accountId: string;
     /** Type of account */
     accountType: AccountType;
 }
-type AccountType = 'GOOGLE_ADS' | 'DISPLAY_VIDEO_ADVERTISER' | 'DISPLAY_VIDEO_PARTNER' | 'GOOGLE_ANALYTICS_PROPERTY';
+type AccountType = 'ACCOUNT_TYPE_UNSPECIFIED' | 'GOOGLE_ADS' | 'DISPLAY_VIDEO_ADVERTISER' | 'DISPLAY_VIDEO_PARTNER' | 'GOOGLE_ANALYTICS_PROPERTY' | 'DATA_PARTNER';
 type EventSource = 'WEB' | 'APP' | 'IN_STORE' | 'PHONE' | 'OTHER';
 /**
  * Consent for Digital Markets Act (DMA) compliance
@@ -96,12 +127,10 @@ type ConsentStatus = 'CONSENT_GRANTED' | 'CONSENT_DENIED';
  * https://developers.google.com/data-manager/api/reference/rest/v1/events/ingest
  */
 interface IngestEventsRequest {
-    /** OAuth 2.0 access token */
-    access_token?: string;
-    /** Array of events to ingest (max 2000) */
-    events: Event[];
     /** Array of destinations for these events (max 10) */
     destinations: Destination[];
+    /** Array of events to ingest (max 2000) */
+    events: Event[];
     /** Request-level consent (overridden by event-level) */
     consent?: Consent;
     /** If true, validate without ingestion */
@@ -114,30 +143,85 @@ interface IngestEventsRequest {
  * https://developers.google.com/data-manager/api/reference/rest/v1/Event
  */
 interface Event {
-    /** Event timestamp in RFC 3339 format */
-    eventTimestamp: string;
+    /** Destination references for routing */
+    destinationReferences?: string[];
     /** Transaction ID for deduplication (max 512 chars) */
     transactionId?: string;
-    /** Google Analytics client ID (max 255 chars) */
-    clientId?: string;
-    /** First-party user ID (max 256 chars) */
-    userId?: string;
+    /** Event timestamp in RFC 3339 format */
+    eventTimestamp?: string;
+    /** Last updated timestamp in RFC 3339 format */
+    lastUpdatedTimestamp?: string;
     /** User data with identifiers (max 10 identifiers) */
     userData?: UserData;
+    /** Event-level consent (overrides request-level) */
+    consent?: Consent;
     /** Attribution identifiers */
     adIdentifiers?: AdIdentifiers;
-    /** Conversion value */
-    conversionValue?: number;
     /** Currency code (ISO 4217, 3 chars) */
     currency?: string;
+    /** Conversion value */
+    conversionValue?: number;
+    /** Source of the event */
+    eventSource?: EventSource;
+    /** Device information for the event */
+    eventDeviceInfo?: DeviceInfo;
     /** Shopping cart data */
     cartData?: CartData;
+    /** Custom variables for the event */
+    customVariables?: CustomVariable[];
+    /** Experimental fields (subject to change) */
+    experimentalFields?: ExperimentalField[];
+    /** User properties */
+    userProperties?: UserProperties;
     /** Event name for GA4 (max 40 chars, required for GA4) */
     eventName?: string;
-    /** Source of the event */
-    eventSource?: EventSource;
-    /** Event-level consent (overrides request-level) */
-    consent?: Consent;
+    /** Google Analytics client ID (max 255 chars) */
+    clientId?: string;
+    /** First-party user ID (max 256 chars) */
+    userId?: string;
+    /** Additional event parameters */
+    additionalEventParameters?: EventParameter[];
+}
+/**
+ * Device information
+ */
+interface DeviceInfo {
+    /** User agent string */
+    userAgent?: string;
+}
+/**
+ * Custom variable
+ */
+interface CustomVariable {
+    /** Variable name */
+    name?: string;
+    /** Variable value */
+    value?: string;
+}
+/**
+ * Experimental field
+ */
+interface ExperimentalField {
+    /** Field name */
+    name?: string;
+    /** Field value */
+    value?: string;
+}
+/**
+ * User properties
+ */
+interface UserProperties {
+    /** Property values */
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * Event parameter
+ */
+interface EventParameter {
+    /** Parameter name */
+    name?: string;
+    /** Parameter value */
+    value?: string | number;
 }
 /**
  * User data with identifiers
@@ -176,14 +260,16 @@ interface Address {
  * https://developers.google.com/data-manager/api/reference/rest/v1/AdIdentifiers
  */
 interface AdIdentifiers {
+    /** Session attributes (privacy-safe attribution) */
+    sessionAttributes?: string;
     /** Google Click ID (primary attribution) */
     gclid?: string;
     /** iOS attribution identifier (post-ATT) */
     gbraid?: string;
     /** Web-to-app attribution identifier */
     wbraid?: string;
-    /** Session attributes (privacy-safe attribution) */
-    sessionAttributes?: string;
+    /** Device information for landing page */
+    landingPageDeviceInfo?: DeviceInfo;
 }
 /**
  * Shopping cart data
@@ -263,17 +349,22 @@ type index_CartItem = CartItem;
 type index_Config = Config;
 type index_Consent = Consent;
 type index_ConsentStatus = ConsentStatus;
+type index_CustomVariable = CustomVariable;
 type index_Destination = Destination;
 type index_DestinationInterface = DestinationInterface;
+type index_DeviceInfo = DeviceInfo;
 type index_Env = Env;
 type index_Event = Event;
+type index_EventParameter = EventParameter;
 type index_EventSource = EventSource;
+type index_ExperimentalField = ExperimentalField;
 type index_IngestEventsRequest = IngestEventsRequest;
 type index_IngestEventsResponse = IngestEventsResponse;
 type index_InitFn = InitFn;
+type index_InitSettings = InitSettings;
 type index_Mapping = Mapping;
-type index_OperatingAccount = OperatingAccount;
 type index_PartialConfig = PartialConfig;
+type index_ProductAccount = ProductAccount;
 type index_PushEvents = PushEvents;
 type index_PushFn = PushFn;
 type index_RequestError = RequestError;
@@ -285,9 +376,11 @@ type index_Settings = Settings;
 type index_Types = Types;
 type index_UserData = UserData;
 type index_UserIdentifier = UserIdentifier;
+type index_UserProperties = UserProperties;
+type index_ValidatedConfig = ValidatedConfig;
 type index_ValidationError = ValidationError;
 declare namespace index {
-  export type { index_AccountType as AccountType, index_AdIdentifiers as AdIdentifiers, index_Address as Address, index_CartData as CartData, index_CartItem as CartItem, index_Config as Config, index_Consent as Consent, index_ConsentStatus as ConsentStatus, index_Destination as Destination, index_DestinationInterface as DestinationInterface, index_Env as Env, index_Event as Event, index_EventSource as EventSource, index_IngestEventsRequest as IngestEventsRequest, index_IngestEventsResponse as IngestEventsResponse, index_InitFn as InitFn, index_Mapping as Mapping, index_OperatingAccount as OperatingAccount, index_PartialConfig as PartialConfig, index_PushEvents as PushEvents, index_PushFn as PushFn, index_RequestError as RequestError, index_RequestState as RequestState, index_RequestStatusResponse as RequestStatusResponse, index_Rule as Rule, index_Rules as Rules, index_Settings as Settings, index_Types as Types, index_UserData as UserData, index_UserIdentifier as UserIdentifier, index_ValidationError as ValidationError };
+  export type { index_AccountType as AccountType, index_AdIdentifiers as AdIdentifiers, index_Address as Address, index_CartData as CartData, index_CartItem as CartItem, index_Config as Config, index_Consent as Consent, index_ConsentStatus as ConsentStatus, index_CustomVariable as CustomVariable, index_Destination as Destination, index_DestinationInterface as DestinationInterface, index_DeviceInfo as DeviceInfo, index_Env as Env, index_Event as Event, index_EventParameter as EventParameter, index_EventSource as EventSource, index_ExperimentalField as ExperimentalField, index_IngestEventsRequest as IngestEventsRequest, index_IngestEventsResponse as IngestEventsResponse, index_InitFn as InitFn, index_InitSettings as InitSettings, index_Mapping as Mapping, index_PartialConfig as PartialConfig, index_ProductAccount as ProductAccount, index_PushEvents as PushEvents, index_PushFn as PushFn, index_RequestError as RequestError, index_RequestState as RequestState, index_RequestStatusResponse as RequestStatusResponse, index_Rule as Rule, index_Rules as Rules, index_Settings as Settings, index_Types as Types, index_UserData as UserData, index_UserIdentifier as UserIdentifier, index_UserProperties as UserProperties, index_ValidatedConfig as ValidatedConfig, index_ValidationError as ValidationError };
 }
 
 declare const destinationDataManager: DestinationInterface;