refactor services structure

.cursor/rules/codebase-index.mdc

@@ -16,6 +16,16 @@ When implementing new features:
 3. Understand the API surface of your codebase
 
 ```typescript
+## apps/web/src/components/editor/timeline
+
+audio-waveform.tsx
+  export function AudioWaveform({␍
+  	audioUrl,␍
+  	audioBuffer,␍
+  	height = 32,␍
+  	className = "",␍
+  }: AudioWaveformProps)
+
 ## apps/web/src/constants
 
 editor-constants.ts
@@ -574,7 +584,7 @@ definitions.ts
   	| "selection"␍
   	| "history"␍
   	| "timeline"␍
-  	| "controls"
+  	| "con...
   export interface TActionDefinition {
     description: string
     category: TActionCategory
@@ -604,7 +614,7 @@ registry.ts
 types.ts
   export type TActionArgsMap = {␍
   	"seek-forward": { seconds: number } | undefined;␍
-  	"seek-backward": { seconds: number } | undef...
+  	"seek-backward": { seconds: number } | und...
   export type TActionWithArgs = keyof TActionArgsMap
   export type TActionWithOptionalArgs = | TActionWithNoArgs␍
   	| TKeysWithValueUndefined<TActionArgsMap>
@@ -614,7 +624,7 @@ types.ts
   	: undefined
   export type TActionFunc<A extends TAction> = A extends TActionWithArgs␍
   	? (arg: TArgOfAction<A>, trigger?: TInvocationTrigger) => void␍
-  	: (_?:...
+  	: (_...
   export type TInvocationTrigger = "keypress" | "mouseclick"
   export type TBoundActionList = {␍
   	[A in TAction]?: Array<TActionFunc<A>>;␍
@@ -673,12 +683,12 @@ parser.ts
   export type GradientOrientation = LinearOrientation | Array<RadialOrientation>
   export type Color = | { type: "hex"; value: string }␍
   	| { type: "literal"; value: string }␍
-  	| { type: "rgb"; value: A...
+  	| { type: "rgb"; value:...
   export type ColorStop = Color & { length?: Distance }
   export type GradientAst = {␍
   	type: GradientType;␍
   	orientation: GradientOrientation | undefined;␍
-  	colorStops: Array<ColorSto...
+  	colorStops: Array<Color...
   export const parseGradient = ({␍
   	code,␍
   }: {␍
@@ -691,8 +701,7 @@ parser.ts
 audio.ts
   export type CollectedAudioElement = Omit<␍
   	AudioElement,␍
-  	"type" | "mediaId" | "volume" | "id" | "name" | "sourceType" | "sourceUrl"
+  	"type" | "mediaId" | "volume" | "id" | "name" | "sourceType" | "sourceUrl...
-  ...
   export function createAudioContext(): AudioContext
   export interface DecodedAudio {
     samples: Float32Array
@@ -1119,27 +1128,6 @@ caption.ts
   	minDuration?: number;␍
   }): CaptionChunk[]
 
-## apps/web/src/services/media
-
-video-cache.ts
-  export class VideoCache {
-    sinks
-    initPromises
-    async getFrameAt({
-  		mediaId,
-  		file,
-  		time,
-  	}: {
-  		mediaId: string;
-  		file: File;
-  		time: number;
-  	}): Promise<WrappedCanvas | null>
-    clearVideo({ mediaId }: { mediaId: string }): void
-    clearAll(): void
-    getStats()
-  }
-  export const videoCache
-
 ## apps/web/src/services/renderer
 
 canvas-renderer.ts
@@ -1173,7 +1161,7 @@ scene-builder.ts
   	canvasSize: TCanvasSize;␍
   	tracks: TimelineTrack[];␍
   	mediaAssets: MediaAsset[];␍
-  	duration: numb...
+  	duration: ...
   export function buildScene(params: BuildSceneParams)
 
 scene-exporter.ts
@@ -1183,7 +1171,7 @@ scene-exporter.ts
   	progress: [progress: number];␍
   	complete: [buffer: ArrayBuffer];␍
   	error: [error: Error];␍
-  	cance...
+  	c...
   export class SceneExporter extends EventEmitter<SceneExporterEvents> {
     renderer: CanvasRenderer
     format: ExportFormat
@@ -1236,7 +1224,7 @@ opfs-adapter.ts
     static isSupported(): boolean
   }
 
-storage-service.ts
+service.ts
   export const storageService
 
 types.ts
@@ -1270,11 +1258,10 @@ types.ts
   	"createdAt" | "updatedAt"␍
   > & {␍
   	createdAt: string;␍
-  	updatedAt: string;
+  	updatedAt: st...
-  }
   export type SerializedProject = Omit<TProject, "metadata" | "scenes"> & {␍
   	metadata: SerializedProjectMetadata;␍
-  	scenes: Serializ...
+  	scenes: Serial...
   export interface StorageConfig {
     projectsDb: string
     mediaDb: string
@@ -1284,15 +1271,36 @@ types.ts
 
 ## apps/web/src/services/transcription
 
-index.ts
+service.ts
   export const transcriptionService
 
 worker.ts
   export type WorkerMessage = | { type: "init"; modelId: string }␍
-  	| { type: "transcribe"; audio: Float32Array; language: strin...
+  	| { type: "transcribe"; audio: Float32Array; language: stri...
   export type WorkerResponse = | { type: "init-progress"; progress: number }␍
   	| { type: "init-complete" }␍
-  	| { type: "init-error...
+  	| { type: "init-err...
+
+## apps/web/src/services/video-cache
+
+service.ts
+  export class VideoCache {
+    sinks
+    initPromises
+    async getFrameAt({␍
+  		mediaId,␍
+  		file,␍
+  		time,␍
+  	}: {␍
+  		mediaId: string;␍
+  		file: File;␍
+  		time: number;␍
+  	}): Promise<WrappedCanvas | null>
+    clearVideo({ mediaId }: { mediaId: string }): void
+    clearAll(): void
+    getStats()
+  }
+  export const videoCache
 
 ## apps/web/src/stores
 
@@ -1360,13 +1368,13 @@ blog.ts
   	title: string;␍
   	content: string;␍
   	description: string;␍
-  	coverImage...
+  	cove...
   export type Pagination = {␍
   	limit: number;␍
   	currpage: number;␍
   	nextPage: number | null;␍
   	prevPage: number | null;␍
-  	totalIt...
+  	to...
   export type MarblePostList = {␍
   	posts: Post[];␍
   	pagination: Pagination;␍
@@ -1469,9 +1477,7 @@ keybinding.ts
   	| "j"␍
   	| "k"␍
   	| "l"␍
-  	| "m"
+  	|...
-  	| "n"
-  ...
   export type ModifierBasedShortcutKey = `${ModifierKeys}+${Key}`
   export type SingleCharacterShortcutKey = `${Key}`
   export type ShortcutKey = ModifierBasedShortcutKey | SingleCharacterShortcutKey
@@ -1490,8 +1496,7 @@ project.ts
   	  }␍
   	| {␍
   			type: "blur";␍
-  			blurIntensity: number;
+  			blurIntensity: number...
-  	  }
   export interface TCanvasSize {
     width: number
     height: number
@@ -1679,7 +1684,7 @@ timeline.ts
   	| CreateVideoElement␍
   	| CreateImageElement␍
   	| CreateTextElement␍
-  	| CreateSt...
+  	| Crea...
   export interface ElementDragState {
     isDragging: boolean
     elementId: string | null

apps/web/src/components/editor/panels/assets/views/captions.tsx

@@ -17,7 +17,7 @@ import type {
 	TranscriptionLanguage,
 	TranscriptionProgress,
 } from "@/types/transcription";
-import { transcriptionService } from "@/services/transcription";
+import { transcriptionService } from "@/services/transcription/service";
 import { decodeAudioToFloat32 } from "@/lib/media/audio";
 import { buildCaptionChunks } from "@/lib/transcription/caption";
 import { Spinner } from "@/components/ui/spinner";

apps/web/src/components/storage-provider.tsx

@@ -3,7 +3,7 @@
 import { createContext, useContext, useEffect, useRef, useState } from "react";
 import { toast } from "sonner";
 import { useEditor } from "@/hooks/use-editor";
-import { storageService } from "@/services/storage/storage-service";
+import { storageService } from "@/services/storage/service";
 
 interface StorageContextType {
 	isInitialized: boolean;

apps/web/src/core/managers/media-manager.ts

@@ -1,8 +1,8 @@
 import type { EditorCore } from "@/core";
 import type { MediaAsset } from "@/types/assets";
-import { storageService } from "@/services/storage/storage-service";
+import { storageService } from "@/services/storage/service";
 import { generateUUID } from "@/utils/id";
-import { videoCache } from "@/services/media/video-cache";
+import { videoCache } from "@/services/video-cache/service";
 import { hasMediaId } from "@/lib/timeline/element-utils";
 
 export class MediaManager {

apps/web/src/core/managers/project-manager.ts

@@ -8,7 +8,7 @@ import type {
 	TTimelineViewState,
 } from "@/types/project";
 import type { ExportOptions, ExportResult } from "@/types/export";
-import { storageService } from "@/services/storage/storage-service";
+import { storageService } from "@/services/storage/service";
 import { toast } from "sonner";
 import { generateUUID } from "@/utils/id";
 import { UpdateProjectSettingsCommand } from "@/lib/commands/project";

apps/web/src/core/managers/scenes-manager.ts

@@ -1,6 +1,6 @@
 import type { EditorCore } from "@/core";
 import type { TimelineTrack, TScene } from "@/types/timeline";
-import { storageService } from "@/services/storage/storage-service";
+import { storageService } from "@/services/storage/service";
 import {
 	getMainScene,
 	ensureMainScene,

apps/web/src/lib/commands/media/add-media-asset.ts

@@ -2,7 +2,7 @@ import { Command } from "@/lib/commands/base-command";
 import { EditorCore } from "@/core";
 import type { MediaAsset } from "@/types/assets";
 import { generateUUID } from "@/utils/id";
-import { storageService } from "@/services/storage/storage-service";
+import { storageService } from "@/services/storage/service";
 
 export class AddMediaAssetCommand extends Command {
 	private assetId: string;

apps/web/src/lib/commands/media/remove-media-asset.ts

@@ -1,8 +1,8 @@
 import { Command } from "@/lib/commands/base-command";
 import { EditorCore } from "@/core";
 import type { MediaAsset } from "@/types/assets";
-import { storageService } from "@/services/storage/storage-service";
+import { storageService } from "@/services/storage/service";
-import { videoCache } from "@/services/media/video-cache";
+import { videoCache } from "@/services/video-cache/service";
 import { hasMediaId } from "@/lib/timeline/element-utils";
 import type { TimelineTrack } from "@/types/timeline";
 

apps/web/src/services/storage/service.ts

@@ -333,12 +333,9 @@ class StorageService {
 		]);
 	}
 
-	// Utility methods
 	async clearAllData(): Promise<void> {
-		// Clear all projects
 		await this.projectsAdapter.clear();
-
+		// project-specific media and timelines cleaned up when projects are deleted
-		// Note: Project-specific media and timelines will be cleaned up when projects are deleted
 	}
 
 	async getStorageInfo(): Promise<{
@@ -392,7 +389,6 @@ class StorageService {
 		try {
 			const currentData = await this.loadSavedSounds();
 
-			// Check if sound is already saved
 			if (currentData.sounds.some((sound) => sound.id === soundEffect.id)) {
 				return; // Already saved
 			}
@@ -456,7 +452,6 @@ class StorageService {
 		}
 	}
 
-	// Check browser support
 	isOPFSSupported(): boolean {
 		return OPFSAdapter.isSupported();
 	}
@@ -470,6 +465,5 @@ class StorageService {
 	}
 }
 
-// Export singleton instance
 export const storageService = new StorageService();
 export { StorageService };

apps/web/src/services/transcription/service.ts

@@ -1,4 +1,5 @@
 import type {
+	TranscriptionLanguage,
 	TranscriptionResult,
 	TranscriptionProgress,
 	TranscriptionModelId,
@@ -8,7 +9,6 @@ import {
 	TRANSCRIPTION_MODELS,
 } from "@/constants/transcription-constants";
 import type { WorkerMessage, WorkerResponse } from "./worker";
-import type { LanguageCode } from "@/types/language";
 
 type ProgressCallback = (progress: TranscriptionProgress) => void;
 
@@ -20,12 +20,12 @@ class TranscriptionService {
 
 	async transcribe({
 		audioData,
-		language,
+		language = "auto",
 		modelId = DEFAULT_TRANSCRIPTION_MODEL,
 		onProgress,
 	}: {
 		audioData: Float32Array;
-		language?: LanguageCode;
+		language?: TranscriptionLanguage;
 		modelId?: TranscriptionModelId;
 		onProgress?: ProgressCallback;
 	}): Promise<TranscriptionResult> {

apps/web/src/services/video-cache/service.ts

@@ -15,6 +15,7 @@ interface VideoSinkData {
 	prefetching: boolean;
 	prefetchPromise: Promise<void> | null;
 }
+
 export class VideoCache {
 	private sinks = new Map<string, VideoSinkData>();
 	private initPromises = new Map<string, Promise<void>>();
@@ -311,4 +312,5 @@ export class VideoCache {
 		};
 	}
 }
+
 export const videoCache = new VideoCache();

apps/web/src/stores/sounds-store.ts

@@ -1,6 +1,6 @@
 import { create } from "zustand";
 import type { SoundEffect, SavedSound } from "@/types/sounds";
-import { storageService } from "@/services/storage/storage-service";
+import { storageService } from "@/services/storage/service";
 import { toast } from "sonner";
 import { EditorCore } from "@/core";
 import { buildLibraryAudioElement } from "@/lib/timeline/element-utils";