@codemation/host 0.0.1

package/dist/ServerLoggerFactory-BRHxIDS7.js

@@ -0,0 +1,340 @@
+import { t as ConsoleLogger } from "./ConsoleLogger-ClPU7jtc.js";
+import { n as __decorateMetadata, t as __decorateParam } from "./decorateParam-BTcc3KNk.js";
+import { t as __decorate } from "./decorate-B-N_5S4p.js";
+import { inject, injectable } from "@codemation/core";
+
+//#region src/presentation/config/CodemationConfigNormalizer.ts
+var CodemationConfigNormalizer = class {
+	normalize(config) {
+		const collected = this.collectRegistration(config);
+		const normalizedRuntime = this.normalizeRuntimeConfig(config);
+		const normalizedWorkflowDiscoveryDirectories = [...config.workflowDiscovery?.directories ?? [], ...collected.workflowDirectories];
+		return {
+			...config,
+			auth: config.app?.auth ?? config.auth,
+			containerRegistrations: collected.containerRegistrations,
+			credentialTypes: [...config.credentialTypes ?? [], ...collected.credentialTypes],
+			log: config.app?.log ?? config.log,
+			runtime: normalizedRuntime,
+			whitelabel: config.app?.whitelabel ?? config.whitelabel,
+			workflowDiscovery: normalizedWorkflowDiscoveryDirectories.length > 0 ? { directories: normalizedWorkflowDiscoveryDirectories } : config.workflowDiscovery,
+			workflows: this.mergeWorkflows(config.workflows ?? [], collected.workflows)
+		};
+	}
+	collectRegistration(config) {
+		if (!config.register) return {
+			containerRegistrations: [],
+			credentialTypes: [],
+			workflows: [],
+			workflowDirectories: []
+		};
+		const containerRegistrations = [];
+		const credentialTypes = [];
+		const workflows = [];
+		const workflowDirectories = [];
+		config.register({
+			registerCredentialType(type) {
+				credentialTypes.push(type);
+			},
+			registerNode(token, implementation) {
+				containerRegistrations.push({
+					token,
+					useClass: implementation ?? token
+				});
+			},
+			registerValue(token, value) {
+				containerRegistrations.push({
+					token,
+					useValue: value
+				});
+			},
+			registerClass(token, implementation) {
+				containerRegistrations.push({
+					token,
+					useClass: implementation
+				});
+			},
+			registerFactory(token, factory) {
+				containerRegistrations.push({
+					token,
+					useFactory: factory
+				});
+			},
+			registerWorkflow(workflow) {
+				workflows.push(workflow);
+			},
+			registerWorkflows(nextWorkflows) {
+				workflows.push(...nextWorkflows);
+			},
+			discoverWorkflows(...directories) {
+				workflowDirectories.push(...directories);
+			}
+		});
+		return {
+			containerRegistrations,
+			credentialTypes,
+			workflows,
+			workflowDirectories
+		};
+	}
+	normalizeRuntimeConfig(config) {
+		if (!config.app) return config.runtime;
+		return {
+			...config.runtime ?? {},
+			frontendPort: config.app.frontendPort ?? config.runtime?.frontendPort,
+			database: this.normalizeDatabaseConfig(config),
+			eventBus: this.normalizeEventBusConfig(config),
+			scheduler: this.normalizeSchedulerConfig(config),
+			engineExecutionLimits: config.app.engineExecutionLimits ?? config.runtime?.engineExecutionLimits
+		};
+	}
+	normalizeDatabaseConfig(config) {
+		if (!config.app) return config.runtime?.database;
+		if (config.app.database) return config.app.database;
+		if (!config.app.databaseUrl) return config.runtime?.database;
+		return {
+			...config.runtime?.database ?? {},
+			url: config.app.databaseUrl
+		};
+	}
+	normalizeSchedulerConfig(config) {
+		if (!config.app?.scheduler) return config.runtime?.scheduler;
+		const scheduler = config.app.scheduler;
+		return {
+			...config.runtime?.scheduler ?? {},
+			kind: scheduler.kind === "queue" ? "bullmq" : scheduler.kind === "inline" ? "local" : config.runtime?.scheduler?.kind,
+			queuePrefix: scheduler.queuePrefix ?? config.runtime?.scheduler?.queuePrefix,
+			workerQueues: scheduler.workerQueues ?? config.runtime?.scheduler?.workerQueues
+		};
+	}
+	normalizeEventBusConfig(config) {
+		if (!config.app?.scheduler) return config.runtime?.eventBus;
+		const scheduler = config.app.scheduler;
+		const eventBusKind = scheduler.kind === "queue" ? "redis" : scheduler.kind === "inline" ? "memory" : config.runtime?.eventBus?.kind;
+		return {
+			...config.runtime?.eventBus ?? {},
+			kind: eventBusKind,
+			queuePrefix: scheduler.queuePrefix ?? config.runtime?.eventBus?.queuePrefix,
+			redisUrl: scheduler.redisUrl ?? config.runtime?.eventBus?.redisUrl
+		};
+	}
+	mergeWorkflows(configuredWorkflows, registeredWorkflows) {
+		if (configuredWorkflows.length === 0 && registeredWorkflows.length === 0) return;
+		const workflowsById = /* @__PURE__ */ new Map();
+		for (const workflow of registeredWorkflows) workflowsById.set(workflow.id, workflow);
+		for (const workflow of configuredWorkflows) workflowsById.set(workflow.id, workflow);
+		return [...workflowsById.values()];
+	}
+};
+
+//#endregion
+//#region src/infrastructure/logging/LogLevelPolicy.ts
+const levelRank = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+const globRegexMetaChars = /* @__PURE__ */ new Set("\\^$+?()[]{}|.");
+/**
+* Minimum log level for @codemation/host loggers.
+* - `CODEMATION_LOG_LEVEL` overrides when set to a known level (for namespaces not matched by `codemation.config` log rules).
+* - Under Vitest, defaults to **warn** so routine `info`/`debug` noise stays off the terminal; `warn`/`error` still print.
+* - Otherwise defaults to **info**.
+*
+* When {@link applyCodemationLogConfig} is set, the first matching rule wins per namespace; unmatched namespaces use env defaults.
+*
+* Resolve a shared instance via {@link LogLevelPolicyFactory} (DI or `logLevelPolicyFactory`).
+*/
+var LogLevelPolicy = class {
+	cachedMin;
+	codemationRules = null;
+	resolveMin() {
+		const raw = process.env.CODEMATION_LOG_LEVEL?.toLowerCase();
+		if (raw === "silent" || raw === "debug" || raw === "info" || raw === "warn" || raw === "error") return raw;
+		if (process.env.VITEST === "true") return "warn";
+		return "info";
+	}
+	minLevelCached() {
+		if (this.cachedMin === void 0) this.cachedMin = this.resolveMin();
+		return this.cachedMin;
+	}
+	resetForTests() {
+		this.cachedMin = void 0;
+		this.codemationRules = null;
+	}
+	/**
+	* Applies `codemation.config` log rules. Pass `undefined` to clear rules and use env-only behavior.
+	*/
+	applyCodemationLogConfig(config) {
+		this.codemationRules = null;
+		if (!config) return;
+		const rawRules = this.normalizeCodemationRules(config);
+		if (rawRules.length === 0) return;
+		const compiled = [];
+		for (const rule of rawRules) {
+			const minLevel = this.parseRuleLevel(rule.level);
+			const patterns = this.normalizeFilterPatterns(rule.filter);
+			if (patterns.length === 0) throw new Error("codemation.config log rule filter must include at least one pattern");
+			const matchers = patterns.map((pattern) => this.compileGlobPattern(pattern));
+			compiled.push({
+				matchers,
+				minLevel
+			});
+		}
+		this.codemationRules = compiled;
+	}
+	shouldEmit(level, namespace) {
+		if (this.codemationRules && this.codemationRules.length > 0) {
+			for (const rule of this.codemationRules) if (rule.matchers.some((regex) => regex.test(namespace))) return this.levelPassesAgainstMin(level, rule.minLevel);
+		}
+		return this.levelPassesAgainstMin(level, this.minLevelCached());
+	}
+	normalizeCodemationRules(config) {
+		if ("rules" in config && Array.isArray(config.rules)) return [...config.rules];
+		return [config];
+	}
+	normalizeFilterPatterns(filter) {
+		if (typeof filter === "string") return [filter];
+		return [...filter];
+	}
+	/**
+	* Glob: only `*` is special (matches any substring). A lone `*` matches all namespaces.
+	*/
+	compileGlobPattern(pattern) {
+		const trimmed = pattern.trim();
+		if (trimmed === "*") return /^.*$/;
+		let body = "";
+		for (const ch of trimmed) {
+			if (ch === "*") {
+				body += ".*";
+				continue;
+			}
+			if (globRegexMetaChars.has(ch)) {
+				body += "\\" + ch;
+				continue;
+			}
+			body += ch;
+		}
+		return /* @__PURE__ */ new RegExp("^" + body + "$");
+	}
+	parseRuleLevel(level) {
+		const normalized = level.toLowerCase();
+		if (normalized === "silent" || normalized === "debug" || normalized === "info" || normalized === "warn" || normalized === "error") return normalized;
+		throw new Error(`Invalid codemation.config log level: ${level}`);
+	}
+	levelPassesAgainstMin(level, min) {
+		if (min === "silent") return false;
+		return levelRank[level] >= levelRank[min];
+	}
+};
+
+//#endregion
+//#region src/infrastructure/logging/LogLevelPolicyFactory.ts
+/**
+* Process-wide {@link LogLevelPolicy} singleton for server and browser loggers.
+* Plain class (no `@injectable` from `@codemation/core`): client components import this file; decorating would pull core into the browser bundle.
+*/
+var LogLevelPolicyFactory = class {
+	policy = new LogLevelPolicy();
+	create() {
+		return this.policy;
+	}
+};
+/** Shared factory for call sites outside the DI container (e.g. next-host bootstrap). */
+const logLevelPolicyFactory = new LogLevelPolicyFactory();
+
+//#endregion
+//#region src/infrastructure/logging/FilteringLogger.ts
+var FilteringLogger = class {
+	constructor(inner, scope, filter) {
+		this.inner = inner;
+		this.scope = scope;
+		this.filter = filter;
+	}
+	info(message, exception) {
+		if (!this.filter({
+			scope: this.scope,
+			level: "info",
+			message
+		})) return;
+		this.inner.info(message, exception);
+	}
+	warn(message, exception) {
+		if (!this.filter({
+			scope: this.scope,
+			level: "warn",
+			message
+		})) return;
+		this.inner.warn(message, exception);
+	}
+	error(message, exception) {
+		if (!this.filter({
+			scope: this.scope,
+			level: "error",
+			message
+		})) return;
+		this.inner.error(message, exception);
+	}
+	debug(message, exception) {
+		if (!this.filter({
+			scope: this.scope,
+			level: "debug",
+			message
+		})) return;
+		this.inner.debug(message, exception);
+	}
+};
+
+//#endregion
+//#region src/infrastructure/logging/PerformanceLogPolicy.ts
+/**
+* Opt-in detailed timing / diagnostics lines (used with `ServerLoggerFactory#createPerformanceDiagnostics`).
+*
+* Set `CODEMATION_PERFORMANCE_LOGGING=true` to enable. Otherwise those loggers are silent regardless of level.
+*/
+var PerformanceLogPolicy = class {
+	shouldEmitDetailedTiming() {
+		return process.env.CODEMATION_PERFORMANCE_LOGGING === "true";
+	}
+};
+
+//#endregion
+//#region src/infrastructure/logging/PerformanceLogPolicyFactory.ts
+/**
+* Process-wide {@link PerformanceLogPolicy} singleton (same pattern as {@link LogLevelPolicyFactory}).
+*/
+var PerformanceLogPolicyFactory = class {
+	policy = new PerformanceLogPolicy();
+	create() {
+		return this.policy;
+	}
+};
+const performanceLogPolicyFactory = new PerformanceLogPolicyFactory();
+
+//#endregion
+//#region src/infrastructure/logging/ServerLoggerFactory.ts
+var _ref;
+let ServerLoggerFactory = class ServerLoggerFactory$1 {
+	constructor(logLevelPolicyFactory$1) {
+		this.logLevelPolicyFactory = logLevelPolicyFactory$1;
+	}
+	create(scope) {
+		return new ConsoleLogger(scope, this.logLevelPolicyFactory.create());
+	}
+	createFiltered(scope, filter) {
+		return new FilteringLogger(this.create(scope), scope, filter);
+	}
+	createPerformanceDiagnostics(scope) {
+		return this.createFiltered(scope, (_entry) => performanceLogPolicyFactory.create().shouldEmitDetailedTiming());
+	}
+};
+ServerLoggerFactory = __decorate([
+	injectable(),
+	__decorateParam(0, inject(LogLevelPolicyFactory)),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof LogLevelPolicyFactory !== "undefined" && LogLevelPolicyFactory) === "function" ? _ref : Object])
+], ServerLoggerFactory);
+
+//#endregion
+export { FilteringLogger as a, CodemationConfigNormalizer as c, PerformanceLogPolicy as i, PerformanceLogPolicyFactory as n, LogLevelPolicyFactory as o, performanceLogPolicyFactory as r, logLevelPolicyFactory as s, ServerLoggerFactory as t };
+//# sourceMappingURL=ServerLoggerFactory-BRHxIDS7.js.map

package/dist/ServerLoggerFactory-BRHxIDS7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerLoggerFactory-BRHxIDS7.js","names":["containerRegistrations: Array<CodemationContainerRegistration<unknown>>","credentialTypes: Array<AnyCredentialType>","workflows: Array<WorkflowDefinition>","workflowDirectories: Array<string>","levelRank: Record<Exclude<LogLevel, \"silent\">, number>","compiled: { matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }[]","inner: Logger","scope: string","filter: LogFilter","ServerLoggerFactory","logLevelPolicyFactory: LogLevelPolicyFactory","ServerLogger"],"sources":["../src/presentation/config/CodemationConfigNormalizer.ts","../src/infrastructure/logging/LogLevelPolicy.ts","../src/infrastructure/logging/LogLevelPolicyFactory.ts","../src/infrastructure/logging/FilteringLogger.ts","../src/infrastructure/logging/PerformanceLogPolicy.ts","../src/infrastructure/logging/PerformanceLogPolicyFactory.ts","../src/infrastructure/logging/ServerLoggerFactory.ts"],"sourcesContent":["import type { AnyCredentialType, Container, TypeToken, WorkflowDefinition } from \"@codemation/core\";\nimport type { CodemationContainerRegistration } from \"../../bootstrap/CodemationContainerRegistration\";\nimport type { CodemationAppContext } from \"./CodemationAppContext\";\nimport type { CodemationClassToken } from \"./CodemationClassToken\";\nimport type {\n  CodemationApplicationRuntimeConfig,\n  CodemationConfig,\n  CodemationDatabaseConfig,\n  CodemationEventBusConfig,\n  CodemationSchedulerConfig,\n} from \"./CodemationConfig\";\n\nexport type NormalizedCodemationConfig = CodemationConfig &\n  Readonly<{\n    containerRegistrations: ReadonlyArray<CodemationContainerRegistration<unknown>>;\n  }>;\n\nexport class CodemationConfigNormalizer {\n  normalize(config: CodemationConfig): NormalizedCodemationConfig {\n    const collected = this.collectRegistration(config);\n    const normalizedRuntime = this.normalizeRuntimeConfig(config);\n    const normalizedWorkflowDiscoveryDirectories = [\n      ...(config.workflowDiscovery?.directories ?? []),\n      ...collected.workflowDirectories,\n    ];\n\n    return {\n      ...config,\n      auth: config.app?.auth ?? config.auth,\n      containerRegistrations: collected.containerRegistrations,\n      credentialTypes: [...(config.credentialTypes ?? []), ...collected.credentialTypes],\n      log: config.app?.log ?? config.log,\n      runtime: normalizedRuntime,\n      whitelabel: config.app?.whitelabel ?? config.whitelabel,\n      workflowDiscovery:\n        normalizedWorkflowDiscoveryDirectories.length > 0\n          ? { directories: normalizedWorkflowDiscoveryDirectories }\n          : config.workflowDiscovery,\n      workflows: this.mergeWorkflows(config.workflows ?? [], collected.workflows),\n    };\n  }\n\n  private collectRegistration(config: CodemationConfig): Readonly<{\n    containerRegistrations: ReadonlyArray<CodemationContainerRegistration<unknown>>;\n    credentialTypes: ReadonlyArray<AnyCredentialType>;\n    workflows: ReadonlyArray<WorkflowDefinition>;\n    workflowDirectories: ReadonlyArray<string>;\n  }> {\n    if (!config.register) {\n      return {\n        containerRegistrations: [],\n        credentialTypes: [],\n        workflows: [],\n        workflowDirectories: [],\n      };\n    }\n\n    const containerRegistrations: Array<CodemationContainerRegistration<unknown>> = [];\n    const credentialTypes: Array<AnyCredentialType> = [];\n    const workflows: Array<WorkflowDefinition> = [];\n    const workflowDirectories: Array<string> = [];\n\n    const context: CodemationAppContext = {\n      registerCredentialType(type) {\n        credentialTypes.push(type);\n      },\n      registerNode<TValue>(token: TypeToken<TValue>, implementation?: CodemationClassToken<TValue>) {\n        containerRegistrations.push({\n          token,\n          useClass: implementation ?? (token as CodemationClassToken<TValue>),\n        });\n      },\n      registerValue<TValue>(token: TypeToken<TValue>, value: TValue) {\n        containerRegistrations.push({ token, useValue: value });\n      },\n      registerClass<TValue>(token: TypeToken<TValue>, implementation: CodemationClassToken<TValue>) {\n        containerRegistrations.push({ token, useClass: implementation });\n      },\n      registerFactory<TValue>(token: TypeToken<TValue>, factory: (container: Container) => TValue) {\n        containerRegistrations.push({ token, useFactory: factory });\n      },\n      registerWorkflow(workflow: WorkflowDefinition) {\n        workflows.push(workflow);\n      },\n      registerWorkflows(nextWorkflows: ReadonlyArray<WorkflowDefinition>) {\n        workflows.push(...nextWorkflows);\n      },\n      discoverWorkflows(...directories: ReadonlyArray<string>) {\n        workflowDirectories.push(...directories);\n      },\n    };\n\n    config.register(context);\n\n    return {\n      containerRegistrations,\n      credentialTypes,\n      workflows,\n      workflowDirectories,\n    };\n  }\n\n  private normalizeRuntimeConfig(config: CodemationConfig): CodemationApplicationRuntimeConfig | undefined {\n    if (!config.app) {\n      return config.runtime;\n    }\n    const nextRuntime: CodemationApplicationRuntimeConfig = {\n      ...(config.runtime ?? {}),\n      frontendPort: config.app.frontendPort ?? config.runtime?.frontendPort,\n      database: this.normalizeDatabaseConfig(config),\n      eventBus: this.normalizeEventBusConfig(config),\n      scheduler: this.normalizeSchedulerConfig(config),\n      engineExecutionLimits: config.app.engineExecutionLimits ?? config.runtime?.engineExecutionLimits,\n    };\n    return nextRuntime;\n  }\n\n  private normalizeDatabaseConfig(config: CodemationConfig): CodemationDatabaseConfig | undefined {\n    if (!config.app) {\n      return config.runtime?.database;\n    }\n    if (config.app.database) {\n      return config.app.database;\n    }\n    if (!config.app.databaseUrl) {\n      return config.runtime?.database;\n    }\n    return {\n      ...(config.runtime?.database ?? {}),\n      url: config.app.databaseUrl,\n    };\n  }\n\n  private normalizeSchedulerConfig(config: CodemationConfig): CodemationSchedulerConfig | undefined {\n    if (!config.app?.scheduler) {\n      return config.runtime?.scheduler;\n    }\n    const scheduler = config.app.scheduler;\n    return {\n      ...(config.runtime?.scheduler ?? {}),\n      kind:\n        scheduler.kind === \"queue\" ? \"bullmq\" : scheduler.kind === \"inline\" ? \"local\" : config.runtime?.scheduler?.kind,\n      queuePrefix: scheduler.queuePrefix ?? config.runtime?.scheduler?.queuePrefix,\n      workerQueues: scheduler.workerQueues ?? config.runtime?.scheduler?.workerQueues,\n    };\n  }\n\n  private normalizeEventBusConfig(config: CodemationConfig): CodemationEventBusConfig | undefined {\n    if (!config.app?.scheduler) {\n      return config.runtime?.eventBus;\n    }\n    const scheduler = config.app.scheduler;\n    const eventBusKind =\n      scheduler.kind === \"queue\" ? \"redis\" : scheduler.kind === \"inline\" ? \"memory\" : config.runtime?.eventBus?.kind;\n    return {\n      ...(config.runtime?.eventBus ?? {}),\n      kind: eventBusKind,\n      queuePrefix: scheduler.queuePrefix ?? config.runtime?.eventBus?.queuePrefix,\n      redisUrl: scheduler.redisUrl ?? config.runtime?.eventBus?.redisUrl,\n    };\n  }\n\n  private mergeWorkflows(\n    configuredWorkflows: ReadonlyArray<WorkflowDefinition>,\n    registeredWorkflows: ReadonlyArray<WorkflowDefinition>,\n  ): ReadonlyArray<WorkflowDefinition> | undefined {\n    if (configuredWorkflows.length === 0 && registeredWorkflows.length === 0) {\n      return undefined;\n    }\n    const workflowsById = new Map<string, WorkflowDefinition>();\n    for (const workflow of registeredWorkflows) {\n      workflowsById.set(workflow.id, workflow);\n    }\n    for (const workflow of configuredWorkflows) {\n      workflowsById.set(workflow.id, workflow);\n    }\n    return [...workflowsById.values()];\n  }\n}\n","import type { CodemationLogConfig, CodemationLogRule } from \"../../presentation/config/CodemationLogConfig\";\n\nexport type LogLevel = \"silent\" | \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst levelRank: Record<Exclude<LogLevel, \"silent\">, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nconst globRegexMetaChars = new Set(\"\\\\^$+?()[]{}|.\");\n\n/**\n * Minimum log level for @codemation/host loggers.\n * - `CODEMATION_LOG_LEVEL` overrides when set to a known level (for namespaces not matched by `codemation.config` log rules).\n * - Under Vitest, defaults to **warn** so routine `info`/`debug` noise stays off the terminal; `warn`/`error` still print.\n * - Otherwise defaults to **info**.\n *\n * When {@link applyCodemationLogConfig} is set, the first matching rule wins per namespace; unmatched namespaces use env defaults.\n *\n * Resolve a shared instance via {@link LogLevelPolicyFactory} (DI or `logLevelPolicyFactory`).\n */\nexport class LogLevelPolicy {\n  private cachedMin: LogLevel | undefined;\n\n  private codemationRules: ReadonlyArray<{ matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }> | null = null;\n\n  resolveMin(): LogLevel {\n    const raw = process.env.CODEMATION_LOG_LEVEL?.toLowerCase();\n    if (raw === \"silent\" || raw === \"debug\" || raw === \"info\" || raw === \"warn\" || raw === \"error\") {\n      return raw;\n    }\n    if (process.env.VITEST === \"true\") {\n      return \"warn\";\n    }\n    return \"info\";\n  }\n\n  private minLevelCached(): LogLevel {\n    if (this.cachedMin === undefined) {\n      this.cachedMin = this.resolveMin();\n    }\n    return this.cachedMin;\n  }\n\n  resetForTests(): void {\n    this.cachedMin = undefined;\n    this.codemationRules = null;\n  }\n\n  /**\n   * Applies `codemation.config` log rules. Pass `undefined` to clear rules and use env-only behavior.\n   */\n  applyCodemationLogConfig(config: CodemationLogConfig | undefined): void {\n    this.codemationRules = null;\n    if (!config) {\n      return;\n    }\n    const rawRules = this.normalizeCodemationRules(config);\n    if (rawRules.length === 0) {\n      return;\n    }\n    const compiled: { matchers: ReadonlyArray<RegExp>; minLevel: LogLevel }[] = [];\n    for (const rule of rawRules) {\n      const minLevel = this.parseRuleLevel(rule.level);\n      const patterns = this.normalizeFilterPatterns(rule.filter);\n      if (patterns.length === 0) {\n        throw new Error(\"codemation.config log rule filter must include at least one pattern\");\n      }\n      const matchers = patterns.map((pattern) => this.compileGlobPattern(pattern));\n      compiled.push({\n        matchers,\n        minLevel,\n      });\n    }\n    this.codemationRules = compiled;\n  }\n\n  shouldEmit(level: Exclude<LogLevel, \"silent\">, namespace: string): boolean {\n    if (this.codemationRules && this.codemationRules.length > 0) {\n      for (const rule of this.codemationRules) {\n        if (rule.matchers.some((regex) => regex.test(namespace))) {\n          return this.levelPassesAgainstMin(level, rule.minLevel);\n        }\n      }\n    }\n    return this.levelPassesAgainstMin(level, this.minLevelCached());\n  }\n\n  private normalizeCodemationRules(config: CodemationLogConfig): ReadonlyArray<CodemationLogRule> {\n    if (\"rules\" in config && Array.isArray(config.rules)) {\n      return [...config.rules];\n    }\n    return [config as CodemationLogRule];\n  }\n\n  private normalizeFilterPatterns(filter: string | ReadonlyArray<string>): ReadonlyArray<string> {\n    if (typeof filter === \"string\") {\n      return [filter];\n    }\n    return [...filter];\n  }\n\n  /**\n   * Glob: only `*` is special (matches any substring). A lone `*` matches all namespaces.\n   */\n  private compileGlobPattern(pattern: string): RegExp {\n    const trimmed = pattern.trim();\n    if (trimmed === \"*\") {\n      return /^.*$/;\n    }\n    let body = \"\";\n    for (const ch of trimmed) {\n      if (ch === \"*\") {\n        body += \".*\";\n        continue;\n      }\n      if (globRegexMetaChars.has(ch)) {\n        body += \"\\\\\" + ch;\n        continue;\n      }\n      body += ch;\n    }\n    return new RegExp(\"^\" + body + \"$\");\n  }\n\n  private parseRuleLevel(level: string): LogLevel {\n    const normalized = level.toLowerCase();\n    if (\n      normalized === \"silent\" ||\n      normalized === \"debug\" ||\n      normalized === \"info\" ||\n      normalized === \"warn\" ||\n      normalized === \"error\"\n    ) {\n      return normalized;\n    }\n    throw new Error(`Invalid codemation.config log level: ${level}`);\n  }\n\n  private levelPassesAgainstMin(level: Exclude<LogLevel, \"silent\">, min: LogLevel): boolean {\n    if (min === \"silent\") {\n      return false;\n    }\n    return levelRank[level] >= levelRank[min];\n  }\n}\n","import { LogLevelPolicy } from \"./LogLevelPolicy\";\n\n/**\n * Process-wide {@link LogLevelPolicy} singleton for server and browser loggers.\n * Plain class (no `@injectable` from `@codemation/core`): client components import this file; decorating would pull core into the browser bundle.\n */\nexport class LogLevelPolicyFactory {\n  private readonly policy = new LogLevelPolicy();\n\n  create(): LogLevelPolicy {\n    return this.policy;\n  }\n}\n\n/** Shared factory for call sites outside the DI container (e.g. next-host bootstrap). */\nexport const logLevelPolicyFactory = new LogLevelPolicyFactory();\n","import type { LogFilter } from \"../../application/logging/LogFilter\";\nimport type { Logger } from \"../../application/logging/Logger\";\n\nexport class FilteringLogger implements Logger {\n  constructor(\n    private readonly inner: Logger,\n    private readonly scope: string,\n    private readonly filter: LogFilter,\n  ) {}\n\n  info(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"info\", message })) {\n      return;\n    }\n    this.inner.info(message, exception);\n  }\n\n  warn(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"warn\", message })) {\n      return;\n    }\n    this.inner.warn(message, exception);\n  }\n\n  error(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"error\", message })) {\n      return;\n    }\n    this.inner.error(message, exception);\n  }\n\n  debug(message: string, exception?: Error): void {\n    if (!this.filter({ scope: this.scope, level: \"debug\", message })) {\n      return;\n    }\n    this.inner.debug(message, exception);\n  }\n}\n","/**\n * Opt-in detailed timing / diagnostics lines (used with `ServerLoggerFactory#createPerformanceDiagnostics`).\n *\n * Set `CODEMATION_PERFORMANCE_LOGGING=true` to enable. Otherwise those loggers are silent regardless of level.\n */\nexport class PerformanceLogPolicy {\n  shouldEmitDetailedTiming(): boolean {\n    return process.env.CODEMATION_PERFORMANCE_LOGGING === \"true\";\n  }\n}\n","import { PerformanceLogPolicy } from \"./PerformanceLogPolicy\";\n\n/**\n * Process-wide {@link PerformanceLogPolicy} singleton (same pattern as {@link LogLevelPolicyFactory}).\n */\nexport class PerformanceLogPolicyFactory {\n  private readonly policy = new PerformanceLogPolicy();\n\n  create(): PerformanceLogPolicy {\n    return this.policy;\n  }\n}\n\nexport const performanceLogPolicyFactory = new PerformanceLogPolicyFactory();\n","import { inject, injectable } from \"@codemation/core\";\n\nimport type { LogFilter } from \"../../application/logging/LogFilter\";\nimport type { Logger, LoggerFactory } from \"../../application/logging/Logger\";\n\nimport { FilteringLogger } from \"./FilteringLogger\";\nimport { LogLevelPolicyFactory } from \"./LogLevelPolicyFactory\";\nimport { performanceLogPolicyFactory } from \"./PerformanceLogPolicyFactory\";\nimport { ServerLogger } from \"./ServerLogger\";\n\n@injectable()\nexport class ServerLoggerFactory implements LoggerFactory {\n  constructor(@inject(LogLevelPolicyFactory) private readonly logLevelPolicyFactory: LogLevelPolicyFactory) {}\n\n  create(scope: string): Logger {\n    return new ServerLogger(scope, this.logLevelPolicyFactory.create());\n  }\n\n  createFiltered(scope: string, filter: LogFilter): Logger {\n    return new FilteringLogger(this.create(scope), scope, filter);\n  }\n\n  createPerformanceDiagnostics(scope: string): Logger {\n    return this.createFiltered(scope, (_entry) => performanceLogPolicyFactory.create().shouldEmitDetailedTiming());\n  }\n}\n\nexport { ServerLogger } from \"./ServerLogger\";\n"],"mappings":"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"}

package/dist/WorkflowViewContracts-DCLpTn25.d.ts

@@ -0,0 +1,47 @@
+//#region src/application/contracts/WorkflowViewContracts.d.ts
+type WorkflowNodeDto = Readonly<{
+  id: string;
+  kind: string;
+  name?: string;
+  type: string;
+  role?: string;
+  icon?: string;
+  parentNodeId?: string;
+  /** Short retry policy label for canvas/properties (e.g. fixed / exponential). */
+  retryPolicySummary?: string;
+  /** Whether this node declares a node-level error handler. */
+  hasNodeErrorHandler?: boolean;
+  /** When true, downstream nodes may run even when this node outputs zero items. */
+  continueWhenEmptyOutput?: boolean;
+}>;
+type WorkflowEdgeDto = Readonly<{
+  from: Readonly<{
+    nodeId: string;
+    output: string;
+  }>;
+  to: Readonly<{
+    nodeId: string;
+    input: string;
+  }>;
+}>;
+type WorkflowDto = Readonly<{
+  id: string;
+  name: string;
+  /** When true, trigger setup runs and webhooks are registered for this workflow. */
+  active: boolean;
+  nodes: ReadonlyArray<WorkflowNodeDto>;
+  edges: ReadonlyArray<WorkflowEdgeDto>;
+  /** Workflow-level error hook configured on the definition. */
+  hasWorkflowErrorHandler?: boolean;
+}>;
+type WorkflowSummary = Readonly<{
+  id: string;
+  name: string;
+  /** When true, trigger setup runs and webhooks are registered for this workflow. */
+  active: boolean;
+  /** Path under workflow discovery root: folders + workflow file stem. */
+  discoveryPathSegments: readonly string[];
+}>;
+//#endregion
+export { WorkflowSummary as n, WorkflowDto as t };
+//# sourceMappingURL=WorkflowViewContracts-DCLpTn25.d.ts.map

package/dist/chunk-7V6ThxGB.js

@@ -0,0 +1,39 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (all) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __toESM as i, __export as n, __require as r, __commonJS as t };