@ad-tracking-kits/meta 0.1.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/fbq.d.ts +19 -0
- package/dist/fbq.d.ts.map +1 -0
- package/dist/fbq.js +39 -0
- package/dist/fbq.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -0
- package/dist/mapper.d.ts +8 -0
- package/dist/mapper.d.ts.map +1 -0
- package/dist/mapper.js +109 -0
- package/dist/mapper.js.map +1 -0
- package/dist/meta.d.ts +17 -0
- package/dist/meta.d.ts.map +1 -0
- package/dist/meta.js +41 -0
- package/dist/meta.js.map +1 -0
- package/package.json +29 -0
package/dist/fbq.d.ts
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
export type Fbq = {
|
|
2
|
+
(...args: unknown[]): void;
|
|
3
|
+
callMethod?: (...args: unknown[]) => void;
|
|
4
|
+
queue: unknown[][];
|
|
5
|
+
loaded: boolean;
|
|
6
|
+
version: string;
|
|
7
|
+
push: Fbq;
|
|
8
|
+
/** Stops the pixel from firing PageView on history changes (SPA navigations). */
|
|
9
|
+
disablePushState?: boolean;
|
|
10
|
+
};
|
|
11
|
+
declare global {
|
|
12
|
+
interface Window {
|
|
13
|
+
fbq?: Fbq;
|
|
14
|
+
_fbq?: Fbq;
|
|
15
|
+
__adTrackingKitsMetaPixelId?: string;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
export declare function ensureFbq(scriptUrl: string, nonce?: string): Fbq | undefined;
|
|
19
|
+
//# sourceMappingURL=fbq.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fbq.d.ts","sourceRoot":"","sources":["../src/fbq.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG;IAChB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAC1C,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;IACV,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,GAAG,CAAC,EAAE,GAAG,CAAC;QACV,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,2BAA2B,CAAC,EAAE,MAAM,CAAC;KACtC;CACF;AAkBD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAsB5E"}
|
package/dist/fbq.js
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
function createFbq() {
|
|
2
|
+
const fbq = function (...args) {
|
|
3
|
+
if (fbq.callMethod) {
|
|
4
|
+
fbq.callMethod(...args);
|
|
5
|
+
}
|
|
6
|
+
else {
|
|
7
|
+
fbq.queue.push(args);
|
|
8
|
+
}
|
|
9
|
+
};
|
|
10
|
+
fbq.push = fbq;
|
|
11
|
+
fbq.loaded = true;
|
|
12
|
+
fbq.version = "2.0";
|
|
13
|
+
fbq.queue = [];
|
|
14
|
+
return fbq;
|
|
15
|
+
}
|
|
16
|
+
export function ensureFbq(scriptUrl, nonce) {
|
|
17
|
+
if (typeof window === "undefined" || typeof document === "undefined")
|
|
18
|
+
return undefined;
|
|
19
|
+
if (window.fbq)
|
|
20
|
+
return window.fbq;
|
|
21
|
+
const fbq = createFbq();
|
|
22
|
+
window.fbq = fbq;
|
|
23
|
+
window._fbq = fbq;
|
|
24
|
+
const script = document.createElement("script");
|
|
25
|
+
script.async = true;
|
|
26
|
+
script.src = scriptUrl;
|
|
27
|
+
if (nonce)
|
|
28
|
+
script.nonce = nonce;
|
|
29
|
+
script.dataset.adTrackingKitsMeta = "true";
|
|
30
|
+
const firstScript = document.getElementsByTagName("script")[0];
|
|
31
|
+
if (firstScript?.parentNode) {
|
|
32
|
+
firstScript.parentNode.insertBefore(script, firstScript);
|
|
33
|
+
}
|
|
34
|
+
else {
|
|
35
|
+
document.head.appendChild(script);
|
|
36
|
+
}
|
|
37
|
+
return fbq;
|
|
38
|
+
}
|
|
39
|
+
//# sourceMappingURL=fbq.js.map
|
package/dist/fbq.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fbq.js","sourceRoot":"","sources":["../src/fbq.ts"],"names":[],"mappings":"AAmBA,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,UAAyB,GAAG,IAAe;QACrD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAQ,CAAC;IAET,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;IACf,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;IAClB,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACpB,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;IACf,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,KAAc;IACzD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACvF,IAAI,MAAM,CAAC,GAAG;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAElC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;IAElB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,GAAG,SAAS,CAAC;IACvB,IAAI,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,MAAM,CAAC,OAAO,CAAC,kBAAkB,GAAG,MAAM,CAAC;IAE3C,MAAM,WAAW,GAAG,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,WAAW,EAAE,UAAU,EAAE,CAAC;QAC5B,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
|
package/dist/mapper.d.ts
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { StandardTrackingEvent } from "@ad-tracking-kits/core";
|
|
2
|
+
export interface MetaMappedEvent {
|
|
3
|
+
method: "track";
|
|
4
|
+
eventName: "PageView" | "ViewContent" | "Search" | "AddToCart" | "AddToWishlist" | "InitiateCheckout" | "Purchase" | "CompleteRegistration" | "Lead";
|
|
5
|
+
params?: Record<string, unknown>;
|
|
6
|
+
}
|
|
7
|
+
export declare function mapToMeta(event: StandardTrackingEvent): MetaMappedEvent;
|
|
8
|
+
//# sourceMappingURL=mapper.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EACL,UAAU,GACV,aAAa,GACb,QAAQ,GACR,WAAW,GACX,eAAe,GACf,kBAAkB,GAClB,UAAU,GACV,sBAAsB,GACtB,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAwBD,wBAAgB,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,eAAe,CAgGvE"}
|
package/dist/mapper.js
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
function itemsToMeta(items) {
|
|
2
|
+
if (!items?.length)
|
|
3
|
+
return {};
|
|
4
|
+
return {
|
|
5
|
+
content_ids: items.map((item) => item.id),
|
|
6
|
+
content_type: "product",
|
|
7
|
+
contents: items.map((item) => ({
|
|
8
|
+
id: item.id,
|
|
9
|
+
quantity: item.quantity ?? 1,
|
|
10
|
+
...(item.price === undefined ? {} : { item_price: item.price }),
|
|
11
|
+
})),
|
|
12
|
+
num_items: items.reduce((sum, item) => sum + (item.quantity ?? 1), 0),
|
|
13
|
+
};
|
|
14
|
+
}
|
|
15
|
+
function money(value, currency) {
|
|
16
|
+
return {
|
|
17
|
+
...(value === undefined ? {} : { value }),
|
|
18
|
+
...(value === undefined && currency === undefined ? {} : { currency: currency ?? "KRW" }),
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
export function mapToMeta(event) {
|
|
22
|
+
switch (event.name) {
|
|
23
|
+
case "page_view":
|
|
24
|
+
// The pixel reads the URL itself.
|
|
25
|
+
return { method: "track", eventName: "PageView" };
|
|
26
|
+
case "view_content": {
|
|
27
|
+
const data = event.properties;
|
|
28
|
+
const fallbackItems = data.id
|
|
29
|
+
? [{
|
|
30
|
+
id: data.id,
|
|
31
|
+
...(data.name ? { name: data.name } : {}),
|
|
32
|
+
...(data.category ? { category: data.category } : {}),
|
|
33
|
+
}]
|
|
34
|
+
: undefined;
|
|
35
|
+
const items = data.items ?? fallbackItems;
|
|
36
|
+
return {
|
|
37
|
+
method: "track",
|
|
38
|
+
eventName: "ViewContent",
|
|
39
|
+
params: {
|
|
40
|
+
...itemsToMeta(items),
|
|
41
|
+
...money(data.value, data.currency),
|
|
42
|
+
...(data.name ? { content_name: data.name } : {}),
|
|
43
|
+
...(data.category ? { content_category: data.category } : {}),
|
|
44
|
+
},
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
case "search":
|
|
48
|
+
return {
|
|
49
|
+
method: "track",
|
|
50
|
+
eventName: "Search",
|
|
51
|
+
params: { search_string: event.properties.query },
|
|
52
|
+
};
|
|
53
|
+
case "add_to_cart":
|
|
54
|
+
return {
|
|
55
|
+
method: "track",
|
|
56
|
+
eventName: "AddToCart",
|
|
57
|
+
params: {
|
|
58
|
+
...itemsToMeta(event.properties.items),
|
|
59
|
+
...money(event.properties.value, event.properties.currency),
|
|
60
|
+
},
|
|
61
|
+
};
|
|
62
|
+
case "add_to_wishlist":
|
|
63
|
+
return {
|
|
64
|
+
method: "track",
|
|
65
|
+
eventName: "AddToWishlist",
|
|
66
|
+
params: {
|
|
67
|
+
...itemsToMeta(event.properties.items),
|
|
68
|
+
...money(event.properties.value, event.properties.currency),
|
|
69
|
+
},
|
|
70
|
+
};
|
|
71
|
+
case "begin_checkout":
|
|
72
|
+
return {
|
|
73
|
+
method: "track",
|
|
74
|
+
eventName: "InitiateCheckout",
|
|
75
|
+
params: {
|
|
76
|
+
...itemsToMeta(event.properties.items),
|
|
77
|
+
...money(event.properties.value, event.properties.currency),
|
|
78
|
+
},
|
|
79
|
+
};
|
|
80
|
+
case "purchase":
|
|
81
|
+
return {
|
|
82
|
+
method: "track",
|
|
83
|
+
eventName: "Purchase",
|
|
84
|
+
params: {
|
|
85
|
+
...itemsToMeta(event.properties.items),
|
|
86
|
+
...money(event.properties.value, event.properties.currency),
|
|
87
|
+
},
|
|
88
|
+
};
|
|
89
|
+
case "sign_up":
|
|
90
|
+
return {
|
|
91
|
+
method: "track",
|
|
92
|
+
eventName: "CompleteRegistration",
|
|
93
|
+
params: {
|
|
94
|
+
...(event.properties.method ? { content_name: event.properties.method } : {}),
|
|
95
|
+
...money(event.properties.value, event.properties.currency),
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
case "lead":
|
|
99
|
+
return {
|
|
100
|
+
method: "track",
|
|
101
|
+
eventName: "Lead",
|
|
102
|
+
params: {
|
|
103
|
+
...(event.properties.type ? { content_name: event.properties.type } : {}),
|
|
104
|
+
...money(event.properties.value, event.properties.currency),
|
|
105
|
+
},
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=mapper.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mapper.js","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"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"}
|
package/dist/meta.d.ts
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { type TrackingAdapter } from "@ad-tracking-kits/core";
|
|
2
|
+
export interface MetaAdapterConfig {
|
|
3
|
+
pixelId: string;
|
|
4
|
+
/**
|
|
5
|
+
* true (default): the pixel sends PageView on load and on SPA history changes by itself,
|
|
6
|
+
* so `page_view` events are skipped.
|
|
7
|
+
* false: the pixel's history tracking is disabled and `page_view` events (e.g. `usePageView`)
|
|
8
|
+
* are sent instead, with an eventID usable for CAPI deduplication.
|
|
9
|
+
*/
|
|
10
|
+
autoPageView?: boolean;
|
|
11
|
+
/** Override only for self-hosting/proxying. */
|
|
12
|
+
scriptUrl?: string;
|
|
13
|
+
/** CSP nonce applied to the injected script tag. */
|
|
14
|
+
nonce?: string;
|
|
15
|
+
}
|
|
16
|
+
export declare function meta(config: MetaAdapterConfig): TrackingAdapter;
|
|
17
|
+
//# sourceMappingURL=meta.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI/E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAqC/D"}
|
package/dist/meta.js
ADDED
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { isStandardEvent } from "@ad-tracking-kits/core";
|
|
2
|
+
import { ensureFbq } from "./fbq.js";
|
|
3
|
+
import { mapToMeta } from "./mapper.js";
|
|
4
|
+
const DEFAULT_SCRIPT_URL = "https://connect.facebook.net/en_US/fbevents.js";
|
|
5
|
+
export function meta(config) {
|
|
6
|
+
if (!config.pixelId.trim()) {
|
|
7
|
+
throw new Error("[ad-tracking-kits/meta] pixelId is required");
|
|
8
|
+
}
|
|
9
|
+
const autoPageView = config.autoPageView ?? true;
|
|
10
|
+
return {
|
|
11
|
+
name: "meta",
|
|
12
|
+
initialize() {
|
|
13
|
+
const fbq = ensureFbq(config.scriptUrl ?? DEFAULT_SCRIPT_URL, config.nonce);
|
|
14
|
+
// Already initialized on this page (e.g. tracker re-created by HMR).
|
|
15
|
+
if (!fbq || window.__adTrackingKitsMetaPixelId === config.pixelId)
|
|
16
|
+
return;
|
|
17
|
+
window.__adTrackingKitsMetaPixelId = config.pixelId;
|
|
18
|
+
if (!autoPageView)
|
|
19
|
+
fbq.disablePushState = true;
|
|
20
|
+
fbq("init", config.pixelId);
|
|
21
|
+
if (autoPageView)
|
|
22
|
+
fbq("track", "PageView");
|
|
23
|
+
},
|
|
24
|
+
track(event) {
|
|
25
|
+
if (typeof window === "undefined" || !window.fbq) {
|
|
26
|
+
throw new Error("[ad-tracking-kits/meta] fbq is not available");
|
|
27
|
+
}
|
|
28
|
+
const options = { eventID: event.id };
|
|
29
|
+
if (!isStandardEvent(event)) {
|
|
30
|
+
window.fbq("trackCustom", event.name, event.properties, options);
|
|
31
|
+
return { payload: ["trackCustom", event.name, event.properties, options] };
|
|
32
|
+
}
|
|
33
|
+
if (event.name === "page_view" && autoPageView)
|
|
34
|
+
return false;
|
|
35
|
+
const { method, eventName, params = {} } = mapToMeta(event);
|
|
36
|
+
window.fbq(method, eventName, params, options);
|
|
37
|
+
return { payload: [method, eventName, params, options] };
|
|
38
|
+
},
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
//# sourceMappingURL=meta.js.map
|
package/dist/meta.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwB,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAiBxC,MAAM,kBAAkB,GAAG,gDAAgD,CAAC;AAE5E,MAAM,UAAU,IAAI,CAAC,MAAyB;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,MAAM;QAEZ,UAAU;YACR,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,IAAI,kBAAkB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,qEAAqE;YACrE,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,2BAA2B,KAAK,MAAM,CAAC,OAAO;gBAAE,OAAO;YAC1E,MAAM,CAAC,2BAA2B,GAAG,MAAM,CAAC,OAAO,CAAC;YAEpD,IAAI,CAAC,YAAY;gBAAE,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC/C,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,YAAY;gBAAE,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,CAAC,KAAK;YACT,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YAEtC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACjE,OAAO,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;YAC7E,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,YAAY;gBAAE,OAAO,KAAK,CAAC;YAE7D,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@ad-tracking-kits/meta",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"repository": {
|
|
5
|
+
"type": "git",
|
|
6
|
+
"url": "git+https://github.com/banggae2/ad-tracking-kits.git",
|
|
7
|
+
"directory": "packages/meta"
|
|
8
|
+
},
|
|
9
|
+
"type": "module",
|
|
10
|
+
"sideEffects": false,
|
|
11
|
+
"exports": {
|
|
12
|
+
".": {
|
|
13
|
+
"types": "./dist/index.d.ts",
|
|
14
|
+
"import": "./dist/index.js"
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
"files": [
|
|
18
|
+
"dist"
|
|
19
|
+
],
|
|
20
|
+
"dependencies": {
|
|
21
|
+
"@ad-tracking-kits/core": "0.1.0"
|
|
22
|
+
},
|
|
23
|
+
"publishConfig": {
|
|
24
|
+
"access": "public"
|
|
25
|
+
},
|
|
26
|
+
"scripts": {
|
|
27
|
+
"build": "tsc -p tsconfig.json"
|
|
28
|
+
}
|
|
29
|
+
}
|