@kajidog/voicevox-client 0.4.1 → 0.6.0

package/dist/effect/services/file-manager-service.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Effect-based AudioFileManager service implementation
+ * Provides structured error handling and resource management for file operations
+ */
+import { Context, Effect, Layer, type Scope } from 'effect';
+import { type FileOperationError } from '../errors';
+/**
+ * EffectFileManagerService interface
+ */
+export interface EffectFileManagerService {
+    readonly saveTempAudioFile: (audioData: ArrayBuffer) => Effect.Effect<string, FileOperationError>;
+    readonly saveAudioFile: (audioData: ArrayBuffer, output: string, forceDownload?: boolean) => Effect.Effect<string, FileOperationError>;
+    readonly deleteTempFile: (filePath: string) => Effect.Effect<void, FileOperationError>;
+    readonly createTempFilePath: () => Effect.Effect<string, FileOperationError>;
+    readonly createBlobUrl: (blob: Blob) => Effect.Effect<string, FileOperationError>;
+    readonly releaseBlobUrl: (url: string) => Effect.Effect<void, never>;
+    readonly releaseAllBlobUrls: () => Effect.Effect<void, never>;
+    readonly withTempFile: <A, E>(audioData: ArrayBuffer, use: (filePath: string) => Effect.Effect<A, E>) => Effect.Effect<A, E | FileOperationError>;
+    readonly deleteMultipleTempFiles: (filePaths: readonly string[]) => Effect.Effect<void, FileOperationError>;
+    readonly saveMultipleTempAudioFiles: (audioDataArray: readonly ArrayBuffer[]) => Effect.Effect<readonly string[], FileOperationError>;
+    readonly getFileSize: (filePath: string) => Effect.Effect<number | null, FileOperationError>;
+    readonly cleanup: () => Effect.Effect<void, never>;
+}
+export declare const EffectFileManagerContext: Context.Tag<EffectFileManagerService, EffectFileManagerService>;
+/**
+ * Effect-based implementation of AudioFileManager service
+ */
+export declare class EffectFileManagerServiceImpl implements EffectFileManagerService {
+    private blobUrls;
+    /**
+     * Save audio data to temporary file with Effect-based error handling
+     */
+    saveTempAudioFile: (audioData: ArrayBuffer) => Effect.Effect<string, FileOperationError>;
+    /**
+     * Save audio data to specific file path with Effect-based error handling
+     */
+    saveAudioFile: (audioData: ArrayBuffer, output: string, forceDownload?: boolean) => Effect.Effect<string, FileOperationError>;
+    /**
+     * Delete temporary file with Effect-based error handling
+     */
+    deleteTempFile: (filePath: string) => Effect.Effect<void, FileOperationError>;
+    /**
+     * Create temporary file path with Effect-based error handling
+     */
+    createTempFilePath: () => Effect.Effect<string, FileOperationError>;
+    /**
+     * Create blob URL with Effect-based error handling
+     */
+    createBlobUrl: (blob: Blob) => Effect.Effect<string, FileOperationError>;
+    /**
+     * Release blob URL (infallible operation)
+     */
+    releaseBlobUrl: (url: string) => Effect.Effect<void, never>;
+    /**
+     * Release all blob URLs (infallible operation)
+     */
+    releaseAllBlobUrls: () => Effect.Effect<void, never>;
+    /**
+     * Create temporary file with automatic cleanup using Scope
+     */
+    withTempFile: <A, E>(audioData: ArrayBuffer, use: (filePath: string) => Effect.Effect<A, E>) => Effect.Effect<A, E | FileOperationError>;
+    /**
+     * Batch delete multiple temporary files
+     */
+    deleteMultipleTempFiles: (filePaths: readonly string[]) => Effect.Effect<void, FileOperationError>;
+    /**
+     * Create multiple temporary files from audio data array
+     */
+    saveMultipleTempAudioFiles: (audioDataArray: readonly ArrayBuffer[]) => Effect.Effect<readonly string[], FileOperationError>;
+    /**
+     * Get file size information (Node.js only, returns null in browser)
+     */
+    getFileSize: (filePath: string) => Effect.Effect<number | null, FileOperationError>;
+    /**
+     * Clean up all resources (blob URLs and temp files)
+     */
+    cleanup: () => Effect.Effect<void, never>;
+}
+/**
+ * Create FileManager service instance
+ */
+export declare const makeEffectFileManagerService: () => Effect.Effect<EffectFileManagerService, never>;
+/**
+ * Layer providing Effect FileManager service
+ */
+export declare const EffectFileManagerServiceLive: Layer.Layer<EffectFileManagerService, never, never>;
+/**
+ * Scoped layer that automatically cleans up resources on scope close
+ */
+export declare const EffectFileManagerServiceScoped: Layer.Layer<EffectFileManagerService, never, Scope.Scope>;
+//# sourceMappingURL=file-manager-service.d.ts.map

package/dist/effect/services/file-manager-service.d.ts.map

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

package/dist/effect/services/file-manager-service.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * Effect-based AudioFileManager service implementation
+ * Provides structured error handling and resource management for file operations
+ */
+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.EffectFileManagerServiceScoped = exports.EffectFileManagerServiceLive = exports.makeEffectFileManagerService = exports.EffectFileManagerServiceImpl = exports.EffectFileManagerContext = void 0;
+const effect_1 = require("effect");
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const errors_1 = require("../errors");
+const utils_1 = require("../utils");
+exports.EffectFileManagerContext = effect_1.Context.GenericTag('@voicevox/EffectFileManager');
+/**
+ * Effect-based implementation of AudioFileManager service
+ */
+class EffectFileManagerServiceImpl {
+    constructor() {
+        this.blobUrls = new Set();
+        /**
+         * Save audio data to temporary file with Effect-based error handling
+         */
+        this.saveTempAudioFile = (audioData) => (0, utils_1.logTimed)('saveTempAudioFile', (0, errors_1.safeAsync)(async () => {
+            const tempDir = os.tmpdir();
+            const fileName = `voicevox_${Date.now()}_${Math.random().toString(36).substring(2)}.wav`;
+            const filePath = path.join(tempDir, fileName);
+            const buffer = Buffer.from(audioData);
+            await fs.writeFile(filePath, buffer);
+            return filePath;
+        }, (error) => (0, errors_1.makeFileOperationError)('Failed to save audio data to temporary file', 'write', undefined, error)));
+        /**
+         * Save audio data to specific file path with Effect-based error handling
+         */
+        this.saveAudioFile = (audioData, output, forceDownload = true) => (0, utils_1.logTimed)(`saveAudioFile-${output}`, (0, errors_1.safeAsync)(async () => {
+            const buffer = Buffer.from(audioData);
+            const outputPath = path.resolve(output);
+            // Ensure directory exists
+            const dir = path.dirname(outputPath);
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(outputPath, buffer);
+            return outputPath;
+        }, (error) => (0, errors_1.makeFileOperationError)('Failed to save audio file', 'write', output, error)));
+        /**
+         * Delete temporary file with Effect-based error handling
+         */
+        this.deleteTempFile = (filePath) => (0, utils_1.logTimed)(`deleteTempFile-${filePath}`, (0, errors_1.safeAsync)(async () => {
+            try {
+                await fs.unlink(filePath);
+            }
+            catch (error) {
+                // Ignore file not found errors
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+        }, (error) => (0, errors_1.makeFileOperationError)('Failed to delete temporary file', 'delete', filePath, error)));
+        /**
+         * Create temporary file path with Effect-based error handling
+         */
+        this.createTempFilePath = () => (0, errors_1.safeSync)(() => {
+            const tempDir = os.tmpdir();
+            const fileName = `voicevox_${Date.now()}_${Math.random().toString(36).substring(2)}.wav`;
+            return path.join(tempDir, fileName);
+        }, (error) => (0, errors_1.makeFileOperationError)('Failed to create temporary file path', 'write', undefined, error));
+        /**
+         * Create blob URL with Effect-based error handling
+         */
+        this.createBlobUrl = (blob) => (0, errors_1.safeSync)(() => {
+            if (typeof URL !== 'undefined' && URL.createObjectURL) {
+                const url = URL.createObjectURL(blob);
+                this.blobUrls.add(url);
+                return url;
+            }
+            throw new Error('Blob URL creation not supported in this environment');
+        }, (error) => (0, errors_1.makeFileOperationError)('Failed to create blob URL', 'write', undefined, error));
+        /**
+         * Release blob URL (infallible operation)
+         */
+        this.releaseBlobUrl = (url) => effect_1.Effect.sync(() => {
+            if (typeof URL !== 'undefined' && URL.revokeObjectURL) {
+                URL.revokeObjectURL(url);
+                this.blobUrls.delete(url);
+            }
+        });
+        /**
+         * Release all blob URLs (infallible operation)
+         */
+        this.releaseAllBlobUrls = () => effect_1.Effect.sync(() => {
+            if (typeof URL !== 'undefined' && URL.revokeObjectURL) {
+                for (const url of this.blobUrls) {
+                    URL.revokeObjectURL(url);
+                }
+                this.blobUrls.clear();
+            }
+        });
+        /**
+         * Create temporary file with automatic cleanup using Scope
+         */
+        this.withTempFile = (audioData, use) => {
+            const self = this;
+            return effect_1.Effect.gen(function* () {
+                // Create temp file
+                const filePath = yield* self.saveTempAudioFile(audioData);
+                // Use the file with automatic cleanup
+                return yield* effect_1.Effect.acquireUseRelease(effect_1.Effect.succeed(filePath), use, (path) => self.deleteTempFile(path).pipe(effect_1.Effect.catchAll((error) => {
+                    // Log cleanup errors but don't fail the operation
+                    console.warn(`Failed to cleanup temp file ${path}:`, error);
+                    return effect_1.Effect.void;
+                })));
+            });
+        };
+        /**
+         * Batch delete multiple temporary files
+         */
+        this.deleteMultipleTempFiles = (filePaths) => {
+            const self = this;
+            return effect_1.Effect.gen(function* () {
+                // Delete all files in parallel with limited concurrency
+                yield* effect_1.Effect.all(filePaths.map((path) => self.deleteTempFile(path)), { concurrency: 5 });
+            });
+        };
+        /**
+         * Create multiple temporary files from audio data array
+         */
+        this.saveMultipleTempAudioFiles = (audioDataArray) => {
+            const self = this;
+            return effect_1.Effect.gen(function* () {
+                // Save all files in parallel with limited concurrency
+                const filePaths = yield* effect_1.Effect.all(audioDataArray.map((data) => self.saveTempAudioFile(data)), { concurrency: 3 });
+                return filePaths;
+            });
+        };
+        /**
+         * Get file size information (Node.js only, returns null in browser)
+         */
+        this.getFileSize = (filePath) => (0, errors_1.safeAsync)(async () => {
+            try {
+                const stats = await fs.stat(filePath);
+                return stats.size;
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    return null;
+                }
+                throw error;
+            }
+        }, (error) => (0, errors_1.makeFileOperationError)('Failed to get file size', 'read', filePath, error));
+        /**
+         * Clean up all resources (blob URLs and temp files)
+         */
+        this.cleanup = () => {
+            const self = this;
+            return effect_1.Effect.gen(function* () {
+                // Release all blob URLs
+                yield* self.releaseAllBlobUrls();
+                // Note: We can't automatically clean up all temp files since we don't track them
+                // This should be handled by the application or OS temp cleanup
+            });
+        };
+    }
+}
+exports.EffectFileManagerServiceImpl = EffectFileManagerServiceImpl;
+/**
+ * Create FileManager service instance
+ */
+const makeEffectFileManagerService = () => effect_1.Effect.sync(() => new EffectFileManagerServiceImpl());
+exports.makeEffectFileManagerService = makeEffectFileManagerService;
+/**
+ * Layer providing Effect FileManager service
+ */
+exports.EffectFileManagerServiceLive = effect_1.Layer.effect(exports.EffectFileManagerContext, (0, exports.makeEffectFileManagerService)());
+/**
+ * Scoped layer that automatically cleans up resources on scope close
+ */
+exports.EffectFileManagerServiceScoped = effect_1.Layer.scoped(exports.EffectFileManagerContext, effect_1.Effect.gen(function* () {
+    const service = yield* (0, exports.makeEffectFileManagerService)();
+    // Add finalizer to cleanup resources when scope closes
+    yield* effect_1.Effect.addFinalizer(() => service.cleanup());
+    return service;
+}));
+//# sourceMappingURL=file-manager-service.js.map

package/dist/effect/services/file-manager-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager-service.js","sourceRoot":"","sources":["../../../src/effect/services/file-manager-service.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,mCAA2D;AAC3D,qDAAsC;AACtC,gDAAiC;AACjC,4CAA6B;AAC7B,sCAAgG;AAChG,oCAAmC;AAoBtB,QAAA,wBAAwB,GAAG,gBAAO,CAAC,UAAU,CAA2B,6BAA6B,CAAC,CAAA;AAEnH;;GAEG;AACH,MAAa,4BAA4B;IAAzC;QACU,aAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;QAEpC;;WAEG;QACH,sBAAiB,GAAG,CAAC,SAAsB,EAA6C,EAAE,CACxF,IAAA,gBAAQ,EACN,mBAAmB,EACnB,IAAA,kBAAS,EACP,KAAK,IAAI,EAAE;YACT,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,EAAE,CAAA;YAC3B,MAAM,QAAQ,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;YACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YAE7C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACrC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAEpC,OAAO,QAAQ,CAAA;QACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,+BAAsB,EAAC,6CAA6C,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAC5G,CACF,CAAA;QAEH;;WAEG;QACH,kBAAa,GAAG,CACd,SAAsB,EACtB,MAAc,EACd,aAAa,GAAG,IAAI,EACuB,EAAE,CAC7C,IAAA,gBAAQ,EACN,iBAAiB,MAAM,EAAE,EACzB,IAAA,kBAAS,EACP,KAAK,IAAI,EAAE;YACT,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACrC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAEvC,0BAA0B;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YACpC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAExC,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;YAEtC,OAAO,UAAU,CAAA;QACnB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,+BAAsB,EAAC,2BAA2B,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CACvF,CACF,CAAA;QAEH;;WAEG;QACH,mBAAc,GAAG,CAAC,QAAgB,EAA2C,EAAE,CAC7E,IAAA,gBAAQ,EACN,kBAAkB,QAAQ,EAAE,EAC5B,IAAA,kBAAS,EACP,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC3B,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,+BAA+B;gBAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5B,MAAM,KAAK,CAAA;gBACb,CAAC;YACH,CAAC;QACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,+BAAsB,EAAC,iCAAiC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAChG,CACF,CAAA;QAEH;;WAEG;QACH,uBAAkB,GAAG,GAA8C,EAAE,CACnE,IAAA,iBAAQ,EACN,GAAG,EAAE;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,EAAE,CAAA;YAC3B,MAAM,QAAQ,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAA;YACxF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QACrC,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,+BAAsB,EAAC,sCAAsC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CACrG,CAAA;QAEH;;WAEG;QACH,kBAAa,GAAG,CAAC,IAAU,EAA6C,EAAE,CACxE,IAAA,iBAAQ,EACN,GAAG,EAAE;YACH,IAAI,OAAO,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;gBACtD,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;gBACrC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;gBACtB,OAAO,GAAG,CAAA;YACZ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;QACxE,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,+BAAsB,EAAC,2BAA2B,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAC1F,CAAA;QAEH;;WAEG;QACH,mBAAc,GAAG,CAAC,GAAW,EAA8B,EAAE,CAC3D,eAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACf,IAAI,OAAO,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;gBACtD,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;gBACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC,CAAC,CAAA;QAEJ;;WAEG;QACH,uBAAkB,GAAG,GAA+B,EAAE,CACpD,eAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACf,IAAI,OAAO,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;gBACtD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAChC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;gBAC1B,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YACvB,CAAC;QACH,CAAC,CAAC,CAAA;QAEJ;;WAEG;QACH,iBAAY,GAAG,CACb,SAAsB,EACtB,GAA8C,EACJ,EAAE;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAA;YACjB,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACzB,mBAAmB;gBACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;gBAEzD,sCAAsC;gBACtC,OAAO,KAAK,CAAC,CAAC,eAAM,CAAC,iBAAiB,CAAC,eAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAC7E,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAC5B,eAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;oBACxB,kDAAkD;oBAClD,OAAO,CAAC,IAAI,CAAC,+BAA+B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAA;oBAC3D,OAAO,eAAM,CAAC,IAAI,CAAA;gBACpB,CAAC,CAAC,CACH,CACF,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;QAED;;WAEG;QACH,4BAAuB,GAAG,CAAC,SAA4B,EAA2C,EAAE;YAClG,MAAM,IAAI,GAAG,IAAI,CAAA;YACjB,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACzB,wDAAwD;gBACxD,KAAK,CAAC,CAAC,eAAM,CAAC,GAAG,CACf,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAClD,EAAE,WAAW,EAAE,CAAC,EAAE,CACnB,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;QAED;;WAEG;QACH,+BAA0B,GAAG,CAC3B,cAAsC,EACgB,EAAE;YACxD,MAAM,IAAI,GAAG,IAAI,CAAA;YACjB,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACzB,sDAAsD;gBACtD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,eAAM,CAAC,GAAG,CACjC,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAC1D,EAAE,WAAW,EAAE,CAAC,EAAE,CACnB,CAAA;gBACD,OAAO,SAAS,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;QAED;;WAEG;QACH,gBAAW,GAAG,CAAC,QAAgB,EAAoD,EAAE,CACnF,IAAA,kBAAS,EACP,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBACrC,OAAO,KAAK,CAAC,IAAI,CAAA;YACnB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5B,OAAO,IAAI,CAAA;gBACb,CAAC;gBACD,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,+BAAsB,EAAC,yBAAyB,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CACtF,CAAA;QAEH;;WAEG;QACH,YAAO,GAAG,GAA+B,EAAE;YACzC,MAAM,IAAI,GAAG,IAAI,CAAA;YACjB,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACzB,wBAAwB;gBACxB,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAA;gBAEhC,iFAAiF;gBACjF,+DAA+D;YACjE,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;IACH,CAAC;CAAA;AArND,oEAqNC;AAED;;GAEG;AACI,MAAM,4BAA4B,GAAG,GAAmD,EAAE,CAC/F,eAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,4BAA4B,EAAE,CAAC,CAAA;AAD1C,QAAA,4BAA4B,gCACc;AAEvD;;GAEG;AACU,QAAA,4BAA4B,GAAwD,cAAK,CAAC,MAAM,CAC3G,gCAAwB,EACxB,IAAA,oCAA4B,GAAE,CAC/B,CAAA;AAED;;GAEG;AACU,QAAA,8BAA8B,GAA8D,cAAK,CAAC,MAAM,CACnH,gCAAwB,EACxB,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAA,oCAA4B,GAAE,CAAA;IAErD,uDAAuD;IACvD,KAAK,CAAC,CAAC,eAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAEnD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAC,CACH,CAAA"}

package/dist/effect/utils.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Effect utility functions and common patterns
+ * Provides reusable Effect combinators for the VOICEVOX system
+ */
+import { Deferred, Duration, Effect, Option } from 'effect';
+/**
+ * Resource management utilities
+ */
+/**
+ * Safely execute an operation with automatic cleanup
+ */
+export declare const withResource: <R, E, A, B>(acquire: Effect.Effect<A, E, R>, release: (resource: A) => Effect.Effect<void, never, R>, use: (resource: A) => Effect.Effect<B, E, R>) => Effect.Effect<B, E, R>;
+/**
+ * Manage a temporary file with automatic cleanup
+ */
+export declare const withTempFile: <R, E, A>(createFile: () => Effect.Effect<string, E, R>, deleteFile: (path: string) => Effect.Effect<void, never, R>, use: (filePath: string) => Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Async coordination utilities
+ */
+/**
+ * Create a deferred promise that can be resolved later
+ */
+export declare const createDeferred: <A>() => Effect.Effect<Deferred.Deferred<A, never>, never>;
+/**
+ * Wait for a condition to be true with timeout
+ */
+export declare const waitForCondition: <R, E>(condition: Effect.Effect<boolean, E, R>, timeout: Duration.Duration, checkInterval?: Duration.Duration) => Effect.Effect<void, E | Error, R>;
+/**
+ * Execute effects in parallel with concurrency limit
+ */
+export declare const parallelWithLimit: <R, E, A>(effects: readonly Effect.Effect<A, E, R>[], concurrency: number) => Effect.Effect<readonly A[], E, R>;
+/**
+ * Queue utilities
+ */
+/**
+ * Process items from a queue with a given processor function
+ */
+export declare const processQueueItems: <A, R, E>(getItems: Effect.Effect<readonly A[], E, R>, processItem: (item: A) => Effect.Effect<void, E, R>, maxConcurrency?: number) => Effect.Effect<void, E, R>;
+/**
+ * State management utilities
+ */
+/**
+ * Create a thread-safe counter
+ */
+export declare const createCounter: (initialValue?: number) => Effect.Effect<{
+    readonly increment: Effect.Effect<number, never>;
+    readonly decrement: Effect.Effect<number, never>;
+    readonly get: Effect.Effect<number, never>;
+    readonly set: (value: number) => Effect.Effect<void, never>;
+}, never>;
+/**
+ * Create a thread-safe boolean flag
+ */
+export declare const createFlag: (initialValue?: boolean) => Effect.Effect<{
+    readonly set: Effect.Effect<void, never>;
+    readonly unset: Effect.Effect<void, never>;
+    readonly get: Effect.Effect<boolean, never>;
+    readonly toggle: Effect.Effect<boolean, never>;
+}, never>;
+/**
+ * Scheduling utilities
+ */
+/**
+ * Execute with timeout
+ */
+export declare const withTimeout: <R, E, A>(effect: Effect.Effect<A, E, R>, timeout: Duration.Duration) => Effect.Effect<A, E | Error, R>;
+/**
+ * Logging utilities
+ */
+/**
+ * Log an effect's execution with timing
+ */
+export declare const logTimed: <R, E, A>(label: string, effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Collection utilities
+ */
+/**
+ * Find the first item in a collection that matches a predicate
+ */
+export declare const findFirst: <A>(items: readonly A[], predicate: (item: A) => boolean) => Option.Option<A>;
+/**
+ * Remove an item from an array by ID
+ */
+export declare const removeById: <A extends {
+    id: string;
+}>(items: readonly A[], id: string) => readonly A[];
+/**
+ * Update an item in an array by ID
+ */
+export declare const updateById: <A extends {
+    id: string;
+}>(items: readonly A[], id: string, updater: (item: A) => A) => readonly A[];
+/**
+ * Error handling utilities
+ */
+/**
+ * Catch and transform errors
+ */
+export declare const catchAndMap: <R, E1, E2, A>(effect: Effect.Effect<A, E1, R>, mapper: (error: E1) => E2) => Effect.Effect<A, E2, R>;
+/**
+ * Provide a fallback value in case of error
+ */
+export declare const orElse: <R, E, A>(effect: Effect.Effect<A, E, R>, fallback: A) => Effect.Effect<A, never, R>;
+/**
+ * Convert common patterns to Effect-friendly operations
+ */
+/**
+ * Convert a callback-based operation to Effect
+ */
+export declare const fromCallback: <A, E = Error>(fn: (callback: (error: E | null, result?: A) => void) => void) => Effect.Effect<A, E>;
+/**
+ * Convert an event-based operation to Effect with timeout
+ */
+export declare const fromEvent: <A>(target: {
+    addEventListener: (eventName: string, handler: (event: A) => void) => void;
+    removeEventListener: (eventName: string, handler: (event: A) => void) => void;
+}, eventName: string, timeout?: Duration.Duration) => Effect.Effect<A, Error>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/effect/utils.d.ts.map

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

package/dist/effect/utils.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * Effect utility functions and common patterns
+ * Provides reusable Effect combinators for the VOICEVOX system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromEvent = exports.fromCallback = exports.orElse = exports.catchAndMap = exports.updateById = exports.removeById = exports.findFirst = exports.logTimed = exports.withTimeout = exports.createFlag = exports.createCounter = exports.processQueueItems = exports.parallelWithLimit = exports.waitForCondition = exports.createDeferred = exports.withTempFile = exports.withResource = void 0;
+const effect_1 = require("effect");
+/**
+ * Resource management utilities
+ */
+/**
+ * Safely execute an operation with automatic cleanup
+ */
+const withResource = (acquire, release, use) => effect_1.Effect.acquireUseRelease(acquire, use, release);
+exports.withResource = withResource;
+/**
+ * Manage a temporary file with automatic cleanup
+ */
+const withTempFile = (createFile, deleteFile, use) => (0, exports.withResource)(createFile(), deleteFile, use);
+exports.withTempFile = withTempFile;
+/**
+ * Async coordination utilities
+ */
+/**
+ * Create a deferred promise that can be resolved later
+ */
+const createDeferred = () => effect_1.Deferred.make();
+exports.createDeferred = createDeferred;
+/**
+ * Wait for a condition to be true with timeout
+ */
+const waitForCondition = (condition, timeout, checkInterval = effect_1.Duration.millis(50)) => effect_1.Effect.gen(function* () {
+    const deadline = yield* effect_1.Effect.sync(() => Date.now() + effect_1.Duration.toMillis(timeout));
+    while (true) {
+        const isReady = yield* condition;
+        if (isReady)
+            return;
+        if (Date.now() > deadline) {
+            throw new Error('Condition timeout');
+        }
+        yield* effect_1.Effect.sleep(checkInterval);
+    }
+});
+exports.waitForCondition = waitForCondition;
+/**
+ * Execute effects in parallel with concurrency limit
+ */
+const parallelWithLimit = (effects, concurrency) => effect_1.Effect.all(effects, { concurrency });
+exports.parallelWithLimit = parallelWithLimit;
+/**
+ * Queue utilities
+ */
+/**
+ * Process items from a queue with a given processor function
+ */
+const processQueueItems = (getItems, processItem, maxConcurrency = 1) => effect_1.Effect.gen(function* () {
+    const items = yield* getItems;
+    if (items.length === 0)
+        return;
+    yield* (0, exports.parallelWithLimit)(items.map(processItem), maxConcurrency);
+});
+exports.processQueueItems = processQueueItems;
+/**
+ * State management utilities
+ */
+/**
+ * Create a thread-safe counter
+ */
+const createCounter = (initialValue = 0) => effect_1.Effect.gen(function* () {
+    const ref = yield* effect_1.Ref.make(initialValue);
+    return {
+        increment: effect_1.Ref.updateAndGet(ref, (n) => n + 1),
+        decrement: effect_1.Ref.updateAndGet(ref, (n) => n - 1),
+        get: effect_1.Ref.get(ref),
+        set: (value) => effect_1.Ref.set(ref, value),
+    };
+});
+exports.createCounter = createCounter;
+/**
+ * Create a thread-safe boolean flag
+ */
+const createFlag = (initialValue = false) => effect_1.Effect.gen(function* () {
+    const ref = yield* effect_1.Ref.make(initialValue);
+    return {
+        set: effect_1.Ref.set(ref, true),
+        unset: effect_1.Ref.set(ref, false),
+        get: effect_1.Ref.get(ref),
+        toggle: effect_1.Ref.updateAndGet(ref, (b) => !b),
+    };
+});
+exports.createFlag = createFlag;
+/**
+ * Scheduling utilities
+ */
+/**
+ * Execute with timeout
+ */
+const withTimeout = (effect, timeout) => effect_1.Effect.race(effect, effect_1.Effect.sleep(timeout).pipe(effect_1.Effect.andThen(effect_1.Effect.fail(new Error(`Operation timed out after ${effect_1.Duration.toMillis(timeout)}ms`)))));
+exports.withTimeout = withTimeout;
+/**
+ * Logging utilities
+ */
+/**
+ * Log an effect's execution with timing
+ */
+const logTimed = (label, effect) => effect_1.Effect.gen(function* () {
+    const start = yield* effect_1.Effect.sync(() => Date.now());
+    yield* effect_1.Effect.log(`[${label}] Starting...`);
+    const result = yield* effect;
+    const end = yield* effect_1.Effect.sync(() => Date.now());
+    yield* effect_1.Effect.log(`[${label}] Completed in ${end - start}ms`);
+    return result;
+});
+exports.logTimed = logTimed;
+/**
+ * Collection utilities
+ */
+/**
+ * Find the first item in a collection that matches a predicate
+ */
+const findFirst = (items, predicate) => effect_1.Option.fromNullable(items.find(predicate));
+exports.findFirst = findFirst;
+/**
+ * Remove an item from an array by ID
+ */
+const removeById = (items, id) => items.filter((item) => item.id !== id);
+exports.removeById = removeById;
+/**
+ * Update an item in an array by ID
+ */
+const updateById = (items, id, updater) => items.map((item) => (item.id === id ? updater(item) : item));
+exports.updateById = updateById;
+/**
+ * Error handling utilities
+ */
+/**
+ * Catch and transform errors
+ */
+const catchAndMap = (effect, mapper) => effect.pipe(effect_1.Effect.catchAll((error) => effect_1.Effect.fail(mapper(error))));
+exports.catchAndMap = catchAndMap;
+/**
+ * Provide a fallback value in case of error
+ */
+const orElse = (effect, fallback) => effect.pipe(effect_1.Effect.orElse(() => effect_1.Effect.succeed(fallback)));
+exports.orElse = orElse;
+/**
+ * Convert common patterns to Effect-friendly operations
+ */
+/**
+ * Convert a callback-based operation to Effect
+ */
+const fromCallback = (fn) => effect_1.Effect.async((resume) => {
+    fn((error, result) => {
+        if (error) {
+            resume(effect_1.Effect.fail(error));
+        }
+        else if (result !== undefined) {
+            resume(effect_1.Effect.succeed(result));
+        }
+        else {
+            resume(effect_1.Effect.fail(new Error('No result provided')));
+        }
+    });
+});
+exports.fromCallback = fromCallback;
+/**
+ * Convert an event-based operation to Effect with timeout
+ */
+const fromEvent = (target, eventName, timeout) => effect_1.Effect.async((resume) => {
+    const handler = (event) => {
+        target.removeEventListener(eventName, handler);
+        resume(effect_1.Effect.succeed(event));
+    };
+    target.addEventListener(eventName, handler);
+    if (timeout) {
+        const timeoutId = setTimeout(() => {
+            target.removeEventListener(eventName, handler);
+            resume(effect_1.Effect.fail(new Error(`Event ${eventName} timed out`)));
+        }, effect_1.Duration.toMillis(timeout));
+        return effect_1.Effect.sync(() => clearTimeout(timeoutId));
+    }
+    return effect_1.Effect.void;
+});
+exports.fromEvent = fromEvent;
+//# sourceMappingURL=utils.js.map

package/dist/effect/utils.js.map

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