@kubuild/renderer 0.10.2 → 0.12.0
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/action-runners/tracking.d.cts.map +1 -1
- package/dist/action-runners/tracking.d.ts.map +1 -1
- package/dist/index.cjs +69 -69
- package/dist/index.js +75 -75
- package/dist/renderer.d.cts.map +1 -1
- package/dist/renderer.d.ts.map +1 -1
- package/dist/tracking/tracking-manager.d.cts +49 -11
- package/dist/tracking/tracking-manager.d.cts.map +1 -1
- package/dist/tracking/tracking-manager.d.ts +49 -11
- package/dist/tracking/tracking-manager.d.ts.map +1 -1
- package/package.json +4 -4
package/dist/renderer.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"renderer.d.cts","sourceRoot":"","sources":["../src/renderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,IAAI,EAEL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EACL,aAAa,EAKb,UAAU,EACX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"renderer.d.cts","sourceRoot":"","sources":["../src/renderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,IAAI,EAEL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EACL,aAAa,EAKb,UAAU,EACX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAcrB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IAChE,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9G,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAChG;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IAChE,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9G,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAChG,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAuBD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,QAAoB,EACpB,IAAgB,EAChB,UAAuB,EACvB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAmB,GACpB,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAoNxC;AAgCD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAKrG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,cAAc,GAAG,SAAS,EACtC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAC1B,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GACpD,cAAc,CAGhB;AA6FD,eAAO,MAAM,eAAe,kDAAuC,CAAC"}
|
package/dist/renderer.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,IAAI,EAEL,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EACL,aAAa,EAKb,UAAU,EACX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.tsx"],"names":[],"mappings":"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"}
|
|
@@ -1,25 +1,39 @@
|
|
|
1
|
-
import type { TrackingConfig } from '@kubuild/schema';
|
|
1
|
+
import type { TrackingConfig, TrackingPixelInput } from '@kubuild/schema';
|
|
2
|
+
import { type ResolvedTrackingConfig } from '@kubuild/core';
|
|
3
|
+
interface TikTokApi {
|
|
4
|
+
track: (event: string, params?: Record<string, unknown>, options?: Record<string, unknown>) => void;
|
|
5
|
+
page: () => void;
|
|
6
|
+
[key: string]: unknown;
|
|
7
|
+
}
|
|
2
8
|
declare global {
|
|
3
9
|
interface Window {
|
|
4
10
|
fbq?: (...args: unknown[]) => void;
|
|
5
11
|
_fbq?: unknown;
|
|
6
12
|
gtag?: (...args: unknown[]) => void;
|
|
7
13
|
dataLayer?: unknown[];
|
|
8
|
-
ttq?: {
|
|
9
|
-
track: (event: string, params?: Record<string, unknown>, options?: Record<string, unknown>) => void;
|
|
10
|
-
page: () => void;
|
|
14
|
+
ttq?: TikTokApi & {
|
|
11
15
|
load: (pixelId: string) => void;
|
|
12
|
-
|
|
16
|
+
/** Per-pixel handle — targets one TikTok pixel when several are loaded. */
|
|
17
|
+
instance?: (pixelId: string) => TikTokApi;
|
|
13
18
|
};
|
|
14
19
|
}
|
|
15
20
|
}
|
|
21
|
+
/** Anything `resolveTrackingConfig` accepts: a 1.3.0 config, a legacy one, or an already resolved one. */
|
|
22
|
+
export type TrackingConfigInput = Partial<TrackingConfig> | ResolvedTrackingConfig;
|
|
23
|
+
export interface InjectTrackingOptions {
|
|
24
|
+
/** Host pixels merged in (subject to the config's `inherit` settings). */
|
|
25
|
+
inheritedPixels?: readonly TrackingPixelInput[];
|
|
26
|
+
}
|
|
16
27
|
/**
|
|
17
|
-
* Injects
|
|
18
|
-
*
|
|
28
|
+
* Injects the client-side scripts of every resolved pixel (Meta Pixel, GA4, GTM, TikTok) —
|
|
29
|
+
* several pixels per provider supported — and, with `autoPageView`, fires one PageView per
|
|
30
|
+
* newly initialised pixel (skipping pixels that list `PageView` in `disabledEvents`).
|
|
31
|
+
* Returns a cleanup that removes the injected scripts.
|
|
19
32
|
*/
|
|
20
|
-
export declare function injectTrackingScripts(config?:
|
|
33
|
+
export declare function injectTrackingScripts(config?: TrackingConfigInput, options?: InjectTrackingOptions): () => void;
|
|
21
34
|
/**
|
|
22
|
-
* Removes all injected tracking scripts from the document head.
|
|
35
|
+
* Removes all injected tracking scripts from the document head. Pixels are initialised again
|
|
36
|
+
* (with a fresh PageView) on the next injection.
|
|
23
37
|
*/
|
|
24
38
|
export declare function removeTrackingScripts(): void;
|
|
25
39
|
/**
|
|
@@ -29,12 +43,36 @@ export declare function removeTrackingScripts(): void;
|
|
|
29
43
|
export declare const META_STANDARD_EVENTS: Set<string>;
|
|
30
44
|
export interface FireBrowserPixelOptions {
|
|
31
45
|
eventId?: string;
|
|
32
|
-
config
|
|
46
|
+
/** Tracking config to target. Without it the event is broadcast to whatever pixels are loaded. */
|
|
47
|
+
config?: TrackingConfigInput;
|
|
48
|
+
/** Host pixels merged into `config` (subject to its `inherit` settings). */
|
|
49
|
+
inheritedPixels?: readonly TrackingPixelInput[];
|
|
33
50
|
provider?: 'all' | 'meta' | 'google' | 'gtm' | 'tiktok' | 'custom' | string;
|
|
51
|
+
/** Only these pixel entry ids (`TrackingPixel.id`). */
|
|
52
|
+
pixelIds?: readonly string[];
|
|
34
53
|
eventType?: 'standard' | 'custom';
|
|
35
54
|
}
|
|
36
55
|
/**
|
|
37
|
-
*
|
|
56
|
+
* Sends an event to the browser pixels of a tracking config — each targeted pixel on its own
|
|
57
|
+
* (Meta `trackSingle`, TikTok `ttq.instance(id)`, GA4 `send_to`), so several pixels of one
|
|
58
|
+
* provider each receive it exactly once. Pixels are filtered by `provider`, `pixelIds` and
|
|
59
|
+
* their `disabledEvents`. GTM gets one `dataLayer` push when any GTM pixel is targeted.
|
|
38
60
|
*/
|
|
39
61
|
export declare function fireBrowserPixel(eventName: string, params?: Record<string, unknown>, options?: FireBrowserPixelOptions): void;
|
|
62
|
+
/** Browser identifiers ad platforms use to match server-side events to a visitor. */
|
|
63
|
+
export interface BrowserTrackingIds {
|
|
64
|
+
fbp?: string;
|
|
65
|
+
fbc?: string;
|
|
66
|
+
ttp?: string;
|
|
67
|
+
ttclid?: string;
|
|
68
|
+
/** GA4 client id, taken from the `_ga` cookie. */
|
|
69
|
+
clientId?: string;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Reads the `_fbp`, `_fbc` and `_ttp` cookies, `ttclid` from the URL and the GA4 client id
|
|
73
|
+
* from `_ga`. Without an `_fbc` cookie, `fbc` is built from an `fbclid` query param.
|
|
74
|
+
* Returns only the ids present, and `{}` outside a browser.
|
|
75
|
+
*/
|
|
76
|
+
export declare function collectBrowserTrackingIds(): BrowserTrackingIds;
|
|
77
|
+
export {};
|
|
40
78
|
//# sourceMappingURL=tracking-manager.d.cts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tracking-manager.d.cts","sourceRoot":"","sources":["../../src/tracking/tracking-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"tracking-manager.d.cts","sourceRoot":"","sources":["../../src/tracking/tracking-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAA+C,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEzG,UAAU,SAAS;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpG,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACnC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACpC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;QACtB,GAAG,CAAC,EAAE,SAAS,GAAG;YAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;YAChC,2EAA2E;YAC3E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC;SAC3C,CAAC;KACH;CACF;AAID,0GAA0G;AAC1G,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,sBAAsB,CAAC;AAEnF,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD;AAuID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,IAAI,CAyBnH;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aAmB/B,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kGAAkG;IAClG,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,4EAA4E;IAC5E,eAAe,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5E,uDAAuD;IACvD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACnC;AA+BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,uBAA4B,GACpC,IAAI,CAgEN;AAED,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkBD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,kBAAkB,CA6B9D"}
|
|
@@ -1,25 +1,39 @@
|
|
|
1
|
-
import type { TrackingConfig } from '@kubuild/schema';
|
|
1
|
+
import type { TrackingConfig, TrackingPixelInput } from '@kubuild/schema';
|
|
2
|
+
import { type ResolvedTrackingConfig } from '@kubuild/core';
|
|
3
|
+
interface TikTokApi {
|
|
4
|
+
track: (event: string, params?: Record<string, unknown>, options?: Record<string, unknown>) => void;
|
|
5
|
+
page: () => void;
|
|
6
|
+
[key: string]: unknown;
|
|
7
|
+
}
|
|
2
8
|
declare global {
|
|
3
9
|
interface Window {
|
|
4
10
|
fbq?: (...args: unknown[]) => void;
|
|
5
11
|
_fbq?: unknown;
|
|
6
12
|
gtag?: (...args: unknown[]) => void;
|
|
7
13
|
dataLayer?: unknown[];
|
|
8
|
-
ttq?: {
|
|
9
|
-
track: (event: string, params?: Record<string, unknown>, options?: Record<string, unknown>) => void;
|
|
10
|
-
page: () => void;
|
|
14
|
+
ttq?: TikTokApi & {
|
|
11
15
|
load: (pixelId: string) => void;
|
|
12
|
-
|
|
16
|
+
/** Per-pixel handle — targets one TikTok pixel when several are loaded. */
|
|
17
|
+
instance?: (pixelId: string) => TikTokApi;
|
|
13
18
|
};
|
|
14
19
|
}
|
|
15
20
|
}
|
|
21
|
+
/** Anything `resolveTrackingConfig` accepts: a 1.3.0 config, a legacy one, or an already resolved one. */
|
|
22
|
+
export type TrackingConfigInput = Partial<TrackingConfig> | ResolvedTrackingConfig;
|
|
23
|
+
export interface InjectTrackingOptions {
|
|
24
|
+
/** Host pixels merged in (subject to the config's `inherit` settings). */
|
|
25
|
+
inheritedPixels?: readonly TrackingPixelInput[];
|
|
26
|
+
}
|
|
16
27
|
/**
|
|
17
|
-
* Injects
|
|
18
|
-
*
|
|
28
|
+
* Injects the client-side scripts of every resolved pixel (Meta Pixel, GA4, GTM, TikTok) —
|
|
29
|
+
* several pixels per provider supported — and, with `autoPageView`, fires one PageView per
|
|
30
|
+
* newly initialised pixel (skipping pixels that list `PageView` in `disabledEvents`).
|
|
31
|
+
* Returns a cleanup that removes the injected scripts.
|
|
19
32
|
*/
|
|
20
|
-
export declare function injectTrackingScripts(config?:
|
|
33
|
+
export declare function injectTrackingScripts(config?: TrackingConfigInput, options?: InjectTrackingOptions): () => void;
|
|
21
34
|
/**
|
|
22
|
-
* Removes all injected tracking scripts from the document head.
|
|
35
|
+
* Removes all injected tracking scripts from the document head. Pixels are initialised again
|
|
36
|
+
* (with a fresh PageView) on the next injection.
|
|
23
37
|
*/
|
|
24
38
|
export declare function removeTrackingScripts(): void;
|
|
25
39
|
/**
|
|
@@ -29,12 +43,36 @@ export declare function removeTrackingScripts(): void;
|
|
|
29
43
|
export declare const META_STANDARD_EVENTS: Set<string>;
|
|
30
44
|
export interface FireBrowserPixelOptions {
|
|
31
45
|
eventId?: string;
|
|
32
|
-
config
|
|
46
|
+
/** Tracking config to target. Without it the event is broadcast to whatever pixels are loaded. */
|
|
47
|
+
config?: TrackingConfigInput;
|
|
48
|
+
/** Host pixels merged into `config` (subject to its `inherit` settings). */
|
|
49
|
+
inheritedPixels?: readonly TrackingPixelInput[];
|
|
33
50
|
provider?: 'all' | 'meta' | 'google' | 'gtm' | 'tiktok' | 'custom' | string;
|
|
51
|
+
/** Only these pixel entry ids (`TrackingPixel.id`). */
|
|
52
|
+
pixelIds?: readonly string[];
|
|
34
53
|
eventType?: 'standard' | 'custom';
|
|
35
54
|
}
|
|
36
55
|
/**
|
|
37
|
-
*
|
|
56
|
+
* Sends an event to the browser pixels of a tracking config — each targeted pixel on its own
|
|
57
|
+
* (Meta `trackSingle`, TikTok `ttq.instance(id)`, GA4 `send_to`), so several pixels of one
|
|
58
|
+
* provider each receive it exactly once. Pixels are filtered by `provider`, `pixelIds` and
|
|
59
|
+
* their `disabledEvents`. GTM gets one `dataLayer` push when any GTM pixel is targeted.
|
|
38
60
|
*/
|
|
39
61
|
export declare function fireBrowserPixel(eventName: string, params?: Record<string, unknown>, options?: FireBrowserPixelOptions): void;
|
|
62
|
+
/** Browser identifiers ad platforms use to match server-side events to a visitor. */
|
|
63
|
+
export interface BrowserTrackingIds {
|
|
64
|
+
fbp?: string;
|
|
65
|
+
fbc?: string;
|
|
66
|
+
ttp?: string;
|
|
67
|
+
ttclid?: string;
|
|
68
|
+
/** GA4 client id, taken from the `_ga` cookie. */
|
|
69
|
+
clientId?: string;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Reads the `_fbp`, `_fbc` and `_ttp` cookies, `ttclid` from the URL and the GA4 client id
|
|
73
|
+
* from `_ga`. Without an `_fbc` cookie, `fbc` is built from an `fbclid` query param.
|
|
74
|
+
* Returns only the ids present, and `{}` outside a browser.
|
|
75
|
+
*/
|
|
76
|
+
export declare function collectBrowserTrackingIds(): BrowserTrackingIds;
|
|
77
|
+
export {};
|
|
40
78
|
//# sourceMappingURL=tracking-manager.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tracking-manager.d.ts","sourceRoot":"","sources":["../../src/tracking/tracking-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"tracking-manager.d.ts","sourceRoot":"","sources":["../../src/tracking/tracking-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAA+C,KAAK,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEzG,UAAU,SAAS;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpG,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACnC,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QACpC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;QACtB,GAAG,CAAC,EAAE,SAAS,GAAG;YAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;YAChC,2EAA2E;YAC3E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC;SAC3C,CAAC;KACH;CACF;AAID,0GAA0G;AAC1G,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,sBAAsB,CAAC;AAEnF,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD;AAuID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,IAAI,CAyBnH;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aAmB/B,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kGAAkG;IAClG,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,4EAA4E;IAC5E,eAAe,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5E,uDAAuD;IACvD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;CACnC;AA+BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,uBAA4B,GACpC,IAAI,CAgEN;AAED,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAkBD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,kBAAkB,CA6B9D"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kubuild/renderer",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0",
|
|
4
4
|
"description": "Pure recursive React renderer for KUBUILD page documents",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.cjs",
|
|
@@ -46,9 +46,9 @@
|
|
|
46
46
|
"homepage": "https://github.com/kustora/kubuild#readme",
|
|
47
47
|
"dependencies": {
|
|
48
48
|
"lucide-react": "^1.33.0",
|
|
49
|
-
"@kubuild/components": "0.
|
|
50
|
-
"@kubuild/core": "0.
|
|
51
|
-
"@kubuild/schema": "0.
|
|
49
|
+
"@kubuild/components": "0.12.0",
|
|
50
|
+
"@kubuild/core": "0.12.0",
|
|
51
|
+
"@kubuild/schema": "0.12.0"
|
|
52
52
|
},
|
|
53
53
|
"peerDependencies": {
|
|
54
54
|
"react": ">=18.0.0",
|