@config-bound/cli 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @config-bound/cli
 
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [87d2ab6]
+  - @config-bound/core@1.0.0
+  - @config-bound/schema-export@0.1.3
+
 ## 0.2.0
 
 ### Minor Changes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Robert Keyser
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@config-bound/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI tool for ConfigBound schema export and management",
   "keywords": [
     "cli",
@@ -17,21 +17,7 @@
   },
   "main": "./dist/main.js",
   "types": "./dist/main.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "clean": "rimraf dist coverage .turbo",
-    "dev": "tsx src/main.ts",
-    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
-    "test:dev": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
-    "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
-    "lint": "eslint src/**/*.ts --fix",
-    "lint:ci": "eslint src/**/*.ts",
-    "format": "prettier --write --config ../../.config/.prettierrc --ignore-path ../../.config/.prettierignore src/**/*.ts",
-    "format:ci": "prettier --check --config ../../.config/.prettierrc --ignore-path ../../.config/.prettierignore src/**/*.ts"
-  },
   "dependencies": {
-    "@config-bound/config-bound": "*",
-    "@config-bound/schema-export": "*",
     "@nestjs/common": "^11.1.18",
     "@nestjs/core": "^11.1.18",
     "chalk": "^4.1.2",
@@ -39,26 +25,44 @@
     "nest-commander": "^3.15.0",
     "reflect-metadata": "^0.2.2",
     "ts-morph": "^24.0.0",
-    "tsx": "^4.20.6"
+    "tsx": "^4.20.6",
+    "@config-bound/core": "1.0.0",
+    "@config-bound/schema-export": "0.1.3"
   },
   "devDependencies": {
-    "@config-bound/eslint-config": "*",
     "@nestjs/testing": "^11.1.18",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.10.1",
+    "@types/node": "^24.10.0",
     "eslint": "^9.39.1",
     "jest": "^30.2.0",
     "markdown-table": "^3.0.4",
-    "rimraf": "^6.1.2",
+    "rimraf": "^6.1.0",
     "ts-jest": "^29.4.5",
-    "typescript": "^6.0.0"
+    "typescript": "^6.0.0",
+    "@config-bound/eslint-config": "0.0.0",
+    "@config-bound/typescript-config": "0.0.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": ">=22"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/notr-ai/ConfigBound"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist coverage .turbo",
+    "dev": "tsx src/main.ts",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest",
+    "test:dev": "NODE_OPTIONS='--experimental-vm-modules' jest --watch",
+    "test:coverage": "NODE_OPTIONS='--experimental-vm-modules' jest --coverage",
+    "lint": "eslint src/**/*.ts --fix",
+    "lint:ci": "eslint src/**/*.ts",
+    "format": "prettier --write --config ../../.config/.prettierrc --ignore-path ../../.config/.prettierignore src/**/*.ts",
+    "format:ci": "prettier --check --config ../../.config/.prettierrc --ignore-path ../../.config/.prettierignore src/**/*.ts"
   }
-}
+}

package/scripts/generate-docs.ts

@@ -311,7 +311,7 @@ The factory pattern pre-loads values into a cache at startup. \`retrieve()\` rea
     { text: 'Create a custom bind', link: '/how-to/custom-bind' },
     {
       text: '`Bind` API reference',
-      link: '/reference/api/@config-bound.config-bound.bind.bind.Class.Bind',
+      link: '/reference/api/@config-bound.core.bind.bind.Class.Bind',
     },
   ],
 };

package/src/services/bind-generator.service.ts

@@ -100,7 +100,7 @@ export class BindGeneratorService {
   }
 
   private renderBindClass(names: BindNames): string {
-    return `import { Bind } from '@config-bound/config-bound/bind';
+    return `import { Bind } from '@config-bound/core/bind';
 
 /**
  * Options for constructing a ${names.pascal}Bind.
@@ -191,7 +191,7 @@ export class ${names.pascal}Bind extends Bind {
   "keywords": ["configbound", "config", "${names.kebab}"],
   "license": "MIT",
   "dependencies": {
-    "@config-bound/config-bound": "^0.1.0"
+    "@config-bound/core": "^0.1.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.0.0",

package/src/services/config-discovery.service.spec.ts

@@ -45,7 +45,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'config.ts',
       `
-      import { ConfigBound } from '@config-bound/config-bound';
+      import { ConfigBound } from '@config-bound/core';
       
       export const appConfig = ConfigBound.createConfig({
         name: 'MyApp',
@@ -66,7 +66,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'config.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       
       export const dbConfig = createConfig({
         name: 'Database',
@@ -86,7 +86,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'config.ts',
       `
-      import { ConfigBound } from '@config-bound/config-bound';
+      import { ConfigBound } from '@config-bound/core';
       
       export default ConfigBound.createConfig({
         name: 'DefaultConfig',
@@ -107,7 +107,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'configs.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       
       export const config1 = createConfig({ name: 'Config1', sections: {} });
       export const config2 = createConfig({ name: 'Config2', sections: {} });
@@ -126,7 +126,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'config1.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       export const config1 = createConfig({ name: 'Config1', sections: {} });
     `
     );
@@ -134,7 +134,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'subdir/config2.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       export const config2 = createConfig({ name: 'Config2', sections: {} });
     `
     );
@@ -148,7 +148,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'config1.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       export const config1 = createConfig({ name: 'Config1', sections: {} });
     `
     );
@@ -156,7 +156,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'subdir/config2.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       export const config2 = createConfig({ name: 'Config2', sections: {} });
     `
     );
@@ -170,7 +170,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'config.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       const privateConfig = createConfig({ name: 'Private', sections: {} });
     `
     );
@@ -184,7 +184,7 @@ describe('ConfigDiscoveryService', () => {
     createTempFile(
       'config.spec.ts',
       `
-      import { createConfig } from '@config-bound/config-bound';
+      import { createConfig } from '@config-bound/core';
       export const testConfig = createConfig({ name: 'Test', sections: {} });
     `
     );

package/src/services/config-discovery.service.ts

@@ -1,8 +1,9 @@
 import { Injectable } from '@nestjs/common';
 import { Project, Node, SyntaxKind, SourceFile } from 'ts-morph';
 import * as path from 'path';
-import * as fs from 'fs';
-import { ensureError } from '@config-bound/config-bound/utilities';
+import { promises as fs } from 'fs';
+import { glob } from 'node:fs/promises';
+import { ensureError } from '@config-bound/core/utilities';
 
 export interface DiscoveredConfig {
   filePath: string;
@@ -18,7 +19,7 @@ export class ConfigDiscoveryService {
     searchPath: string,
     recursive: boolean = true
   ): Promise<DiscoveredConfig[]> {
-    const tsFiles = this.findTypeScriptFiles(searchPath, recursive);
+    const tsFiles = await this.findTypeScriptFiles(searchPath, recursive);
     const discovered: DiscoveredConfig[] = [];
 
     // Create a single project instance for all files
@@ -171,11 +172,10 @@ export class ConfigDiscoveryService {
     return undefined;
   }
 
-  private findTypeScriptFiles(
+  private async findTypeScriptFiles(
     searchPath: string,
     recursive: boolean
-  ): string[] {
-    const files: string[] = [];
+  ): Promise<string[]> {
     const excludedDirs = new Set([
       'node_modules',
       'dist',
@@ -192,46 +192,31 @@ export class ConfigDiscoveryService {
       'env'
     ]);
 
-    function traverse(dir: string) {
-      let entries;
-      try {
-        entries = fs.readdirSync(dir, { withFileTypes: true });
-      } catch {
-        // Skip directories we can't read
-        return;
-      }
+    const stats = await fs.stat(searchPath);
+    if (stats.isFile()) {
+      return searchPath.endsWith('.ts') ? [searchPath] : [];
+    }
 
-      for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
+    const pattern = recursive ? '**/*.ts' : '*.ts';
+    const files: string[] = [];
 
-        // Skip excluded directories and hidden directories
-        if (entry.isDirectory()) {
-          if (excludedDirs.has(entry.name) || entry.name.startsWith('.')) {
-            continue;
-          }
-          if (recursive) {
-            traverse(fullPath);
-          }
-        } else if (entry.isFile() && entry.name.endsWith('.ts')) {
-          // Skip test files and declaration files
-          if (
-            !entry.name.endsWith('.spec.ts') &&
-            !entry.name.endsWith('.test.ts') &&
-            !entry.name.endsWith('.d.ts')
-          ) {
-            files.push(fullPath);
-          }
-        }
+    for await (const file of glob(pattern, {
+      cwd: searchPath,
+      exclude: (p) =>
+        p
+          .split(path.sep)
+          .some((part) => excludedDirs.has(part) || part.startsWith('.'))
+    })) {
+      const name = path.basename(file);
+      if (
+        !name.endsWith('.spec.ts') &&
+        !name.endsWith('.test.ts') &&
+        !name.endsWith('.d.ts')
+      ) {
+        files.push(path.join(searchPath, file));
       }
     }
 
-    const stats = fs.statSync(searchPath);
-    if (stats.isDirectory()) {
-      traverse(searchPath);
-    } else if (stats.isFile() && searchPath.endsWith('.ts')) {
-      files.push(searchPath);
-    }
-
     return files;
   }
 }

package/src/services/config-loader.service.ts

@@ -2,10 +2,9 @@ import { Injectable } from '@nestjs/common';
 import * as path from 'path';
 import * as fs from 'fs';
 import { pathToFileURL } from 'url';
-import { Section } from '@config-bound/config-bound/section';
+import { Section } from '@config-bound/core/section';
 import {
   ConfigBound,
-  TypedConfigBound,
   ConfigSchema,
   ConfigLoaderException,
   ConfigFileNotFoundException,
@@ -16,12 +15,12 @@ import {
   InvalidConfigBoundInstanceException,
   ConfigFileParseException,
   MissingDependencyException
-} from '@config-bound/config-bound';
+} from '@config-bound/core';
 
 export interface LoadedConfig {
   name: string;
-  sections: Section[];
-  instance: ConfigBound | TypedConfigBound<ConfigSchema>;
+  sections: ReadonlyArray<Section>;
+  instance: ConfigBound<ConfigSchema>;
 }
 
 @Injectable()
@@ -94,10 +93,7 @@ export class ConfigLoaderService {
       const fileURL = pathToFileURL(fileToLoad).href;
       const module = await import(fileURL);
 
-      let configInstance:
-        | ConfigBound
-        | TypedConfigBound<ConfigSchema>
-        | undefined;
+      let configInstance: ConfigBound<ConfigSchema> | undefined;
 
       if (exportName && exportName !== 'default') {
         configInstance = module[exportName];
@@ -156,9 +152,7 @@ export class ConfigLoaderService {
             );
           }
 
-          configInstance = configExports[0][1] as
-            | ConfigBound
-            | TypedConfigBound<ConfigSchema>;
+          configInstance = configExports[0][1] as ConfigBound<ConfigSchema>;
         } else {
           // exportName === 'default' was explicitly requested, so use it even if invalid
           configInstance = defaultExport;
@@ -320,9 +314,7 @@ export class ConfigLoaderService {
           exportName !== 'default' &&
           this.isConfigBoundInstance(exportValue)
         ) {
-          const typedValue = exportValue as
-            | ConfigBound
-            | TypedConfigBound<ConfigSchema>;
+          const typedValue = exportValue as ConfigBound<ConfigSchema>;
           configs.set(exportName, {
             name: typedValue.name,
             sections: typedValue.sections,
@@ -365,7 +357,7 @@ export class ConfigLoaderService {
 
   private isConfigBoundInstance(
     value: unknown
-  ): value is ConfigBound | TypedConfigBound<ConfigSchema> {
+  ): value is ConfigBound<ConfigSchema> {
     return (
       value !== null &&
       value !== undefined &&

package/src/services/schema-export.service.spec.ts

@@ -1,9 +1,9 @@
 import { Test, TestingModule } from '@nestjs/testing';
 import { SchemaExportService } from './schema-export.service.js';
 import { describe, beforeEach, it, expect } from '@jest/globals';
-import { ConfigBound } from '@config-bound/config-bound';
-import { Section } from '@config-bound/config-bound/section';
-import { Element } from '@config-bound/config-bound/element';
+import { ConfigBound } from '@config-bound/core';
+import { Section } from '@config-bound/core/section';
+import { Element } from '@config-bound/core/element';
 import { z } from 'zod';
 
 describe('SchemaExportService', () => {
@@ -18,25 +18,23 @@ describe('SchemaExportService', () => {
 
     service = module.get<SchemaExportService>(SchemaExportService);
 
-    const hostElement = new Element<string>(
-      'host',
-      'Database host',
-      'localhost',
-      undefined,
-      false,
-      false,
-      z.string()
-    );
+    const hostElement = new Element<string>({
+      name: 'host',
+      description: 'Database host',
+      default: 'localhost',
+      sensitive: false,
+      omitFromSchema: false,
+      validator: z.string()
+    });
 
-    const portElement = new Element<number>(
-      'port',
-      'Database port',
-      5432,
-      undefined,
-      false,
-      false,
-      z.number()
-    );
+    const portElement = new Element<number>({
+      name: 'port',
+      description: 'Database port',
+      default: 5432,
+      sensitive: false,
+      omitFromSchema: false,
+      validator: z.number()
+    });
 
     const databaseSection = new Section(
       'database',

package/src/services/schema-export.service.ts

@@ -5,13 +5,9 @@ import {
   formatAsYAML,
   formatAsEnvExample
 } from '@config-bound/schema-export';
-import {
-  ConfigBound,
-  TypedConfigBound,
-  ConfigSchema
-} from '@config-bound/config-bound';
-import { Section } from '@config-bound/config-bound/section';
-import { EnvVarBind } from '@config-bound/config-bound/bind/binds/envVar';
+import { ConfigBound, ConfigSchema } from '@config-bound/core';
+import { Section } from '@config-bound/core/section';
+import { EnvVarBind } from '@config-bound/core/binds/env';
 
 export type ExportFormat = 'json' | 'yaml' | 'env';
 
@@ -25,8 +21,8 @@ export interface ExportSchemaOptions {
 export class SchemaExportService {
   exportToString(
     configName: string,
-    sections: Section[],
-    configInstance: ConfigBound | TypedConfigBound<ConfigSchema>,
+    sections: ReadonlyArray<Section>,
+    configInstance: ConfigBound<ConfigSchema>,
     options: ExportSchemaOptions
   ): string {
     const includeOmitted = options.includeOmitted || false;
@@ -41,7 +37,6 @@ export class SchemaExportService {
         return formatAsYAML(schema);
 
       case 'env': {
-        // Extract prefix from EnvVarBind if present
         const prefix = this.extractEnvVarPrefix(configInstance);
         return formatAsEnvExample(schema, prefix);
       }
@@ -52,7 +47,7 @@ export class SchemaExportService {
   }
 
   private extractEnvVarPrefix(
-    configInstance: ConfigBound | TypedConfigBound<ConfigSchema>
+    configInstance: ConfigBound<ConfigSchema>
   ): string | undefined {
     if (!configInstance || !configInstance.binds) {
       return undefined;