@kubuild/core 0.5.0 → 0.6.0

package/dist/runtime/index.d.ts

@@ -4,4 +4,5 @@ export * from './interpolator';
 export * from './conditional-resolver';
 export * from './pipeline-executor';
 export * from './state-store';
+export * from './server-tracking';
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/dist/runtime/server-tracking.d.ts

@@ -0,0 +1,110 @@
+import type { TrackingConfig, MetaTrackingProviderConfig, GoogleTrackingProviderConfig, TikTokTrackingProviderConfig, CustomTrackingProviderConfig } from '@kubuild/schema';
+/**
+ * Normalized Server Tracking Event
+ */
+export interface ServerTrackingEvent {
+    eventName: string;
+    eventType?: 'standard' | 'custom';
+    eventId?: string;
+    eventTime?: number;
+    eventSourceUrl?: string;
+    actionSource?: 'website' | 'app' | 'system_generated';
+    params?: Record<string, unknown>;
+    userData?: {
+        email?: string;
+        phone?: string;
+        firstName?: string;
+        lastName?: string;
+        gender?: string;
+        dateOfBirth?: string;
+        city?: string;
+        state?: string;
+        zip?: string;
+        country?: string;
+        clientIp?: string;
+        clientUserAgent?: string;
+        fbp?: string;
+        fbc?: string;
+        externalId?: string;
+        [key: string]: unknown;
+    };
+    customData?: Record<string, unknown>;
+}
+/**
+ * Result of a single provider delivery
+ */
+export interface TrackingDeliveryResult {
+    provider: string;
+    success: boolean;
+    status?: number;
+    data?: unknown;
+    error?: string;
+    skipped?: boolean;
+}
+/**
+ * Aggregate result from dispatchServerTracking
+ */
+export interface ServerTrackingDispatchResult {
+    success: boolean;
+    eventId: string;
+    skipped?: boolean;
+    reason?: string;
+    results: Record<string, TrackingDeliveryResult>;
+}
+/**
+ * Options for configuring server tracking dispatch
+ */
+export interface ServerTrackingOptions {
+    fetchFn?: typeof fetch;
+    clientIp?: string;
+    clientUserAgent?: string;
+    sourceUrl?: string;
+    simulateInDebug?: boolean;
+    onLog?: (message: string, data?: unknown) => void;
+}
+/**
+ * Normalizes an email string (lowercase, trim) according to Meta CAPI specification.
+ */
+export declare function normalizeEmail(email: string): string;
+/**
+ * Normalizes a phone number (removes non-digits, strips leading zeros if needed) per CAPI spec.
+ */
+export declare function normalizePhone(phone: string): string;
+/**
+ * Normalizes text names (trim, lowercase).
+ */
+export declare function normalizeText(text: string): string;
+/**
+ * Generates a SHA-256 hash formatted as a hex string.
+ * Uses universal Web Crypto API (supported in Node 18+, Bun, Deno, and modern browsers).
+ */
+export declare function hashSha256(value: string): Promise<string>;
+/**
+ * Generates a unique deduplication event ID.
+ */
+export declare function generateTrackingEventId(prefix?: string): string;
+/**
+ * Dispatches an event to Meta Conversions API (CAPI).
+ * Spec: https://developers.facebook.com/docs/marketing-api/conversions-api
+ */
+export declare function sendMetaCapiEvent(event: ServerTrackingEvent, config: MetaTrackingProviderConfig, options?: ServerTrackingOptions): Promise<TrackingDeliveryResult>;
+/**
+ * Dispatches an event to TikTok Events API.
+ * Spec: https://business-api.tiktok.com/portal/docs
+ */
+export declare function sendTikTokEventsApi(event: ServerTrackingEvent, config: TikTokTrackingProviderConfig, options?: ServerTrackingOptions): Promise<TrackingDeliveryResult>;
+/**
+ * Dispatches an event to Google Analytics 4 Measurement Protocol.
+ * Spec: https://developers.google.com/analytics/devguides/collection/protocol/ga4
+ */
+export declare function sendGa4MeasurementEvent(event: ServerTrackingEvent, config: GoogleTrackingProviderConfig, options?: ServerTrackingOptions): Promise<TrackingDeliveryResult>;
+/**
+ * Dispatches an event to a Custom Webhook.
+ */
+export declare function sendCustomWebhookEvent(event: ServerTrackingEvent, config: CustomTrackingProviderConfig, options?: ServerTrackingOptions): Promise<TrackingDeliveryResult>;
+/**
+ * High-Level Server Tracking Dispatcher
+ * Evaluates dynamic enabled state, filters enabled providers, and dispatches events.
+ */
+export declare function dispatchServerTracking(event: ServerTrackingEvent, config?: TrackingConfig, options?: ServerTrackingOptions): Promise<ServerTrackingDispatchResult>;
+//# sourceMappingURL=server-tracking.d.ts.map

package/dist/runtime/server-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tracking.d.ts","sourceRoot":"","sources":["../../src/runtime/server-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,kBAAkB,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,SAAQ,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAwHjC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAqFjC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAyDjC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,4BAA4B,EACpC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CA6CjC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,4BAA4B,CAAC,CAkGvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubuild/core",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Framework-agnostic engine for KUBUILD: document utilities, command engine, history, migration, and validation",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -41,7 +41,7 @@
   "homepage": "https://github.com/kustora/kubuild#readme",
   "dependencies": {
     "fflate": "^0.8.3",
-    "@kubuild/schema": "0.5.0"
+    "@kubuild/schema": "0.6.0"
   },
   "devDependencies": {
     "tsup": "^8.3.6",