@volley/vwr-loader 1.0.0-alpha.1

package/README.md

@@ -0,0 +1,205 @@
+# @volley/vwr-loader
+
+VWR (Volley Web Runtime) loader for Volley TV platform shells (Samsung, LG, Fire TV, etc.).
+
+## Features
+
+- **Amplitude Flag Fetching**: Fetch feature flags from Amplitude Experiment REST API
+- **Chrome 66+ Compatible**: Uses modern browser APIs (Fetch API, async/await, AbortController)
+- **Safe Defaults**: Returns fallback values on error to ensure graceful degradation
+- **Shell Loader Template**: HTML template for shell initialization with VWR integration
+- **Device ID Resolution**: Cross-platform device ID handling
+
+## Installation
+
+```bash
+pnpm add @volley/vwr-loader
+```
+
+## Usage
+
+### CLI Build (Recommended)
+
+You can build the loader for a specific platform and environment using the CLI. This is useful for native shells (iOS, Android, FireTV, Samsung, LG) and CI/CD pipelines.
+
+```bash
+# Using npx (if installed globally or in project)
+npx build-loader --platform IOS_MOBILE --env dev --output ./dist-ios
+
+# Or via pnpm
+pnpm build-loader --platform IOS_MOBILE --env dev --output ./dist-ios
+```
+
+**Options:**
+
+- `--platform`: Target platform (`IOS_MOBILE`, `ANDROID_MOBILE`, `FIRE_TV`, `SAMSUNG_TV`, `LG_TV`, `WEB`)
+- `--env`: Environment (`local`, `dev`, `staging`, `prod`)
+- `--output`: Output directory for `index.html` and `main.js`
+- `--hubUrl`: Override Hub URL (optional)
+- `--vwrUrl`: Override VWR URL (optional)
+- `--amplitudeKey`: Override Amplitude deployment key (optional)
+
+### Fetching Amplitude Flags
+
+```typescript
+import { fetchAmplitudeFlags } from '@volley/vwr-loader'
+
+const flags = await fetchAmplitudeFlags(
+  'device-id-123',
+  'samsung',
+  {
+    apiKey: 'your-amplitude-api-key',
+    timeout: 2000
+  }
+)
+
+console.log(flags['vwr-enabled']) // boolean
+console.log(flags['vwr-url'])     // string
+```
+
+### Using the VWR Loader Template
+
+The package includes a `vwr-loader.html` template that can be used as the entry point for platform shells. The template:
+
+1. Fetches feature flags from Amplitude
+2. Conditionally loads VWR (Volley Web Runtime) or falls back to legacy Hub
+3. Handles device ID resolution across platforms
+4. Validates that build-time config was properly injected
+
+**Build-time placeholders** (must be replaced during build):
+- `__PLATFORM__` - Platform name (samsung-tv, lg-tv, firetv, etc.)
+- `__AMPLITUDE_KEY__` - Amplitude deployment key
+- `__HUB_URL__` - Hub application URL
+- `__VWR_URL__` - Default VWR bundle URL
+
+## Development Commands
+
+```bash
+# Run tests
+pnpm test
+
+# Type checking
+pnpm typecheck
+
+# Build
+pnpm build
+
+# Lint
+pnpm lint
+```
+
+## Browser Compatibility
+
+Requires Chrome 66+ or equivalent browser with support for:
+- Fetch API
+- async/await
+- AbortController
+- crypto.randomUUID (for fallback device ID generation)
+
+## API Reference
+
+### `fetchAmplitudeFlags(deviceId, platform, config)`
+
+Fetches feature flags from Amplitude Experiment using GET method with query parameters.
+
+**Parameters:**
+- `deviceId` (string): Unique device identifier
+- `platform` (string): Platform name (samsung-tv, lg-tv, firetv, ios, android)
+- `config` (AmplitudeConfig):
+  - `apiKey` (string): Amplitude API key (client-side key starting with "client-")
+  - `apiUrl` (string, optional): API endpoint (defaults to Amplitude production)
+  - `timeout` (number, optional): Request timeout in ms (defaults to 2000)
+
+**Returns:** `Promise<FlagResult>`
+- `vwr-enabled` (boolean): Whether VWR should be loaded
+- `vwr-url` (string): VWR bundle URL to load
+
+**Error Handling:**
+Returns safe defaults on error:
+```typescript
+{
+  'vwr-enabled': false,
+  'vwr-url': 'https://vwr.volley.tv/v1/vwr.js'
+}
+```
+
+## VWR Configuration System
+
+The vwr-loader fetches configuration from S3 with a priority-based fallback system. This enables device-specific, shell-version-specific, or environment-specific configurations without rebuilding shells.
+
+### Configuration Schema
+
+```typescript
+type VWRConfig = {
+    hubUrl: string              // URL to the Hub application
+    vwrUrl: string              // URL to the VWR runtime JavaScript file
+    launchUrl: string | undefined  // Optional launch URL (defaults to hubUrl)
+    trustedDomains: Array<string>  // List of trusted domains for iframe communication
+    amplitudeKey: string        // Amplitude API key for analytics
+}
+```
+
+### Configuration Priority
+
+The loader tries to fetch configs in this order (first successful fetch wins):
+
+1. **Local config** (development only): `http://localhost:5174/vwrConfig.json`
+2. **Device-specific config**: `{configUrl}/device/{platform}/{deviceId}/vwrConfig.json`
+3. **Shell version config**: `{configUrl}/shellVersion/{environment}/{platform}/{shellVersion}/vwrConfig.json`
+4. **Environment config**: `{configUrl}/environments/{environment}/vwrConfig.json`
+5. **Fallback defaults**: Built-in defaults from `envDefaults.ts`
+
+Where `configUrl` defaults to: `https://vwr.volley.tv/config/`
+
+### S3 Bucket Structure
+
+```
+s3://volley-vwr/config/
+├── environments/
+│   ├── dev/
+│   │   └── vwrConfig.json
+│   ├── staging/
+│   │   └── vwrConfig.json
+│   └── prod/
+│       └── vwrConfig.json
+├── device/
+│   ├── SAMSUNG_TV/
+│   │   └── {deviceId}/
+│   │       └── vwrConfig.json
+│   ├── LG_TV/
+│   ├── FIRE_TV/
+│   └── WEB/
+└── shellVersion/
+    └── {environment}/
+        └── {platform}/
+            └── {version}/
+                └── vwrConfig.json
+```
+
+### Fetching Config in Shells
+
+```typescript
+import { getVWRConfig } from '@volley/vwr-loader'
+
+const vwrConfig = await getVWRConfig({
+    configUrl: 'https://vwr.volley.tv/config/',
+    configFile: 'vwrConfig.json',
+    platform: 'SAMSUNG_TV',
+    deviceId: 'DEVICE123',
+    environment: 'prod',
+    shellVersion: '1.0.0',
+    timeout: 2000  // optional, defaults to 2000ms
+})
+```
+
+### Default Values
+
+If all config fetches fail, the loader falls back to built-in defaults per environment. See `src/envDefaults.ts` for current values.
+
+### Operations
+
+For S3 config management (uploading, deleting, cache invalidation), see [VWR S3 Config Operations](../../docs/VWR_S3_CONFIG_OPERATIONS.md).
+
+## License
+
+Proprietary - Volley Inc.

package/dist/amplitudeFlagFetcher.d.ts

@@ -0,0 +1,23 @@
+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 declare function fetchAmplitudeFlags(deviceId: string, platform: string, config: AmplitudeConfig, shellVersion?: string): Promise<FlagResult>;
+//# sourceMappingURL=amplitudeFlagFetcher.d.ts.map

package/dist/amplitudeFlagFetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amplitudeFlagFetcher.d.ts","sourceRoot":"","sources":["../src/amplitudeFlagFetcher.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,aAAa,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,YAAY,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,UAAU,CAAC,CAyDrB"}

package/dist/amplitudeFlagFetcher.js

@@ -0,0 +1,60 @@
+import { getShellVersion } from "./getShellVersion";
+/**
+ * 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, platform, config, shellVersion) {
+    var _a, _b, _c;
+    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 !== null && shellVersion !== void 0 ? 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": (_c = (_b = (_a = data["vwr-enabled"]) === null || _a === void 0 ? void 0 : _a.payload) === null || _b === void 0 ? void 0 : _b["vwr-enabled"]) !== null && _c !== void 0 ? _c : false,
+        };
+    }
+    catch (error) {
+        console.error("[Shell] Amplitude flag fetch failed:", error);
+        // Return safe defaults - runs legacy path
+        return {
+            "vwr-enabled": false,
+        };
+    }
+}
+//# sourceMappingURL=amplitudeFlagFetcher.js.map

package/dist/amplitudeFlagFetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amplitudeFlagFetcher.js","sourceRoot":"","sources":["../src/amplitudeFlagFetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAYnD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,QAAgB,EAChB,QAAgB,EAChB,MAAuB,EACvB,YAAqB;;IAErB,MAAM,EACF,MAAM,EACN,MAAM,GAAG,0CAA0C,EACnD,OAAO,GAAG,IAAI,GACjB,GAAG,MAAM,CAAA;IAEV,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAA;IAE/D,IAAI,CAAC;QACD,oCAAoC;QACpC,MAAM,OAAO,GAAG,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,CAAC,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAA;QAEjE,qCAAqC;QACrC,MAAM,OAAO,GAAG;YACZ,eAAe,EAAE;gBACb,YAAY,EAAE,QAAQ;gBACtB,qBAAqB,EAAE,OAAO;aACjC;SACJ,CAAA;QAED,yBAAyB;QACzB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YAC/B,OAAO,EAAE,QAAQ;YACjB,SAAS,EAAE,aAAa;YACxB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SACnC,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,EAAE;YAChD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACL,aAAa,EAAE,WAAW,MAAM,EAAE;aACrC;YACD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC5B,CAAC,CAAA;QAEF,YAAY,CAAC,SAAS,CAAC,CAAA;QAEvB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAElC,OAAO;YACH,aAAa,EACT,MAAA,MAAA,MAAA,IAAI,CAAC,aAAa,CAAC,0CAAE,OAAO,0CAAG,aAAa,CAAC,mCAAI,KAAK;SAC7D,CAAA;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAA;QAE5D,0CAA0C;QAC1C,OAAO;YACH,aAAa,EAAE,KAAK;SACvB,CAAA;IACL,CAAC;AACL,CAAC"}

package/dist/cli.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { config as config$1 } from "dotenv";
+import fs from "fs-extra";
+import path from "path";
+import os from "os";
+import { fileURLToPath } from "url";
+import { build } from "vite";
+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 = {
+  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: ""
+};
+const ENV_DEFAULTS = {
+  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
+};
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const cliPackageJson = JSON.parse(
+  fs.readFileSync(path.join(__dirname, "../package.json"), "utf-8")
+);
+const VALID_PLATFORMS = [
+  "FIRE_TV",
+  "ANDROID_MOBILE",
+  "IOS_MOBILE",
+  "SAMSUNG_TV",
+  "LG_TV",
+  "WEB"
+];
+const program = new Command();
+program.name("build-loader").version(cliPackageJson.version).description("Build vwr-loader with environment configuration").requiredOption(
+  "--platform <platform>",
+  "Platform: FIRE_TV, ANDROID_MOBILE, IOS_MOBILE, SAMSUNG_TV, LG_TV, WEB"
+).requiredOption("--env <env>", "Environment: local, dev, staging, prod").requiredOption("--output <path>", "Output directory").option("--hubUrl <url>", "Override Hub URL").option("--amplitudeKey <key>", "Override Amplitude deployment key").option("--vwrUrl <url>", "Override VWR URL").option("--configUrl <url>", "Override VWR Config URL").option("--configFile <filename>", "Override VWR Config Filename").option("--launchUrl <url>", "Override launch url").parse();
+const opts = program.opts();
+const normalizedPlatform = opts.platform.toUpperCase();
+if (!VALID_PLATFORMS.includes(normalizedPlatform)) {
+  console.error(`❌ Unknown platform: ${opts.platform}`);
+  console.error(`   Valid: ${VALID_PLATFORMS.join(", ")}`);
+  process.exit(1);
+}
+opts.platform = normalizedPlatform;
+const envFile = path.join(process.cwd(), `.env.${opts.env}`);
+let shellEnv = {};
+if (fs.existsSync(envFile)) {
+  console.log(`📄 Reading config from ${envFile}`);
+  const result = config$1({ path: envFile });
+  shellEnv = result.parsed || {};
+} else {
+  console.log(`ℹ️  No .env.${opts.env} found, using defaults/CLI flags`);
+}
+let shellVersion = "unknown";
+const packageJsonPath = path.join(process.cwd(), "package.json");
+if (fs.existsSync(packageJsonPath)) {
+  try {
+    const packageJson = JSON.parse(
+      fs.readFileSync(packageJsonPath, "utf-8")
+    );
+    shellVersion = packageJson.version || "unknown";
+  } catch {
+    console.warn(`⚠️  Could not read version from package.json`);
+  }
+}
+const envDefaults = ENV_DEFAULTS[opts.env];
+if (!envDefaults) {
+  console.error(`❌ Unknown environment: ${opts.env}`);
+  console.error(`   Valid: local, dev, staging, prod`);
+  process.exit(1);
+}
+const config = {
+  VITE_PLATFORM: opts.platform,
+  VITE_HUB_URL: opts.hubUrl || shellEnv.VITE_HUB_URL || envDefaults.hubUrl,
+  VITE_AMPLITUDE_DEPLOYMENT_KEY: opts.amplitudeKey || shellEnv.VITE_AMPLITUDE_DEPLOYMENT_KEY || envDefaults.amplitudeKey || "",
+  VITE_VWR_URL: opts.vwrUrl || shellEnv.VITE_VWR_URL || envDefaults.vwrUrl || "https://vwr.volley.tv/v1/latest/vwr.js",
+  VITE_CONFIG_URL: opts.configUrl || shellEnv.VITE_CONFIG_URL || envDefaults.configUrl,
+  VITE_CONFIG_FILE: opts.configFile || shellEnv.VITE_CONFIG_FILE || envDefaults.configFile,
+  VITE_LAUNCH_URL: opts.launchUrl || shellEnv.VITE_LAUNCH_URL || opts.hubUrl || shellEnv.VITE_HUB_URL || envDefaults.hubUrl
+};
+console.log("🔧 Build configuration:");
+console.log(`   Platform: ${config.VITE_PLATFORM}`);
+console.log(`   Hub URL: ${config.VITE_HUB_URL}`);
+console.log(`   VWR URL: ${config.VITE_VWR_URL}`);
+if (config.VITE_AMPLITUDE_DEPLOYMENT_KEY) {
+  console.log(`   Amplitude: ***`);
+} else {
+  console.warn(`   Amplitude: (not set)`);
+  console.warn(
+    `   ⚠️  VWR flag fetching will use safe defaults (vwr-enabled: false)`
+  );
+}
+const loaderSrcDir = path.join(__dirname, "../src");
+const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "vwr-loader-"));
+const loaderDistDir = tmpDir;
+try {
+  console.log(`⏳ Building loader...`);
+  await build({
+    configFile: false,
+    root: loaderSrcDir,
+    mode: opts.env,
+    logLevel: "warn",
+    build: {
+      outDir: loaderDistDir,
+      emptyOutDir: true,
+      target: "es2017",
+      minify: opts.env === "prod" ? "esbuild" : false,
+      sourcemap: true,
+      rollupOptions: {
+        input: {
+          main: path.join(loaderSrcDir, "index.html")
+        },
+        output: {
+          entryFileNames: "[name].js",
+          assetFileNames: "[name].[ext]"
+        }
+      }
+    },
+    define: {
+      "import.meta.env.VITE_ENVIRONMENT": JSON.stringify(opts.env),
+      "import.meta.env.VITE_PLATFORM": JSON.stringify(config.VITE_PLATFORM),
+      "import.meta.env.VITE_SHELL_VERSION": JSON.stringify(shellVersion),
+      "import.meta.env.VITE_HUB_URL": JSON.stringify(config.VITE_HUB_URL),
+      "import.meta.env.VITE_AMPLITUDE_DEPLOYMENT_KEY": JSON.stringify(
+        config.VITE_AMPLITUDE_DEPLOYMENT_KEY
+      ),
+      "import.meta.env.VITE_VWR_URL": JSON.stringify(config.VITE_VWR_URL),
+      "import.meta.env.VITE_CONFIG_URL": JSON.stringify(
+        config.VITE_CONFIG_URL
+      ),
+      "import.meta.env.VITE_CONFIG_FILE": JSON.stringify(
+        config.VITE_CONFIG_FILE
+      ),
+      "import.meta.env.VITE_LAUNCH_URL": JSON.stringify(
+        config.VITE_LAUNCH_URL
+      )
+    }
+  });
+  const outputPath = path.resolve(opts.output);
+  await fs.ensureDir(outputPath);
+  await fs.copy(loaderDistDir, outputPath, { overwrite: true });
+  console.log(`✅ VWR loader built successfully`);
+  console.log(`   Output: ${outputPath}`);
+  console.log(`   Files: index.html, main.js`);
+} finally {
+  try {
+    await fs.remove(tmpDir);
+  } catch (e) {
+    console.warn("⚠️ Failed to cleanup temp dir:", e);
+  }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/envDefaults.ts","../scripts/build.ts"],"sourcesContent":["export interface EnvConfig {\n    hubUrl: string\n    vwrUrl: string\n    configUrl: string\n    configFile: string\n    amplitudeKey: string // Used for amplitude flag fetch, not part of VWRConfig\n}\n\nconst CONFIG_URL_DEFAULT = \"https://vwr.volley.tv/config/\"\nconst CONFIG_FILE_DEFAULT = \"vwrConfig.json\"\nconst VWR_URL_PATH_DEFAULT = \"v1/latest/vwr.js\"\n\nconst prodConfig: EnvConfig = {\n    hubUrl: \"https://game-clients.volley.tv/hub\",\n    vwrUrl: `https://vwr.volley.tv/${VWR_URL_PATH_DEFAULT}`,\n    configUrl: CONFIG_URL_DEFAULT,\n    configFile: CONFIG_FILE_DEFAULT,\n    amplitudeKey: \"\",\n}\n\nexport const ENV_DEFAULTS: Record<string, EnvConfig> = {\n    local: {\n        hubUrl: \"http://localhost:5173\",\n        vwrUrl: \"http://localhost:5174/vwr.js\",\n        configUrl: \"http://localhost:5174/config/\",\n        configFile: CONFIG_FILE_DEFAULT,\n        amplitudeKey: \"client-uJJVW3zKPC1G9kqPhUumLnZN6eaY42iQ\",\n    },\n    dev: {\n        hubUrl: \"https://game-clients-dev.volley.tv/hub\",\n        vwrUrl: `https://vwr.volley.tv/dev/${VWR_URL_PATH_DEFAULT}`,\n        configUrl: CONFIG_URL_DEFAULT,\n        configFile: CONFIG_FILE_DEFAULT,\n        amplitudeKey: \"client-uJJVW3zKPC1G9kqPhUumLnZN6eaY42iQ\",\n    },\n    staging: {\n        hubUrl: \"https://game-clients-staging.volley.tv/hub\",\n        vwrUrl: `https://vwr.volley.tv/staging/${VWR_URL_PATH_DEFAULT}`,\n        configUrl: CONFIG_URL_DEFAULT,\n        configFile: CONFIG_FILE_DEFAULT,\n        amplitudeKey: \"\",\n    },\n    prod: prodConfig,\n    production: prodConfig, // Alias for prod\n}\n","import { Command } from \"commander\"\nimport { config as loadDotenv } from \"dotenv\"\nimport fs from \"fs-extra\"\nimport path from \"path\"\nimport os from \"os\"\nimport { fileURLToPath } from \"url\"\nimport { build } from \"vite\"\n\nimport { ENV_DEFAULTS } from \"../src/envDefaults.js\"\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\n\n// Read package version for --version flag\nconst cliPackageJson = JSON.parse(\n    fs.readFileSync(path.join(__dirname, \"../package.json\"), \"utf-8\")\n)\n\nconst VALID_PLATFORMS = [\n    \"FIRE_TV\",\n    \"ANDROID_MOBILE\",\n    \"IOS_MOBILE\",\n    \"SAMSUNG_TV\",\n    \"LG_TV\",\n    \"WEB\",\n]\n\nconst program = new Command()\n\nprogram\n    .name(\"build-loader\")\n    .version(cliPackageJson.version)\n    .description(\"Build vwr-loader with environment configuration\")\n    .requiredOption(\n        \"--platform <platform>\",\n        \"Platform: FIRE_TV, ANDROID_MOBILE, IOS_MOBILE, SAMSUNG_TV, LG_TV, WEB\"\n    )\n    .requiredOption(\"--env <env>\", \"Environment: local, dev, staging, prod\")\n    .requiredOption(\"--output <path>\", \"Output directory\")\n    .option(\"--hubUrl <url>\", \"Override Hub URL\")\n    .option(\"--amplitudeKey <key>\", \"Override Amplitude deployment key\")\n    .option(\"--vwrUrl <url>\", \"Override VWR URL\")\n    .option(\"--configUrl <url>\", \"Override VWR Config URL\")\n    .option(\"--configFile <filename>\", \"Override VWR Config Filename\")\n    .option(\"--launchUrl <url>\", \"Override launch url\")\n    .parse()\n\nconst opts = program.opts()\n\n// Validate platform\nconst normalizedPlatform = opts.platform.toUpperCase()\nif (!VALID_PLATFORMS.includes(normalizedPlatform)) {\n    console.error(`❌ Unknown platform: ${opts.platform}`)\n    console.error(`   Valid: ${VALID_PLATFORMS.join(\", \")}`)\n    process.exit(1)\n}\nopts.platform = normalizedPlatform\n\n// Try to read from shell's .env file (run from shell directory)\nconst envFile = path.join(process.cwd(), `.env.${opts.env}`)\nlet shellEnv: Record<string, string> = {}\n\nif (fs.existsSync(envFile)) {\n    console.log(`📄 Reading config from ${envFile}`)\n    const result = loadDotenv({ path: envFile })\n    shellEnv = result.parsed || {}\n} else {\n    console.log(`ℹ️  No .env.${opts.env} found, using defaults/CLI flags`)\n}\n\n// Read shell version from package.json (for web shell)\nlet shellVersion = \"unknown\"\nconst packageJsonPath = path.join(process.cwd(), \"package.json\")\nif (fs.existsSync(packageJsonPath)) {\n    try {\n        const packageJson = JSON.parse(\n            fs.readFileSync(packageJsonPath, \"utf-8\")\n        )\n        shellVersion = packageJson.version || \"unknown\"\n    } catch {\n        console.warn(`⚠️  Could not read version from package.json`)\n    }\n}\n\n// Get predefined defaults\nconst envDefaults = ENV_DEFAULTS[opts.env]\nif (!envDefaults) {\n    console.error(`❌ Unknown environment: ${opts.env}`)\n    console.error(`   Valid: local, dev, staging, prod`)\n    process.exit(1)\n}\n\n// Config precedence: CLI > shell .env > defaults\nconst config = {\n    VITE_PLATFORM: opts.platform,\n    VITE_HUB_URL: opts.hubUrl || shellEnv.VITE_HUB_URL || envDefaults.hubUrl,\n    VITE_AMPLITUDE_DEPLOYMENT_KEY:\n        opts.amplitudeKey ||\n        shellEnv.VITE_AMPLITUDE_DEPLOYMENT_KEY ||\n        envDefaults.amplitudeKey ||\n        \"\",\n    VITE_VWR_URL:\n        opts.vwrUrl ||\n        shellEnv.VITE_VWR_URL ||\n        envDefaults.vwrUrl ||\n        \"https://vwr.volley.tv/v1/latest/vwr.js\",\n    VITE_CONFIG_URL:\n        opts.configUrl || shellEnv.VITE_CONFIG_URL || envDefaults.configUrl,\n    VITE_CONFIG_FILE:\n        opts.configFile || shellEnv.VITE_CONFIG_FILE || envDefaults.configFile,\n    VITE_LAUNCH_URL:\n        opts.launchUrl ||\n        shellEnv.VITE_LAUNCH_URL ||\n        opts.hubUrl ||\n        shellEnv.VITE_HUB_URL ||\n        envDefaults.hubUrl,\n}\n\nconsole.log(\"🔧 Build configuration:\")\nconsole.log(`   Platform: ${config.VITE_PLATFORM}`)\nconsole.log(`   Hub URL: ${config.VITE_HUB_URL}`)\nconsole.log(`   VWR URL: ${config.VITE_VWR_URL}`)\nif (config.VITE_AMPLITUDE_DEPLOYMENT_KEY) {\n    console.log(`   Amplitude: ***`)\n} else {\n    console.warn(`   Amplitude: (not set)`)\n    console.warn(\n        `   ⚠️  VWR flag fetching will use safe defaults (vwr-enabled: false)`\n    )\n}\n\n// Build with Vite (inline config to avoid path resolution issues)\nconst loaderSrcDir = path.join(__dirname, \"../src\")\nconst tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), \"vwr-loader-\"))\nconst loaderDistDir = tmpDir\n\ntry {\n    console.log(`⏳ Building loader...`)\n    await build({\n        configFile: false,\n        root: loaderSrcDir,\n        mode: opts.env,\n        logLevel: \"warn\",\n        build: {\n            outDir: loaderDistDir,\n            emptyOutDir: true,\n            target: \"es2017\",\n            minify: opts.env === \"prod\" ? \"esbuild\" : false,\n            sourcemap: true,\n            rollupOptions: {\n                input: {\n                    main: path.join(loaderSrcDir, \"index.html\"),\n                },\n                output: {\n                    entryFileNames: \"[name].js\",\n                    assetFileNames: \"[name].[ext]\",\n                },\n            },\n        },\n        define: {\n            \"import.meta.env.VITE_ENVIRONMENT\": JSON.stringify(opts.env),\n            \"import.meta.env.VITE_PLATFORM\": JSON.stringify(config.VITE_PLATFORM),\n            \"import.meta.env.VITE_SHELL_VERSION\": JSON.stringify(shellVersion),\n            \"import.meta.env.VITE_HUB_URL\": JSON.stringify(config.VITE_HUB_URL),\n            \"import.meta.env.VITE_AMPLITUDE_DEPLOYMENT_KEY\": JSON.stringify(\n                config.VITE_AMPLITUDE_DEPLOYMENT_KEY\n            ),\n            \"import.meta.env.VITE_VWR_URL\": JSON.stringify(config.VITE_VWR_URL),\n            \"import.meta.env.VITE_CONFIG_URL\": JSON.stringify(\n                config.VITE_CONFIG_URL\n            ),\n            \"import.meta.env.VITE_CONFIG_FILE\": JSON.stringify(\n                config.VITE_CONFIG_FILE\n            ),\n            \"import.meta.env.VITE_LAUNCH_URL\": JSON.stringify(\n                config.VITE_LAUNCH_URL\n            ),\n        },\n    })\n\n    // Copy build output to specified directory\n    const outputPath = path.resolve(opts.output)\n\n    await fs.ensureDir(outputPath)\n    await fs.copy(loaderDistDir, outputPath, { overwrite: true })\n\n    console.log(`✅ VWR loader built successfully`)\n    console.log(`   Output: ${outputPath}`)\n    console.log(`   Files: index.html, main.js`)\n\n} finally {\n    // Cleanup temp dir\n    try {\n        await fs.remove(tmpDir)\n    } catch (e) {\n        console.warn(\"⚠️ Failed to cleanup temp dir:\", e)\n    }\n}\n"],"names":["loadDotenv"],"mappings":"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"}

package/dist/envDefaults.d.ts

@@ -0,0 +1,9 @@
+export interface EnvConfig {
+    hubUrl: string;
+    vwrUrl: string;
+    configUrl: string;
+    configFile: string;
+    amplitudeKey: string;
+}
+export declare const ENV_DEFAULTS: Record<string, EnvConfig>;
+//# sourceMappingURL=envDefaults.d.ts.map

package/dist/envDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envDefaults.d.ts","sourceRoot":"","sources":["../src/envDefaults.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACvB;AAcD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAwBlD,CAAA"}

package/dist/envDefaults.js

@@ -0,0 +1,36 @@
+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 = {
+    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 = {
+    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
+};
+//# sourceMappingURL=envDefaults.js.map

package/dist/envDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envDefaults.js","sourceRoot":"","sources":["../src/envDefaults.ts"],"names":[],"mappings":"AAQA,MAAM,kBAAkB,GAAG,+BAA+B,CAAA;AAC1D,MAAM,mBAAmB,GAAG,gBAAgB,CAAA;AAC5C,MAAM,oBAAoB,GAAG,kBAAkB,CAAA;AAE/C,MAAM,UAAU,GAAc;IAC1B,MAAM,EAAE,oCAAoC;IAC5C,MAAM,EAAE,yBAAyB,oBAAoB,EAAE;IACvD,SAAS,EAAE,kBAAkB;IAC7B,UAAU,EAAE,mBAAmB;IAC/B,YAAY,EAAE,EAAE;CACnB,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAA8B;IACnD,KAAK,EAAE;QACH,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,8BAA8B;QACtC,SAAS,EAAE,+BAA+B;QAC1C,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,yCAAyC;KAC1D;IACD,GAAG,EAAE;QACD,MAAM,EAAE,wCAAwC;QAChD,MAAM,EAAE,6BAA6B,oBAAoB,EAAE;QAC3D,SAAS,EAAE,kBAAkB;QAC7B,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,yCAAyC;KAC1D;IACD,OAAO,EAAE;QACL,MAAM,EAAE,4CAA4C;QACpD,MAAM,EAAE,iCAAiC,oBAAoB,EAAE;QAC/D,SAAS,EAAE,kBAAkB;QAC7B,UAAU,EAAE,mBAAmB;QAC/B,YAAY,EAAE,EAAE;KACnB;IACD,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,UAAU,EAAE,iBAAiB;CAC5C,CAAA"}

package/dist/getDeviceId.d.ts

@@ -0,0 +1,65 @@
+import { type Logger } from "./logger";
+/**
+ * Get a unique device identifier for the current platform.
+ *
+ * This function attempts to retrieve a device ID from platform-specific APIs.
+ *
+ * Platform handling:
+ * - FireTV: DeviceInfo (Capacitor plugin)
+ * - Android/iOS: NativeBridge
+ * - Samsung TV: webapis
+ * - LG TV: webOS Luna service
+ * - Web: localStorage (with generated UUID fallback)
+ *
+ * @param platform - Platform identifier ('FIRE_TV', 'SAMSUNG_TV', 'LG_TV', 'ANDROID_MOBILE', 'IOS_MOBILE', 'WEB')
+ * @param logger - Optional logger for error reporting. Defaults to defaultLogger.
+ * @returns A promise that resolves to a unique device identifier string, or null if retrieval fails
+ *
+ * @example
+ * ```typescript
+ * const deviceId = await getDeviceId('SAMSUNG_TV', logger)
+ * if (!deviceId) {
+ *   // Handle error
+ * }
+ * ```
+ */
+export declare function getDeviceId(platform: string, logger?: Logger): Promise<string | null>;
+interface LGDeviceIdResponse {
+    idList?: Array<{
+        idValue?: string;
+    }>;
+}
+declare global {
+    interface Window {
+        DeviceInfo?: {
+            getAndroidId: () => Promise<{
+                androidId: string;
+            }>;
+        };
+        NativeBridge?: {
+            getDeviceId: () => Promise<string>;
+        };
+        webapis?: {
+            productinfo?: {
+                getDuid: () => string;
+            };
+        };
+        webOS?: {
+            service?: {
+                request: (uri: string, options: {
+                    method?: string;
+                    parameters?: Record<string, unknown>;
+                    onSuccess?: (response: LGDeviceIdResponse) => void;
+                    onFailure?: (error: {
+                        errorText?: string;
+                    }) => void;
+                    subscribe?: boolean;
+                }) => {
+                    cancel: () => void;
+                };
+            };
+        };
+    }
+}
+export {};
+//# sourceMappingURL=getDeviceId.d.ts.map

package/dist/getDeviceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeviceId.d.ts","sourceRoot":"","sources":["../src/getDeviceId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAsB,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB;AA4JD,UAAU,kBAAkB;IACxB,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,OAAO,CAAC,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;CACL;AAGD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,UAAU,CAAC,EAAE;YACT,YAAY,EAAE,MAAM,OAAO,CAAC;gBAAE,SAAS,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SACrD,CAAA;QACD,YAAY,CAAC,EAAE;YACX,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;SACrC,CAAA;QACD,OAAO,CAAC,EAAE;YACN,WAAW,CAAC,EAAE;gBACV,OAAO,EAAE,MAAM,MAAM,CAAA;aACxB,CAAA;SACJ,CAAA;QACD,KAAK,CAAC,EAAE;YACJ,OAAO,CAAC,EAAE;gBACN,OAAO,EAAE,CACL,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;oBACL,MAAM,CAAC,EAAE,MAAM,CAAA;oBACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;oBACpC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;oBAClD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;wBAAE,SAAS,CAAC,EAAE,MAAM,CAAA;qBAAE,KAAK,IAAI,CAAA;oBACnD,SAAS,CAAC,EAAE,OAAO,CAAA;iBACtB,KACA;oBACD,MAAM,EAAE,MAAM,IAAI,CAAA;iBACrB,CAAA;aACJ,CAAA;SACJ,CAAA;KACJ;CACJ"}