@theunwalked/cardigantime 0.0.1 → 0.0.3

package/dist/util/storage.cjs

@@ -1,149 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-const fs = require('fs');
-const glob = require('glob');
-const path = require('path');
-const crypto = require('crypto');
-
-function _interopNamespaceDefault(e) {
-    const n = Object.create(null, { [Symbol.toStringTag]: { value: 'Module' } });
-    if (e) {
-        for (const k in e) {
-            if (k !== 'default') {
-                const d = Object.getOwnPropertyDescriptor(e, k);
-                Object.defineProperty(n, k, d.get ? d : {
-                    enumerable: true,
-                    get: () => e[k]
-                });
-            }
-        }
-    }
-    n.default = e;
-    return Object.freeze(n);
-}
-
-const fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
-
-// eslint-disable-next-line no-restricted-imports
-const create = (params)=>{
-    // eslint-disable-next-line no-console
-    const log = params.log || console.log;
-    const exists = async (path)=>{
-        try {
-            await fs__namespace.promises.stat(path);
-            return true;
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        } catch (error) {
-            return false;
-        }
-    };
-    const isDirectory = async (path)=>{
-        const stats = await fs__namespace.promises.stat(path);
-        if (!stats.isDirectory()) {
-            log(`${path} is not a directory`);
-            return false;
-        }
-        return true;
-    };
-    const isFile = async (path)=>{
-        const stats = await fs__namespace.promises.stat(path);
-        if (!stats.isFile()) {
-            log(`${path} is not a file`);
-            return false;
-        }
-        return true;
-    };
-    const isReadable = async (path)=>{
-        try {
-            await fs__namespace.promises.access(path, fs__namespace.constants.R_OK);
-        } catch (error) {
-            log(`${path} is not readable: %s %s`, error.message, error.stack);
-            return false;
-        }
-        return true;
-    };
-    const isWritable = async (path)=>{
-        try {
-            await fs__namespace.promises.access(path, fs__namespace.constants.W_OK);
-        } catch (error) {
-            log(`${path} is not writable: %s %s`, error.message, error.stack);
-            return false;
-        }
-        return true;
-    };
-    const isFileReadable = async (path)=>{
-        return await exists(path) && await isFile(path) && await isReadable(path);
-    };
-    const isDirectoryWritable = async (path)=>{
-        return await exists(path) && await isDirectory(path) && await isWritable(path);
-    };
-    const isDirectoryReadable = async (path)=>{
-        return await exists(path) && await isDirectory(path) && await isReadable(path);
-    };
-    const createDirectory = async (path)=>{
-        try {
-            await fs__namespace.promises.mkdir(path, {
-                recursive: true
-            });
-        } catch (mkdirError) {
-            throw new Error(`Failed to create output directory ${path}: ${mkdirError.message} ${mkdirError.stack}`);
-        }
-    };
-    const readFile = async (path, encoding)=>{
-        return await fs__namespace.promises.readFile(path, {
-            encoding: encoding
-        });
-    };
-    const writeFile = async (path, data, encoding)=>{
-        await fs__namespace.promises.writeFile(path, data, {
-            encoding: encoding
-        });
-    };
-    const forEachFileIn = async (directory, callback, options = {
-        pattern: '*.*'
-    })=>{
-        try {
-            const files = await glob.glob(options.pattern, {
-                cwd: directory,
-                nodir: true
-            });
-            for (const file of files){
-                await callback(path.join(directory, file));
-            }
-        } catch (err) {
-            throw new Error(`Failed to glob pattern ${options.pattern} in ${directory}: ${err.message}`);
-        }
-    };
-    const readStream = async (path)=>{
-        return fs__namespace.createReadStream(path);
-    };
-    const hashFile = async (path, length)=>{
-        const file = await readFile(path, 'utf8');
-        return crypto.createHash('sha256').update(file).digest('hex').slice(0, length);
-    };
-    const listFiles = async (directory)=>{
-        return await fs__namespace.promises.readdir(directory);
-    };
-    return {
-        exists,
-        isDirectory,
-        isFile,
-        isReadable,
-        isWritable,
-        isFileReadable,
-        isDirectoryWritable,
-        isDirectoryReadable,
-        createDirectory,
-        readFile,
-        readStream,
-        writeFile,
-        forEachFileIn,
-        hashFile,
-        listFiles
-    };
-};
-
-exports.create = create;
-//# sourceMappingURL=storage.cjs.map

package/dist/util/storage.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.cjs","sources":["../../src/util/storage.ts"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport * as fs from 'fs';\nimport { glob } from 'glob';\nimport path from 'path';\nimport crypto from 'crypto';\n/**\n * This module exists to isolate filesystem operations from the rest of the codebase.\n * This makes testing easier by avoiding direct fs mocking in jest configuration.\n * \n * Additionally, abstracting storage operations allows for future flexibility - \n * this export utility may need to work with storage systems other than the local filesystem\n * (e.g. S3, Google Cloud Storage, etc).\n */\n\nexport interface Utility {\n    exists: (path: string) => Promise<boolean>;\n    isDirectory: (path: string) => Promise<boolean>;\n    isFile: (path: string) => Promise<boolean>;\n    isReadable: (path: string) => Promise<boolean>;\n    isWritable: (path: string) => Promise<boolean>;\n    isFileReadable: (path: string) => Promise<boolean>;\n    isDirectoryWritable: (path: string) => Promise<boolean>;\n    isDirectoryReadable: (path: string) => Promise<boolean>;\n    createDirectory: (path: string) => Promise<void>;\n    readFile: (path: string, encoding: string) => Promise<string>;\n    readStream: (path: string) => Promise<fs.ReadStream>;\n    writeFile: (path: string, data: string | Buffer, encoding: string) => Promise<void>;\n    forEachFileIn: (directory: string, callback: (path: string) => Promise<void>, options?: { pattern: string }) => Promise<void>;\n    hashFile: (path: string, length: number) => Promise<string>;\n    listFiles: (directory: string) => Promise<string[]>;\n}\n\nexport const create = (params: { log?: (message: string, ...args: any[]) => void }): Utility => {\n\n    // eslint-disable-next-line no-console\n    const log = params.log || console.log;\n\n    const exists = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.stat(path);\n            return true;\n            // eslint-disable-next-line @typescript-eslint/no-unused-vars\n        } catch (error: any) {\n            return false;\n        }\n    }\n\n    const isDirectory = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isDirectory()) {\n            log(`${path} is not a directory`);\n            return false;\n        }\n        return true;\n    }\n\n    const isFile = async (path: string): Promise<boolean> => {\n        const stats = await fs.promises.stat(path);\n        if (!stats.isFile()) {\n            log(`${path} is not a file`);\n            return false;\n        }\n        return true;\n    }\n\n    const isReadable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.R_OK);\n        } catch (error: any) {\n            log(`${path} is not readable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isWritable = async (path: string): Promise<boolean> => {\n        try {\n            await fs.promises.access(path, fs.constants.W_OK);\n        } catch (error: any) {\n            log(`${path} is not writable: %s %s`, error.message, error.stack);\n            return false;\n        }\n        return true;\n    }\n\n    const isFileReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isFile(path) && await isReadable(path);\n    }\n\n    const isDirectoryWritable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isWritable(path);\n    }\n\n    const isDirectoryReadable = async (path: string): Promise<boolean> => {\n        return await exists(path) && await isDirectory(path) && await isReadable(path);\n    }\n\n    const createDirectory = async (path: string): Promise<void> => {\n        try {\n            await fs.promises.mkdir(path, { recursive: true });\n        } catch (mkdirError: any) {\n            throw new Error(`Failed to create output directory ${path}: ${mkdirError.message} ${mkdirError.stack}`);\n        }\n    }\n\n    const readFile = async (path: string, encoding: string): Promise<string> => {\n        return await fs.promises.readFile(path, { encoding: encoding as BufferEncoding });\n    }\n\n    const writeFile = async (path: string, data: string | Buffer, encoding: string): Promise<void> => {\n        await fs.promises.writeFile(path, data, { encoding: encoding as BufferEncoding });\n    }\n\n    const forEachFileIn = async (directory: string, callback: (file: string) => Promise<void>, options: { pattern: string | string[] } = { pattern: '*.*' }): Promise<void> => {\n        try {\n            const files = await glob(options.pattern, { cwd: directory, nodir: true });\n            for (const file of files) {\n                await callback(path.join(directory, file));\n            }\n        } catch (err: any) {\n            throw new Error(`Failed to glob pattern ${options.pattern} in ${directory}: ${err.message}`);\n        }\n    }\n\n    const readStream = async (path: string): Promise<fs.ReadStream> => {\n        return fs.createReadStream(path);\n    }\n\n    const hashFile = async (path: string, length: number): Promise<string> => {\n        const file = await readFile(path, 'utf8');\n        return crypto.createHash('sha256').update(file).digest('hex').slice(0, length);\n    }\n\n    const listFiles = async (directory: string): Promise<string[]> => {\n        return await fs.promises.readdir(directory);\n    }\n\n    return {\n        exists,\n        isDirectory,\n        isFile,\n        isReadable,\n        isWritable,\n        isFileReadable,\n        isDirectoryWritable,\n        isDirectoryReadable,\n        createDirectory,\n        readFile,\n        readStream,\n        writeFile,\n        forEachFileIn,\n        hashFile,\n        listFiles,\n    };\n}"],"names":["create","params","log","console","exists","path","fs","promises","stat","error","isDirectory","stats","isFile","isReadable","access","constants","R_OK","message","stack","isWritable","W_OK","isFileReadable","isDirectoryWritable","isDirectoryReadable","createDirectory","mkdir","recursive","mkdirError","Error","readFile","encoding","writeFile","data","forEachFileIn","directory","callback","options","pattern","files","glob","cwd","nodir","file","join","err","readStream","createReadStream","hashFile","length","crypto","createHash","update","digest","slice","listFiles","readdir"],"mappings":"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"}

package/dist/validate.cjs

@@ -1,130 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-const zod = require('zod');
-const types = require('./types.cjs');
-const storage = require('./util/storage.cjs');
-
-const listZodKeys = (schema, prefix = '')=>{
-    // Check if schema has unwrap method (which both ZodOptional and ZodNullable have)
-    if (schema._def && (schema._def.typeName === 'ZodOptional' || schema._def.typeName === 'ZodNullable')) {
-        // Use type assertion to handle the unwrap method
-        const unwrappable = schema;
-        return listZodKeys(unwrappable.unwrap(), prefix);
-    }
-    if (schema._def && schema._def.typeName === 'ZodArray') {
-        // Use type assertion to handle the element property
-        const arraySchema = schema;
-        return listZodKeys(arraySchema.element, prefix);
-    }
-    if (schema._def && schema._def.typeName === 'ZodObject') {
-        // Use type assertion to handle the shape property
-        const objectSchema = schema;
-        return Object.entries(objectSchema.shape).flatMap(([key, subschema])=>{
-            const fullKey = prefix ? `${prefix}.${key}` : key;
-            const nested = listZodKeys(subschema, fullKey);
-            return nested.length ? nested : fullKey;
-        });
-    }
-    return [];
-};
-const isPlainObject = (value)=>{
-    // Check if it's an object, not null, and not an array.
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-};
-/**
- * Generates a list of all keys within a JavaScript object, using dot notation for nested keys.
- * Mimics the behavior of listZodKeys but operates on plain objects.
- * For arrays, it inspects the first element that is a plain object to determine nested keys.
- * If an array contains no plain objects, or is empty, the key for the array itself is listed.
- *
- * @param obj The object to introspect.
- * @param prefix Internal use for recursion: the prefix for the current nesting level.
- * @returns An array of strings representing all keys in dot notation.
- */ const listObjectKeys = (obj, prefix = '')=>{
-    const keys = new Set(); // Use Set to automatically handle duplicates from array recursion
-    for(const key in obj){
-        // Ensure it's an own property, not from the prototype chain
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-            const value = obj[key];
-            const fullKey = prefix ? `${prefix}.${key}` : key;
-            if (Array.isArray(value)) {
-                // Find the first element that is a plain object to determine structure
-                const firstObjectElement = value.find(isPlainObject);
-                if (firstObjectElement) {
-                    // Recurse into the structure of the first object element found
-                    const nestedKeys = listObjectKeys(firstObjectElement, fullKey);
-                    nestedKeys.forEach((k)=>keys.add(k));
-                } else {
-                    // Array is empty or contains no plain objects, list the array key itself
-                    keys.add(fullKey);
-                }
-            } else if (isPlainObject(value)) {
-                // Recurse into nested plain objects
-                const nestedKeys = listObjectKeys(value, fullKey);
-                nestedKeys.forEach((k)=>keys.add(k));
-            } else {
-                // It's a primitive, null, or other non-plain object/array type
-                keys.add(fullKey);
-            }
-        }
-    }
-    return Array.from(keys); // Convert Set back to Array
-};
-const checkForExtraKeys = (mergedSources, fullSchema, logger)=>{
-    const allowedKeys = new Set(listZodKeys(fullSchema));
-    const actualKeys = listObjectKeys(mergedSources);
-    const extraKeys = actualKeys.filter((key)=>!allowedKeys.has(key));
-    if (extraKeys.length > 0) {
-        const allowedKeysString = Array.from(allowedKeys).join(', ');
-        const extraKeysString = extraKeys.join(', ');
-        const errorMessage = `Unknown configuration keys found: ${extraKeysString}. Allowed keys are: ${allowedKeysString}`;
-        logger.error(errorMessage);
-        throw new Error(`Configuration validation failed: Unknown keys found (${extraKeysString}). Check logs for details.`);
-    }
-};
-const validateConfigDirectory = async (configDirectory, isRequired)=>{
-    // eslint-disable-next-line no-console
-    const storage$1 = storage.create({
-        log: console.log
-    });
-    const exists = await storage$1.exists(configDirectory);
-    if (!exists) {
-        if (isRequired) {
-            throw new Error(`Config directory does not exist and is required: ${configDirectory}`);
-        }
-    } else if (exists) {
-        const isReadable = await storage$1.isDirectoryReadable(configDirectory);
-        if (!isReadable) {
-            throw new Error(`Config directory exists but is not readable: ${configDirectory}`);
-        }
-    }
-};
-const validate = async (config, options)=>{
-    const logger = options.logger;
-    if (options.features.includes('config') && config.configDirectory) {
-        await validateConfigDirectory(config.configDirectory, options.defaults.isRequired);
-    }
-    // Combine the base schema with the user-provided shape
-    const fullSchema = zod.z.object({
-        ...types.ConfigSchema.shape,
-        ...options.configShape
-    });
-    logger.debug('Full Schema: \n\n%s\n\n', JSON.stringify(listZodKeys(fullSchema), null, 2));
-    // Validate the merged sources against the full schema
-    const validationResult = fullSchema.safeParse(config);
-    // Check for extraneous keys
-    checkForExtraKeys(config, fullSchema, logger);
-    if (!validationResult.success) {
-        logger.error('Configuration validation failed: %s', JSON.stringify(validationResult.error.format(), null, 2));
-        throw new Error(`Configuration validation failed. Check logs for details.`);
-    }
-    return;
-};
-
-exports.checkForExtraKeys = checkForExtraKeys;
-exports.listObjectKeys = listObjectKeys;
-exports.listZodKeys = listZodKeys;
-exports.validate = validate;
-//# sourceMappingURL=validate.cjs.map

package/dist/validate.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate.cjs","sources":["../src/validate.ts"],"sourcesContent":["import { z, ZodObject } from \"zod\";\nimport { ArgumentError } from \"./error/ArgumentError\";\nimport { ConfigSchema, Logger, Options } from \"./types\";\nimport * as Storage from \"./util/storage\";\nexport { ArgumentError };\n\nexport const listZodKeys = (schema: z.ZodTypeAny, prefix = ''): string[] => {\n    // Check if schema has unwrap method (which both ZodOptional and ZodNullable have)\n    if (schema._def && (schema._def.typeName === 'ZodOptional' || schema._def.typeName === 'ZodNullable')) {\n        // Use type assertion to handle the unwrap method\n        const unwrappable = schema as z.ZodOptional<any> | z.ZodNullable<any>;\n        return listZodKeys(unwrappable.unwrap(), prefix);\n    }\n    if (schema._def && schema._def.typeName === 'ZodArray') {\n        // Use type assertion to handle the element property\n        const arraySchema = schema as z.ZodArray<any>;\n        return listZodKeys(arraySchema.element, prefix);\n    }\n    if (schema._def && schema._def.typeName === 'ZodObject') {\n        // Use type assertion to handle the shape property\n        const objectSchema = schema as z.ZodObject<any>;\n        return Object.entries(objectSchema.shape).flatMap(([key, subschema]) => {\n            const fullKey = prefix ? `${prefix}.${key}` : key;\n            const nested = listZodKeys(subschema as z.ZodTypeAny, fullKey);\n            return nested.length ? nested : fullKey;\n        });\n    }\n    return [];\n}\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n    // Check if it's an object, not null, and not an array.\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n};\n\n/**\n * Generates a list of all keys within a JavaScript object, using dot notation for nested keys.\n * Mimics the behavior of listZodKeys but operates on plain objects.\n * For arrays, it inspects the first element that is a plain object to determine nested keys.\n * If an array contains no plain objects, or is empty, the key for the array itself is listed.\n *\n * @param obj The object to introspect.\n * @param prefix Internal use for recursion: the prefix for the current nesting level.\n * @returns An array of strings representing all keys in dot notation.\n */\nexport const listObjectKeys = (obj: Record<string, unknown>, prefix = ''): string[] => {\n    const keys = new Set<string>(); // Use Set to automatically handle duplicates from array recursion\n\n    for (const key in obj) {\n        // Ensure it's an own property, not from the prototype chain\n        if (Object.prototype.hasOwnProperty.call(obj, key)) {\n            const value = obj[key];\n            const fullKey = prefix ? `${prefix}.${key}` : key;\n\n            if (Array.isArray(value)) {\n                // Find the first element that is a plain object to determine structure\n                const firstObjectElement = value.find(isPlainObject);\n                if (firstObjectElement) {\n                    // Recurse into the structure of the first object element found\n                    const nestedKeys = listObjectKeys(firstObjectElement, fullKey);\n                    nestedKeys.forEach(k => keys.add(k));\n                } else {\n                    // Array is empty or contains no plain objects, list the array key itself\n                    keys.add(fullKey);\n                }\n            } else if (isPlainObject(value)) {\n                // Recurse into nested plain objects\n                const nestedKeys = listObjectKeys(value, fullKey);\n                nestedKeys.forEach(k => keys.add(k));\n            } else {\n                // It's a primitive, null, or other non-plain object/array type\n                keys.add(fullKey);\n            }\n        }\n    }\n    return Array.from(keys); // Convert Set back to Array\n};\n\n\n\nexport const checkForExtraKeys = (mergedSources: object, fullSchema: ZodObject<any>, logger: Logger | typeof console): void => {\n    const allowedKeys = new Set(listZodKeys(fullSchema));\n    const actualKeys = listObjectKeys(mergedSources as Record<string, unknown>);\n    const extraKeys = actualKeys.filter(key => !allowedKeys.has(key));\n\n    if (extraKeys.length > 0) {\n        const allowedKeysString = Array.from(allowedKeys).join(', ');\n        const extraKeysString = extraKeys.join(', ');\n        const errorMessage = `Unknown configuration keys found: ${extraKeysString}. Allowed keys are: ${allowedKeysString}`;\n        logger.error(errorMessage);\n        throw new Error(`Configuration validation failed: Unknown keys found (${extraKeysString}). Check logs for details.`);\n    }\n}\n\nconst validateConfigDirectory = async (configDirectory: string, isRequired: boolean): Promise<void> => {\n    // eslint-disable-next-line no-console\n    const storage = Storage.create({ log: console.log });\n    const exists = await storage.exists(configDirectory);\n    if (!exists) {\n        if (isRequired) {\n            throw new Error(`Config directory does not exist and is required: ${configDirectory}`);\n        }\n    } else if (exists) {\n        const isReadable = await storage.isDirectoryReadable(configDirectory);\n        if (!isReadable) {\n            throw new Error(`Config directory exists but is not readable: ${configDirectory}`);\n        }\n    }\n}\n\nexport const validate = async <T extends z.ZodRawShape>(config: z.infer<ZodObject<T & typeof ConfigSchema.shape>>, options: Options<T>): Promise<void> => {\n    const logger = options.logger;\n\n    if (options.features.includes('config') && config.configDirectory) {\n        await validateConfigDirectory(config.configDirectory, options.defaults.isRequired);\n    }\n\n    // Combine the base schema with the user-provided shape\n    const fullSchema = z.object({\n        ...ConfigSchema.shape,\n        ...options.configShape,\n    });\n\n    logger.debug('Full Schema: \\n\\n%s\\n\\n', JSON.stringify(listZodKeys(fullSchema), null, 2));\n\n    // Validate the merged sources against the full schema\n    const validationResult = fullSchema.safeParse(config);\n\n    // Check for extraneous keys\n    checkForExtraKeys(config, fullSchema, logger);\n\n    if (!validationResult.success) {\n        logger.error('Configuration validation failed: %s', JSON.stringify(validationResult.error.format(), null, 2));\n        throw new Error(`Configuration validation failed. Check logs for details.`);\n    }\n\n    return;\n}\n\n"],"names":["listZodKeys","schema","prefix","_def","typeName","unwrappable","unwrap","arraySchema","element","objectSchema","Object","entries","shape","flatMap","key","subschema","fullKey","nested","length","isPlainObject","value","Array","isArray","listObjectKeys","obj","keys","Set","prototype","hasOwnProperty","call","firstObjectElement","find","nestedKeys","forEach","k","add","from","checkForExtraKeys","mergedSources","fullSchema","logger","allowedKeys","actualKeys","extraKeys","filter","has","allowedKeysString","join","extraKeysString","errorMessage","error","Error","validateConfigDirectory","configDirectory","isRequired","storage","Storage","log","console","exists","isReadable","isDirectoryReadable","validate","config","options","features","includes","defaults","z","object","ConfigSchema","configShape","debug","JSON","stringify","validationResult","safeParse","success","format"],"mappings":"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"}

package/eslint.config.mjs

@@ -1,82 +0,0 @@
-import { defineConfig, globalIgnores } from "eslint/config";
-import typescriptEslint from "@typescript-eslint/eslint-plugin";
-import importPlugin from "eslint-plugin-import";
-import globals from "globals";
-import tsParser from "@typescript-eslint/parser";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import js from "@eslint/js";
-import { FlatCompat } from "@eslint/eslintrc";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const compat = new FlatCompat({
-    baseDirectory: __dirname,
-    recommendedConfig: js.configs.recommended,
-    allConfig: js.configs.all
-});
-
-export default defineConfig([
-    globalIgnores([
-        "dist/**",
-        "node_modules/**",
-        "**/*.test.ts",
-    ]),
-    {
-        extends: compat.extends("eslint:recommended", "plugin:@typescript-eslint/recommended"),
-
-        plugins: {
-            "@typescript-eslint": typescriptEslint,
-            "import": importPlugin,
-        },
-
-        languageOptions: {
-            globals: {
-                ...globals.node,
-            },
-
-            parser: tsParser,
-            ecmaVersion: "latest",
-            sourceType: "module",
-        },
-
-        rules: {
-            "@typescript-eslint/no-explicit-any": "off",
-            "@typescript-eslint/explicit-function-return-type": "off",
-
-            "@typescript-eslint/no-unused-vars": ["warn", {
-                argsIgnorePattern: "^_",
-            }],
-
-            indent: ["error", 4, {
-                SwitchCase: 1,
-            }],
-
-            "import/extensions": ["error", "never", {
-                ignorePackages: true,
-                pattern: {
-                    "js": "never",
-                    "ts": "never",
-                    "d": "always"
-                }
-            }],
-
-            "import/no-extraneous-dependencies": ["error", {
-                devDependencies: true,
-                optionalDependencies: false,
-                peerDependencies: false,
-            }],
-
-            "no-console": ["error"],
-
-            "no-restricted-imports": ["error", {
-                paths: ["dayjs", "fs", "moment-timezone"],
-                patterns: [
-                    {
-                        group: ["src/**"],
-                        message: "Use absolute imports instead of relative imports"
-                    }
-                ]
-            }]
-        },
-    }]);

package/nodemon.json

@@ -1,14 +0,0 @@
-{
-    "verbose": true,
-    "ignore": [
-        ".git",
-        "node_modules/**/node_modules",
-        "dist",
-        "*.test.ts"
-    ],
-    "watch": [
-        "src"
-    ],
-    "ext": "ts,json",
-    "exec": "tsc && echo \"⚡ Compilation complete\""
-}

package/vite.config.ts

@@ -1,98 +0,0 @@
-import { defineConfig } from 'vite';
-import { VitePluginNode } from 'vite-plugin-node';
-import replace from '@rollup/plugin-replace';
-// import { visualizer } from 'rollup-plugin-visualizer';
-import { execSync } from 'child_process';
-import dts from 'vite-plugin-dts';
-
-let gitInfo = {
-    branch: '',
-    commit: '',
-    tags: '',
-    commitDate: '',
-};
-
-try {
-    gitInfo = {
-        branch: execSync('git rev-parse --abbrev-ref HEAD').toString().trim(),
-        commit: execSync('git rev-parse --short HEAD').toString().trim(),
-        tags: '',
-        commitDate: execSync('git log -1 --format=%cd --date=iso').toString().trim(),
-    };
-
-    try {
-        gitInfo.tags = execSync('git tag --points-at HEAD | paste -sd "," -').toString().trim();
-    } catch {
-        gitInfo.tags = '';
-    }
-} catch {
-    // eslint-disable-next-line no-console
-    console.log('Directory does not have a Git repository, skipping git info');
-}
-
-
-export default defineConfig({
-    server: {
-        port: 3000
-    },
-    plugins: [
-        ...VitePluginNode({
-            adapter: 'express',
-            appPath: './src/cardigantime.ts',
-            exportName: 'viteNodeApp',
-            tsCompiler: 'swc',
-            swcOptions: {
-                sourceMaps: true,
-            },
-        }),
-        // visualizer({
-        //     template: 'network',
-        //     filename: 'network.html',
-        //     projectRoot: process.cwd(),
-        // }),
-        replace({
-            '__VERSION__': process.env.npm_package_version,
-            '__GIT_BRANCH__': gitInfo.branch,
-            '__GIT_COMMIT__': gitInfo.commit,
-            '__GIT_TAGS__': gitInfo.tags === '' ? '' : `T:${gitInfo.tags}`,
-            '__GIT_COMMIT_DATE__': gitInfo.commitDate,
-            '__SYSTEM_INFO__': `${process.platform} ${process.arch} ${process.version}`,
-            preventAssignment: true,
-        }),
-        dts({
-            entryRoot: 'src',
-            outDir: 'dist',
-            exclude: ['**/*.test.ts'],
-            include: ['**/*.ts'],
-        }),
-    ],
-    build: {
-        target: 'esnext',
-        outDir: 'dist',
-        lib: {
-            entry: './src/cardigantime.ts',
-            formats: ['es', 'cjs'],
-        },
-        rollupOptions: {
-            input: 'src/cardigantime.ts',
-            output: [
-                {
-                    format: 'esm',
-                    entryFileNames: '[name].js',
-                    preserveModules: true,
-                    exports: 'named',
-                },
-                {
-                    format: 'cjs',
-                    entryFileNames: '[name].cjs',
-                    preserveModules: true,
-                    exports: 'named',
-                },
-            ],
-        },
-        // Make sure Vite generates ESM-compatible code
-        modulePreload: false,
-        minify: false,
-        sourcemap: true
-    },
-}); 

package/vitest.config.ts

@@ -1,17 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-    test: {
-        globals: false,
-        environment: 'node',
-        setupFiles: ['tests/setup.ts'],
-        coverage: {
-            provider: 'v8',
-            reporter: ['text', 'html', 'lcov'],
-            lines: 75,
-            branches: 56,
-            functions: 82,
-            statements: 75,
-        },
-    },
-});