Files
jackwener__opencli/clis/youtube/utils.ts
jakevin 4fe9a73ebc refactor: migrate adapter imports to package exports (#795)
* refactor: migrate adapter imports to package exports

Replace all relative imports (../../src/registry.js, ../../browser/cdp.js, etc.)
with package exports (@jackwener/opencli/registry, @jackwener/opencli/errors, etc.)
across all 484 adapter files.

This decouples adapter import resolution from directory structure:
- User CLIs in ~/.opencli/clis/ resolve via node_modules symlink
- Internal adapters resolve via Node.js self-referencing
- No more shim files needed for import resolution

Changes:
- package.json: add sub-path exports for all public modules
- clis/**: replace relative imports with @jackwener/opencli/...
- discovery.ts: simplify ensureUserCliCompatShims to symlink-only
- registry-api.ts: export CommandArgs type
- Remove root-level shim directories (browser/, download/, pipeline/)
- Remove shim entries from tsconfig.json include and package.json files

* test: add regression tests for package exports

Prevents regressions like #788/#791 by:
1. Scanning all adapter files for forbidden relative imports
   (../../src/, ../../browser/, etc.) — fails if any remain
2. Verifying every package.json export maps to an existing source file

18 new test cases.

* fix: use junction on Windows + broaden test patterns

- discovery.ts: use 'junction' symlink type on Windows (no admin required)
- package-exports.test.ts: generalize forbidden patterns to catch any
  depth of ../ traversal (not just ../../ and ../../../)

* fix: update stale vi.mock/importActual paths in adapter tests

Test files still used old relative paths for vi.mock() and
vi.importActual() calls. Updated 5 test files to use package exports.
Also broadened regression test patterns to catch mock/importActual paths.

* fix: use rm instead of unlink for symlink cleanup, add warn on failure

Addresses review feedback from Astro-Han:
- rm() handles both symlinks and stale directories (unlink fails on dirs)
- Log a warning when symlink creation fails instead of silent catch

* docs: update import examples to use package exports

Update all documentation, contributing guides, and skills to use
@jackwener/opencli/registry instead of ../../src/registry.js.

Without this, users following the docs would write adapters with
broken imports since the old shim files are no longer created.
2026-04-05 16:02:17 +08:00

98 lines
2.6 KiB
TypeScript

/**
* Shared YouTube utilities — URL parsing, video ID extraction, etc.
*/
import type { IPage } from '@jackwener/opencli/types';
/**
* Extract a YouTube video ID from a URL or bare video ID string.
* Supports: watch?v=, youtu.be/, /shorts/, /embed/, /live/, /v/
*/
export function parseVideoId(input: string): string {
if (!input.startsWith('http')) return input;
try {
const parsed = new URL(input);
if (parsed.searchParams.has('v')) {
return parsed.searchParams.get('v')!;
}
if (parsed.hostname === 'youtu.be') {
return parsed.pathname.slice(1).split('/')[0];
}
// Handle /shorts/xxx, /embed/xxx, /live/xxx, /v/xxx
const pathMatch = parsed.pathname.match(/^\/(shorts|embed|live|v)\/([^/?]+)/);
if (pathMatch) return pathMatch[2];
} catch {
// Not a valid URL — treat entire input as video ID
}
return input;
}
/**
* Extract a JSON object assigned to a known bootstrap variable inside YouTube HTML.
*/
export function extractJsonAssignmentFromHtml(html: string, keys: string | string[]): Record<string, unknown> | null {
const candidates = Array.isArray(keys) ? keys : [keys];
for (const key of candidates) {
const markers = [
`var ${key} = `,
`window["${key}"] = `,
`window.${key} = `,
`${key} = `,
];
for (const marker of markers) {
const markerIndex = html.indexOf(marker);
if (markerIndex === -1) continue;
const jsonStart = html.indexOf('{', markerIndex + marker.length);
if (jsonStart === -1) continue;
let depth = 0;
let inString = false;
let escaping = false;
for (let i = jsonStart; i < html.length; i += 1) {
const ch = html[i];
if (inString) {
if (escaping) {
escaping = false;
} else if (ch === '\\') {
escaping = true;
} else if (ch === '"') {
inString = false;
}
continue;
}
if (ch === '"') {
inString = true;
continue;
}
if (ch === '{') {
depth += 1;
continue;
}
if (ch === '}') {
depth -= 1;
if (depth === 0) {
try {
return JSON.parse(html.slice(jsonStart, i + 1)) as Record<string, unknown>;
} catch {
break;
}
}
}
}
}
}
return null;
}
/**
* Prepare a quiet YouTube API-capable page without opening the watch UI.
*/
export async function prepareYoutubeApiPage(page: IPage): Promise<void> {
await page.goto('https://www.youtube.com', { waitUntil: 'none' });
await page.wait(2);
}