@devcraft-ts/diadem 0.1.0

package/dist/setup/index.js

@@ -0,0 +1,75 @@
+import { DiademContainer } from '../chunk-RTX6B4YY.js';
+import { getLogger } from '../chunk-W7NA3ZZF.js';
+
+// src/setup/setup.ts
+async function setupDependencies(container, environment) {
+  await container.autoRegisterDiscovered(environment);
+  container.setReady();
+}
+async function setupTestDependencies(container, mockDependencies, environment) {
+  if (mockDependencies) {
+    mockDependencies.forEach((implementation, token) => {
+      container.register(token, implementation);
+    });
+  }
+  await container.autoRegisterDiscovered(environment);
+  container.setReady();
+}
+async function setupDevelopmentDependencies(container) {
+  await container.autoRegisterDiscovered("development");
+  if (process.env.NODE_ENV === "development") {
+    const diagnostics = container.getDiagnostics();
+    getLogger().info("DI Container Auto-Registration Diagnostics:", diagnostics);
+    const stats = container.getDiagnostics();
+    getLogger().info(
+      `Registered ${stats.dependencies + stats.singletons + stats.factories + stats.asyncFactories} services automatically`
+    );
+  }
+  container.setReady();
+}
+async function setupProductionDependencies(container) {
+  await container.autoRegisterDiscovered("production");
+  container.setReady();
+}
+async function createAutoConfiguredContainer(environment, customSetup) {
+  const container = new DiademContainer();
+  if (customSetup) {
+    await customSetup(container);
+  }
+  await container.autoRegisterDiscovered(environment);
+  container.setReady();
+  return container;
+}
+function validateAutoRegistration(container, expectedServices = []) {
+  const diagnostics = container.getDiagnostics();
+  const totalRegistered = diagnostics.dependencies + diagnostics.singletons + diagnostics.factories + diagnostics.asyncFactories;
+  const registeredTokens = container.getRegisteredTokens();
+  const registeredNames = registeredTokens.map((token) => token.name);
+  const missingServices = expectedServices.filter(
+    (serviceName) => !registeredNames.some((name) => name.includes(serviceName))
+  );
+  return {
+    isValid: missingServices.length === 0,
+    missingServices,
+    registeredCount: totalRegistered
+  };
+}
+var setupDependenciesAuto = setupDependencies;
+var setupTestDependenciesAuto = setupTestDependencies;
+var setupDevelopmentDependenciesAuto = setupDevelopmentDependencies;
+var setupProductionDependenciesAuto = setupProductionDependencies;
+
+// src/setup/index.ts
+function logSetupInfo(container) {
+  const diagnostics = container.getDiagnostics();
+  const total = diagnostics.dependencies + diagnostics.singletons + diagnostics.factories + diagnostics.asyncFactories;
+  getLogger().info("Diadem container setup", {
+    ...diagnostics,
+    total,
+    tokens: container.getRegisteredTokens().map((token) => token.name)
+  });
+}
+
+export { createAutoConfiguredContainer, logSetupInfo, setupDependencies, setupDependenciesAuto, setupDevelopmentDependencies, setupDevelopmentDependenciesAuto, setupProductionDependencies, setupProductionDependenciesAuto, setupTestDependencies, setupTestDependenciesAuto, validateAutoRegistration };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/setup/setup.ts","../../src/setup/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Constructor } from '../core/container'\nimport { DiademContainer } from '../core/container'\nimport { getLogger } from '../core/logger'\n\n/**\n * Auto-registration based dependency setup that uses decorated classes.\n * This replaces the manual setup functions with automatic discovery and registration.\n *\n * @param container The DI container instance to configure\n * @param environment Optional environment filter for environment-specific services\n */\nexport async function setupDependencies(\n  container: DiademContainer,\n  environment?: string\n): Promise<void> {\n  // Auto-register all decorated services using manifest-based discovery\n  await container.autoRegisterDiscovered(environment)\n\n  // Mark container as ready for use\n  container.setReady()\n}\n\n/**\n * Auto-registration setup for testing environments.\n * Allows for custom dependency mocking while using auto-registration for the rest.\n *\n * @param container The DI container instance to configure\n * @param mockDependencies Optional map of tokens to mock implementations\n * @param environment Optional environment filter\n */\nexport async function setupTestDependencies(\n  container: DiademContainer,\n  mockDependencies?: Map<Constructor<unknown>, unknown>,\n  environment?: string\n): Promise<void> {\n  // Register mock dependencies first (they take precedence)\n  if (mockDependencies) {\n    mockDependencies.forEach((implementation, token) => {\n      container.register(token, implementation)\n    })\n  }\n\n  // Auto-register remaining services using manifest-based discovery\n  await container.autoRegisterDiscovered(environment)\n\n  container.setReady()\n}\n\n/**\n * Auto-registration setup for development environment with debugging.\n *\n * @param container The DI container instance to configure\n */\nexport async function setupDevelopmentDependencies(\n  container: DiademContainer\n): Promise<void> {\n  // Auto-register all services for development using manifest-based discovery\n  await container.autoRegisterDiscovered('development')\n\n  // Log diagnostics in development\n  if (process.env.NODE_ENV === 'development') {\n    const diagnostics = container.getDiagnostics()\n    getLogger().info('DI Container Auto-Registration Diagnostics:', diagnostics)\n\n    // Log discovered services\n    const stats = container.getDiagnostics()\n    getLogger().info(\n      `Registered ${stats.dependencies + stats.singletons + stats.factories + stats.asyncFactories} services automatically`\n    )\n  }\n\n  container.setReady()\n}\n\n/**\n * Auto-registration setup for production environment.\n *\n * @param container The DI container instance to configure\n */\nexport async function setupProductionDependencies(\n  container: DiademContainer\n): Promise<void> {\n  // Auto-register all services for production using manifest-based discovery\n  await container.autoRegisterDiscovered('production')\n\n  container.setReady()\n}\n\n/**\n * Create a fully configured container using auto-registration.\n * This is the recommended way to create containers with the new decorator system.\n *\n * @param environment The environment to configure for ('development', 'production', 'test', etc.)\n * @param customSetup Optional custom setup function that runs before auto-registration\n * @returns A fully configured and ready container\n */\nexport async function createAutoConfiguredContainer(\n  environment: string,\n  customSetup?: (container: DiademContainer) => Promise<void>\n): Promise<DiademContainer> {\n  const container = new DiademContainer()\n\n  // Run custom setup first if provided\n  if (customSetup) {\n    await customSetup(container)\n  }\n\n  // Auto-register core services using manifest-based discovery\n  await container.autoRegisterDiscovered(environment)\n  container.setReady()\n\n  return container\n}\n\n/**\n * Validate that the expected services are registered after auto-registration.\n * Useful for debugging and asserting setup in application bootstrap code.\n *\n * @param container The container to validate\n * @param expectedServices Class names the application expects to be registered.\n *   Each is matched as a substring against registered token names. Defaults to\n *   an empty list (validation passes), since the set of services is\n *   application-specific.\n * @returns Object with validation results\n */\nexport function validateAutoRegistration(\n  container: DiademContainer,\n  expectedServices: string[] = []\n): {\n  isValid: boolean\n  missingServices: string[]\n  registeredCount: number\n} {\n  const diagnostics = container.getDiagnostics()\n  const totalRegistered =\n    diagnostics.dependencies +\n    diagnostics.singletons +\n    diagnostics.factories +\n    diagnostics.asyncFactories\n\n  const registeredTokens = container.getRegisteredTokens()\n  const registeredNames = registeredTokens.map((token) => token.name)\n\n  const missingServices = expectedServices.filter(\n    (serviceName) => !registeredNames.some((name) => name.includes(serviceName))\n  )\n\n  return {\n    isValid: missingServices.length === 0,\n    missingServices,\n    registeredCount: totalRegistered\n  }\n}\n\n// Backward compatibility aliases (keep the Auto suffix for existing code)\nexport const setupDependenciesAuto = setupDependencies\nexport const setupTestDependenciesAuto = setupTestDependencies\nexport const setupDevelopmentDependenciesAuto = setupDevelopmentDependencies\nexport const setupProductionDependenciesAuto = setupProductionDependencies\n","/**\n * Setup helpers — environment-aware container factories and validation.\n *\n * @example\n * ```ts\n * import { createAutoConfiguredContainer } from 'diadem/setup'\n *\n * const container = await createAutoConfiguredContainer(process.env.NODE_ENV)\n * const service = container.resolve(IMyService)\n * ```\n */\n\nimport type { DiademContainer } from '../core/container'\nimport { getLogger } from '../core/logger'\n\nexport {\n  createAutoConfiguredContainer,\n  setupDependencies,\n  setupDependenciesAuto,\n  setupDevelopmentDependencies,\n  setupDevelopmentDependenciesAuto,\n  setupProductionDependencies,\n  setupProductionDependenciesAuto,\n  setupTestDependencies,\n  setupTestDependenciesAuto,\n  validateAutoRegistration\n} from './setup'\n\n/**\n * Log a one-line summary of a container's registrations through the active\n * logger (silent unless a logger is configured). Intended for development\n * bootstrap diagnostics.\n */\nexport function logSetupInfo(container: DiademContainer): void {\n  const diagnostics = container.getDiagnostics()\n  const total =\n    diagnostics.dependencies +\n    diagnostics.singletons +\n    diagnostics.factories +\n    diagnostics.asyncFactories\n\n  getLogger().info('Diadem container setup', {\n    ...diagnostics,\n    total,\n    tokens: container.getRegisteredTokens().map((token) => token.name)\n  })\n}\n"]}

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@devcraft-ts/diadem",
+  "version": "0.1.0",
+  "description": "Build-time, manifest-driven dependency injection for TypeScript. SSR-safe, framework-agnostic, zero runtime reflection.",
+  "keywords": [
+    "dependency-injection",
+    "di",
+    "ioc",
+    "container",
+    "typescript",
+    "decorators",
+    "build-time",
+    "autowiring",
+    "manifest",
+    "ssr"
+  ],
+  "license": "MIT",
+  "author": "astralstriker",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/astralstriker/diadem.git"
+  },
+  "homepage": "https://github.com/astralstriker/diadem#readme",
+  "bugs": {
+    "url": "https://github.com/astralstriker/diadem/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./setup": {
+      "types": "./dist/setup/index.d.ts",
+      "import": "./dist/setup/index.js",
+      "require": "./dist/setup/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "diadem": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.10.0",
+    "eslint": "^10.4.1",
+    "globals": "^17.6.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.60.1",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}