@filmwhisper/shared-types 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FilmWhisper Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/schemas.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schemas.test.d.ts.map

package/dist/__tests__/schemas.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schemas.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/schemas.test.js

@@ -0,0 +1,222 @@
+/**
+ * TDD RED → GREEN: Zod schema validation tests for fw-files core types
+ */
+import { describe, it, expect } from "vitest";
+import { SegmentSchema, UtteranceSchema, TranscriptSchema, FwProjectSchema, ProcessingStatusSchema, JobStatusSchema, ReviewStatusSchema, TimelineClipSchema, JobSchema, } from "../schemas/fw-files.schema.js";
+// ============================================================
+// Segment
+// ============================================================
+describe("SegmentSchema", () => {
+    const validSegment = {
+        segment_index: 0,
+        start_ms: 0,
+        end_ms: 5000,
+        editorial_role: "establishing",
+        energy: 7,
+        story_value: 8,
+        summary: "Wide shot of sunset over the ocean",
+    };
+    it("should validate a valid segment", () => {
+        const result = SegmentSchema.safeParse(validSegment);
+        expect(result.success).toBe(true);
+    });
+    it("should reject segment with negative start_ms", () => {
+        const result = SegmentSchema.safeParse({ ...validSegment, start_ms: -1 });
+        expect(result.success).toBe(false);
+    });
+    it("should reject segment where end_ms <= start_ms", () => {
+        const result = SegmentSchema.safeParse({
+            ...validSegment,
+            start_ms: 5000,
+            end_ms: 3000,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject segment with empty summary", () => {
+        const result = SegmentSchema.safeParse({ ...validSegment, summary: "" });
+        expect(result.success).toBe(false);
+    });
+    it("should reject segment without required fields", () => {
+        const result = SegmentSchema.safeParse({
+            segment_index: 0,
+            start_ms: 0,
+        });
+        expect(result.success).toBe(false);
+    });
+});
+// ============================================================
+// Utterance
+// ============================================================
+describe("UtteranceSchema", () => {
+    const validUtterance = {
+        speaker_label: "Speaker 1",
+        text: "Hello world",
+        start_ms: 0,
+        end_ms: 2000,
+        confidence: 0.95,
+    };
+    it("should validate a valid utterance", () => {
+        const result = UtteranceSchema.safeParse(validUtterance);
+        expect(result.success).toBe(true);
+    });
+    it("should reject confidence > 1", () => {
+        const result = UtteranceSchema.safeParse({
+            ...validUtterance,
+            confidence: 1.5,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject confidence < 0", () => {
+        const result = UtteranceSchema.safeParse({
+            ...validUtterance,
+            confidence: -0.1,
+        });
+        expect(result.success).toBe(false);
+    });
+});
+// ============================================================
+// Transcript
+// ============================================================
+describe("TranscriptSchema", () => {
+    it("should validate a valid transcript", () => {
+        const result = TranscriptSchema.safeParse({
+            speakers: ["Speaker 1", "Speaker 2"],
+            utterances: [
+                {
+                    speaker_label: "Speaker 1",
+                    text: "Hello",
+                    start_ms: 0,
+                    end_ms: 1000,
+                    confidence: 0.9,
+                },
+            ],
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should allow empty speakers and utterances", () => {
+        const result = TranscriptSchema.safeParse({
+            speakers: [],
+            utterances: [],
+        });
+        expect(result.success).toBe(true);
+    });
+});
+// ============================================================
+// ProcessingStatus / JobStatus / ReviewStatus (enums)
+// ============================================================
+describe("Status enums", () => {
+    it("ProcessingStatus accepts valid values", () => {
+        for (const v of ["pending", "running", "complete", "failed"]) {
+            expect(ProcessingStatusSchema.safeParse(v).success).toBe(true);
+        }
+    });
+    it("ProcessingStatus rejects invalid values", () => {
+        expect(ProcessingStatusSchema.safeParse("cancelled").success).toBe(false);
+    });
+    it("JobStatus accepts cancelled", () => {
+        expect(JobStatusSchema.safeParse("cancelled").success).toBe(true);
+    });
+    it("ReviewStatus accepts valid values", () => {
+        for (const v of ["keep", "exclude", "needs_review"]) {
+            expect(ReviewStatusSchema.safeParse(v).success).toBe(true);
+        }
+    });
+});
+// ============================================================
+// FwProject
+// ============================================================
+describe("FwProjectSchema", () => {
+    const validProject = {
+        fw_version: "1.0.0",
+        schema: "project",
+        name: "My Film",
+        source_path: "/videos/raw",
+        language: "ko",
+        created_at: "2026-03-20T00:00:00Z",
+        updated_at: "2026-03-20T00:00:00Z",
+    };
+    it("should validate a valid project", () => {
+        const result = FwProjectSchema.safeParse(validProject);
+        expect(result.success).toBe(true);
+    });
+    it("should accept optional fields", () => {
+        const result = FwProjectSchema.safeParse({
+            ...validProject,
+            proxy_spec: "1280x720",
+            target_duration_seconds: 120,
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject schema !== 'project'", () => {
+        const result = FwProjectSchema.safeParse({
+            ...validProject,
+            schema: "asset",
+        });
+        expect(result.success).toBe(false);
+    });
+});
+// ============================================================
+// TimelineClip
+// ============================================================
+describe("TimelineClipSchema", () => {
+    const validClip = {
+        id: "clip_001",
+        asset_hash: "abc123",
+        clip_index: 0,
+        in_point_ms: 0,
+        out_point_ms: 5000,
+        created_at: "2026-03-20T00:00:00Z",
+        updated_at: "2026-03-20T00:00:00Z",
+    };
+    it("should validate a valid clip", () => {
+        const result = TimelineClipSchema.safeParse(validClip);
+        expect(result.success).toBe(true);
+    });
+    it("should accept optional editorial_rationale", () => {
+        const result = TimelineClipSchema.safeParse({
+            ...validClip,
+            editorial_rationale: "Establishing shot for scene transition",
+        });
+        expect(result.success).toBe(true);
+    });
+    it("should reject clip where out_point <= in_point", () => {
+        const result = TimelineClipSchema.safeParse({
+            ...validClip,
+            in_point_ms: 5000,
+            out_point_ms: 3000,
+        });
+        expect(result.success).toBe(false);
+    });
+});
+// ============================================================
+// Job
+// ============================================================
+describe("JobSchema", () => {
+    const validJob = {
+        job_id: "job_001",
+        type: "transcode",
+        status: "pending",
+        progress_pct: 0,
+        created_at: "2026-03-20T00:00:00Z",
+        updated_at: "2026-03-20T00:00:00Z",
+    };
+    it("should validate a valid job", () => {
+        const result = JobSchema.safeParse(validJob);
+        expect(result.success).toBe(true);
+    });
+    it("should reject progress_pct > 100", () => {
+        const result = JobSchema.safeParse({
+            ...validJob,
+            progress_pct: 150,
+        });
+        expect(result.success).toBe(false);
+    });
+    it("should reject progress_pct < 0", () => {
+        const result = JobSchema.safeParse({
+            ...validJob,
+            progress_pct: -10,
+        });
+        expect(result.success).toBe(false);
+    });
+});
+//# sourceMappingURL=schemas.test.js.map

package/dist/__tests__/schemas.test.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MCP error codes for FilmWhisper v2
+ * See: DESIGN.md §4 공통 규약
+ */
+export declare const MCP_ERROR_CODES: {
+    readonly PROJECT_NOT_FOUND: "project_not_found";
+    readonly ASSET_NOT_FOUND: "asset_not_found";
+    readonly INVALID_INPUT: "invalid_input";
+    readonly PROCESSING_IN_PROGRESS: "processing_in_progress";
+    readonly NO_EDIT_PACKAGE: "no_edit_package";
+    readonly STALE_EDIT_PACKAGE: "stale_edit_package";
+    readonly INSUFFICIENT_FOOTAGE: "insufficient_footage";
+    readonly FFMPEG_ERROR: "ffmpeg_error";
+    readonly PROVIDER_ERROR: "provider_error";
+    readonly ENGINE_UNAVAILABLE: "engine_unavailable";
+    readonly LOCK_CONFLICT: "lock_conflict";
+    readonly REVISION_CONFLICT: "revision_conflict";
+    readonly JOB_CANCELLED: "job_cancelled";
+    readonly DEPENDENCY_NOT_READY: "dependency_not_ready";
+    readonly PROVIDER_TIMEOUT: "provider_timeout";
+    readonly CORRUPT_PROJECT: "corrupt_project";
+    readonly MEDIA_MISSING: "media_missing";
+};
+export type McpErrorCode = (typeof MCP_ERROR_CODES)[keyof typeof MCP_ERROR_CODES];
+export interface McpError {
+    code: McpErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/** Error envelope as specified in DESIGN.md §4: { error: { code, message, details } } */
+export interface McpErrorResponse {
+    error: McpError;
+}
+//# 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;;;GAGG;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAkBlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAElF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,QAAQ,CAAC;CACjB"}

package/dist/errors.js

@@ -0,0 +1,24 @@
+/**
+ * MCP error codes for FilmWhisper v2
+ * See: DESIGN.md §4 공통 규약
+ */
+export const MCP_ERROR_CODES = {
+    PROJECT_NOT_FOUND: "project_not_found",
+    ASSET_NOT_FOUND: "asset_not_found",
+    INVALID_INPUT: "invalid_input",
+    PROCESSING_IN_PROGRESS: "processing_in_progress",
+    NO_EDIT_PACKAGE: "no_edit_package",
+    STALE_EDIT_PACKAGE: "stale_edit_package",
+    INSUFFICIENT_FOOTAGE: "insufficient_footage",
+    FFMPEG_ERROR: "ffmpeg_error",
+    PROVIDER_ERROR: "provider_error",
+    ENGINE_UNAVAILABLE: "engine_unavailable",
+    LOCK_CONFLICT: "lock_conflict",
+    REVISION_CONFLICT: "revision_conflict",
+    JOB_CANCELLED: "job_cancelled",
+    DEPENDENCY_NOT_READY: "dependency_not_ready",
+    PROVIDER_TIMEOUT: "provider_timeout",
+    CORRUPT_PROJECT: "corrupt_project",
+    MEDIA_MISSING: "media_missing",
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;IAC9B,sBAAsB,EAAE,wBAAwB;IAChD,eAAe,EAAE,iBAAiB;IAClC,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,sBAAsB;IAC5C,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,eAAe;IAC9B,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,oBAAoB,EAAE,sBAAsB;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;CACtB,CAAC"}

package/dist/fw-files.d.ts

@@ -0,0 +1,140 @@
+/**
+ * .fw file format types (JSON files — immutable data) + SQLite row types (mutable state)
+ * See: DESIGN.md §2.1
+ */
+export interface FwProject {
+    fw_version: string;
+    schema: "project";
+    name: string;
+    source_path: string;
+    language: string;
+    proxy_spec?: string;
+    target_duration_seconds?: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface FwAsset {
+    fw_version: string;
+    schema: "asset";
+    asset_hash: string;
+    filename: string;
+    source_path: string;
+    duration_seconds: number;
+    created_at: string;
+    updated_at: string;
+    transcode_status: ProcessingStatus;
+    transcribe_status: ProcessingStatus;
+    analyze_status: ProcessingStatus;
+    proxy_path?: string;
+    analysis?: AssetAnalysis;
+    transcript?: Transcript;
+    segments?: Segment[];
+}
+/** Asset-level processing status (subset — no "cancelled" since assets aren't cancelled individually) */
+export type ProcessingStatus = "pending" | "running" | "complete" | "failed";
+/** Job-level status (full set, maps to jobs table CHECK constraint) */
+export type JobStatus = "pending" | "running" | "complete" | "failed" | "cancelled";
+export interface TechnicalAnalysis {
+    scenes: Array<{
+        start_ms: number;
+        end_ms: number;
+        score: number;
+    }>;
+    audio_levels: {
+        mean_volume_db: number;
+        max_volume_db: number;
+    };
+    silence_ranges: Array<{
+        start_ms: number;
+        end_ms: number;
+    }>;
+    duration_ms: number;
+}
+export interface SemanticAnalysis {
+    subject: string;
+    editorial_role: string;
+    energy: number;
+    shot_type: string;
+    story_value: number;
+    summary: string;
+}
+export interface AssetAnalysis {
+    technical?: TechnicalAnalysis;
+    semantic?: SemanticAnalysis;
+    segments?: Segment[];
+}
+export interface Transcript {
+    speakers: string[];
+    utterances: Utterance[];
+}
+export interface Utterance {
+    speaker_label: string;
+    text: string;
+    start_ms: number;
+    end_ms: number;
+    confidence: number;
+}
+export interface Segment {
+    segment_index: number;
+    start_ms: number;
+    end_ms: number;
+    editorial_role: string;
+    energy: number;
+    story_value: number;
+    summary: string;
+}
+export type ExportFormat = "premiere-xml" | "davinci-xml" | "fcpxml";
+export type RevisionScope = "timeline" | "reviews" | "project" | "jobs" | "fts";
+export interface RevisionEntry {
+    scope: RevisionScope;
+    revision: number;
+}
+export interface Job {
+    job_id: string;
+    type: string;
+    status: JobStatus;
+    progress_pct: number;
+    result?: Record<string, unknown>;
+    error?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface UndoOperation {
+    type: string;
+    before: Record<string, unknown> | null;
+    after: Record<string, unknown> | null;
+}
+export interface UndoHistoryEntry {
+    id: number;
+    scope: RevisionScope;
+    operation: UndoOperation;
+    created_at: string;
+}
+export type ReviewStatus = "keep" | "exclude" | "needs_review";
+export interface TimelineClip {
+    id: string;
+    asset_hash: string;
+    clip_index: number;
+    in_point_ms: number;
+    out_point_ms: number;
+    editorial_rationale?: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface SegmentReview {
+    asset_hash: string;
+    segment_index: number;
+    status: ReviewStatus;
+    reviewer?: string;
+    updated_at: string;
+}
+export interface SegmentSource {
+    rowid?: number;
+    asset_hash: string;
+    segment_index: number;
+    transcript_text?: string;
+    analysis_summary?: string;
+    editorial_role?: string;
+    speaker_labels?: string;
+}
+//# sourceMappingURL=fw-files.d.ts.map

package/dist/fw-files.d.ts.map

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

package/dist/fw-files.js

@@ -0,0 +1,6 @@
+/**
+ * .fw file format types (JSON files — immutable data) + SQLite row types (mutable state)
+ * See: DESIGN.md §2.1
+ */
+export {};
+//# sourceMappingURL=fw-files.js.map

package/dist/fw-files.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./ipc.js";
+export * from "./fw-files.js";
+export * from "./mcp-tools.js";
+export * 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,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./ipc.js";
+export * from "./fw-files.js";
+export * from "./mcp-tools.js";
+export * from "./errors.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,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}