@codefast/tracking 0.6.2 → 0.7.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/CHANGELOG.md +10 -0
- package/README.md +1 -1
- package/dist/adapters/tanstack-start.d.ts +11 -7
- package/dist/adapters/tanstack-start.d.ts.map +1 -1
- package/dist/adapters/tanstack-start.js +4 -4
- package/dist/adapters/tanstack-start.js.map +1 -1
- package/dist/client/ad-framework-consent.d.ts +8 -6
- package/dist/client/ad-framework-consent.d.ts.map +1 -1
- package/dist/client/ad-framework-consent.js +3 -3
- package/dist/client/ad-framework-consent.js.map +1 -1
- package/dist/client/browser-cookie.d.ts +1 -1
- package/dist/client/browser-cookie.js +1 -1
- package/dist/client/consent-runtime.d.ts +5 -3
- package/dist/client/consent-runtime.d.ts.map +1 -1
- package/dist/client/consent-runtime.js +1 -1
- package/dist/client/consent-runtime.js.map +1 -1
- package/dist/client/consent-withdrawal.d.ts +4 -2
- package/dist/client/consent-withdrawal.d.ts.map +1 -1
- package/dist/client/consent-withdrawal.js +1 -1
- package/dist/client/consent-withdrawal.js.map +1 -1
- package/dist/client/cookie-anonymous-id.d.ts +7 -3
- package/dist/client/cookie-anonymous-id.d.ts.map +1 -1
- package/dist/client/cookie-anonymous-id.js +1 -1
- package/dist/client/cookie-anonymous-id.js.map +1 -1
- package/dist/client/create-client-tracker.d.ts +7 -1
- package/dist/client/create-client-tracker.d.ts.map +1 -1
- package/dist/client/create-client-tracker.js +2 -0
- package/dist/client/create-client-tracker.js.map +1 -1
- package/dist/client/initial-consent-store.d.ts +6 -4
- package/dist/client/initial-consent-store.d.ts.map +1 -1
- package/dist/client/initial-consent-store.js +1 -1
- package/dist/client/initial-consent-store.js.map +1 -1
- package/dist/client/is-analytics-allowed.d.ts +4 -2
- package/dist/client/is-analytics-allowed.d.ts.map +1 -1
- package/dist/client/is-analytics-allowed.js +1 -1
- package/dist/client/is-analytics-allowed.js.map +1 -1
- package/dist/client/server-persisted-anonymous-id.d.ts +4 -2
- package/dist/client/server-persisted-anonymous-id.d.ts.map +1 -1
- package/dist/client/server-persisted-anonymous-id.js +1 -1
- package/dist/client/server-persisted-anonymous-id.js.map +1 -1
- package/dist/core/consent-config.d.ts +2 -2
- package/dist/core/consent-config.js +1 -1
- package/dist/core/consent-receipt.d.ts +6 -6
- package/dist/core/consent-receipt.js +1 -1
- package/dist/core/consent.d.ts +23 -11
- package/dist/core/consent.d.ts.map +1 -1
- package/dist/core/consent.js +12 -8
- package/dist/core/consent.js.map +1 -1
- package/dist/core/cookie.d.ts +2 -2
- package/dist/core/cookie.js +2 -2
- package/dist/core/event-catalog.d.ts +1 -1
- package/dist/core/event-catalog.js +1 -1
- package/dist/destinations/ad-consent.d.ts +2 -2
- package/dist/destinations/ad-consent.js +1 -1
- package/dist/destinations/google-analytics.d.ts +16 -8
- package/dist/destinations/google-analytics.d.ts.map +1 -1
- package/dist/destinations/google-analytics.js +4 -4
- package/dist/destinations/google-analytics.js.map +1 -1
- package/dist/destinations/google-consent.d.ts +9 -7
- package/dist/destinations/google-consent.d.ts.map +1 -1
- package/dist/destinations/google-consent.js +5 -5
- package/dist/destinations/google-consent.js.map +1 -1
- package/dist/destinations/meta.d.ts +7 -5
- package/dist/destinations/meta.d.ts.map +1 -1
- package/dist/destinations/meta.js +2 -2
- package/dist/destinations/meta.js.map +1 -1
- package/dist/destinations/microsoft-uet.d.ts +7 -5
- package/dist/destinations/microsoft-uet.d.ts.map +1 -1
- package/dist/destinations/microsoft-uet.js +2 -2
- package/dist/destinations/microsoft-uet.js.map +1 -1
- package/dist/destinations/shared.d.ts +7 -3
- package/dist/destinations/shared.d.ts.map +1 -1
- package/dist/destinations/shared.js +3 -1
- package/dist/destinations/shared.js.map +1 -1
- package/dist/destinations/tiktok.d.ts +7 -5
- package/dist/destinations/tiktok.d.ts.map +1 -1
- package/dist/destinations/tiktok.js +2 -2
- package/dist/destinations/tiktok.js.map +1 -1
- package/dist/destinations/vercel-analytics.d.ts +3 -1
- package/dist/destinations/vercel-analytics.d.ts.map +1 -1
- package/dist/destinations/vercel-analytics.js.map +1 -1
- package/dist/react/consent-banner.d.ts +28 -0
- package/dist/react/consent-banner.d.ts.map +1 -1
- package/dist/react/consent-banner.js +11 -7
- package/dist/react/consent-banner.js.map +1 -1
- package/dist/react/gtag-consent-bootstrap.d.ts +4 -2
- package/dist/react/gtag-consent-bootstrap.d.ts.map +1 -1
- package/dist/react/gtag-consent-bootstrap.js +1 -1
- package/dist/react/gtag-consent-bootstrap.js.map +1 -1
- package/dist/react/use-consent.d.ts +4 -0
- package/dist/react/use-consent.d.ts.map +1 -1
- package/dist/react/use-consent.js.map +1 -1
- package/dist/react/use-google-consent-sync.d.ts +4 -2
- package/dist/react/use-google-consent-sync.d.ts.map +1 -1
- package/dist/react/use-google-consent-sync.js +1 -1
- package/dist/react/use-google-consent-sync.js.map +1 -1
- package/dist/react/use-initial-consent.d.ts +1 -1
- package/dist/react/use-initial-consent.js +1 -1
- package/dist/server/anonymous-id-cookie.d.ts +7 -5
- package/dist/server/anonymous-id-cookie.d.ts.map +1 -1
- package/dist/server/anonymous-id-cookie.js +4 -4
- package/dist/server/anonymous-id-cookie.js.map +1 -1
- package/dist/server/consent-receipt-store.d.ts +4 -4
- package/dist/server/consent-receipt-store.js +2 -2
- package/dist/server/consent-receipt.d.ts +4 -4
- package/dist/server/consent-receipt.js +3 -3
- package/dist/server/initial-consent.d.ts +4 -2
- package/dist/server/initial-consent.d.ts.map +1 -1
- package/dist/server/initial-consent.js +1 -1
- package/dist/server/initial-consent.js.map +1 -1
- package/dist/server/measurement-protocol.d.ts +9 -7
- package/dist/server/measurement-protocol.d.ts.map +1 -1
- package/dist/server/measurement-protocol.js +3 -3
- package/dist/server/measurement-protocol.js.map +1 -1
- package/dist/server/region.d.ts +2 -2
- package/dist/server/region.js +2 -2
- package/dist/server/user-deletion.d.ts +9 -5
- package/dist/server/user-deletion.d.ts.map +1 -1
- package/dist/server/user-deletion.js +2 -2
- package/dist/server/user-deletion.js.map +1 -1
- package/dist/tooling/import-protection.d.ts +1 -1
- package/dist/tooling/import-protection.js +1 -1
- package/package.json +7 -7
- package/src/adapters/tanstack-start.ts +11 -7
- package/src/client/ad-framework-consent.ts +8 -6
- package/src/client/browser-cookie.ts +1 -1
- package/src/client/consent-runtime.ts +5 -3
- package/src/client/consent-withdrawal.ts +4 -2
- package/src/client/cookie-anonymous-id.ts +7 -3
- package/src/client/create-client-tracker.ts +7 -1
- package/src/client/initial-consent-store.ts +6 -4
- package/src/client/is-analytics-allowed.ts +4 -2
- package/src/client/server-persisted-anonymous-id.ts +4 -2
- package/src/core/consent-config.ts +2 -2
- package/src/core/consent-receipt.ts +6 -6
- package/src/core/consent.ts +23 -11
- package/src/core/cookie.ts +2 -2
- package/src/core/event-catalog.ts +1 -1
- package/src/destinations/ad-consent.ts +2 -2
- package/src/destinations/google-analytics.ts +16 -8
- package/src/destinations/google-consent.ts +9 -7
- package/src/destinations/meta.ts +7 -5
- package/src/destinations/microsoft-uet.ts +7 -5
- package/src/destinations/shared.ts +10 -4
- package/src/destinations/tiktok.ts +7 -5
- package/src/destinations/vercel-analytics.ts +3 -1
- package/src/react/consent-banner.tsx +34 -8
- package/src/react/gtag-consent-bootstrap.tsx +4 -2
- package/src/react/use-consent.ts +4 -0
- package/src/react/use-google-consent-sync.ts +4 -2
- package/src/react/use-initial-consent.ts +1 -1
- package/src/server/anonymous-id-cookie.ts +7 -5
- package/src/server/consent-receipt-store.ts +4 -4
- package/src/server/consent-receipt.ts +4 -4
- package/src/server/initial-consent.ts +4 -2
- package/src/server/measurement-protocol.ts +9 -7
- package/src/server/region.ts +2 -2
- package/src/server/user-deletion.ts +9 -5
- package/src/tooling/import-protection.ts +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server-persisted-anonymous-id.d.ts","sourceRoot":"","sources":["../../src/client/server-persisted-anonymous-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAItE
|
|
1
|
+
{"version":3,"file":"server-persisted-anonymous-id.d.ts","sourceRoot":"","sources":["../../src/client/server-persisted-anonymous-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAItE;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD,iGAAiG;IACjG,aAAa,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAClD,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,iBAAiB,CAqE9G"}
|
|
@@ -8,7 +8,7 @@ import { readCookieValue } from "#/core/cookie";
|
|
|
8
8
|
* its full max-age. Same optimistic `document.cookie` write first, so the current event
|
|
9
9
|
* never waits on the round-trip and a failed `persist` degrades to today's behavior.
|
|
10
10
|
*
|
|
11
|
-
* @since
|
|
11
|
+
* @since 0.5.0-canary.6
|
|
12
12
|
*/
|
|
13
13
|
export function createServerPersistedAnonymousId(options) {
|
|
14
14
|
const { clearOnServer, cookieName, maxAgeSeconds, persist } = options;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server-persisted-anonymous-id.js","sourceRoot":"","sources":["../../src/client/server-persisted-anonymous-id.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"server-persisted-anonymous-id.js","sourceRoot":"","sources":["../../src/client/server-persisted-anonymous-id.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAsBhD;;;;;;;;;GASG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAA0C;IACzF,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACtE,MAAM,KAAK,GAAG,uBAAuB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;IACrE,sFAAsF;IACtF,oFAAoF;IACpF,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAEhC,OAAO;QACL,KAAK;YACH,4EAA4E;YAC5E,2EAA2E;YAC3E,MAAM,iBAAiB,GACrB,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;YAE3F,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,uDAAuD;YACvD,mBAAmB,GAAG,KAAK,CAAC;YAE5B,IAAI,iBAAiB,EAAE,CAAC;gBACtB,KAAK,aAAa,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;oBAChC,sDAAsD;gBACxD,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO;YACL,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;QACzB,CAAC;QACD,WAAW;YACT,oFAAoF;YACpF,kEAAkE;YAClE,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC;gBACrF,mBAAmB,GAAG,KAAK,CAAC;YAC9B,CAAC;YAED,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAE/B,qFAAqF;YACrF,0EAA0E;YAC1E,IAAI,CAAC,mBAAmB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC5D,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC1B,6DAA6D;gBAC/D,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO;YACL,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACpC,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAE9D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,KAAK,CAAC,OAAO,EAAE,CAAC;YAEhB,oFAAoF;YACpF,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzB,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBAChC,oEAAoE;gBACtE,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -5,7 +5,7 @@ import type { ConsentCategory } from "#/core/consent";
|
|
|
5
5
|
* cross-surface "must match" contracts hold by construction instead of by hand-threading
|
|
6
6
|
* the same strings through every call site.
|
|
7
7
|
*
|
|
8
|
-
* @since
|
|
8
|
+
* @since 0.5.0-canary.6
|
|
9
9
|
*/
|
|
10
10
|
export interface ConsentConfig {
|
|
11
11
|
/** Bumping re-prompts every visitor — a stored decision under any other version is ignored. */
|
|
@@ -18,7 +18,7 @@ export interface ConsentConfig {
|
|
|
18
18
|
/**
|
|
19
19
|
* Identity helper for declaring the config with inference — `defineEventCatalog`'s consent twin.
|
|
20
20
|
*
|
|
21
|
-
* @since
|
|
21
|
+
* @since 0.5.0-canary.6
|
|
22
22
|
*/
|
|
23
23
|
export declare function defineConsentConfig<Config extends ConsentConfig>(config: Config): Config;
|
|
24
24
|
//# sourceMappingURL=consent-config.d.ts.map
|
|
@@ -3,28 +3,28 @@ import type { ConsentDecision } from "#/core/consent";
|
|
|
3
3
|
* Which consent event a receipt records. Receipts are append-only: an `update` or
|
|
4
4
|
* `withdraw` is a new receipt referencing the prior one, never a mutation.
|
|
5
5
|
*
|
|
6
|
-
* @since
|
|
6
|
+
* @since 0.5.0-canary.6
|
|
7
7
|
*/
|
|
8
8
|
export type ConsentReceiptEventType = "give" | "update" | "withdraw";
|
|
9
9
|
/**
|
|
10
10
|
* How the decision was expressed — the "how" dimension a demonstrable-consent record must
|
|
11
11
|
* capture (GDPR Art. 7(1); EDPB 05/2020 §5.1).
|
|
12
12
|
*
|
|
13
|
-
* @since
|
|
13
|
+
* @since 0.5.0-canary.6
|
|
14
14
|
*/
|
|
15
15
|
export type ConsentReceiptMethod = "banner-accept" | "banner-reject" | "granular" | "gpc-signal" | "withdrawal";
|
|
16
16
|
/**
|
|
17
17
|
* What kind of identifier links the receipt to a subject. A cookie-only visitor uses a
|
|
18
18
|
* pseudonymous `cookie` id — the receipt is still valid proof.
|
|
19
19
|
*
|
|
20
|
-
* @since
|
|
20
|
+
* @since 0.5.0-canary.6
|
|
21
21
|
*/
|
|
22
22
|
export type ConsentReceiptSubjectIdType = "cookie" | "email-hash" | "userId";
|
|
23
23
|
/**
|
|
24
24
|
* The caller-supplied fields of a consent receipt. Deliberately carries **no IP** — the
|
|
25
25
|
* server derives a coarsened one from the connection so a full IP never transits the body.
|
|
26
26
|
*
|
|
27
|
-
* @since
|
|
27
|
+
* @since 0.5.0-canary.6
|
|
28
28
|
*/
|
|
29
29
|
export interface ConsentReceiptInput {
|
|
30
30
|
decision: ConsentDecision;
|
|
@@ -49,7 +49,7 @@ export interface ConsentReceiptInput {
|
|
|
49
49
|
* The record is append-only; never mutate a stored receipt. `ipCoarse` is truncated at
|
|
50
50
|
* write time and MUST NOT be a full IP.
|
|
51
51
|
*
|
|
52
|
-
* @since
|
|
52
|
+
* @since 0.5.0-canary.6
|
|
53
53
|
*/
|
|
54
54
|
export interface ConsentReceipt extends ConsentReceiptInput {
|
|
55
55
|
/** Coarsened/pseudonymized IP, or absent — never a full address. */
|
|
@@ -65,7 +65,7 @@ export interface ConsentReceipt extends ConsentReceiptInput {
|
|
|
65
65
|
* Guards a receipt input received from an untrusted client. Rejects a body carrying an
|
|
66
66
|
* `ip`/`ipCoarse` field so a full address can never be persisted from caller input.
|
|
67
67
|
*
|
|
68
|
-
* @since
|
|
68
|
+
* @since 0.5.0-canary.6
|
|
69
69
|
*/
|
|
70
70
|
export declare function isConsentReceiptInput(value: unknown): value is ConsentReceiptInput;
|
|
71
71
|
//# sourceMappingURL=consent-receipt.d.ts.map
|
|
@@ -14,7 +14,7 @@ const RECEIPT_SUBJECT_ID_TYPES = new Set(["cookie", "email-hash", "userId"]);
|
|
|
14
14
|
* Guards a receipt input received from an untrusted client. Rejects a body carrying an
|
|
15
15
|
* `ip`/`ipCoarse` field so a full address can never be persisted from caller input.
|
|
16
16
|
*
|
|
17
|
-
* @since
|
|
17
|
+
* @since 0.5.0-canary.6
|
|
18
18
|
*/
|
|
19
19
|
export function isConsentReceiptInput(value) {
|
|
20
20
|
if (typeof value !== "object" || value === null) {
|
package/dist/core/consent.d.ts
CHANGED
|
@@ -1,18 +1,24 @@
|
|
|
1
1
|
/**
|
|
2
|
+
* The privacy-law region a visitor's consent defaults are resolved for.
|
|
3
|
+
*
|
|
2
4
|
* @since 0.5.0-canary.4
|
|
3
5
|
*/
|
|
4
6
|
export type ConsentRegion = "eu" | "other" | "us" | "vn";
|
|
5
7
|
/**
|
|
6
|
-
*
|
|
8
|
+
* Every consent region, in a stable order shared by guards and iteration.
|
|
9
|
+
*
|
|
10
|
+
* @since 0.5.0-canary.6
|
|
7
11
|
*/
|
|
8
12
|
export declare const CONSENT_REGIONS: ReadonlyArray<ConsentRegion>;
|
|
9
13
|
/**
|
|
10
14
|
* Guards a region read from untrusted storage (a cached `InitialConsent`, a cookie).
|
|
11
15
|
*
|
|
12
|
-
* @since
|
|
16
|
+
* @since 0.5.0-canary.6
|
|
13
17
|
*/
|
|
14
18
|
export declare function isConsentRegion(value: unknown): value is ConsentRegion;
|
|
15
19
|
/**
|
|
20
|
+
* Whether a region requires explicit opt-in before tracking or defaults to opt-out.
|
|
21
|
+
*
|
|
16
22
|
* @since 0.5.0-canary.4
|
|
17
23
|
*/
|
|
18
24
|
export type ConsentMode = "opt-in" | "opt-out";
|
|
@@ -33,6 +39,8 @@ export declare function resolveConsentMode(region: ConsentRegion): ConsentMode;
|
|
|
33
39
|
*/
|
|
34
40
|
export type ConsentCategory = "ads" | "analytics";
|
|
35
41
|
/**
|
|
42
|
+
* Every consent category, in a stable order shared by guards and iteration.
|
|
43
|
+
*
|
|
36
44
|
* @since 0.5.0-canary.4
|
|
37
45
|
*/
|
|
38
46
|
export declare const CONSENT_CATEGORIES: ReadonlyArray<ConsentCategory>;
|
|
@@ -60,17 +68,19 @@ export declare function isConsentDecision(value: unknown): value is ConsentDecis
|
|
|
60
68
|
* dropped, every category becomes an explicit boolean. The one normalization rule every
|
|
61
69
|
* reader of stored consent shares (e.g. `readStoredDecision`).
|
|
62
70
|
*
|
|
63
|
-
* @since
|
|
71
|
+
* @since 0.5.0-canary.6
|
|
64
72
|
*/
|
|
65
73
|
export declare function normalizeConsentDecision(decision: ConsentDecision): ConsentDecision;
|
|
66
74
|
/**
|
|
67
75
|
* Guards a persisted consent record read from untrusted storage (e.g. `localStorage`).
|
|
68
76
|
*
|
|
69
|
-
* @since
|
|
77
|
+
* @since 0.5.0-canary.6
|
|
70
78
|
*/
|
|
71
79
|
export declare function isConsentRecord(value: unknown): value is ConsentRecord;
|
|
72
80
|
/**
|
|
73
|
-
*
|
|
81
|
+
* Options for `resolveDefaultConsent`.
|
|
82
|
+
*
|
|
83
|
+
* @since 0.5.0-canary.6
|
|
74
84
|
*/
|
|
75
85
|
export interface ResolveDefaultConsentOptions {
|
|
76
86
|
/** A "do not sell or share" opt-out — forces `ads` denied under opt-out regions. */
|
|
@@ -98,7 +108,7 @@ export declare function resolveDefaultConsent(options: ResolveDefaultConsentOpti
|
|
|
98
108
|
* `defaultConsent` is the server snapshot — useful when you need request-time `sec-gpc`
|
|
99
109
|
* as-is; analytics-only apps can ignore it because GPC only forces `ads` denied.
|
|
100
110
|
*
|
|
101
|
-
* @since
|
|
111
|
+
* @since 0.5.0-canary.6
|
|
102
112
|
*/
|
|
103
113
|
export interface InitialConsent {
|
|
104
114
|
defaultConsent: ConsentDecision;
|
|
@@ -111,7 +121,7 @@ export interface InitialConsent {
|
|
|
111
121
|
* Prerendered/CDN-cached markup must carry nothing region-specific, and a missing geo
|
|
112
122
|
* header means "unknown visitor", never "known non-EU visitor".
|
|
113
123
|
*
|
|
114
|
-
* @since
|
|
124
|
+
* @since 0.5.0-canary.6
|
|
115
125
|
*/
|
|
116
126
|
export declare const STRICTEST_INITIAL_CONSENT: InitialConsent;
|
|
117
127
|
/**
|
|
@@ -120,7 +130,7 @@ export declare const STRICTEST_INITIAL_CONSENT: InitialConsent;
|
|
|
120
130
|
* {@link STRICTEST_INITIAL_CONSENT}'s own pairing — stricter than the region's usual
|
|
121
131
|
* mode, never looser.
|
|
122
132
|
*
|
|
123
|
-
* @since
|
|
133
|
+
* @since 0.5.0-canary.6
|
|
124
134
|
*/
|
|
125
135
|
export declare function isInitialConsent(value: unknown): value is InitialConsent;
|
|
126
136
|
/**
|
|
@@ -156,11 +166,13 @@ export interface ConsentStorage {
|
|
|
156
166
|
* any tampered extra keys — `undefined` if there is none yet, the record is malformed, or
|
|
157
167
|
* it was recorded under a superseded policy version.
|
|
158
168
|
*
|
|
159
|
-
* @since
|
|
169
|
+
* @since 0.5.0-canary.6
|
|
160
170
|
*/
|
|
161
171
|
export declare function readStoredDecision(storage: ConsentStorage, policyVersion: string): ConsentDecision | undefined;
|
|
162
172
|
/**
|
|
163
|
-
*
|
|
173
|
+
* Options for `resolveEffectiveConsent`.
|
|
174
|
+
*
|
|
175
|
+
* @since 0.5.0-canary.6
|
|
164
176
|
*/
|
|
165
177
|
export interface ResolveEffectiveConsentOptions {
|
|
166
178
|
/** A "do not sell or share" opt-out — forces `ads` denied under opt-out regions. */
|
|
@@ -176,7 +188,7 @@ export interface ResolveEffectiveConsentOptions {
|
|
|
176
188
|
* non-React gate (e.g. a tracker's `isAnalyticsAllowed` option) doesn't have to reimplement
|
|
177
189
|
* "read storage, validate the policy version, fall back to `resolveDefaultConsent`" itself.
|
|
178
190
|
*
|
|
179
|
-
* @since
|
|
191
|
+
* @since 0.5.0-canary.6
|
|
180
192
|
*/
|
|
181
193
|
export declare function resolveEffectiveConsent(options: ResolveEffectiveConsentOptions): ConsentDecision;
|
|
182
194
|
//# sourceMappingURL=consent.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/core/consent.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/core/consent.ts"],"names":[],"mappings":"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"}
|
package/dist/core/consent.js
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* Every consent region, in a stable order shared by guards and iteration.
|
|
3
|
+
*
|
|
4
|
+
* @since 0.5.0-canary.6
|
|
3
5
|
*/
|
|
4
6
|
export const CONSENT_REGIONS = ["eu", "other", "us", "vn"];
|
|
5
7
|
/**
|
|
6
8
|
* Guards a region read from untrusted storage (a cached `InitialConsent`, a cookie).
|
|
7
9
|
*
|
|
8
|
-
* @since
|
|
10
|
+
* @since 0.5.0-canary.6
|
|
9
11
|
*/
|
|
10
12
|
export function isConsentRegion(value) {
|
|
11
13
|
return CONSENT_REGIONS.includes(value);
|
|
@@ -30,6 +32,8 @@ export function resolveConsentMode(region) {
|
|
|
30
32
|
}
|
|
31
33
|
}
|
|
32
34
|
/**
|
|
35
|
+
* Every consent category, in a stable order shared by guards and iteration.
|
|
36
|
+
*
|
|
33
37
|
* @since 0.5.0-canary.4
|
|
34
38
|
*/
|
|
35
39
|
export const CONSENT_CATEGORIES = ["ads", "analytics"];
|
|
@@ -57,7 +61,7 @@ export function isConsentDecision(value) {
|
|
|
57
61
|
* dropped, every category becomes an explicit boolean. The one normalization rule every
|
|
58
62
|
* reader of stored consent shares (e.g. `readStoredDecision`).
|
|
59
63
|
*
|
|
60
|
-
* @since
|
|
64
|
+
* @since 0.5.0-canary.6
|
|
61
65
|
*/
|
|
62
66
|
export function normalizeConsentDecision(decision) {
|
|
63
67
|
return createConsentDecision(CONSENT_CATEGORIES.filter((category) => decision[category]));
|
|
@@ -65,7 +69,7 @@ export function normalizeConsentDecision(decision) {
|
|
|
65
69
|
/**
|
|
66
70
|
* Guards a persisted consent record read from untrusted storage (e.g. `localStorage`).
|
|
67
71
|
*
|
|
68
|
-
* @since
|
|
72
|
+
* @since 0.5.0-canary.6
|
|
69
73
|
*/
|
|
70
74
|
export function isConsentRecord(value) {
|
|
71
75
|
return (isPlainObject(value) &&
|
|
@@ -100,7 +104,7 @@ export function resolveDefaultConsent(options) {
|
|
|
100
104
|
* Prerendered/CDN-cached markup must carry nothing region-specific, and a missing geo
|
|
101
105
|
* header means "unknown visitor", never "known non-EU visitor".
|
|
102
106
|
*
|
|
103
|
-
* @since
|
|
107
|
+
* @since 0.5.0-canary.6
|
|
104
108
|
*/
|
|
105
109
|
export const STRICTEST_INITIAL_CONSENT = Object.freeze({
|
|
106
110
|
defaultConsent: Object.freeze(createConsentDecision([])),
|
|
@@ -113,7 +117,7 @@ export const STRICTEST_INITIAL_CONSENT = Object.freeze({
|
|
|
113
117
|
* {@link STRICTEST_INITIAL_CONSENT}'s own pairing — stricter than the region's usual
|
|
114
118
|
* mode, never looser.
|
|
115
119
|
*
|
|
116
|
-
* @since
|
|
120
|
+
* @since 0.5.0-canary.6
|
|
117
121
|
*/
|
|
118
122
|
export function isInitialConsent(value) {
|
|
119
123
|
if (!isPlainObject(value)) {
|
|
@@ -134,7 +138,7 @@ export function isInitialConsent(value) {
|
|
|
134
138
|
* any tampered extra keys — `undefined` if there is none yet, the record is malformed, or
|
|
135
139
|
* it was recorded under a superseded policy version.
|
|
136
140
|
*
|
|
137
|
-
* @since
|
|
141
|
+
* @since 0.5.0-canary.6
|
|
138
142
|
*/
|
|
139
143
|
export function readStoredDecision(storage, policyVersion) {
|
|
140
144
|
const record = storage.load();
|
|
@@ -149,7 +153,7 @@ export function readStoredDecision(storage, policyVersion) {
|
|
|
149
153
|
* non-React gate (e.g. a tracker's `isAnalyticsAllowed` option) doesn't have to reimplement
|
|
150
154
|
* "read storage, validate the policy version, fall back to `resolveDefaultConsent`" itself.
|
|
151
155
|
*
|
|
152
|
-
* @since
|
|
156
|
+
* @since 0.5.0-canary.6
|
|
153
157
|
*/
|
|
154
158
|
export function resolveEffectiveConsent(options) {
|
|
155
159
|
const { hasGlobalPrivacyControlSignal, mode, policyVersion, requestedCategories, storage } = options;
|
package/dist/core/consent.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/core/consent.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/core/consent.ts"],"names":[],"mappings":"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"}
|
package/dist/core/cookie.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Default lifetime shared by the anonymous-id and consent cookies — one year.
|
|
3
3
|
*
|
|
4
|
-
* @since
|
|
4
|
+
* @since 0.5.0-canary.6
|
|
5
5
|
*/
|
|
6
6
|
export declare const ONE_YEAR_IN_SECONDS: number;
|
|
7
7
|
/**
|
|
@@ -9,7 +9,7 @@ export declare const ONE_YEAR_IN_SECONDS: number;
|
|
|
9
9
|
* `document.cookie`, which share the `name=value; name2=value2` wire format — or
|
|
10
10
|
* `undefined` when absent. The name must match exactly; a longer prefix sibling is ignored.
|
|
11
11
|
*
|
|
12
|
-
* @since
|
|
12
|
+
* @since 0.5.0-canary.6
|
|
13
13
|
*/
|
|
14
14
|
export declare function readCookieValue(cookieString: string | null | undefined, cookieName: string): string | undefined;
|
|
15
15
|
//# sourceMappingURL=cookie.d.ts.map
|
package/dist/core/cookie.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Default lifetime shared by the anonymous-id and consent cookies — one year.
|
|
3
3
|
*
|
|
4
|
-
* @since
|
|
4
|
+
* @since 0.5.0-canary.6
|
|
5
5
|
*/
|
|
6
6
|
export const ONE_YEAR_IN_SECONDS = 60 * 60 * 24 * 365;
|
|
7
7
|
/**
|
|
@@ -9,7 +9,7 @@ export const ONE_YEAR_IN_SECONDS = 60 * 60 * 24 * 365;
|
|
|
9
9
|
* `document.cookie`, which share the `name=value; name2=value2` wire format — or
|
|
10
10
|
* `undefined` when absent. The name must match exactly; a longer prefix sibling is ignored.
|
|
11
11
|
*
|
|
12
|
-
* @since
|
|
12
|
+
* @since 0.5.0-canary.6
|
|
13
13
|
*/
|
|
14
14
|
export function readCookieValue(cookieString, cookieName) {
|
|
15
15
|
if (!cookieString) {
|
|
@@ -29,7 +29,7 @@ export declare function defineEventCatalog<Catalog extends EventCatalog>(catalog
|
|
|
29
29
|
* @throws Error when validation reports issues, or when the schema validates asynchronously —
|
|
30
30
|
* tracking sits on synchronous call paths, so async schemas are unsupported by design.
|
|
31
31
|
*
|
|
32
|
-
* @since
|
|
32
|
+
* @since 0.5.0-canary.6
|
|
33
33
|
*/
|
|
34
34
|
export declare function assertValidEventProperties(schema: StandardSchemaV1, eventName: string, properties: unknown): unknown;
|
|
35
35
|
//# sourceMappingURL=event-catalog.d.ts.map
|
|
@@ -14,7 +14,7 @@ export function defineEventCatalog(catalog) {
|
|
|
14
14
|
* @throws Error when validation reports issues, or when the schema validates asynchronously —
|
|
15
15
|
* tracking sits on synchronous call paths, so async schemas are unsupported by design.
|
|
16
16
|
*
|
|
17
|
-
* @since
|
|
17
|
+
* @since 0.5.0-canary.6
|
|
18
18
|
*/
|
|
19
19
|
export function assertValidEventProperties(schema, eventName, properties) {
|
|
20
20
|
const result = schema["~standard"].validate(properties);
|
|
@@ -6,7 +6,7 @@ import type { ConsentDecision } from "#/core/consent";
|
|
|
6
6
|
* restricts to LDU but MUST NOT withhold first-party `analytics` (spec-consent §3). Every
|
|
7
7
|
* ad destination consumes this same shape so per-vendor mappings cannot drift.
|
|
8
8
|
*
|
|
9
|
-
* @since
|
|
9
|
+
* @since 0.5.0-canary.6
|
|
10
10
|
*/
|
|
11
11
|
export interface AdConsentState {
|
|
12
12
|
/** `ads` denied → the platform must restrict to Limited Data Use (Meta/TikTok LDU, UET `ad_storage` denied). */
|
|
@@ -17,7 +17,7 @@ export interface AdConsentState {
|
|
|
17
17
|
/**
|
|
18
18
|
* Normalizes a package `ConsentDecision` to the vendor-agnostic {@link AdConsentState}.
|
|
19
19
|
*
|
|
20
|
-
* @since
|
|
20
|
+
* @since 0.5.0-canary.6
|
|
21
21
|
*/
|
|
22
22
|
export declare function toAdConsentState(decision: ConsentDecision): AdConsentState;
|
|
23
23
|
//# sourceMappingURL=ad-consent.d.ts.map
|
|
@@ -9,7 +9,7 @@ type GtagPropertyValue = FlatPropertyValue;
|
|
|
9
9
|
* two separate `declare global` augmentations with different signatures for the same
|
|
10
10
|
* property is a TS error, not a merge.
|
|
11
11
|
*
|
|
12
|
-
* @since
|
|
12
|
+
* @since 0.5.0-canary.6
|
|
13
13
|
*/
|
|
14
14
|
export type GtagFunction = {
|
|
15
15
|
(command: "config", targetId: string, params?: Record<string, GtagPropertyValue>): void;
|
|
@@ -26,7 +26,9 @@ declare global {
|
|
|
26
26
|
}
|
|
27
27
|
}
|
|
28
28
|
/**
|
|
29
|
-
*
|
|
29
|
+
* Options for `ensureGtag`.
|
|
30
|
+
*
|
|
31
|
+
* @since 0.5.0-canary.6
|
|
30
32
|
*/
|
|
31
33
|
export interface EnsureGtagOptions {
|
|
32
34
|
/**
|
|
@@ -39,11 +41,13 @@ export interface EnsureGtagOptions {
|
|
|
39
41
|
* Ensures the standard gtag.js queueing stub exists so consent commands can be issued
|
|
40
42
|
* before the tag itself loads — gtag.js replays the queue in order once it boots.
|
|
41
43
|
*
|
|
42
|
-
* @since
|
|
44
|
+
* @since 0.5.0-canary.6
|
|
43
45
|
*/
|
|
44
46
|
export declare function ensureGtag(options?: EnsureGtagOptions): GtagFunction | undefined;
|
|
45
47
|
/**
|
|
46
|
-
*
|
|
48
|
+
* Options for `loadGtagScript`.
|
|
49
|
+
*
|
|
50
|
+
* @since 0.5.0-canary.6
|
|
47
51
|
*/
|
|
48
52
|
export interface LoadGtagScriptOptions {
|
|
49
53
|
/**
|
|
@@ -69,7 +73,7 @@ export interface LoadGtagScriptOptions {
|
|
|
69
73
|
* (advanced Consent Mode always injects the tag after the default); use this when the
|
|
70
74
|
* bootstrap did not run, or as an idempotent safety net after a runtime grant.
|
|
71
75
|
*
|
|
72
|
-
* @since
|
|
76
|
+
* @since 0.5.0-canary.6
|
|
73
77
|
*/
|
|
74
78
|
export declare function loadGtagScript(options: LoadGtagScriptOptions): void;
|
|
75
79
|
/**
|
|
@@ -77,7 +81,7 @@ export declare function loadGtagScript(options: LoadGtagScriptOptions): void;
|
|
|
77
81
|
* domain. Consent Mode stops using them once denied but never removes them — call from
|
|
78
82
|
* a consent-withdrawal handler so a revoke does not leave identifier cookies behind.
|
|
79
83
|
*
|
|
80
|
-
* @since
|
|
84
|
+
* @since 0.5.0-canary.6
|
|
81
85
|
*/
|
|
82
86
|
export declare function clearGoogleAnalyticsCookies(): void;
|
|
83
87
|
/**
|
|
@@ -89,7 +93,9 @@ export declare function clearGoogleAnalyticsCookies(): void;
|
|
|
89
93
|
*/
|
|
90
94
|
export declare function updateGoogleConsent(decision: ConsentDecision, options?: EnsureGtagOptions): void;
|
|
91
95
|
/**
|
|
92
|
-
*
|
|
96
|
+
* Options for `buildGtagConsentBootstrapScript`.
|
|
97
|
+
*
|
|
98
|
+
* @since 0.5.0-canary.6
|
|
93
99
|
*/
|
|
94
100
|
export interface GtagConsentBootstrapOptions {
|
|
95
101
|
/** The same object `useConsent` receives — the bootstrap reads its `storageKey` and `policyVersion`. */
|
|
@@ -125,10 +131,12 @@ export interface GtagConsentBootstrapOptions {
|
|
|
125
131
|
* so the already-loaded tag picks up the grant/deny — this only covers the page-load
|
|
126
132
|
* default + script injection.
|
|
127
133
|
*
|
|
128
|
-
* @since
|
|
134
|
+
* @since 0.5.0-canary.6
|
|
129
135
|
*/
|
|
130
136
|
export declare function buildGtagConsentBootstrapScript(options: GtagConsentBootstrapOptions): string;
|
|
131
137
|
/**
|
|
138
|
+
* Options for `createGoogleAnalyticsDestination`.
|
|
139
|
+
*
|
|
132
140
|
* @since 0.5.0-canary.4
|
|
133
141
|
*/
|
|
134
142
|
export interface GoogleAnalyticsDestinationOptions {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"google-analytics.d.ts","sourceRoot":"","sources":["../../src/destinations/google-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAQzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAK/D,KAAK,iBAAiB,GAAG,iBAAiB,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAC;IACxF,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtF,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAC;IACxF,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAClE,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACrD,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;KACrB;CACF;AAeD
|
|
1
|
+
{"version":3,"file":"google-analytics.d.ts","sourceRoot":"","sources":["../../src/destinations/google-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAQzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAK/D,KAAK,iBAAiB,GAAG,iBAAiB,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAC;IACxF,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtF,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAC;IACxF,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAC;IAClE,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACrD,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,EAAE,YAAY,CAAC;KACrB;CACF;AAeD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,YAAY,GAAG,SAAS,CAgBpF;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CA8BnE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAgBlD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI,CAEpG;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wGAAwG;IACxG,MAAM,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,cAAc,EAAE,eAAe,CAAC;IAChC,yFAAyF;IACzF,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CA+B5F;AAED;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,iCAAsC,GAAG,WAAW,CAmB7G"}
|
|
@@ -14,7 +14,7 @@ function gtagScriptSrc(gaMeasurementId, dataLayerName) {
|
|
|
14
14
|
* Ensures the standard gtag.js queueing stub exists so consent commands can be issued
|
|
15
15
|
* before the tag itself loads — gtag.js replays the queue in order once it boots.
|
|
16
16
|
*
|
|
17
|
-
* @since
|
|
17
|
+
* @since 0.5.0-canary.6
|
|
18
18
|
*/
|
|
19
19
|
export function ensureGtag(options = {}) {
|
|
20
20
|
if (typeof window === "undefined") {
|
|
@@ -37,7 +37,7 @@ export function ensureGtag(options = {}) {
|
|
|
37
37
|
* (advanced Consent Mode always injects the tag after the default); use this when the
|
|
38
38
|
* bootstrap did not run, or as an idempotent safety net after a runtime grant.
|
|
39
39
|
*
|
|
40
|
-
* @since
|
|
40
|
+
* @since 0.5.0-canary.6
|
|
41
41
|
*/
|
|
42
42
|
export function loadGtagScript(options) {
|
|
43
43
|
if (typeof document === "undefined" || document.querySelector(`script[src^="${GTAG_SCRIPT_BASE_URL}"]`) !== null) {
|
|
@@ -68,7 +68,7 @@ export function loadGtagScript(options) {
|
|
|
68
68
|
* domain. Consent Mode stops using them once denied but never removes them — call from
|
|
69
69
|
* a consent-withdrawal handler so a revoke does not leave identifier cookies behind.
|
|
70
70
|
*
|
|
71
|
-
* @since
|
|
71
|
+
* @since 0.5.0-canary.6
|
|
72
72
|
*/
|
|
73
73
|
export function clearGoogleAnalyticsCookies() {
|
|
74
74
|
if (typeof document === "undefined") {
|
|
@@ -103,7 +103,7 @@ export function updateGoogleConsent(decision, options = {}) {
|
|
|
103
103
|
* so the already-loaded tag picks up the grant/deny — this only covers the page-load
|
|
104
104
|
* default + script injection.
|
|
105
105
|
*
|
|
106
|
-
* @since
|
|
106
|
+
* @since 0.5.0-canary.6
|
|
107
107
|
*/
|
|
108
108
|
export function buildGtagConsentBootstrapScript(options) {
|
|
109
109
|
const { config, dataLayerName = DEFAULT_DATA_LAYER_NAME, defaultConsent, debugMode, gaMeasurementId, nonce, } = options;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"google-analytics.js","sourceRoot":"","sources":["../../src/destinations/google-analytics.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,mCAAmC,EACnC,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,oBAAoB,GAAG,0CAA0C,CAAC;AA2BxE,SAAS,aAAa,CAAC,eAAuB,EAAE,aAAqB;IACnE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAE1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAE5C,IAAI,aAAa,KAAK,uBAAuB,EAAE,CAAC;QAC9C,uFAAuF;QACvF,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;
|
|
1
|
+
{"version":3,"file":"google-analytics.js","sourceRoot":"","sources":["../../src/destinations/google-analytics.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,mCAAmC,EACnC,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,oBAAoB,GAAG,0CAA0C,CAAC;AA2BxE,SAAS,aAAa,CAAC,eAAuB,EAAE,aAAqB;IACnE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAE1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAE5C,IAAI,aAAa,KAAK,uBAAuB,EAAE,CAAC;QAC9C,uFAAuF;QACvF,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAeD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAO,GAAsB,EAAE;IACxD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;IAEvE,eAAe,CAAC,aAAa,CAAC,CAAC;IAE/B,sFAAsF;IACtF,yEAAyE;IACzE,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI;QAC3B,eAAe,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAiB,CAAC;IAElB,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAwBD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,aAAa,CAAC,gBAAgB,oBAAoB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACjH,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC;IACvE,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAEvB,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEhD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAEnE,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B;IACzC,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAElC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACtE,kFAAkF;YAClF,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,sBAAsB,CAAC;YAChD,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,iCAAiC,QAAQ,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAyB,EAAE,OAAO,GAAsB,EAAE;IAC5F,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9E,CAAC;AAiCD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAAC,OAAoC;IAClF,MAAM,EACJ,MAAM,EACN,aAAa,GAAG,uBAAuB,EACvC,cAAc,EACd,SAAS,EACT,eAAe,EACf,KAAK,GACN,GAAG,OAAO,CAAC;IAEZ,MAAM,aAAa,GAAG,aAAa,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IACpE,MAAM,UAAU,GACd,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACpH,MAAM,eAAe,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;IAClG,MAAM,QAAQ,GAAG,mCAAmC,CAAC;QACnD,iBAAiB,EAAE,MAAM,CAAC,UAAU;QACpC,aAAa;QACb,cAAc;QACd,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC,CAAC;IAEH,6FAA6F;IAC7F,OAAO,GAAG,QAAQ;;qBAEC,UAAU;;;uBAGR,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;MAC9C,eAAe;;GAElB,CAAC;AACJ,CAAC;AAWD;;;;;;;;GAQG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAAO,GAAsC,EAAE;IAC9F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,kBAAkB,CAAC;IAEhD,OAAO;QACL,IAAI;QACJ,qFAAqF;QACrF,oFAAoF;QACpF,KAAK,CAAC,IAAI,CAAC,KAAK;YACd,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACvE,OAAO;YACT,CAAC;YAED,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACxE,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -2,7 +2,7 @@ import type { ConsentDecision } from "#/core/consent";
|
|
|
2
2
|
/**
|
|
3
3
|
* gtag.js/gtm.js's default queue-array name — shared so the gtag and GTM helpers cannot disagree.
|
|
4
4
|
*
|
|
5
|
-
* @since
|
|
5
|
+
* @since 0.5.0-canary.6
|
|
6
6
|
*/
|
|
7
7
|
export declare const DEFAULT_DATA_LAYER_NAME = "dataLayer";
|
|
8
8
|
type GoogleConsentState = "denied" | "granted";
|
|
@@ -10,7 +10,7 @@ type GoogleConsentState = "denied" | "granted";
|
|
|
10
10
|
* Consent Mode v2 params issued via `gtag('consent', …)` — shared by the gtag and GTM
|
|
11
11
|
* bootstraps so signal mapping cannot drift between them.
|
|
12
12
|
*
|
|
13
|
-
* @since
|
|
13
|
+
* @since 0.5.0-canary.6
|
|
14
14
|
*/
|
|
15
15
|
export interface GoogleConsentParams {
|
|
16
16
|
ad_personalization: GoogleConsentState;
|
|
@@ -23,11 +23,13 @@ export interface GoogleConsentParams {
|
|
|
23
23
|
/**
|
|
24
24
|
* Maps a package `ConsentDecision` onto Consent Mode v2's four storage signals.
|
|
25
25
|
*
|
|
26
|
-
* @since
|
|
26
|
+
* @since 0.5.0-canary.6
|
|
27
27
|
*/
|
|
28
28
|
export declare function toGoogleConsentParams(decision: ConsentDecision): GoogleConsentParams;
|
|
29
29
|
/**
|
|
30
|
-
*
|
|
30
|
+
* Options for `buildGoogleConsentBootstrapPreamble`.
|
|
31
|
+
*
|
|
32
|
+
* @since 0.5.0-canary.6
|
|
31
33
|
*/
|
|
32
34
|
export interface GoogleConsentBootstrapPreambleOptions {
|
|
33
35
|
/** localStorage key holding the package's `ConsentRecord`. */
|
|
@@ -43,19 +45,19 @@ export interface GoogleConsentBootstrapPreambleOptions {
|
|
|
43
45
|
* "default" signal. The builders append only their tag-specific tail, so the consent
|
|
44
46
|
* logic cannot drift between them.
|
|
45
47
|
*
|
|
46
|
-
* @since
|
|
48
|
+
* @since 0.5.0-canary.6
|
|
47
49
|
*/
|
|
48
50
|
export declare function buildGoogleConsentBootstrapPreamble(options: GoogleConsentBootstrapPreambleOptions): string;
|
|
49
51
|
/**
|
|
50
52
|
* Reads or creates a named `window[dataLayerName]` queue array.
|
|
51
53
|
*
|
|
52
|
-
* @since
|
|
54
|
+
* @since 0.5.0-canary.6
|
|
53
55
|
*/
|
|
54
56
|
export declare function ensureDataLayer(dataLayerName: string): Array<unknown> | undefined;
|
|
55
57
|
/**
|
|
56
58
|
* Warns and returns `false` when `eventName` would be rejected by GA4.
|
|
57
59
|
*
|
|
58
|
-
* @since
|
|
60
|
+
* @since 0.5.0-canary.6
|
|
59
61
|
*/
|
|
60
62
|
export declare function warnUnlessGa4EventName(destinationName: string, eventName: string): boolean;
|
|
61
63
|
export {};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"google-consent.d.ts","sourceRoot":"","sources":["../../src/destinations/google-consent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGvE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD,KAAK,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAkBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,CASpF;AAuBD
|
|
1
|
+
{"version":3,"file":"google-consent.d.ts","sourceRoot":"","sources":["../../src/destinations/google-consent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGvE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD,KAAK,kBAAkB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAkBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,CASpF;AAuBD;;;;GAIG;AACH,MAAM,WAAW,qCAAqC;IACpD,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,cAAc,EAAE,eAAe,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,qCAAqC,GAAG,MAAM,CAiB1G;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,SAAS,CAWjF;AAaD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAU1F"}
|