@walkeros/server-destination-datamanager 0.3.1 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/dev.d.ts ADDED
@@ -0,0 +1,235 @@
1
+ import { JSONSchema } from '@walkeros/core/dev';
2
+ import { Mapping as Mapping$1, Destination as Destination$1 } from '@walkeros/core';
3
+ import { DestinationServer } from '@walkeros/server-core';
4
+ import { OAuth2Client } from 'google-auth-library';
5
+
6
+ declare const schemas$1: Record<string, JSONSchema>;
7
+
8
+ declare namespace schemas {
9
+ export { schemas$1 as schemas };
10
+ }
11
+
12
+ type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
13
+
14
+ interface Settings {
15
+ /**
16
+ * Service account credentials (client_email + private_key)
17
+ * Recommended for serverless environments (AWS Lambda, Docker, etc.)
18
+ */
19
+ credentials?: {
20
+ client_email: string;
21
+ private_key: string;
22
+ };
23
+ /**
24
+ * Path to service account JSON file
25
+ * For local development or environments with filesystem access
26
+ */
27
+ keyFilename?: string;
28
+ /**
29
+ * OAuth scopes for Data Manager API
30
+ * @default ['https://www.googleapis.com/auth/datamanager']
31
+ */
32
+ scopes?: string[];
33
+ /** Array of destination accounts and conversion actions/user lists */
34
+ destinations: Destination[];
35
+ /** Default event source if not specified per event */
36
+ eventSource?: EventSource;
37
+ /** Maximum number of events to batch before sending (max 2000) */
38
+ batchSize?: number;
39
+ /** Time in milliseconds to wait before auto-flushing batch */
40
+ batchInterval?: number;
41
+ /** If true, validate request without ingestion (testing mode) */
42
+ validateOnly?: boolean;
43
+ /** Override API endpoint (for testing) */
44
+ url?: string;
45
+ /** Request-level consent for all events */
46
+ consent?: Consent;
47
+ /** Test event code for debugging (optional) */
48
+ testEventCode?: string;
49
+ /** Log level for debugging (optional) */
50
+ logLevel?: LogLevel;
51
+ /** Guided helpers: User data mapping (applies to all events) */
52
+ userData?: Mapping$1.Map;
53
+ /** Guided helper: First-party user ID */
54
+ userId?: Mapping$1.Value;
55
+ /** Guided helper: GA4 client ID */
56
+ clientId?: Mapping$1.Value;
57
+ /** Guided helper: Privacy-safe attribution (Google's sessionAttributes) */
58
+ sessionAttributes?: Mapping$1.Value;
59
+ /** Consent mapping: Map consent field to adUserData (string = field name, boolean = static value) */
60
+ consentAdUserData?: string | boolean;
61
+ /** Consent mapping: Map consent field to adPersonalization (string = field name, boolean = static value) */
62
+ consentAdPersonalization?: string | boolean;
63
+ }
64
+ interface Mapping {
65
+ gclid?: Mapping$1.Value;
66
+ gbraid?: Mapping$1.Value;
67
+ wbraid?: Mapping$1.Value;
68
+ sessionAttributes?: Mapping$1.Value;
69
+ }
70
+ interface Env extends DestinationServer.Env {
71
+ fetch?: typeof fetch;
72
+ authClient?: OAuth2Client | null;
73
+ }
74
+ type InitSettings = Partial<Settings>;
75
+ type Types = Destination$1.Types<Settings, Mapping, Env, InitSettings>;
76
+ type Config = {
77
+ settings: Settings;
78
+ } & DestinationServer.Config<Types>;
79
+ type Rule = Mapping$1.Rule<Mapping>;
80
+ /**
81
+ * Destination account and product identifier
82
+ * https://developers.google.com/data-manager/api/reference/rest/v1/Destination
83
+ */
84
+ interface Destination {
85
+ /** Reference identifier for this destination */
86
+ reference?: string;
87
+ /** Login account (account initiating the request) */
88
+ loginAccount?: ProductAccount;
89
+ /** Linked account (child account linked to login account) */
90
+ linkedAccount?: ProductAccount;
91
+ /** Operating account (account where data is sent) */
92
+ operatingAccount?: ProductAccount;
93
+ /** Product-specific destination ID (conversion action or user list) */
94
+ productDestinationId?: string;
95
+ }
96
+ /**
97
+ * Product account information
98
+ */
99
+ interface ProductAccount {
100
+ /** Account ID (e.g., "123-456-7890" for Google Ads) */
101
+ accountId: string;
102
+ /** Type of account */
103
+ accountType: AccountType;
104
+ }
105
+ type AccountType = 'ACCOUNT_TYPE_UNSPECIFIED' | 'GOOGLE_ADS' | 'DISPLAY_VIDEO_ADVERTISER' | 'DISPLAY_VIDEO_PARTNER' | 'GOOGLE_ANALYTICS_PROPERTY' | 'DATA_PARTNER';
106
+ type EventSource = 'WEB' | 'APP' | 'IN_STORE' | 'PHONE' | 'OTHER';
107
+ /**
108
+ * Consent for Digital Markets Act (DMA) compliance
109
+ * https://developers.google.com/data-manager/api/devguides/concepts/dma
110
+ */
111
+ interface Consent {
112
+ /** Consent for data collection and use */
113
+ adUserData?: ConsentStatus;
114
+ /** Consent for ad personalization */
115
+ adPersonalization?: ConsentStatus;
116
+ }
117
+ type ConsentStatus = 'CONSENT_GRANTED' | 'CONSENT_DENIED';
118
+
119
+ /**
120
+ * AWS Lambda / Serverless Configuration
121
+ * Uses inline credentials from environment variables
122
+ * Best for: AWS Lambda, Docker, Kubernetes, any serverless environment
123
+ */
124
+ declare const awsLambda: Config;
125
+ /**
126
+ * GCP Cloud Functions / Cloud Run Configuration
127
+ * Uses Application Default Credentials (ADC) - no explicit auth config needed
128
+ * Best for: Google Cloud Functions, Cloud Run, GCE, GKE
129
+ */
130
+ declare const gcpCloudFunctions: Config;
131
+ /**
132
+ * Local Development Configuration
133
+ * Uses service account JSON file
134
+ * Best for: Local development, testing
135
+ */
136
+ declare const localDevelopment: Config;
137
+ /**
138
+ * Docker / Kubernetes Configuration
139
+ * Uses ADC via GOOGLE_APPLICATION_CREDENTIALS environment variable
140
+ * Best for: Docker containers, Kubernetes pods
141
+ *
142
+ * Setup:
143
+ * 1. Mount service account JSON as secret/configmap
144
+ * 2. Set GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
145
+ * 3. ADC will automatically use it
146
+ */
147
+ declare const dockerKubernetes: Config;
148
+ /**
149
+ * Custom Scopes Configuration
150
+ * For specific use cases requiring different OAuth scopes
151
+ */
152
+ declare const customScopes: Config;
153
+
154
+ declare const auth_awsLambda: typeof awsLambda;
155
+ declare const auth_customScopes: typeof customScopes;
156
+ declare const auth_dockerKubernetes: typeof dockerKubernetes;
157
+ declare const auth_gcpCloudFunctions: typeof gcpCloudFunctions;
158
+ declare const auth_localDevelopment: typeof localDevelopment;
159
+ declare namespace auth {
160
+ export { auth_awsLambda as awsLambda, auth_customScopes as customScopes, auth_dockerKubernetes as dockerKubernetes, auth_gcpCloudFunctions as gcpCloudFunctions, auth_localDevelopment as localDevelopment };
161
+ }
162
+
163
+ /**
164
+ * Minimal configuration for Google Data Manager with inline credentials
165
+ */
166
+ declare const minimal: Config;
167
+ /**
168
+ * Complete configuration with all options
169
+ */
170
+ declare const complete: Config;
171
+ /**
172
+ * GA4-specific configuration using Application Default Credentials
173
+ */
174
+ declare const ga4: Config;
175
+ /**
176
+ * Debug configuration with logging enabled using keyFilename
177
+ */
178
+ declare const debug: Config;
179
+
180
+ declare const basic_complete: typeof complete;
181
+ declare const basic_debug: typeof debug;
182
+ declare const basic_ga4: typeof ga4;
183
+ declare const basic_minimal: typeof minimal;
184
+ declare namespace basic {
185
+ export { basic_complete as complete, basic_debug as debug, basic_ga4 as ga4, basic_minimal as minimal };
186
+ }
187
+
188
+ /**
189
+ * Purchase event mapping for Google Ads conversion
190
+ */
191
+ declare const Purchase: Rule;
192
+ /**
193
+ * Lead event mapping
194
+ */
195
+ declare const Lead: Rule;
196
+ /**
197
+ * Page view mapping for GA4
198
+ */
199
+ declare const PageView: Rule;
200
+ /**
201
+ * Complete mapping configuration
202
+ */
203
+ declare const mapping: {
204
+ order: {
205
+ complete: Rule;
206
+ };
207
+ lead: {
208
+ submit: Rule;
209
+ };
210
+ page: {
211
+ view: Rule;
212
+ };
213
+ };
214
+ /**
215
+ * User data mapping configuration
216
+ * Maps walkerOS user properties to Data Manager user identifiers
217
+ */
218
+ declare const userDataMapping: Config;
219
+
220
+ declare const mapping$1_Lead: typeof Lead;
221
+ declare const mapping$1_PageView: typeof PageView;
222
+ declare const mapping$1_Purchase: typeof Purchase;
223
+ declare const mapping$1_mapping: typeof mapping;
224
+ declare const mapping$1_userDataMapping: typeof userDataMapping;
225
+ declare namespace mapping$1 {
226
+ export { mapping$1_Lead as Lead, mapping$1_PageView as PageView, mapping$1_Purchase as Purchase, mapping$1_mapping as mapping, mapping$1_userDataMapping as userDataMapping };
227
+ }
228
+
229
+ declare const index_auth: typeof auth;
230
+ declare const index_basic: typeof basic;
231
+ declare namespace index {
232
+ export { index_auth as auth, index_basic as basic, mapping$1 as mapping };
233
+ }
234
+
235
+ export { index as examples, schemas };
package/dist/dev.js ADDED
@@ -0,0 +1 @@
1
+ "use strict";var e,t=Object.defineProperty,a=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,i=(e,a)=>{for(var n in a)t(e,n,{get:a[n],enumerable:!0})},c={};i(c,{examples:()=>A,schemas:()=>s}),module.exports=(e=c,((e,i,c,s)=>{if(i&&"object"==typeof i||"function"==typeof i)for(let r of n(i))o.call(e,r)||r===c||t(e,r,{get:()=>i[r],enumerable:!(s=a(i,r))||s.enumerable});return e})(t({},"__esModule",{value:!0}),e));var s={};i(s,{schemas:()=>I});var r=require("@walkeros/core/dev"),d=r.z.enum(["GOOGLE_ADS","DISPLAY_VIDEO_ADVERTISER","DISPLAY_VIDEO_PARTNER","GOOGLE_ANALYTICS_PROPERTY"]),u=r.z.enum(["WEB","APP","IN_STORE","PHONE","OTHER"]),l=r.z.enum(["CONSENT_GRANTED","CONSENT_DENIED"]),p=r.z.object({adUserData:l.describe("Consent for data collection and use").optional(),adPersonalization:l.describe("Consent for ad personalization").optional()}),m=r.z.object({accountId:r.z.string().min(1).describe('Account ID (e.g., "123-456-7890" for Google Ads)'),accountType:d.describe("Type of account")}),g=r.z.object({operatingAccount:m.describe("Operating account details"),productDestinationId:r.z.string().min(1).describe("Product-specific destination ID (conversion action or user list)")}),v=require("@walkeros/core/dev"),O=v.z.object({accessToken:v.z.string().min(1).describe("OAuth 2.0 access token with datamanager scope (like ya29.c.xxx)"),destinations:v.z.array(g).min(1).max(10).describe("Array of destination accounts and conversion actions/user lists (max 10)"),eventSource:u.describe("Default event source if not specified per event (like WEB)").optional(),batchSize:v.z.number().int().min(1).max(2e3).describe("Maximum number of events to batch before sending (max 2000, like 100)").optional(),batchInterval:v.z.number().int().min(0).describe("Time in milliseconds to wait before auto-flushing batch (like 5000)").optional(),validateOnly:v.z.boolean().describe("If true, validate request without ingestion (testing mode)").optional(),url:v.z.string().url().describe("Override API endpoint for testing (like https://datamanager.googleapis.com/v1)").optional(),consent:p.describe("Request-level consent for all events").optional(),testEventCode:v.z.string().describe("Test event code for debugging (like TEST12345)").optional(),logLevel:v.z.enum(["debug","info","warn","error","none"]).describe("Log level for debugging (debug shows all API calls)").optional(),userData:v.z.record(v.z.string(),v.z.unknown()).describe("Guided helper: User data mapping for all events (like { email: 'user.id', phone: 'data.phone' })").optional(),userId:v.z.any().describe("Guided helper: First-party user ID for all events (like 'user.id')").optional(),clientId:v.z.any().describe("Guided helper: GA4 client ID for all events (like 'user.device')").optional(),sessionAttributes:v.z.any().describe("Guided helper: Privacy-safe attribution for all events (like 'context.sessionAttributes')").optional(),consentAdUserData:v.z.union([v.z.string(),v.z.boolean()]).describe("Consent mapping: Field name from event.consent (like 'marketing') or static boolean value").optional(),consentAdPersonalization:v.z.union([v.z.string(),v.z.boolean()]).describe("Consent mapping: Field name from event.consent (like 'targeting') or static boolean value").optional()}),E=require("@walkeros/core/dev").z.object({}),b=require("@walkeros/core/dev"),I={settings:(0,b.zodToSchema)(O),mapping:(0,b.zodToSchema)(E)},A={};i(A,{auth:()=>N,basic:()=>S,mapping:()=>k});var N={};i(N,{awsLambda:()=>D,customScopes:()=>T,dockerKubernetes:()=>y,gcpCloudFunctions:()=>G,localDevelopment:()=>_});var D={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"}]}},G={settings:{destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},_={settings:{keyFilename:"./service-account.json",destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},y={settings:{destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},T={settings:{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:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},S={};i(S,{complete:()=>f,debug:()=>P,ga4:()=>h,minimal:()=>z});var z={settings:{credentials:{client_email:"service-account@project.iam.gserviceaccount.com",private_key:"-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"},destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},f={settings:{credentials:{client_email:"service-account@project.iam.gserviceaccount.com",private_key:"-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"},destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"},{operatingAccount:{accountId:"987654321",accountType:"GOOGLE_ANALYTICS_PROPERTY"},productDestinationId:"G-XXXXXXXXXX"}],eventSource:"WEB",batchSize:100,batchInterval:5e3,validateOnly:!1,consent:{adUserData:"CONSENT_GRANTED",adPersonalization:"CONSENT_GRANTED"},userData:{email:"user.id",phone:"data.phone",firstName:"data.firstName",lastName:"data.lastName"},userId:"user.id",clientId:"user.device",sessionAttributes:"context.sessionAttributes"},data:{map:{eventSource:{value:"WEB"}}}},h={settings:{destinations:[{operatingAccount:{accountId:"123456789",accountType:"GOOGLE_ANALYTICS_PROPERTY"},productDestinationId:"G-XXXXXXXXXX"}],eventSource:"WEB"}},P={settings:{keyFilename:"./service-account.json",destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}],logLevel:"debug"}},k={};i(k,{Lead:()=>C,PageView:()=>w,Purchase:()=>R,mapping:()=>V,userDataMapping:()=>X});var L=require("@walkeros/core"),R={name:"purchase",data:{map:{transactionId:"data.id",conversionValue:"data.total",currency:{key:"data.currency",value:"USD"},eventName:{value:"purchase"},userId:"user.id",email:"user.id",gclid:"context.gclid",gbraid:"context.gbraid",wbraid:"context.wbraid",cartData:{map:{items:{loop:["nested",{condition:e=>(0,L.isObject)(e)&&"product"===e.entity,map:{merchantProductId:"data.id",price:"data.price",quantity:{key:"data.quantity",value:1}}}]}}}}}},C={name:"generate_lead",data:{map:{eventName:{value:"generate_lead"},conversionValue:{value:10},currency:{value:"USD"}}}},w={name:"page_view",data:{map:{eventName:{value:"page_view"}}}},V={order:{complete:R},lead:{submit:C},page:{view:w}},X={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:V};//# sourceMappingURL=dev.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/dev.ts","../src/schemas.ts","../src/schemas/primitives.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/schemas/index.ts","../src/examples/index.ts","../src/examples/auth.ts","../src/examples/basic.ts","../src/examples/mapping.ts"],"sourcesContent":["export * as schemas from './schemas';\nexport * as examples from './examples';\n","// Browser-safe schema-only exports\n// This file exports ONLY schemas without any Node.js dependencies\nimport { schemas } from './schemas/index';\n\nexport { schemas };\n","import { z } from '@walkeros/core/dev';\n\nexport const AccountTypeSchema = z.enum([\n 'GOOGLE_ADS',\n 'DISPLAY_VIDEO_ADVERTISER',\n 'DISPLAY_VIDEO_PARTNER',\n 'GOOGLE_ANALYTICS_PROPERTY',\n]);\n\nexport const EventSourceSchema = z.enum([\n 'WEB',\n 'APP',\n 'IN_STORE',\n 'PHONE',\n 'OTHER',\n]);\n\nexport const ConsentStatusSchema = z.enum([\n 'CONSENT_GRANTED',\n 'CONSENT_DENIED',\n]);\n\nexport const ConsentSchema = z.object({\n adUserData: ConsentStatusSchema.describe(\n 'Consent for data collection and use',\n ).optional(),\n adPersonalization: ConsentStatusSchema.describe(\n 'Consent for ad personalization',\n ).optional(),\n});\n\nexport const OperatingAccountSchema = z.object({\n accountId: z\n .string()\n .min(1)\n .describe('Account ID (e.g., \"123-456-7890\" for Google Ads)'),\n accountType: AccountTypeSchema.describe('Type of account'),\n});\n\nexport const DestinationSchema = z.object({\n operatingAccount: OperatingAccountSchema.describe(\n 'Operating account details',\n ),\n productDestinationId: z\n .string()\n .min(1)\n .describe(\n 'Product-specific destination ID (conversion action or user list)',\n ),\n});\n","import { z } from '@walkeros/core/dev';\nimport {\n DestinationSchema,\n EventSourceSchema,\n ConsentSchema,\n} from './primitives';\n\nexport const SettingsSchema = z.object({\n accessToken: z\n .string()\n .min(1)\n .describe(\n 'OAuth 2.0 access token with datamanager scope (like ya29.c.xxx)',\n ),\n destinations: z\n .array(DestinationSchema)\n .min(1)\n .max(10)\n .describe(\n 'Array of destination accounts and conversion actions/user lists (max 10)',\n ),\n eventSource: EventSourceSchema.describe(\n 'Default event source if not specified per event (like WEB)',\n ).optional(),\n batchSize: z\n .number()\n .int()\n .min(1)\n .max(2000)\n .describe(\n 'Maximum number of events to batch before sending (max 2000, like 100)',\n )\n .optional(),\n batchInterval: z\n .number()\n .int()\n .min(0)\n .describe(\n 'Time in milliseconds to wait before auto-flushing batch (like 5000)',\n )\n .optional(),\n validateOnly: z\n .boolean()\n .describe('If true, validate request without ingestion (testing mode)')\n .optional(),\n url: z\n .string()\n .url()\n .describe(\n 'Override API endpoint for testing (like https://datamanager.googleapis.com/v1)',\n )\n .optional(),\n consent: ConsentSchema.describe(\n 'Request-level consent for all events',\n ).optional(),\n testEventCode: z\n .string()\n .describe('Test event code for debugging (like TEST12345)')\n .optional(),\n logLevel: z\n .enum(['debug', 'info', 'warn', 'error', 'none'])\n .describe('Log level for debugging (debug shows all API calls)')\n .optional(),\n userData: z\n .record(z.string(), z.unknown())\n .describe(\n \"Guided helper: User data mapping for all events (like { email: 'user.id', phone: 'data.phone' })\",\n )\n .optional(),\n userId: z\n .any()\n .describe(\n \"Guided helper: First-party user ID for all events (like 'user.id')\",\n )\n .optional(),\n clientId: z\n .any()\n .describe(\n \"Guided helper: GA4 client ID for all events (like 'user.device')\",\n )\n .optional(),\n sessionAttributes: z\n .any()\n .describe(\n \"Guided helper: Privacy-safe attribution for all events (like 'context.sessionAttributes')\",\n )\n .optional(),\n consentAdUserData: z\n .union([z.string(), z.boolean()])\n .describe(\n \"Consent mapping: Field name from event.consent (like 'marketing') or static boolean value\",\n )\n .optional(),\n consentAdPersonalization: z\n .union([z.string(), z.boolean()])\n .describe(\n \"Consent mapping: Field name from event.consent (like 'targeting') or static boolean value\",\n )\n .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n// Data Manager uses flexible mapping via walkerOS mapping system\n// No event-specific mapping schema needed (similar to Meta CAPI pattern)\nexport const MappingSchema = z.object({});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * from './primitives';\nexport * from './settings';\nexport * from './mapping';\n\nimport { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nimport type { JSONSchema } from '@walkeros/core/dev';\n\nexport const schemas: Record<string, JSONSchema> = {\n settings: zodToSchema(SettingsSchema),\n mapping: zodToSchema(MappingSchema),\n};\n","export * as auth from './auth';\nexport * as basic from './basic';\nexport * as mapping from './mapping';\n","import type { DestinationDataManager } from '..';\n\n/**\n * AWS Lambda / Serverless Configuration\n * Uses inline credentials from environment variables\n * Best for: AWS Lambda, Docker, Kubernetes, any serverless environment\n */\nexport const awsLambda: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: process.env.GOOGLE_CLIENT_EMAIL!,\n private_key: process.env.GOOGLE_PRIVATE_KEY!.replace(/\\\\n/g, '\\n'),\n },\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * GCP Cloud Functions / Cloud Run Configuration\n * Uses Application Default Credentials (ADC) - no explicit auth config needed\n * Best for: Google Cloud Functions, Cloud Run, GCE, GKE\n */\nexport const gcpCloudFunctions: DestinationDataManager.Config = {\n settings: {\n // No auth config needed - ADC works automatically on GCP!\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Local Development Configuration\n * Uses service account JSON file\n * Best for: Local development, testing\n */\nexport const localDevelopment: DestinationDataManager.Config = {\n settings: {\n keyFilename: './service-account.json',\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Docker / Kubernetes Configuration\n * Uses ADC via GOOGLE_APPLICATION_CREDENTIALS environment variable\n * Best for: Docker containers, Kubernetes pods\n *\n * Setup:\n * 1. Mount service account JSON as secret/configmap\n * 2. Set GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json\n * 3. ADC will automatically use it\n */\nexport const dockerKubernetes: DestinationDataManager.Config = {\n settings: {\n // No explicit config - ADC uses GOOGLE_APPLICATION_CREDENTIALS env var\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Custom Scopes Configuration\n * For specific use cases requiring different OAuth scopes\n */\nexport const customScopes: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: process.env.GOOGLE_CLIENT_EMAIL!,\n private_key: process.env.GOOGLE_PRIVATE_KEY!.replace(/\\\\n/g, '\\n'),\n },\n scopes: ['https://www.googleapis.com/auth/datamanager'],\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n","import type { DestinationDataManager } from '..';\n\n/**\n * Minimal configuration for Google Data Manager with inline credentials\n */\nexport const minimal: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: 'service-account@project.iam.gserviceaccount.com',\n private_key:\n '-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n',\n },\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Complete configuration with all options\n */\nexport const complete: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: 'service-account@project.iam.gserviceaccount.com',\n private_key:\n '-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n',\n },\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n {\n operatingAccount: {\n accountId: '987654321',\n accountType: 'GOOGLE_ANALYTICS_PROPERTY',\n },\n productDestinationId: 'G-XXXXXXXXXX',\n },\n ],\n eventSource: 'WEB',\n batchSize: 100,\n batchInterval: 5000,\n validateOnly: false,\n consent: {\n adUserData: 'CONSENT_GRANTED',\n adPersonalization: 'CONSENT_GRANTED',\n },\n\n // Guided helpers (apply to all events)\n userData: {\n email: 'user.id',\n phone: 'data.phone',\n firstName: 'data.firstName',\n lastName: 'data.lastName',\n },\n userId: 'user.id',\n clientId: 'user.device',\n sessionAttributes: 'context.sessionAttributes',\n },\n data: {\n map: {\n eventSource: { value: 'WEB' },\n },\n },\n};\n\n/**\n * GA4-specific configuration using Application Default Credentials\n */\nexport const ga4: DestinationDataManager.Config = {\n settings: {\n destinations: [\n {\n operatingAccount: {\n accountId: '123456789',\n accountType: 'GOOGLE_ANALYTICS_PROPERTY',\n },\n productDestinationId: 'G-XXXXXXXXXX',\n },\n ],\n eventSource: 'WEB',\n },\n};\n\n/**\n * Debug configuration with logging enabled using keyFilename\n */\nexport const debug: DestinationDataManager.Config = {\n settings: {\n keyFilename: './service-account.json',\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n logLevel: 'debug', // Shows all API calls and responses\n },\n};\n","import type { DestinationDataManager } from '..';\nimport { isObject } from '@walkeros/core';\n\n/**\n * Purchase event mapping for Google Ads conversion\n */\nexport const Purchase: DestinationDataManager.Rule = {\n name: 'purchase',\n data: {\n map: {\n // Required fields\n transactionId: 'data.id',\n conversionValue: 'data.total',\n currency: { key: 'data.currency', value: 'USD' },\n eventName: { value: 'purchase' },\n\n // User identification\n userId: 'user.id',\n email: 'user.id', // Will be hashed automatically\n\n // Attribution identifiers (captured by browser source from URL)\n gclid: 'context.gclid', // Google Click ID\n gbraid: 'context.gbraid', // iOS attribution\n wbraid: 'context.wbraid', // Web-to-app\n\n // Shopping cart data\n cartData: {\n map: {\n items: {\n loop: [\n 'nested',\n {\n condition: (entity) =>\n isObject(entity) && entity.entity === 'product',\n map: {\n merchantProductId: 'data.id',\n price: 'data.price',\n quantity: { key: 'data.quantity', value: 1 },\n },\n },\n ],\n },\n },\n },\n },\n },\n};\n\n/**\n * Lead event mapping\n */\nexport const Lead: DestinationDataManager.Rule = {\n name: 'generate_lead',\n data: {\n map: {\n eventName: { value: 'generate_lead' },\n conversionValue: { value: 10 },\n currency: { value: 'USD' },\n },\n },\n};\n\n/**\n * Page view mapping for GA4\n */\nexport const PageView: DestinationDataManager.Rule = {\n name: 'page_view',\n data: {\n map: {\n eventName: { value: 'page_view' },\n },\n },\n};\n\n/**\n * Complete mapping configuration\n */\nexport const mapping = {\n order: {\n complete: Purchase,\n },\n lead: {\n submit: Lead,\n },\n page: {\n view: PageView,\n },\n} satisfies DestinationDataManager.Rules;\n\n/**\n * User data mapping configuration\n * Maps walkerOS user properties to Data Manager user identifiers\n */\nexport const userDataMapping: DestinationDataManager.Config = {\n settings: {\n keyFilename: './service-account.json',\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n data: {\n map: {\n email: 'user.id',\n phone: 'data.phone',\n firstName: 'data.firstName',\n lastName: 'data.lastName',\n regionCode: 'data.country',\n postalCode: 'data.zip',\n },\n },\n mapping,\n};\n"],"mappings":"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","names":["import_dev","import_dev","import_dev"]}
package/dist/dev.mjs ADDED
@@ -0,0 +1 @@
1
+ var e=Object.defineProperty,t=(t,a)=>{for(var n in a)e(t,n,{get:a[n],enumerable:!0})},a={};t(a,{schemas:()=>v});import{z as n}from"@walkeros/core/dev";var o=n.enum(["GOOGLE_ADS","DISPLAY_VIDEO_ADVERTISER","DISPLAY_VIDEO_PARTNER","GOOGLE_ANALYTICS_PROPERTY"]),i=n.enum(["WEB","APP","IN_STORE","PHONE","OTHER"]),c=n.enum(["CONSENT_GRANTED","CONSENT_DENIED"]),s=n.object({adUserData:c.describe("Consent for data collection and use").optional(),adPersonalization:c.describe("Consent for ad personalization").optional()}),r=n.object({accountId:n.string().min(1).describe('Account ID (e.g., "123-456-7890" for Google Ads)'),accountType:o.describe("Type of account")}),d=n.object({operatingAccount:r.describe("Operating account details"),productDestinationId:n.string().min(1).describe("Product-specific destination ID (conversion action or user list)")});import{z as u}from"@walkeros/core/dev";var l=u.object({accessToken:u.string().min(1).describe("OAuth 2.0 access token with datamanager scope (like ya29.c.xxx)"),destinations:u.array(d).min(1).max(10).describe("Array of destination accounts and conversion actions/user lists (max 10)"),eventSource:i.describe("Default event source if not specified per event (like WEB)").optional(),batchSize:u.number().int().min(1).max(2e3).describe("Maximum number of events to batch before sending (max 2000, like 100)").optional(),batchInterval:u.number().int().min(0).describe("Time in milliseconds to wait before auto-flushing batch (like 5000)").optional(),validateOnly:u.boolean().describe("If true, validate request without ingestion (testing mode)").optional(),url:u.string().url().describe("Override API endpoint for testing (like https://datamanager.googleapis.com/v1)").optional(),consent:s.describe("Request-level consent for all events").optional(),testEventCode:u.string().describe("Test event code for debugging (like TEST12345)").optional(),logLevel:u.enum(["debug","info","warn","error","none"]).describe("Log level for debugging (debug shows all API calls)").optional(),userData:u.record(u.string(),u.unknown()).describe("Guided helper: User data mapping for all events (like { email: 'user.id', phone: 'data.phone' })").optional(),userId:u.any().describe("Guided helper: First-party user ID for all events (like 'user.id')").optional(),clientId:u.any().describe("Guided helper: GA4 client ID for all events (like 'user.device')").optional(),sessionAttributes:u.any().describe("Guided helper: Privacy-safe attribution for all events (like 'context.sessionAttributes')").optional(),consentAdUserData:u.union([u.string(),u.boolean()]).describe("Consent mapping: Field name from event.consent (like 'marketing') or static boolean value").optional(),consentAdPersonalization:u.union([u.string(),u.boolean()]).describe("Consent mapping: Field name from event.consent (like 'targeting') or static boolean value").optional()});import{z as p}from"@walkeros/core/dev";var m=p.object({});import{zodToSchema as g}from"@walkeros/core/dev";var v={settings:g(l),mapping:g(m)},E={};t(E,{auth:()=>I,basic:()=>G,mapping:()=>f});var I={};t(I,{awsLambda:()=>O,customScopes:()=>D,dockerKubernetes:()=>N,gcpCloudFunctions:()=>A,localDevelopment:()=>b});var O={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"}]}},A={settings:{destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},b={settings:{keyFilename:"./service-account.json",destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},N={settings:{destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},D={settings:{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:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},G={};t(G,{complete:()=>T,debug:()=>S,ga4:()=>y,minimal:()=>_});var _={settings:{credentials:{client_email:"service-account@project.iam.gserviceaccount.com",private_key:"-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"},destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}]}},T={settings:{credentials:{client_email:"service-account@project.iam.gserviceaccount.com",private_key:"-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"},destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"},{operatingAccount:{accountId:"987654321",accountType:"GOOGLE_ANALYTICS_PROPERTY"},productDestinationId:"G-XXXXXXXXXX"}],eventSource:"WEB",batchSize:100,batchInterval:5e3,validateOnly:!1,consent:{adUserData:"CONSENT_GRANTED",adPersonalization:"CONSENT_GRANTED"},userData:{email:"user.id",phone:"data.phone",firstName:"data.firstName",lastName:"data.lastName"},userId:"user.id",clientId:"user.device",sessionAttributes:"context.sessionAttributes"},data:{map:{eventSource:{value:"WEB"}}}},y={settings:{destinations:[{operatingAccount:{accountId:"123456789",accountType:"GOOGLE_ANALYTICS_PROPERTY"},productDestinationId:"G-XXXXXXXXXX"}],eventSource:"WEB"}},S={settings:{keyFilename:"./service-account.json",destinations:[{operatingAccount:{accountId:"123-456-7890",accountType:"GOOGLE_ADS"},productDestinationId:"AW-CONVERSION-123"}],logLevel:"debug"}},f={};t(f,{Lead:()=>L,PageView:()=>R,Purchase:()=>k,mapping:()=>P,userDataMapping:()=>C});import{isObject as h}from"@walkeros/core";var k={name:"purchase",data:{map:{transactionId:"data.id",conversionValue:"data.total",currency:{key:"data.currency",value:"USD"},eventName:{value:"purchase"},userId:"user.id",email:"user.id",gclid:"context.gclid",gbraid:"context.gbraid",wbraid:"context.wbraid",cartData:{map:{items:{loop:["nested",{condition:e=>h(e)&&"product"===e.entity,map:{merchantProductId:"data.id",price:"data.price",quantity:{key:"data.quantity",value:1}}}]}}}}}},L={name:"generate_lead",data:{map:{eventName:{value:"generate_lead"},conversionValue:{value:10},currency:{value:"USD"}}}},R={name:"page_view",data:{map:{eventName:{value:"page_view"}}}},P={order:{complete:k},lead:{submit:L},page:{view:R}},C={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:P};export{E as examples,a as schemas};//# sourceMappingURL=dev.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/schemas.ts","../src/schemas/primitives.ts","../src/schemas/settings.ts","../src/schemas/mapping.ts","../src/schemas/index.ts","../src/examples/index.ts","../src/examples/auth.ts","../src/examples/basic.ts","../src/examples/mapping.ts"],"sourcesContent":["// Browser-safe schema-only exports\n// This file exports ONLY schemas without any Node.js dependencies\nimport { schemas } from './schemas/index';\n\nexport { schemas };\n","import { z } from '@walkeros/core/dev';\n\nexport const AccountTypeSchema = z.enum([\n 'GOOGLE_ADS',\n 'DISPLAY_VIDEO_ADVERTISER',\n 'DISPLAY_VIDEO_PARTNER',\n 'GOOGLE_ANALYTICS_PROPERTY',\n]);\n\nexport const EventSourceSchema = z.enum([\n 'WEB',\n 'APP',\n 'IN_STORE',\n 'PHONE',\n 'OTHER',\n]);\n\nexport const ConsentStatusSchema = z.enum([\n 'CONSENT_GRANTED',\n 'CONSENT_DENIED',\n]);\n\nexport const ConsentSchema = z.object({\n adUserData: ConsentStatusSchema.describe(\n 'Consent for data collection and use',\n ).optional(),\n adPersonalization: ConsentStatusSchema.describe(\n 'Consent for ad personalization',\n ).optional(),\n});\n\nexport const OperatingAccountSchema = z.object({\n accountId: z\n .string()\n .min(1)\n .describe('Account ID (e.g., \"123-456-7890\" for Google Ads)'),\n accountType: AccountTypeSchema.describe('Type of account'),\n});\n\nexport const DestinationSchema = z.object({\n operatingAccount: OperatingAccountSchema.describe(\n 'Operating account details',\n ),\n productDestinationId: z\n .string()\n .min(1)\n .describe(\n 'Product-specific destination ID (conversion action or user list)',\n ),\n});\n","import { z } from '@walkeros/core/dev';\nimport {\n DestinationSchema,\n EventSourceSchema,\n ConsentSchema,\n} from './primitives';\n\nexport const SettingsSchema = z.object({\n accessToken: z\n .string()\n .min(1)\n .describe(\n 'OAuth 2.0 access token with datamanager scope (like ya29.c.xxx)',\n ),\n destinations: z\n .array(DestinationSchema)\n .min(1)\n .max(10)\n .describe(\n 'Array of destination accounts and conversion actions/user lists (max 10)',\n ),\n eventSource: EventSourceSchema.describe(\n 'Default event source if not specified per event (like WEB)',\n ).optional(),\n batchSize: z\n .number()\n .int()\n .min(1)\n .max(2000)\n .describe(\n 'Maximum number of events to batch before sending (max 2000, like 100)',\n )\n .optional(),\n batchInterval: z\n .number()\n .int()\n .min(0)\n .describe(\n 'Time in milliseconds to wait before auto-flushing batch (like 5000)',\n )\n .optional(),\n validateOnly: z\n .boolean()\n .describe('If true, validate request without ingestion (testing mode)')\n .optional(),\n url: z\n .string()\n .url()\n .describe(\n 'Override API endpoint for testing (like https://datamanager.googleapis.com/v1)',\n )\n .optional(),\n consent: ConsentSchema.describe(\n 'Request-level consent for all events',\n ).optional(),\n testEventCode: z\n .string()\n .describe('Test event code for debugging (like TEST12345)')\n .optional(),\n logLevel: z\n .enum(['debug', 'info', 'warn', 'error', 'none'])\n .describe('Log level for debugging (debug shows all API calls)')\n .optional(),\n userData: z\n .record(z.string(), z.unknown())\n .describe(\n \"Guided helper: User data mapping for all events (like { email: 'user.id', phone: 'data.phone' })\",\n )\n .optional(),\n userId: z\n .any()\n .describe(\n \"Guided helper: First-party user ID for all events (like 'user.id')\",\n )\n .optional(),\n clientId: z\n .any()\n .describe(\n \"Guided helper: GA4 client ID for all events (like 'user.device')\",\n )\n .optional(),\n sessionAttributes: z\n .any()\n .describe(\n \"Guided helper: Privacy-safe attribution for all events (like 'context.sessionAttributes')\",\n )\n .optional(),\n consentAdUserData: z\n .union([z.string(), z.boolean()])\n .describe(\n \"Consent mapping: Field name from event.consent (like 'marketing') or static boolean value\",\n )\n .optional(),\n consentAdPersonalization: z\n .union([z.string(), z.boolean()])\n .describe(\n \"Consent mapping: Field name from event.consent (like 'targeting') or static boolean value\",\n )\n .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n// Data Manager uses flexible mapping via walkerOS mapping system\n// No event-specific mapping schema needed (similar to Meta CAPI pattern)\nexport const MappingSchema = z.object({});\n\nexport type Mapping = z.infer<typeof MappingSchema>;\n","export * from './primitives';\nexport * from './settings';\nexport * from './mapping';\n\nimport { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\nimport { MappingSchema } from './mapping';\n\nimport type { JSONSchema } from '@walkeros/core/dev';\n\nexport const schemas: Record<string, JSONSchema> = {\n settings: zodToSchema(SettingsSchema),\n mapping: zodToSchema(MappingSchema),\n};\n","export * as auth from './auth';\nexport * as basic from './basic';\nexport * as mapping from './mapping';\n","import type { DestinationDataManager } from '..';\n\n/**\n * AWS Lambda / Serverless Configuration\n * Uses inline credentials from environment variables\n * Best for: AWS Lambda, Docker, Kubernetes, any serverless environment\n */\nexport const awsLambda: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: process.env.GOOGLE_CLIENT_EMAIL!,\n private_key: process.env.GOOGLE_PRIVATE_KEY!.replace(/\\\\n/g, '\\n'),\n },\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * GCP Cloud Functions / Cloud Run Configuration\n * Uses Application Default Credentials (ADC) - no explicit auth config needed\n * Best for: Google Cloud Functions, Cloud Run, GCE, GKE\n */\nexport const gcpCloudFunctions: DestinationDataManager.Config = {\n settings: {\n // No auth config needed - ADC works automatically on GCP!\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Local Development Configuration\n * Uses service account JSON file\n * Best for: Local development, testing\n */\nexport const localDevelopment: DestinationDataManager.Config = {\n settings: {\n keyFilename: './service-account.json',\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Docker / Kubernetes Configuration\n * Uses ADC via GOOGLE_APPLICATION_CREDENTIALS environment variable\n * Best for: Docker containers, Kubernetes pods\n *\n * Setup:\n * 1. Mount service account JSON as secret/configmap\n * 2. Set GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json\n * 3. ADC will automatically use it\n */\nexport const dockerKubernetes: DestinationDataManager.Config = {\n settings: {\n // No explicit config - ADC uses GOOGLE_APPLICATION_CREDENTIALS env var\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Custom Scopes Configuration\n * For specific use cases requiring different OAuth scopes\n */\nexport const customScopes: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: process.env.GOOGLE_CLIENT_EMAIL!,\n private_key: process.env.GOOGLE_PRIVATE_KEY!.replace(/\\\\n/g, '\\n'),\n },\n scopes: ['https://www.googleapis.com/auth/datamanager'],\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n","import type { DestinationDataManager } from '..';\n\n/**\n * Minimal configuration for Google Data Manager with inline credentials\n */\nexport const minimal: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: 'service-account@project.iam.gserviceaccount.com',\n private_key:\n '-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n',\n },\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n};\n\n/**\n * Complete configuration with all options\n */\nexport const complete: DestinationDataManager.Config = {\n settings: {\n credentials: {\n client_email: 'service-account@project.iam.gserviceaccount.com',\n private_key:\n '-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n',\n },\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n {\n operatingAccount: {\n accountId: '987654321',\n accountType: 'GOOGLE_ANALYTICS_PROPERTY',\n },\n productDestinationId: 'G-XXXXXXXXXX',\n },\n ],\n eventSource: 'WEB',\n batchSize: 100,\n batchInterval: 5000,\n validateOnly: false,\n consent: {\n adUserData: 'CONSENT_GRANTED',\n adPersonalization: 'CONSENT_GRANTED',\n },\n\n // Guided helpers (apply to all events)\n userData: {\n email: 'user.id',\n phone: 'data.phone',\n firstName: 'data.firstName',\n lastName: 'data.lastName',\n },\n userId: 'user.id',\n clientId: 'user.device',\n sessionAttributes: 'context.sessionAttributes',\n },\n data: {\n map: {\n eventSource: { value: 'WEB' },\n },\n },\n};\n\n/**\n * GA4-specific configuration using Application Default Credentials\n */\nexport const ga4: DestinationDataManager.Config = {\n settings: {\n destinations: [\n {\n operatingAccount: {\n accountId: '123456789',\n accountType: 'GOOGLE_ANALYTICS_PROPERTY',\n },\n productDestinationId: 'G-XXXXXXXXXX',\n },\n ],\n eventSource: 'WEB',\n },\n};\n\n/**\n * Debug configuration with logging enabled using keyFilename\n */\nexport const debug: DestinationDataManager.Config = {\n settings: {\n keyFilename: './service-account.json',\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n logLevel: 'debug', // Shows all API calls and responses\n },\n};\n","import type { DestinationDataManager } from '..';\nimport { isObject } from '@walkeros/core';\n\n/**\n * Purchase event mapping for Google Ads conversion\n */\nexport const Purchase: DestinationDataManager.Rule = {\n name: 'purchase',\n data: {\n map: {\n // Required fields\n transactionId: 'data.id',\n conversionValue: 'data.total',\n currency: { key: 'data.currency', value: 'USD' },\n eventName: { value: 'purchase' },\n\n // User identification\n userId: 'user.id',\n email: 'user.id', // Will be hashed automatically\n\n // Attribution identifiers (captured by browser source from URL)\n gclid: 'context.gclid', // Google Click ID\n gbraid: 'context.gbraid', // iOS attribution\n wbraid: 'context.wbraid', // Web-to-app\n\n // Shopping cart data\n cartData: {\n map: {\n items: {\n loop: [\n 'nested',\n {\n condition: (entity) =>\n isObject(entity) && entity.entity === 'product',\n map: {\n merchantProductId: 'data.id',\n price: 'data.price',\n quantity: { key: 'data.quantity', value: 1 },\n },\n },\n ],\n },\n },\n },\n },\n },\n};\n\n/**\n * Lead event mapping\n */\nexport const Lead: DestinationDataManager.Rule = {\n name: 'generate_lead',\n data: {\n map: {\n eventName: { value: 'generate_lead' },\n conversionValue: { value: 10 },\n currency: { value: 'USD' },\n },\n },\n};\n\n/**\n * Page view mapping for GA4\n */\nexport const PageView: DestinationDataManager.Rule = {\n name: 'page_view',\n data: {\n map: {\n eventName: { value: 'page_view' },\n },\n },\n};\n\n/**\n * Complete mapping configuration\n */\nexport const mapping = {\n order: {\n complete: Purchase,\n },\n lead: {\n submit: Lead,\n },\n page: {\n view: PageView,\n },\n} satisfies DestinationDataManager.Rules;\n\n/**\n * User data mapping configuration\n * Maps walkerOS user properties to Data Manager user identifiers\n */\nexport const userDataMapping: DestinationDataManager.Config = {\n settings: {\n keyFilename: './service-account.json',\n destinations: [\n {\n operatingAccount: {\n accountId: '123-456-7890',\n accountType: 'GOOGLE_ADS',\n },\n productDestinationId: 'AW-CONVERSION-123',\n },\n ],\n },\n data: {\n map: {\n email: 'user.id',\n phone: 'data.phone',\n firstName: 'data.firstName',\n lastName: 'data.lastName',\n regionCode: 'data.country',\n postalCode: 'data.zip',\n },\n },\n mapping,\n};\n"],"mappings":"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","names":["z","z","z"]}
@@ -1,11 +1,28 @@
1
1
  import { Mapping as Mapping$1, Destination as Destination$1 } from '@walkeros/core';
2
2
  import { DestinationServer } from '@walkeros/server-core';
3
+ import { OAuth2Client } from 'google-auth-library';
3
4
 
4
5
  type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
5
6
 
6
7
  interface Settings {
7
- /** OAuth 2.0 access token with datamanager scope */
8
- accessToken: string;
8
+ /**
9
+ * Service account credentials (client_email + private_key)
10
+ * Recommended for serverless environments (AWS Lambda, Docker, etc.)
11
+ */
12
+ credentials?: {
13
+ client_email: string;
14
+ private_key: string;
15
+ };
16
+ /**
17
+ * Path to service account JSON file
18
+ * For local development or environments with filesystem access
19
+ */
20
+ keyFilename?: string;
21
+ /**
22
+ * OAuth scopes for Data Manager API
23
+ * @default ['https://www.googleapis.com/auth/datamanager']
24
+ */
25
+ scopes?: string[];
9
26
  /** Array of destination accounts and conversion actions/user lists */
10
27
  destinations: Destination[];
11
28
  /** Default event source if not specified per event */
@@ -45,8 +62,10 @@ interface Mapping {
45
62
  }
46
63
  interface Env extends DestinationServer.Env {
47
64
  fetch?: typeof fetch;
65
+ authClient?: OAuth2Client | null;
48
66
  }
49
- type Types = Destination$1.Types<Settings, Mapping, Env>;
67
+ type InitSettings = Partial<Settings>;
68
+ type Types = Destination$1.Types<Settings, Mapping, Env, InitSettings>;
50
69
  type Config = {
51
70
  settings: Settings;
52
71
  } & DestinationServer.Config<Types>;
@@ -56,21 +75,27 @@ type Rule = Mapping$1.Rule<Mapping>;
56
75
  * https://developers.google.com/data-manager/api/reference/rest/v1/Destination
57
76
  */
58
77
  interface Destination {
59
- /** Operating account details */
60
- operatingAccount: OperatingAccount;
78
+ /** Reference identifier for this destination */
79
+ reference?: string;
80
+ /** Login account (account initiating the request) */
81
+ loginAccount?: ProductAccount;
82
+ /** Linked account (child account linked to login account) */
83
+ linkedAccount?: ProductAccount;
84
+ /** Operating account (account where data is sent) */
85
+ operatingAccount?: ProductAccount;
61
86
  /** Product-specific destination ID (conversion action or user list) */
62
- productDestinationId: string;
87
+ productDestinationId?: string;
63
88
  }
64
89
  /**
65
- * Operating account information
90
+ * Product account information
66
91
  */
67
- interface OperatingAccount {
92
+ interface ProductAccount {
68
93
  /** Account ID (e.g., "123-456-7890" for Google Ads) */
69
94
  accountId: string;
70
95
  /** Type of account */
71
96
  accountType: AccountType;
72
97
  }
73
- type AccountType = 'GOOGLE_ADS' | 'DISPLAY_VIDEO_ADVERTISER' | 'DISPLAY_VIDEO_PARTNER' | 'GOOGLE_ANALYTICS_PROPERTY';
98
+ type AccountType = 'ACCOUNT_TYPE_UNSPECIFIED' | 'GOOGLE_ADS' | 'DISPLAY_VIDEO_ADVERTISER' | 'DISPLAY_VIDEO_PARTNER' | 'GOOGLE_ANALYTICS_PROPERTY' | 'DATA_PARTNER';
74
99
  type EventSource = 'WEB' | 'APP' | 'IN_STORE' | 'PHONE' | 'OTHER';
75
100
  /**
76
101
  * Consent for Digital Markets Act (DMA) compliance
@@ -84,6 +109,75 @@ interface Consent {
84
109
  }
85
110
  type ConsentStatus = 'CONSENT_GRANTED' | 'CONSENT_DENIED';
86
111
 
112
+ /**
113
+ * AWS Lambda / Serverless Configuration
114
+ * Uses inline credentials from environment variables
115
+ * Best for: AWS Lambda, Docker, Kubernetes, any serverless environment
116
+ */
117
+ declare const awsLambda: Config;
118
+ /**
119
+ * GCP Cloud Functions / Cloud Run Configuration
120
+ * Uses Application Default Credentials (ADC) - no explicit auth config needed
121
+ * Best for: Google Cloud Functions, Cloud Run, GCE, GKE
122
+ */
123
+ declare const gcpCloudFunctions: Config;
124
+ /**
125
+ * Local Development Configuration
126
+ * Uses service account JSON file
127
+ * Best for: Local development, testing
128
+ */
129
+ declare const localDevelopment: Config;
130
+ /**
131
+ * Docker / Kubernetes Configuration
132
+ * Uses ADC via GOOGLE_APPLICATION_CREDENTIALS environment variable
133
+ * Best for: Docker containers, Kubernetes pods
134
+ *
135
+ * Setup:
136
+ * 1. Mount service account JSON as secret/configmap
137
+ * 2. Set GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
138
+ * 3. ADC will automatically use it
139
+ */
140
+ declare const dockerKubernetes: Config;
141
+ /**
142
+ * Custom Scopes Configuration
143
+ * For specific use cases requiring different OAuth scopes
144
+ */
145
+ declare const customScopes: Config;
146
+
147
+ declare const auth_awsLambda: typeof awsLambda;
148
+ declare const auth_customScopes: typeof customScopes;
149
+ declare const auth_dockerKubernetes: typeof dockerKubernetes;
150
+ declare const auth_gcpCloudFunctions: typeof gcpCloudFunctions;
151
+ declare const auth_localDevelopment: typeof localDevelopment;
152
+ declare namespace auth {
153
+ export { auth_awsLambda as awsLambda, auth_customScopes as customScopes, auth_dockerKubernetes as dockerKubernetes, auth_gcpCloudFunctions as gcpCloudFunctions, auth_localDevelopment as localDevelopment };
154
+ }
155
+
156
+ /**
157
+ * Minimal configuration for Google Data Manager with inline credentials
158
+ */
159
+ declare const minimal: Config;
160
+ /**
161
+ * Complete configuration with all options
162
+ */
163
+ declare const complete: Config;
164
+ /**
165
+ * GA4-specific configuration using Application Default Credentials
166
+ */
167
+ declare const ga4: Config;
168
+ /**
169
+ * Debug configuration with logging enabled using keyFilename
170
+ */
171
+ declare const debug: Config;
172
+
173
+ declare const basic_complete: typeof complete;
174
+ declare const basic_debug: typeof debug;
175
+ declare const basic_ga4: typeof ga4;
176
+ declare const basic_minimal: typeof minimal;
177
+ declare namespace basic {
178
+ export { basic_complete as complete, basic_debug as debug, basic_ga4 as ga4, basic_minimal as minimal };
179
+ }
180
+
87
181
  /**
88
182
  * Purchase event mapping for Google Ads conversion
89
183
  */
@@ -125,29 +219,4 @@ declare namespace mapping$1 {
125
219
  export { mapping$1_Lead as Lead, mapping$1_PageView as PageView, mapping$1_Purchase as Purchase, mapping$1_mapping as mapping, mapping$1_userDataMapping as userDataMapping };
126
220
  }
127
221
 
128
- /**
129
- * Minimal configuration for Google Data Manager
130
- */
131
- declare const minimal: Config;
132
- /**
133
- * Complete configuration with all options
134
- */
135
- declare const complete: Config;
136
- /**
137
- * GA4-specific configuration
138
- */
139
- declare const ga4: Config;
140
- /**
141
- * Debug configuration with logging enabled
142
- */
143
- declare const debug: Config;
144
-
145
- declare const basic_complete: typeof complete;
146
- declare const basic_debug: typeof debug;
147
- declare const basic_ga4: typeof ga4;
148
- declare const basic_minimal: typeof minimal;
149
- declare namespace basic {
150
- export { basic_complete as complete, basic_debug as debug, basic_ga4 as ga4, basic_minimal as minimal };
151
- }
152
-
153
- export { basic, mapping$1 as mapping };
222
+ export { auth, basic, mapping$1 as mapping };