@atmosfer/impressions 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.
Files changed (7) hide show
  1. package/dist/index.d.mts +34 -0
  2. package/dist/index.d.ts +34 -0
  3. package/dist/index.js +141 -0
  4. package/dist/index.js.map +1 -0
  5. package/dist/index.mjs +138 -0
  6. package/dist/index.mjs.map +1 -0
  7. package/package.json +26 -0
package/dist/index.d.mts ADDED
@@ -0,0 +1,34 @@
1
+ type RestaurantId = number | string;
2
+ type ImpressionEvent = {
3
+ schema_version: 1;
4
+ event_id: string;
5
+ ts: string;
6
+ restaurant_id: RestaurantId;
7
+ table_no?: number | null;
8
+ event_type: string;
9
+ event_detail: Record<string, any>;
10
+ };
11
+ type TrackerConfig = {
12
+ endpoint?: string;
13
+ restaurantId: RestaurantId;
14
+ tableNo?: number;
15
+ headers?: Record<string, string>;
16
+ debug?: boolean;
17
+ disable?: boolean;
18
+ anonIdKey?: string;
19
+ };
20
+ type Tracker = {
21
+ page: (detail?: Record<string, any>) => Promise<void>;
22
+ track: (eventType: string, detail?: Record<string, any>) => Promise<void>;
23
+ setContext: (ctx: Partial<{
24
+ restaurantId: RestaurantId;
25
+ tableNo: number;
26
+ }>) => void;
27
+ disable: () => void;
28
+ enable: () => void;
29
+ };
30
+ declare function createTracker(cfg: TrackerConfig): Tracker;
31
+
32
+ declare function useImpressions(config: TrackerConfig): Tracker;
33
+
34
+ export { type ImpressionEvent, type RestaurantId, type Tracker, type TrackerConfig, createTracker, useImpressions };
package/dist/index.d.ts ADDED
@@ -0,0 +1,34 @@
1
+ type RestaurantId = number | string;
2
+ type ImpressionEvent = {
3
+ schema_version: 1;
4
+ event_id: string;
5
+ ts: string;
6
+ restaurant_id: RestaurantId;
7
+ table_no?: number | null;
8
+ event_type: string;
9
+ event_detail: Record<string, any>;
10
+ };
11
+ type TrackerConfig = {
12
+ endpoint?: string;
13
+ restaurantId: RestaurantId;
14
+ tableNo?: number;
15
+ headers?: Record<string, string>;
16
+ debug?: boolean;
17
+ disable?: boolean;
18
+ anonIdKey?: string;
19
+ };
20
+ type Tracker = {
21
+ page: (detail?: Record<string, any>) => Promise<void>;
22
+ track: (eventType: string, detail?: Record<string, any>) => Promise<void>;
23
+ setContext: (ctx: Partial<{
24
+ restaurantId: RestaurantId;
25
+ tableNo: number;
26
+ }>) => void;
27
+ disable: () => void;
28
+ enable: () => void;
29
+ };
30
+ declare function createTracker(cfg: TrackerConfig): Tracker;
31
+
32
+ declare function useImpressions(config: TrackerConfig): Tracker;
33
+
34
+ export { type ImpressionEvent, type RestaurantId, type Tracker, type TrackerConfig, createTracker, useImpressions };
package/dist/index.js ADDED
@@ -0,0 +1,141 @@
1
+ 'use strict';
2
+
3
+ var react = require('react');
4
+
5
+ // src/tracker.ts
6
+ var DEFAULT_ENDPOINT = "https://pg0ovbo79k.execute-api.eu-central-1.amazonaws.com/impressions";
7
+ function uuidv4() {
8
+ return crypto.randomUUID();
9
+ }
10
+ function safeGetLS(key) {
11
+ try {
12
+ return localStorage.getItem(key);
13
+ } catch {
14
+ return null;
15
+ }
16
+ }
17
+ function safeSetLS(key, val) {
18
+ try {
19
+ localStorage.setItem(key, val);
20
+ } catch {
21
+ }
22
+ }
23
+ function getAnonId(key) {
24
+ const existing = safeGetLS(key);
25
+ if (existing) return existing;
26
+ const id = uuidv4();
27
+ safeSetLS(key, id);
28
+ return id;
29
+ }
30
+ function parseUtm() {
31
+ const p = new URLSearchParams(location.search);
32
+ const source = p.get("utm_source");
33
+ const medium = p.get("utm_medium");
34
+ const campaign = p.get("utm_campaign");
35
+ if (!source && !medium && !campaign) return void 0;
36
+ return { source, medium, campaign };
37
+ }
38
+ function deviceType() {
39
+ const w = Math.min(screen.width, screen.height);
40
+ if (w <= 480) return "mobile";
41
+ if (w <= 1024) return "tablet";
42
+ return "desktop";
43
+ }
44
+ function baseDetail(anonId) {
45
+ return {
46
+ path: location.pathname + location.search,
47
+ referrer: document.referrer || void 0,
48
+ utm: parseUtm(),
49
+ anon_id: anonId,
50
+ language: navigator.language,
51
+ timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
52
+ device: { type: deviceType() },
53
+ screen: { w: window.innerWidth, h: window.innerHeight },
54
+ page: { title: document.title }
55
+ };
56
+ }
57
+ function createTracker(cfg) {
58
+ const anonKey = cfg.anonIdKey ?? "sa_anon_id";
59
+ const anonId = getAnonId(anonKey);
60
+ const state = {
61
+ endpoint: cfg.endpoint ?? DEFAULT_ENDPOINT,
62
+ restaurantId: cfg.restaurantId,
63
+ tableNo: cfg.tableNo,
64
+ headers: cfg.headers ?? {},
65
+ disabled: !!cfg.disable,
66
+ debug: !!cfg.debug
67
+ };
68
+ async function post(ev) {
69
+ if (state.disabled) return;
70
+ if (state.debug) console.log("[impr] sending", ev);
71
+ await fetch(state.endpoint, {
72
+ method: "POST",
73
+ headers: { "content-type": "application/json", ...state.headers },
74
+ body: JSON.stringify(ev),
75
+ keepalive: true
76
+ });
77
+ }
78
+ function beacon(ev) {
79
+ var _a;
80
+ try {
81
+ const blob = new Blob([JSON.stringify(ev)], { type: "application/json" });
82
+ (_a = navigator.sendBeacon) == null ? void 0 : _a.call(navigator, state.endpoint, blob);
83
+ } catch {
84
+ }
85
+ }
86
+ function build(eventType, detail) {
87
+ return {
88
+ schema_version: 1,
89
+ event_id: uuidv4(),
90
+ ts: (/* @__PURE__ */ new Date()).toISOString(),
91
+ restaurant_id: state.restaurantId,
92
+ table_no: state.tableNo ?? null,
93
+ event_type: eventType,
94
+ event_detail: { ...baseDetail(anonId), ...detail ?? {} }
95
+ };
96
+ }
97
+ window.addEventListener("pagehide", () => {
98
+ if (state.disabled) return;
99
+ beacon(build("page_view"));
100
+ });
101
+ const origPush = history.pushState;
102
+ history.pushState = function(...args) {
103
+ origPush.apply(history, args);
104
+ void post(build("page_view"));
105
+ };
106
+ const origReplace = history.replaceState;
107
+ history.replaceState = function(...args) {
108
+ origReplace.apply(history, args);
109
+ void post(build("page_view"));
110
+ };
111
+ window.addEventListener("popstate", () => void post(build("page_view")));
112
+ return {
113
+ page: async (detail) => post(build("page_view", detail)),
114
+ track: async (eventType, detail) => post(build(eventType, detail)),
115
+ setContext: (ctx) => {
116
+ if (ctx.restaurantId !== void 0) state.restaurantId = ctx.restaurantId;
117
+ if (ctx.tableNo !== void 0) state.tableNo = ctx.tableNo;
118
+ },
119
+ disable: () => {
120
+ state.disabled = true;
121
+ },
122
+ enable: () => {
123
+ state.disabled = false;
124
+ }
125
+ };
126
+ }
127
+ function useImpressions(config) {
128
+ const tracker = react.useMemo(
129
+ () => createTracker(config),
130
+ [config.endpoint, config.restaurantId, config.tableNo]
131
+ );
132
+ react.useEffect(() => {
133
+ void tracker.page();
134
+ }, []);
135
+ return tracker;
136
+ }
137
+
138
+ exports.createTracker = createTracker;
139
+ exports.useImpressions = useImpressions;
140
+ //# sourceMappingURL=index.js.map
141
+ //# sourceMappingURL=index.js.map
package/dist/index.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/tracker.ts","../src/hook.ts"],"names":["useMemo","useEffect"],"mappings":";;;;;AAwBA,IAAM,gBAAA,GACJ,uEAAA;AAEF,SAAS,MAAA,GAAiB;AACxB,EAAA,OAAO,OAAO,UAAA,EAAW;AAC3B;AAEA,SAAS,UAAU,GAAA,EAA4B;AAC7C,EAAA,IAAI;AACF,IAAA,OAAO,YAAA,CAAa,QAAQ,GAAG,CAAA;AAAA,EACjC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AACA,SAAS,SAAA,CAAU,KAAa,GAAA,EAAa;AAC3C,EAAA,IAAI;AACF,IAAA,YAAA,CAAa,OAAA,CAAQ,KAAK,GAAG,CAAA;AAAA,EAC/B,CAAA,CAAA,MAAQ;AAAA,EAAC;AACX;AAEA,SAAS,UAAU,GAAA,EAAa;AAC9B,EAAA,MAAM,QAAA,GAAW,UAAU,GAAG,CAAA;AAC9B,EAAA,IAAI,UAAU,OAAO,QAAA;AACrB,EAAA,MAAM,KAAK,MAAA,EAAO;AAClB,EAAA,SAAA,CAAU,KAAK,EAAE,CAAA;AACjB,EAAA,OAAO,EAAA;AACT;AAEA,SAAS,QAAA,GAAW;AAClB,EAAA,MAAM,CAAA,GAAI,IAAI,eAAA,CAAgB,QAAA,CAAS,MAAM,CAAA;AAC7C,EAAA,MAAM,MAAA,GAAS,CAAA,CAAE,GAAA,CAAI,YAAY,CAAA;AACjC,EAAA,MAAM,MAAA,GAAS,CAAA,CAAE,GAAA,CAAI,YAAY,CAAA;AACjC,EAAA,MAAM,QAAA,GAAW,CAAA,CAAE,GAAA,CAAI,cAAc,CAAA;AACrC,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,MAAA,IAAU,CAAC,UAAU,OAAO,MAAA;AAC5C,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,QAAA,EAAS;AACpC;AAEA,SAAS,UAAA,GAA8C;AACrD,EAAA,MAAM,IAAI,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,KAAA,EAAO,OAAO,MAAM,CAAA;AAC9C,EAAA,IAAI,CAAA,IAAK,KAAK,OAAO,QAAA;AACrB,EAAA,IAAI,CAAA,IAAK,MAAM,OAAO,QAAA;AACtB,EAAA,OAAO,SAAA;AACT;AAEA,SAAS,WAAW,MAAA,EAAgB;AAClC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA,CAAS,QAAA,GAAW,QAAA,CAAS,MAAA;AAAA,IACnC,QAAA,EAAU,SAAS,QAAA,IAAY,MAAA;AAAA,IAC/B,KAAK,QAAA,EAAS;AAAA,IACd,OAAA,EAAS,MAAA;AAAA,IACT,UAAU,SAAA,CAAU,QAAA;AAAA,IACpB,QAAA,EAAU,IAAA,CAAK,cAAA,EAAe,CAAE,iBAAgB,CAAE,QAAA;AAAA,IAClD,MAAA,EAAQ,EAAE,IAAA,EAAM,UAAA,EAAW,EAAE;AAAA,IAC7B,QAAQ,EAAE,CAAA,EAAG,OAAO,UAAA,EAAY,CAAA,EAAG,OAAO,WAAA,EAAY;AAAA,IACtD,IAAA,EAAM,EAAE,KAAA,EAAO,QAAA,CAAS,KAAA;AAAM,GAChC;AACF;AAYO,SAAS,cAAc,GAAA,EAA6B;AACzD,EAAA,MAAM,OAAA,GAAU,IAAI,SAAA,IAAa,YAAA;AACjC,EAAA,MAAM,MAAA,GAAS,UAAU,OAAO,CAAA;AAEhC,EAAA,MAAM,KAAA,GAAQ;AAAA,IACZ,QAAA,EAAU,IAAI,QAAA,IAAY,gBAAA;AAAA,IAC1B,cAAc,GAAA,CAAI,YAAA;AAAA,IAClB,SAAS,GAAA,CAAI,OAAA;AAAA,IACb,OAAA,EAAS,GAAA,CAAI,OAAA,IAAW,EAAC;AAAA,IACzB,QAAA,EAAU,CAAC,CAAC,GAAA,CAAI,OAAA;AAAA,IAChB,KAAA,EAAO,CAAC,CAAC,GAAA,CAAI;AAAA,GACf;AAEA,EAAA,eAAe,KAAK,EAAA,EAAqB;AACvC,IAAA,IAAI,MAAM,QAAA,EAAU;AAEpB,IAAA,IAAI,KAAA,CAAM,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,kBAAkB,EAAE,CAAA;AAEjD,IAAA,MAAM,KAAA,CAAM,MAAM,QAAA,EAAU;AAAA,MAC1B,MAAA,EAAQ,MAAA;AAAA,MACR,SAAS,EAAE,cAAA,EAAgB,kBAAA,EAAoB,GAAG,MAAM,OAAA,EAAQ;AAAA,MAChE,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,EAAE,CAAA;AAAA,MACvB,SAAA,EAAW;AAAA,KACZ,CAAA;AAAA,EACH;AAEA,EAAA,SAAS,OAAO,EAAA,EAAqB;AAtHvC,IAAA,IAAA,EAAA;AAuHI,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAO,IAAI,IAAA,CAAK,CAAC,IAAA,CAAK,SAAA,CAAU,EAAE,CAAC,CAAA,EAAG,EAAE,IAAA,EAAM,kBAAA,EAAoB,CAAA;AACxE,MAAA,CAAA,EAAA,GAAA,SAAA,CAAU,UAAA,KAAV,IAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,IAAA,CAAA,SAAA,EAAuB,KAAA,CAAM,QAAA,EAAU,IAAA,CAAA;AAAA,IACzC,CAAA,CAAA,MAAQ;AAAA,IAAC;AAAA,EACX;AAEA,EAAA,SAAS,KAAA,CACP,WACA,MAAA,EACiB;AACjB,IAAA,OAAO;AAAA,MACL,cAAA,EAAgB,CAAA;AAAA,MAChB,UAAU,MAAA,EAAO;AAAA,MACjB,EAAA,EAAA,iBAAI,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,MAC3B,eAAe,KAAA,CAAM,YAAA;AAAA,MACrB,QAAA,EAAU,MAAM,OAAA,IAAW,IAAA;AAAA,MAC3B,UAAA,EAAY,SAAA;AAAA,MACZ,YAAA,EAAc,EAAE,GAAG,UAAA,CAAW,MAAM,CAAA,EAAG,GAAI,MAAA,IAAU,EAAC;AAAG,KAC3D;AAAA,EACF;AAGA,EAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,MAAM;AACxC,IAAA,IAAI,MAAM,QAAA,EAAU;AACpB,IAAA,MAAA,CAAO,KAAA,CAAM,WAAW,CAAC,CAAA;AAAA,EAC3B,CAAC,CAAA;AAGD,EAAA,MAAM,WAAW,OAAA,CAAQ,SAAA;AACzB,EAAA,OAAA,CAAQ,SAAA,GAAY,YAAa,IAAA,EAAW;AAC1C,IAAA,QAAA,CAAS,KAAA,CAAM,SAAS,IAAW,CAAA;AACnC,IAAA,KAAK,IAAA,CAAK,KAAA,CAAM,WAAW,CAAC,CAAA;AAAA,EAC9B,CAAA;AAEA,EAAA,MAAM,cAAc,OAAA,CAAQ,YAAA;AAC5B,EAAA,OAAA,CAAQ,YAAA,GAAe,YAAa,IAAA,EAAW;AAC7C,IAAA,WAAA,CAAY,KAAA,CAAM,SAAS,IAAW,CAAA;AACtC,IAAA,KAAK,IAAA,CAAK,KAAA,CAAM,WAAW,CAAC,CAAA;AAAA,EAC9B,CAAA;AAEA,EAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,MAAM,KAAK,KAAK,KAAA,CAAM,WAAW,CAAC,CAAC,CAAA;AAEvE,EAAA,OAAO;AAAA,IACL,MAAM,OAAO,MAAA,KAAW,KAAK,KAAA,CAAM,WAAA,EAAa,MAAM,CAAC,CAAA;AAAA,IACvD,KAAA,EAAO,OAAO,SAAA,EAAW,MAAA,KAAW,KAAK,KAAA,CAAM,SAAA,EAAW,MAAM,CAAC,CAAA;AAAA,IACjE,UAAA,EAAY,CAAC,GAAA,KAAQ;AACnB,MAAA,IAAI,GAAA,CAAI,YAAA,KAAiB,MAAA,EAAW,KAAA,CAAM,eAAe,GAAA,CAAI,YAAA;AAC7D,MAAA,IAAI,GAAA,CAAI,OAAA,KAAY,MAAA,EAAW,KAAA,CAAM,UAAU,GAAA,CAAI,OAAA;AAAA,IACrD,CAAA;AAAA,IACA,SAAS,MAAM;AACb,MAAA,KAAA,CAAM,QAAA,GAAW,IAAA;AAAA,IACnB,CAAA;AAAA,IACA,QAAQ,MAAM;AACZ,MAAA,KAAA,CAAM,QAAA,GAAW,KAAA;AAAA,IACnB;AAAA,GACF;AACF;AC3KO,SAAS,eAAe,MAAA,EAAuB;AACpD,EAAA,MAAM,OAAA,GAAUA,aAAA;AAAA,IACd,MAAM,cAAc,MAAM,CAAA;AAAA,IAC1B,CAAC,MAAA,CAAO,QAAA,EAAU,MAAA,CAAO,YAAA,EAAc,OAAO,OAAO;AAAA,GACvD;AAEA,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,KAAK,QAAQ,IAAA,EAAK;AAAA,EAEpB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,OAAA;AACT","file":"index.js","sourcesContent":["export type RestaurantId = number | string;\n\nexport type ImpressionEvent = {\n schema_version: 1;\n event_id: string;\n ts: string;\n\n restaurant_id: RestaurantId;\n table_no?: number | null;\n\n event_type: string;\n event_detail: Record<string, any>;\n};\n\nexport type TrackerConfig = {\n endpoint?: string;\n restaurantId: RestaurantId;\n tableNo?: number;\n headers?: Record<string, string>;\n debug?: boolean;\n disable?: boolean;\n anonIdKey?: string;\n};\n\nconst DEFAULT_ENDPOINT =\n \"https://pg0ovbo79k.execute-api.eu-central-1.amazonaws.com/impressions\";\n\nfunction uuidv4(): string {\n return crypto.randomUUID();\n}\n\nfunction safeGetLS(key: string): string | null {\n try {\n return localStorage.getItem(key);\n } catch {\n return null;\n }\n}\nfunction safeSetLS(key: string, val: string) {\n try {\n localStorage.setItem(key, val);\n } catch {}\n}\n\nfunction getAnonId(key: string) {\n const existing = safeGetLS(key);\n if (existing) return existing;\n const id = uuidv4();\n safeSetLS(key, id);\n return id;\n}\n\nfunction parseUtm() {\n const p = new URLSearchParams(location.search);\n const source = p.get(\"utm_source\");\n const medium = p.get(\"utm_medium\");\n const campaign = p.get(\"utm_campaign\");\n if (!source && !medium && !campaign) return undefined;\n return { source, medium, campaign };\n}\n\nfunction deviceType(): \"mobile\" | \"tablet\" | \"desktop\" {\n const w = Math.min(screen.width, screen.height);\n if (w <= 480) return \"mobile\";\n if (w <= 1024) return \"tablet\";\n return \"desktop\";\n}\n\nfunction baseDetail(anonId: string) {\n return {\n path: location.pathname + location.search,\n referrer: document.referrer || undefined,\n utm: parseUtm(),\n anon_id: anonId,\n language: navigator.language,\n timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n device: { type: deviceType() },\n screen: { w: window.innerWidth, h: window.innerHeight },\n page: { title: document.title },\n };\n}\n\nexport type Tracker = {\n page: (detail?: Record<string, any>) => Promise<void>;\n track: (eventType: string, detail?: Record<string, any>) => Promise<void>;\n setContext: (\n ctx: Partial<{ restaurantId: RestaurantId; tableNo: number }>\n ) => void;\n disable: () => void;\n enable: () => void;\n};\n\nexport function createTracker(cfg: TrackerConfig): Tracker {\n const anonKey = cfg.anonIdKey ?? \"sa_anon_id\";\n const anonId = getAnonId(anonKey);\n\n const state = {\n endpoint: cfg.endpoint ?? DEFAULT_ENDPOINT,\n restaurantId: cfg.restaurantId,\n tableNo: cfg.tableNo,\n headers: cfg.headers ?? {},\n disabled: !!cfg.disable,\n debug: !!cfg.debug,\n };\n\n async function post(ev: ImpressionEvent) {\n if (state.disabled) return;\n\n if (state.debug) console.log(\"[impr] sending\", ev);\n\n await fetch(state.endpoint, {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\", ...state.headers },\n body: JSON.stringify(ev),\n keepalive: true,\n });\n }\n\n function beacon(ev: ImpressionEvent) {\n try {\n const blob = new Blob([JSON.stringify(ev)], { type: \"application/json\" });\n navigator.sendBeacon?.(state.endpoint, blob);\n } catch {}\n }\n\n function build(\n eventType: string,\n detail?: Record<string, any>\n ): ImpressionEvent {\n return {\n schema_version: 1,\n event_id: uuidv4(),\n ts: new Date().toISOString(),\n restaurant_id: state.restaurantId,\n table_no: state.tableNo ?? null,\n event_type: eventType,\n event_detail: { ...baseDetail(anonId), ...(detail ?? {}) },\n };\n }\n\n // Unload best-effort\n window.addEventListener(\"pagehide\", () => {\n if (state.disabled) return;\n beacon(build(\"page_view\"));\n });\n\n // SPA navigation tracking (framework-agnostic)\n const origPush = history.pushState;\n history.pushState = function (...args: any) {\n origPush.apply(history, args as any);\n void post(build(\"page_view\"));\n } as any;\n\n const origReplace = history.replaceState;\n history.replaceState = function (...args: any) {\n origReplace.apply(history, args as any);\n void post(build(\"page_view\"));\n } as any;\n\n window.addEventListener(\"popstate\", () => void post(build(\"page_view\")));\n\n return {\n page: async (detail) => post(build(\"page_view\", detail)),\n track: async (eventType, detail) => post(build(eventType, detail)),\n setContext: (ctx) => {\n if (ctx.restaurantId !== undefined) state.restaurantId = ctx.restaurantId;\n if (ctx.tableNo !== undefined) state.tableNo = ctx.tableNo;\n },\n disable: () => {\n state.disabled = true;\n },\n enable: () => {\n state.disabled = false;\n },\n };\n}\n","import { useEffect, useMemo } from \"react\";\nimport { createTracker } from \"./tracker\";\nimport type { TrackerConfig } from \"./tracker\";\n\nexport function useImpressions(config: TrackerConfig) {\n const tracker = useMemo(\n () => createTracker(config),\n [config.endpoint, config.restaurantId, config.tableNo]\n );\n\n useEffect(() => {\n void tracker.page();\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n return tracker;\n}\n"]}
package/dist/index.mjs ADDED
@@ -0,0 +1,138 @@
1
+ import { useMemo, useEffect } from 'react';
2
+
3
+ // src/tracker.ts
4
+ var DEFAULT_ENDPOINT = "https://pg0ovbo79k.execute-api.eu-central-1.amazonaws.com/impressions";
5
+ function uuidv4() {
6
+ return crypto.randomUUID();
7
+ }
8
+ function safeGetLS(key) {
9
+ try {
10
+ return localStorage.getItem(key);
11
+ } catch {
12
+ return null;
13
+ }
14
+ }
15
+ function safeSetLS(key, val) {
16
+ try {
17
+ localStorage.setItem(key, val);
18
+ } catch {
19
+ }
20
+ }
21
+ function getAnonId(key) {
22
+ const existing = safeGetLS(key);
23
+ if (existing) return existing;
24
+ const id = uuidv4();
25
+ safeSetLS(key, id);
26
+ return id;
27
+ }
28
+ function parseUtm() {
29
+ const p = new URLSearchParams(location.search);
30
+ const source = p.get("utm_source");
31
+ const medium = p.get("utm_medium");
32
+ const campaign = p.get("utm_campaign");
33
+ if (!source && !medium && !campaign) return void 0;
34
+ return { source, medium, campaign };
35
+ }
36
+ function deviceType() {
37
+ const w = Math.min(screen.width, screen.height);
38
+ if (w <= 480) return "mobile";
39
+ if (w <= 1024) return "tablet";
40
+ return "desktop";
41
+ }
42
+ function baseDetail(anonId) {
43
+ return {
44
+ path: location.pathname + location.search,
45
+ referrer: document.referrer || void 0,
46
+ utm: parseUtm(),
47
+ anon_id: anonId,
48
+ language: navigator.language,
49
+ timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
50
+ device: { type: deviceType() },
51
+ screen: { w: window.innerWidth, h: window.innerHeight },
52
+ page: { title: document.title }
53
+ };
54
+ }
55
+ function createTracker(cfg) {
56
+ const anonKey = cfg.anonIdKey ?? "sa_anon_id";
57
+ const anonId = getAnonId(anonKey);
58
+ const state = {
59
+ endpoint: cfg.endpoint ?? DEFAULT_ENDPOINT,
60
+ restaurantId: cfg.restaurantId,
61
+ tableNo: cfg.tableNo,
62
+ headers: cfg.headers ?? {},
63
+ disabled: !!cfg.disable,
64
+ debug: !!cfg.debug
65
+ };
66
+ async function post(ev) {
67
+ if (state.disabled) return;
68
+ if (state.debug) console.log("[impr] sending", ev);
69
+ await fetch(state.endpoint, {
70
+ method: "POST",
71
+ headers: { "content-type": "application/json", ...state.headers },
72
+ body: JSON.stringify(ev),
73
+ keepalive: true
74
+ });
75
+ }
76
+ function beacon(ev) {
77
+ var _a;
78
+ try {
79
+ const blob = new Blob([JSON.stringify(ev)], { type: "application/json" });
80
+ (_a = navigator.sendBeacon) == null ? void 0 : _a.call(navigator, state.endpoint, blob);
81
+ } catch {
82
+ }
83
+ }
84
+ function build(eventType, detail) {
85
+ return {
86
+ schema_version: 1,
87
+ event_id: uuidv4(),
88
+ ts: (/* @__PURE__ */ new Date()).toISOString(),
89
+ restaurant_id: state.restaurantId,
90
+ table_no: state.tableNo ?? null,
91
+ event_type: eventType,
92
+ event_detail: { ...baseDetail(anonId), ...detail ?? {} }
93
+ };
94
+ }
95
+ window.addEventListener("pagehide", () => {
96
+ if (state.disabled) return;
97
+ beacon(build("page_view"));
98
+ });
99
+ const origPush = history.pushState;
100
+ history.pushState = function(...args) {
101
+ origPush.apply(history, args);
102
+ void post(build("page_view"));
103
+ };
104
+ const origReplace = history.replaceState;
105
+ history.replaceState = function(...args) {
106
+ origReplace.apply(history, args);
107
+ void post(build("page_view"));
108
+ };
109
+ window.addEventListener("popstate", () => void post(build("page_view")));
110
+ return {
111
+ page: async (detail) => post(build("page_view", detail)),
112
+ track: async (eventType, detail) => post(build(eventType, detail)),
113
+ setContext: (ctx) => {
114
+ if (ctx.restaurantId !== void 0) state.restaurantId = ctx.restaurantId;
115
+ if (ctx.tableNo !== void 0) state.tableNo = ctx.tableNo;
116
+ },
117
+ disable: () => {
118
+ state.disabled = true;
119
+ },
120
+ enable: () => {
121
+ state.disabled = false;
122
+ }
123
+ };
124
+ }
125
+ function useImpressions(config) {
126
+ const tracker = useMemo(
127
+ () => createTracker(config),
128
+ [config.endpoint, config.restaurantId, config.tableNo]
129
+ );
130
+ useEffect(() => {
131
+ void tracker.page();
132
+ }, []);
133
+ return tracker;
134
+ }
135
+
136
+ export { createTracker, useImpressions };
137
+ //# sourceMappingURL=index.mjs.map
138
+ //# sourceMappingURL=index.mjs.map
package/dist/index.mjs.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/tracker.ts","../src/hook.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export type RestaurantId = number | string;\n\nexport type ImpressionEvent = {\n schema_version: 1;\n event_id: string;\n ts: string;\n\n restaurant_id: RestaurantId;\n table_no?: number | null;\n\n event_type: string;\n event_detail: Record<string, any>;\n};\n\nexport type TrackerConfig = {\n endpoint?: string;\n restaurantId: RestaurantId;\n tableNo?: number;\n headers?: Record<string, string>;\n debug?: boolean;\n disable?: boolean;\n anonIdKey?: string;\n};\n\nconst DEFAULT_ENDPOINT =\n \"https://pg0ovbo79k.execute-api.eu-central-1.amazonaws.com/impressions\";\n\nfunction uuidv4(): string {\n return crypto.randomUUID();\n}\n\nfunction safeGetLS(key: string): string | null {\n try {\n return localStorage.getItem(key);\n } catch {\n return null;\n }\n}\nfunction safeSetLS(key: string, val: string) {\n try {\n localStorage.setItem(key, val);\n } catch {}\n}\n\nfunction getAnonId(key: string) {\n const existing = safeGetLS(key);\n if (existing) return existing;\n const id = uuidv4();\n safeSetLS(key, id);\n return id;\n}\n\nfunction parseUtm() {\n const p = new URLSearchParams(location.search);\n const source = p.get(\"utm_source\");\n const medium = p.get(\"utm_medium\");\n const campaign = p.get(\"utm_campaign\");\n if (!source && !medium && !campaign) return undefined;\n return { source, medium, campaign };\n}\n\nfunction deviceType(): \"mobile\" | \"tablet\" | \"desktop\" {\n const w = Math.min(screen.width, screen.height);\n if (w <= 480) return \"mobile\";\n if (w <= 1024) return \"tablet\";\n return \"desktop\";\n}\n\nfunction baseDetail(anonId: string) {\n return {\n path: location.pathname + location.search,\n referrer: document.referrer || undefined,\n utm: parseUtm(),\n anon_id: anonId,\n language: navigator.language,\n timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n device: { type: deviceType() },\n screen: { w: window.innerWidth, h: window.innerHeight },\n page: { title: document.title },\n };\n}\n\nexport type Tracker = {\n page: (detail?: Record<string, any>) => Promise<void>;\n track: (eventType: string, detail?: Record<string, any>) => Promise<void>;\n setContext: (\n ctx: Partial<{ restaurantId: RestaurantId; tableNo: number }>\n ) => void;\n disable: () => void;\n enable: () => void;\n};\n\nexport function createTracker(cfg: TrackerConfig): Tracker {\n const anonKey = cfg.anonIdKey ?? \"sa_anon_id\";\n const anonId = getAnonId(anonKey);\n\n const state = {\n endpoint: cfg.endpoint ?? DEFAULT_ENDPOINT,\n restaurantId: cfg.restaurantId,\n tableNo: cfg.tableNo,\n headers: cfg.headers ?? {},\n disabled: !!cfg.disable,\n debug: !!cfg.debug,\n };\n\n async function post(ev: ImpressionEvent) {\n if (state.disabled) return;\n\n if (state.debug) console.log(\"[impr] sending\", ev);\n\n await fetch(state.endpoint, {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\", ...state.headers },\n body: JSON.stringify(ev),\n keepalive: true,\n });\n }\n\n function beacon(ev: ImpressionEvent) {\n try {\n const blob = new Blob([JSON.stringify(ev)], { type: \"application/json\" });\n navigator.sendBeacon?.(state.endpoint, blob);\n } catch {}\n }\n\n function build(\n eventType: string,\n detail?: Record<string, any>\n ): ImpressionEvent {\n return {\n schema_version: 1,\n event_id: uuidv4(),\n ts: new Date().toISOString(),\n restaurant_id: state.restaurantId,\n table_no: state.tableNo ?? null,\n event_type: eventType,\n event_detail: { ...baseDetail(anonId), ...(detail ?? {}) },\n };\n }\n\n // Unload best-effort\n window.addEventListener(\"pagehide\", () => {\n if (state.disabled) return;\n beacon(build(\"page_view\"));\n });\n\n // SPA navigation tracking (framework-agnostic)\n const origPush = history.pushState;\n history.pushState = function (...args: any) {\n origPush.apply(history, args as any);\n void post(build(\"page_view\"));\n } as any;\n\n const origReplace = history.replaceState;\n history.replaceState = function (...args: any) {\n origReplace.apply(history, args as any);\n void post(build(\"page_view\"));\n } as any;\n\n window.addEventListener(\"popstate\", () => void post(build(\"page_view\")));\n\n return {\n page: async (detail) => post(build(\"page_view\", detail)),\n track: async (eventType, detail) => post(build(eventType, detail)),\n setContext: (ctx) => {\n if (ctx.restaurantId !== undefined) state.restaurantId = ctx.restaurantId;\n if (ctx.tableNo !== undefined) state.tableNo = ctx.tableNo;\n },\n disable: () => {\n state.disabled = true;\n },\n enable: () => {\n state.disabled = false;\n },\n };\n}\n","import { useEffect, useMemo } from \"react\";\nimport { createTracker } from \"./tracker\";\nimport type { TrackerConfig } from \"./tracker\";\n\nexport function useImpressions(config: TrackerConfig) {\n const tracker = useMemo(\n () => createTracker(config),\n [config.endpoint, config.restaurantId, config.tableNo]\n );\n\n useEffect(() => {\n void tracker.page();\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n return tracker;\n}\n"]}
package/package.json ADDED
@@ -0,0 +1,26 @@
1
+ {
2
+ "name": "@atmosfer/impressions",
3
+ "version": "0.1.0",
4
+ "description": "",
5
+ "main": "dist/index.cjs",
6
+ "module": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "files": [
9
+ "dist"
10
+ ],
11
+ "scripts": {
12
+ "build": "tsup",
13
+ "dev": "tsup --watch"
14
+ },
15
+ "license": "ISC",
16
+ "sideEffects": false,
17
+ "peerDependencies": {
18
+ "react": ">=18"
19
+ },
20
+ "devDependencies": {
21
+ "@types/node": "^25.0.3",
22
+ "@types/react": "^19.2.7",
23
+ "tsup": "^8.5.1",
24
+ "typescript": "^5.9.3"
25
+ }
26
+ }