@volley/vwr-loader 1.0.0-alpha.1

package/dist/vwrConfig.js

@@ -0,0 +1,172 @@
+import { ENV_DEFAULTS } from "./envDefaults";
+import { defaultLogger } from "./logger";
+const DEFAULT_CONFIG_TIMEOUT = 2000;
+/**
+ * Build a URL from a base and relative path, handling missing trailing slashes.
+ *
+ * The URL constructor resolves relative paths against the "directory" of the base URL,
+ * which is defined as everything up to (but not including) the last path segment.
+ * Without a trailing slash, the last segment is treated as a "file" and gets replaced.
+ *
+ * Example:
+ *   new URL("a/b.json", "https://x.com/config")  → "https://x.com/a/b.json" (wrong)
+ *   new URL("a/b.json", "https://x.com/config/") → "https://x.com/config/a/b.json" (correct)
+ *
+ * This helper normalizes the base URL to ensure correct resolution.
+ */
+const buildUrl = (path, base) => {
+    const normalizedBase = base.endsWith("/") ? base : `${base}/`;
+    return new URL(path, normalizedBase);
+};
+export const getVWRConfig = async (request, logger = defaultLogger) => {
+    var _a;
+    const timeout = (_a = request.timeout) !== null && _a !== void 0 ? _a : DEFAULT_CONFIG_TIMEOUT;
+    logger.info("[VWR Config] Fetching config with priority: local → device → shellVersion → environment → defaults");
+    // Fetch all configs in parallel for performance
+    const [localConfig, deviceConfig, shellVersionConfig, environmentConfig] = await Promise.all([
+        tryGetLocalConfig(request.configFile, timeout, logger),
+        tryGetDeviceConfig(request.configUrl, request.configFile, request.platform, request.deviceId, timeout, logger),
+        tryGetShellVersionConfig(request.configUrl, request.configFile, request.environment, request.platform, request.shellVersion, timeout, logger),
+        tryGetEnvironmentConfig(request.configUrl, request.configFile, request.environment, timeout, logger),
+    ]);
+    // Return first successful config in priority order
+    if (localConfig !== null) {
+        logger.info("[VWR Config] ✓ Using config from: local", localConfig);
+        return localConfig;
+    }
+    if (deviceConfig !== null) {
+        logger.info("[VWR Config] ✓ Using config from: device", deviceConfig);
+        return deviceConfig;
+    }
+    if (shellVersionConfig !== null) {
+        logger.info("[VWR Config] ✓ Using config from: shellVersion", shellVersionConfig);
+        return shellVersionConfig;
+    }
+    if (environmentConfig !== null) {
+        logger.info("[VWR Config] ✓ Using config from: environment", environmentConfig);
+        return environmentConfig;
+    }
+    // All fetches failed, use defaults
+    logger.warn("[VWR Config] All config fetches failed, using built-in defaults");
+    const defaultConfig = getDefaultConfig();
+    return defaultConfig;
+};
+const tryGetLocalConfig = async (configFile, timeout, logger) => {
+    var _a, _b;
+    try {
+        const url = buildUrl(configFile, (_b = (_a = ENV_DEFAULTS["local"]) === null || _a === void 0 ? void 0 : _a.configUrl) !== null && _b !== void 0 ? _b : "");
+        logger.info(`[VWR Config] Trying local: ${url}`);
+        return tryGetVWRConfig(url, timeout);
+    }
+    catch (error) {
+        logger.error(`[VWR Config] URL construction failed for local config: ${error}`);
+        return null;
+    }
+};
+const tryGetDeviceConfig = async (configUrl, configFile, platform, deviceId, timeout, logger) => {
+    try {
+        const url = buildUrl(`device/${platform}/${deviceId}/${configFile}`, configUrl);
+        logger.info(`[VWR Config] Trying device: ${url}`);
+        return tryGetVWRConfig(url, timeout);
+    }
+    catch (error) {
+        logger.error(`[VWR Config] URL construction failed for device config: ${error}`);
+        return null;
+    }
+};
+const tryGetEnvironmentConfig = async (configUrl, configFile, environment, timeout, logger) => {
+    try {
+        const url = buildUrl(`environments/${environment}/${configFile}`, configUrl);
+        logger.info(`[VWR Config] Trying environment: ${url}`);
+        return tryGetVWRConfig(url, timeout);
+    }
+    catch (error) {
+        logger.error(`[VWR Config] URL construction failed for environment config: ${error}`);
+        return null;
+    }
+};
+const tryGetShellVersionConfig = async (configUrl, configFile, environment, platform, shellVersion, timeout, logger) => {
+    try {
+        const url = buildUrl(`shellVersion/${environment}/${platform}/${shellVersion}/${configFile}`, configUrl);
+        logger.info(`[VWR Config] Trying shellVersion: ${url}`);
+        return tryGetVWRConfig(url, timeout);
+    }
+    catch (error) {
+        logger.error(`[VWR Config] URL construction failed for shellVersion config: ${error}`);
+        return null;
+    }
+};
+const tryGetVWRConfig = async (url, timeout) => {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(new Request(url, {
+            headers: {
+                "Content-Type": "application/json",
+            },
+            signal: controller.signal,
+        }));
+        if (!response.ok) {
+            clearTimeout(timeoutId);
+            return null;
+        }
+        let config = await response.json();
+        config = parseConfig(config);
+        clearTimeout(timeoutId);
+        return config;
+    }
+    catch (_a) {
+        clearTimeout(timeoutId);
+        return null;
+    }
+};
+const parseConfig = (config) => {
+    const defaultConfig = getDefaultConfig();
+    if (!Array.isArray(config.trustedDomains) ||
+        config.trustedDomains.length === 0) {
+        config.trustedDomains = defaultConfig.trustedDomains;
+    }
+    if (!config.vwrUrl) {
+        config.vwrUrl = defaultConfig.vwrUrl;
+        if (!config.trustedDomains.includes(defaultConfig.vwrUrl)) {
+            config.trustedDomains.push(defaultConfig.vwrUrl);
+        }
+    }
+    if (!config.hubUrl) {
+        config.hubUrl = defaultConfig.hubUrl;
+        if (!config.trustedDomains.includes(defaultConfig.hubUrl)) {
+            config.trustedDomains.push(defaultConfig.hubUrl);
+        }
+    }
+    // launchUrl is optional - only add to trustedDomains if explicitly set
+    if (config.launchUrl && !config.trustedDomains.includes(config.launchUrl)) {
+        config.trustedDomains.push(config.launchUrl);
+    }
+    return config;
+};
+export const validateConfig = (config) => {
+    if (!config.vwrUrl)
+        return false;
+    if (!config.hubUrl)
+        return false;
+    // launchUrl is optional, allow undefined
+    if (!Array.isArray(config.trustedDomains))
+        return false;
+    else if (config.trustedDomains.length === 0)
+        return false;
+    return true;
+};
+const getDefaultConfig = () => {
+    const ENVIRONMENT = import.meta.env.VITE_ENVIRONMENT || "dev";
+    const defaults = ENV_DEFAULTS[ENVIRONMENT];
+    if (!defaults) {
+        throw new Error(`[VWR Config] Unknown environment: ${ENVIRONMENT}. Valid: local, dev, staging, prod`);
+    }
+    return {
+        hubUrl: defaults.hubUrl,
+        vwrUrl: defaults.vwrUrl,
+        launchUrl: undefined,
+        trustedDomains: [defaults.hubUrl, defaults.vwrUrl],
+    };
+};
+//# sourceMappingURL=vwrConfig.js.map

package/dist/vwrConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vwrConfig.js","sourceRoot":"","sources":["../src/vwrConfig.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@volley/vwr-loader",
+  "version": "1.0.0-alpha.1",
+  "type": "module",
+  "description": "Vite-based VWR loader for all Volley platforms",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./amplitudeFlagFetcher": "./dist/amplitudeFlagFetcher.js",
+    "./getDeviceId": "./dist/getDeviceId.js",
+    "./getShellVersion": "./dist/getShellVersion.js",
+    "./envDefaults": "./dist/envDefaults.js"
+  },
+  "bin": {
+    "build-loader": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc && vite build && vite build -c vite.cli.config.ts && chmod +x dist/cli.js",
+    "build:cli": "vite build -c vite.cli.config.ts",
+    "build:loader": "vite build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "format": "eslint . --fix",
+    "lint": "eslint .",
+    "semantic-release": "semantic-release"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "dotenv": "^16.0.0",
+    "fs-extra": "^11.0.0",
+    "tsx": "^4.7.0",
+    "vite": "^5.0.0"
+  },
+  "devDependencies": {
+    "@platform/eslint-config": "workspace:*",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^12.0.1",
+    "@types/fs-extra": "^11.0.0",
+    "@types/node": "^20.0.0",
+    "eslint": "^9.25.1",
+    "jsdom": "^24.1.3",
+    "prettier": "~3.0.3",
+    "semantic-release": "^24.2.3",
+    "semantic-release-monorepo": "^8.0.2",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  }
+}

package/src/amplitudeFlagFetcher.test.ts

@@ -0,0 +1,209 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
+
+import { fetchAmplitudeFlags } from "./amplitudeFlagFetcher"
+import * as getShellVersionModule from "./getShellVersion"
+
+describe("fetchAmplitudeFlags", () => {
+    const mockFetch = vi.fn()
+    const originalLocation = window.location
+
+    beforeEach(() => {
+        global.fetch = mockFetch
+        vi.clearAllMocks()
+
+        // Mock window.location for getShellVersion
+        delete (window as any).location
+        window.location = {
+            ...originalLocation,
+            href: "http://localhost:3000/?version=1.0.0",
+        } as Location
+    })
+
+    afterEach(() => {
+        window.location = originalLocation
+        vi.restoreAllMocks()
+    })
+
+    it("fetches flags successfully from Amplitude with context", async () => {
+        // Mock getShellVersion to return expected version for SAMSUNG_TV
+        vi.spyOn(getShellVersionModule, "getShellVersion").mockResolvedValue(
+            "1.0.0"
+        )
+
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                "vwr-enabled": {
+                    payload: {
+                        "vwr-enabled": true,
+                    },
+                },
+            }),
+        })
+
+        const result = await fetchAmplitudeFlags("device-123", "SAMSUNG_TV", {
+            apiKey: "test-key",
+        })
+
+        expect(result).toEqual({
+            "vwr-enabled": true,
+        })
+
+        // Verify context is included in the request
+        const callArgs = mockFetch.mock.calls[0]
+        const url = new URL(callArgs[0])
+        const context = JSON.parse(url.searchParams.get("context") || "{}")
+
+        expect(context).toEqual({
+            user_properties: {
+                platformEnum: "SAMSUNG_TV",
+                nativeShellAppVersion: "1.0.0",
+            },
+        })
+
+        expect(mockFetch).toHaveBeenCalledWith(
+            expect.stringContaining("user_id=device-123"),
+            expect.objectContaining({
+                method: "GET",
+                headers: { Authorization: "Api-Key test-key" },
+            })
+        )
+    })
+
+    it("includes provided shell version in context", async () => {
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                "vwr-enabled": {
+                    payload: {
+                        "vwr-enabled": true,
+                    },
+                },
+            }),
+        })
+
+        await fetchAmplitudeFlags(
+            "device-123",
+            "SAMSUNG_TV",
+            {
+                apiKey: "test-key",
+            },
+            "2.5.0"
+        )
+
+        const callArgs = mockFetch.mock.calls[0]
+        const url = new URL(callArgs[0])
+        const context = JSON.parse(url.searchParams.get("context") || "{}")
+
+        expect(context).toEqual({
+            user_properties: {
+                platformEnum: "SAMSUNG_TV",
+                nativeShellAppVersion: "2.5.0",
+            },
+        })
+    })
+
+    it("auto-fetches shell version when not provided", async () => {
+        const getShellVersionSpy = vi.spyOn(
+            getShellVersionModule,
+            "getShellVersion"
+        )
+
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                "vwr-enabled": {
+                    payload: {
+                        "vwr-enabled": false,
+                    },
+                },
+            }),
+        })
+
+        await fetchAmplitudeFlags("device-456", "LG_TV", {
+            apiKey: "test-key",
+        })
+
+        expect(getShellVersionSpy).toHaveBeenCalledWith("LG_TV")
+
+        const callArgs = mockFetch.mock.calls[0]
+        const url = new URL(callArgs[0])
+        const context = JSON.parse(url.searchParams.get("context") || "{}")
+
+        expect(context.user_properties).toHaveProperty("nativeShellAppVersion")
+    })
+
+    it("returns safe defaults on timeout", async () => {
+        mockFetch.mockImplementationOnce(
+            () => new Promise((resolve) => setTimeout(resolve, 3000))
+        )
+
+        const result = await fetchAmplitudeFlags("device-123", "FIRE_TV", {
+            apiKey: "test-key",
+            timeout: 100,
+        })
+
+        expect(result).toEqual({
+            "vwr-enabled": false,
+        })
+    })
+
+    it("returns safe defaults on API error", async () => {
+        mockFetch.mockResolvedValueOnce({
+            ok: false,
+            status: 500,
+        })
+
+        const result = await fetchAmplitudeFlags("device-123", "MOBILE", {
+            apiKey: "test-key",
+        })
+
+        expect(result).toEqual({
+            "vwr-enabled": false,
+        })
+    })
+
+    it("returns safe defaults on network error", async () => {
+        mockFetch.mockRejectedValueOnce(new Error("Network error"))
+
+        const result = await fetchAmplitudeFlags("device-123", "MOBILE", {
+            apiKey: "test-key",
+        })
+
+        expect(result).toEqual({
+            "vwr-enabled": false,
+        })
+    })
+
+    it("handles missing flag values in response", async () => {
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({}),
+        })
+
+        const result = await fetchAmplitudeFlags("device-123", "LG_TV", {
+            apiKey: "test-key",
+        })
+
+        expect(result).toEqual({
+            "vwr-enabled": false,
+        })
+    })
+
+    it("handles partial response with missing payload", async () => {
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: async () => ({
+                "vwr-enabled": {},
+            }),
+        })
+
+        const result = await fetchAmplitudeFlags("device-123", "LG_TV", {
+            apiKey: "test-key",
+        })
+
+        expect(result).toEqual({
+            "vwr-enabled": false,
+        })
+    })
+})

package/src/amplitudeFlagFetcher.ts

@@ -0,0 +1,88 @@
+import { getShellVersion } from "./getShellVersion"
+
+export interface AmplitudeConfig {
+    apiKey: string
+    apiUrl?: string
+    timeout?: number
+}
+
+export interface FlagResult {
+    "vwr-enabled": boolean
+}
+
+/**
+ * Fetch feature flags from Amplitude Experiment REST API.
+ *
+ * Uses GET method with query parameters and Authorization header.
+ * Includes platform and shell version in context for better flag targeting.
+ * Compatible with Chrome 66+ (Fetch API, async/await, AbortController).
+ *
+ * @param deviceId - Unique device identifier
+ * @param platform - Platform name (samsung, lg, firetv, ios, android)
+ * @param config - Amplitude configuration
+ * @param shellVersion - Optional shell version (if not provided, will be fetched automatically)
+ * @returns Flag values with safe defaults on error
+ */
+export async function fetchAmplitudeFlags(
+    deviceId: string,
+    platform: string,
+    config: AmplitudeConfig,
+    shellVersion?: string
+): Promise<FlagResult> {
+    const {
+        apiKey,
+        apiUrl = "https://api.lab.amplitude.com/v1/vardata",
+        timeout = 2000,
+    } = config
+
+    const controller = new AbortController()
+    const timeoutId = setTimeout(() => controller.abort(), timeout)
+
+    try {
+        // Get shell version if not provided
+        const version = shellVersion ?? (await getShellVersion(platform))
+
+        // Build context with user_properties
+        const context = {
+            user_properties: {
+                platformEnum: platform,
+                nativeShellAppVersion: version,
+            },
+        }
+
+        // Build query parameters
+        const params = new URLSearchParams({
+            user_id: deviceId,
+            flag_keys: "vwr-enabled",
+            context: JSON.stringify(context),
+        })
+
+        const response = await fetch(`${apiUrl}?${params}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Api-Key ${apiKey}`,
+            },
+            signal: controller.signal,
+        })
+
+        clearTimeout(timeoutId)
+
+        if (!response.ok) {
+            throw new Error(`Amplitude API returned ${response.status}`)
+        }
+
+        const data = await response.json()
+
+        return {
+            "vwr-enabled":
+                data["vwr-enabled"]?.payload?.["vwr-enabled"] ?? false,
+        }
+    } catch (error) {
+        console.error("[Shell] Amplitude flag fetch failed:", error)
+
+        // Return safe defaults - runs legacy path
+        return {
+            "vwr-enabled": false,
+        }
+    }
+}

package/src/envDefaults.ts

@@ -0,0 +1,45 @@
+export interface EnvConfig {
+    hubUrl: string
+    vwrUrl: string
+    configUrl: string
+    configFile: string
+    amplitudeKey: string // Used for amplitude flag fetch, not part of VWRConfig
+}
+
+const CONFIG_URL_DEFAULT = "https://vwr.volley.tv/config/"
+const CONFIG_FILE_DEFAULT = "vwrConfig.json"
+const VWR_URL_PATH_DEFAULT = "v1/latest/vwr.js"
+
+const prodConfig: EnvConfig = {
+    hubUrl: "https://game-clients.volley.tv/hub",
+    vwrUrl: `https://vwr.volley.tv/${VWR_URL_PATH_DEFAULT}`,
+    configUrl: CONFIG_URL_DEFAULT,
+    configFile: CONFIG_FILE_DEFAULT,
+    amplitudeKey: "",
+}
+
+export const ENV_DEFAULTS: Record<string, EnvConfig> = {
+    local: {
+        hubUrl: "http://localhost:5173",
+        vwrUrl: "http://localhost:5174/vwr.js",
+        configUrl: "http://localhost:5174/config/",
+        configFile: CONFIG_FILE_DEFAULT,
+        amplitudeKey: "client-uJJVW3zKPC1G9kqPhUumLnZN6eaY42iQ",
+    },
+    dev: {
+        hubUrl: "https://game-clients-dev.volley.tv/hub",
+        vwrUrl: `https://vwr.volley.tv/dev/${VWR_URL_PATH_DEFAULT}`,
+        configUrl: CONFIG_URL_DEFAULT,
+        configFile: CONFIG_FILE_DEFAULT,
+        amplitudeKey: "client-uJJVW3zKPC1G9kqPhUumLnZN6eaY42iQ",
+    },
+    staging: {
+        hubUrl: "https://game-clients-staging.volley.tv/hub",
+        vwrUrl: `https://vwr.volley.tv/staging/${VWR_URL_PATH_DEFAULT}`,
+        configUrl: CONFIG_URL_DEFAULT,
+        configFile: CONFIG_FILE_DEFAULT,
+        amplitudeKey: "",
+    },
+    prod: prodConfig,
+    production: prodConfig, // Alias for prod
+}