@memberjunction/video-studio-render-worker 0.0.1-seed.1 → 6.2.0-edge.7

package/dist/backend.d.ts

@@ -0,0 +1,201 @@
+import type { CheckIssue, ExtractedKeyframe, RenderHealth, RenderProgress, RenderWorkerErrorBody, RenderWorkerErrorCode } from '@memberjunction/video-studio-core';
+/** Pinned `@hyperframes/producer` version reported by the worker. */
+export declare const PINNED_HYPERFRAMES_VERSION = "0.8.134";
+/** Valid 1x1 transparent PNG used by `FakeRenderBackend`. */
+export declare const FAKE_ONE_BY_ONE_PNG: Buffer<ArrayBuffer>;
+/** Minimal valid ISO BMFF (`ftyp`) header bytes used by `FakeRenderBackend`. */
+export declare const FAKE_MP4_BYTES: Buffer<ArrayBuffer>;
+/**
+ * Structured error thrown inside the render worker with an HTTP-mappable error code.
+ */
+export declare class RenderWorkerError extends Error {
+    readonly Code: RenderWorkerErrorCode;
+    readonly Issues?: CheckIssue[];
+    constructor(code: RenderWorkerErrorCode, message: string, issues?: CheckIssue[]);
+    /**
+     * Converts this error into the wire-format `RenderWorkerErrorBody`.
+     */
+    ToBody(): RenderWorkerErrorBody;
+}
+/**
+ * Parameters passed to `RenderBackend.Render` for an unpacked bundle on disk.
+ */
+export interface BackendRenderJob {
+    /** Absolute path to the unpacked bundle directory. */
+    RootDir: string;
+    /** Relative entry HTML path inside `RootDir`. */
+    EntryFile: string;
+    /** Output frame width in pixels. */
+    Width: number;
+    /** Output frame height in pixels. */
+    Height: number;
+    /** Output frame rate in frames per second. */
+    Fps: number;
+    /** Optional explicit duration override in seconds. */
+    DurationSeconds?: number;
+    /** Optional encoding quality preset. */
+    Quality?: 'draft' | 'standard' | 'high';
+}
+/**
+ * Parameters passed to `RenderBackend.CaptureStills` for an unpacked bundle on disk.
+ */
+export interface BackendStillsJob {
+    /** Absolute path to the unpacked bundle directory. */
+    RootDir: string;
+    /** Relative entry HTML path inside `RootDir`. */
+    EntryFile: string;
+    /** Viewport width in pixels. */
+    Width: number;
+    /** Viewport height in pixels. */
+    Height: number;
+    /** Frame rate in frames per second. */
+    Fps: number;
+    /** Timestamps in seconds to capture in a single browser session. */
+    TimestampsSeconds: number[];
+    /** Output image format (`png` or `jpeg`). */
+    ImageFormat: 'png' | 'jpeg';
+    /** Optional JPEG quality (`1-100`). */
+    JpegQuality?: number;
+}
+/**
+ * Media metadata probed from a rendered MP4 file.
+ */
+export interface BackendProbeResult {
+    /** Probed duration in seconds. */
+    DurationSeconds: number;
+    /** Whether the file contains an audio stream with non-zero duration. */
+    HasAudio: boolean;
+    /** Probed video width in pixels. */
+    Width: number;
+    /** Probed video height in pixels. */
+    Height: number;
+}
+/**
+ * Parameters passed to `RenderBackend.RunCheckCli` and `RenderBackend.MeasureText` for an unpacked bundle on disk.
+ */
+export interface BackendCheckJob {
+    /** Absolute path to the unpacked bundle directory. */
+    RootDir: string;
+    /** Relative entry HTML path inside `RootDir`. */
+    EntryFile: string;
+    /** Viewport width in pixels. */
+    Width: number;
+    /** Viewport height in pixels. */
+    Height: number;
+    /** Frame rate in frames per second (defaults to 30). */
+    Fps?: number;
+}
+/**
+ * Visible text element measurement captured in the headless browser DOM at a specific timestamp (VS-RND-5).
+ */
+export interface MeasuredText {
+    /** Trimmed visible text owned by the element. */
+    Text: string;
+    /** Bounding box left coordinate in CSS pixels relative to the viewport. */
+    Left: number;
+    /** Bounding box top coordinate in CSS pixels relative to the viewport. */
+    Top: number;
+    /** Bounding box width in CSS pixels. */
+    Width: number;
+    /** Bounding box height in CSS pixels. */
+    Height: number;
+    /** Computed `font-size` in pixels. */
+    FontSizePx: number;
+    /** First computed `font-family` name (unquoted). */
+    FontFamily: string;
+    /** True when the first computed `font-family` is a loaded `FontFace` in `document.fonts`. */
+    FontIsBundled: boolean;
+    /** True when the element or an ancestor carries `data-mj-bound`. */
+    IsBound: boolean;
+    /** The `data-mj-bound` attribute value from the element or its nearest bound ancestor, when `IsBound` is true. */
+    BoundKey?: string;
+    /** Short CSS selector path identifying the element. */
+    Selector: string;
+    /** Sample timestamp in seconds at which the measurement was taken. */
+    TimestampSeconds: number;
+}
+/**
+ * Pluggable rendering backend interface separating job orchestration and HTTP transport
+ * from HyperFrames, Chromium, and ffmpeg execution.
+ */
+export interface RenderBackend {
+    /** Runs static project and media URL lint checks on an unpacked bundle directory. */
+    Lint(dir: string, entry: string): Promise<{
+        Issues: CheckIssue[];
+        Block: boolean;
+    }>;
+    /** Runs `hyperframes check --json` in a restricted subprocess and maps findings to `CheckIssue[]`. */
+    RunCheckCli(job: BackendCheckJob, signal?: AbortSignal): Promise<CheckIssue[]>;
+    /** Seeks the composition to each timestamp in `timestampsSeconds` and measures visible text elements. */
+    MeasureText(job: BackendCheckJob, timestampsSeconds: readonly number[], signal?: AbortSignal): Promise<MeasuredText[][]>;
+    /** Renders an unpacked composition to an MP4 file on disk, emitting progress events. */
+    Render(job: BackendRenderJob, onProgress: (progress: RenderProgress) => void, signal?: AbortSignal): Promise<{
+        OutputPath: string;
+        FrameCount: number;
+    }>;
+    /** Captures one or more still frames in a single headless browser session. */
+    CaptureStills(job: BackendStillsJob, signal?: AbortSignal): Promise<Uint8Array[]>;
+    /** Probes an MP4 file for duration, dimensions, and audio stream presence. */
+    Probe(videoPath: string): Promise<BackendProbeResult>;
+    /** Extracts representative keyframes (scene changes + uniform samples) from an MP4 file. */
+    ExtractKeyframes(videoPath: string, outDir: string, max: number, signal?: AbortSignal): Promise<ExtractedKeyframe[]>;
+    /** Checks runtime dependencies and returns version and health status. */
+    Health(): Promise<RenderHealth>;
+    /** Returns the installed renderer version string. */
+    GetRendererVersion(): string;
+}
+/**
+ * Configuration options for `FakeRenderBackend` in unit and contract tests.
+ */
+export interface FakeRenderBackendOptions {
+    /** Additional lint issues returned by `Lint()`. */
+    ExtraLintIssues?: CheckIssue[];
+    /** Whether `Lint()` should report `Block: true`. */
+    BlockLint?: boolean;
+    /** Scripted CLI check issues returned by `RunCheckCli()` (defaults to `[]`). */
+    CheckCliIssues?: CheckIssue[];
+    /** Optional error thrown by `RunCheckCli()` to test fault tolerance. */
+    ThrowOnCheckCli?: Error;
+    /** Scripted DOM text measurements returned by `MeasureText()` (defaults to `[]`). */
+    MeasuredTexts?: MeasuredText[][];
+    /** Optional error thrown by `MeasureText()` to test fault tolerance. */
+    ThrowOnMeasureText?: Error;
+    /** Delay in milliseconds between each of the 5 progress steps (defaults to 20 ms). */
+    StepDelayMs?: number;
+    /** Simulated audio presence returned by `Probe()` (defaults to `true`). */
+    HasAudio?: boolean;
+    /** Simulated health status returned by `Health()` (defaults to `true`). */
+    Healthy?: boolean;
+}
+/**
+ * Deterministic in-memory/temp-file `RenderBackend` requiring neither Chromium nor ffmpeg.
+ */
+export declare class FakeRenderBackend implements RenderBackend {
+    private readonly options;
+    private lastProbe;
+    LintCallCount: number;
+    RunCheckCliCallCount: number;
+    MeasureTextCallCount: number;
+    LastMeasuredTimestamps: number[];
+    LastCheckCliJob?: BackendCheckJob;
+    LastMeasureTextJob?: BackendCheckJob;
+    LastCheckCliSignal?: AbortSignal;
+    LastMeasureTextSignal?: AbortSignal;
+    constructor(options?: FakeRenderBackendOptions);
+    Lint(_dir: string, _entry: string): Promise<{
+        Issues: CheckIssue[];
+        Block: boolean;
+    }>;
+    RunCheckCli(job: BackendCheckJob, signal?: AbortSignal): Promise<CheckIssue[]>;
+    MeasureText(job: BackendCheckJob, timestampsSeconds: readonly number[], signal?: AbortSignal): Promise<MeasuredText[][]>;
+    Render(job: BackendRenderJob, onProgress: (progress: RenderProgress) => void, signal?: AbortSignal): Promise<{
+        OutputPath: string;
+        FrameCount: number;
+    }>;
+    CaptureStills(job: BackendStillsJob, signal?: AbortSignal): Promise<Uint8Array[]>;
+    Probe(_videoPath: string): Promise<BackendProbeResult>;
+    ExtractKeyframes(_videoPath: string, _outDir: string, max: number, signal?: AbortSignal): Promise<ExtractedKeyframe[]>;
+    Health(): Promise<RenderHealth>;
+    GetRendererVersion(): string;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

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

package/dist/backend.js

@@ -0,0 +1,205 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/** Pinned `@hyperframes/producer` version reported by the worker. */
+export const PINNED_HYPERFRAMES_VERSION = '0.8.134';
+/** Valid 1x1 transparent PNG used by `FakeRenderBackend`. */
+export const FAKE_ONE_BY_ONE_PNG = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==', 'base64');
+/** Minimal valid ISO BMFF (`ftyp`) header bytes used by `FakeRenderBackend`. */
+export const FAKE_MP4_BYTES = Buffer.from([
+    0x00, 0x00, 0x00, 0x18,
+    0x66, 0x74, 0x79, 0x70, // 'ftyp'
+    0x6d, 0x70, 0x34, 0x32, // 'mp42'
+    0x00, 0x00, 0x00, 0x00,
+    0x6d, 0x70, 0x34, 0x32, // 'mp42'
+    0x69, 0x73, 0x6f, 0x6d, // 'isom'
+]);
+/**
+ * Structured error thrown inside the render worker with an HTTP-mappable error code.
+ */
+export class RenderWorkerError extends Error {
+    constructor(code, message, issues) {
+        super(message);
+        this.name = 'RenderWorkerError';
+        this.Code = code;
+        this.Issues = issues;
+    }
+    /**
+     * Converts this error into the wire-format `RenderWorkerErrorBody`.
+     */
+    ToBody() {
+        const body = {
+            Code: this.Code,
+            Message: this.message,
+        };
+        if (this.Issues && this.Issues.length > 0) {
+            body.Issues = this.Issues;
+        }
+        return body;
+    }
+}
+/**
+ * Deterministic in-memory/temp-file `RenderBackend` requiring neither Chromium nor ffmpeg.
+ */
+export class FakeRenderBackend {
+    constructor(options = {}) {
+        this.lastProbe = {
+            DurationSeconds: 3,
+            HasAudio: true,
+            Width: 1280,
+            Height: 720,
+        };
+        this.LintCallCount = 0;
+        this.RunCheckCliCallCount = 0;
+        this.MeasureTextCallCount = 0;
+        this.LastMeasuredTimestamps = [];
+        this.options = options;
+    }
+    async Lint(_dir, _entry) {
+        this.LintCallCount++;
+        const extra = this.options.ExtraLintIssues ? [...this.options.ExtraLintIssues] : [];
+        const hasError = extra.some((issue) => issue.Severity === 'Error');
+        return {
+            Issues: extra,
+            Block: Boolean(this.options.BlockLint) || hasError,
+        };
+    }
+    async RunCheckCli(job, signal) {
+        throwIfAborted(signal);
+        this.RunCheckCliCallCount++;
+        this.LastCheckCliJob = { ...job };
+        this.LastCheckCliSignal = signal;
+        if (this.options.ThrowOnCheckCli) {
+            throw this.options.ThrowOnCheckCli;
+        }
+        return this.options.CheckCliIssues ? [...this.options.CheckCliIssues] : [];
+    }
+    async MeasureText(job, timestampsSeconds, signal) {
+        throwIfAborted(signal);
+        this.MeasureTextCallCount++;
+        this.LastMeasureTextJob = { ...job };
+        this.LastMeasureTextSignal = signal;
+        this.LastMeasuredTimestamps = [...timestampsSeconds];
+        if (this.options.ThrowOnMeasureText) {
+            throw this.options.ThrowOnMeasureText;
+        }
+        if (this.options.MeasuredTexts) {
+            return this.options.MeasuredTexts.map((group) => [...group]);
+        }
+        return [];
+    }
+    async Render(job, onProgress, signal) {
+        throwIfAborted(signal);
+        const entryContent = await fs.readFile(path.join(job.RootDir, job.EntryFile), 'utf8');
+        const durationSeconds = job.DurationSeconds ?? parseDurationFromHtml(entryContent) ?? 3;
+        const totalFrames = Math.max(1, Math.round(durationSeconds * job.Fps));
+        const stepDelayMs = this.options.StepDelayMs ?? 20;
+        if (entryContent.includes('data-fake-hang')) {
+            onProgress({
+                Phase: 'Rendering',
+                RenderedFrames: 1,
+                TotalFrames: totalFrames,
+                Percent: Math.round((1 / totalFrames) * 100),
+                ElapsedMs: 1,
+            });
+            await waitForAbort(signal);
+        }
+        const totalSteps = 5;
+        const startMs = Date.now();
+        for (let step = 1; step <= totalSteps; step++) {
+            await delayWithSignal(stepDelayMs, signal);
+            const completedFrames = Math.round((step / totalSteps) * totalFrames);
+            onProgress({
+                Phase: step < totalSteps ? 'Rendering' : 'Encoding',
+                RenderedFrames: completedFrames,
+                TotalFrames: totalFrames,
+                Percent: Math.round((step / totalSteps) * 100),
+                ElapsedMs: Date.now() - startMs,
+            });
+        }
+        const outputPath = path.join(job.RootDir, 'fake-output.mp4');
+        await fs.writeFile(outputPath, FAKE_MP4_BYTES);
+        this.lastProbe = {
+            DurationSeconds: durationSeconds,
+            HasAudio: this.options.HasAudio ?? true,
+            Width: job.Width,
+            Height: job.Height,
+        };
+        return { OutputPath: outputPath, FrameCount: totalFrames };
+    }
+    async CaptureStills(job, signal) {
+        throwIfAborted(signal);
+        return job.TimestampsSeconds.map(() => new Uint8Array(FAKE_ONE_BY_ONE_PNG));
+    }
+    async Probe(_videoPath) {
+        return { ...this.lastProbe };
+    }
+    async ExtractKeyframes(_videoPath, _outDir, max, signal) {
+        throwIfAborted(signal);
+        const cap = Math.max(1, Math.min(max, 4));
+        const frames = [];
+        for (let i = 0; i < cap; i++) {
+            frames.push({
+                Index: i,
+                TimestampSeconds: i * 0.5,
+                Reason: i === 1 ? 'SceneChange' : 'UniformSample',
+                MimeType: 'image/png',
+                Width: 1280,
+                Height: 720,
+                ImageBase64: FAKE_ONE_BY_ONE_PNG.toString('base64'),
+            });
+        }
+        return frames;
+    }
+    async Health() {
+        const healthy = this.options.Healthy ?? true;
+        return {
+            Healthy: healthy,
+            NodeVersion: process.version,
+            HyperFramesVersion: PINNED_HYPERFRAMES_VERSION,
+            ChromiumVersion: healthy ? 'fake-chromium-146.0' : undefined,
+            FfmpegVersion: healthy ? 'fake-ffmpeg-7.1' : undefined,
+            Errors: healthy ? [] : ['Fake backend configured unhealthy.'],
+        };
+    }
+    GetRendererVersion() {
+        return PINNED_HYPERFRAMES_VERSION;
+    }
+}
+function parseDurationFromHtml(html) {
+    const match = /\bdata-duration\s*=\s*(?:"([0-9.]+)"|'([0-9.]+)')/i.exec(html);
+    const raw = match?.[1] ?? match?.[2];
+    if (!raw) {
+        return undefined;
+    }
+    const parsed = Number.parseFloat(raw);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw new RenderWorkerError('Cancelled', 'Render job was cancelled.');
+    }
+}
+function delayWithSignal(ms, signal) {
+    throwIfAborted(signal);
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new RenderWorkerError('Cancelled', 'Render job was cancelled.'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function waitForAbort(signal) {
+    throwIfAborted(signal);
+    return new Promise((_resolve, reject) => {
+        const onAbort = () => {
+            reject(new RenderWorkerError('Cancelled', 'Render job was cancelled.'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

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

package/dist/bundle.d.ts

@@ -0,0 +1,112 @@
+import { type RenderProjectBundle, type VideoFormat } from '@memberjunction/video-studio-core';
+import { type PreambleRuntimeOptions } from './preamble.js';
+/** Maximum number of `Files` + `Assets` entries allowed in a single bundle. */
+export declare const MAX_BUNDLE_ENTRIES = 2000;
+/** Minimum allowed output frame dimension in pixels. */
+export declare const MIN_FRAME_DIMENSION = 16;
+/** Maximum allowed output frame dimension in pixels. */
+export declare const MAX_FRAME_DIMENSION = 4096;
+/** Maximum allowed relative deviation (1%) from the format's target aspect ratio. */
+export declare const MAX_ASPECT_RATIO_TOLERANCE = 0.01;
+/** Minimum allowed frame rate in frames per second. */
+export declare const MIN_FPS = 1;
+/** Maximum allowed frame rate in frames per second. */
+export declare const MAX_FPS = 60;
+/** Maximum allowed composition duration in seconds. */
+export declare const MAX_DURATION_SECONDS = 600;
+/**
+ * Unpacked composition bundle staged in an isolated temporary directory on disk.
+ */
+export interface StagedBundle {
+    /** Absolute path to the temporary root directory for this bundle. */
+    readonly RootDir: string;
+    /** Absolute path to the entry HTML file inside `RootDir`. */
+    readonly EntryPath: string;
+    /** Idempotently removes `RootDir` and all unpacked files. */
+    Cleanup(): Promise<void>;
+}
+/**
+ * Options for `StageRenderBundle`.
+ */
+export interface StageBundleOptions {
+    /** Optional parent directory for `mkdtemp` (defaults to `os.tmpdir()`). */
+    TempRoot?: string;
+    /** Optional frame geometry forwarded to the `window.MJVideo` preamble. */
+    Geometry?: {
+        Width?: number;
+        Height?: number;
+        Fps?: number;
+        DurationSeconds?: number;
+    };
+    /**
+     * Whether to inject the CSP `<meta>` and `window.MJVideo` preamble into `.html` files
+     * during initial staging (defaults to `true`).
+     */
+    InjectPreamble?: boolean;
+}
+/**
+ * Parameters validated by `ValidateRenderGeometry`.
+ */
+export interface RenderGeometryParams {
+    Format: VideoFormat;
+    Width: number;
+    Height: number;
+    Fps?: number;
+    DurationSeconds?: number;
+}
+/**
+ * Validates a `RenderProjectBundle`, throwing `RenderWorkerError('InvalidBundle', ...)` on any violation.
+ */
+export declare function ValidateRenderBundle(bundle: RenderProjectBundle): void;
+/**
+ * Validates a bundle-relative path according to Step 5 security rules.
+ */
+export declare function ValidateBundleRelativePath(relPath: string, label: string): void;
+/**
+ * Validates render request geometry, frame rate, and duration, throwing `InvalidRequest` on error.
+ */
+export declare function ValidateRenderGeometry(params: RenderGeometryParams): void;
+export interface CompositionGeometryMatchParams {
+    Width: number;
+    Height: number;
+    DurationSeconds?: number;
+}
+/**
+ * Validates that the entry HTML's `data-width`, `data-height`, and `data-duration` attributes
+ * (if present on `[data-composition-id]`) match the request's `Width`, `Height`, and `DurationSeconds`,
+ * throwing `RenderWorkerError('GEOMETRY_MISMATCH', ...)` (HTTP 400) on mismatch.
+ */
+export declare function ValidateCompositionGeometryMatch(bundle: RenderProjectBundle, params: CompositionGeometryMatchParams): void;
+/**
+ * Reads the entry HTML's `data-fps` attribute on `[data-composition-id]` (or falls back to `defaultFps`),
+ * range-checking it against `MIN_FPS..MAX_FPS` with `RenderWorkerError('InvalidRequest', ...)`.
+ */
+export declare function ResolveCompositionFps(bundle: RenderProjectBundle, defaultFps?: number): number;
+/**
+ * Reads the entry HTML's `data-duration` attribute on `[data-composition-id]` (or falls back to
+ * `defaultDurationSeconds`), range-checking it against `(0, MAX_DURATION_SECONDS]` with
+ * `RenderWorkerError('InvalidRequest', ...)`.
+ */
+export declare function ResolveCompositionDuration(bundle: RenderProjectBundle, defaultDurationSeconds?: number): number;
+/**
+ * Stages a validated `RenderProjectBundle` into a fresh `mkdtemp` directory and injects the preamble
+ * into every `.html` / `.htm` file (unless `options.InjectPreamble === false`).
+ */
+export declare function StageRenderBundle(bundle: RenderProjectBundle, options?: StageBundleOptions): Promise<StagedBundle>;
+/**
+ * Injects the CSP `<meta>`, bundled default `@font-face` `<style>`, and `window.MJVideo`
+ * preamble into every `.html` / `.htm` file of a bundle that was staged with `InjectPreamble: false`,
+ * and stages the worker's bundled SIL OFL default fonts (`Inter` and `JetBrains Mono`) into `__mj_fonts/`.
+ */
+export declare function ApplyPreambleToStagedBundle(rootDir: string, bundle: RenderProjectBundle, preambleOptions: PreambleRuntimeOptions): Promise<void>;
+/**
+ * Validates that `dataBase64` is a well-formed base64 string and returns the decoded `Buffer`.
+ */
+export declare function ValidateStrictBase64(dataBase64: string, label: string, allowEmpty?: boolean, errorCode?: 'InvalidBundle' | 'InvalidRequest'): Buffer;
+/**
+ * Shared entry helper used by `CaptureStills`, `RunCheckCli`, and `MeasureText` to ensure
+ * `path.join(rootDir, 'index.html')` matches `entryFile` by always overwriting `index.html`
+ * when `entryFile !== 'index.html'` (VS-RND-1 Fix 7b / VS-RND-5 Fix 5).
+ */
+export declare function EnsureIndexHtmlForServer(rootDir: string, entryFile: string): Promise<void>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

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