@defai.digital/ax-cli 1.2.2 → 2.0.1

package/dist/tools/morph-editor.js

@@ -1,308 +0,0 @@
-import * as fs from "fs-extra";
-import * as path from "path";
-import axios from "axios";
-import { ConfirmationService } from "../utils/confirmation-service.js";
-export class MorphEditorTool {
-    confirmationService = ConfirmationService.getInstance();
-    morphApiKey;
-    morphBaseUrl = "https://api.morphllm.com/v1";
-    constructor(apiKey) {
-        this.morphApiKey = apiKey || process.env.MORPH_API_KEY || "";
-        if (!this.morphApiKey) {
-            console.warn("MORPH_API_KEY not found. Morph editor functionality will be limited.");
-        }
-    }
-    /**
-     * Use this tool to make an edit to an existing file.
-     *
-     * This will be read by a less intelligent model, which will quickly apply the edit. You should make it clear what the edit is, while also minimizing the unchanged code you write.
-     * When writing the edit, you should specify each edit in sequence, with the special comment // ... existing code ... to represent unchanged code in between edited lines.
-     *
-     * For example:
-     *
-     * // ... existing code ...
-     * FIRST_EDIT
-     * // ... existing code ...
-     * SECOND_EDIT
-     * // ... existing code ...
-     * THIRD_EDIT
-     * // ... existing code ...
-     *
-     * You should still bias towards repeating as few lines of the original file as possible to convey the change.
-     * But, each edit should contain sufficient context of unchanged lines around the code you're editing to resolve ambiguity.
-     * DO NOT omit spans of pre-existing code (or comments) without using the // ... existing code ... comment to indicate its absence. If you omit the existing code comment, the model may inadvertently delete these lines.
-     * If you plan on deleting a section, you must provide context before and after to delete it. If the initial code is ```code \n Block 1 \n Block 2 \n Block 3 \n code```, and you want to remove Block 2, you would output ```// ... existing code ... \n Block 1 \n  Block 3 \n // ... existing code ...```.
-     * Make sure it is clear what the edit should be, and where it should be applied.
-     * Make edits to a file in a single edit_file call instead of multiple edit_file calls to the same file. The apply model can handle many distinct edits at once.
-     */
-    async editFile(targetFile, instructions, codeEdit) {
-        try {
-            const resolvedPath = path.resolve(targetFile);
-            if (!(await fs.pathExists(resolvedPath))) {
-                return {
-                    success: false,
-                    error: `File not found: ${targetFile}`,
-                };
-            }
-            if (!this.morphApiKey) {
-                return {
-                    success: false,
-                    error: "MORPH_API_KEY not configured. Please set your Morph API key.",
-                };
-            }
-            // Read the initial code
-            const initialCode = await fs.readFile(resolvedPath, "utf-8");
-            // Check user confirmation before proceeding
-            const sessionFlags = this.confirmationService.getSessionFlags();
-            if (!sessionFlags.fileOperations && !sessionFlags.allOperations) {
-                const confirmationResult = await this.confirmationService.requestConfirmation({
-                    operation: "Edit file with Morph Fast Apply",
-                    filename: targetFile,
-                    showVSCodeOpen: false,
-                    content: `Instructions: ${instructions}\n\nEdit:\n${codeEdit}`,
-                }, "file");
-                if (!confirmationResult.confirmed) {
-                    return {
-                        success: false,
-                        error: confirmationResult.feedback || "File edit cancelled by user",
-                    };
-                }
-            }
-            // Call Morph Fast Apply API
-            const mergedCode = await this.callMorphApply(instructions, initialCode, codeEdit);
-            // Write the merged code back to file
-            await fs.writeFile(resolvedPath, mergedCode, "utf-8");
-            // Generate diff for display
-            const oldLines = initialCode.split("\n");
-            const newLines = mergedCode.split("\n");
-            const diff = this.generateDiff(oldLines, newLines, targetFile);
-            return {
-                success: true,
-                output: diff,
-            };
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: `Error editing ${targetFile} with Morph: ${error.message}`,
-            };
-        }
-    }
-    async callMorphApply(instructions, initialCode, editSnippet) {
-        try {
-            const response = await axios.post(`${this.morphBaseUrl}/chat/completions`, {
-                model: "morph-v3-large",
-                messages: [
-                    {
-                        role: "user",
-                        content: `<instruction>${instructions}</instruction>\n<code>${initialCode}</code>\n<update>${editSnippet}</update>`,
-                    },
-                ],
-            }, {
-                headers: {
-                    "Authorization": `Bearer ${this.morphApiKey}`,
-                    "Content-Type": "application/json",
-                },
-            });
-            if (!response.data.choices || !response.data.choices[0] || !response.data.choices[0].message) {
-                throw new Error("Invalid response format from Morph API");
-            }
-            return response.data.choices[0].message.content;
-        }
-        catch (error) {
-            if (error.response) {
-                throw new Error(`Morph API error (${error.response.status}): ${error.response.data}`);
-            }
-            throw error;
-        }
-    }
-    generateDiff(oldLines, newLines, filePath) {
-        const CONTEXT_LINES = 3;
-        const changes = [];
-        let i = 0, j = 0;
-        while (i < oldLines.length || j < newLines.length) {
-            while (i < oldLines.length && j < newLines.length && oldLines[i] === newLines[j]) {
-                i++;
-                j++;
-            }
-            if (i < oldLines.length || j < newLines.length) {
-                const changeStart = { old: i, new: j };
-                let oldEnd = i;
-                let newEnd = j;
-                while (oldEnd < oldLines.length || newEnd < newLines.length) {
-                    let matchFound = false;
-                    let matchLength = 0;
-                    for (let k = 0; k < Math.min(2, oldLines.length - oldEnd, newLines.length - newEnd); k++) {
-                        if (oldEnd + k < oldLines.length &&
-                            newEnd + k < newLines.length &&
-                            oldLines[oldEnd + k] === newLines[newEnd + k]) {
-                            matchLength++;
-                        }
-                        else {
-                            break;
-                        }
-                    }
-                    if (matchLength >= 2 || (oldEnd >= oldLines.length && newEnd >= newLines.length)) {
-                        matchFound = true;
-                    }
-                    if (matchFound) {
-                        break;
-                    }
-                    if (oldEnd < oldLines.length)
-                        oldEnd++;
-                    if (newEnd < newLines.length)
-                        newEnd++;
-                }
-                changes.push({
-                    oldStart: changeStart.old,
-                    oldEnd: oldEnd,
-                    newStart: changeStart.new,
-                    newEnd: newEnd
-                });
-                i = oldEnd;
-                j = newEnd;
-            }
-        }
-        const hunks = [];
-        let accumulatedOffset = 0;
-        for (let changeIdx = 0; changeIdx < changes.length; changeIdx++) {
-            const change = changes[changeIdx];
-            let contextStart = Math.max(0, change.oldStart - CONTEXT_LINES);
-            let contextEnd = Math.min(oldLines.length, change.oldEnd + CONTEXT_LINES);
-            if (hunks.length > 0) {
-                const lastHunk = hunks[hunks.length - 1];
-                const lastHunkEnd = lastHunk.oldStart + lastHunk.oldCount;
-                if (lastHunkEnd >= contextStart) {
-                    const oldHunkEnd = lastHunk.oldStart + lastHunk.oldCount;
-                    const newContextEnd = Math.min(oldLines.length, change.oldEnd + CONTEXT_LINES);
-                    for (let idx = oldHunkEnd; idx < change.oldStart; idx++) {
-                        lastHunk.lines.push({ type: ' ', content: oldLines[idx] });
-                    }
-                    for (let idx = change.oldStart; idx < change.oldEnd; idx++) {
-                        lastHunk.lines.push({ type: '-', content: oldLines[idx] });
-                    }
-                    for (let idx = change.newStart; idx < change.newEnd; idx++) {
-                        lastHunk.lines.push({ type: '+', content: newLines[idx] });
-                    }
-                    for (let idx = change.oldEnd; idx < newContextEnd && idx < oldLines.length; idx++) {
-                        lastHunk.lines.push({ type: ' ', content: oldLines[idx] });
-                    }
-                    lastHunk.oldCount = newContextEnd - lastHunk.oldStart;
-                    lastHunk.newCount = lastHunk.oldCount + (change.newEnd - change.newStart) - (change.oldEnd - change.oldStart);
-                    continue;
-                }
-            }
-            const hunk = {
-                oldStart: contextStart + 1,
-                oldCount: contextEnd - contextStart,
-                newStart: contextStart + 1 + accumulatedOffset,
-                newCount: contextEnd - contextStart + (change.newEnd - change.newStart) - (change.oldEnd - change.oldStart),
-                lines: []
-            };
-            for (let idx = contextStart; idx < change.oldStart; idx++) {
-                hunk.lines.push({ type: ' ', content: oldLines[idx] });
-            }
-            for (let idx = change.oldStart; idx < change.oldEnd; idx++) {
-                hunk.lines.push({ type: '-', content: oldLines[idx] });
-            }
-            for (let idx = change.newStart; idx < change.newEnd; idx++) {
-                hunk.lines.push({ type: '+', content: newLines[idx] });
-            }
-            for (let idx = change.oldEnd; idx < contextEnd && idx < oldLines.length; idx++) {
-                hunk.lines.push({ type: ' ', content: oldLines[idx] });
-            }
-            hunks.push(hunk);
-            accumulatedOffset += (change.newEnd - change.newStart) - (change.oldEnd - change.oldStart);
-        }
-        let addedLines = 0;
-        let removedLines = 0;
-        for (const hunk of hunks) {
-            for (const line of hunk.lines) {
-                if (line.type === '+')
-                    addedLines++;
-                if (line.type === '-')
-                    removedLines++;
-            }
-        }
-        let summary = `Updated ${filePath} with Morph Fast Apply`;
-        if (addedLines > 0 && removedLines > 0) {
-            summary += ` - ${addedLines} addition${addedLines !== 1 ? "s" : ""} and ${removedLines} removal${removedLines !== 1 ? "s" : ""}`;
-        }
-        else if (addedLines > 0) {
-            summary += ` - ${addedLines} addition${addedLines !== 1 ? "s" : ""}`;
-        }
-        else if (removedLines > 0) {
-            summary += ` - ${removedLines} removal${removedLines !== 1 ? "s" : ""}`;
-        }
-        else if (changes.length === 0) {
-            return `No changes applied to ${filePath}`;
-        }
-        let diff = summary + "\n";
-        diff += `--- a/${filePath}\n`;
-        diff += `+++ b/${filePath}\n`;
-        for (const hunk of hunks) {
-            diff += `@@ -${hunk.oldStart},${hunk.oldCount} +${hunk.newStart},${hunk.newCount} @@\n`;
-            for (const line of hunk.lines) {
-                diff += `${line.type}${line.content}\n`;
-            }
-        }
-        return diff.trim();
-    }
-    async view(filePath, viewRange) {
-        try {
-            const resolvedPath = path.resolve(filePath);
-            if (await fs.pathExists(resolvedPath)) {
-                const stats = await fs.stat(resolvedPath);
-                if (stats.isDirectory()) {
-                    const files = await fs.readdir(resolvedPath);
-                    return {
-                        success: true,
-                        output: `Directory contents of ${filePath}:\n${files.join("\n")}`,
-                    };
-                }
-                const content = await fs.readFile(resolvedPath, "utf-8");
-                const lines = content.split("\n");
-                if (viewRange) {
-                    const [start, end] = viewRange;
-                    const selectedLines = lines.slice(start - 1, end);
-                    const numberedLines = selectedLines
-                        .map((line, idx) => `${start + idx}: ${line}`)
-                        .join("\n");
-                    return {
-                        success: true,
-                        output: `Lines ${start}-${end} of ${filePath}:\n${numberedLines}`,
-                    };
-                }
-                const totalLines = lines.length;
-                const displayLines = totalLines > 10 ? lines.slice(0, 10) : lines;
-                const numberedLines = displayLines
-                    .map((line, idx) => `${idx + 1}: ${line}`)
-                    .join("\n");
-                const additionalLinesMessage = totalLines > 10 ? `\n... +${totalLines - 10} lines` : "";
-                return {
-                    success: true,
-                    output: `Contents of ${filePath}:\n${numberedLines}${additionalLinesMessage}`,
-                };
-            }
-            else {
-                return {
-                    success: false,
-                    error: `File or directory not found: ${filePath}`,
-                };
-            }
-        }
-        catch (error) {
-            return {
-                success: false,
-                error: `Error viewing ${filePath}: ${error.message}`,
-            };
-        }
-    }
-    setApiKey(apiKey) {
-        this.morphApiKey = apiKey;
-    }
-    getApiKey() {
-        return this.morphApiKey;
-    }
-}
-//# sourceMappingURL=morph-editor.js.map

package/dist/tools/morph-editor.js.map

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

package/packages/schemas/dist/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * @ax-cli/schemas - Single Source of Truth Type System
- *
- * This package provides centralized Zod schemas, brand types, and enums
- * for the entire ax-cli ecosystem.
- *
- * SECURITY: All exports are controlled. Internal helpers are not exposed.
- *
- * @packageDocumentation
- */
-export { brand, unbrand, isBranded, createBrandFactory, type __brand, type Brand, type ExtractBrand, type ExtractBase, } from './public/core/brand-types.js';
-export { ApiResponseId, ToolCallId, ToolCallIdSchema, ModelId, ModelIdSchema, TenantId, ApiKeyId, MCPServerId, MCPServerIdSchema, UsageRecordId, PlanId, SessionId, RequestId, type ApiResponseId as ApiResponseIdType, type ToolCallId as ToolCallIdType, type ModelId as ModelIdType, type TenantId as TenantIdType, type ApiKeyId as ApiKeyIdType, type MCPServerId as MCPServerIdType, type UsageRecordId as UsageRecordIdType, type PlanId as PlanIdType, type SessionId as SessionIdType, type RequestId as RequestIdType, } from './public/core/id-types.js';
-export { MessageRoleEnum, FinishReasonEnum, TransportEnum, EditorCommandEnum, type MessageRole, type FinishReason, type Transport, type EditorCommand, } from './public/core/enums.js';
-//# sourceMappingURL=index.d.ts.map

package/packages/schemas/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,KAAK,EACL,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,KAAK,OAAO,EACZ,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,SAAS,EACT,SAAS,EACT,KAAK,aAAa,IAAI,iBAAiB,EACvC,KAAK,UAAU,IAAI,cAAc,EACjC,KAAK,OAAO,IAAI,WAAW,EAC3B,KAAK,QAAQ,IAAI,YAAY,EAC7B,KAAK,QAAQ,IAAI,YAAY,EAC7B,KAAK,WAAW,IAAI,eAAe,EACnC,KAAK,aAAa,IAAI,iBAAiB,EACvC,KAAK,MAAM,IAAI,UAAU,EACzB,KAAK,SAAS,IAAI,aAAa,EAC/B,KAAK,SAAS,IAAI,aAAa,GAChC,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC"}

package/packages/schemas/dist/index.js

@@ -1,19 +0,0 @@
-/**
- * @ax-cli/schemas - Single Source of Truth Type System
- *
- * This package provides centralized Zod schemas, brand types, and enums
- * for the entire ax-cli ecosystem.
- *
- * SECURITY: All exports are controlled. Internal helpers are not exposed.
- *
- * @packageDocumentation
- */
-// Core brand type utilities
-export { brand, unbrand, isBranded, createBrandFactory, } from './public/core/brand-types.js';
-// ID Brand Types
-export { ApiResponseId, ToolCallId, ToolCallIdSchema, ModelId, ModelIdSchema, TenantId, ApiKeyId, MCPServerId, MCPServerIdSchema, UsageRecordId, PlanId, SessionId, RequestId, } from './public/core/id-types.js';
-// Centralized Enums
-export { MessageRoleEnum, FinishReasonEnum, TransportEnum, EditorCommandEnum, } from './public/core/enums.js';
-// Additional exports will be added as we implement them:
-// - Domain schemas (Usage, API, MCP)
-//# sourceMappingURL=index.js.map

package/packages/schemas/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4BAA4B;AAC5B,OAAO,EACL,KAAK,EACL,OAAO,EACP,SAAS,EACT,kBAAkB,GAKnB,MAAM,8BAA8B,CAAC;AAEtC,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,MAAM,EACN,SAAS,EACT,SAAS,GAWV,MAAM,2BAA2B,CAAC;AAEnC,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAKlB,MAAM,wBAAwB,CAAC;AAEhC,yDAAyD;AACzD,qCAAqC"}

package/packages/schemas/dist/public/core/brand-types.d.ts

@@ -1,308 +0,0 @@
-/**
- * Brand Types Utilities for @ax-cli/schemas
- *
- * CRITICAL SECURITY WARNING:
- * =========================
- * Brand types are COMPILE-TIME ONLY markers. They provide ZERO runtime validation.
- *
- * **YOU MUST VALIDATE ALL INPUTS AT SYSTEM BOUNDARIES**
- *
- * Unsafe usage (WILL FAIL IN PRODUCTION):
- * ```typescript
- * const tenantId = userInput as TenantId; // ❌ NO RUNTIME VALIDATION!
- * ```
- *
- * Safe usage (REQUIRED):
- * ```typescript
- * const result = TenantId.parse(userInput); // ✅ Validates with Zod
- * if (result.success) {
- *   const tenantId = result.data; // Type-safe AND runtime-safe
- * }
- * ```
- *
- * WHEN TO USE BRAND TYPES:
- * - Preventing ID mixing at compile time (ApiKeyId vs TenantId)
- * - Enforcing domain boundaries in function signatures
- * - Type-level documentation of intent
- *
- * WHEN TO VALIDATE:
- * - API boundaries (HTTP requests, MCP inputs)
- * - File I/O (reading configs, user settings)
- * - Database queries (WHERE clauses with user IDs)
- * - Environment variables
- * - Command-line arguments
- *
- * PERFORMANCE:
- * Brand types have ZERO runtime cost. They are erased during compilation.
- *
- * @module brand-types
- * @see {@link https://github.com/microsoft/TypeScript/issues/4895|TypeScript Nominal Types}
- */
-/**
- * Unique symbol used as a phantom type marker for branding.
- * This symbol is exported for type compatibility but cannot be accessed at runtime,
- * making it impossible to forge branded types without using the
- * provided constructor functions.
- *
- * @internal
- */
-export declare const __brand: unique symbol;
-/**
- * Brand<T, B> creates a "nominal type" from a structural type.
- *
- * TypeScript uses structural typing by default:
- * ```typescript
- * type UserId = string;
- * type TenantId = string;
- *
- * const user: UserId = "user-123";
- * const tenant: TenantId = user; // ✅ No error! Strings are compatible.
- * ```
- *
- * Brand types enforce nominal typing:
- * ```typescript
- * type UserId = Brand<string, 'UserId'>;
- * type TenantId = Brand<string, 'TenantId'>;
- *
- * const user = brand<string, 'UserId'>("user-123");
- * const tenant: TenantId = user; // ❌ Compile error! Incompatible brands.
- * ```
- *
- * @template T - The base type (string, number, etc.)
- * @template B - The brand identifier (unique string literal)
- *
- * @example
- * ```typescript
- * type ApiKeyId = Brand<string, 'ApiKeyId'>;
- * type TenantId = Brand<string, 'TenantId'>;
- *
- * function updateUsage(apiKeyId: ApiKeyId, tenantId: TenantId) {
- *   // This function signature makes it impossible to swap arguments
- * }
- *
- * const apiKey = brand<string, 'ApiKeyId'>("ak_123");
- * const tenant = brand<string, 'TenantId'>("tn_456");
- *
- * updateUsage(apiKey, tenant);        // ✅ Correct
- * updateUsage(tenant, apiKey);        // ❌ Compile error!
- * updateUsage("ak_123", "tn_456");    // ❌ Compile error!
- * ```
- */
-export type Brand<T, B extends string> = T & {
-    readonly [__brand]: B;
-};
-/**
- * Creates a branded value.
- *
- * WARNING: This function performs NO VALIDATION. It is a type-level assertion only.
- *
- * Use this ONLY in trusted contexts after validation:
- * - Inside schema .transform() after Zod validation
- * - After database queries that return validated data
- * - In test fixtures with known-good values
- *
- * DO NOT use with user input directly:
- * ```typescript
- * // ❌ UNSAFE - No validation!
- * const userId = brand<string, 'UserId'>(req.body.userId);
- *
- * // ✅ SAFE - Validated first
- * const result = UserIdSchema.safeParse(req.body.userId);
- * if (result.success) {
- *   const userId = result.data; // Already branded by schema
- * }
- * ```
- *
- * @template T - The base type
- * @template B - The brand identifier
- * @param value - The value to brand
- * @returns The same value, but with a brand type
- *
- * @example
- * ```typescript
- * // Safe usage in tests
- * const mockTenantId = brand<string, 'TenantId'>("test-tenant-123");
- *
- * // Safe usage after validation
- * const schema = z.string().uuid().transform(v => brand<string, 'TenantId'>(v));
- * const tenantId = schema.parse(userInput); // Validated AND branded
- * ```
- */
-export declare function brand<T, B extends string>(value: T): Brand<T, B>;
-/**
- * Type guard to check if a value is already branded with a specific brand.
- *
- * NOTE: This only works if the value was created using the brand() function.
- * It CANNOT detect fake brands created with `as` casts.
- *
- * @template T - The base type
- * @template B - The brand identifier
- * @param value - The value to check
- * @returns true if the value has the correct brand (compile-time only)
- *
- * @example
- * ```typescript
- * const value: string | TenantId = getTenantId();
- *
- * if (isBranded<string, 'TenantId'>(value)) {
- *   const tenantId: TenantId = value; // TypeScript knows it's branded
- * }
- * ```
- */
-export declare function isBranded<T, B extends string>(_value: unknown): _value is Brand<T, B>;
-/**
- * Removes the brand from a branded type, returning the base type.
- *
- * Use this when you need to pass a branded value to a function that
- * expects the base type (e.g., logging, serialization).
- *
- * @template T - The base type
- * @template B - The brand identifier
- * @param value - The branded value
- * @returns The same value, but with the brand removed
- *
- * @example
- * ```typescript
- * const tenantId: TenantId = getTenantId();
- *
- * // Pass to function expecting plain string
- * console.log(unbrand(tenantId)); // string, not TenantId
- *
- * // Serialize to JSON
- * const json = JSON.stringify({ id: unbrand(tenantId) });
- * ```
- */
-export declare function unbrand<T, B extends string>(value: Brand<T, B>): T;
-/**
- * Utility type to extract the brand identifier from a branded type.
- *
- * @template T - The branded type
- *
- * @example
- * ```typescript
- * type TenantId = Brand<string, 'TenantId'>;
- * type BrandName = ExtractBrand<TenantId>; // 'TenantId'
- * ```
- */
-export type ExtractBrand<T> = T extends Brand<unknown, infer B> ? B : never;
-/**
- * Utility type to extract the base type from a branded type.
- *
- * @template T - The branded type
- *
- * @example
- * ```typescript
- * type TenantId = Brand<string, 'TenantId'>;
- * type BaseType = ExtractBase<TenantId>; // string
- * ```
- */
-export type ExtractBase<T> = T extends Brand<infer U, string> ? U : T;
-/**
- * Creates a type-safe brand factory with validation.
- *
- * This is the RECOMMENDED way to create brand types with runtime validation.
- *
- * @template T - The base type
- * @template B - The brand identifier
- * @param schema - Zod schema for validation
- * @param brandName - The brand identifier
- * @returns Object with parse, create, and is methods
- *
- * @example
- * ```typescript
- * import { z } from 'zod';
- *
- * const TenantId = createBrandFactory(
- *   z.string().uuid(),
- *   'TenantId'
- * );
- *
- * // Type-safe parsing with validation
- * const result = TenantId.parse(userInput);
- * if (result.success) {
- *   const tenantId = result.data; // Brand<string, 'TenantId'>
- * }
- *
- * // Create new ID
- * const newId = TenantId.create(); // Generates UUID
- *
- * // Type guard
- * if (TenantId.is(value)) {
- *   // value is Brand<string, 'TenantId'>
- * }
- * ```
- */
-export declare function createBrandFactory<T, B extends string>(schema: {
-    parse: (input: unknown) => T;
-    safeParse: (input: unknown) => {
-        success: boolean;
-        data?: T;
-        error?: unknown;
-    };
-}, brandName: B): {
-    /**
-     * The Zod schema with brand transformation.
-     */
-    schema: {
-        parse: (input: unknown) => Brand<T, B>;
-        safeParse: (input: unknown) => {
-            success: true;
-            data: Brand<T, B>;
-        } | {
-            success: false;
-            error: unknown;
-        };
-    };
-    /**
-     * Parse and validate input, returning branded value.
-     * Throws on validation failure.
-     */
-    parse: (input: unknown) => Brand<T, B>;
-    /**
-     * Type guard to check if a value is this brand.
-     */
-    is: (value: unknown) => value is Brand<T, B>;
-    /**
-     * Brand name identifier.
-     */
-    brandName: B;
-};
-/**
- * BEST PRACTICES SUMMARY:
- * =======================
- *
- * 1. ALWAYS validate at boundaries:
- *    - API inputs: Use Zod schemas
- *    - Database outputs: Use Zod schemas
- *    - File I/O: Use Zod schemas
- *    - CLI args: Use Zod schemas
- *
- * 2. NEVER cast to brand types:
- *    ❌ const id = userInput as TenantId;
- *    ✅ const id = TenantIdSchema.parse(userInput);
- *
- * 3. Use createBrandFactory for all brand types:
- *    - Provides validation
- *    - Provides type guards
- *    - Centralizes brand creation
- *
- * 4. Document which functions validate:
- *    ```typescript
- *    // @validates TenantId - performs Zod validation
- *    function parseTenantId(input: string): TenantId {
- *      return TenantIdSchema.parse(input);
- *    }
- *
- *    // @assumes TenantId - no validation, requires validated input
- *    function formatTenantId(id: TenantId): string {
- *      return `tenant:${unbrand(id)}`;
- *    }
- *    ```
- *
- * 5. Test brand type enforcement:
- *    ```typescript
- *    // Should fail to compile
- *    const apiKey: ApiKeyId = getTenantId(); // ❌
- *    ```
- */
-//# sourceMappingURL=brand-types.d.ts.map