@flagix/js-sdk 1.1.0

package/src/sse/create-event-source.ts

@@ -0,0 +1,33 @@
+import type { EventSourceInit } from "eventsource";
+import { log } from "@/lib/logger";
+
+export type FlagStreamConnection = {
+  onopen: ((this: FlagStreamConnection, ev: Event) => void) | null;
+  onerror: ((this: FlagStreamConnection, ev: Event) => void) | null;
+  addEventListener: (
+    type: string,
+    listener: (event: MessageEvent) => void
+  ) => void;
+  close: () => void;
+};
+
+export async function createEventSource(
+  url: string,
+  apiKey: string
+): Promise<FlagStreamConnection | null> {
+  if (typeof window !== "undefined" && "EventSource" in window) {
+    return new EventSource(`${url}?apiKey=${apiKey}`) as FlagStreamConnection;
+  }
+
+  try {
+    // Dynamic import to prevent bundlers from including it in client code
+    const { EventSource: NodeEventSource } = await import("eventsource");
+
+    return new NodeEventSource(url, {
+      headers: { "X-Api-Key": apiKey },
+    } as EventSourceInit) as FlagStreamConnection;
+  } catch (error) {
+    log("warn", "[Flagix SDK] SSE not supported in this environment.", error);
+    return null;
+  }
+}

package/src/types.ts

@@ -0,0 +1,22 @@
+import type { EvaluationContext } from "@flagix/evaluation-core";
+import type { LogLevel } from "@/lib/logger";
+
+export type {
+  EvaluationContext,
+  FlagConfig,
+  FlagVariation,
+  VariationValue,
+} from "@flagix/evaluation-core";
+
+export type FlagixClientOptions = {
+  /** The API Key for the environment */
+  apiKey: string;
+  /** The base URL for the flag evaluation API  */
+  apiBaseUrl: string;
+  /** Optional context attributes  */
+  initialContext?: EvaluationContext;
+  /** Enable SDK logging */
+  logs?: {
+    level?: LogLevel; // default: "none"
+  };
+};

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "typeRoots": ["./node_modules/@types", "./types"],
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src", "src/types", "../../types"]
+}