@aquex/cmos-mcp 1.0.0

package/dist/utils/abort.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Abort utilities for cancelable async operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationTimeoutError = exports.OperationAbortedError = void 0;
+exports.throwIfAborted = throwIfAborted;
+exports.withAbort = withAbort;
+exports.createTimeoutController = createTimeoutController;
+class OperationAbortedError extends Error {
+    constructor(message = 'Operation aborted') {
+        super(message);
+        this.name = 'AbortError';
+    }
+}
+exports.OperationAbortedError = OperationAbortedError;
+class OperationTimeoutError extends Error {
+    constructor(message = 'Operation timed out') {
+        super(message);
+        this.name = 'TimeoutError';
+    }
+}
+exports.OperationTimeoutError = OperationTimeoutError;
+function toAbortError(signal, message) {
+    const fallback = message ?? 'Operation aborted';
+    const reason = signal.reason;
+    if (reason instanceof Error) {
+        return reason;
+    }
+    if (typeof reason === 'string' && reason.trim().length > 0) {
+        return new OperationAbortedError(reason);
+    }
+    if (reason && typeof reason === 'object' && 'message' in reason) {
+        const reasonMessage = reason.message;
+        if (typeof reasonMessage === 'string' && reasonMessage.trim().length > 0) {
+            return new OperationAbortedError(reasonMessage);
+        }
+    }
+    return new OperationAbortedError(fallback);
+}
+function throwIfAborted(signal, message) {
+    if (!signal || !signal.aborted) {
+        return;
+    }
+    throw toAbortError(signal, message);
+}
+function withAbort(promise, signal, message) {
+    if (!signal) {
+        return promise;
+    }
+    if (signal.aborted) {
+        return Promise.reject(toAbortError(signal, message));
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            cleanup();
+            reject(toAbortError(signal, message));
+        };
+        const cleanup = () => {
+            signal.removeEventListener('abort', onAbort);
+        };
+        promise
+            .then((value) => {
+            cleanup();
+            resolve(value);
+        })
+            .catch((error) => {
+            cleanup();
+            reject(error);
+        });
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+function createTimeoutController(timeoutMs, message) {
+    const controller = new AbortController();
+    const timeoutMessage = message ?? `Operation timed out after ${timeoutMs}ms`;
+    const timer = setTimeout(() => {
+        controller.abort(new OperationTimeoutError(timeoutMessage));
+    }, timeoutMs);
+    const dispose = () => {
+        clearTimeout(timer);
+    };
+    controller.signal.addEventListener('abort', dispose, { once: true });
+    return {
+        controller,
+        dispose,
+    };
+}
+//# sourceMappingURL=abort.js.map

package/dist/utils/abort.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,14 @@
+import type { Mode, PathLike, RmOptions, WriteFileOptions } from 'fs';
+export declare function pathExists(targetPath: PathLike): Promise<boolean>;
+export declare function ensureDir(directoryPath: PathLike): Promise<void>;
+export declare function writeFileAtomic(filePath: PathLike, data: string | NodeJS.ArrayBufferView, options?: WriteFileOptions): Promise<void>;
+export declare function removeFile(targetPath: PathLike): Promise<void>;
+export declare function removeDir(targetPath: PathLike, options?: RmOptions): Promise<void>;
+export declare function chmod(targetPath: PathLike, mode: Mode): Promise<void>;
+export interface MkdirOptions {
+    readonly mode?: Mode;
+}
+export declare function ensureTempDir(prefix: string): Promise<string>;
+export type ConcurrencyTask<T> = () => Promise<T>;
+export declare function runWithConcurrency<T>(tasks: readonly ConcurrencyTask<T>[], limit?: number): Promise<T[]>;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAC;AAatE,wBAAsB,UAAU,CAAC,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBvE;AAED,wBAAsB,SAAS,CAAC,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EACrC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpE;AAED,wBAAsB,SAAS,CAC7B,UAAU,EAAE,QAAQ,EACpB,OAAO,GAAE,SAA4C,GACpD,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;CACtB;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAElD,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,EACpC,KAAK,SAAI,GACR,OAAO,CAAC,CAAC,EAAE,CAAC,CAkBd"}

package/dist/utils/fs.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pathExists = pathExists;
+exports.ensureDir = ensureDir;
+exports.writeFileAtomic = writeFileAtomic;
+exports.removeFile = removeFile;
+exports.removeDir = removeDir;
+exports.chmod = chmod;
+exports.ensureTempDir = ensureTempDir;
+exports.runWithConcurrency = runWithConcurrency;
+const fs_1 = require("fs");
+const crypto_1 = __importDefault(require("crypto"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+function normalizeError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return Object.assign(new Error(String(error)), { code: 'UNKNOWN' });
+}
+async function pathExists(targetPath) {
+    try {
+        await fs_1.promises.access(targetPath, fs_1.constants.F_OK);
+        return true;
+    }
+    catch (error) {
+        const err = normalizeError(error);
+        const code = typeof err.code === 'string' ? err.code.toUpperCase() : undefined;
+        const message = (err.message || '').toUpperCase();
+        if (code === 'ENOENT' ||
+            code === 'ENOTDIR' ||
+            message.includes('ENOENT') ||
+            message.includes('ENOTDIR')) {
+            return false;
+        }
+        throw err;
+    }
+}
+async function ensureDir(directoryPath) {
+    await fs_1.promises.mkdir(directoryPath, { recursive: true });
+}
+async function writeFileAtomic(filePath, data, options = {}) {
+    const resolvedPath = typeof filePath === 'string' ? filePath : filePath.toString();
+    const directory = path_1.default.dirname(resolvedPath);
+    await ensureDir(directory);
+    const uniqueSuffix = `${process.pid}-${Date.now()}-${crypto_1.default.randomBytes(6).toString('hex')}`;
+    const tempFile = path_1.default.join(directory, `.tmp-${path_1.default.basename(resolvedPath)}-${uniqueSuffix}`);
+    try {
+        await fs_1.promises.writeFile(tempFile, data, options);
+        await fs_1.promises.rename(tempFile, resolvedPath);
+    }
+    catch (error) {
+        const err = normalizeError(error);
+        if (err.code === 'EXDEV') {
+            // Cross-device rename fallback: copy + unlink
+            await fs_1.promises.copyFile(tempFile, resolvedPath, fs_1.constants.COPYFILE_FICLONE);
+            await fs_1.promises.unlink(tempFile);
+        }
+        else {
+            try {
+                await fs_1.promises.unlink(tempFile);
+            }
+            catch {
+                // Ignore cleanup failures
+            }
+            throw err;
+        }
+    }
+}
+async function removeFile(targetPath) {
+    try {
+        await fs_1.promises.unlink(targetPath);
+    }
+    catch (error) {
+        const err = normalizeError(error);
+        const code = typeof err.code === 'string' ? err.code.toUpperCase() : undefined;
+        const message = (err.message || '').toUpperCase();
+        if (code === 'ENOENT' || message.includes('ENOENT')) {
+            return;
+        }
+        throw err;
+    }
+}
+async function removeDir(targetPath, options = { recursive: true, force: true }) {
+    await fs_1.promises.rm(targetPath, options);
+}
+async function chmod(targetPath, mode) {
+    await fs_1.promises.chmod(targetPath, mode);
+}
+async function ensureTempDir(prefix) {
+    const base = path_1.default.join(os_1.default.tmpdir(), prefix);
+    await ensureDir(base);
+    return fs_1.promises.mkdtemp(`${base}${path_1.default.sep}`);
+}
+async function runWithConcurrency(tasks, limit = 8) {
+    if (limit <= 0) {
+        throw new Error('Concurrency limit must be greater than zero');
+    }
+    const results = [];
+    let current = 0;
+    async function worker() {
+        while (current < tasks.length) {
+            const index = current++;
+            results[index] = await tasks[index]();
+        }
+    }
+    const workerCount = Math.min(limit, tasks.length);
+    await Promise.all(Array.from({ length: workerCount }, () => worker()));
+    return results;
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

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

package/dist/utils/workspace-io.d.ts

@@ -0,0 +1,18 @@
+import { WorkspacePathOptions } from '../security/workspace-guard';
+export { getWorkspaceRoot } from '../security/workspace-guard';
+export type ResolveWorkspacePathOptions = WorkspacePathOptions;
+export declare function resolveWorkspacePath(inputPath: string, options?: ResolveWorkspacePathOptions): Promise<string>;
+export interface AtomicWorkspaceWriteOptions {
+    readonly encoding?: BufferEncoding | null;
+    readonly mode?: number;
+    readonly flag?: string;
+    readonly signal?: AbortSignal;
+    readonly backupSuffix?: string;
+    readonly allowedExtensions?: readonly string[];
+    readonly allowRelative?: boolean;
+    readonly baseDir?: string;
+}
+export declare function writeFileAtomicWithBackup(targetPath: string, data: string | NodeJS.ArrayBufferView, options?: AtomicWorkspaceWriteOptions): Promise<{
+    backupPath?: string;
+}>;
+//# sourceMappingURL=workspace-io.d.ts.map

package/dist/utils/workspace-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-io.d.ts","sourceRoot":"","sources":["../../src/utils/workspace-io.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAC;AAE/D,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,EACrC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BlC"}

package/dist/utils/workspace-io.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWorkspaceRoot = void 0;
+exports.resolveWorkspacePath = resolveWorkspacePath;
+exports.writeFileAtomicWithBackup = writeFileAtomicWithBackup;
+const fs_1 = require("fs");
+const fs_2 = require("./fs");
+const workspace_guard_1 = require("../security/workspace-guard");
+var workspace_guard_2 = require("../security/workspace-guard");
+Object.defineProperty(exports, "getWorkspaceRoot", { enumerable: true, get: function () { return workspace_guard_2.getWorkspaceRoot; } });
+async function resolveWorkspacePath(inputPath, options = {}) {
+    return (0, workspace_guard_1.resolveWorkspacePath)(inputPath, options);
+}
+async function writeFileAtomicWithBackup(targetPath, data, options = {}) {
+    const { backupSuffix, allowedExtensions, allowRelative, baseDir, ...writeOptions } = options;
+    const sanitizedTarget = await (0, workspace_guard_1.resolveWorkspacePath)(targetPath, {
+        allowRelative: allowRelative ?? true,
+        allowedExtensions,
+        baseDir,
+    });
+    const suffix = backupSuffix ?? '.backup';
+    const backupPath = `${sanitizedTarget}${suffix}`;
+    const originalExists = await (0, fs_2.pathExists)(sanitizedTarget);
+    let backupCreated = false;
+    if (originalExists) {
+        await fs_1.promises.copyFile(sanitizedTarget, backupPath);
+        backupCreated = true;
+    }
+    try {
+        await (0, fs_2.writeFileAtomic)(sanitizedTarget, data, writeOptions);
+        return backupCreated ? { backupPath } : {};
+    }
+    catch (error) {
+        if (backupCreated) {
+            await fs_1.promises.copyFile(backupPath, sanitizedTarget).catch(() => undefined);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=workspace-io.js.map

package/dist/utils/workspace-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-io.js","sourceRoot":"","sources":["../../src/utils/workspace-io.ts"],"names":[],"mappings":";;;AAWA,oDAKC;AAaD,8DA+BC;AA5DD,2BAAoC;AACpC,6BAAmD;AACnD,iEAGqC;AAErC,+DAA+D;AAAtD,mHAAA,gBAAgB,OAAA;AAIlB,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,UAAuC,EAAE;IAEzC,OAAO,IAAA,sCAAyB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAaM,KAAK,UAAU,yBAAyB,CAC7C,UAAkB,EAClB,IAAqC,EACrC,UAAuC,EAAE;IAEzC,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAC7F,MAAM,eAAe,GAAG,MAAM,IAAA,sCAAyB,EAAC,UAAU,EAAE;QAClE,aAAa,EAAE,aAAa,IAAI,IAAI;QACpC,iBAAiB;QACjB,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,YAAY,IAAI,SAAS,CAAC;IACzC,MAAM,UAAU,GAAG,GAAG,eAAe,GAAG,MAAM,EAAE,CAAC;IACjD,MAAM,cAAc,GAAG,MAAM,IAAA,eAAU,EAAC,eAAe,CAAC,CAAC;IACzD,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,aAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC/C,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAA,oBAAe,EAAC,eAAe,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAC3D,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,aAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/validation/common.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export interface SafeFilePathOptions {
+    readonly baseDir?: string;
+    readonly allowRelative?: boolean;
+    readonly allowedExtensions?: readonly string[];
+    readonly maxLength?: number;
+    readonly allowSymbolicLinks?: boolean;
+}
+export declare function safeFilePath(rawPath: string, options?: SafeFilePathOptions): Promise<string>;
+export declare function missionId(value: string): string;
+export declare function domainName(value: string): string;
+export interface StructuredContentOptions<T extends z.ZodTypeAny = z.ZodTypeAny> {
+    readonly schema?: T;
+    readonly maxSize?: number;
+}
+export declare function yamlContent<TOutput = unknown, TSchema extends z.ZodTypeAny = z.ZodTypeAny>(rawContent: string, options?: StructuredContentOptions<TSchema>): TOutput;
+export declare function jsonContent<TOutput = unknown, TSchema extends z.ZodTypeAny = z.ZodTypeAny>(rawContent: string, options?: StructuredContentOptions<TSchema>): TOutput;
+export declare const MissionIdSchema: z.ZodString;
+export declare const DomainNameSchema: z.ZodString;
+export declare const FilePathSchema: z.ZodBranded<z.ZodEffects<z.ZodString, string, string>, "FilePath">;
+//# sourceMappingURL=common.d.ts.map

package/dist/validation/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/validation/common.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmCxB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAsHD,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EACxF,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,wBAAwB,CAAC,OAAO,CAAM,GAC9C,OAAO,CAyBT;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EACxF,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,wBAAwB,CAAC,OAAO,CAAM,GAC9C,OAAO,CAwBT;AAED,eAAO,MAAM,eAAe,aAAwB,CAAC;AACrD,eAAO,MAAM,gBAAgB,aAAyB,CAAC;AAEvD,eAAO,MAAM,cAAc,qEAcL,CAAC"}

package/dist/validation/common.js

@@ -0,0 +1,241 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilePathSchema = exports.DomainNameSchema = exports.MissionIdSchema = void 0;
+exports.safeFilePath = safeFilePath;
+exports.missionId = missionId;
+exports.domainName = domainName;
+exports.yamlContent = yamlContent;
+exports.jsonContent = jsonContent;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const yaml_1 = __importDefault(require("yaml"));
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const DEFAULT_MAX_PATH_LENGTH = 4096;
+const DEFAULT_MAX_CONTENT_SIZE = 1024 * 1024; // 1MB
+const pathStringSchema = zod_1.z
+    .string({
+    required_error: 'Path value is required',
+    invalid_type_error: 'Path must be a string',
+})
+    .min(1, 'Path cannot be empty')
+    .max(DEFAULT_MAX_PATH_LENGTH, 'Path is too long')
+    .refine((value) => !value.includes('\0'), {
+    message: 'Path cannot contain null bytes',
+});
+const missionIdStringSchema = zod_1.z
+    .string({
+    required_error: 'Mission ID is required',
+    invalid_type_error: 'Mission ID must be a string',
+})
+    .min(3)
+    .max(64)
+    .regex(/^M\d{2}(?:-[A-Za-z0-9]+)*$/, 'Mission ID must follow format M##(-segment)*');
+const domainNameStringSchema = zod_1.z
+    .string({
+    required_error: 'Domain name is required',
+    invalid_type_error: 'Domain name must be a string',
+})
+    .min(3)
+    .max(64)
+    .regex(/^[a-z][a-z0-9-]+$/, 'Domain name must be lowercase alphanumeric with hyphens');
+function ensureAllowedExtension(filePath, allowed) {
+    if (!allowed || allowed.length === 0) {
+        return;
+    }
+    const ext = path_1.default.extname(filePath).toLowerCase();
+    const normalizedList = allowed.map((value) => value.startsWith('.') ? value.toLowerCase() : `.${value.toLowerCase()}`);
+    if (!normalizedList.includes(ext)) {
+        throw new errors_1.SanitizationError('File extension is not permitted', {
+            data: { filePath, allowedExtensions: normalizedList },
+        });
+    }
+}
+function ensureWithinBaseDir(resolvedPath, baseDir) {
+    const normalizedBase = path_1.default.resolve(baseDir);
+    const normalizedPath = path_1.default.resolve(resolvedPath);
+    const baseWithSep = normalizedBase.endsWith(path_1.default.sep)
+        ? normalizedBase
+        : `${normalizedBase}${path_1.default.sep}`;
+    const isWithin = normalizedPath === normalizedBase || normalizedPath.startsWith(baseWithSep);
+    if (!isWithin) {
+        throw new errors_1.SanitizationError('Path escapes allowed base directory', {
+            data: { resolvedPath, baseDir: normalizedBase },
+        });
+    }
+}
+async function tryRealpath(target) {
+    try {
+        return await fs_1.promises.realpath(target);
+    }
+    catch (error) {
+        const err = error;
+        if (err && (err.code === 'ENOENT' || err.code === 'ENOTDIR')) {
+            return null;
+        }
+        throw new errors_1.SanitizationError('Unable to resolve real path', {
+            cause: error,
+            data: { path: target },
+        });
+    }
+}
+function isWithinBase(actualPath, basePath) {
+    const normalizedBase = basePath.endsWith(path_1.default.sep) ? basePath : `${basePath}${path_1.default.sep}`;
+    return actualPath === basePath || actualPath.startsWith(normalizedBase);
+}
+async function findExistingAncestor(target) {
+    let current = target;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const real = await tryRealpath(current);
+        if (real) {
+            return real;
+        }
+        const parent = path_1.default.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+async function ensureNoSymlinkEscape(sanitizedPath, options) {
+    if (!options.baseDir || options.allowSymbolicLinks) {
+        return;
+    }
+    const realBase = (await tryRealpath(options.baseDir)) ?? path_1.default.resolve(options.baseDir);
+    const targetReal = await tryRealpath(sanitizedPath);
+    if (targetReal) {
+        if (!isWithinBase(targetReal, realBase)) {
+            throw new errors_1.SanitizationError('Path escapes allowed base directory via symlink resolution', {
+                data: { resolvedPath: targetReal, baseDir: realBase },
+            });
+        }
+        try {
+            const stats = await fs_1.promises.lstat(sanitizedPath);
+            if (stats.isSymbolicLink() && !options.allowSymbolicLinks) {
+                throw new errors_1.SanitizationError('Symbolic links are not permitted for paths within base directory', {
+                    data: { path: sanitizedPath },
+                });
+            }
+        }
+        catch (error) {
+            throw new errors_1.SanitizationError('Unable to inspect filesystem entry for symbolic links', {
+                cause: error,
+                data: { path: sanitizedPath },
+            });
+        }
+        return;
+    }
+    const ancestorReal = await findExistingAncestor(sanitizedPath);
+    if (ancestorReal && !isWithinBase(ancestorReal, realBase)) {
+        throw new errors_1.SanitizationError('Path escapes allowed base directory via unresolved symlink', {
+            data: { resolvedPath: ancestorReal, baseDir: realBase },
+        });
+    }
+}
+async function safeFilePath(rawPath, options = {}) {
+    const maxLength = options.maxLength ?? DEFAULT_MAX_PATH_LENGTH;
+    const parsedPath = pathStringSchema.parse(rawPath);
+    if (parsedPath.length > maxLength) {
+        throw new errors_1.SanitizationError(`Path must be <= ${maxLength} characters`, {
+            data: { path: parsedPath, maxLength },
+        });
+    }
+    const normalized = path_1.default.normalize(parsedPath);
+    const segments = normalized.split(path_1.default.sep).filter(Boolean);
+    if (segments.some((segment) => segment === '..')) {
+        throw new errors_1.SanitizationError('Path cannot contain parent directory traversals', {
+            data: { path: parsedPath },
+        });
+    }
+    const isAbsolute = path_1.default.isAbsolute(normalized);
+    const allowRelative = options.allowRelative ?? true;
+    if (!allowRelative && !isAbsolute) {
+        throw new errors_1.SanitizationError('Path must be absolute', { data: { path: parsedPath } });
+    }
+    let sanitizedPath = normalized;
+    if (options.baseDir) {
+        sanitizedPath = isAbsolute ? normalized : path_1.default.resolve(options.baseDir, normalized);
+        ensureWithinBaseDir(sanitizedPath, options.baseDir);
+        await ensureNoSymlinkEscape(sanitizedPath, options);
+    }
+    ensureAllowedExtension(sanitizedPath, options.allowedExtensions);
+    return sanitizedPath;
+}
+function missionId(value) {
+    return missionIdStringSchema.parse(value);
+}
+function domainName(value) {
+    return domainNameStringSchema.parse(value);
+}
+function yamlContent(rawContent, options = {}) {
+    const contentSchema = zod_1.z
+        .string({
+        required_error: 'YAML content is required',
+        invalid_type_error: 'YAML content must be a string',
+    })
+        .min(1, 'YAML content cannot be empty')
+        .max(options.maxSize ?? DEFAULT_MAX_CONTENT_SIZE, 'YAML content exceeds maximum allowed size')
+        .refine((value) => !value.includes('\0'), 'Content cannot contain null bytes');
+    const sanitized = contentSchema.parse(rawContent);
+    try {
+        const parsed = yaml_1.default.parse(sanitized);
+        if (options.schema) {
+            const result = options.schema.parse(parsed);
+            return result;
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new errors_1.SchemaError('Failed to parse YAML content', {
+            cause: error,
+            data: { message: error instanceof Error ? error.message : String(error) },
+        });
+    }
+}
+function jsonContent(rawContent, options = {}) {
+    const contentSchema = zod_1.z
+        .string({
+        required_error: 'JSON content is required',
+        invalid_type_error: 'JSON content must be a string',
+    })
+        .min(2, 'JSON content cannot be empty')
+        .max(options.maxSize ?? DEFAULT_MAX_CONTENT_SIZE, 'JSON content exceeds maximum allowed size');
+    const sanitized = contentSchema.parse(rawContent);
+    try {
+        const parsed = JSON.parse(sanitized);
+        if (options.schema) {
+            const result = options.schema.parse(parsed);
+            return result;
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new errors_1.SchemaError('Failed to parse JSON content', {
+            cause: error,
+            data: { message: error instanceof Error ? error.message : String(error) },
+        });
+    }
+}
+exports.MissionIdSchema = missionIdStringSchema;
+exports.DomainNameSchema = domainNameStringSchema;
+exports.FilePathSchema = zod_1.z
+    .string()
+    .transform(async (value, ctx) => {
+    try {
+        return await safeFilePath(value, { allowRelative: true });
+    }
+    catch (error) {
+        const normalized = (0, errors_1.normalizeValidationError)(error);
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: normalized.message,
+        });
+        return zod_1.z.NEVER;
+    }
+})
+    .brand();
+//# sourceMappingURL=common.js.map

package/dist/validation/common.js.map

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

package/dist/validation/errors.d.ts

@@ -0,0 +1,21 @@
+import { ZodIssue } from 'zod';
+export interface ValidationErrorOptions {
+    readonly issues?: ZodIssue[];
+    readonly cause?: unknown;
+    readonly code?: string;
+    readonly data?: Record<string, unknown>;
+}
+export declare class ValidationError extends Error {
+    readonly issues?: ZodIssue[];
+    readonly code: string;
+    readonly data?: Record<string, unknown>;
+    constructor(message: string, options?: ValidationErrorOptions);
+}
+export declare class SchemaError extends ValidationError {
+    constructor(message: string, options?: ValidationErrorOptions);
+}
+export declare class SanitizationError extends ValidationError {
+    constructor(message: string, options?: ValidationErrorOptions);
+}
+export declare function normalizeValidationError(error: unknown, fallbackMessage?: string): ValidationError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/validation/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/validation/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEnC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;CAUlE;AAED,qBAAa,WAAY,SAAQ,eAAe;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;CAIlE;AAED,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;CAIlE;AAsED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,eAAe,SAA4B,GAC1C,eAAe,CA0BjB"}