@piecemaker-legal/piecemaker 1.0.0

package/dist-server/server/modules/user/user.module.js

@@ -0,0 +1,56 @@
+import spawn from 'cross-spawn';
+import { sessionDraftsDb, userDb, userPreferencesDb } from '../../modules/database/index.js';
+import { createUserRouter } from './user.routes.js';
+import { createUserService } from './user.service.js';
+function runGit(args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('git', args, { shell: false });
+        let stdout = '';
+        child.stdout?.on('data', (data) => { stdout += data.toString(); });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve({ stdout });
+                return;
+            }
+            reject(new Error(`Git command failed with code ${code}`));
+        });
+    });
+}
+async function readSystemGitConfig() {
+    const [nameResult, emailResult] = await Promise.all([
+        runGit(['config', '--global', 'user.name']).catch(() => ({ stdout: '' })),
+        runGit(['config', '--global', 'user.email']).catch(() => ({ stdout: '' })),
+    ]);
+    return {
+        git_name: nameResult.stdout.trim() || null,
+        git_email: emailResult.stdout.trim() || null,
+    };
+}
+const userService = createUserService({
+    users: {
+        getGitConfig: (userId) => userDb.getGitConfig(userId),
+        updateGitConfig: (userId, gitName, gitEmail) => userDb.updateGitConfig(userId, gitName ?? '', gitEmail ?? ''),
+        completeOnboarding: (userId) => userDb.completeOnboarding(userId),
+        hasCompletedOnboarding: (userId) => userDb.hasCompletedOnboarding(userId),
+    },
+    preferences: {
+        getPreferences: (userId) => userPreferencesDb.getPreferences(userId),
+        savePreferences: (userId, updates) => userPreferencesDb.savePreferences(userId, updates),
+    },
+    drafts: {
+        getDrafts: (userId) => sessionDraftsDb.getDrafts(userId),
+        saveDraft: (userId, scope, draft) => sessionDraftsDb.saveDraft(userId, scope, draft),
+        deleteDraft: (userId, scope) => sessionDraftsDb.deleteDraft(userId, scope),
+    },
+    readSystemGitConfig,
+    applyGlobalGitConfig: async (gitName, gitEmail) => {
+        await runGit(['config', '--global', 'user.name', gitName]);
+        await runGit(['config', '--global', 'user.email', gitEmail]);
+    },
+    logInfo: (message) => console.log(message),
+    logError: (message, error) => console.error(message, error),
+});
+/** User router assembled for the authenticated server mount. */
+export const userRoutes = createUserRouter(userService);
+//# sourceMappingURL=user.module.js.map

package/dist-server/server/modules/user/user.module.js.map

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

package/dist-server/server/modules/user/user.routes.js

@@ -0,0 +1,88 @@
+import express from 'express';
+function readUserId(request) {
+    const rawUserId = request.user?.id;
+    return Number(rawUserId);
+}
+/** Creates thin user routes that parse authenticated input and call the service. */
+export function createUserRouter(service) {
+    const router = express.Router();
+    router.get('/git-config', async (req, res, next) => {
+        try {
+            res.json(await service.getGitConfig(readUserId(req)));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    router.post('/git-config', async (req, res, next) => {
+        try {
+            const body = req.body;
+            res.json(await service.updateGitConfig(readUserId(req), body.gitName, body.gitEmail));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    router.post('/complete-onboarding', (req, res, next) => {
+        try {
+            res.json(service.completeOnboarding(readUserId(req)));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    router.get('/onboarding-status', (req, res, next) => {
+        try {
+            res.json(service.getOnboardingStatus(readUserId(req)));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    router.get('/preferences', (req, res, next) => {
+        try {
+            res.json(service.getPreferences(readUserId(req)));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    router.patch('/preferences', (req, res, next) => {
+        try {
+            res.json(service.savePreferences(readUserId(req), req.body));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    router.get('/drafts', (req, res, next) => {
+        try {
+            res.json(service.getDrafts(readUserId(req)));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    // The scope is a session id or `project:<id>`, so it is read from the body
+    // rather than the path: neither form is guaranteed to be URL-path-safe.
+    router.put('/drafts', (req, res, next) => {
+        try {
+            const body = req.body;
+            res.json(service.saveDraft(readUserId(req), body?.scope, req.body));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    router.delete('/drafts', (req, res, next) => {
+        try {
+            const body = req.body;
+            res.json(service.deleteDraft(readUserId(req), body?.scope));
+        }
+        catch (error) {
+            next(error);
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=user.routes.js.map

package/dist-server/server/modules/user/user.routes.js.map

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

package/dist-server/server/modules/user/user.service.js

@@ -0,0 +1,134 @@
+import { AppError } from '../../shared/utils.js';
+/**
+ * The longest a draft scope or preference key may be.
+ *
+ * Scopes are session UUIDs or `project:<id>`, and preference keys are fixed
+ * identifiers, so anything longer is a client bug or an attempt to use the
+ * table as general storage.
+ */
+const MAX_KEY_LENGTH = 200;
+/** Guards against a runaway composer filling the database with one row. */
+const MAX_DRAFT_TEXT_LENGTH = 100_000;
+const readDraftScope = (value) => {
+    const scope = typeof value === 'string' ? value.trim() : '';
+    if (!scope || scope.length > MAX_KEY_LENGTH) {
+        throw new AppError('A draft scope of 1-200 characters is required', {
+            code: 'INVALID_DRAFT_SCOPE',
+            statusCode: 400,
+        });
+    }
+    return scope;
+};
+const readPreferenceUpdates = (body) => {
+    if (!body || typeof body !== 'object' || Array.isArray(body)) {
+        throw new AppError('Preferences must be sent as an object', {
+            code: 'INVALID_PREFERENCES',
+            statusCode: 400,
+        });
+    }
+    const updates = body;
+    for (const key of Object.keys(updates)) {
+        if (!key || key.length > MAX_KEY_LENGTH) {
+            throw new AppError('Preference keys must be 1-200 characters', {
+                code: 'INVALID_PREFERENCE_KEY',
+                statusCode: 400,
+            });
+        }
+    }
+    return updates;
+};
+/** Creates user-profile workflows with explicit repository and Git adapters. */
+export function createUserService(dependencies) {
+    return {
+        async getGitConfig(userId) {
+            let gitConfig = dependencies.users.getGitConfig(userId);
+            if (!gitConfig || (!gitConfig.git_name && !gitConfig.git_email)) {
+                const systemConfig = await dependencies.readSystemGitConfig();
+                if (systemConfig.git_name || systemConfig.git_email) {
+                    dependencies.users.updateGitConfig(userId, systemConfig.git_name, systemConfig.git_email);
+                    gitConfig = systemConfig;
+                    dependencies.logInfo(`Auto-populated Git config for user ${userId}`);
+                }
+            }
+            return {
+                success: true,
+                gitName: gitConfig?.git_name ?? null,
+                gitEmail: gitConfig?.git_email ?? null,
+            };
+        },
+        async updateGitConfig(userId, gitNameInput, gitEmailInput) {
+            const gitName = typeof gitNameInput === 'string' ? gitNameInput.trim() : '';
+            const gitEmail = typeof gitEmailInput === 'string' ? gitEmailInput.trim() : '';
+            if (!gitName || !gitEmail) {
+                throw new AppError('Git name and email are required', {
+                    code: 'GIT_CONFIG_REQUIRED',
+                    statusCode: 400,
+                });
+            }
+            if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(gitEmail)) {
+                throw new AppError('Invalid email format', {
+                    code: 'INVALID_GIT_EMAIL',
+                    statusCode: 400,
+                });
+            }
+            dependencies.users.updateGitConfig(userId, gitName, gitEmail);
+            try {
+                await dependencies.applyGlobalGitConfig(gitName, gitEmail);
+            }
+            catch (error) {
+                // Persisted user settings remain authoritative even if the host Git
+                // installation cannot be updated (matching the previous behavior).
+                dependencies.logError('Failed to apply global Git config', error);
+            }
+            return { success: true, gitName, gitEmail };
+        },
+        completeOnboarding(userId) {
+            dependencies.users.completeOnboarding(userId);
+            return { success: true, message: 'Onboarding completed successfully' };
+        },
+        getOnboardingStatus(userId) {
+            return {
+                success: true,
+                hasCompletedOnboarding: dependencies.users.hasCompletedOnboarding(userId),
+            };
+        },
+        /** Every stored preference at once; the client fills gaps with its defaults. */
+        getPreferences(userId) {
+            return { success: true, preferences: dependencies.preferences.getPreferences(userId) };
+        },
+        /**
+         * Merge-patch: only the keys in the request body are touched, so two
+         * independent settings screens can save concurrently without one erasing
+         * the other's work.
+         */
+        savePreferences(userId, body) {
+            const updates = readPreferenceUpdates(body);
+            dependencies.preferences.savePreferences(userId, updates);
+            return { success: true, preferences: dependencies.preferences.getPreferences(userId) };
+        },
+        getDrafts(userId) {
+            return { success: true, drafts: dependencies.drafts.getDrafts(userId) };
+        },
+        saveDraft(userId, scopeInput, body) {
+            const scope = readDraftScope(scopeInput);
+            const payload = (body ?? {});
+            const text = typeof payload.text === 'string' ? payload.text : '';
+            if (text.length > MAX_DRAFT_TEXT_LENGTH) {
+                throw new AppError('Draft text is too long to store', {
+                    code: 'DRAFT_TEXT_TOO_LONG',
+                    statusCode: 413,
+                });
+            }
+            dependencies.drafts.saveDraft(userId, scope, {
+                text,
+                queuedMessage: payload.queuedMessage ?? null,
+            });
+            return { success: true };
+        },
+        deleteDraft(userId, scopeInput) {
+            dependencies.drafts.deleteDraft(userId, readDraftScope(scopeInput));
+            return { success: true };
+        },
+    };
+}
+//# sourceMappingURL=user.service.js.map

package/dist-server/server/modules/user/user.service.js.map

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

package/dist-server/server/modules/voice/index.js

@@ -0,0 +1,3 @@
+// voiceRoutes: used by the server entrypoint to mount authenticated STT/TTS endpoints.
+export { voiceRoutes } from './voice.module.js';
+//# sourceMappingURL=index.js.map

package/dist-server/server/modules/voice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/modules/voice/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist-server/server/modules/voice/tests/voice.service.test.js

@@ -0,0 +1,87 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { createVoiceService } from '../voice.service.js';
+const defaults = {
+    baseUrl: 'https://voice.example/v1',
+    apiKey: 'server-key',
+    sttModel: 'whisper-1',
+    ttsModel: 'tts-1',
+    ttsVoice: 'alloy',
+};
+test('reports whether the server-controlled backend is configured', () => {
+    const service = createVoiceService({
+        defaults: { ...defaults, baseUrl: '' },
+        timeoutMs: 1_000,
+        fetchBackend: async () => {
+            throw new Error('fetch should not run');
+        },
+    });
+    assert.deepEqual(service.getHealth(), { configured: false });
+});
+test('transcribes with injected fetch and request-level credential/model overrides', async () => {
+    let requestedUrl = '';
+    let requestedOptions;
+    const service = createVoiceService({
+        defaults,
+        timeoutMs: 1_000,
+        fetchBackend: async (url, options) => {
+            requestedUrl = url;
+            requestedOptions = options;
+            return new Response(JSON.stringify({ text: 'hello' }), { status: 200 });
+        },
+    });
+    const result = await service.transcribe({
+        audio: {
+            bytes: Buffer.from('audio'),
+            mimeType: 'audio/webm',
+            fileName: 'recording.webm',
+        },
+        overrides: { apiKey: 'request-key', sttModel: 'custom-whisper' },
+    });
+    assert.deepEqual(result, { ok: true, value: { text: 'hello' } });
+    assert.equal(requestedUrl, 'https://voice.example/v1/audio/transcriptions');
+    assert.ok(requestedOptions, 'fetchBackend should receive request options');
+    assert.equal(requestedOptions.headers.Authorization, 'Bearer request-key');
+    assert.equal(requestedOptions.body.get('model'), 'custom-whisper');
+});
+test('forwards the explicit TTS format and maps backend authentication failures', async () => {
+    let requestBody = '';
+    const service = createVoiceService({
+        defaults,
+        timeoutMs: 1_000,
+        fetchBackend: async (_url, options) => {
+            requestBody = String(options.body);
+            return new Response('unauthorized', { status: 401 });
+        },
+    });
+    const result = await service.synthesizeSpeech({
+        text: 'Read this',
+        overrides: { ttsFormat: 'wav' },
+    });
+    assert.deepEqual(JSON.parse(requestBody), {
+        model: 'tts-1',
+        voice: 'alloy',
+        input: 'Read this',
+        response_format: 'wav',
+    });
+    assert.deepEqual(result, {
+        ok: false,
+        status: 502,
+        error: 'Voice backend rejected the request (check the API key).',
+    });
+});
+test('blocks link-local metadata destinations before calling the fetch adapter', async () => {
+    let fetchCalls = 0;
+    const service = createVoiceService({
+        defaults: { ...defaults, baseUrl: 'http://169.254.169.254/latest' },
+        timeoutMs: 1_000,
+        fetchBackend: async () => {
+            fetchCalls += 1;
+            return new Response();
+        },
+    });
+    const result = await service.synthesizeSpeech({ text: 'hello', overrides: {} });
+    assert.deepEqual(result, { ok: false, status: 400, error: 'Invalid voice backend URL.' });
+    assert.equal(fetchCalls, 0);
+});
+//# sourceMappingURL=voice.service.test.js.map

package/dist-server/server/modules/voice/tests/voice.service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.service.test.js","sourceRoot":"","sources":["../../../../../server/modules/voice/tests/voice.service.test.ts"],"names":[],"mappings":"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"}

package/dist-server/server/modules/voice/voice.module.js

@@ -0,0 +1,44 @@
+import multer from 'multer';
+import { createVoiceRouter } from './voice.routes.js';
+import { createVoiceService } from './voice.service.js';
+const DEFAULT_VOICE_TIMEOUT_MS = 300_000;
+const parsedTimeoutMs = Number(process.env.VOICE_TIMEOUT_MS);
+const voiceTimeoutMs = Number.isFinite(parsedTimeoutMs) && parsedTimeoutMs > 0
+    ? parsedTimeoutMs
+    : DEFAULT_VOICE_TIMEOUT_MS;
+const voiceService = createVoiceService({
+    defaults: {
+        // The server-controlled URL is intentional: frontend-configured custom
+        // backends are called directly by the browser and never become SSRF input.
+        baseUrl: (process.env.VOICE_API_BASE_URL || '').replace(/\/$/, ''),
+        apiKey: process.env.VOICE_API_KEY || '',
+        sttModel: process.env.VOICE_STT_MODEL || 'whisper-1',
+        ttsModel: process.env.VOICE_TTS_MODEL || 'tts-1',
+        ttsVoice: process.env.VOICE_TTS_VOICE || 'alloy',
+    },
+    timeoutMs: voiceTimeoutMs,
+    fetchBackend: async (url, options) => {
+        const abortController = new AbortController();
+        const timeoutHandle = setTimeout(() => abortController.abort(), voiceTimeoutMs);
+        try {
+            return await fetch(url, {
+                redirect: 'manual',
+                ...options,
+                signal: abortController.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutHandle);
+        }
+    },
+});
+const audioUpload = multer({
+    storage: multer.memoryStorage(),
+    limits: { fileSize: 25 * 1024 * 1024 },
+});
+/** Voice router assembled for the server entrypoint. */
+export const voiceRoutes = createVoiceRouter({
+    voiceService,
+    parseAudioUpload: audioUpload.single('audio'),
+});
+//# sourceMappingURL=voice.module.js.map

package/dist-server/server/modules/voice/voice.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.module.js","sourceRoot":"","sources":["../../../../server/modules/voice/voice.module.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,wBAAwB,GAAG,OAAO,CAAC;AACzC,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC7D,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,CAAC;IAC5E,CAAC,CAAC,eAAe;IACjB,CAAC,CAAC,wBAAwB,CAAC;AAE7B,MAAM,YAAY,GAAG,kBAAkB,CAAC;IACtC,QAAQ,EAAE;QACR,uEAAuE;QACvE,2EAA2E;QAC3E,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE;QACvC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,WAAW;QACpD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO;QAChD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO;KACjD;IACD,SAAS,EAAE,cAAc;IACzB,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;QACnC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,EAAE,cAAc,CAAC,CAAC;QAChF,IAAI,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE;gBACtB,QAAQ,EAAE,QAAQ;gBAClB,GAAG,OAAO;gBACV,MAAM,EAAE,eAAe,CAAC,MAAM;aAC/B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE;IAC/B,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE;CACvC,CAAC,CAAC;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;IAC3C,YAAY;IACZ,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;CAC9C,CAAC,CAAC"}

package/dist-server/server/modules/voice/voice.routes.js

@@ -0,0 +1,87 @@
+import { Readable } from 'node:stream';
+import express from 'express';
+import { asyncHandler } from '../../shared/utils.js';
+function readHeaderValue(value) {
+    const normalizedValue = Array.isArray(value) ? value[0] : value;
+    const trimmedValue = normalizedValue?.trim();
+    return trimmedValue || undefined;
+}
+function parseVoiceOverrides(request) {
+    return {
+        apiKey: readHeaderValue(request.headers['x-voice-api-key']),
+        sttModel: readHeaderValue(request.headers['x-voice-stt-model']),
+        ttsModel: readHeaderValue(request.headers['x-voice-tts-model']),
+        ttsVoice: readHeaderValue(request.headers['x-voice-tts-voice']),
+        ttsFormat: readHeaderValue(request.headers['x-voice-tts-format']),
+    };
+}
+function sendFailure(response, result) {
+    if (result.ok) {
+        return false;
+    }
+    response.status(result.status).json({ error: result.error });
+    return true;
+}
+/**
+ * Creates the transport-only router used by the Voice composition root. It is
+ * exported for Voice route tests; other modules consume only the composed
+ * router exposed from the Voice barrel.
+ */
+export function createVoiceRouter(dependencies) {
+    const router = express.Router();
+    router.get('/health', (_request, response) => {
+        response.json(dependencies.voiceService.getHealth());
+    });
+    router.post('/transcribe', (request, response, next) => {
+        dependencies.parseAudioUpload(request, response, (uploadError) => {
+            if (uploadError) {
+                const message = uploadError instanceof Error ? uploadError.message : String(uploadError);
+                response.status(400).json({ error: message });
+                return;
+            }
+            // Multer uses a callback API, so bridge its parsed request into the async
+            // service call and forward unexpected rejections to Express middleware.
+            void (async () => {
+                if (!request.file) {
+                    response.status(400).json({ error: 'No audio uploaded' });
+                    return;
+                }
+                const result = await dependencies.voiceService.transcribe({
+                    audio: {
+                        bytes: request.file.buffer,
+                        mimeType: request.file.mimetype || 'audio/webm',
+                        fileName: request.file.originalname || 'recording.webm',
+                    },
+                    overrides: parseVoiceOverrides(request),
+                });
+                if (sendFailure(response, result)) {
+                    return;
+                }
+                response.json(result.value);
+            })().catch(next);
+        });
+    });
+    router.post('/tts', asyncHandler(async (request, response) => {
+        const text = request.body?.text;
+        if (typeof text !== 'string' || !text.trim()) {
+            response.status(400).json({ error: 'text required' });
+            return;
+        }
+        const result = await dependencies.voiceService.synthesizeSpeech({
+            text,
+            overrides: parseVoiceOverrides(request),
+        });
+        if (sendFailure(response, result)) {
+            return;
+        }
+        response.setHeader('Content-Type', result.value.contentType);
+        response.setHeader('Cache-Control', 'no-store');
+        if (!result.value.body) {
+            response.end();
+            return;
+        }
+        Readable.fromWeb(result.value.body).on('error', (error) => response.destroy(error)).pipe(response);
+    }));
+    return router;
+}
+//# sourceMappingURL=voice.routes.js.map

package/dist-server/server/modules/voice/voice.routes.js.map

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