@warlock.js/core 4.0.161 → 4.0.163

package/esm/validation/validators/file-validator.d.ts

@@ -0,0 +1,62 @@
+import type { FileSizeOption, JsonSchemaResult, JsonSchemaTarget } from "@warlock.js/seal";
+import { BaseValidator } from "@warlock.js/seal";
+export declare const uploadedFileMetadataSchema: any;
+/**
+ * File validator class
+ */
+export declare class FileValidator extends BaseValidator {
+    constructor(errorMessage?: string);
+    /**
+     * Check if value is a File type
+     */
+    matchesType(value: any): boolean;
+    /** Value must be an image */
+    image(errorMessage?: string): FileValidator;
+    /** Accept specific file extensions */
+    accept(extensions: string | string[], errorMessage?: string): FileValidator;
+    /** Allow specific MIME types */
+    mimeType(mimeTypes: string | string[], errorMessage?: string): FileValidator;
+    /** Allow only pdf files */
+    pdf(errorMessage?: string): FileValidator;
+    /** Allow only excel files */
+    excel(errorMessage?: string): FileValidator;
+    /** Allow only word files */
+    word(errorMessage?: string): FileValidator;
+    /** Minimum file size */
+    minSize(size: number | FileSizeOption, errorMessage?: string): FileValidator;
+    /** @alias minSize */
+    min(size: number | FileSizeOption, errorMessage?: string): FileValidator;
+    /** Maximum file size */
+    maxSize(size: number | FileSizeOption, errorMessage?: string): FileValidator;
+    /** @alias maxSize */
+    max(size: number, errorMessage?: string): FileValidator;
+    /** Minimum image width */
+    minWidth(width: number, errorMessage?: string): FileValidator;
+    /** Maximum image width */
+    maxWidth(width: number, errorMessage?: string): FileValidator;
+    /** Minimum image height */
+    minHeight(height: number, errorMessage?: string): FileValidator;
+    /** Maximum image height */
+    maxHeight(height: number, errorMessage?: string): FileValidator;
+    /**
+     * Save the file and return it as a string
+     */
+    saveTo(relativeDirectory: string): FileValidator;
+    /**
+     * @inheritdoc
+     *
+     * File uploads are not natively representable in JSON Schema.
+     * The output varies by target:
+     * - `openapi-3.0`   → `{ type: "string", format: "binary" }` (standard for multipart/form-data uploads)
+     * - `draft-2020-12` → `{ type: "string", contentEncoding: "binary" }`
+     * - `draft-07`      → `{}` (no standard binary representation — permissive fallback)
+     *
+     * @example
+     * ```ts
+     * v.file().toJsonSchema("openapi-3.0")
+     * // → { type: "string", format: "binary" }
+     * ```
+     */
+    toJsonSchema(target?: JsonSchemaTarget): JsonSchemaResult;
+}
+//# sourceMappingURL=file-validator.d.ts.map

package/esm/validation/validators/file-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/file-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EACL,aAAa,EASd,MAAM,kBAAkB,CAAC;AAI1B,eAAO,MAAM,0BAA0B,KAQrC,CAAC;AAEH;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAC3B,YAAY,CAAC,EAAE,MAAM;IAKxC;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIvC,6BAA6B;IACtB,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAIlD,sCAAsC;IAC/B,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMlF,gCAAgC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMnF,2BAA2B;IACpB,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAIhD,6BAA6B;IACtB,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAUlD,4BAA4B;IACrB,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAUjD,wBAAwB;IACjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMnF,qBAAqB;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAI/E,wBAAwB;IACjB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMnF,qBAAqB;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAI9D,0BAA0B;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMpE,0BAA0B;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMpE,2BAA2B;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMtE,2BAA2B;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa;IAMtE;;OAEG;IACI,MAAM,CAAC,iBAAiB,EAAE,MAAM,GAAG,aAAa;IAQvD;;;;;;;;;;;;;;OAcG;IACa,YAAY,CAAC,MAAM,GAAE,gBAAkC,GAAG,gBAAgB;CAY3F"}

package/esm/validation/validators/file-validator.js

@@ -0,0 +1,136 @@
+import {v,BaseValidator,minFileSizeRule,resolveFileSize,maxFileSizeRule,minWidthRule,maxWidthRule,minHeightRule,maxHeightRule}from'@warlock.js/seal';import'@mongez/config';import'@mongez/reinforcements';import'@warlock.js/logger';import'../../router/router.js';import'@fastify/multipart';import'../../database/models/database-log/database-log.js';import'../../http/context/request-context.js';import'path';import'@mongez/slug';import'@mongez/supportive-is';import'fastify';import'../../http/database/RequestLog.js';import {UploadedFile}from'../../http/uploaded-file.js';import'../../config/config-handlers.js';import'@warlock.js/cache';import'@mongez/localization';import'@warlock.js/cascade';import'@warlock.js/context';import'@mongez/copper';import'@mongez/events';import'../../http/response.js';import {fileRule,imageRule,fileExtensionRule,fileTypeRule}from'../file/file.js';const uploadedFileMetadataSchema = v.object({
+    location: v.string().oneOf(["local", "cloud"]),
+    width: v.int().positive(),
+    height: v.int().positive(),
+    size: v.int().positive(),
+    mimeType: v.string(),
+    extension: v.string(),
+    name: v.string(),
+});
+/**
+ * File validator class
+ */
+class FileValidator extends BaseValidator {
+    constructor(errorMessage) {
+        super();
+        this.addMutableRule(fileRule, errorMessage);
+    }
+    /**
+     * Check if value is a File type
+     */
+    matchesType(value) {
+        return value instanceof UploadedFile;
+    }
+    /** Value must be an image */
+    image(errorMessage) {
+        return this.addRule(imageRule, errorMessage);
+    }
+    /** Accept specific file extensions */
+    accept(extensions, errorMessage) {
+        return this.addRule(fileExtensionRule, errorMessage, {
+            extensions,
+        });
+    }
+    /** Allow specific MIME types */
+    mimeType(mimeTypes, errorMessage) {
+        return this.addRule(fileTypeRule, errorMessage, {
+            mimeTypes,
+        });
+    }
+    /** Allow only pdf files */
+    pdf(errorMessage) {
+        return this.mimeType("application/pdf", errorMessage);
+    }
+    /** Allow only excel files */
+    excel(errorMessage) {
+        return this.mimeType([
+            "application/vnd.ms-excel",
+            "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        ], errorMessage);
+    }
+    /** Allow only word files */
+    word(errorMessage) {
+        return this.mimeType([
+            "application/msword",
+            "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        ], errorMessage);
+    }
+    /** Minimum file size */
+    minSize(size, errorMessage) {
+        return this.addRule(minFileSizeRule, errorMessage, {
+            minSize: resolveFileSize(size),
+        });
+    }
+    /** @alias minSize */
+    min(size, errorMessage) {
+        return this.minSize(size, errorMessage);
+    }
+    /** Maximum file size */
+    maxSize(size, errorMessage) {
+        return this.addRule(maxFileSizeRule, errorMessage, {
+            maxSize: resolveFileSize(size),
+        });
+    }
+    /** @alias maxSize */
+    max(size, errorMessage) {
+        return this.maxSize(size, errorMessage);
+    }
+    /** Minimum image width */
+    minWidth(width, errorMessage) {
+        return this.addRule(minWidthRule, errorMessage, {
+            minWidth: width,
+        });
+    }
+    /** Maximum image width */
+    maxWidth(width, errorMessage) {
+        return this.addRule(maxWidthRule, errorMessage, {
+            maxWidth: width,
+        });
+    }
+    /** Minimum image height */
+    minHeight(height, errorMessage) {
+        return this.addRule(minHeightRule, errorMessage, {
+            minHeight: height,
+        });
+    }
+    /** Maximum image height */
+    maxHeight(height, errorMessage) {
+        return this.addRule(maxHeightRule, errorMessage, {
+            maxHeight: height,
+        });
+    }
+    /**
+     * Save the file and return it as a string
+     */
+    saveTo(relativeDirectory) {
+        return this.addTransformer(async (file) => {
+            const output = await file.save(relativeDirectory);
+            return output.path;
+        });
+    }
+    /**
+     * @inheritdoc
+     *
+     * File uploads are not natively representable in JSON Schema.
+     * The output varies by target:
+     * - `openapi-3.0`   → `{ type: "string", format: "binary" }` (standard for multipart/form-data uploads)
+     * - `draft-2020-12` → `{ type: "string", contentEncoding: "binary" }`
+     * - `draft-07`      → `{}` (no standard binary representation — permissive fallback)
+     *
+     * @example
+     * ```ts
+     * v.file().toJsonSchema("openapi-3.0")
+     * // → { type: "string", format: "binary" }
+     * ```
+     */
+    toJsonSchema(target = "draft-2020-12") {
+        if (target === "openapi-3.0") {
+            return { type: "string", format: "binary" };
+        }
+        if (target === "draft-2020-12") {
+            return { type: "string", contentEncoding: "binary" };
+        }
+        // draft-07: no standard binary representation
+        return {};
+    }
+}export{FileValidator,uploadedFileMetadataSchema};//# sourceMappingURL=file-validator.js.map

package/esm/validation/validators/file-validator.js.map

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

package/esm/validation/validators/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Framework-Specific Validators
+ *
+ * These validators require framework-specific functionality
+ */
+export * from "./file-validator";
+//# sourceMappingURL=index.d.ts.map

package/esm/validation/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC"}

package/esm/warlock-config/default-configurations.d.ts

@@ -0,0 +1,3 @@
+import { WarlockConfig } from "./types";
+export declare const defaultWarlockConfigurations: WarlockConfig;
+//# sourceMappingURL=default-configurations.d.ts.map

package/esm/warlock-config/default-configurations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-configurations.d.ts","sourceRoot":"","sources":["../../src/warlock-config/default-configurations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,eAAO,MAAM,4BAA4B,EAAE,aAO1C,CAAC"}

package/esm/warlock-config/default-configurations.js

@@ -0,0 +1,8 @@
+const defaultWarlockConfigurations = {
+    build: {
+        outDirectory: process.cwd() + "/dist",
+        outFile: "app.js",
+        sourcemap: true,
+        minify: true,
+    },
+};export{defaultWarlockConfigurations};//# sourceMappingURL=default-configurations.js.map

package/esm/warlock-config/default-configurations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-configurations.js","sources":["../../src/warlock-config/default-configurations.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEa,MAAA,4BAA4B,GAAkB;AACzD,IAAA,KAAK,EAAE;AACL,QAAA,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO;AACrC,QAAA,OAAO,EAAE,QAAQ;AACjB,QAAA,SAAS,EAAE,IAAI;AACf,QAAA,MAAM,EAAE,IAAI;AACb,KAAA;"}

package/esm/warlock-config/define-config.d.ts

@@ -0,0 +1,3 @@
+import type { WarlockConfig } from "./types";
+export declare function defineConfig(options: WarlockConfig): any;
+//# sourceMappingURL=define-config.d.ts.map

package/esm/warlock-config/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/warlock-config/define-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,OAElD"}

package/esm/warlock-config/define-config.js

@@ -0,0 +1,3 @@
+import {merge}from'@mongez/reinforcements';import {defaultWarlockConfigurations}from'./default-configurations.js';function defineConfig(options) {
+    return merge(defaultWarlockConfigurations, options);
+}export{defineConfig};//# sourceMappingURL=define-config.js.map

package/esm/warlock-config/define-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.js","sources":["../../src/warlock-config/define-config.ts"],"sourcesContent":[null],"names":[],"mappings":"kHAIM,SAAU,YAAY,CAAC,OAAsB,EAAA;AACjD,IAAA,OAAO,KAAK,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;AACtD"}

package/esm/warlock-config/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./define-config";
+export * from "./types";
+export * from "./warlock-config.manager";
+//# sourceMappingURL=index.d.ts.map

package/esm/warlock-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/warlock-config/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,0BAA0B,CAAC"}

package/esm/warlock-config/types.d.ts

@@ -0,0 +1,129 @@
+import type { MigrationConstructor } from "@warlock.js/cascade";
+import type { CLICommand } from "../cli/cli-command";
+import type { FileHealthCheckerContract } from "../dev-server/health-checker/file-health-checker.contract";
+/**
+ * Resolved Warlock Configuration
+ *
+ * This is the final configuration after merging user config with defaults
+ */
+export type WarlockConfig = {
+    /**
+     * Server configuration
+     */
+    server?: {
+        port?: number;
+        host?: string;
+        retryOtherPort?: boolean;
+    };
+    /**
+     * Build configuration
+     */
+    build?: {
+        /**
+         * Output directory
+         *
+         * @default dist
+         */
+        outDirectory?: string;
+        /**
+         * Output file
+         *
+         * @default app.js
+         */
+        outFile?: string;
+        /**
+         * Minify output
+         *
+         * @default true
+         */
+        minify?: boolean;
+        /**
+         * Generate sourcemap
+         *
+         * @default true
+         */
+        sourcemap?: boolean | "inline" | "linked";
+    };
+    /**
+     * CLI configuration
+     */
+    cli?: {
+        commands?: CLICommand[];
+    };
+    /**
+     * Development server configuration
+     */
+    devServer?: {
+        /**
+         * Watch configuration
+         */
+        watch?: {
+            /**
+             * Glob patterns to include in file watching
+             *
+             * @default ["**\/*.{ts,tsx}"]
+             */
+            include?: string[];
+            /**
+             * Glob patterns to exclude from file watching
+             *
+             * @default ["**\/node_modules\/**", "**\/dist\/**", "**\/.warlock\/**", "**\/.git\/**"]
+             */
+            exclude?: string[];
+        };
+        /**
+         * Custom health checkers
+         */
+        healthCheckers?: FileHealthCheckerContract[] | false;
+        /**
+         * Whether to generate typings on dev server start
+         * @default true
+         */
+        generateTypings?: boolean;
+    };
+    /**
+     * Database configuration
+     */
+    database?: {
+        /**
+         * Package-level migrations to include in migration runs.
+         *
+         * Use this to register migrations from external packages
+         * (e.g., @warlock.js/auth) that are not auto-discovered.
+         *
+         * @example
+         * ```typescript
+         * import { authMigrations } from "@warlock.js/auth";
+         *
+         * export default defineConfig({
+         *   database: {
+         *     migrations: [...authMigrations],
+         *   },
+         * });
+         * ```
+         */
+        migrations?: Array<MigrationConstructor>;
+    };
+    /**
+     * Testing configuration
+     *
+     * High-level test settings. For detailed test behavior,
+     * use config/tests.ts instead.
+     */
+    testing?: {
+        /**
+         * Additional glob patterns to include as test files.
+         * Added to the default patterns.
+         *
+         * @example ["src/shared/[ALL]/*.test.ts"]
+         */
+        include?: string[];
+        /**
+         * Glob patterns to exclude from test discovery.
+         *
+         * @example [[ALL]/*.integration.test.ts"]
+         */
+        exclude?: string[];
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/esm/warlock-config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/warlock-config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAE3G;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,EAAE;QACN;;;;WAIG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB;;;;WAIG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;WAIG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB;;;;WAIG;QACH,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;KAC3C,CAAC;IAEF;;OAEG;IACH,GAAG,CAAC,EAAE;QACJ,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;KACzB,CAAC;IAEF;;OAEG;IACH,SAAS,CAAC,EAAE;QACV;;WAEG;QACH,KAAK,CAAC,EAAE;YACN;;;;eAIG;YACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YACnB;;;;eAIG;YACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC;QACF;;WAEG;QACH,cAAc,CAAC,EAAE,yBAAyB,EAAE,GAAG,KAAK,CAAC;QACrD;;;WAGG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IAEF;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT;;;;;;;;;;;;;;;;WAgBG;QACH,UAAU,CAAC,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;KAC1C,CAAC;IAEF;;;;;OAKG;IACH,OAAO,CAAC,EAAE;QACR;;;;;WAKG;QACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAEnB;;;;WAIG;QACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH,CAAC"}

package/esm/warlock-config/warlock-config.manager.d.ts

@@ -0,0 +1,83 @@
+import { WarlockConfig } from "./types";
+/**
+ * Warlock Config Manager
+ *
+ * Manages lazy loading of the pre-compiled warlock.config.js file
+ * from the .warlock/cache directory.
+ */
+export declare class WarlockConfigManager {
+    /**
+     * Cached config instance
+     */
+    private config?;
+    /**
+     * Loading promise to prevent duplicate loads
+     */
+    private loading?;
+    /**
+     * Load warlock.config.js (cached after first load)
+     *
+     * @returns The resolved Warlock configuration
+     */
+    load(): Promise<WarlockConfig | undefined>;
+    /**
+     * Internal load implementation
+     */
+    private doLoad;
+    /**
+     * Compile warlock.config.ts file
+     */
+    protected compile(): Promise<boolean>;
+    /**
+     * Get config value by key (dot notation supported)
+     *
+     * @example
+     * config.get("server.port") // Returns 3000
+     * config.get("cli.commands") // Returns array of commands
+     *
+     * @param key - Config key (supports dot notation), autocompletes for first level only
+     * @returns The config value
+     * @throws Error if config is not loaded
+     */
+    get<Key extends keyof WarlockConfig>(key: Key, defaultValue?: WarlockConfig[Key]): WarlockConfig[Key];
+    /**
+     * Lazy get - loads config if not already loaded
+     *
+     * @example
+     * const port = await config.lazyGet("server");
+     *
+     * @param key - Config key (supports dot notation), autocompletes for first level only
+     * @param defaultValue - Default value if config key is undefined
+     * @returns The config value
+     */
+    lazyGet<Key extends keyof WarlockConfig>(key: Key, defaultValue?: WarlockConfig[Key]): Promise<WarlockConfig[Key]>;
+    /**
+     * Check if config is loaded
+     */
+    get isLoaded(): boolean;
+    /**
+     * Get the entire config object
+     *
+     * @throws Error if config is not loaded
+     */
+    getAll(): WarlockConfig;
+    /**
+     * Reload config (useful for HMR/development)
+     */
+    reload(): Promise<void>;
+}
+/**
+ * Exported singleton instance
+ *
+ * @example
+ * import { warlockConfig } from "@warlock.js/core";
+ *
+ * // Lazy load and get value
+ * const port = await warlockConfig.lazyGet("server.port");
+ *
+ * // Or load first, then get
+ * await warlockConfig.load();
+ * const commands = warlockConfig.get("cli.commands");
+ */
+export declare const warlockConfigManager: WarlockConfigManager;
+//# sourceMappingURL=warlock-config.manager.d.ts.map

package/esm/warlock-config/warlock-config.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warlock-config.manager.d.ts","sourceRoot":"","sources":["../../src/warlock-config/warlock-config.manager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,CAAgB;IAE/B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAC,CAAqC;IAErD;;;;OAIG;IACU,IAAI,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAmBvD;;OAEG;YACW,MAAM;IA2BpB;;OAEG;cACa,OAAO;IAYvB;;;;;;;;;;OAUG;IACI,GAAG,CAAC,GAAG,SAAS,MAAM,aAAa,EACxC,GAAG,EAAE,GAAG,EACR,YAAY,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,GAChC,aAAa,CAAC,GAAG,CAAC;IAQrB;;;;;;;;;OASG;IACG,OAAO,CAAC,GAAG,SAAS,MAAM,aAAa,EAC3C,GAAG,EAAE,GAAG,EACR,YAAY,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,GAChC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAK9B;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;;;OAIG;IACI,MAAM,IAAI,aAAa;IAQ9B;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAKrC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/esm/warlock-config/warlock-config.manager.js

@@ -0,0 +1,141 @@
+import {fileExistsAsync,getFileAsync,putFileAsync}from'@mongez/fs';import {get}from'@mongez/reinforcements';import {pathToFileURL}from'url';import {devLogWarn}from'../dev-server/dev-logger.js';import'@warlock.js/logger';import'../database/models/database-log/database-log.js';import'../http/context/request-context.js';import {warlockPath,rootPath}from'../utils/paths.js';import'@mongez/slug';import'@mongez/supportive-is';import {transpile}from'../dev-server/transpile-file.js';/**
+ * Warlock Config Manager
+ *
+ * Manages lazy loading of the pre-compiled warlock.config.js file
+ * from the .warlock/cache directory.
+ */
+class WarlockConfigManager {
+    /**
+     * Cached config instance
+     */
+    config;
+    /**
+     * Loading promise to prevent duplicate loads
+     */
+    loading;
+    /**
+     * Load warlock.config.js (cached after first load)
+     *
+     * @returns The resolved Warlock configuration
+     */
+    async load() {
+        // Already loaded
+        if (this.config) {
+            return this.config;
+        }
+        // Currently loading (prevent duplicate loads)
+        if (this.loading) {
+            return this.loading;
+        }
+        // Start loading
+        this.loading = this.doLoad();
+        this.config = await this.loading;
+        this.loading = undefined;
+        return this.config;
+    }
+    /**
+     * Internal load implementation
+     */
+    async doLoad() {
+        const configPath = warlockPath("cache/warlock-config.js");
+        // if (!(await fileExistsAsync(configPath))) {
+        const result = await this.compile();
+        if (!result) {
+            devLogWarn("warlock.config.ts is missing, it's highly recommended to create it, run warlock init to create it");
+            return;
+        }
+        // }
+        const fileUrl = pathToFileURL(configPath).href;
+        try {
+            const configModule = await import(fileUrl);
+            return configModule.default;
+        }
+        catch (error) {
+            throw new Error(`Failed to load warlock.config.js from ${fileUrl}. ` +
+                `Make sure the config has been compiled. Error: ${error}`);
+        }
+    }
+    /**
+     * Compile warlock.config.ts file
+     */
+    async compile() {
+        const configPath = rootPath("warlock.config.ts");
+        if (!(await fileExistsAsync(configPath))) {
+            return false;
+        }
+        const content = await getFileAsync(configPath);
+        const compiledContent = await transpile(content, configPath);
+        await putFileAsync(warlockPath("cache/warlock-config.js"), compiledContent);
+        return true;
+    }
+    /**
+     * Get config value by key (dot notation supported)
+     *
+     * @example
+     * config.get("server.port") // Returns 3000
+     * config.get("cli.commands") // Returns array of commands
+     *
+     * @param key - Config key (supports dot notation), autocompletes for first level only
+     * @returns The config value
+     * @throws Error if config is not loaded
+     */
+    get(key, defaultValue) {
+        if (!this.config) {
+            throw new Error("WarlockConfig not loaded. Call load() first or use lazyGet().");
+        }
+        return get(this.config, key, defaultValue);
+    }
+    /**
+     * Lazy get - loads config if not already loaded
+     *
+     * @example
+     * const port = await config.lazyGet("server");
+     *
+     * @param key - Config key (supports dot notation), autocompletes for first level only
+     * @param defaultValue - Default value if config key is undefined
+     * @returns The config value
+     */
+    async lazyGet(key, defaultValue) {
+        await this.load();
+        return this.get(key, defaultValue);
+    }
+    /**
+     * Check if config is loaded
+     */
+    get isLoaded() {
+        return this.config !== undefined;
+    }
+    /**
+     * Get the entire config object
+     *
+     * @throws Error if config is not loaded
+     */
+    getAll() {
+        if (!this.config) {
+            throw new Error("WarlockConfig not loaded. Call load() first or use lazyGet().");
+        }
+        return this.config;
+    }
+    /**
+     * Reload config (useful for HMR/development)
+     */
+    async reload() {
+        this.config = undefined;
+        this.loading = undefined;
+        await this.load();
+    }
+}
+/**
+ * Exported singleton instance
+ *
+ * @example
+ * import { warlockConfig } from "@warlock.js/core";
+ *
+ * // Lazy load and get value
+ * const port = await warlockConfig.lazyGet("server.port");
+ *
+ * // Or load first, then get
+ * await warlockConfig.load();
+ * const commands = warlockConfig.get("cli.commands");
+ */
+const warlockConfigManager = new WarlockConfigManager();export{WarlockConfigManager,warlockConfigManager};//# sourceMappingURL=warlock-config.manager.js.map

package/esm/warlock-config/warlock-config.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warlock-config.manager.js","sources":["../../src/warlock-config/warlock-config.manager.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}