@codemation/host 0.6.0 → 0.8.0

package/dist/{ItemsInputNormalizer-C-KHg9Mo.d.ts → ItemsInputNormalizer-_RwIfRIQ.d.ts}

@@ -262,6 +262,11 @@ interface PersistedWorkflowSnapshotNode {
   tokenName?: string;
   configTokenName?: string;
   config: unknown;
+  /** Pre-computed static configuration summary; populated by WorkflowSnapshotCodec. */
+  inspectorSummary?: ReadonlyArray<Readonly<{
+    label: string;
+    value: string;
+  }>>;
 }
 interface PersistedWorkflowSnapshot {
   id: WorkflowId;
@@ -340,6 +345,10 @@ interface ConnectionInvocationRecord {
   readonly status: NodeExecutionStatus;
   readonly managedInput?: JsonValue;
   readonly managedOutput?: JsonValue;
+  /** Short human-readable description of what this invocation is doing right now (e.g. `"calling search_messages"`). Rendered as a sub-line on the canvas node card. */
+  readonly statusLabel?: string;
+  /** Stable identifier for the thing this invocation acts on (e.g. an MCP tool name like `"search_messages"`). Persists across status transitions so the inspector can show it on completed/failed entries too. Connection nodes that ARE the tool (e.g. node-backed agent tools) leave this unset — the parent node id already identifies the subject. */
+  readonly subjectName?: string;
   readonly error?: NodeExecutionError;
   readonly queuedAt?: string;
   readonly startedAt?: string;
@@ -361,6 +370,8 @@ type ConnectionInvocationAppendArgs = Readonly<{
   status: NodeExecutionStatus;
   managedInput?: JsonValue;
   managedOutput?: JsonValue;
+  statusLabel?: string;
+  subjectName?: string;
   error?: NodeExecutionError;
   queuedAt?: string;
   startedAt?: string;
@@ -619,6 +630,26 @@ interface NodeConfigBase {
    * configs (e.g. `AssertionNodeConfig`, `StringEqualsAssertionNodeConfig`).
    */
   readonly emitsAssertions?: true;
+  /**
+   * Static configuration summary surfaced in the workflow inspector — the design-time
+   * "what does this node do" panel that renders before any run telemetry exists.
+   *
+   * Return 2–6 short label/value pairs derived from this config (method + url for an HTTP
+   * call, model + tool list for an agent, schedule + timezone for a cron trigger, etc.).
+   * Values are truncated by the UI; aim for one line each. Return `undefined` to opt out
+   * — the inspector hides the section when no rows are produced.
+   *
+   * Implement on the config class instance so the function can read sibling config fields.
+   * `defineNode({ inspectorSummary })` plumbs through to this.
+   */
+  inspectorSummary?(): ReadonlyArray<NodeInspectorSummaryRow> | undefined;
+}
+/**
+ * One row of a node's static configuration summary. See {@link NodeConfigBase.inspectorSummary}.
+ */
+interface NodeInspectorSummaryRow {
+  readonly label: string;
+  readonly value: string;
 }
 declare const runnableNodeInputType: unique symbol;
 declare const runnableNodeOutputType: unique symbol;
@@ -796,6 +827,29 @@ type NodeErrorHandlerSpec = TypeToken<NodeErrorHandler> | NodeErrorHandler;
  */
 type TestSuiteRunId = string;
 //#endregion
+//#region ../core/src/contracts/CostTrackingTelemetryContract.d.ts
+type CostTrackingComponent = "chat" | "ocr" | "rag";
+interface CostTrackingUsageRecord {
+  readonly component: CostTrackingComponent;
+  readonly provider: string;
+  readonly operation: string;
+  readonly pricingKey: string;
+  readonly usageUnit: string;
+  readonly quantity: number;
+  readonly modelName?: string;
+  readonly attributes?: TelemetryAttributes;
+}
+interface CostTrackingPriceQuote {
+  readonly currency: string;
+  readonly currencyScale: number;
+  readonly estimatedAmountMinor: number;
+  readonly estimateKind: "catalog";
+}
+interface CostTrackingTelemetry {
+  captureUsage(args: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
+  forScope(scope: TelemetryScope): CostTrackingTelemetry;
+}
+//#endregion
 //#region ../core/src/contracts/telemetryTypes.d.ts
 type TelemetryAttributePrimitive = string | number | boolean | null;
 interface TelemetryAttributes {
@@ -876,29 +930,6 @@ interface ExecutionTelemetry extends TelemetryScope {
   }>): NodeExecutionTelemetry;
 }
 //#endregion
-//#region ../core/src/contracts/CostTrackingTelemetryContract.d.ts
-type CostTrackingComponent = "chat" | "ocr" | "rag";
-interface CostTrackingUsageRecord {
-  readonly component: CostTrackingComponent;
-  readonly provider: string;
-  readonly operation: string;
-  readonly pricingKey: string;
-  readonly usageUnit: string;
-  readonly quantity: number;
-  readonly modelName?: string;
-  readonly attributes?: TelemetryAttributes;
-}
-interface CostTrackingPriceQuote {
-  readonly currency: string;
-  readonly currencyScale: number;
-  readonly estimatedAmountMinor: number;
-  readonly estimateKind: "catalog";
-}
-interface CostTrackingTelemetry {
-  captureUsage(args: CostTrackingUsageRecord): Promise<CostTrackingPriceQuote | undefined>;
-  forScope(scope: TelemetryScope): CostTrackingTelemetry;
-}
-//#endregion
 //#region ../core/src/contracts/executionPersistenceContracts.d.ts
 /** Canonical id for persisted execution rows (activation or connection invocation). */
 type ExecutionInstanceId = string;
@@ -1016,6 +1047,35 @@ interface WebhookTriggerMatcher {
   reloadWebhookRoutes?(): void;
 }
 //#endregion
+//#region ../core/src/contracts/mcpTypes.d.ts
+type McpServerTransport = "http";
+interface McpServerDeclaration {
+  /** Globally unique slug, e.g. "gmail". Workflow authors reference this. */
+  id: string;
+  displayName: string;
+  description: string;
+  transport: McpServerTransport;
+  url: string;
+  /**
+   * Credential types accepted by this MCP server, matching CredentialRequirement.acceptedTypes.
+   * Absent or empty means no credential is required.
+   */
+  acceptedCredentialTypes?: ReadonlyArray<string>;
+  /**
+   * Documentation only in MVP. The bind-time validator checks
+   * requiredScopes ⊆ CredentialInstance.scopesGranted.
+   */
+  requiredScopes?: string[];
+  /** Non-secret static headers merged onto every MCP request. */
+  staticHeaders?: Record<string, string>;
+  /**
+   * Overrides for tool descriptions advertised by the MCP server.
+   * Applied by the connection pool after tools/list.
+   * Key: exact tool name as returned by the server.
+   */
+  toolDescriptionOverrides?: Record<string, string>;
+}
+//#endregion
 //#region ../core/src/contracts/collectionTypes.d.ts
 /**
  * Represents a typed store for a single collection.
@@ -1347,6 +1407,10 @@ interface BinaryStorage {
   openReadStream(storageKey: string): Promise<BinaryStorageReadResult | undefined>;
   stat(storageKey: string): Promise<BinaryStorageStatResult>;
   delete(storageKey: string): Promise<void>;
+  /** Deletes multiple objects in bulk. Keys are batched internally. */
+  deleteMany(storageKeys: ReadonlyArray<string>): Promise<void>;
+  /** Lists all keys sharing a common prefix. Returns keys in arbitrary order. */
+  listByPrefix(prefix: string): Promise<ReadonlyArray<string>>;
 }
 interface BinaryAttachmentCreateRequest {
   name: string;
@@ -1569,5 +1633,5 @@ interface ChatModelFactory<TConfig extends ChatModelConfig = ChatModelConfig> {
   }>): Promise<ChatLanguageModel> | ChatLanguageModel;
 }
 //#endregion
-export { RunCurrentState as $, TelemetryArtifactAttachment as A, NodeDefinition as B, AnyRunnableNodeConfig as C, CredentialTypeDefinition as Ct, WebhookTriggerMatcher as D, WorkflowId as Dt, WebhookInvocationMatch as E, NodeId as Et, BinaryAttachment as F, RunIdFactory as G, ParentExecutionRef as H, Item as I, WorkflowDefinition as J, RunnableNodeConfig as K, Items as L, TelemetryMetricRecord as M, TelemetrySpanEventRecord as N, WebhookTriggerResolution as O, ActivationIdFactory as P, PersistedWorkflowTokenRegistryLike as Q, JsonValue as R, ChainCursor as S, CredentialType as St, HttpMethod as T, CredentialTypeRegistry as Tt, PersistedRunPolicySnapshot as U, NodeOutputs as V, RunId as W, NodeInputsByPort as X, CurrentStateExecutionRequest as Y, PersistedRunState as Z, EngineExecutionLimitsPolicyConfig as _, CredentialOAuth2AuthDefinition as _t, ParamDeep as a, RunSummary as at, TestCaseRunStatus as b, CredentialSessionService as bt, NodeActivationContinuation as c, AnyCredentialType as ct, NodeExecutionRequestHandler as d, CredentialFieldSchema as dt, RunExecutionOptions as et, NodeExecutionScheduler as f, CredentialHealth as ft, TypeToken as g, CredentialMaterialSourceKind as gt, Container as h, CredentialJsonRecord as ht, ToolConfig as i, RunStopCondition as it, TelemetryAttributes as j, WorkflowRunDetailDto as k, NodeExecutionContext as l, CredentialBinding as lt, WorkflowSnapshotResolver as m, CredentialInstanceRecord as mt, AgentMessageConfig as n, RunResult as nt, BinaryStorage as o, WebhookRunResult as ot, WorkflowRepository as p, CredentialInstanceId as pt, RunnableNodeOutputJson as q, ChatModelConfig as r, RunStatus as rt, LiveWorkflowRepository as s, WorkflowExecutionRepository as st, AgentGuardrailConfig as t, RunPruneCandidate as tt, NodeExecutionRequest as u, CredentialBindingKey as ut, RunEvent as v, CredentialRequirement as vt, WorkflowActivationPolicy as w, CredentialTypeId as wt, TestSuiteRunStatus as x, CredentialSetupStatus as xt, RunEventBus as y, CredentialSessionFactoryArgs as yt, NodeActivationId as z };
-//# sourceMappingURL=ItemsInputNormalizer-C-KHg9Mo.d.ts.map
+export { PersistedRunState as $, WorkflowRunDetailDto as A, NodeActivationId as B, AnyRunnableNodeConfig as C, CredentialSetupStatus as Ct, WebhookInvocationMatch as D, CredentialTypeRegistry as Dt, HttpMethod as E, CredentialTypeId as Et, ActivationIdFactory as F, PersistedRunPolicySnapshot as G, NodeInspectorSummaryRow as H, BinaryAttachment as I, RunnableNodeConfig as J, RunId as K, Item as L, TelemetryAttributes as M, TelemetryMetricRecord as N, WebhookTriggerMatcher as O, NodeId as Ot, TelemetrySpanEventRecord as P, NodeInputsByPort as Q, Items as R, ChainCursor as S, CredentialSessionService as St, McpServerDeclaration as T, CredentialTypeDefinition as Tt, NodeOutputs as U, NodeDefinition as V, ParentExecutionRef as W, WorkflowDefinition as X, RunnableNodeOutputJson as Y, CurrentStateExecutionRequest as Z, EngineExecutionLimitsPolicyConfig as _, CredentialJsonRecord as _t, ParamDeep as a, RunStatus as at, TestCaseRunStatus as b, CredentialRequirement as bt, NodeActivationContinuation as c, WebhookRunResult as ct, NodeExecutionRequestHandler as d, CredentialBinding as dt, PersistedWorkflowTokenRegistryLike as et, NodeExecutionScheduler as f, CredentialBindingKey as ft, TypeToken as g, CredentialInstanceRecord as gt, Container as h, CredentialInstanceId as ht, ToolConfig as i, RunResult as it, TelemetryArtifactAttachment as j, WebhookTriggerResolution as k, WorkflowId as kt, NodeExecutionContext as l, WorkflowExecutionRepository as lt, WorkflowSnapshotResolver as m, CredentialHealth as mt, AgentMessageConfig as n, RunExecutionOptions as nt, BinaryStorage as o, RunStopCondition as ot, WorkflowRepository as p, CredentialFieldSchema as pt, RunIdFactory as q, ChatModelConfig as r, RunPruneCandidate as rt, LiveWorkflowRepository as s, RunSummary as st, AgentGuardrailConfig as t, RunCurrentState as tt, NodeExecutionRequest as u, AnyCredentialType as ut, RunEvent as v, CredentialMaterialSourceKind as vt, WorkflowActivationPolicy as w, CredentialType as wt, TestSuiteRunStatus as x, CredentialSessionFactoryArgs as xt, RunEventBus as y, CredentialOAuth2AuthDefinition as yt, JsonValue as z };
+//# sourceMappingURL=ItemsInputNormalizer-_RwIfRIQ.d.ts.map

package/dist/{LogLevelPolicyFactory-CampWO0l.d.ts → LogLevelPolicyFactory-ewCHLDLn.d.ts}

@@ -1,4 +1,4 @@
-import { n as CodemationLogConfig } from "./CodemationWhitelabelConfig-CWbcyQqn.js";
+import { n as CodemationLogConfig } from "./CodemationWhitelabelConfig-Ca2mCUeC.js";
 
 //#region src/infrastructure/logging/LogLevelPolicy.d.ts
 type LogLevel = "silent" | "debug" | "info" | "warn" | "error";
@@ -46,4 +46,4 @@ declare class LogLevelPolicyFactory {
 declare const logLevelPolicyFactory: LogLevelPolicyFactory;
 //#endregion
 export { LogLevelPolicy as i, logLevelPolicyFactory as n, LogLevel as r, LogLevelPolicyFactory as t };
-//# sourceMappingURL=LogLevelPolicyFactory-CampWO0l.d.ts.map
+//# sourceMappingURL=LogLevelPolicyFactory-ewCHLDLn.d.ts.map

package/dist/{PublicFrontendBootstrap-DzBgwOnG.d.ts → PublicFrontendBootstrap-Cev3qK46.d.ts}

@@ -1,4 +1,4 @@
-import { a as CodemationAuthConfig } from "./CodemationWhitelabelConfig-CWbcyQqn.js";
+import { a as CodemationAuthConfig } from "./CodemationWhitelabelConfig-Ca2mCUeC.js";
 
 //#region src/presentation/frontend/CodemationFrontendAuthSnapshot.d.ts
 type CodemationFrontendAuthProviderSnapshot = Readonly<{
@@ -11,6 +11,11 @@ type CodemationFrontendAuthSnapshot = Readonly<{
   oauthProviders: ReadonlyArray<CodemationFrontendAuthProviderSnapshot>;
   secret: string | null;
   uiAuthEnabled: boolean;
+  /**
+   * Present when auth.kind === "managed". Carries the CP-web origin for CORS
+   * awareness. No UI login flow is rendered in managed mode.
+   */
+  cpWebOrigin?: string;
 }>;
 //#endregion
 //#region src/presentation/frontend/FrontendAppConfig.d.ts
@@ -44,7 +49,9 @@ type PublicFrontendBootstrap = Readonly<{
   oauthProviders: ReadonlyArray<CodemationFrontendAuthProviderSnapshot>;
   productName: string;
   uiAuthEnabled: boolean;
+  /** Present in managed mode — the CP web origin. No UI login is rendered when this is set. */
+  cpWebOrigin?: string;
 }>;
 //#endregion
 export { CodemationFrontendAuthSnapshot as a, CodemationFrontendAuthProviderSnapshot as i, InternalAuthBootstrap as n, FrontendAppConfig as r, PublicFrontendBootstrap as t };
-//# sourceMappingURL=PublicFrontendBootstrap-DzBgwOnG.d.ts.map
+//# sourceMappingURL=PublicFrontendBootstrap-Cev3qK46.d.ts.map

package/dist/PublicFrontendBootstrapFactory-Dv04tJ-6.d.ts

@@ -0,0 +1,82 @@
+import { r as AppConfig } from "./CodemationAppContext-CGFYVcSb.js";
+import { a as CodemationAuthConfig } from "./CodemationWhitelabelConfig-Ca2mCUeC.js";
+import { a as CodemationFrontendAuthSnapshot, n as InternalAuthBootstrap, r as FrontendAppConfig, t as PublicFrontendBootstrap } from "./PublicFrontendBootstrap-Cev3qK46.js";
+import { ChildProcess } from "node:child_process";
+
+//#region src/process/ProcessRunner.types.d.ts
+type ProcessRunOptions = Readonly<{
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+  /**
+   * Mirrors `child_process.SpawnOptions["stdio"]`. The runner forwards the value verbatim to the
+   * underlying subprocess, so callers that need fine-grained per-fd control (e.g.
+   * `["ignore", "pipe", "pipe"]`) can pass a tuple.
+   */
+  stdio?: "inherit" | "pipe" | "ignore" | ReadonlyArray<"inherit" | "pipe" | "ignore">;
+  /**
+   * On Unix this detaches the child from the parent's process group so it becomes the group
+   * leader (used by {@link DevTrackedProcessTreeKiller} to broadcast SIGTERM to descendants).
+   * On Windows it is ignored — `windowsHide` should be used to suppress console windows instead.
+   */
+  detached?: boolean;
+  windowsHide?: boolean;
+}>;
+type ProcessRunResult = Readonly<{
+  exitCode: number | null;
+}>;
+/**
+ * Cross-platform process spawning seam. Implementations resolve bare CLI names (`pnpm`, `prisma`,
+ * `next`, …) against the OS PATH using OS-appropriate executable lookup, so call sites stop having
+ * to remember `pnpm.cmd` or `shell: true` on Windows.
+ *
+ * `spawn` returns a Node `ChildProcess` so existing helpers like `DevNextChildProcessOutputFilter`
+ * and `DevTrackedProcessTreeKiller` keep working unchanged.
+ */
+interface ProcessRunner {
+  /** Long-lived child (dev watcher, Next dev server). Returns a `ChildProcess`. */
+  spawn(command: string, args: ReadonlyArray<string>, options?: ProcessRunOptions): ChildProcess;
+  /** Synchronous one-shot (used by Prisma migrate deploy). */
+  runSync(command: string, args: ReadonlyArray<string>, options?: ProcessRunOptions): ProcessRunResult;
+}
+//#endregion
+//#region src/presentation/frontend/CodemationFrontendAuthSnapshotFactory.d.ts
+declare class CodemationFrontendAuthSnapshotFactory {
+  createFromAppConfig(appConfig: AppConfig): CodemationFrontendAuthSnapshot;
+  createFromResolvedInputs(args: Readonly<{
+    authConfig: CodemationAuthConfig | undefined;
+    env: NodeJS.ProcessEnv;
+    uiAuthEnabled: boolean;
+  }>): CodemationFrontendAuthSnapshot;
+  private resolveUiAuthEnabled;
+  private resolveAuthSecret;
+  private createOauthProviders;
+  private createOAuthProvider;
+  private createOidcProvider;
+  private resolveOAuthProviderName;
+}
+//#endregion
+//#region src/presentation/frontend/FrontendAppConfigFactory.d.ts
+declare class FrontendAppConfigFactory {
+  private readonly appConfig;
+  private readonly authSnapshotFactory;
+  constructor(appConfig: AppConfig, authSnapshotFactory: CodemationFrontendAuthSnapshotFactory);
+  create(): FrontendAppConfig;
+}
+//#endregion
+//#region src/presentation/frontend/InternalAuthBootstrapFactory.d.ts
+declare class InternalAuthBootstrapFactory {
+  private readonly appConfig;
+  private readonly authSnapshotFactory;
+  constructor(appConfig: AppConfig, authSnapshotFactory: CodemationFrontendAuthSnapshotFactory);
+  create(): InternalAuthBootstrap;
+}
+//#endregion
+//#region src/presentation/frontend/PublicFrontendBootstrapFactory.d.ts
+declare class PublicFrontendBootstrapFactory {
+  private readonly frontendAppConfigFactory;
+  constructor(frontendAppConfigFactory: FrontendAppConfigFactory);
+  create(): PublicFrontendBootstrap;
+}
+//#endregion
+export { ProcessRunOptions as a, CodemationFrontendAuthSnapshotFactory as i, InternalAuthBootstrapFactory as n, ProcessRunResult as o, FrontendAppConfigFactory as r, ProcessRunner as s, PublicFrontendBootstrapFactory as t };
+//# sourceMappingURL=PublicFrontendBootstrapFactory-Dv04tJ-6.d.ts.map

package/dist/{PublicFrontendBootstrapJsonCodec-Cl_DLRh0.d.ts → PublicFrontendBootstrapJsonCodec-CXG9Dxft.d.ts}

@@ -1,4 +1,4 @@
-import { a as CodemationFrontendAuthSnapshot, n as InternalAuthBootstrap, r as FrontendAppConfig, t as PublicFrontendBootstrap } from "./PublicFrontendBootstrap-DzBgwOnG.js";
+import { a as CodemationFrontendAuthSnapshot, n as InternalAuthBootstrap, r as FrontendAppConfig, t as PublicFrontendBootstrap } from "./PublicFrontendBootstrap-Cev3qK46.js";
 
 //#region src/presentation/http/ApiPaths.d.ts
 declare class ApiPaths {
@@ -47,9 +47,9 @@ declare class ApiPaths {
   static credentialInstance(instanceId: string, withSecrets?: boolean): string;
   static credentialInstanceTest(instanceId: string): string;
   static credentialBindings(): string;
-  static oauth2Auth(instanceId: string): string;
   static oauth2RedirectUri(): string;
   static oauth2Disconnect(instanceId: string): string;
+  static credentialOAuthStart(): string;
   static workflowWebsocket(): string;
   /** Dev gateway: stable browser WebSocket for build lifecycle (CLI → gateway → browser). */
   static devGatewaySocket(): string;
@@ -116,4 +116,4 @@ declare class PublicFrontendBootstrapJsonCodec {
 }
 //#endregion
 export { ApiPaths as a, CodemationFrontendAuthSnapshotJsonCodec as i, InternalAuthBootstrapJsonCodec as n, FrontendAppConfigJsonCodec as r, PublicFrontendBootstrapJsonCodec as t };
-//# sourceMappingURL=PublicFrontendBootstrapJsonCodec-Cl_DLRh0.d.ts.map
+//# sourceMappingURL=PublicFrontendBootstrapJsonCodec-CXG9Dxft.d.ts.map

package/dist/{PublicFrontendBootstrapJsonCodec-DzqvA0uo.js → PublicFrontendBootstrapJsonCodec-CegIF_ne.js}

@@ -128,13 +128,18 @@ var PublicFrontendBootstrapJsonCodec = class {
 		try {
 			const parsed = JSON.parse(serialized);
 			if (!parsed || typeof parsed !== "object") return null;
-			return {
+			const base = {
 				credentialsEnabled: parsed.credentialsEnabled === true,
 				logoUrl: typeof parsed.logoUrl === "string" && parsed.logoUrl.trim().length > 0 ? parsed.logoUrl : null,
 				oauthProviders: this.resolveOauthProviders(parsed.oauthProviders),
 				productName: typeof parsed.productName === "string" && parsed.productName.trim().length > 0 ? parsed.productName : "Codemation",
 				uiAuthEnabled: parsed.uiAuthEnabled !== false
 			};
+			const cpWebOrigin = typeof parsed.cpWebOrigin === "string" && parsed.cpWebOrigin.trim().length > 0 ? parsed.cpWebOrigin : void 0;
+			return cpWebOrigin ? {
+				...base,
+				cpWebOrigin
+			} : base;
 		} catch {
 			return null;
 		}
@@ -155,4 +160,4 @@ var PublicFrontendBootstrapJsonCodec = class {
 
 //#endregion
 export { CodemationFrontendAuthSnapshotJsonCodec as i, InternalAuthBootstrapJsonCodec as n, FrontendAppConfigJsonCodec as r, PublicFrontendBootstrapJsonCodec as t };
-//# sourceMappingURL=PublicFrontendBootstrapJsonCodec-DzqvA0uo.js.map
+//# sourceMappingURL=PublicFrontendBootstrapJsonCodec-CegIF_ne.js.map

package/dist/PublicFrontendBootstrapJsonCodec-CegIF_ne.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicFrontendBootstrapJsonCodec-CegIF_ne.js","names":["base: PublicFrontendBootstrap"],"sources":["../src/presentation/frontend/CodemationFrontendAuthSnapshotJsonCodec.ts","../src/presentation/frontend/FrontendAppConfigJsonCodec.ts","../src/presentation/frontend/InternalAuthBootstrapJsonCodec.ts","../src/presentation/frontend/PublicFrontendBootstrapJsonCodec.ts"],"sourcesContent":["import type { CodemationAuthConfig } from \"../config/CodemationAuthConfig\";\n\nimport type {\n  CodemationFrontendAuthProviderSnapshot,\n  CodemationFrontendAuthSnapshot,\n} from \"./CodemationFrontendAuthSnapshot\";\n\nexport class CodemationFrontendAuthSnapshotJsonCodec {\n  serialize(snapshot: CodemationFrontendAuthSnapshot): string {\n    return JSON.stringify(snapshot);\n  }\n\n  deserialize(serialized: string | undefined): CodemationFrontendAuthSnapshot | null {\n    if (!serialized || serialized.trim().length === 0) {\n      return null;\n    }\n    try {\n      const parsed = JSON.parse(serialized) as Partial<CodemationFrontendAuthSnapshot> | null;\n      if (!parsed || typeof parsed !== \"object\") {\n        return null;\n      }\n      return {\n        config: this.resolveAuthConfig(parsed.config),\n        credentialsEnabled: parsed.credentialsEnabled === true,\n        oauthProviders: this.resolveOauthProviders(parsed.oauthProviders),\n        secret: typeof parsed.secret === \"string\" && parsed.secret.trim().length > 0 ? parsed.secret : null,\n        uiAuthEnabled: parsed.uiAuthEnabled !== false,\n      };\n    } catch {\n      return null;\n    }\n  }\n\n  private resolveAuthConfig(value: unknown): CodemationAuthConfig | undefined {\n    return value && typeof value === \"object\" ? (value as CodemationAuthConfig) : undefined;\n  }\n\n  private resolveOauthProviders(value: unknown): ReadonlyArray<CodemationFrontendAuthProviderSnapshot> {\n    if (!Array.isArray(value)) {\n      return [];\n    }\n    return value.flatMap((entry) => {\n      if (!entry || typeof entry !== \"object\") {\n        return [];\n      }\n      const provider = entry as Partial<CodemationFrontendAuthProviderSnapshot>;\n      if (typeof provider.id !== \"string\" || typeof provider.name !== \"string\") {\n        return [];\n      }\n      return [\n        {\n          id: provider.id,\n          name: provider.name,\n        },\n      ];\n    });\n  }\n}\n","import type { CodemationAuthConfig } from \"../config/CodemationAuthConfig\";\nimport type { FrontendAppConfig } from \"./FrontendAppConfig\";\nimport type { CodemationFrontendAuthProviderSnapshot } from \"./CodemationFrontendAuthSnapshot\";\n\nexport class FrontendAppConfigJsonCodec {\n  serialize(config: FrontendAppConfig): string {\n    return JSON.stringify(config);\n  }\n\n  deserialize(serialized: string | undefined): FrontendAppConfig | null {\n    if (!serialized || serialized.trim().length === 0) {\n      return null;\n    }\n    try {\n      const parsed = JSON.parse(serialized) as Partial<FrontendAppConfig> | null;\n      if (!parsed || typeof parsed !== \"object\" || !parsed.auth || typeof parsed.auth !== \"object\") {\n        return null;\n      }\n      return {\n        auth: {\n          config: this.resolveAuthConfig(parsed.auth.config),\n          credentialsEnabled: parsed.auth.credentialsEnabled === true,\n          oauthProviders: this.resolveOauthProviders(parsed.auth.oauthProviders),\n          secret:\n            typeof parsed.auth.secret === \"string\" && parsed.auth.secret.trim().length > 0 ? parsed.auth.secret : null,\n          uiAuthEnabled: parsed.auth.uiAuthEnabled !== false,\n        },\n        productName:\n          typeof parsed.productName === \"string\" && parsed.productName.trim().length > 0\n            ? parsed.productName\n            : \"Codemation\",\n        logoUrl: typeof parsed.logoUrl === \"string\" && parsed.logoUrl.trim().length > 0 ? parsed.logoUrl : null,\n      };\n    } catch {\n      return null;\n    }\n  }\n\n  private resolveAuthConfig(value: unknown): CodemationAuthConfig | undefined {\n    return value && typeof value === \"object\" ? (value as CodemationAuthConfig) : undefined;\n  }\n\n  private resolveOauthProviders(value: unknown): ReadonlyArray<CodemationFrontendAuthProviderSnapshot> {\n    if (!Array.isArray(value)) {\n      return [];\n    }\n    return value.flatMap((entry) => {\n      if (!entry || typeof entry !== \"object\") {\n        return [];\n      }\n      const provider = entry as Partial<CodemationFrontendAuthProviderSnapshot>;\n      if (typeof provider.id !== \"string\" || typeof provider.name !== \"string\") {\n        return [];\n      }\n      return [{ id: provider.id, name: provider.name }];\n    });\n  }\n}\n","import type { CodemationAuthConfig } from \"../config/CodemationAuthConfig\";\nimport type { CodemationFrontendAuthProviderSnapshot } from \"./CodemationFrontendAuthSnapshot\";\nimport type { InternalAuthBootstrap } from \"./InternalAuthBootstrap\";\n\nexport class InternalAuthBootstrapJsonCodec {\n  serialize(bootstrap: InternalAuthBootstrap): string {\n    return JSON.stringify(bootstrap);\n  }\n\n  deserialize(serialized: string | undefined): InternalAuthBootstrap | null {\n    if (!serialized || serialized.trim().length === 0) {\n      return null;\n    }\n    try {\n      const parsed = JSON.parse(serialized) as Partial<InternalAuthBootstrap> | null;\n      if (!parsed || typeof parsed !== \"object\") {\n        return null;\n      }\n      return {\n        authConfig: this.resolveAuthConfig(parsed.authConfig),\n        credentialsEnabled: parsed.credentialsEnabled === true,\n        oauthProviders: this.resolveOauthProviders(parsed.oauthProviders),\n        uiAuthEnabled: parsed.uiAuthEnabled !== false,\n      };\n    } catch {\n      return null;\n    }\n  }\n\n  private resolveAuthConfig(value: unknown): CodemationAuthConfig | undefined {\n    return value && typeof value === \"object\" ? (value as CodemationAuthConfig) : undefined;\n  }\n\n  private resolveOauthProviders(value: unknown): ReadonlyArray<CodemationFrontendAuthProviderSnapshot> {\n    if (!Array.isArray(value)) {\n      return [];\n    }\n    return value.flatMap((entry) => {\n      if (!entry || typeof entry !== \"object\") {\n        return [];\n      }\n      const provider = entry as Partial<CodemationFrontendAuthProviderSnapshot>;\n      if (typeof provider.id !== \"string\" || typeof provider.name !== \"string\") {\n        return [];\n      }\n      return [{ id: provider.id, name: provider.name }];\n    });\n  }\n}\n","import type { PublicFrontendBootstrap } from \"./PublicFrontendBootstrap\";\nimport type { CodemationFrontendAuthProviderSnapshot } from \"./CodemationFrontendAuthSnapshot\";\n\nexport class PublicFrontendBootstrapJsonCodec {\n  serialize(bootstrap: PublicFrontendBootstrap): string {\n    return JSON.stringify(bootstrap);\n  }\n\n  deserialize(serialized: string | undefined): PublicFrontendBootstrap | null {\n    if (!serialized || serialized.trim().length === 0) {\n      return null;\n    }\n    try {\n      const parsed = JSON.parse(serialized) as Partial<PublicFrontendBootstrap> | null;\n      if (!parsed || typeof parsed !== \"object\") {\n        return null;\n      }\n      const base: PublicFrontendBootstrap = {\n        credentialsEnabled: parsed.credentialsEnabled === true,\n        logoUrl: typeof parsed.logoUrl === \"string\" && parsed.logoUrl.trim().length > 0 ? parsed.logoUrl : null,\n        oauthProviders: this.resolveOauthProviders(parsed.oauthProviders),\n        productName:\n          typeof parsed.productName === \"string\" && parsed.productName.trim().length > 0\n            ? parsed.productName\n            : \"Codemation\",\n        uiAuthEnabled: parsed.uiAuthEnabled !== false,\n      };\n      const cpWebOrigin =\n        typeof parsed.cpWebOrigin === \"string\" && parsed.cpWebOrigin.trim().length > 0 ? parsed.cpWebOrigin : undefined;\n      return cpWebOrigin ? { ...base, cpWebOrigin } : base;\n    } catch {\n      return null;\n    }\n  }\n\n  private resolveOauthProviders(value: unknown): ReadonlyArray<CodemationFrontendAuthProviderSnapshot> {\n    if (!Array.isArray(value)) {\n      return [];\n    }\n    return value.flatMap((entry) => {\n      if (!entry || typeof entry !== \"object\") {\n        return [];\n      }\n      const provider = entry as Partial<CodemationFrontendAuthProviderSnapshot>;\n      if (typeof provider.id !== \"string\" || typeof provider.name !== \"string\") {\n        return [];\n      }\n      return [{ id: provider.id, name: provider.name }];\n    });\n  }\n}\n"],"mappings":";AAOA,IAAa,0CAAb,MAAqD;CACnD,UAAU,UAAkD;AAC1D,SAAO,KAAK,UAAU,SAAS;;CAGjC,YAAY,YAAuE;AACjF,MAAI,CAAC,cAAc,WAAW,MAAM,CAAC,WAAW,EAC9C,QAAO;AAET,MAAI;GACF,MAAM,SAAS,KAAK,MAAM,WAAW;AACrC,OAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;AAET,UAAO;IACL,QAAQ,KAAK,kBAAkB,OAAO,OAAO;IAC7C,oBAAoB,OAAO,uBAAuB;IAClD,gBAAgB,KAAK,sBAAsB,OAAO,eAAe;IACjE,QAAQ,OAAO,OAAO,WAAW,YAAY,OAAO,OAAO,MAAM,CAAC,SAAS,IAAI,OAAO,SAAS;IAC/F,eAAe,OAAO,kBAAkB;IACzC;UACK;AACN,UAAO;;;CAIX,AAAQ,kBAAkB,OAAkD;AAC1E,SAAO,SAAS,OAAO,UAAU,WAAY,QAAiC;;CAGhF,AAAQ,sBAAsB,OAAuE;AACnG,MAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,QAAO,EAAE;AAEX,SAAO,MAAM,SAAS,UAAU;AAC9B,OAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO,EAAE;GAEX,MAAM,WAAW;AACjB,OAAI,OAAO,SAAS,OAAO,YAAY,OAAO,SAAS,SAAS,SAC9D,QAAO,EAAE;AAEX,UAAO,CACL;IACE,IAAI,SAAS;IACb,MAAM,SAAS;IAChB,CACF;IACD;;;;;;ACnDN,IAAa,6BAAb,MAAwC;CACtC,UAAU,QAAmC;AAC3C,SAAO,KAAK,UAAU,OAAO;;CAG/B,YAAY,YAA0D;AACpE,MAAI,CAAC,cAAc,WAAW,MAAM,CAAC,WAAW,EAC9C,QAAO;AAET,MAAI;GACF,MAAM,SAAS,KAAK,MAAM,WAAW;AACrC,OAAI,CAAC,UAAU,OAAO,WAAW,YAAY,CAAC,OAAO,QAAQ,OAAO,OAAO,SAAS,SAClF,QAAO;AAET,UAAO;IACL,MAAM;KACJ,QAAQ,KAAK,kBAAkB,OAAO,KAAK,OAAO;KAClD,oBAAoB,OAAO,KAAK,uBAAuB;KACvD,gBAAgB,KAAK,sBAAsB,OAAO,KAAK,eAAe;KACtE,QACE,OAAO,OAAO,KAAK,WAAW,YAAY,OAAO,KAAK,OAAO,MAAM,CAAC,SAAS,IAAI,OAAO,KAAK,SAAS;KACxG,eAAe,OAAO,KAAK,kBAAkB;KAC9C;IACD,aACE,OAAO,OAAO,gBAAgB,YAAY,OAAO,YAAY,MAAM,CAAC,SAAS,IACzE,OAAO,cACP;IACN,SAAS,OAAO,OAAO,YAAY,YAAY,OAAO,QAAQ,MAAM,CAAC,SAAS,IAAI,OAAO,UAAU;IACpG;UACK;AACN,UAAO;;;CAIX,AAAQ,kBAAkB,OAAkD;AAC1E,SAAO,SAAS,OAAO,UAAU,WAAY,QAAiC;;CAGhF,AAAQ,sBAAsB,OAAuE;AACnG,MAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,QAAO,EAAE;AAEX,SAAO,MAAM,SAAS,UAAU;AAC9B,OAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO,EAAE;GAEX,MAAM,WAAW;AACjB,OAAI,OAAO,SAAS,OAAO,YAAY,OAAO,SAAS,SAAS,SAC9D,QAAO,EAAE;AAEX,UAAO,CAAC;IAAE,IAAI,SAAS;IAAI,MAAM,SAAS;IAAM,CAAC;IACjD;;;;;;ACnDN,IAAa,iCAAb,MAA4C;CAC1C,UAAU,WAA0C;AAClD,SAAO,KAAK,UAAU,UAAU;;CAGlC,YAAY,YAA8D;AACxE,MAAI,CAAC,cAAc,WAAW,MAAM,CAAC,WAAW,EAC9C,QAAO;AAET,MAAI;GACF,MAAM,SAAS,KAAK,MAAM,WAAW;AACrC,OAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;AAET,UAAO;IACL,YAAY,KAAK,kBAAkB,OAAO,WAAW;IACrD,oBAAoB,OAAO,uBAAuB;IAClD,gBAAgB,KAAK,sBAAsB,OAAO,eAAe;IACjE,eAAe,OAAO,kBAAkB;IACzC;UACK;AACN,UAAO;;;CAIX,AAAQ,kBAAkB,OAAkD;AAC1E,SAAO,SAAS,OAAO,UAAU,WAAY,QAAiC;;CAGhF,AAAQ,sBAAsB,OAAuE;AACnG,MAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,QAAO,EAAE;AAEX,SAAO,MAAM,SAAS,UAAU;AAC9B,OAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO,EAAE;GAEX,MAAM,WAAW;AACjB,OAAI,OAAO,SAAS,OAAO,YAAY,OAAO,SAAS,SAAS,SAC9D,QAAO,EAAE;AAEX,UAAO,CAAC;IAAE,IAAI,SAAS;IAAI,MAAM,SAAS;IAAM,CAAC;IACjD;;;;;;AC3CN,IAAa,mCAAb,MAA8C;CAC5C,UAAU,WAA4C;AACpD,SAAO,KAAK,UAAU,UAAU;;CAGlC,YAAY,YAAgE;AAC1E,MAAI,CAAC,cAAc,WAAW,MAAM,CAAC,WAAW,EAC9C,QAAO;AAET,MAAI;GACF,MAAM,SAAS,KAAK,MAAM,WAAW;AACrC,OAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;GAET,MAAMA,OAAgC;IACpC,oBAAoB,OAAO,uBAAuB;IAClD,SAAS,OAAO,OAAO,YAAY,YAAY,OAAO,QAAQ,MAAM,CAAC,SAAS,IAAI,OAAO,UAAU;IACnG,gBAAgB,KAAK,sBAAsB,OAAO,eAAe;IACjE,aACE,OAAO,OAAO,gBAAgB,YAAY,OAAO,YAAY,MAAM,CAAC,SAAS,IACzE,OAAO,cACP;IACN,eAAe,OAAO,kBAAkB;IACzC;GACD,MAAM,cACJ,OAAO,OAAO,gBAAgB,YAAY,OAAO,YAAY,MAAM,CAAC,SAAS,IAAI,OAAO,cAAc;AACxG,UAAO,cAAc;IAAE,GAAG;IAAM;IAAa,GAAG;UAC1C;AACN,UAAO;;;CAIX,AAAQ,sBAAsB,OAAuE;AACnG,MAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,QAAO,EAAE;AAEX,SAAO,MAAM,SAAS,UAAU;AAC9B,OAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO,EAAE;GAEX,MAAM,WAAW;AACjB,OAAI,OAAO,SAAS,OAAO,YAAY,OAAO,SAAS,SAAS,SAC9D,QAAO,EAAE;AAEX,UAAO,CAAC;IAAE,IAAI,SAAS;IAAI,MAAM,SAAS;IAAM,CAAC;IACjD"}

package/dist/ServerLoggerFactory-Ckk52S3w.js

@@ -0,0 +1,223 @@
+import { r as ConsoleLogger, t as LogLevelPolicyFactory } from "./LogLevelPolicyFactory-DCUzIN6G.js";
+import { n as __decorateMetadata, t as __decorateParam } from "./decorateParam-BWxkAUSj.js";
+import { t as __decorate } from "./decorate-CXWmflG_.js";
+import { inject, injectable } from "@codemation/core";
+import path from "node:path";
+import { promises } from "node:fs";
+
+//#region src/bootstrap/perf/BootTimer.ts
+var BootTimer = class {
+	static enabled = false;
+	static root = null;
+	static current = null;
+	/** Enable boot tracing for the lifetime of the current process. Idempotent. */
+	static enable() {
+		if (this.enabled) return;
+		this.enabled = true;
+		this.root = {
+			name: "boot",
+			startNs: process.hrtime.bigint(),
+			endNs: null,
+			children: [],
+			parent: null
+		};
+		this.current = this.root;
+	}
+	static isEnabled() {
+		return this.enabled;
+	}
+	/** Wrap an async phase. Pass-through when disabled. */
+	static async measureAsync(name, fn) {
+		if (!this.enabled || !this.current) return await fn();
+		const node = this.pushPhase(name);
+		try {
+			return await fn();
+		} finally {
+			this.popPhase(node);
+		}
+	}
+	/** Wrap a sync phase. Pass-through when disabled. */
+	static measure(name, fn) {
+		if (!this.enabled || !this.current) return fn();
+		const node = this.pushPhase(name);
+		try {
+			return fn();
+		} finally {
+			this.popPhase(node);
+		}
+	}
+	/**
+	* Manual start/stop for fire-and-forget phases (e.g. a spawned child process you only
+	* stop once a readiness probe succeeds). Returns the stop function.
+	*/
+	static start(name) {
+		if (!this.enabled || !this.current) return () => {};
+		const node = this.pushPhase(name);
+		return () => this.popPhase(node);
+	}
+	/** Print the tree to stderr and write JSON to the given path. Finalizes the root span. */
+	static async finish(outputJsonPath) {
+		if (!this.enabled || !this.root) return;
+		if (this.root.endNs === null) this.root.endNs = process.hrtime.bigint();
+		const totalMs = nodeMs(this.root);
+		process.stderr.write(`\n=== Boot trace (total ${totalMs.toFixed(0)}ms) ===\n`);
+		writeTree(this.root, 0, totalMs);
+		process.stderr.write("=========================================\n\n");
+		if (outputJsonPath) try {
+			await promises.mkdir(path.dirname(outputJsonPath), { recursive: true });
+			await promises.writeFile(outputJsonPath, JSON.stringify(this.snapshot(), null, 2), "utf8");
+		} catch (error) {
+			process.stderr.write(`[boot-timer] failed to write JSON trace: ${String(error)}\n`);
+		}
+	}
+	/** Return a plain-object snapshot of the current tree (for tests / diffing). */
+	static snapshot() {
+		if (!this.root) return {
+			name: "boot",
+			ms: 0,
+			pct: 100,
+			children: []
+		};
+		const totalMs = nodeMs(this.root);
+		return toReport(this.root, totalMs);
+	}
+	/** Test helper: reset all state. Do not call in production code. */
+	static reset() {
+		this.enabled = false;
+		this.root = null;
+		this.current = null;
+	}
+	static pushPhase(name) {
+		const node = {
+			name,
+			startNs: process.hrtime.bigint(),
+			endNs: null,
+			children: [],
+			parent: this.current
+		};
+		this.current.children.push(node);
+		this.current = node;
+		return node;
+	}
+	static popPhase(node) {
+		node.endNs = process.hrtime.bigint();
+		this.current = node.parent ?? this.root;
+	}
+};
+function nodeMs(node) {
+	const end = node.endNs ?? node.startNs;
+	return Number(end - node.startNs) / 1e6;
+}
+function toReport(node, totalMs) {
+	const ms = nodeMs(node);
+	return {
+		name: node.name,
+		ms,
+		pct: totalMs > 0 ? ms / totalMs * 100 : 0,
+		children: node.children.map((child) => toReport(child, totalMs))
+	};
+}
+function writeTree(node, depth, totalMs) {
+	const ms = nodeMs(node);
+	const pct = totalMs > 0 ? (ms / totalMs * 100).toFixed(1) : "—";
+	const indent = "  ".repeat(depth);
+	const msStr = ms.toFixed(0).padStart(6);
+	const pctStr = pct.padStart(5);
+	process.stderr.write(`${indent}${msStr}ms  ${pctStr}%  ${node.name}\n`);
+	for (const child of node.children) writeTree(child, depth + 1, totalMs);
+}
+
+//#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) {
+		this.logLevelPolicyFactory = logLevelPolicyFactory;
+	}
+	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, PerformanceLogPolicy as i, PerformanceLogPolicyFactory as n, BootTimer as o, performanceLogPolicyFactory as r, ServerLoggerFactory as t };
+//# sourceMappingURL=ServerLoggerFactory-Ckk52S3w.js.map

package/dist/ServerLoggerFactory-Ckk52S3w.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerLoggerFactory-Ckk52S3w.js","names":["fs","node: PhaseNode","inner: Logger","scope: string","filter: LogFilter","ServerLoggerFactory","logLevelPolicyFactory: LogLevelPolicyFactory","ServerLogger"],"sources":["../src/bootstrap/perf/BootTimer.ts","../src/infrastructure/logging/FilteringLogger.ts","../src/infrastructure/logging/PerformanceLogPolicy.ts","../src/infrastructure/logging/PerformanceLogPolicyFactory.ts","../src/infrastructure/logging/ServerLoggerFactory.ts"],"sourcesContent":["/**\n * Lightweight boot-phase timer. Designed for diagnosing slow `pnpm dev` cold starts.\n *\n * Usage: every meaningful boot phase wraps its async work in\n *   `await BootTimer.measureAsync(\"phase.name\", async () => { ... })`\n * (or the sync `measure` for non-async work). When `--trace-boot` is set on the CLI\n * the timer records each phase in a tree, prints a pretty tree to stderr at the end\n * of boot, and writes the same tree to `tmp/boot-trace.json` for diffing later.\n *\n * When disabled (default), every method is a near-zero-cost passthrough — no allocation,\n * no Date.now() calls, no tree construction. Safe to leave instrumentation in production\n * code paths.\n */\n\nimport { promises as fs } from \"node:fs\";\nimport path from \"node:path\";\n\ntype PhaseNode = {\n  name: string;\n  startNs: bigint;\n  endNs: bigint | null;\n  children: PhaseNode[];\n  parent: PhaseNode | null;\n};\n\nexport type BootTracePhase = Readonly<{\n  name: string;\n  ms: number;\n  pct: number;\n  children: ReadonlyArray<BootTracePhase>;\n}>;\n\nexport class BootTimer {\n  private static enabled = false;\n  private static root: PhaseNode | null = null;\n  private static current: PhaseNode | null = null;\n\n  /** Enable boot tracing for the lifetime of the current process. Idempotent. */\n  static enable(): void {\n    if (this.enabled) return;\n    this.enabled = true;\n    this.root = { name: \"boot\", startNs: process.hrtime.bigint(), endNs: null, children: [], parent: null };\n    this.current = this.root;\n  }\n\n  static isEnabled(): boolean {\n    return this.enabled;\n  }\n\n  /** Wrap an async phase. Pass-through when disabled. */\n  static async measureAsync<T>(name: string, fn: () => Promise<T>): Promise<T> {\n    if (!this.enabled || !this.current) {\n      return await fn();\n    }\n    const node = this.pushPhase(name);\n    try {\n      return await fn();\n    } finally {\n      this.popPhase(node);\n    }\n  }\n\n  /** Wrap a sync phase. Pass-through when disabled. */\n  static measure<T>(name: string, fn: () => T): T {\n    if (!this.enabled || !this.current) {\n      return fn();\n    }\n    const node = this.pushPhase(name);\n    try {\n      return fn();\n    } finally {\n      this.popPhase(node);\n    }\n  }\n\n  /**\n   * Manual start/stop for fire-and-forget phases (e.g. a spawned child process you only\n   * stop once a readiness probe succeeds). Returns the stop function.\n   */\n  static start(name: string): () => void {\n    if (!this.enabled || !this.current) {\n      return () => {};\n    }\n    const node = this.pushPhase(name);\n    return () => this.popPhase(node);\n  }\n\n  /** Print the tree to stderr and write JSON to the given path. Finalizes the root span. */\n  static async finish(outputJsonPath?: string): Promise<void> {\n    if (!this.enabled || !this.root) return;\n    if (this.root.endNs === null) {\n      this.root.endNs = process.hrtime.bigint();\n    }\n    const totalMs = nodeMs(this.root);\n    process.stderr.write(`\\n=== Boot trace (total ${totalMs.toFixed(0)}ms) ===\\n`);\n    writeTree(this.root, 0, totalMs);\n    process.stderr.write(\"=========================================\\n\\n\");\n    if (outputJsonPath) {\n      try {\n        await fs.mkdir(path.dirname(outputJsonPath), { recursive: true });\n        await fs.writeFile(outputJsonPath, JSON.stringify(this.snapshot(), null, 2), \"utf8\");\n      } catch (error) {\n        process.stderr.write(`[boot-timer] failed to write JSON trace: ${String(error)}\\n`);\n      }\n    }\n  }\n\n  /** Return a plain-object snapshot of the current tree (for tests / diffing). */\n  static snapshot(): BootTracePhase {\n    if (!this.root) {\n      return { name: \"boot\", ms: 0, pct: 100, children: [] };\n    }\n    const totalMs = nodeMs(this.root);\n    return toReport(this.root, totalMs);\n  }\n\n  /** Test helper: reset all state. Do not call in production code. */\n  static reset(): void {\n    this.enabled = false;\n    this.root = null;\n    this.current = null;\n  }\n\n  private static pushPhase(name: string): PhaseNode {\n    const node: PhaseNode = {\n      name,\n      startNs: process.hrtime.bigint(),\n      endNs: null,\n      children: [],\n      parent: this.current,\n    };\n    this.current!.children.push(node);\n    this.current = node;\n    return node;\n  }\n\n  private static popPhase(node: PhaseNode): void {\n    node.endNs = process.hrtime.bigint();\n    this.current = node.parent ?? this.root;\n  }\n}\n\nfunction nodeMs(node: PhaseNode): number {\n  const end = node.endNs ?? node.startNs;\n  return Number(end - node.startNs) / 1e6;\n}\n\nfunction toReport(node: PhaseNode, totalMs: number): BootTracePhase {\n  const ms = nodeMs(node);\n  return {\n    name: node.name,\n    ms,\n    pct: totalMs > 0 ? (ms / totalMs) * 100 : 0,\n    children: node.children.map((child) => toReport(child, totalMs)),\n  };\n}\n\nfunction writeTree(node: PhaseNode, depth: number, totalMs: number): void {\n  const ms = nodeMs(node);\n  const pct = totalMs > 0 ? ((ms / totalMs) * 100).toFixed(1) : \"—\";\n  const indent = \"  \".repeat(depth);\n  const msStr = ms.toFixed(0).padStart(6);\n  const pctStr = pct.padStart(5);\n  process.stderr.write(`${indent}${msStr}ms  ${pctStr}%  ${node.name}\\n`);\n  for (const child of node.children) {\n    writeTree(child, depth + 1, totalMs);\n  }\n}\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":";;;;;;;;AAgCA,IAAa,YAAb,MAAuB;CACrB,OAAe,UAAU;CACzB,OAAe,OAAyB;CACxC,OAAe,UAA4B;;CAG3C,OAAO,SAAe;AACpB,MAAI,KAAK,QAAS;AAClB,OAAK,UAAU;AACf,OAAK,OAAO;GAAE,MAAM;GAAQ,SAAS,QAAQ,OAAO,QAAQ;GAAE,OAAO;GAAM,UAAU,EAAE;GAAE,QAAQ;GAAM;AACvG,OAAK,UAAU,KAAK;;CAGtB,OAAO,YAAqB;AAC1B,SAAO,KAAK;;;CAId,aAAa,aAAgB,MAAc,IAAkC;AAC3E,MAAI,CAAC,KAAK,WAAW,CAAC,KAAK,QACzB,QAAO,MAAM,IAAI;EAEnB,MAAM,OAAO,KAAK,UAAU,KAAK;AACjC,MAAI;AACF,UAAO,MAAM,IAAI;YACT;AACR,QAAK,SAAS,KAAK;;;;CAKvB,OAAO,QAAW,MAAc,IAAgB;AAC9C,MAAI,CAAC,KAAK,WAAW,CAAC,KAAK,QACzB,QAAO,IAAI;EAEb,MAAM,OAAO,KAAK,UAAU,KAAK;AACjC,MAAI;AACF,UAAO,IAAI;YACH;AACR,QAAK,SAAS,KAAK;;;;;;;CAQvB,OAAO,MAAM,MAA0B;AACrC,MAAI,CAAC,KAAK,WAAW,CAAC,KAAK,QACzB,cAAa;EAEf,MAAM,OAAO,KAAK,UAAU,KAAK;AACjC,eAAa,KAAK,SAAS,KAAK;;;CAIlC,aAAa,OAAO,gBAAwC;AAC1D,MAAI,CAAC,KAAK,WAAW,CAAC,KAAK,KAAM;AACjC,MAAI,KAAK,KAAK,UAAU,KACtB,MAAK,KAAK,QAAQ,QAAQ,OAAO,QAAQ;EAE3C,MAAM,UAAU,OAAO,KAAK,KAAK;AACjC,UAAQ,OAAO,MAAM,2BAA2B,QAAQ,QAAQ,EAAE,CAAC,WAAW;AAC9E,YAAU,KAAK,MAAM,GAAG,QAAQ;AAChC,UAAQ,OAAO,MAAM,gDAAgD;AACrE,MAAI,eACF,KAAI;AACF,SAAMA,SAAG,MAAM,KAAK,QAAQ,eAAe,EAAE,EAAE,WAAW,MAAM,CAAC;AACjE,SAAMA,SAAG,UAAU,gBAAgB,KAAK,UAAU,KAAK,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO;WAC7E,OAAO;AACd,WAAQ,OAAO,MAAM,4CAA4C,OAAO,MAAM,CAAC,IAAI;;;;CAMzF,OAAO,WAA2B;AAChC,MAAI,CAAC,KAAK,KACR,QAAO;GAAE,MAAM;GAAQ,IAAI;GAAG,KAAK;GAAK,UAAU,EAAE;GAAE;EAExD,MAAM,UAAU,OAAO,KAAK,KAAK;AACjC,SAAO,SAAS,KAAK,MAAM,QAAQ;;;CAIrC,OAAO,QAAc;AACnB,OAAK,UAAU;AACf,OAAK,OAAO;AACZ,OAAK,UAAU;;CAGjB,OAAe,UAAU,MAAyB;EAChD,MAAMC,OAAkB;GACtB;GACA,SAAS,QAAQ,OAAO,QAAQ;GAChC,OAAO;GACP,UAAU,EAAE;GACZ,QAAQ,KAAK;GACd;AACD,OAAK,QAAS,SAAS,KAAK,KAAK;AACjC,OAAK,UAAU;AACf,SAAO;;CAGT,OAAe,SAAS,MAAuB;AAC7C,OAAK,QAAQ,QAAQ,OAAO,QAAQ;AACpC,OAAK,UAAU,KAAK,UAAU,KAAK;;;AAIvC,SAAS,OAAO,MAAyB;CACvC,MAAM,MAAM,KAAK,SAAS,KAAK;AAC/B,QAAO,OAAO,MAAM,KAAK,QAAQ,GAAG;;AAGtC,SAAS,SAAS,MAAiB,SAAiC;CAClE,MAAM,KAAK,OAAO,KAAK;AACvB,QAAO;EACL,MAAM,KAAK;EACX;EACA,KAAK,UAAU,IAAK,KAAK,UAAW,MAAM;EAC1C,UAAU,KAAK,SAAS,KAAK,UAAU,SAAS,OAAO,QAAQ,CAAC;EACjE;;AAGH,SAAS,UAAU,MAAiB,OAAe,SAAuB;CACxE,MAAM,KAAK,OAAO,KAAK;CACvB,MAAM,MAAM,UAAU,KAAM,KAAK,UAAW,KAAK,QAAQ,EAAE,GAAG;CAC9D,MAAM,SAAS,KAAK,OAAO,MAAM;CACjC,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC,SAAS,EAAE;CACvC,MAAM,SAAS,IAAI,SAAS,EAAE;AAC9B,SAAQ,OAAO,MAAM,GAAG,SAAS,MAAM,MAAM,OAAO,KAAK,KAAK,KAAK,IAAI;AACvE,MAAK,MAAM,SAAS,KAAK,SACvB,WAAU,OAAO,QAAQ,GAAG,QAAQ;;;;;AClKxC,IAAa,kBAAb,MAA+C;CAC7C,YACE,AAAiBC,OACjB,AAAiBC,OACjB,AAAiBC,QACjB;EAHiB;EACA;EACA;;CAGnB,KAAK,SAAiB,WAAyB;AAC7C,MAAI,CAAC,KAAK,OAAO;GAAE,OAAO,KAAK;GAAO,OAAO;GAAQ;GAAS,CAAC,CAC7D;AAEF,OAAK,MAAM,KAAK,SAAS,UAAU;;CAGrC,KAAK,SAAiB,WAAyB;AAC7C,MAAI,CAAC,KAAK,OAAO;GAAE,OAAO,KAAK;GAAO,OAAO;GAAQ;GAAS,CAAC,CAC7D;AAEF,OAAK,MAAM,KAAK,SAAS,UAAU;;CAGrC,MAAM,SAAiB,WAAyB;AAC9C,MAAI,CAAC,KAAK,OAAO;GAAE,OAAO,KAAK;GAAO,OAAO;GAAS;GAAS,CAAC,CAC9D;AAEF,OAAK,MAAM,MAAM,SAAS,UAAU;;CAGtC,MAAM,SAAiB,WAAyB;AAC9C,MAAI,CAAC,KAAK,OAAO;GAAE,OAAO,KAAK;GAAO,OAAO;GAAS;GAAS,CAAC,CAC9D;AAEF,OAAK,MAAM,MAAM,SAAS,UAAU;;;;;;;;;;;AC9BxC,IAAa,uBAAb,MAAkC;CAChC,2BAAoC;AAClC,SAAO,QAAQ,IAAI,mCAAmC;;;;;;;;;ACF1D,IAAa,8BAAb,MAAyC;CACvC,AAAiB,SAAS,IAAI,sBAAsB;CAEpD,SAA+B;AAC7B,SAAO,KAAK;;;AAIhB,MAAa,8BAA8B,IAAI,6BAA6B;;;;;ACFrE,gCAAMC,sBAA6C;CACxD,YAAY,AAAgDC,uBAA8C;EAA9C;;CAE5D,OAAO,OAAuB;AAC5B,SAAO,IAAIC,cAAa,OAAO,KAAK,sBAAsB,QAAQ,CAAC;;CAGrE,eAAe,OAAe,QAA2B;AACvD,SAAO,IAAI,gBAAgB,KAAK,OAAO,MAAM,EAAE,OAAO,OAAO;;CAG/D,6BAA6B,OAAuB;AAClD,SAAO,KAAK,eAAe,QAAQ,WAAW,4BAA4B,QAAQ,CAAC,0BAA0B,CAAC;;;;CAbjH,YAAY;oBAEE,OAAO,sBAAsB"}