@open-kingdom/shared-backend-integration-test-doubles 0.0.2-17 → 0.0.2-18

package/dist/youtube/youtube-error-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/youtube/youtube-error-mode.ts"],"sourcesContent":["/**\n * YouTube error mode simulation — pure state management.\n *\n * Design follows GcsErrorModeManager conventions:\n * - Single-mode constraint: only one mode active at a time.\n * - setMode() replaces any existing mode.\n * - reset() and clearMode() clear state to prevent leakage between tests.\n */\n\n// ─── Type Definitions ────────────────────────────────────────────────\n\nexport type YoutubeApiErrorModeType =\n  | 'daily-limit-exceeded'\n  | 'invalid-api-key'\n  | 'empty-results';\n\nexport type YoutubePlayerErrorCode = 2 | 5 | 100 | 101 | 150;\n\nexport type YoutubeErrorModeType =\n  | YoutubeApiErrorModeType\n  | `player-error-${YoutubePlayerErrorCode}`;\n\nexport interface YoutubeErrorModeConfig {\n  type: YoutubeErrorModeType;\n}\n\nexport interface YoutubeErrorSimulationResult {\n  status: number;\n  body: Record<string, unknown>;\n}\n\n// ─── Error Response Factories ─────────────────────────────────────────\n\nfunction youtubeApiError(\n  status: number,\n  message: string,\n  reason: string,\n  domain = 'usageLimits'\n): YoutubeErrorSimulationResult {\n  return {\n    status,\n    body: {\n      error: {\n        code: status,\n        message,\n        errors: [{ domain, reason, message }],\n      },\n    },\n  };\n}\n\nfunction emptySearchResponse(): YoutubeErrorSimulationResult {\n  return {\n    status: 200,\n    body: {\n      kind: 'youtube#searchListResponse',\n      etag: 'empty-etag',\n      regionCode: 'US',\n      pageInfo: { totalResults: 0, resultsPerPage: 0 },\n      items: [],\n    },\n  };\n}\n\n// ─── Manager ──────────────────────────────────────────────────────────\n\nexport class YoutubeErrorModeManager {\n  private activeMode: YoutubeErrorModeConfig | null = null;\n\n  setMode(config: YoutubeErrorModeConfig): void {\n    this.activeMode = config;\n  }\n\n  clearMode(): void {\n    this.activeMode = null;\n  }\n\n  getMode(): YoutubeErrorModeConfig | null {\n    return this.activeMode;\n  }\n\n  /**\n   * Check if the current mode is a player error mode.\n   * Returns the numeric error code, or null if not a player error.\n   */\n  getPlayerErrorCode(): number | null {\n    if (!this.activeMode) return null;\n    const match = this.activeMode.type.match(/^player-error-(\\d+)$/);\n    return match ? parseInt(match[1], 10) : null;\n  }\n\n  /**\n   * Match a search request against the active API error mode.\n   * Returns null for pass-through (no error, or player-only mode).\n   */\n  matchSearchRequest(): YoutubeErrorSimulationResult | null {\n    if (!this.activeMode) return null;\n\n    switch (this.activeMode.type) {\n      case 'daily-limit-exceeded':\n        return youtubeApiError(\n          403,\n          'Daily Limit Exceeded',\n          'dailyLimitExceeded'\n        );\n      case 'invalid-api-key':\n        return youtubeApiError(400, 'API key not valid', 'keyInvalid');\n      case 'empty-results':\n        return emptySearchResponse();\n      default:\n        // Player error modes don't affect the search endpoint\n        return null;\n    }\n  }\n\n  reset(): void {\n    this.activeMode = null;\n  }\n}\n"],"names":["youtubeApiError","status","message","reason","domain","body","error","code","errors","emptySearchResponse","kind","etag","regionCode","pageInfo","totalResults","resultsPerPage","items","YoutubeErrorModeManager","setMode","config","activeMode","clearMode","getMode","getPlayerErrorCode","match","type","parseInt","matchSearchRequest","reset"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"AAAA;;;;;;;CAOC,GAED,wEAAwE;AAsBxE,yEAAyE;AAEzE,SAASA,gBACPC,MAAc,EACdC,OAAe,EACfC,MAAc,EACdC,SAAS,aAAa;IAEtB,OAAO;QACLH;QACAI,MAAM;YACJC,OAAO;gBACLC,MAAMN;gBACNC;gBACAM,QAAQ;oBAAC;wBAAEJ;wBAAQD;wBAAQD;oBAAQ;iBAAE;YACvC;QACF;IACF;AACF;AAEA,SAASO;IACP,OAAO;QACLR,QAAQ;QACRI,MAAM;YACJK,MAAM;YACNC,MAAM;YACNC,YAAY;YACZC,UAAU;gBAAEC,cAAc;gBAAGC,gBAAgB;YAAE;YAC/CC,OAAO,EAAE;QACX;IACF;AACF;AAEA,yEAAyE;AAEzE,OAAO,MAAMC;IAGXC,QAAQC,MAA8B,EAAQ;QAC5C,IAAI,CAACC,UAAU,GAAGD;IACpB;IAEAE,YAAkB;QAChB,IAAI,CAACD,UAAU,GAAG;IACpB;IAEAE,UAAyC;QACvC,OAAO,IAAI,CAACF,UAAU;IACxB;IAEA;;;GAGC,GACDG,qBAAoC;QAClC,IAAI,CAAC,IAAI,CAACH,UAAU,EAAE,OAAO;QAC7B,MAAMI,QAAQ,IAAI,CAACJ,UAAU,CAACK,IAAI,CAACD,KAAK,CAAC;QACzC,OAAOA,QAAQE,SAASF,KAAK,CAAC,EAAE,EAAE,MAAM;IAC1C;IAEA;;;GAGC,GACDG,qBAA0D;QACxD,IAAI,CAAC,IAAI,CAACP,UAAU,EAAE,OAAO;QAE7B,OAAQ,IAAI,CAACA,UAAU,CAACK,IAAI;YAC1B,KAAK;gBACH,OAAOzB,gBACL,KACA,wBACA;YAEJ,KAAK;gBACH,OAAOA,gBAAgB,KAAK,qBAAqB;YACnD,KAAK;gBACH,OAAOS;YACT;gBACE,sDAAsD;gBACtD,OAAO;QACX;IACF;IAEAmB,QAAc;QACZ,IAAI,CAACR,UAAU,GAAG;IACpB;;aAlDQA,aAA4C;;AAmDtD"}

package/dist/youtube/youtube-twin.config.d.ts

@@ -0,0 +1,13 @@
+export interface YoutubeTwinConfig {
+    /** Port the YouTube twin Express server listens on */
+    port: number;
+    /** External URL consumers use to reach the twin */
+    externalUrl: string;
+    /** Path to the sample video file */
+    sampleVideoPath: string;
+    /** Path to the thumbnails directory */
+    thumbnailDir: string;
+}
+export declare const defaultYoutubeConfig: YoutubeTwinConfig;
+export declare function createYoutubeConfig(overrides?: Partial<YoutubeTwinConfig>): YoutubeTwinConfig;
+//# sourceMappingURL=youtube-twin.config.d.ts.map

package/dist/youtube/youtube-twin.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-twin.config.d.ts","sourceRoot":"","sources":["../../src/youtube/youtube-twin.config.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,oBAAoB,EAAE,iBAKlC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACzC,iBAAiB,CA8BnB"}

package/dist/youtube/youtube-twin.config.js

@@ -0,0 +1,32 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { ConfigService, nodeEnvAdapter } from '@open-kingdom/shared-poly-util-env-config';
+import { DEFAULT_PORTS, ENV_VARS, PORT_RANGE } from '../shared/constants.js';
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+// Resolved relative to dist/youtube/youtube-twin.config.js when packaged
+const defaultAssetDir = path.resolve(currentDir, '../../test-assets/youtube');
+export const defaultYoutubeConfig = {
+    port: DEFAULT_PORTS.YOUTUBE,
+    externalUrl: `http://localhost:${DEFAULT_PORTS.YOUTUBE}`,
+    sampleVideoPath: path.join(defaultAssetDir, 'sample.mp4'),
+    thumbnailDir: path.join(defaultAssetDir, 'thumbnails')
+};
+export function createYoutubeConfig(overrides = {}) {
+    const env = new ConfigService(nodeEnvAdapter);
+    const envPortVal = env.get(ENV_VARS.YOUTUBE_TWIN_PORT);
+    const envPort = envPortVal ? Number.parseInt(envPortVal, 10) : undefined;
+    const baseConfig = _extends({}, defaultYoutubeConfig, envPort !== undefined && !Number.isNaN(envPort) && {
+        port: envPort
+    });
+    const finalConfig = _extends({}, baseConfig, overrides);
+    if (finalConfig.port < PORT_RANGE.min || finalConfig.port > PORT_RANGE.max) {
+        throw new Error(`YouTube twin port ${finalConfig.port} is outside the reserved range ` + `${PORT_RANGE.min}–${PORT_RANGE.max}.`);
+    }
+    if (!overrides.externalUrl && finalConfig.externalUrl === defaultYoutubeConfig.externalUrl) {
+        finalConfig.externalUrl = `http://localhost:${finalConfig.port}`;
+    }
+    return finalConfig;
+}
+
+//# sourceMappingURL=youtube-twin.config.js.map

package/dist/youtube/youtube-twin.config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/youtube/youtube-twin.config.ts"],"sourcesContent":["import { fileURLToPath } from 'node:url';\nimport path from 'node:path';\nimport {\n  ConfigService,\n  nodeEnvAdapter,\n} from '@open-kingdom/shared-poly-util-env-config';\nimport { DEFAULT_PORTS, ENV_VARS, PORT_RANGE } from '../shared/constants.js';\n\nconst currentDir = path.dirname(fileURLToPath(import.meta.url));\n\n// Resolved relative to dist/youtube/youtube-twin.config.js when packaged\nconst defaultAssetDir = path.resolve(currentDir, '../../test-assets/youtube');\n\nexport interface YoutubeTwinConfig {\n  /** Port the YouTube twin Express server listens on */\n  port: number;\n  /** External URL consumers use to reach the twin */\n  externalUrl: string;\n  /** Path to the sample video file */\n  sampleVideoPath: string;\n  /** Path to the thumbnails directory */\n  thumbnailDir: string;\n}\n\nexport const defaultYoutubeConfig: YoutubeTwinConfig = {\n  port: DEFAULT_PORTS.YOUTUBE,\n  externalUrl: `http://localhost:${DEFAULT_PORTS.YOUTUBE}`,\n  sampleVideoPath: path.join(defaultAssetDir, 'sample.mp4'),\n  thumbnailDir: path.join(defaultAssetDir, 'thumbnails'),\n};\n\nexport function createYoutubeConfig(\n  overrides: Partial<YoutubeTwinConfig> = {}\n): YoutubeTwinConfig {\n  const env = new ConfigService(nodeEnvAdapter);\n  const envPortVal = env.get(ENV_VARS.YOUTUBE_TWIN_PORT);\n  const envPort = envPortVal ? Number.parseInt(envPortVal, 10) : undefined;\n\n  const baseConfig: YoutubeTwinConfig = {\n    ...defaultYoutubeConfig,\n    ...(envPort !== undefined && !Number.isNaN(envPort) && { port: envPort }),\n  };\n\n  const finalConfig: YoutubeTwinConfig = {\n    ...baseConfig,\n    ...overrides,\n  };\n\n  if (finalConfig.port < PORT_RANGE.min || finalConfig.port > PORT_RANGE.max) {\n    throw new Error(\n      `YouTube twin port ${finalConfig.port} is outside the reserved range ` +\n        `${PORT_RANGE.min}–${PORT_RANGE.max}.`\n    );\n  }\n\n  if (\n    !overrides.externalUrl &&\n    finalConfig.externalUrl === defaultYoutubeConfig.externalUrl\n  ) {\n    finalConfig.externalUrl = `http://localhost:${finalConfig.port}`;\n  }\n\n  return finalConfig;\n}\n"],"names":["fileURLToPath","path","ConfigService","nodeEnvAdapter","DEFAULT_PORTS","ENV_VARS","PORT_RANGE","currentDir","dirname","url","defaultAssetDir","resolve","defaultYoutubeConfig","port","YOUTUBE","externalUrl","sampleVideoPath","join","thumbnailDir","createYoutubeConfig","overrides","env","envPortVal","get","YOUTUBE_TWIN_PORT","envPort","Number","parseInt","undefined","baseConfig","isNaN","finalConfig","min","max","Error"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":";AAAA,SAASA,aAAa,QAAQ,WAAW;AACzC,OAAOC,UAAU,YAAY;AAC7B,SACEC,aAAa,EACbC,cAAc,QACT,4CAA4C;AACnD,SAASC,aAAa,EAAEC,QAAQ,EAAEC,UAAU,QAAQ,yBAAyB;AAE7E,MAAMC,aAAaN,KAAKO,OAAO,CAACR,cAAc,YAAYS,GAAG;AAE7D,yEAAyE;AACzE,MAAMC,kBAAkBT,KAAKU,OAAO,CAACJ,YAAY;AAajD,OAAO,MAAMK,uBAA0C;IACrDC,MAAMT,cAAcU,OAAO;IAC3BC,aAAa,CAAC,iBAAiB,EAAEX,cAAcU,OAAO,CAAC,CAAC;IACxDE,iBAAiBf,KAAKgB,IAAI,CAACP,iBAAiB;IAC5CQ,cAAcjB,KAAKgB,IAAI,CAACP,iBAAiB;AAC3C,EAAE;AAEF,OAAO,SAASS,oBACdC,YAAwC,CAAC,CAAC;IAE1C,MAAMC,MAAM,IAAInB,cAAcC;IAC9B,MAAMmB,aAAaD,IAAIE,GAAG,CAAClB,SAASmB,iBAAiB;IACrD,MAAMC,UAAUH,aAAaI,OAAOC,QAAQ,CAACL,YAAY,MAAMM;IAE/D,MAAMC,aAAgC,aACjCjB,sBACCa,YAAYG,aAAa,CAACF,OAAOI,KAAK,CAACL,YAAY;QAAEZ,MAAMY;IAAQ;IAGzE,MAAMM,cAAiC,aAClCF,YACAT;IAGL,IAAIW,YAAYlB,IAAI,GAAGP,WAAW0B,GAAG,IAAID,YAAYlB,IAAI,GAAGP,WAAW2B,GAAG,EAAE;QAC1E,MAAM,IAAIC,MACR,CAAC,kBAAkB,EAAEH,YAAYlB,IAAI,CAAC,+BAA+B,CAAC,GACpE,CAAC,EAAEP,WAAW0B,GAAG,CAAC,CAAC,EAAE1B,WAAW2B,GAAG,CAAC,CAAC,CAAC;IAE5C;IAEA,IACE,CAACb,UAAUL,WAAW,IACtBgB,YAAYhB,WAAW,KAAKH,qBAAqBG,WAAW,EAC5D;QACAgB,YAAYhB,WAAW,GAAG,CAAC,iBAAiB,EAAEgB,YAAYlB,IAAI,CAAC,CAAC;IAClE;IAEA,OAAOkB;AACT"}

package/dist/youtube/youtube-twin.d.ts

@@ -0,0 +1,14 @@
+import { YoutubeTwinConfig } from './youtube-twin.config.js';
+export declare class YoutubeTwin {
+    private readonly config;
+    private server;
+    private currentFixtures;
+    private readonly errorModeManager;
+    constructor(overrides?: Partial<YoutubeTwinConfig>);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    reset(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    getEmulatorHost(): string;
+}
+//# sourceMappingURL=youtube-twin.d.ts.map

package/dist/youtube/youtube-twin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-twin.d.ts","sourceRoot":"","sources":["../../src/youtube/youtube-twin.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAUlC,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiC;gBAEtD,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAK5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkHtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAarB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAenC,eAAe,IAAI,MAAM;CAG1B"}

package/dist/youtube/youtube-twin.js

@@ -0,0 +1,162 @@
+import path from 'node:path';
+import express from 'express';
+import cors from 'cors';
+import { createYoutubeConfig } from './youtube-twin.config.js';
+import { videoFixtures, searchFixtures } from './search-fixtures.js';
+import { formatSearchResponse } from './search-response.js';
+import { generatePlayerShim } from './player-shim.js';
+import { YoutubeErrorModeManager } from './youtube-error-mode.js';
+export class YoutubeTwin {
+    async start() {
+        if (this.server) return; // Already started
+        const app = express();
+        app.use(cors());
+        app.use(express.json());
+        // Serve static test assets (sample video and thumbnails)
+        const assetsDir = path.resolve(this.config.thumbnailDir, '..');
+        app.use('/test-assets', express.static(assetsDir));
+        // YouTube Data API — Search
+        app.get('/youtube/v3/search', (req, res)=>{
+            const errorResult = this.errorModeManager.matchSearchRequest();
+            if (errorResult) {
+                return res.status(errorResult.status).json(errorResult.body);
+            }
+            const { q = '', maxResults = '10', key } = req.query;
+            if (!key) {
+                return res.status(400).json({
+                    error: {
+                        code: 400,
+                        message: 'API key not valid. Please pass a valid API key.',
+                        errors: [
+                            {
+                                domain: 'usageLimits',
+                                reason: 'keyInvalid',
+                                message: 'API key not valid.'
+                            }
+                        ]
+                    }
+                });
+            }
+            const limit = Number.parseInt(maxResults, 10);
+            const results = searchFixtures(q, Number.isNaN(limit) ? 10 : limit, this.currentFixtures);
+            const response = formatSearchResponse(results, this.config.externalUrl, results.length);
+            return res.json(response);
+        });
+        // Test control: override fixtures at runtime
+        app.put('/test/youtube/fixtures', (req, res)=>{
+            var _req_body;
+            var _req_body_fixtures;
+            this.currentFixtures = (_req_body_fixtures = (_req_body = req.body) == null ? void 0 : _req_body.fixtures) != null ? _req_body_fixtures : [
+                ...videoFixtures
+            ];
+            res.json({
+                success: true,
+                count: this.currentFixtures.length
+            });
+        });
+        // Health check endpoint
+        app.get('/test/youtube/health', (_req, res)=>{
+            res.json({
+                status: 'ok'
+            });
+        });
+        // Reset endpoint
+        app.post('/test/youtube/reset', async (_req, res)=>{
+            await this.reset();
+            res.json({
+                success: true
+            });
+        });
+        // Error mode control endpoints
+        app.post('/test/youtube/error-mode', (req, res)=>{
+            const { mode } = req.body;
+            if (!mode) {
+                return res.status(400).json({
+                    error: 'Missing "mode" field'
+                });
+            }
+            this.errorModeManager.setMode({
+                type: mode
+            });
+            return res.json({
+                success: true,
+                mode
+            });
+        });
+        app.delete('/test/youtube/error-mode', (_req, res)=>{
+            this.errorModeManager.clearMode();
+            return res.json({
+                success: true,
+                mode: null
+            });
+        });
+        app.get('/test/youtube/error-mode', (_req, res)=>{
+            const mode = this.errorModeManager.getMode();
+            var _mode_type;
+            return res.json({
+                active: mode !== null,
+                mode: (_mode_type = mode == null ? void 0 : mode.type) != null ? _mode_type : null
+            });
+        });
+        // Serve YouTube IFrame Player API Shim JS
+        const shimJs = generatePlayerShim(this.config.externalUrl);
+        app.get('/iframe_api', (_req, res)=>{
+            res.type('application/javascript').send(shimJs);
+        });
+        app.get('/shim/youtube-player.js', (_req, res)=>{
+            res.type('application/javascript').send(shimJs);
+        });
+        return new Promise((resolve, reject)=>{
+            this.server = app.listen(this.config.port, ()=>{
+                console.log(`[YoutubeTwin] Express server listening on port ${this.config.port}`);
+                resolve();
+            });
+            this.server.on('error', reject);
+        });
+    }
+    async stop() {
+        const server = this.server;
+        if (!server) return;
+        return new Promise((resolve, reject)=>{
+            server.close((err)=>{
+                if (err) return reject(err);
+                this.server = null;
+                console.log('[YoutubeTwin] Express server stopped');
+                resolve();
+            });
+        });
+    }
+    async reset() {
+        this.errorModeManager.reset();
+        this.currentFixtures = [
+            ...videoFixtures
+        ];
+    }
+    async isHealthy() {
+        try {
+            const res = await fetch(`${this.config.externalUrl}/test/youtube/health`, {
+                headers: {
+                    Connection: 'close'
+                }
+            });
+            await res.text(); // Consume body to release socket
+            return res.ok;
+        } catch (e) {
+            return false;
+        }
+    }
+    getEmulatorHost() {
+        return this.config.externalUrl;
+    }
+    constructor(overrides){
+        this.server = null;
+        this.currentFixtures = [];
+        this.errorModeManager = new YoutubeErrorModeManager();
+        this.config = createYoutubeConfig(overrides);
+        this.currentFixtures = [
+            ...videoFixtures
+        ];
+    }
+}
+
+//# sourceMappingURL=youtube-twin.js.map

package/dist/youtube/youtube-twin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/youtube/youtube-twin.ts"],"sourcesContent":["import http from 'node:http';\nimport path from 'node:path';\nimport express, { Request, Response } from 'express';\nimport cors from 'cors';\nimport {\n  createYoutubeConfig,\n  YoutubeTwinConfig,\n} from './youtube-twin.config.js';\nimport {\n  VideoFixture,\n  videoFixtures,\n  searchFixtures,\n} from './search-fixtures.js';\nimport { formatSearchResponse } from './search-response.js';\nimport { generatePlayerShim } from './player-shim.js';\nimport { YoutubeErrorModeManager } from './youtube-error-mode.js';\n\nexport class YoutubeTwin {\n  private readonly config: YoutubeTwinConfig;\n  private server: http.Server | null = null;\n  private currentFixtures: VideoFixture[] = [];\n  private readonly errorModeManager = new YoutubeErrorModeManager();\n\n  constructor(overrides?: Partial<YoutubeTwinConfig>) {\n    this.config = createYoutubeConfig(overrides);\n    this.currentFixtures = [...videoFixtures];\n  }\n\n  async start(): Promise<void> {\n    if (this.server) return; // Already started\n\n    const app = express();\n    app.use(cors());\n    app.use(express.json());\n\n    // Serve static test assets (sample video and thumbnails)\n    const assetsDir = path.resolve(this.config.thumbnailDir, '..');\n    app.use('/test-assets', express.static(assetsDir));\n\n    // YouTube Data API — Search\n    app.get('/youtube/v3/search', (req: Request, res: Response) => {\n      const errorResult = this.errorModeManager.matchSearchRequest();\n      if (errorResult) {\n        return res.status(errorResult.status).json(errorResult.body);\n      }\n\n      const {\n        q = '',\n        maxResults = '10',\n        key,\n      } = req.query as Record<string, string>;\n\n      if (!key) {\n        return res.status(400).json({\n          error: {\n            code: 400,\n            message: 'API key not valid. Please pass a valid API key.',\n            errors: [\n              {\n                domain: 'usageLimits',\n                reason: 'keyInvalid',\n                message: 'API key not valid.',\n              },\n            ],\n          },\n        });\n      }\n\n      const limit = Number.parseInt(maxResults, 10);\n      const results = searchFixtures(\n        q,\n        Number.isNaN(limit) ? 10 : limit,\n        this.currentFixtures\n      );\n      const response = formatSearchResponse(\n        results,\n        this.config.externalUrl,\n        results.length\n      );\n\n      return res.json(response);\n    });\n\n    // Test control: override fixtures at runtime\n    app.put('/test/youtube/fixtures', (req: Request, res: Response) => {\n      this.currentFixtures = req.body?.fixtures ?? [...videoFixtures];\n      res.json({ success: true, count: this.currentFixtures.length });\n    });\n\n    // Health check endpoint\n    app.get('/test/youtube/health', (_req: Request, res: Response) => {\n      res.json({ status: 'ok' });\n    });\n\n    // Reset endpoint\n    app.post('/test/youtube/reset', async (_req: Request, res: Response) => {\n      await this.reset();\n      res.json({ success: true });\n    });\n\n    // Error mode control endpoints\n    app.post('/test/youtube/error-mode', (req: Request, res: Response) => {\n      const { mode } = req.body;\n      if (!mode) {\n        return res.status(400).json({ error: 'Missing \"mode\" field' });\n      }\n      this.errorModeManager.setMode({ type: mode });\n      return res.json({ success: true, mode });\n    });\n\n    app.delete('/test/youtube/error-mode', (_req: Request, res: Response) => {\n      this.errorModeManager.clearMode();\n      return res.json({ success: true, mode: null });\n    });\n\n    app.get('/test/youtube/error-mode', (_req: Request, res: Response) => {\n      const mode = this.errorModeManager.getMode();\n      return res.json({ active: mode !== null, mode: mode?.type ?? null });\n    });\n\n    // Serve YouTube IFrame Player API Shim JS\n    const shimJs = generatePlayerShim(this.config.externalUrl);\n\n    app.get('/iframe_api', (_req: Request, res: Response) => {\n      res.type('application/javascript').send(shimJs);\n    });\n\n    app.get('/shim/youtube-player.js', (_req: Request, res: Response) => {\n      res.type('application/javascript').send(shimJs);\n    });\n\n    return new Promise<void>((resolve, reject) => {\n      this.server = app.listen(this.config.port, () => {\n        console.log(\n          `[YoutubeTwin] Express server listening on port ${this.config.port}`\n        );\n        resolve();\n      });\n      this.server.on('error', reject);\n    });\n  }\n\n  async stop(): Promise<void> {\n    const server = this.server;\n    if (!server) return;\n    return new Promise<void>((resolve, reject) => {\n      server.close((err) => {\n        if (err) return reject(err);\n        this.server = null;\n        console.log('[YoutubeTwin] Express server stopped');\n        resolve();\n      });\n    });\n  }\n\n  async reset(): Promise<void> {\n    this.errorModeManager.reset();\n    this.currentFixtures = [...videoFixtures];\n  }\n\n  async isHealthy(): Promise<boolean> {\n    try {\n      const res = await fetch(\n        `${this.config.externalUrl}/test/youtube/health`,\n        {\n          headers: { Connection: 'close' },\n        }\n      );\n      await res.text(); // Consume body to release socket\n      return res.ok;\n    } catch {\n      return false;\n    }\n  }\n\n  getEmulatorHost(): string {\n    return this.config.externalUrl;\n  }\n}\n"],"names":["path","express","cors","createYoutubeConfig","videoFixtures","searchFixtures","formatSearchResponse","generatePlayerShim","YoutubeErrorModeManager","YoutubeTwin","start","server","app","use","json","assetsDir","resolve","config","thumbnailDir","static","get","req","res","errorResult","errorModeManager","matchSearchRequest","status","body","q","maxResults","key","query","error","code","message","errors","domain","reason","limit","Number","parseInt","results","isNaN","currentFixtures","response","externalUrl","length","put","fixtures","success","count","_req","post","reset","mode","setMode","type","delete","clearMode","getMode","active","shimJs","send","Promise","reject","listen","port","console","log","on","stop","close","err","isHealthy","fetch","headers","Connection","text","ok","getEmulatorHost","constructor","overrides"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;","mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-kingdom/shared-backend-integration-test-doubles",
-  "version": "0.0.2-17",
+  "version": "0.0.2-18",
   "publishConfig": {
     "access": "public"
   },
@@ -20,6 +20,7 @@
   "files": [
     "README.md",
     "dist",
+    "test-assets",
     "!**/*.tsbuildinfo"
   ],
   "nx": {
@@ -49,12 +50,24 @@
         "dependsOn": [
           "^build"
         ]
+      },
+      "start:youtube-twin": {
+        "command": "npx tsx libs/shared/backend/integration-test-doubles/scripts/start-youtube-twin.ts",
+        "dependsOn": [
+          "^build"
+        ]
       }
     }
   },
   "dependencies": {
-    "@open-kingdom/shared-poly-util-env-config": "0.0.2-17",
+    "@open-kingdom/shared-poly-util-env-config": "0.0.2-18",
+    "cors": "^2.8.5",
     "dockerode": "^4.0.6",
+    "express": "^5.1.0",
     "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0"
   }
 }