@fire-spark/analytics-tiktok 0.0.0-stage → 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { AnalyticsAdapter } from "@fire-spark/analytics";
+//#region src/index.d.ts
+type TikTokLogEvent = (name: string, params?: Record<string, unknown>) => Promise<void> | void;
+type TikTokOptions = {
+  pixelId?: string;
+  logEvent?: TikTokLogEvent;
+};
+declare const tiktok: (options?: TikTokOptions) => AnalyticsAdapter;
+//#endregion
+export { TikTokLogEvent, TikTokOptions, tiktok };

package/dist/index.js

@@ -0,0 +1,55 @@
+//#region src/index.ts
+const existingTtq = () => {
+	const root = globalThis;
+	if (root.ttq) return root.ttq;
+	return globalThis.window?.ttq;
+};
+const injectScript = (src, id) => {
+	if (typeof document === "undefined") return Promise.resolve();
+	if (document.getElementById(id)) return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		const el = document.createElement("script");
+		el.id = id;
+		el.async = true;
+		el.src = src;
+		el.onload = () => resolve();
+		el.onerror = () => reject(/* @__PURE__ */ new Error(`Failed to load ${src}`));
+		document.head.appendChild(el);
+	});
+};
+let loading = null;
+const ensureTtq = async (pixelId) => {
+	if (loading) return loading;
+	const present = existingTtq();
+	if (present) return present;
+	if (!pixelId || typeof document === "undefined") return void 0;
+	loading = (async () => {
+		const src = `https://analytics.tiktok.com/i18n/pixel/events.js?sdkid=${encodeURIComponent(pixelId)}&lib=ttq`;
+		await injectScript(src, "firespark-tiktok-ttq");
+		const ttq = existingTtq();
+		ttq?.load?.(pixelId);
+		return ttq;
+	})();
+	try {
+		return await loading;
+	} finally {
+		loading = null;
+	}
+};
+const tiktok = (options = {}) => {
+	return {
+		provider: "tiktok",
+		send: async (event) => {
+			if (event.runtime === "react-native") {
+				if (!options.logEvent) return;
+				await options.logEvent(event.name, event.params);
+				return;
+			}
+			const ttq = await ensureTtq(options.pixelId);
+			if (!ttq?.track) return;
+			ttq.track(event.name, event.params);
+		}
+	};
+};
+//#endregion
+export { tiktok };

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@fire-spark/analytics-tiktok",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.2",
+  "description": "Fire Spark TikTok analytics adapter (web ttq + RN inject)",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@fire-spark/analytics": "^0.1.2"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^2.1.8",
+    "@fire-spark/analytics": "0.1.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "tsdown": {
+    "entry": [
+      "src/index.ts"
+    ],
+    "format": [
+      "esm"
+    ],
+    "platform": "neutral",
+    "dts": {
+      "tsconfig": "tsconfig.build.json"
+    },
+    "clean": true,
+    "deps": {
+      "neverBundle": [
+        "@fire-spark/analytics"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "check-types": "tsc --noEmit",
+    "test:utils": "vitest run",
+    "lint": "oxlint ./src --max-warnings=0",
+    "format": "oxfmt ./src",
+    "check-format": "oxfmt --check ./src"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.