devchain-cli 0.1.0

package/dist/server/modules/core/services/preflight.service.js

@@ -0,0 +1,400 @@
+"use strict";
+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 __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreflightService = void 0;
+const common_1 = require("@nestjs/common");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const promises_1 = require("fs/promises");
+const logger_1 = require("../../../common/logging/logger");
+const path = __importStar(require("path"));
+const mcp_provider_registration_service_1 = require("../../mcp/services/mcp-provider-registration.service");
+const profile_options_1 = require("../../sessions/utils/profile-options");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const logger = (0, logger_1.createLogger)('PreflightService');
+let PreflightService = class PreflightService {
+    constructor(storage, mcpRegistration) {
+        this.storage = storage;
+        this.mcpRegistration = mcpRegistration;
+        this.cache = new Map();
+        this.CACHE_TTL_MS = 60000;
+    }
+    async runChecks(projectPath) {
+        const cacheKey = projectPath || '';
+        const cached = this.cache.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            logger.debug({ projectPath, cacheHit: true }, 'Returning cached preflight results');
+            return cached.result;
+        }
+        if (process.env.SKIP_PREFLIGHT === '1') {
+            const result = {
+                overall: 'pass',
+                checks: [
+                    {
+                        name: 'preflight',
+                        status: 'pass',
+                        message: 'Preflight checks skipped (test mode)',
+                    },
+                ],
+                providers: [],
+                timestamp: new Date().toISOString(),
+            };
+            this.cache.set(cacheKey, {
+                result,
+                expiresAt: Date.now() + this.CACHE_TTL_MS,
+            });
+            return result;
+        }
+        logger.info({ projectPath }, 'Running preflight checks');
+        const checks = [];
+        const providerChecks = [];
+        checks.push(await this.checkTmux());
+        let profiles = [];
+        let scopedProjectId = undefined;
+        if (projectPath) {
+            try {
+                const project = await this.storage.findProjectByPath(projectPath);
+                scopedProjectId = project?.id;
+                logger.debug({ projectPath, projectId: scopedProjectId }, 'Resolved project for preflight profile scoping');
+            }
+            catch (e) {
+                logger.warn({ projectPath }, 'Failed to resolve project by path for preflight');
+            }
+        }
+        try {
+            const profileResult = await this.storage.listAgentProfiles(scopedProjectId ? { projectId: scopedProjectId } : {});
+            profiles = profileResult.items ?? [];
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to fetch agent profiles for preflight checks');
+            checks.push({
+                name: 'profiles',
+                status: 'warn',
+                message: 'Failed to inspect agent profiles for options validation',
+                details: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+        try {
+            const providersResult = await this.storage.listProviders();
+            logger.debug({ providerCount: providersResult.items.length }, 'Fetched providers for preflight');
+            for (const provider of providersResult.items) {
+                const relevantProfiles = profiles.filter((profile) => profile.providerId === provider.id);
+                providerChecks.push(await this.checkProvider(provider, relevantProfiles, projectPath));
+            }
+        }
+        catch (error) {
+            logger.error({ error }, 'Failed to fetch providers for preflight checks');
+            checks.push({
+                name: 'providers',
+                status: 'warn',
+                message: 'Failed to fetch provider configuration',
+                details: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+        if (projectPath) {
+            checks.push(await this.checkDevchainAccess(projectPath));
+        }
+        const hasFail = checks.some((c) => c.status === 'fail') || providerChecks.some((p) => p.status === 'fail');
+        const hasWarn = checks.some((c) => c.status === 'warn') || providerChecks.some((p) => p.status === 'warn');
+        const overall = hasFail ? 'fail' : hasWarn ? 'warn' : 'pass';
+        const result = {
+            overall,
+            checks,
+            providers: providerChecks,
+            timestamp: new Date().toISOString(),
+        };
+        this.cache.set(cacheKey, {
+            result,
+            expiresAt: Date.now() + this.CACHE_TTL_MS,
+        });
+        logger.info({ overall, checkCount: checks.length, providerCount: providerChecks.length }, 'Preflight checks completed');
+        return result;
+    }
+    async evaluateMcpStatus(provider, projectPath) {
+        if (!this.isMcpSupported(provider.name)) {
+            return {
+                mcpStatus: 'pass',
+                mcpMessage: 'MCP not required for this provider.',
+            };
+        }
+        const { getEnvConfig } = await Promise.resolve().then(() => __importStar(require('../../../common/config/env.config')));
+        const env = getEnvConfig();
+        const expectedEndpoint = `http://127.0.0.1:${env.PORT}/mcp`;
+        const expectedAlias = 'devchain';
+        const listResult = await this.mcpRegistration.listRegistrations(provider, {
+            cwd: projectPath,
+        });
+        if (!listResult.success) {
+            return {
+                mcpStatus: 'fail',
+                mcpMessage: listResult.message,
+                mcpDetails: undefined,
+            };
+        }
+        const devchainEntry = listResult.entries.find((entry) => entry.alias === expectedAlias);
+        if (!devchainEntry) {
+            return {
+                mcpStatus: 'warn',
+                mcpMessage: `MCP alias '${expectedAlias}' not found.`,
+                mcpDetails: `Run Configure MCP or use ensure endpoint to add: ${expectedEndpoint}`,
+            };
+        }
+        if (devchainEntry.endpoint !== expectedEndpoint) {
+            return {
+                mcpStatus: 'warn',
+                mcpMessage: `MCP endpoint mismatch for alias '${expectedAlias}'.`,
+                mcpDetails: `Expected: ${expectedEndpoint}, Found: ${devchainEntry.endpoint}. Run Configure MCP or use ensure endpoint to fix.`,
+            };
+        }
+        return {
+            mcpStatus: 'pass',
+            mcpMessage: `MCP registered correctly (${expectedAlias} → ${expectedEndpoint}).`,
+        };
+    }
+    isMcpSupported(name) {
+        return ['claude', 'codex'].includes(name);
+    }
+    async checkTmux() {
+        try {
+            const { stdout } = await execAsync('tmux -V');
+            const version = stdout.trim();
+            const versionMatch = version.match(/tmux\s+(?:next-)?(\d+)\.?(\d+)?/);
+            if (!versionMatch) {
+                return {
+                    name: 'tmux',
+                    status: 'warn',
+                    message: 'tmux found but version could not be parsed',
+                    details: `Output: "${version}". This may still work if tmux is properly installed.`,
+                };
+            }
+            const major = parseInt(versionMatch[1], 10);
+            const minor = versionMatch[2] ? parseInt(versionMatch[2], 10) : 0;
+            const versionNum = major + minor / 10;
+            if (versionNum < 2.6) {
+                return {
+                    name: 'tmux',
+                    status: 'warn',
+                    message: `tmux ${version} found (recommend 2.6+)`,
+                    details: 'Older versions may have compatibility issues with session management',
+                };
+            }
+            return {
+                name: 'tmux',
+                status: 'pass',
+                message: `tmux ${version} found`,
+            };
+        }
+        catch (error) {
+            return {
+                name: 'tmux',
+                status: 'fail',
+                message: 'tmux not found',
+                details: 'Install tmux: apt-get install tmux (Debian/Ubuntu) or brew install tmux (macOS)',
+            };
+        }
+    }
+    async checkProvider(provider, profiles, projectPath) {
+        let binaryStatus = 'warn';
+        let binaryMessage = `${provider.name} binary not configured`;
+        let binaryDetails;
+        let resolvedBinPath = provider.binPath ?? null;
+        try {
+            if (provider.binPath && path.isAbsolute(provider.binPath)) {
+                await (0, promises_1.access)(provider.binPath, promises_1.constants.X_OK);
+                binaryStatus = 'pass';
+                binaryMessage = `${provider.name} binary found at ${provider.binPath}`;
+            }
+            else {
+                const resolution = await this.mcpRegistration.resolveBinary(provider);
+                if (resolution.success && resolution.binaryPath) {
+                    binaryStatus = 'pass';
+                    resolvedBinPath = resolution.binaryPath;
+                    binaryMessage = `${provider.name} binary available at ${resolution.binaryPath}`;
+                    binaryDetails = resolution.source === 'which' ? 'Discovered via PATH lookup.' : undefined;
+                }
+                else {
+                    binaryStatus = 'warn';
+                    binaryDetails =
+                        resolution.message ??
+                            'Set a binary path or ensure the binary is on PATH via Providers settings.';
+                }
+            }
+        }
+        catch (error) {
+            binaryStatus = 'fail';
+            binaryMessage = `${provider.name} binary not accessible`;
+            binaryDetails =
+                error instanceof Error
+                    ? error.message
+                    : 'Binary is either missing or not executable. Check file permissions.';
+        }
+        let optionsStatus = 'pass';
+        let optionsMessage;
+        let optionsDetails;
+        const optionErrors = [];
+        for (const profile of profiles) {
+            if (!profile.options) {
+                continue;
+            }
+            try {
+                (0, profile_options_1.parseProfileOptions)(profile.options);
+            }
+            catch (error) {
+                if (error instanceof profile_options_1.ProfileOptionsError) {
+                    optionsStatus = 'fail';
+                    optionErrors.push(`${profile.name}: ${error.message}`);
+                }
+                else {
+                    optionsStatus = 'fail';
+                    optionErrors.push(`${profile.name}: invalid options`);
+                }
+            }
+        }
+        if (optionErrors.length > 0) {
+            optionsMessage = `Invalid options in ${optionErrors.length} profile${optionErrors.length === 1 ? '' : 's'}.`;
+            optionsDetails = optionErrors.join(' | ');
+        }
+        const { mcpStatus, mcpMessage, mcpDetails } = await this.evaluateMcpStatus(provider, projectPath);
+        const statusCollection = [
+            binaryStatus,
+            mcpStatus,
+            optionsStatus,
+        ];
+        const overallStatus = statusCollection.includes('fail')
+            ? 'fail'
+            : statusCollection.includes('warn')
+                ? 'warn'
+                : 'pass';
+        const summaryMessage = optionsStatus === overallStatus && optionsMessage
+            ? optionsMessage
+            : binaryStatus === overallStatus
+                ? binaryMessage
+                : (mcpMessage ?? binaryMessage);
+        const combinedDetails = [binaryDetails, optionsDetails, mcpDetails].filter(Boolean).join(' | ') || undefined;
+        return {
+            id: provider.id,
+            name: provider.name,
+            binPath: resolvedBinPath,
+            status: overallStatus,
+            message: summaryMessage,
+            details: combinedDetails,
+            binaryStatus,
+            binaryMessage,
+            binaryDetails,
+            mcpStatus,
+            mcpMessage,
+            mcpDetails,
+            mcpEndpoint: provider.mcpEndpoint,
+        };
+    }
+    async checkDevchainAccess(projectPath) {
+        try {
+            const devchainPath = path.join(projectPath, '.devchain');
+            try {
+                await (0, promises_1.access)(devchainPath, promises_1.constants.W_OK);
+                return {
+                    name: '.devchain access',
+                    status: 'pass',
+                    message: `Write access to ${devchainPath} verified`,
+                };
+            }
+            catch (accessError) {
+                try {
+                    await (0, promises_1.mkdir)(devchainPath, { recursive: true });
+                    return {
+                        name: '.devchain access',
+                        status: 'pass',
+                        message: `Created ${devchainPath} with write access`,
+                    };
+                }
+                catch (mkdirError) {
+                    return {
+                        name: '.devchain access',
+                        status: 'fail',
+                        message: `Cannot create/write to ${devchainPath}`,
+                        details: `Error: ${mkdirError instanceof Error ? mkdirError.message : 'Unknown error'}. Check directory permissions.`,
+                    };
+                }
+            }
+        }
+        catch (error) {
+            return {
+                name: '.devchain access',
+                status: 'fail',
+                message: 'Failed to check .devchain directory',
+                details: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    async getCheck(checkName, projectPath) {
+        const result = await this.runChecks(projectPath);
+        const check = result.checks.find((c) => c.name === checkName);
+        if (!check) {
+            throw new Error(`Check not found: ${checkName}`);
+        }
+        return check;
+    }
+    clearCache(projectPath) {
+        if (projectPath !== undefined) {
+            const cacheKey = projectPath || '';
+            this.cache.delete(cacheKey);
+            logger.debug({ projectPath }, 'Cleared preflight cache');
+        }
+        else {
+            this.cache.clear();
+            logger.debug('Cleared all preflight cache');
+        }
+    }
+};
+exports.PreflightService = PreflightService;
+exports.PreflightService = PreflightService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('STORAGE_SERVICE')),
+    __param(1, (0, common_1.Inject)((0, common_1.forwardRef)(() => mcp_provider_registration_service_1.McpProviderRegistrationService))),
+    __metadata("design:paramtypes", [Object, mcp_provider_registration_service_1.McpProviderRegistrationService])
+], PreflightService);
+//# sourceMappingURL=preflight.service.js.map

package/dist/server/modules/core/services/preflight.service.js.map

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

package/dist/server/modules/documents/controllers/documents.controller.d.ts

@@ -0,0 +1,12 @@
+import { StorageService, ListResult } from '../../storage/interfaces/storage.interface';
+import { Document } from '../../storage/models/domain.models';
+export declare class DocumentsController {
+    private readonly storage;
+    constructor(storage: StorageService);
+    listDocuments(projectId?: string, tag?: string | string[], tagsParam?: string, tagKey?: string | string[], q?: string, limit?: string, offset?: string): Promise<ListResult<Document>>;
+    getDocument(id: string): Promise<Document>;
+    getDocumentBySlug(slug?: string, projectId?: string): Promise<Document>;
+    createDocument(body: unknown): Promise<Document>;
+    updateDocument(id: string, body: unknown): Promise<Document>;
+    deleteDocument(id: string): Promise<void>;
+}

package/dist/server/modules/documents/controllers/documents.controller.js

@@ -0,0 +1,173 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentsController = void 0;
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const storage_interface_1 = require("../../storage/interfaces/storage.interface");
+const logger_1 = require("../../../common/logging/logger");
+const logger = (0, logger_1.createLogger)('DocumentsController');
+const CreateDocumentSchema = zod_1.z.object({
+    projectId: zod_1.z.string().min(1).nullable().optional(),
+    title: zod_1.z.string().min(1),
+    slug: zod_1.z.string().min(1).optional(),
+    contentMd: zod_1.z.string(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+});
+const UpdateDocumentSchema = zod_1.z.object({
+    title: zod_1.z.string().min(1).optional(),
+    slug: zod_1.z.string().min(1).optional(),
+    contentMd: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    version: zod_1.z.number().int().optional(),
+    archived: zod_1.z.boolean().optional(),
+});
+let DocumentsController = class DocumentsController {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async listDocuments(projectId, tag, tagsParam, tagKey, q, limit, offset) {
+        logger.info({ projectId, tag, tagsParam, tagKey, q, limit, offset }, 'GET /api/documents');
+        const filters = {};
+        if (projectId !== undefined) {
+            filters.projectId = projectId === '' ? null : projectId;
+        }
+        const combinedTags = [
+            ...(Array.isArray(tag) ? tag : tag ? [tag] : []),
+            ...(tagsParam ? tagsParam.split(',') : []),
+        ]
+            .map((t) => t.trim())
+            .filter((t) => t.length > 0);
+        if (combinedTags.length) {
+            filters.tags = Array.from(new Set(combinedTags));
+        }
+        const tagKeyValues = Array.isArray(tagKey) ? tagKey : tagKey ? [tagKey] : [];
+        const normalizedTagKeys = tagKeyValues
+            .flatMap((value) => value.split(','))
+            .map((value) => value.trim())
+            .filter((value) => value.length > 0);
+        if (normalizedTagKeys.length) {
+            filters.tagKeys = Array.from(new Set(normalizedTagKeys));
+        }
+        if (q) {
+            filters.q = q;
+        }
+        if (limit) {
+            const parsedLimit = parseInt(limit, 10);
+            if (!Number.isNaN(parsedLimit)) {
+                filters.limit = parsedLimit;
+            }
+        }
+        if (offset) {
+            const parsedOffset = parseInt(offset, 10);
+            if (!Number.isNaN(parsedOffset)) {
+                filters.offset = parsedOffset;
+            }
+        }
+        return this.storage.listDocuments(filters);
+    }
+    async getDocument(id) {
+        logger.info({ id }, 'GET /api/documents/:id');
+        return this.storage.getDocument({ id });
+    }
+    async getDocumentBySlug(slug, projectId) {
+        logger.info({ slug, projectId }, 'GET /api/documents/by-slug');
+        if (!slug) {
+            throw new common_1.BadRequestException('slug query parameter is required');
+        }
+        if (projectId === undefined) {
+            throw new common_1.BadRequestException('projectId query parameter is required');
+        }
+        const normalizedProjectId = projectId === '' ? null : projectId;
+        return this.storage.getDocument({ slug, projectId: normalizedProjectId });
+    }
+    async createDocument(body) {
+        logger.info('POST /api/documents');
+        const parsed = CreateDocumentSchema.parse(body);
+        const data = {
+            projectId: parsed.projectId ?? null,
+            title: parsed.title,
+            slug: parsed.slug,
+            contentMd: parsed.contentMd,
+            tags: parsed.tags,
+        };
+        return this.storage.createDocument(data);
+    }
+    async updateDocument(id, body) {
+        logger.info({ id }, 'PUT /api/documents/:id');
+        const parsed = UpdateDocumentSchema.parse(body);
+        return this.storage.updateDocument(id, parsed);
+    }
+    async deleteDocument(id) {
+        logger.info({ id }, 'DELETE /api/documents/:id');
+        await this.storage.deleteDocument(id);
+    }
+};
+exports.DocumentsController = DocumentsController;
+__decorate([
+    (0, common_1.Get)(),
+    __param(0, (0, common_1.Query)('projectId')),
+    __param(1, (0, common_1.Query)('tag')),
+    __param(2, (0, common_1.Query)('tags')),
+    __param(3, (0, common_1.Query)('tagKey')),
+    __param(4, (0, common_1.Query)('q')),
+    __param(5, (0, common_1.Query)('limit')),
+    __param(6, (0, common_1.Query)('offset')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, String, Object, String, String, String]),
+    __metadata("design:returntype", Promise)
+], DocumentsController.prototype, "listDocuments", null);
+__decorate([
+    (0, common_1.Get)(':id'),
+    __param(0, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], DocumentsController.prototype, "getDocument", null);
+__decorate([
+    (0, common_1.Get)('by-slug'),
+    __param(0, (0, common_1.Query)('slug')),
+    __param(1, (0, common_1.Query)('projectId')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String]),
+    __metadata("design:returntype", Promise)
+], DocumentsController.prototype, "getDocumentBySlug", null);
+__decorate([
+    (0, common_1.Post)(),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], DocumentsController.prototype, "createDocument", null);
+__decorate([
+    (0, common_1.Put)(':id'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], DocumentsController.prototype, "updateDocument", null);
+__decorate([
+    (0, common_1.Delete)(':id'),
+    __param(0, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], DocumentsController.prototype, "deleteDocument", null);
+exports.DocumentsController = DocumentsController = __decorate([
+    (0, common_1.Controller)('api/documents'),
+    __param(0, (0, common_1.Inject)(storage_interface_1.STORAGE_SERVICE)),
+    __metadata("design:paramtypes", [Object])
+], DocumentsController);
+//# sourceMappingURL=documents.controller.js.map

package/dist/server/modules/documents/controllers/documents.controller.js.map

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

package/dist/server/modules/documents/documents.module.d.ts

@@ -0,0 +1,2 @@
+export declare class DocumentsModule {
+}

package/dist/server/modules/documents/documents.module.js

@@ -0,0 +1,22 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentsModule = void 0;
+const common_1 = require("@nestjs/common");
+const documents_controller_1 = require("./controllers/documents.controller");
+const storage_module_1 = require("../storage/storage.module");
+let DocumentsModule = class DocumentsModule {
+};
+exports.DocumentsModule = DocumentsModule;
+exports.DocumentsModule = DocumentsModule = __decorate([
+    (0, common_1.Module)({
+        imports: [storage_module_1.StorageModule],
+        controllers: [documents_controller_1.DocumentsController],
+    })
+], DocumentsModule);
+//# sourceMappingURL=documents.module.js.map

package/dist/server/modules/documents/documents.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.module.js","sourceRoot":"","sources":["../../../src/modules/documents/documents.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,6EAAyE;AACzE,8DAA0D;AAMnD,IAAM,eAAe,GAArB,MAAM,eAAe;CAAG,CAAA;AAAlB,0CAAe;0BAAf,eAAe;IAJ3B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,8BAAa,CAAC;QACxB,WAAW,EAAE,CAAC,0CAAmB,CAAC;KACnC,CAAC;GACW,eAAe,CAAG"}

package/dist/server/modules/epics/controllers/epic-comments.controller.d.ts

@@ -0,0 +1,10 @@
+import { StorageService, ListResult } from '../../storage/interfaces/storage.interface';
+import { EpicComment } from '../../storage/models/domain.models';
+export declare class EpicCommentsController {
+    private readonly storage;
+    constructor(storage: StorageService);
+    listEpicComments(id: string, limit?: string, offset?: string): Promise<ListResult<EpicComment>>;
+    createEpicComment(id: string, body: unknown): Promise<EpicComment>;
+    deleteEpicComment(id: string): Promise<void>;
+    private parseListOptions;
+}