@echovisionlab/youtube-audio 0.1.0

package/DISCLOSURE.md

@@ -0,0 +1,12 @@
+# Dual-use software disclosure
+
+`@echovisionlab/youtube-audio` resolves and proxies authenticated access to
+YouTube audio sources. This capability can be used for legitimate workflows,
+including processing media owned by the user or covered by permission, license,
+or another lawful basis. It can also be misused to copy protected media without
+authorization.
+
+Integrators must restrict access to authenticated users, obtain all necessary
+copyright and rights clearances, and comply with YouTube's terms and applicable
+law. Echo Vision Lab does not encourage infringement, piracy, or unauthorized
+copying.

package/LICENSE.md

@@ -0,0 +1,6 @@
+Required Notice: Copyright 2026 Echo Vision Lab. All rights reserved.
+
+Licensed under the PolyForm Noncommercial License 1.0.0:
+https://polyformproject.org/licenses/noncommercial/1.0.0
+
+Commercial use requires a separate license from Echo Vision Lab.

package/README.md

@@ -0,0 +1,58 @@
+# YouTube audio
+
+Server-side YouTube audio source resolution and authenticated byte-range
+proxying for applications that perform browser-local audio processing.
+
+```sh
+pnpm add @echovisionlab/youtube-audio
+```
+
+The browser receives a same-origin opaque source URL, not the upstream media
+URL. Integrators must authenticate every resolve and range request, derive the
+subject from the server-side session, and store short-lived source records in a
+shared subject-bound store.
+
+```ts
+import { createYoutubeAudioService } from "@echovisionlab/youtube-audio";
+import { createYoutubeJsAudioProvider } from "@echovisionlab/youtube-audio/youtube-js";
+
+const service = createYoutubeAudioService({
+  provider: createYoutubeJsAudioProvider(),
+  sourceStore,
+  makeSourceUrl: (id) => `/api/youtube-audio/${id}`,
+});
+```
+
+## Responsible use
+
+This package is dual-use software, not a public download service. Access must
+be restricted to signed-in users. Use it only for media you own or are
+authorized to acquire and process, and obtain all required copyright and rights
+clearances. Echo Vision Lab does not encourage infringement or unauthorized
+copying. See [DISCLOSURE.md](DISCLOSURE.md).
+
+YouTube and its private APIs can change independently. Keep failures observable
+and review YouTube's terms and applicable law for your integration.
+
+## Development
+
+```sh
+corepack enable
+pnpm install --frozen-lockfile
+pnpm typecheck
+pnpm test:coverage
+pnpm build
+pnpm package:verify
+pnpm package:pack
+```
+
+## Release
+
+The initial package version requires an interactive npm publish with 2FA. Later
+versions use npm staged publishing from a GitHub Actions trusted publisher and
+still require maintainer approval with 2FA.
+
+## License
+
+PolyForm Noncommercial 1.0.0. Commercial use requires a separate license from
+Echo Vision Lab. See [LICENSE.md](LICENSE.md).

package/dist/contracts.d.ts

@@ -0,0 +1,74 @@
+export interface YoutubeVideoReference {
+    readonly canonicalUrl: string;
+    readonly videoId: string;
+}
+export interface YoutubeAudioUpstreamSource {
+    readonly contentType: string;
+    readonly expiresAt: number | null;
+    readonly fileName: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly size: number;
+    readonly title: string;
+    readonly url: string;
+    readonly videoId: string;
+}
+export interface YoutubeAudioProvider {
+    resolve(video: YoutubeVideoReference, signal?: AbortSignal): Promise<YoutubeAudioUpstreamSource>;
+}
+export interface YoutubeAudioSourceRecord {
+    readonly expiresAt: number;
+    readonly id: string;
+    readonly subject: string;
+    readonly upstream: YoutubeAudioUpstreamSource;
+}
+export interface YoutubeAudioSourceStore {
+    delete(id: string): Promise<void>;
+    get(id: string): Promise<YoutubeAudioSourceRecord | null>;
+    put(source: YoutubeAudioSourceRecord): Promise<void>;
+}
+export interface YoutubeAudioTranscoderInput {
+    readonly http: {
+        readonly credentials: 'include';
+        readonly size: number;
+        readonly url: string;
+    };
+    readonly name: string;
+}
+export interface ResolvedYoutubeAudio {
+    readonly contentType: string;
+    readonly expiresAt: number;
+    readonly input: YoutubeAudioTranscoderInput;
+    readonly sourceId: string;
+    readonly title: string;
+    readonly videoId: string;
+}
+export interface ResolveYoutubeAudioRequest {
+    readonly signal?: AbortSignal;
+    readonly subject: string;
+    readonly url: string;
+}
+export interface ReadYoutubeAudioRequest {
+    readonly range: string;
+    readonly signal?: AbortSignal;
+    readonly sourceId: string;
+    readonly subject: string;
+}
+export interface RevokeYoutubeAudioRequest {
+    readonly sourceId: string;
+    readonly subject: string;
+}
+export interface CreateYoutubeAudioServiceOptions {
+    readonly createSourceId?: () => string;
+    readonly fetch?: typeof fetch;
+    readonly makeSourceUrl: (sourceId: string) => string;
+    readonly now?: () => number;
+    readonly provider: YoutubeAudioProvider;
+    readonly sourceStore: YoutubeAudioSourceStore;
+    readonly sourceTtlMs?: number;
+}
+export interface YoutubeAudioService {
+    read(request: ReadYoutubeAudioRequest): Promise<Response>;
+    resolve(request: ResolveYoutubeAudioRequest): Promise<ResolvedYoutubeAudio>;
+    revoke(request: RevokeYoutubeAudioRequest): Promise<void>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CACL,KAAK,EAAE,qBAAqB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;CAC/C;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAC;IAC1D,GAAG,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;QAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC5E,MAAM,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D"}

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export type YoutubeAudioErrorCode = 'INVALID_REQUEST' | 'INVALID_UPSTREAM_RESPONSE' | 'REQUEST_ABORTED' | 'SOURCE_EXPIRED' | 'SOURCE_NOT_FOUND' | 'UNAUTHORIZED' | 'UNSUPPORTED_VIDEO' | 'UPSTREAM_FAILURE';
+export declare class YoutubeAudioError extends Error {
+    readonly code: YoutubeAudioErrorCode;
+    constructor(code: YoutubeAudioErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,2BAA2B,GAC3B,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC,YAAY,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,EAIvD;CACF"}

package/dist/errors.js

@@ -0,0 +1,9 @@
+export class YoutubeAudioError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'YoutubeAudioError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAwB;IAErC,YAAY,IAA2B,EAAE,OAAe;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { YoutubeAudioError } from './errors.js';
+export { createMemoryYoutubeAudioSourceStore } from './memory-store.js';
+export { createYoutubeAudioService } from './service.js';
+export { parseYoutubeVideoUrl } from './youtube-url.js';
+export type { CreateYoutubeAudioServiceOptions, ReadYoutubeAudioRequest, ResolvedYoutubeAudio, ResolveYoutubeAudioRequest, RevokeYoutubeAudioRequest, YoutubeAudioProvider, YoutubeAudioService, YoutubeAudioSourceRecord, YoutubeAudioSourceStore, YoutubeAudioTranscoderInput, YoutubeAudioUpstreamSource, YoutubeVideoReference, } from './contracts.js';
+export type { YoutubeAudioErrorCode } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EACV,gCAAgC,EAChC,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { YoutubeAudioError } from './errors.js';
+export { createMemoryYoutubeAudioSourceStore } from './memory-store.js';
+export { createYoutubeAudioService } from './service.js';
+export { parseYoutubeVideoUrl } from './youtube-url.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mCAAmC,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/memory-store.d.ts

@@ -0,0 +1,3 @@
+import type { YoutubeAudioSourceStore } from './contracts.js';
+export declare function createMemoryYoutubeAudioSourceStore(): YoutubeAudioSourceStore;
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../src/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,mCAAmC,IAAI,uBAAuB,CAa7E"}

package/dist/memory-store.js

@@ -0,0 +1,15 @@
+export function createMemoryYoutubeAudioSourceStore() {
+    const sources = new Map();
+    return {
+        async delete(id) {
+            sources.delete(id);
+        },
+        async get(id) {
+            return sources.get(id) ?? null;
+        },
+        async put(source) {
+            sources.set(source.id, source);
+        },
+    };
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../src/memory-store.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,mCAAmC;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC5D,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,EAAE;YACb,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,EAAE;YACV,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,MAAM;YACd,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,3 @@
+import type { CreateYoutubeAudioServiceOptions, YoutubeAudioService } from './contracts.js';
+export declare function createYoutubeAudioService(options: CreateYoutubeAudioServiceOptions): YoutubeAudioService;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gCAAgC,EAKhC,mBAAmB,EAGpB,MAAM,gBAAgB,CAAC;AAQxB,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,mBAAmB,CAqIrB"}

package/dist/service.js

@@ -0,0 +1,248 @@
+import { randomUUID } from 'node:crypto';
+import { YoutubeAudioError } from './errors.js';
+import { parseYoutubeVideoUrl } from './youtube-url.js';
+const DEFAULT_SOURCE_TTL_MS = 10 * 60 * 1_000;
+const MAX_SOURCE_TTL_MS = 60 * 60 * 1_000;
+const SUBJECT_MAX_LENGTH = 256;
+export function createYoutubeAudioService(options) {
+    const sourceTtlMs = validateTtl(options.sourceTtlMs ?? DEFAULT_SOURCE_TTL_MS);
+    const now = options.now ?? Date.now;
+    const createSourceId = options.createSourceId ?? randomUUID;
+    const fetchSource = options.fetch ?? fetch;
+    return {
+        async resolve(request) {
+            return resolveSource(request);
+        },
+        async read(request) {
+            return readSource(request);
+        },
+        async revoke(request) {
+            await revokeSource(request);
+        },
+    };
+    async function resolveSource(request) {
+        const subject = validateSubject(request.subject);
+        throwIfAborted(request.signal);
+        const video = parseYoutubeVideoUrl(request.url);
+        let upstream;
+        try {
+            upstream = await options.provider.resolve(video, request.signal);
+        }
+        catch (error) {
+            rethrowProviderError(error, request.signal);
+        }
+        throwIfAborted(request.signal);
+        validateUpstreamSource(upstream, video.videoId, now());
+        const issuedAt = now();
+        const ttlExpiry = issuedAt + sourceTtlMs;
+        const expiresAt = upstream.expiresAt === null
+            ? ttlExpiry
+            : Math.min(ttlExpiry, upstream.expiresAt);
+        const sourceId = validateSourceId(createSourceId());
+        const sourceUrl = validateSourceUrl(options.makeSourceUrl(sourceId));
+        const record = Object.freeze({
+            expiresAt,
+            id: sourceId,
+            subject,
+            upstream: freezeUpstream(upstream),
+        });
+        await options.sourceStore.put(record);
+        return Object.freeze({
+            contentType: upstream.contentType,
+            expiresAt,
+            input: Object.freeze({
+                http: Object.freeze({
+                    credentials: 'include',
+                    size: upstream.size,
+                    url: sourceUrl,
+                }),
+                name: upstream.fileName,
+            }),
+            sourceId,
+            title: upstream.title,
+            videoId: upstream.videoId,
+        });
+    }
+    async function readSource(request) {
+        const subject = validateSubject(request.subject);
+        const sourceId = validateSourceId(request.sourceId);
+        throwIfAborted(request.signal);
+        const record = await options.sourceStore.get(sourceId);
+        if (record === null) {
+            throw new YoutubeAudioError('SOURCE_NOT_FOUND', 'Audio source was not found.');
+        }
+        if (record.subject !== subject) {
+            throw new YoutubeAudioError('UNAUTHORIZED', 'Audio source access is denied.');
+        }
+        if (record.expiresAt <= now()) {
+            await options.sourceStore.delete(sourceId);
+            throw new YoutubeAudioError('SOURCE_EXPIRED', 'Audio source has expired.');
+        }
+        const range = parseClosedRange(request.range, record.upstream.size);
+        const headers = createUpstreamHeaders(record.upstream, range.header);
+        let response;
+        try {
+            response = await fetchSource(record.upstream.url, {
+                cache: 'no-store',
+                headers,
+                method: 'GET',
+                redirect: 'follow',
+                ...(request.signal === undefined ? {} : { signal: request.signal }),
+            });
+        }
+        catch {
+            throwIfAborted(request.signal);
+            throw new YoutubeAudioError('UPSTREAM_FAILURE', 'The upstream audio range request failed.');
+        }
+        throwIfAborted(request.signal);
+        validateUpstreamRangeResponse(response, range, record.upstream.size);
+        if (response.body === null) {
+            throw new YoutubeAudioError('INVALID_UPSTREAM_RESPONSE', 'The upstream audio response has no body.');
+        }
+        return new Response(response.body, {
+            headers: {
+                'Accept-Ranges': 'bytes',
+                'Cache-Control': 'private, no-store',
+                'Content-Length': String(range.end - range.start + 1),
+                'Content-Range': `bytes ${range.start}-${range.end}/${record.upstream.size}`,
+                'Content-Type': record.upstream.contentType,
+            },
+            status: 206,
+        });
+    }
+    async function revokeSource(request) {
+        const subject = validateSubject(request.subject);
+        const sourceId = validateSourceId(request.sourceId);
+        const record = await options.sourceStore.get(sourceId);
+        if (record === null) {
+            return;
+        }
+        if (record.subject !== subject) {
+            throw new YoutubeAudioError('UNAUTHORIZED', 'Audio source access is denied.');
+        }
+        await options.sourceStore.delete(sourceId);
+    }
+}
+function parseClosedRange(value, size) {
+    const match = /^bytes=(\d+)-(\d+)$/.exec(value);
+    if (match === null) {
+        throw new YoutubeAudioError('INVALID_REQUEST', 'A single closed byte range is required.');
+    }
+    const start = Number(match[1]);
+    const end = Number(match[2]);
+    if (!Number.isSafeInteger(start) ||
+        !Number.isSafeInteger(end) ||
+        start < 0 ||
+        end < start ||
+        end >= size) {
+        throw new YoutubeAudioError('INVALID_REQUEST', 'The requested byte range is outside the audio source.');
+    }
+    return { end, header: `bytes=${start}-${end}`, start };
+}
+function validateUpstreamRangeResponse(response, range, size) {
+    if (!response.ok) {
+        throw new YoutubeAudioError('UPSTREAM_FAILURE', `The upstream audio range request returned status ${response.status}.`);
+    }
+    const expected = `bytes ${range.start}-${range.end}/${size}`;
+    if (response.status !== 206 || response.headers.get('content-range') !== expected) {
+        throw new YoutubeAudioError('INVALID_UPSTREAM_RESPONSE', 'The upstream server did not honor the exact audio byte range.');
+    }
+}
+function createUpstreamHeaders(source, range) {
+    let headers;
+    try {
+        headers = new Headers(source.headers);
+    }
+    catch {
+        throw new YoutubeAudioError('INVALID_UPSTREAM_RESPONSE', 'The upstream audio request headers are invalid.');
+    }
+    if (headers.has('range')) {
+        throw new YoutubeAudioError('INVALID_UPSTREAM_RESPONSE', 'The upstream audio source must not override Range.');
+    }
+    headers.set('Range', range);
+    return headers;
+}
+function validateUpstreamSource(source, expectedVideoId, now) {
+    let url;
+    try {
+        url = new URL(source.url);
+    }
+    catch {
+        throw invalidUpstream();
+    }
+    if (url.protocol !== 'https:' ||
+        url.username !== '' ||
+        url.password !== '' ||
+        source.videoId !== expectedVideoId ||
+        !Number.isSafeInteger(source.size) ||
+        source.size < 1 ||
+        !isNonEmpty(source.contentType) ||
+        !isNonEmpty(source.fileName) ||
+        !isNonEmpty(source.title) ||
+        (source.expiresAt !== null &&
+            (!Number.isSafeInteger(source.expiresAt) || source.expiresAt <= now))) {
+        throw invalidUpstream();
+    }
+}
+function freezeUpstream(source) {
+    return Object.freeze({
+        ...source,
+        ...(source.headers === undefined
+            ? {}
+            : { headers: Object.freeze({ ...source.headers }) }),
+    });
+}
+function validateSubject(subject) {
+    const value = subject.trim();
+    if (value.length === 0 || value.length > SUBJECT_MAX_LENGTH) {
+        throw new YoutubeAudioError('UNAUTHORIZED', 'An authenticated subject is required.');
+    }
+    return value;
+}
+function validateSourceId(sourceId) {
+    const value = sourceId.trim();
+    if (!/^[A-Za-z0-9_-]{8,128}$/.test(value)) {
+        throw new YoutubeAudioError('INVALID_REQUEST', 'Audio source ID is invalid.');
+    }
+    return value;
+}
+function validateSourceUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new YoutubeAudioError('INVALID_REQUEST', 'makeSourceUrl must return an absolute HTTP(S) URL.');
+    }
+    if ((url.protocol !== 'https:' && url.protocol !== 'http:') ||
+        url.username !== '' ||
+        url.password !== '') {
+        throw new YoutubeAudioError('INVALID_REQUEST', 'makeSourceUrl must return an absolute HTTP(S) URL.');
+    }
+    return url.href;
+}
+function validateTtl(value) {
+    if (!Number.isSafeInteger(value) || value < 1_000 || value > MAX_SOURCE_TTL_MS) {
+        throw new YoutubeAudioError('INVALID_REQUEST', `sourceTtlMs must be an integer from 1000 to ${MAX_SOURCE_TTL_MS}.`);
+    }
+    return value;
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new YoutubeAudioError('REQUEST_ABORTED', 'The audio request was aborted.');
+    }
+}
+function rethrowProviderError(error, signal) {
+    throwIfAborted(signal);
+    if (error instanceof YoutubeAudioError) {
+        throw error;
+    }
+    throw new YoutubeAudioError('UPSTREAM_FAILURE', 'YouTube audio resolution failed.');
+}
+function invalidUpstream() {
+    return new YoutubeAudioError('INVALID_UPSTREAM_RESPONSE', 'The resolved YouTube audio source is invalid.');
+}
+function isNonEmpty(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/youtube-js.d.ts

@@ -0,0 +1,14 @@
+import { Innertube, type Types } from 'youtubei.js';
+import type { YoutubeAudioProvider } from './contracts.js';
+export interface CreateYoutubeJsAudioProviderOptions {
+    /** Optional YouTube.js session, useful when the application owns its cache. */
+    readonly innertube?: Innertube;
+    /** Used only when `innertube` is omitted. */
+    readonly innertubeConfig?: Types.InnerTubeConfig;
+    /** Optional YouTube client override. */
+    readonly client?: Types.InnerTubeClient;
+    /** Optional container preference such as `m4a` or `webm`. */
+    readonly format?: string;
+}
+export declare function createYoutubeJsAudioProvider(options?: CreateYoutubeJsAudioProviderOptions): YoutubeAudioProvider;
+//# sourceMappingURL=youtube-js.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-js.d.ts","sourceRoot":"","sources":["../src/youtube-js.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,mCAAmC;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;IACjD,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,mCAAwC,GAChD,oBAAoB,CA0CtB"}

package/dist/youtube-js.js

@@ -0,0 +1,107 @@
+import { Innertube } from 'youtubei.js';
+import { YoutubeAudioError } from './errors.js';
+export function createYoutubeJsAudioProvider(options = {}) {
+    let clientPromise;
+    const clientType = options.client ?? 'IOS';
+    return {
+        async resolve(video, signal) {
+            throwIfAborted(signal);
+            const innertube = await getInnertube();
+            throwIfAborted(signal);
+            try {
+                const info = await innertube.getBasicInfo(video.videoId, videoInfoOptions(clientType));
+                throwIfAborted(signal);
+                if (info.basic_info.is_live || info.basic_info.is_upcoming) {
+                    throw new YoutubeAudioError('UNSUPPORTED_VIDEO', 'Live and upcoming YouTube videos are not supported.');
+                }
+                const format = info.chooseFormat({
+                    ...videoInfoOptions(clientType),
+                    format: options.format ?? 'any',
+                    quality: 'best',
+                    type: 'audio',
+                });
+                format.url = await format.decipher(innertube.session.player);
+                throwIfAborted(signal);
+                return toUpstreamSource(video, info.basic_info.title, format);
+            }
+            catch (error) {
+                rethrowYoutubeJsError(error, signal);
+            }
+        },
+    };
+    function getInnertube() {
+        clientPromise ??= options.innertube === undefined
+            ? Innertube.create(options.innertubeConfig)
+            : Promise.resolve(options.innertube);
+        return clientPromise;
+    }
+}
+function toUpstreamSource(video, title, format) {
+    if (typeof title !== 'string' ||
+        title.trim().length === 0 ||
+        typeof format.url !== 'string' ||
+        format.url.length === 0 ||
+        !Number.isSafeInteger(format.content_length) ||
+        (format.content_length ?? 0) < 1 ||
+        !format.has_audio ||
+        format.has_video) {
+        throw new YoutubeAudioError('UNSUPPORTED_VIDEO', 'YouTube did not provide a finite audio-only source.');
+    }
+    const contentType = format.mime_type.split(';', 1)[0]?.trim();
+    if (contentType === undefined || !contentType.startsWith('audio/')) {
+        throw new YoutubeAudioError('UNSUPPORTED_VIDEO', 'YouTube did not provide a supported audio content type.');
+    }
+    const upstreamUrl = new URL(format.url);
+    return Object.freeze({
+        contentType,
+        expiresAt: readExpiry(upstreamUrl),
+        fileName: `${sanitizeFileName(title)}.${extensionFor(contentType)}`,
+        size: format.content_length,
+        title: title.trim(),
+        url: upstreamUrl.href,
+        videoId: video.videoId,
+    });
+}
+function videoInfoOptions(client) {
+    return { client };
+}
+function readExpiry(url) {
+    const seconds = Number(url.searchParams.get('expire'));
+    if (!Number.isSafeInteger(seconds) || seconds < 1) {
+        return null;
+    }
+    return seconds * 1_000;
+}
+function extensionFor(contentType) {
+    switch (contentType) {
+        case 'audio/mp4':
+            return 'm4a';
+        case 'audio/ogg':
+            return 'ogg';
+        case 'audio/webm':
+            return 'webm';
+        default:
+            return 'audio';
+    }
+}
+function sanitizeFileName(title) {
+    const sanitized = title
+        .replace(/[<>:"/\\|?*\u0000-\u001f]/g, '_')
+        .replace(/[. ]+$/g, '')
+        .trim()
+        .slice(0, 120);
+    return sanitized.length === 0 ? 'youtube-audio' : sanitized;
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new YoutubeAudioError('REQUEST_ABORTED', 'The audio request was aborted.');
+    }
+}
+function rethrowYoutubeJsError(error, signal) {
+    throwIfAborted(signal);
+    if (error instanceof YoutubeAudioError) {
+        throw error;
+    }
+    throw new YoutubeAudioError('UPSTREAM_FAILURE', 'YouTube.js could not resolve the audio source.');
+}
+//# sourceMappingURL=youtube-js.js.map

package/dist/youtube-js.js.map

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

package/dist/youtube-url.d.ts

@@ -0,0 +1,3 @@
+import type { YoutubeVideoReference } from './contracts.js';
+export declare function parseYoutubeVideoUrl(input: string): YoutubeVideoReference;
+//# sourceMappingURL=youtube-url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-url.d.ts","sourceRoot":"","sources":["../src/youtube-url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAY5D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAwCzE"}

package/dist/youtube-url.js

@@ -0,0 +1,59 @@
+import { YoutubeAudioError } from './errors.js';
+const VIDEO_ID_PATTERN = /^[A-Za-z0-9_-]{11}$/;
+const YOUTUBE_HOSTS = new Set([
+    'm.youtube.com',
+    'music.youtube.com',
+    'www.youtube-nocookie.com',
+    'www.youtube.com',
+    'youtube.com',
+]);
+const PATH_VIDEO_PREFIXES = new Set(['embed', 'live', 'shorts']);
+export function parseYoutubeVideoUrl(input) {
+    const value = input.trim();
+    if (VIDEO_ID_PATTERN.test(value)) {
+        return reference(value);
+    }
+    if (value.length === 0 || value.length > 2_048) {
+        throw invalidUrl();
+    }
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw invalidUrl();
+    }
+    if ((url.protocol !== 'https:' && url.protocol !== 'http:') ||
+        url.username !== '' ||
+        url.password !== '') {
+        throw invalidUrl();
+    }
+    const host = url.hostname.toLowerCase();
+    let videoId = null;
+    if (host === 'youtu.be') {
+        videoId = url.pathname.split('/').filter(Boolean)[0] ?? null;
+    }
+    else if (YOUTUBE_HOSTS.has(host)) {
+        const segments = url.pathname.split('/').filter(Boolean);
+        if (url.pathname === '/watch') {
+            videoId = url.searchParams.get('v');
+        }
+        else if (segments[0] !== undefined && PATH_VIDEO_PREFIXES.has(segments[0])) {
+            videoId = segments[1] ?? null;
+        }
+    }
+    if (videoId === null || !VIDEO_ID_PATTERN.test(videoId)) {
+        throw invalidUrl();
+    }
+    return reference(videoId);
+}
+function reference(videoId) {
+    return Object.freeze({
+        canonicalUrl: `https://www.youtube.com/watch?v=${videoId}`,
+        videoId,
+    });
+}
+function invalidUrl() {
+    return new YoutubeAudioError('INVALID_REQUEST', 'Provide a valid YouTube video URL or video ID.');
+}
+//# sourceMappingURL=youtube-url.js.map

package/dist/youtube-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-url.js","sourceRoot":"","sources":["../src/youtube-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,eAAe;IACf,mBAAmB;IACnB,0BAA0B;IAC1B,iBAAiB;IACjB,aAAa;CACd,CAAC,CAAC;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEjE,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC/C,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;IACD,IACE,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC;QACvD,GAAG,CAAC,QAAQ,KAAK,EAAE;QACnB,GAAG,CAAC,QAAQ,KAAK,EAAE,EACnB,CAAC;QACD,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC/D,CAAC;SAAM,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,MAAM,UAAU,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,mCAAmC,OAAO,EAAE;QAC1D,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,iBAAiB,CAC1B,iBAAiB,EACjB,gDAAgD,CACjD,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@echovisionlab/youtube-audio",
+  "version": "0.1.0",
+  "description": "Authenticated server-side YouTube audio resolution and byte-range proxying.",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./youtube-js": {
+      "types": "./dist/youtube-js.d.ts",
+      "import": "./dist/youtube-js.js"
+    }
+  },
+  "files": [
+    "dist",
+    "DISCLOSURE.md",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/echovisionlab/youtube-audio.git"
+  },
+  "engines": {
+    "node": "24.19.0"
+  },
+  "packageManager": "pnpm@11.22.0+sha512.1ff870c4c6133dfd88fb2afc46dd13d47f09c9794b438c6fdb47ca98caf3bc16381ee0be93a091b8e3824cf01f889f46d7d9e20910fb0be1ab0fb5baa80dd621",
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "build:clean": "node ./scripts/clean-dist.mjs",
+    "package:verify": "node ./scripts/verify-package.mjs",
+    "package:pack": "npm pack --dry-run",
+    "dist:verify-clean": "node ./scripts/verify-dist-clean.mjs",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "test:workflow": "node ./scripts/verify-workflow-contract.mjs"
+  },
+  "dependencies": {
+    "youtubei.js": "18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "@vitest/coverage-v8": "4.1.10",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
+  },
+  "homepage": "https://github.com/echovisionlab/youtube-audio#readme",
+  "bugs": {
+    "url": "https://github.com/echovisionlab/youtube-audio/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "contentPolicy": {
+    "class": "dual-use"
+  }
+}