fix(sdk): use neutral sync endpoints in sdk to prevent ad-blocker

Author: Davidthecode

.changeset/large-spiders-feel.md

@@ -0,0 +1,5 @@
+---
+"@flagix/js-sdk": minor
+---
+
+migrated internal tracking and evaluation endpoints to a generic /api/sync path. This change is to improve the SDK reliability by bypassing aggressive tracking filters in browser privacy extensions and ad-blockers

apps/api/src/app.ts

@@ -8,7 +8,7 @@ import flagRoutes from "@/routes/flag/route";
 import flagConfigRoutes from "@/routes/flag-config/route";
 import projectRoutes from "@/routes/project/route";
 import sseRoutes from "@/routes/sse/route";
-import trackRoutes from "@/routes/track/route";
+import trackRoutes from "@/routes/sync/route";
 
 const createApp = (): Express => {
   const app: Express = express();
@@ -23,7 +23,10 @@ const createApp = (): Express => {
 
   app.use("/api/flag-config", flagConfigRoutes);
   app.use("/api/sse", sseRoutes);
-  app.use("/api/track", trackRoutes);
+
+  // this route ideally should be `track` but is named `sync` because ad-blockers block routes with "track" in them
+  // the route handles tracking events from the SDK
+  app.use("/api/sync", trackRoutes);
 
   app.use(requireAuth);
 

apps/api/src/config/cors.ts

@@ -2,7 +2,7 @@ import type { CorsOptionsDelegate } from "cors";
 import type { Request } from "express";
 import { env } from "@/config/env";
 
-const SDK_PREFIXES = ["/api/flag-config", "/api/track", "/api/sse"];
+const SDK_PREFIXES = ["/api/flag-config", "/api/sync", "/api/sse"];
 const ALLOWED_ADMIN_ORIGINS = [env.FRONTEND_URL, "http://localhost:3000"];
 
 export const corsOptions: CorsOptionsDelegate = (req, callback) => {

apps/api/src/routes/track/route.ts apps/api/src/routes/sync/route.tsapps/api/src/routes/track/route.ts renamed to apps/api/src/routes/sync/route.ts

@@ -412,7 +412,7 @@ export class FlagixClient {
     properties?: Record<string, unknown>,
     contextOverrides?: EvaluationContext
   ): void {
-    const url = `${this.apiBaseUrl}/api/track/event`;
+    const url = `${this.apiBaseUrl}/api/sync/event`;
 
     const finalContext = { ...this.context, ...contextOverrides };
     const distinctId = resolveIdentifier(finalContext);
@@ -466,7 +466,7 @@ export class FlagixClient {
     result: FlagVariation,
     context: EvaluationContext
   ): void {
-    const url = `${this.apiBaseUrl}/api/track/evaluation`;
+    const url = `${this.apiBaseUrl}/api/sync/evaluation`;
 
     const distinctId = resolveIdentifier(context);