stonyx 0.2.3-alpha.2 → 0.2.3-alpha.21

package/src/cli.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-
-import serve from './cli/serve.js';
-import test from './cli/test.js';
-import help from './cli/help.js';
-import newCommand from './cli/new.js';
-import loadModuleCommands from './cli/load-commands.js';
-
-try { process.loadEnvFile(); } catch { /* no .env file */ }
-
-const aliases = { s: 'serve', t: 'test', h: 'help', n: 'new' };
-
-const builtInCommands = {
-  serve: { description: 'Bootstrap Stonyx and run the app', run: serve },
-  test: { description: 'Bootstrap Stonyx in test mode and run tests', run: test },
-  new: { description: 'Scaffold a new Stonyx project', run: newCommand },
-  help: { description: 'Show available commands', run: help }
-};
-
-const args = process.argv.slice(2);
-const commandName = aliases[args[0]] || args[0];
-const commandArgs = args.slice(1);
-
-async function main() {
-  if (!commandName || commandName === 'help') {
-    await help({ args: commandArgs, builtInCommands, loadModuleCommands });
-    return;
-  }
-
-  const builtIn = builtInCommands[commandName];
-
-  if (builtIn) {
-    await builtIn.run({ args: commandArgs });
-    return;
-  }
-
-  // Search module commands
-  const moduleCommands = await loadModuleCommands();
-  const moduleCommand = moduleCommands[commandName];
-
-  if (moduleCommand) {
-    const cwd = process.cwd();
-
-    if (moduleCommand.bootstrap) {
-      const { default: config } = await import(`${cwd}/config/environment.js`);
-      const { default: Stonyx } = await import('./main.js');
-      new Stonyx(config, cwd);
-      await Stonyx.ready;
-    }
-
-    await moduleCommand.run({ args: commandArgs, cwd });
-    return;
-  }
-
-  console.error(`Unknown command: ${args[0]}\n`);
-  await help({ args: [], builtInCommands, loadModuleCommands });
-  process.exit(1);
-}
-
-main().catch(error => {
-  console.error(error);
-  process.exit(1);
-});

package/src/exports/config.js

@@ -1,3 +0,0 @@
-import Stonyx from 'stonyx';
-
-export default Stonyx.config;

package/src/exports/test-helpers.js

@@ -1,8 +0,0 @@
-import Stonyx from 'stonyx';
-
-export function setupIntegrationTests(hooks) {
-  hooks.before(async function() {
-    await Stonyx.ready;
-    console.log('Stonyx ready');
-  });
-}

package/src/lifecycle.js

@@ -1,17 +0,0 @@
-export async function runStartupHooks(modules) {
-  for (const module of modules) {
-    if (typeof module.startup === 'function') await module.startup();
-  }
-}
-
-export async function runShutdownHooks(modules) {
-  for (const module of [...modules].reverse()) {
-    if (typeof module.shutdown === 'function') {
-      try {
-        await module.shutdown();
-      } catch (error) {
-        console.error('Error during module shutdown:', error);
-      }
-    }
-  }
-}

package/src/main.js

@@ -1,101 +0,0 @@
-/*
- * Copyright 2025 Stone Costa
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import Chronicle from 'node-chronicle';
-import loadModules from './modules.js';
-import { kebabCaseToCamelCase } from '@stonyx/utils/string';
-import { mergeObject } from '@stonyx/utils/object';
-
-export default class Stonyx {
-  static initialized = false
-  static modulePromises = {};
-
-  constructor(config, rootPath) {
-    if (Stonyx.instance) return Stonyx.instance;
-
-    Stonyx.instance = this;
-    Stonyx.ready = this.start(config, rootPath);
-  }
-
-  async start(config, rootPath) {
-    if (!config) throw new Error('Stonyx requires full environment configuration on startup');
-    if (!rootPath) throw new Error('Stonyx requires root project\'s path on startup');
-
-    // Transform config from stonyx-modules running as a standalone
-    if (rootPath.includes('stonyx-')) {
-      const moduleName = kebabCaseToCamelCase(rootPath.split('/').pop().replace('stonyx-', ''));
-      config = { [moduleName]: config, ...(config.modules || {}) };
-      delete config.modules;  
-    }
-
-    this.config = config;
-    this.chronicle = new Chronicle({ additionalLogs: { title: 'green' }});
-
-    Stonyx.initialized = true;
-
-    // Auto-merge test environment overrides (after initialized flag, before modules load)
-    // Uses in-place mutation to preserve existing references (e.g. stonyx/config export cache)
-    if (process.env.NODE_ENV === 'test') {
-      try {
-        const { default: testOverrides } = await import(`${rootPath}/test/config/environment.js`);
-        const merged = mergeObject(config, testOverrides);
-        Object.assign(config, merged);
-      } catch { /* no test overrides found */ }
-    }
-
-    this.modules = await loadModules(config, rootPath, this.chronicle);
-    this.configureUserLogs();
-  }
-
-  /**
-   * Allows users to define their own log for any extra class via environment config
-   * { 
-   *   myClass: {
-   *     logColor: 'purple',
-   *     logMethod: 'highlight'
-   *     logTimestamp: true
-   *   }
-   & }
-   */
-  configureUserLogs() {
-    const { chronicle } = this;
-
-    for (const [ className, config ] of Object.entries(this.config)) {
-      if (!config || typeof config !== 'object') continue;
-      if (chronicle[className]) continue;
-
-      const { logColor, logMethod, logTimestamp } = config;
-
-      if (!logColor) continue;
-
-      chronicle.defineType(logMethod || className, logColor, { logTimestamp: !!logTimestamp });
-    }
-  }
-  
-  static get log() {
-    if (!Stonyx.initialized) throw new Error('Stonyx has not been initialized yet');
-
-    return Stonyx.instance.chronicle;
-  }
-
-  static get config() {
-    if (!Stonyx.initialized) throw new Error('Stonyx has not been initialized yet');
-
-    return Stonyx.instance.config;
-  }
-}
-
-export { waitForModule } from './modules.js';

package/src/modules.js

@@ -1,112 +0,0 @@
-/**
- * Validates and initializes stonyx modules
- * TODO: Refactor into a ModuleLoader class (good coding exercise) 
- */
-import { readFile } from '@stonyx/utils/file';
-import { kebabCaseToCamelCase } from '@stonyx/utils/string';
-import { mergeObject } from '@stonyx/utils/object';
-
-const modulePromises = {};
-
-// Configure module-specific logging
-function configureLog(chronicle, module, config) {
-  const { logColor, logMethod, logTimestamp } = config;
-  if (!logColor) return;
-  
-  chronicle.defineType(logMethod || module, logColor, { logTimestamp: !!logTimestamp });
-}
-
-function initializeModule(moduleName, moduleClass, modules, initPromises) {
-  const moduleInstance = new moduleClass();
-  
-  modules.push(moduleInstance);
-
-  if (!moduleInstance.init) return;
-    
-  initPromises.push((async () => {
-    await moduleInstance.init();
-    modulePromises[moduleName]?.resolve();
-  })());
-}
-
-export default async function(config, rootPath, chronicle) {
-  const modules = [];
-  const initPromises = [];
-  const rootPackage = await readFile(`${rootPath}/package.json`, { json: true });
-  const { devDependencies:dependencies, name:projectName } = rootPackage;
-
-  // Expose rootPath to public configuration
-  config.rootPath = rootPath;
-
-  const moduleDependencies = Object.keys(dependencies).filter(moduleName => moduleName.startsWith('@stonyx/'));
-
-  // Setup module promises prior to initialization
-  for (const moduleName of moduleDependencies) {
-    const promise = {};
-    modulePromises[moduleName] = promise;
-    promise.ready = new Promise(resolve => promise.resolve = resolve);
-  }
-
-  // Standalone module configuration
-  if (rootPackage.keywords?.includes('stonyx-module')) {
-    configureLog(chronicle, projectName, config);
-
-    const { main: entryPoint } = rootPackage; 
-    const { default: moduleClass } = await import(`${rootPath}/${entryPoint}`);
-    initializeModule(rootPackage.name, moduleClass, modules, initPromises);
-  }
-
-  for (const moduleName of moduleDependencies) {
-    const modulePackage = await readFile(`${rootPath}/node_modules/${moduleName}/package.json`, { json: true, missingFileCallback: () => {
-      console.warn(`Warning: Could not locate stonyx module: "${moduleName}". Module was not loaded`);
-    }});
-
-    if (!modulePackage) continue;
-
-    const { keywords } = modulePackage;
-
-    if (!keywords.includes('stonyx-module')) {
-      console.warn(`Warning: Stonyx modules must contain the "stonyx-module" keyword. Module was not loaded`);
-      continue;
-    }
-    
-    if (!keywords.includes('stonyx-async')) {
-      modulePromises[moduleName].resolve();
-      continue;
-    }
-
-    try {
-      // Load & Configure Async Modules
-      const { default: moduleConfig } = await import(`${rootPath}/node_modules/${moduleName}/config/environment.js`);
-
-      const module = kebabCaseToCamelCase(moduleName.split('/').pop());
-      const userConfig = config[module] || {};
-      const finalConfig = mergeObject(moduleConfig, userConfig);
-      config[module] = finalConfig;
-
-      // Configure module-specific logging
-      configureLog(chronicle, module, finalConfig);
-
-      const { main: entryPoint } = modulePackage; 
-      const { default: moduleClass } = await import(`${rootPath}/node_modules/${moduleName}/${entryPoint}`);
-      initializeModule(moduleName, moduleClass, modules, initPromises);
-    } catch (error) {
-      console.error(error);
-      throw new Error(`Stonyx modules with async loading must have a config/environment.js file with default configurations. Module "${moduleName}" failed to load.`);
-    }
-  }
-
-  // Wait until all modules are initialized
-  await Promise.all(initPromises);
-
-  return modules;
-}
-
-export async function waitForModule(module) {
-  module = `@stonyx/${module}`;
-  const modulePromise = modulePromises[module];
-
-  if (!modulePromise) throw new Error(`Could wait for module: ${module}. Module was not registered in project dependencies`);
-
-  await modulePromises[module].ready;
-}