deio-scroll 1.0.0

package/dist/transcode/probe.js

@@ -0,0 +1,91 @@
+import { spawn } from "node:child_process";
+export async function probeVideoDurationMs(inputPath) {
+    return new Promise((resolve) => {
+        const child = spawn("ffprobe", [
+            "-v",
+            "error",
+            "-show_entries",
+            "format=duration",
+            "-of",
+            "default=noprint_wrappers=1:nokey=1",
+            inputPath,
+        ]);
+        let stdout = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.on("error", () => resolve(null));
+        child.on("close", (code) => {
+            if (code !== 0)
+                return resolve(null);
+            const seconds = Number(stdout.trim());
+            if (!Number.isFinite(seconds) || seconds <= 0)
+                return resolve(null);
+            resolve(Math.round(seconds * 1000));
+        });
+    });
+}
+export async function probeVideoSize(inputPath) {
+    return new Promise((resolve) => {
+        const child = spawn("ffprobe", [
+            "-v",
+            "error",
+            "-select_streams",
+            "v:0",
+            "-show_entries",
+            "stream=width,height",
+            "-of",
+            "csv=p=0:s=x",
+            inputPath,
+        ]);
+        let stdout = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.on("error", () => resolve(null));
+        child.on("close", (code) => {
+            if (code !== 0)
+                return resolve(null);
+            const [width, height] = stdout.trim().split("x").map(Number);
+            if (!width || !height)
+                return resolve(null);
+            resolve({ width, height });
+        });
+    });
+}
+export async function probeVideoFps(inputPath) {
+    return new Promise((resolve) => {
+        const child = spawn("ffprobe", [
+            "-v",
+            "error",
+            "-select_streams",
+            "v:0",
+            "-show_entries",
+            "stream=r_frame_rate",
+            "-of",
+            "default=noprint_wrappers=1:nokey=1",
+            inputPath,
+        ]);
+        let stdout = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.on("error", () => resolve(60));
+        child.on("close", (code) => {
+            if (code !== 0)
+                return resolve(60);
+            const parts = stdout.trim().split("/");
+            if (parts.length === 2) {
+                const num = Number(parts[0]);
+                const den = Number(parts[1]);
+                if (num && den)
+                    return resolve(Math.round(num / den));
+            }
+            const val = Number(stdout.trim());
+            if (Number.isFinite(val) && val > 0)
+                return resolve(Math.round(val));
+            resolve(60);
+        });
+    });
+}
+//# sourceMappingURL=probe.js.map

package/dist/transcode/probe.js.map

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

package/dist/transcode/quality.d.ts

@@ -0,0 +1,8 @@
+export type QualityPreset = 'high' | 'medium' | 'low';
+export interface EncodeSettings {
+    crf: number;
+    preset: string;
+    deviceScaleFactor: number;
+}
+export declare function resolveEncodeSettings(qualityPreset?: QualityPreset, requestedScaleFactor?: number): EncodeSettings;
+//# sourceMappingURL=quality.d.ts.map

package/dist/transcode/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/transcode/quality.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,qBAAqB,CACnC,aAAa,GAAE,aAAsB,EACrC,oBAAoB,CAAC,EAAE,MAAM,GAC5B,cAAc,CAYhB"}

package/dist/transcode/quality.js

@@ -0,0 +1,13 @@
+export function resolveEncodeSettings(qualityPreset = 'high', requestedScaleFactor) {
+    const presets = {
+        high: { crf: 15, preset: 'slow', deviceScaleFactor: 2 },
+        medium: { crf: 20, preset: 'medium', deviceScaleFactor: 1 },
+        low: { crf: 26, preset: 'fast', deviceScaleFactor: 1 },
+    };
+    const settings = presets[qualityPreset];
+    return {
+        ...settings,
+        deviceScaleFactor: requestedScaleFactor ?? settings.deviceScaleFactor,
+    };
+}
+//# sourceMappingURL=quality.js.map

package/dist/transcode/quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../../src/transcode/quality.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,qBAAqB,CACnC,gBAA+B,MAAM,EACrC,oBAA6B;IAE7B,MAAM,OAAO,GAA0C;QACrD,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE;QACvD,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,EAAE;QAC3D,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE;KACvD,CAAA;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IACvC,OAAO;QACL,GAAG,QAAQ;QACX,iBAAiB,EAAE,oBAAoB,IAAI,QAAQ,CAAC,iBAAiB;KACtE,CAAA;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,302 @@
+export interface ViewportConfig {
+    width: number;
+    height: number;
+    deviceScaleFactor?: number;
+}
+export interface PauseTrigger {
+    selector: string;
+    durationMs: number;
+}
+export type MotionTarget = {
+    type: "selector";
+    selector: string;
+    align?: "top" | "center" | "bottom";
+    offsetPx?: number;
+    /** Last measured page progress, used when a dynamic selector goes stale. */
+    fallbackProgress?: number;
+} | {
+    type: "progress";
+    value: number;
+} | {
+    type: "page-end";
+};
+export interface MotionBeat {
+    target: MotionTarget;
+    transitionMs: number;
+    curve?: ScrollCurve;
+    holdMs?: number;
+    interaction?: ComponentInteraction;
+}
+export type ComponentInteractionAction = "hover" | "focus" | "click";
+export interface ComponentInteraction {
+    action: ComponentInteractionAction;
+    /** Inspection identity retained for diagnostics. */
+    candidateId?: string;
+    /** Semantic fallback used when a live page changes its DOM path. */
+    label?: string;
+    /** ARIA or element role used with label during selector recovery. */
+    role?: string;
+    /** Maximum camera scale while the component is active. */
+    zoomScale?: number;
+    /** Show and animate a rendered cursor toward the component. */
+    showCursor?: boolean;
+}
+export interface MotionDirection {
+    startHoldMs?: number;
+    beats: MotionBeat[];
+}
+export declare const DEFAULT_DIRECTED_START_HOLD_MS = 1500;
+export interface VideoConfig {
+    framerate?: number;
+    qualityPreset?: "high" | "medium" | "low";
+    viewport: ViewportConfig;
+}
+export type ScrollCurvePreset = "linear" | "ease-in" | "ease-out" | "ease-in-out" | "ease-in-cubic" | "ease-out-cubic" | "ease-in-out-cubic" | "custom";
+export interface ScrollCurve {
+    preset?: ScrollCurvePreset;
+    /** CSS cubic-bezier control points [x1, y1, x2, y2]. Required when preset is "custom". */
+    bezier?: [number, number, number, number];
+}
+export type ScrollMode = "auto" | "document" | "virtual";
+export interface AnimationConfig {
+    pixelsPerFrame?: number;
+    preRecordingDelayMs?: number;
+    removeOverlayElements?: boolean;
+    pauseTriggers?: PauseTrigger[];
+    scrollCurve?: ScrollCurve;
+    /** Target scroll duration in milliseconds. Applies to both document and virtual scroll. */
+    durationMs?: number;
+    /** Capture the top of the page before scrolling, allowing dynamic hero content to settle. */
+    heroHoldMs?: number;
+    /**
+     * How to drive scrolling. `auto` picks document scrolling or virtual wheel
+     * scrolling based on page layout (fixed viewport / infinite scroll sites).
+     */
+    scrollMode?: ScrollMode;
+    /** Virtual-scroll only: viewport-heights worth of wheel input to replay. */
+    virtualScrollCycles?: number;
+    /** Virtual-scroll only: total capture duration in milliseconds. */
+    virtualScrollDurationMs?: number;
+    /** Skip deep hydration, scroll faster, and use quick encoding. */
+    fastMode?: boolean;
+    /** Capture mode: 'preview' (fast, video) or 'export' (high-quality, screenshots) */
+    captureMode?: "preview" | "export";
+    /** Ordered, section-level direction. Takes precedence over legacy global motion settings. */
+    direction?: MotionDirection;
+    scrollSync?: {
+        refMaxScroll: number;
+        refDurationMs: number;
+    };
+}
+export interface RecordRequest {
+    targetUrl: string;
+    exportFormat?: "mp4";
+    videoConfig: VideoConfig;
+    animationConfig?: AnimationConfig;
+    /** Image placed behind a contained recording in the completed capture. */
+    backgroundPreset?: BackgroundPreset;
+    /** Add a soft drop shadow to the contained recording. */
+    addShadow?: boolean;
+    /** Round the contained recording's corners. */
+    roundedCorners?: boolean;
+    /** Capture a second page with the same motion settings and export a paired video. */
+    comparison?: ComparisonConfig;
+    responsiveness?: ResponsivenessConfig;
+}
+export interface ResponsivenessConfig {
+    desktopLabel?: string;
+    mobileLabel?: string;
+    desktopWidth?: number;
+    desktopHeight?: number;
+    mobileWidth?: number;
+    mobileHeight?: number;
+}
+export interface ComparisonConfig {
+    targetUrl: string;
+    primaryLabel: string;
+    secondaryLabel: string;
+    layout?: "side-by-side";
+    primaryLogo?: string;
+    secondaryLogo?: string;
+    /** Base64 data URI (PNG/JPEG/WebP/SVG) for the primary side logo image. Max 512 KB. */
+    primaryLogoDataUrl?: string;
+    /** Base64 data URI (PNG/JPEG/WebP/SVG) for the secondary side logo image. Max 512 KB. */
+    secondaryLogoDataUrl?: string;
+}
+export interface StyleRequest {
+    jobId: string;
+    backgroundPreset?: BackgroundPreset;
+    addShadow?: boolean;
+    roundedCorners?: boolean;
+}
+export interface StyleResult {
+    jobId: string;
+    videoUrl: string;
+    mp4Path: string;
+}
+export type ResolvedScrollStrategy = "document" | "virtual";
+export interface RecordResult {
+    jobId: string;
+    outputDir: string;
+    rawVideoPath: string;
+    mp4Path: string;
+    durationMs: number;
+    renderTimeMs: number;
+    viewport: ViewportConfig;
+    scrollStrategy: ResolvedScrollStrategy;
+    motionPlan?: ResolvedMotionPlan;
+}
+export interface ResolvedMotionBeat {
+    target: MotionTarget;
+    position: number;
+    transitionMs: number;
+    holdMs: number;
+    curve: ScrollCurve;
+    interaction?: ComponentInteraction;
+    framing?: ResolvedBeatFraming;
+}
+export interface ResolvedBeatFraming {
+    selector: string;
+    align: "top" | "center" | "bottom";
+    targetY: number;
+    safeTopPx: number;
+    safeBottomPx: number;
+    verified: boolean;
+}
+export interface ResolvedMotionPlan {
+    mode: ResolvedScrollStrategy;
+    startHoldMs: number;
+    durationMs: number;
+    beats: ResolvedMotionBeat[];
+    adjustments: MotionPlanAdjustment[];
+}
+export interface MotionPlanAdjustment {
+    beatIndex: number;
+    code: "promoted-progress-target" | "merged-nearby-beat" | "replaced-boundary-curve" | "stretched-transition" | "corrected-pause-framing";
+    message: string;
+    requested?: number | string | MotionTarget;
+    resolved?: number | string | MotionTarget;
+}
+export type BackgroundPreset = "none" | "gray_noise_gradient" | "paper_blue" | "red_blocks_gradient";
+export interface WebsiteSection {
+    label: string;
+    selector: string;
+    kind: "heading" | "landmark";
+    imageIndex?: number;
+    y: number;
+    progress: number;
+    height: number;
+    targetY: number;
+    distanceFromPrevious: number;
+    recommendedTransitionMs: number;
+    recommendedTarget: Extract<MotionTarget, {
+        type: "selector";
+    }>;
+}
+export interface StoryboardFrame {
+    imageIndex: number;
+    target: Extract<MotionTarget, {
+        type: "progress";
+    }>;
+    y?: number;
+}
+export interface WebsiteInspection {
+    url: string;
+    title: string;
+    pageHeight: number;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    scrollMode: ResolvedScrollStrategy;
+    safeViewport: {
+        topInsetPx: number;
+        bottomInsetPx: number;
+    };
+    sections: WebsiteSection[];
+    interactions: WebsiteInteractionCandidate[];
+    storyboard: StoryboardFrame[];
+    screenshots: string[];
+    warnings: string[];
+}
+export interface WebsiteInteractionCandidate {
+    id: string;
+    selector: string;
+    label: string;
+    tag: string;
+    role: string;
+    actions: ComponentInteractionAction[];
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    recommendedTarget: Extract<MotionTarget, {
+        type: "selector";
+    }>;
+    recommendedHoldMs: number;
+    recommendedZoomScale: number;
+    recommendedInteraction: ComponentInteraction;
+}
+export type RecordingJobStatus = "queued" | "running" | "completed" | "failed" | "cancelled" | "interrupted";
+export type RecordingJobStage = "queued" | "preparing" | "capturing" | "encoding" | "styling" | "finalizing" | "completed" | "failed" | "cancelled" | "interrupted";
+export interface RecordingJobProgress {
+    stage: RecordingJobStage;
+    percent: number;
+    message: string;
+}
+export interface RecordingJobResult {
+    videoUrl: string;
+    sourceVideoUrl?: string;
+    thumbnailUrl?: string;
+    durationMs: number;
+    renderTimeMs: number;
+    sizeBytes: number;
+    viewport: ViewportConfig;
+    scrollStrategy: ResolvedScrollStrategy;
+    motionPlan?: ResolvedMotionPlan;
+    canRestyle: boolean;
+    comparison?: {
+        primaryUrl: string;
+        secondaryUrl: string;
+        primaryLabel: string;
+        secondaryLabel: string;
+        layout: "side-by-side";
+        primaryLogo?: string;
+        secondaryLogo?: string;
+        primaryLogoDataUrl?: string;
+        secondaryLogoDataUrl?: string;
+    };
+    responsiveness?: {
+        desktopLabel: string;
+        mobileLabel: string;
+        desktopWidth: number;
+        desktopHeight: number;
+        mobileWidth: number;
+        mobileHeight: number;
+    };
+}
+export interface RecordingJobManifest {
+    schemaVersion: 1;
+    jobId: string;
+    /** Stable tenancy seams used by the local SQLite store and future hosted adapters. */
+    workspaceId?: string;
+    projectId?: string;
+    targetUrl: string;
+    title?: string;
+    createdAt: string;
+    updatedAt: string;
+    status: RecordingJobStatus;
+    progress: RecordingJobProgress;
+    request?: RecordRequest;
+    result?: RecordingJobResult;
+    error?: {
+        stage: RecordingJobStage;
+        message: string;
+    };
+    attempt: number;
+    parentJobId?: string;
+    legacy?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACpC;AAED,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,0BAA0B,CAAC;IACnC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1C,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACnC,6FAA6F;IAC7F,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qFAAqF;IACrF,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EACA,0BAA0B,GAC1B,oBAAoB,GACpB,yBAAyB,GACzB,sBAAsB,GACtB,yBAAyB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,qBAAqB,GACrB,YAAY,GACZ,qBAAqB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IACpD,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE,sBAAsB,CAAC;IACnC,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,YAAY,EAAE,2BAA2B,EAAE,CAAC;IAC5C,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACtC,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,iBAAiB,EAAE,OAAO,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAC/D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,oBAAoB,CAAC;CAC9C;AAED,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,aAAa,CAAC;AAElB,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,WAAW,GACX,aAAa,CAAC;AAElB,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,cAAc,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,cAAc,CAAC,EAAE;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,iBAAiB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const DEFAULT_DIRECTED_START_HOLD_MS = 1_500;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAoDA,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/worker.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import path from "node:path";
+import { RecordingJobManager } from "./jobs/manager.js";
+const outputRoot = path.resolve(process.env.OUTPUT_DIR ?? "./outputs");
+const worker = new RecordingJobManager(outputRoot, {
+    processJobs: true,
+    recoverRunning: "requeue",
+    workerId: process.env.WORKER_ID,
+});
+await worker.initialize();
+console.log(`Deio Scroll capture worker listening for jobs in ${outputRoot}`);
+// The manager's poll timer is deliberately unreferenced for embedded CLI/MCP use.
+const keepAlive = setInterval(() => undefined, 60_000);
+const shutdown = async () => {
+    clearInterval(keepAlive);
+    await worker.shutdown();
+    process.exit(0);
+};
+process.once("SIGINT", () => void shutdown());
+process.once("SIGTERM", () => void shutdown());
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,WAAW,CAAC,CAAC;AACvE,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,UAAU,EAAE;IACjD,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;CAChC,CAAC,CAAC;AAEH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;AAC1B,OAAO,CAAC,GAAG,CAAC,oDAAoD,UAAU,EAAE,CAAC,CAAC;AAE9E,kFAAkF;AAClF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAEvD,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;IAC1B,aAAa,CAAC,SAAS,CAAC,CAAC;IACzB,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC9C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "deio-scroll",
+  "version": "1.0.0",
+  "description": "Deio Scroll API and worker for directed website scroll videos",
+  "license": "MIT",
+  "author": "ken-rl (https://github.com/ken-rl)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ken-rl/website_recorder.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ken-rl/website_recorder/issues"
+  },
+  "homepage": "https://github.com/ken-rl/website_recorder#readme",
+  "keywords": [
+    "playwright",
+    "screen-recording",
+    "video",
+    "webpage",
+    "scroll",
+    "mp4",
+    "ffmpeg",
+    "website-recorder"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "bin": {
+    "deio": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "public",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "tsx src/api/server.ts",
+    "start:watch": "tsx watch src/api/server.ts",
+    "worker": "tsx src/worker.ts",
+    "worker:watch": "tsx watch src/worker.ts",
+    "record": "tsx src/cli.ts",
+    "build:web": "pnpm --dir ../web build",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "pnpm run build:web && pnpm run clean && tsc -p tsconfig.build.json",
+    "prepack": "pnpm run build",
+    "test": "tsx --test \"src/**/*.test.ts\"",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.11.1",
+    "dotenv": "^16.4.7",
+    "playwright": "^1.40.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}