gooseworks 0.4.2 → 0.4.5-dev.15.facf60fb

package/dist/lib/mcp-client.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpError = exports.LOGIN_HINT = void 0;
+exports.mcpEndpoint = mcpEndpoint;
+exports.connectMcp = connectMcp;
+const MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
+const DEFAULT_TIMEOUT_MS = 5 * 60_000;
+const PROTOCOL_VERSION = '2025-03-26';
+exports.LOGIN_HINT = 'Run `npx gooseworks login` (cloud sandbox or SSH: `npx gooseworks login --device --no-wait`).';
+class McpError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'McpError';
+    }
+}
+exports.McpError = McpError;
+/** `<mcp_server_url>/mcp`; HTTPS only, except a local dev server. */
+function mcpEndpoint(mcpServerUrl) {
+    const url = new URL(mcpServerUrl);
+    const local = ['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname);
+    if (url.username || url.password || url.hash || url.search ||
+        (url.protocol !== 'https:' && !(url.protocol === 'http:' && local))) {
+        throw new McpError('The saved GooseWorks MCP address is not a plain HTTPS URL. ' + exports.LOGIN_HINT);
+    }
+    const path = url.pathname.replace(/\/+$/, '');
+    url.pathname = path.endsWith('/mcp') ? path : `${path}/mcp`;
+    return url;
+}
+async function readBounded(response) {
+    const length = Number(response.headers.get('content-length'));
+    if (length > MAX_RESPONSE_BYTES)
+        throw new McpError('The GooseWorks reply is too large (over 8 MB).');
+    if (!response.body)
+        return '';
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    try {
+        for (;;) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            size += value.length;
+            if (size > MAX_RESPONSE_BYTES)
+                throw new McpError('The GooseWorks reply is too large (over 8 MB).');
+            chunks.push(Buffer.from(value));
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+/** The JSON-RPC message with `id` from a JSON or SSE (text/event-stream) body. */
+function pickMessage(body, contentType, id) {
+    if (contentType?.includes('text/event-stream')) {
+        let found;
+        for (const event of body.split(/\r?\n\r?\n/)) {
+            const data = event.split(/\r?\n/)
+                .filter((line) => line.startsWith('data:'))
+                .map((line) => line.slice(5).trimStart())
+                .join('\n');
+            if (!data)
+                continue;
+            try {
+                const parsed = JSON.parse(data);
+                if (parsed?.id === id)
+                    found = parsed;
+            }
+            catch {
+                // Ignore non-JSON keep-alive events.
+            }
+        }
+        return found;
+    }
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function connectMcp(creds, opts = {}) {
+    if (!creds.mcp_server_url) {
+        throw new McpError('This sign-in has no GooseWorks MCP address. ' + exports.LOGIN_HINT);
+    }
+    const endpoint = mcpEndpoint(creds.mcp_server_url);
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    let session;
+    let protocol = PROTOCOL_VERSION;
+    let sequence = 0;
+    const headers = () => ({
+        Authorization: `Bearer ${creds.api_key}`,
+        'Content-Type': 'application/json',
+        Accept: 'application/json, text/event-stream',
+        'MCP-Protocol-Version': protocol,
+        ...(session ? { 'Mcp-Session-Id': session } : {}),
+    });
+    const rpc = async (method, params, notification = false) => {
+        const id = ++sequence;
+        let response;
+        try {
+            response = await fetch(endpoint, {
+                method: 'POST',
+                redirect: 'error',
+                signal: AbortSignal.timeout(timeoutMs),
+                headers: headers(),
+                body: JSON.stringify({ jsonrpc: '2.0', ...(notification ? {} : { id }), method, params }),
+            });
+        }
+        catch (err) {
+            const timedOut = err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError');
+            throw new McpError(timedOut
+                ? `GooseWorks did not answer within ${Math.round(timeoutMs / 1000)} seconds. Try again, or pass --timeout.`
+                : `Could not reach GooseWorks at ${endpoint.origin}. Check the connection and try again.`);
+        }
+        if (response.status === 401 || response.status === 403) {
+            await response.body?.cancel();
+            throw new McpError('GooseWorks did not accept this sign-in. ' + exports.LOGIN_HINT, response.status);
+        }
+        if (!response.ok) {
+            await response.body?.cancel();
+            throw new McpError(`GooseWorks answered HTTP ${response.status}. Try again in a moment.`, response.status);
+        }
+        session = response.headers.get('mcp-session-id') ?? session;
+        if (notification) {
+            await response.body?.cancel();
+            return undefined;
+        }
+        const message = pickMessage(await readBounded(response), response.headers.get('content-type'), id);
+        if (!message || message.id !== id)
+            throw new McpError('GooseWorks sent an unexpected reply.');
+        if (message.error) {
+            const text = typeof message.error.message === 'string' ? message.error.message : 'unknown error';
+            throw new McpError(`GooseWorks refused the request: ${text}`);
+        }
+        return message.result;
+    };
+    const initialized = await rpc('initialize', {
+        protocolVersion: protocol,
+        capabilities: {},
+        clientInfo: { name: opts.clientName ?? 'gooseworks-cli', version: opts.version ?? '1' },
+    });
+    if (typeof initialized?.protocolVersion === 'string')
+        protocol = initialized.protocolVersion;
+    await rpc('notifications/initialized', {}, true);
+    const instructions = typeof initialized?.instructions === 'string' && initialized.instructions.trim()
+        ? initialized.instructions.trim()
+        : null;
+    return {
+        instructions,
+        async listTools() {
+            const tools = [];
+            const seen = new Set();
+            let cursor;
+            do {
+                const page = await rpc('tools/list', cursor ? { cursor } : {});
+                for (const tool of Array.isArray(page?.tools) ? page.tools : []) {
+                    if (tool && typeof tool.name === 'string')
+                        tools.push(tool);
+                }
+                const next = page?.nextCursor;
+                if (next !== undefined && next !== null && (typeof next !== 'string' || seen.has(next) || seen.size >= 100)) {
+                    throw new McpError('GooseWorks sent an unexpected tool list.');
+                }
+                if (next)
+                    seen.add(next);
+                cursor = next || undefined;
+            } while (cursor);
+            return tools;
+        },
+        async callTool(name, args) {
+            const result = await rpc('tools/call', { name, arguments: args });
+            return (result ?? {});
+        },
+        async close() {
+            if (!session)
+                return;
+            try {
+                const response = await fetch(endpoint, {
+                    method: 'DELETE',
+                    redirect: 'error',
+                    signal: AbortSignal.timeout(10_000),
+                    headers: headers(),
+                });
+                await response.body?.cancel();
+            }
+            catch {
+                // The server also cleans up idle sessions.
+            }
+        },
+    };
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/lib/mcp-client.js.map

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

package/dist/lib/video-local-captions.d.ts

@@ -0,0 +1,83 @@
+export declare const MAX_CAPTION_SOURCE_BYTES: number;
+export interface CaptionsPackage {
+    version: 1;
+    operation: 'captions';
+    source_video_url: string;
+    source_video_sha256: string;
+    ass_text: string;
+    edl: {
+        width: number;
+        height: number;
+        segments: Array<{
+            dur_s: number;
+        }>;
+    };
+    [key: string]: unknown;
+}
+export interface CaptionClaim {
+    claim_id: string;
+    lease_token: string;
+    lease_expires_at: string;
+    package_digest: string;
+    package: CaptionsPackage;
+}
+export interface CaptionTransport {
+    next(projectId: string, workerId: string): Promise<CaptionClaim | null>;
+    status(claimId: string, leaseToken: string): Promise<CaptionClaimStatus>;
+    heartbeat(claimId: string, leaseToken: string): Promise<void>;
+    complete(claimId: string, leaseToken: string, outputPath: string, sha256: string): Promise<void>;
+}
+export type CaptionClaimStatus = {
+    status: 'claimed';
+    package_digest: string;
+    package: CaptionsPackage;
+    lease_expires_at: string;
+} | {
+    status: 'completed';
+    output_sha256: string;
+    output_url: string;
+} | {
+    status: 'offered' | 'fallback';
+};
+export interface MediaProbe {
+    width: number;
+    height: number;
+    duration_s: number;
+}
+export interface CaptionRuntime {
+    download(url: string, target: string, expectedSha256?: string): Promise<string>;
+    preflight(): Promise<string>;
+    render(source: string, ass: string, output: string): Promise<void>;
+    probe(output: string): Promise<MediaProbe>;
+}
+export type CaptionPhase = 'claimed' | 'downloaded' | 'rendered' | 'completed';
+export interface CaptionJournal {
+    claim_id: string;
+    project_id: string;
+    package_digest: string;
+    lease_token: string;
+    lease_expires_at: string;
+    ffmpeg_version: string;
+    phase: CaptionPhase;
+    source_sha256?: string;
+    output_sha256?: string;
+}
+export declare function validateCaptionClaim(claim: CaptionClaim): {
+    expectedDuration: number;
+};
+export declare function sha256File(filePath: string): Promise<string>;
+/** Recover the prior lease/output before asking for new work. Never silently rerender an
+ * uncertain completion or let /next hide a still-active claim. */
+export declare function executeNextCaptionClaim(args: {
+    projectId: string;
+    workerId: string;
+    workRoot: string;
+    transport: CaptionTransport;
+    runtime: CaptionRuntime;
+    heartbeatMs?: number;
+}): Promise<{
+    claimId: string;
+    outputSha256: string;
+    journalPath: string;
+} | null>;
+//# sourceMappingURL=video-local-captions.d.ts.map

package/dist/lib/video-local-captions.d.ts.map

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

package/dist/lib/video-local-captions.js

@@ -0,0 +1,261 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CAPTION_SOURCE_BYTES = void 0;
+exports.validateCaptionClaim = validateCaptionClaim;
+exports.sha256File = sha256File;
+exports.executeNextCaptionClaim = executeNextCaptionClaim;
+/** One server-vetted local operation. This module never invokes a media provider. */
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path = __importStar(require("path"));
+const SHA256 = /^[a-f0-9]{64}$/i;
+const ID = /^[a-zA-Z0-9_-]{1,160}$/;
+exports.MAX_CAPTION_SOURCE_BYTES = 150 * 1024 * 1024;
+async function findPendingJournal(workRoot, projectId) {
+    let dirs;
+    try {
+        dirs = await (0, promises_1.readdir)(workRoot);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    const matches = [];
+    const unscoped = [];
+    for (const dir of dirs) {
+        if (!ID.test(dir))
+            continue;
+        const filePath = path.join(workRoot, dir, 'journal.json');
+        try {
+            const journal = JSON.parse(await (0, promises_1.readFile)(filePath, 'utf8'));
+            if (journal.project_id === projectId && journal.phase !== 'completed')
+                matches.push({ filePath, journal });
+            else if (!journal.project_id && journal.phase !== 'completed')
+                unscoped.push(filePath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    }
+    if (matches.length > 1)
+        throw new Error('Multiple unfinished caption claims exist; inspect the private journals before continuing');
+    if (unscoped.length)
+        throw new Error(`An older caption journal has no project binding; inspect it before requesting new work: ${unscoped[0]}`);
+    return matches[0] ?? null;
+}
+function validateCaptionClaim(claim) {
+    if (!claim || !ID.test(claim.claim_id) || !claim.lease_token ||
+        !SHA256.test(claim.package_digest) || !Number.isFinite(Date.parse(claim.lease_expires_at))) {
+        throw new Error('Invalid local caption claim identity or lease');
+    }
+    const pack = claim.package;
+    if (!pack || pack.version !== 1 || pack.operation !== 'captions' ||
+        typeof pack.source_video_url !== 'string' || !pack.source_video_url ||
+        typeof pack.ass_text !== 'string' || !pack.ass_text || pack.ass_text.length > 1024 * 1024 ||
+        !pack.ass_text.includes('[Script Info]') || !pack.ass_text.includes('[Events]')) {
+        throw new Error('Incomplete or unsupported local captions package');
+    }
+    const sourceUrl = new URL(pack.source_video_url);
+    if (sourceUrl.protocol !== 'https:' && !(sourceUrl.protocol === 'http:' &&
+        ['localhost', '127.0.0.1', '[::1]'].includes(sourceUrl.hostname))) {
+        throw new Error('Caption source must use HTTPS (or local development HTTP)');
+    }
+    if (!SHA256.test(pack.source_video_sha256)) {
+        throw new Error('Missing or invalid source checksum');
+    }
+    const edl = pack.edl;
+    if (!edl || !Number.isInteger(edl.width) || !Number.isInteger(edl.height) ||
+        edl.width < 16 || edl.height < 16 || edl.width > 8192 || edl.height > 8192 ||
+        !Array.isArray(edl.segments) || !edl.segments.length) {
+        throw new Error('Invalid expected caption dimensions or timeline');
+    }
+    const expectedDuration = edl.segments.reduce((sum, segment) => sum + segment.dur_s, 0);
+    if (!Number.isFinite(expectedDuration) || expectedDuration < 0.25 || expectedDuration > 70) {
+        throw new Error('Invalid expected caption duration');
+    }
+    return { expectedDuration };
+}
+async function sha256File(filePath) {
+    const hash = (0, crypto_1.createHash)('sha256');
+    for await (const chunk of (0, fs_1.createReadStream)(filePath))
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+async function saveJournal(filePath, journal) {
+    const pending = `${filePath}.pending`;
+    await (0, promises_1.writeFile)(pending, JSON.stringify(journal, null, 2), { mode: 0o600 });
+    await (0, promises_1.rename)(pending, filePath);
+}
+/** Recover the prior lease/output before asking for new work. Never silently rerender an
+ * uncertain completion or let /next hide a still-active claim. */
+async function executeNextCaptionClaim(args) {
+    if (!ID.test(args.projectId) || !ID.test(args.workerId))
+        throw new Error('Invalid project or worker ID');
+    const pending = await findPendingJournal(args.workRoot, args.projectId);
+    let claim;
+    let resumedJournal = null;
+    if (pending) {
+        const journal = pending.journal;
+        if (!ID.test(journal.claim_id) || !SHA256.test(journal.package_digest) || !journal.lease_token) {
+            throw new Error('Local caption recovery journal is invalid; inspect it before requesting new work');
+        }
+        let status;
+        try {
+            status = await args.transport.status(journal.claim_id, journal.lease_token);
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            throw new Error(`Could not verify prior caption claim ${journal.claim_id} (${reason}). Do not request new work; retain the journal and rerun after server recovery: ${pending.filePath}`);
+        }
+        if (status.status === 'completed') {
+            if (!SHA256.test(status.output_sha256) ||
+                (journal.output_sha256 && journal.output_sha256 !== status.output_sha256)) {
+                throw new Error('Completed caption receipt does not match the recovery journal');
+            }
+            journal.output_sha256 = status.output_sha256;
+            journal.phase = 'completed';
+            await saveJournal(pending.filePath, journal);
+            return { claimId: journal.claim_id, outputSha256: status.output_sha256, journalPath: pending.filePath };
+        }
+        if (status.status === 'offered') {
+            const renewed = await args.transport.next(args.projectId, args.workerId);
+            if (!renewed)
+                throw new Error(`Caption claim ${journal.claim_id} is not reclaimable yet. Rerun after the server offers it. Recovery journal: ${pending.filePath}`);
+            if (renewed.claim_id !== journal.claim_id || renewed.package_digest !== journal.package_digest) {
+                throw new Error(`Server offered a different caption claim; inspect the old recovery journal: ${pending.filePath}`);
+            }
+            claim = renewed;
+            journal.lease_token = renewed.lease_token;
+            resumedJournal = journal;
+        }
+        else if (status.status === 'claimed') {
+            if (status.package_digest !== journal.package_digest ||
+                !Number.isFinite(Date.parse(status.lease_expires_at)) || Date.parse(status.lease_expires_at) <= Date.now()) {
+                throw new Error(`Caption claim ${journal.claim_id} changed or its lease expired; stop and inspect the recovery journal: ${pending.filePath}`);
+            }
+            await args.transport.heartbeat(journal.claim_id, journal.lease_token);
+            claim = { claim_id: journal.claim_id, lease_token: journal.lease_token,
+                lease_expires_at: status.lease_expires_at, package_digest: status.package_digest, package: status.package };
+            resumedJournal = journal;
+        }
+        else {
+            throw new Error(`Caption claim ${journal.claim_id} is in server fallback; no local upload is allowed. Recovery journal: ${pending.filePath}`);
+        }
+    }
+    else {
+        claim = await args.transport.next(args.projectId, args.workerId);
+    }
+    if (!claim)
+        return null;
+    const { expectedDuration } = validateCaptionClaim(claim);
+    const claimDir = path.join(args.workRoot, claim.claim_id);
+    await (0, promises_1.mkdir)(claimDir, { recursive: true, mode: 0o700 });
+    const journalPath = path.join(claimDir, 'journal.json');
+    try {
+        const existing = JSON.parse(await (0, promises_1.readFile)(journalPath, 'utf8'));
+        if (existing.package_digest !== claim.package_digest)
+            throw new Error('Claim package changed; refusing old local state');
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    const journal = resumedJournal ?? {
+        claim_id: claim.claim_id, project_id: args.projectId, package_digest: claim.package_digest,
+        lease_token: claim.lease_token, lease_expires_at: claim.lease_expires_at,
+        ffmpeg_version: 'pending preflight', phase: 'claimed',
+    };
+    journal.lease_expires_at = claim.lease_expires_at;
+    await saveJournal(journalPath, journal);
+    if (journal.phase !== 'rendered') {
+        journal.ffmpeg_version = await args.runtime.preflight();
+        await saveJournal(journalPath, journal);
+    }
+    let heartbeatError = null;
+    let heartbeatBusy = false;
+    const timer = setInterval(() => {
+        if (heartbeatBusy || heartbeatError)
+            return;
+        heartbeatBusy = true;
+        void args.transport.heartbeat(claim.claim_id, claim.lease_token)
+            .catch((error) => { heartbeatError = error instanceof Error ? error : new Error(String(error)); })
+            .finally(() => { heartbeatBusy = false; });
+    }, args.heartbeatMs ?? 60_000);
+    try {
+        const sourcePath = path.join(claimDir, 'source.mp4');
+        const assPath = path.join(claimDir, 'captions.ass');
+        const outputPath = path.join(claimDir, 'captioned.mp4');
+        if (journal.phase !== 'rendered') {
+            journal.source_sha256 = await args.runtime.download(claim.package.source_video_url, sourcePath, claim.package.source_video_sha256);
+            journal.phase = 'downloaded';
+            await saveJournal(journalPath, journal);
+            await (0, promises_1.writeFile)(assPath, claim.package.ass_text, { mode: 0o600 });
+            await args.runtime.render(sourcePath, assPath, outputPath);
+        }
+        else {
+            const info = await (0, promises_1.stat)(outputPath).catch(() => null);
+            if (!info?.isFile() || !journal.output_sha256 ||
+                await sha256File(outputPath) !== journal.output_sha256) {
+                throw new Error('Rendered caption output is missing or differs from its journal; refusing upload');
+            }
+        }
+        if (heartbeatError)
+            throw heartbeatError;
+        const probe = await args.runtime.probe(outputPath);
+        if (probe.width !== claim.package.edl.width || probe.height !== claim.package.edl.height ||
+            probe.duration_s < Math.max(0.25, expectedDuration - 1) ||
+            probe.duration_s > Math.min(70, expectedDuration + 2)) {
+            throw new Error('Caption output dimensions or duration do not match the server package');
+        }
+        journal.output_sha256 = await sha256File(outputPath);
+        journal.phase = 'rendered';
+        await saveJournal(journalPath, journal);
+        await args.transport.heartbeat(claim.claim_id, claim.lease_token);
+        if (heartbeatError)
+            throw heartbeatError;
+        await args.transport.complete(claim.claim_id, claim.lease_token, outputPath, journal.output_sha256);
+        journal.phase = 'completed';
+        await saveJournal(journalPath, journal);
+        return { claimId: claim.claim_id, outputSha256: journal.output_sha256, journalPath };
+    }
+    finally {
+        clearInterval(timer);
+    }
+}
+//# sourceMappingURL=video-local-captions.js.map

package/dist/lib/video-local-captions.js.map

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

package/dist/lib/video-local-runtime.d.ts

@@ -0,0 +1,8 @@
+import type { CaptionRuntime, CaptionTransport } from './video-local-captions';
+export declare const LOCAL_UPLOAD_TIMEOUT_MS: number;
+/** HTTP transport uses only the scoped, authenticated local-node route. */
+export declare function createCaptionTransport(apiBase: string, apiKey: string): CaptionTransport;
+/** Reviewed, fixed ffmpeg flags. Neither the server package nor the user supplies flags. */
+export declare const ffmpegCaptionArgs: (sourceName?: string) => string[];
+export declare function createCaptionRuntime(ffmpeg?: string, ffprobe?: string): CaptionRuntime;
+//# sourceMappingURL=video-local-runtime.d.ts.map

package/dist/lib/video-local-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-local-runtime.d.ts","sourceRoot":"","sources":["../../src/lib/video-local-runtime.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAoC,cAAc,EAAE,gBAAgB,EAAc,MAAM,wBAAwB,CAAC;AAwB7H,eAAO,MAAM,uBAAuB,QAAc,CAAC;AAcnD,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CA6CxF;AAED,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,GAAI,mBAAyB,KAAG,MAAM,EAKnE,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,SAAW,EAAE,OAAO,SAAY,GAAG,cAAc,CAyD3F"}