@fulmenhq/tsfulmen 0.3.3 → 0.4.1

package/dist/chunk-UP2VWCW5.js

@@ -0,0 +1,33 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+export { __commonJS, __esm, __export, __require, __toCommonJS };
+//# sourceMappingURL=chunk-UP2VWCW5.js.map
+//# sourceMappingURL=chunk-UP2VWCW5.js.map

package/dist/chunk-UP2VWCW5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-UP2VWCW5.js"}

package/dist/chunk-VJIGX7MH.js

@@ -0,0 +1,208 @@
+import { AppIdentityError } from './chunk-WCCMRVZF.js';
+import { validateDataBySchemaId } from './chunk-SNV5WG5V.js';
+import { readFile, access } from 'fs/promises';
+import { parse } from 'yaml';
+import { join, dirname } from 'path';
+
+// src/appidentity/cache.ts
+var cachedIdentity = null;
+function getCachedIdentity() {
+  return cachedIdentity;
+}
+function setCachedIdentity(identity) {
+  cachedIdentity = identity;
+}
+function clearIdentityCache() {
+  cachedIdentity = null;
+}
+
+// src/appidentity/constants.ts
+var APP_IDENTITY_FILENAME = "app.yaml";
+var APP_IDENTITY_DIR = ".fulmen";
+var APP_IDENTITY_ENV_VAR = "FULMEN_APP_IDENTITY_PATH";
+var APP_IDENTITY_SCHEMA_ID = "config/repository/app-identity/v1.0.0/app-identity";
+var MAX_ANCESTOR_SEARCH_DEPTH = 20;
+async function discoverIdentityPath(options) {
+  if (options?.path) {
+    const exists = await fileExists(options.path);
+    if (!exists) {
+      throw AppIdentityError.notFound([options.path]);
+    }
+    return { path: options.path, source: "explicit" };
+  }
+  const envPath = process.env[APP_IDENTITY_ENV_VAR];
+  if (envPath) {
+    const exists = await fileExists(envPath);
+    if (!exists) {
+      throw AppIdentityError.envOverrideMissing(envPath);
+    }
+    return { path: envPath, source: "env" };
+  }
+  const startDir = options?.startDir || process.cwd();
+  const result = await searchAncestors(startDir);
+  if (result) {
+    return { path: result, source: "ancestor" };
+  }
+  return null;
+}
+async function searchAncestors(startDir) {
+  let currentDir = startDir;
+  const searchedPaths = [];
+  for (let i = 0; i < MAX_ANCESTOR_SEARCH_DEPTH; i++) {
+    const candidatePath = join(currentDir, APP_IDENTITY_DIR, APP_IDENTITY_FILENAME);
+    searchedPaths.push(candidatePath);
+    if (await fileExists(candidatePath)) {
+      return candidatePath;
+    }
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
+      throw AppIdentityError.notFound(searchedPaths);
+    }
+    currentDir = parentDir;
+  }
+  throw AppIdentityError.notFound(searchedPaths);
+}
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var embeddedIdentity = null;
+var isRegistered = false;
+function deepFreeze(obj) {
+  Object.freeze(obj);
+  Object.getOwnPropertyNames(obj).forEach((prop) => {
+    const value = obj[prop];
+    if (value !== null && (typeof value === "object" || typeof value === "function") && !Object.isFrozen(value)) {
+      deepFreeze(value);
+    }
+  });
+  return obj;
+}
+async function registerEmbeddedIdentity(data, options) {
+  if (isRegistered) {
+    throw AppIdentityError.alreadyRegistered();
+  }
+  const skipValidation = options?.skipValidation ?? false;
+  let identity;
+  if (typeof data === "string") {
+    let parsed;
+    try {
+      parsed = parse(data);
+    } catch (error) {
+      throw AppIdentityError.embeddedParseFailed(
+        error instanceof Error ? error : new Error(String(error))
+      );
+    }
+    if (!skipValidation) {
+      const result = await validateDataBySchemaId(parsed, APP_IDENTITY_SCHEMA_ID);
+      if (!result.valid) {
+        throw AppIdentityError.embeddedValidationFailed(result.diagnostics);
+      }
+    }
+    identity = parsed;
+  } else {
+    if (!skipValidation) {
+      const result = await validateDataBySchemaId(data, APP_IDENTITY_SCHEMA_ID);
+      if (!result.valid) {
+        throw AppIdentityError.embeddedValidationFailed(result.diagnostics);
+      }
+    }
+    identity = data;
+  }
+  embeddedIdentity = deepFreeze(structuredClone(identity));
+  isRegistered = true;
+}
+function hasEmbeddedIdentity() {
+  return isRegistered;
+}
+function getEmbeddedIdentity() {
+  return embeddedIdentity;
+}
+function clearEmbeddedIdentity() {
+  embeddedIdentity = null;
+  isRegistered = false;
+}
+
+// src/appidentity/loader.ts
+function deepFreeze2(obj) {
+  Object.freeze(obj);
+  Object.getOwnPropertyNames(obj).forEach((prop) => {
+    const value = obj[prop];
+    if (value !== null && (typeof value === "object" || typeof value === "function") && !Object.isFrozen(value)) {
+      deepFreeze2(value);
+    }
+  });
+  return obj;
+}
+async function loadIdentity(options) {
+  if (options?.identity) {
+    return deepFreeze2(structuredClone(options.identity));
+  }
+  if (!options?.skipCache) {
+    const cached = getCachedIdentity();
+    if (cached) {
+      return cached;
+    }
+  }
+  let discovery;
+  try {
+    discovery = await discoverIdentityPath({
+      path: options?.path,
+      startDir: options?.startDir
+    });
+  } catch (error) {
+    const hasExplicitPath = Boolean(options?.path);
+    const hasEnvOverride = Boolean(process.env[APP_IDENTITY_ENV_VAR]);
+    if (!hasExplicitPath && !hasEnvOverride && error instanceof AppIdentityError) {
+      const embedded = getEmbeddedIdentity();
+      if (embedded) {
+        setCachedIdentity(embedded);
+        return embedded;
+      }
+    }
+    throw error;
+  }
+  if (!discovery) {
+    const embedded = getEmbeddedIdentity();
+    if (embedded) {
+      setCachedIdentity(embedded);
+      return embedded;
+    }
+    throw AppIdentityError.notFound([]);
+  }
+  let content;
+  try {
+    content = await readFile(discovery.path, "utf-8");
+  } catch (error) {
+    throw AppIdentityError.readFailed(
+      discovery.path,
+      error instanceof Error ? error : new Error(String(error))
+    );
+  }
+  let parsed;
+  try {
+    parsed = parse(content);
+  } catch (error) {
+    throw AppIdentityError.parseFailed(
+      discovery.path,
+      error instanceof Error ? error : new Error(String(error))
+    );
+  }
+  if (!options?.skipValidation) {
+    const result = await validateDataBySchemaId(parsed, APP_IDENTITY_SCHEMA_ID);
+    if (!result.valid) {
+      throw AppIdentityError.validationFailed(discovery.path, result.diagnostics);
+    }
+  }
+  const identity = deepFreeze2(structuredClone(parsed));
+  setCachedIdentity(identity);
+  return identity;
+}
+
+export { APP_IDENTITY_DIR, APP_IDENTITY_ENV_VAR, APP_IDENTITY_FILENAME, APP_IDENTITY_SCHEMA_ID, MAX_ANCESTOR_SEARCH_DEPTH, clearEmbeddedIdentity, clearIdentityCache, getCachedIdentity, getEmbeddedIdentity, hasEmbeddedIdentity, loadIdentity, registerEmbeddedIdentity };
+//# sourceMappingURL=chunk-VJIGX7MH.js.map
+//# sourceMappingURL=chunk-VJIGX7MH.js.map

package/dist/chunk-VJIGX7MH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/appidentity/cache.ts","../src/appidentity/constants.ts","../src/appidentity/discovery.ts","../src/appidentity/embedded.ts","../src/appidentity/loader.ts"],"names":["parseYAML","deepFreeze"],"mappings":"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","file":"chunk-VJIGX7MH.js","sourcesContent":["/**\n * Application Identity Cache\n *\n * Process-level caching for identity objects with immutability guarantees\n */\n\nimport type { Identity } from \"./types.js\";\n\n/**\n * Process-level cache storage\n * null = not cached, Identity = cached value\n */\nlet cachedIdentity: Identity | null = null;\n\n/**\n * Get cached identity if available\n *\n * @returns Cached identity or null if not cached\n */\nexport function getCachedIdentity(): Identity | null {\n  return cachedIdentity;\n}\n\n/**\n * Set cached identity\n *\n * Identity object should already be frozen before caching\n *\n * @param identity - Identity to cache (must be frozen)\n */\nexport function setCachedIdentity(identity: Identity): void {\n  cachedIdentity = identity;\n}\n\n/**\n * Clear the identity cache\n *\n * Useful for testing or when identity needs to be reloaded\n */\nexport function clearIdentityCache(): void {\n  cachedIdentity = null;\n}\n","/**\n * Application Identity Constants\n *\n * Centralized configuration for identity discovery and validation\n */\n\n/**\n * Filename for identity document\n */\nexport const APP_IDENTITY_FILENAME = \"app.yaml\";\n\n/**\n * Directory containing identity file\n */\nexport const APP_IDENTITY_DIR = \".fulmen\";\n\n/**\n * Environment variable for explicit path override\n */\nexport const APP_IDENTITY_ENV_VAR = \"FULMEN_APP_IDENTITY_PATH\";\n\n/**\n * Schema ID for validation\n */\nexport const APP_IDENTITY_SCHEMA_ID = \"config/repository/app-identity/v1.0.0/app-identity\";\n\n/**\n * Maximum depth for ancestor directory search\n * Prevents infinite loops and excessive filesystem traversal\n */\nexport const MAX_ANCESTOR_SEARCH_DEPTH = 20;\n","/**\n * Application Identity Discovery\n *\n * Implements the Crucible discovery precedence algorithm:\n * 1. Explicit path parameter (highest priority)\n * 2. Environment variable override (FULMEN_APP_IDENTITY_PATH)\n * 3. Ancestor search from CWD upward\n */\n\nimport { access } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport {\n  APP_IDENTITY_DIR,\n  APP_IDENTITY_ENV_VAR,\n  APP_IDENTITY_FILENAME,\n  MAX_ANCESTOR_SEARCH_DEPTH,\n} from \"./constants.js\";\nimport { AppIdentityError } from \"./errors.js\";\n\n/**\n * Discovery result with path and source\n */\nexport interface DiscoveryResult {\n  readonly path: string;\n  readonly source: \"explicit\" | \"env\" | \"ancestor\" | \"test\";\n}\n\n/**\n * Options for identity discovery\n */\nexport interface DiscoveryOptions {\n  /**\n   * Explicit path override (highest priority)\n   */\n  readonly path?: string;\n\n  /**\n   * Starting directory for ancestor search\n   * Defaults to process.cwd()\n   */\n  readonly startDir?: string;\n}\n\n/**\n * Discover application identity file using Crucible precedence algorithm\n *\n * Discovery order:\n * 1. Explicit path parameter (throws if not found)\n * 2. FULMEN_APP_IDENTITY_PATH env var (throws if set but not found)\n * 3. Ancestor search from startDir (throws if not found after max depth)\n *\n * @param options - Discovery options\n * @returns Discovery result with path and source\n * @throws {AppIdentityError} If identity file not found or inaccessible\n */\nexport async function discoverIdentityPath(\n  options?: DiscoveryOptions,\n): Promise<DiscoveryResult | null> {\n  // 1. Explicit path parameter (highest priority)\n  if (options?.path) {\n    const exists = await fileExists(options.path);\n    if (!exists) {\n      throw AppIdentityError.notFound([options.path]);\n    }\n    return { path: options.path, source: \"explicit\" };\n  }\n\n  // 2. Environment variable override\n  const envPath = process.env[APP_IDENTITY_ENV_VAR];\n  if (envPath) {\n    const exists = await fileExists(envPath);\n    if (!exists) {\n      throw AppIdentityError.envOverrideMissing(envPath);\n    }\n    return { path: envPath, source: \"env\" };\n  }\n\n  // 3. Ancestor search from startDir\n  const startDir = options?.startDir || process.cwd();\n  const result = await searchAncestors(startDir);\n  if (result) {\n    return { path: result, source: \"ancestor\" };\n  }\n\n  return null;\n}\n\n/**\n * Search ancestor directories for identity file\n *\n * Walks upward from startDir to filesystem root, looking for .fulmen/app.yaml\n * Stops at MAX_ANCESTOR_SEARCH_DEPTH or filesystem root\n *\n * @param startDir - Directory to start search from\n * @returns Path to identity file if found, null otherwise\n * @throws {AppIdentityError} If max depth reached or filesystem root reached without finding file\n */\nasync function searchAncestors(startDir: string): Promise<string | null> {\n  let currentDir = startDir;\n  const searchedPaths: string[] = [];\n\n  for (let i = 0; i < MAX_ANCESTOR_SEARCH_DEPTH; i++) {\n    const candidatePath = join(currentDir, APP_IDENTITY_DIR, APP_IDENTITY_FILENAME);\n    searchedPaths.push(candidatePath);\n\n    if (await fileExists(candidatePath)) {\n      return candidatePath;\n    }\n\n    const parentDir = dirname(currentDir);\n    if (parentDir === currentDir) {\n      // Reached filesystem root\n      throw AppIdentityError.notFound(searchedPaths);\n    }\n    currentDir = parentDir;\n  }\n\n  // Max depth reached\n  throw AppIdentityError.notFound(searchedPaths);\n}\n\n/**\n * Check if a file exists and is accessible\n *\n * @param path - Path to check\n * @returns true if file exists and is readable, false otherwise\n */\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","/**\n * Embedded Identity Registration\n *\n * Provides a mechanism to register embedded identity at application startup\n * for standalone binary/package support. This allows applications to work\n * without requiring .fulmen/app.yaml to be discoverable on the filesystem.\n *\n * Discovery precedence (with embedded fallback):\n * 1. Explicit path parameter\n * 2. FULMEN_APP_IDENTITY_PATH environment variable\n * 3. Ancestor search from CWD\n * 4. Embedded identity fallback (this module)\n */\n\nimport { parse as parseYAML } from \"yaml\";\nimport { validateDataBySchemaId } from \"../schema/index.js\";\nimport { APP_IDENTITY_SCHEMA_ID } from \"./constants.js\";\nimport { AppIdentityError } from \"./errors.js\";\nimport type { Identity, RegisterEmbeddedIdentityOptions } from \"./types.js\";\n\n/**\n * Process-level storage for embedded identity\n * Uses first-wins semantics - once registered, cannot be replaced\n */\nlet embeddedIdentity: Identity | null = null;\nlet isRegistered = false;\n\n/**\n * Deep freeze an object and all its nested properties\n */\nfunction deepFreeze<T>(obj: T): T {\n  Object.freeze(obj);\n  Object.getOwnPropertyNames(obj).forEach((prop) => {\n    // biome-ignore lint/suspicious/noExplicitAny: Required for recursive property access\n    const value = (obj as any)[prop];\n    if (\n      value !== null &&\n      (typeof value === \"object\" || typeof value === \"function\") &&\n      !Object.isFrozen(value)\n    ) {\n      deepFreeze(value);\n    }\n  });\n  return obj;\n}\n\n/**\n * Register embedded identity YAML that serves as fallback when\n * runtime discovery cannot find an external app.yaml.\n *\n * Semantics:\n * - First registration wins (subsequent calls throw error)\n * - Validates against schema on registration (unless `skipValidation`)\n * - Stores as immutable process-level fallback\n *\n * @param data - YAML string or pre-parsed Identity object\n * @param options - Optional registration options (see {@link RegisterEmbeddedIdentityOptions})\n * @throws {AppIdentityError} If already registered or validation fails\n *\n * @example\n * ```typescript\n * // From npm package entry point\n * import { registerEmbeddedIdentity } from \"@fulmenhq/tsfulmen/appidentity\";\n * import { readFileSync } from \"node:fs\";\n * import { fileURLToPath } from \"node:url\";\n * import { dirname, join } from \"node:path\";\n *\n * const __filename = fileURLToPath(import.meta.url);\n * const __dirname = dirname(__filename);\n * const embeddedPath = join(__dirname, \"..\", \".fulmen\", \"app.yaml\");\n *\n * try {\n *   const yaml = readFileSync(embeddedPath, \"utf-8\");\n *   registerEmbeddedIdentity(yaml);\n * } catch {\n *   // Embedded identity not available - discovery will use filesystem\n * }\n * ```\n *\n * @example\n * ```typescript\n * // In a `bun --compile` single-file binary, the FS-backed schema registry\n * // is unavailable. Register a build-time-embedded, CI-validated identity\n * // without re-validating against the (absent) schema registry:\n * import embeddedYaml from \"./app-identity.embedded.js\"; // inlined at build\n * registerEmbeddedIdentity(embeddedYaml, { skipValidation: true });\n * ```\n */\nexport async function registerEmbeddedIdentity(\n  data: string | Identity,\n  options?: RegisterEmbeddedIdentityOptions,\n): Promise<void> {\n  // First-wins semantics\n  if (isRegistered) {\n    throw AppIdentityError.alreadyRegistered();\n  }\n\n  const skipValidation = options?.skipValidation ?? false;\n  let identity: Identity;\n\n  if (typeof data === \"string\") {\n    // Parse YAML\n    let parsed: unknown;\n    try {\n      parsed = parseYAML(data);\n    } catch (error) {\n      throw AppIdentityError.embeddedParseFailed(\n        error instanceof Error ? error : new Error(String(error)),\n      );\n    }\n\n    // Validate against schema (unless skipValidation)\n    if (!skipValidation) {\n      const result = await validateDataBySchemaId(parsed, APP_IDENTITY_SCHEMA_ID);\n      if (!result.valid) {\n        throw AppIdentityError.embeddedValidationFailed(result.diagnostics);\n      }\n    }\n\n    identity = parsed as Identity;\n  } else {\n    // Pre-parsed object - still validate (unless skipValidation)\n    if (!skipValidation) {\n      const result = await validateDataBySchemaId(data, APP_IDENTITY_SCHEMA_ID);\n      if (!result.valid) {\n        throw AppIdentityError.embeddedValidationFailed(result.diagnostics);\n      }\n    }\n    identity = data;\n  }\n\n  // Deep freeze and store\n  embeddedIdentity = deepFreeze(structuredClone(identity)) as Identity;\n  isRegistered = true;\n}\n\n/**\n * Check if embedded identity has been registered\n *\n * @returns true if registerEmbeddedIdentity() has been called successfully\n */\nexport function hasEmbeddedIdentity(): boolean {\n  return isRegistered;\n}\n\n/**\n * Get the registered embedded identity\n *\n * @returns Frozen identity object or null if not registered\n */\nexport function getEmbeddedIdentity(): Identity | null {\n  return embeddedIdentity;\n}\n\n/**\n * Clear embedded identity registration\n *\n * WARNING: For testing only. In production, embedded identity should be\n * set once at startup and never cleared.\n */\nexport function clearEmbeddedIdentity(): void {\n  embeddedIdentity = null;\n  isRegistered = false;\n}\n","/**\n * Application Identity Loader\n *\n * Main loading logic with YAML parsing, schema validation, and caching\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { parse as parseYAML } from \"yaml\";\nimport { validateDataBySchemaId } from \"../schema/index.js\";\nimport { clearIdentityCache, getCachedIdentity, setCachedIdentity } from \"./cache.js\";\nimport { APP_IDENTITY_ENV_VAR, APP_IDENTITY_SCHEMA_ID } from \"./constants.js\";\nimport { discoverIdentityPath } from \"./discovery.js\";\nimport { getEmbeddedIdentity } from \"./embedded.js\";\nimport { AppIdentityError } from \"./errors.js\";\nimport type { Identity, LoadIdentityOptions } from \"./types.js\";\n\n/**\n * Deep freeze an object and all its nested properties\n *\n * Recursively freezes an object and all nested objects/functions to ensure\n * complete immutability. This prevents accidental mutations of identity data.\n *\n * Note: Uses `any` type assertion (line 28) to access arbitrary properties\n * during recursive traversal. This is necessary because TypeScript's generic\n * constraint system cannot express \"any object with indexable properties\"\n * without losing the return type safety. The `any` is scoped to a single\n * line and protected by runtime guards.\n *\n * @param obj - Object to freeze\n * @returns Frozen object (same type as input)\n */\nfunction deepFreeze<T>(obj: T): T {\n  // Freeze the object itself\n  Object.freeze(obj);\n\n  // Recursively freeze all properties\n  Object.getOwnPropertyNames(obj).forEach((prop) => {\n    // biome-ignore lint/suspicious/noExplicitAny: Required for recursive property access - see function docs\n    const value = (obj as any)[prop];\n    if (\n      value !== null &&\n      (typeof value === \"object\" || typeof value === \"function\") &&\n      !Object.isFrozen(value)\n    ) {\n      deepFreeze(value);\n    }\n  });\n\n  return obj;\n}\n\n/**\n * Load application identity from .fulmen/app.yaml\n *\n * Discovery order:\n * 1. Test injection (options.identity) - bypasses all discovery and caching\n * 2. Explicit path (options.path)\n * 3. Environment variable (FULMEN_APP_IDENTITY_PATH)\n * 4. Ancestor search from startDir or CWD\n * 5. Embedded identity fallback (if registered via registerEmbeddedIdentity)\n *\n * Results are cached after first successful load unless skipCache is true.\n * Test injections are never cached.\n *\n * @param options - Load options\n * @returns Frozen, immutable identity object\n * @throws {AppIdentityError} If identity not found, invalid, or unreadable\n */\nexport async function loadIdentity(options?: LoadIdentityOptions): Promise<Identity> {\n  // Test injection (never caches)\n  if (options?.identity) {\n    return deepFreeze(structuredClone(options.identity)) as Identity;\n  }\n\n  // Check cache unless skipCache\n  if (!options?.skipCache) {\n    const cached = getCachedIdentity();\n    if (cached) {\n      return cached;\n    }\n  }\n\n  // Discover file - may throw AppIdentityError.notFound or return null\n  let discovery: Awaited<ReturnType<typeof discoverIdentityPath>>;\n  try {\n    discovery = await discoverIdentityPath({\n      path: options?.path,\n      startDir: options?.startDir,\n    });\n  } catch (error) {\n    // Discovery failed (e.g., reached filesystem root without finding identity)\n    // Embedded fallback MUST NOT override explicit path or env override semantics.\n    const hasExplicitPath = Boolean(options?.path);\n    const hasEnvOverride = Boolean(process.env[APP_IDENTITY_ENV_VAR]);\n\n    if (!hasExplicitPath && !hasEnvOverride && error instanceof AppIdentityError) {\n      const embedded = getEmbeddedIdentity();\n      if (embedded) {\n        // Cache the embedded identity for subsequent calls\n        setCachedIdentity(embedded);\n        return embedded;\n      }\n    }\n\n    throw error;\n  }\n\n  // If discovery returned null (no env var, no explicit path, and ancestor search returned null)\n  if (!discovery) {\n    const embedded = getEmbeddedIdentity();\n    if (embedded) {\n      // Cache the embedded identity for subsequent calls\n      setCachedIdentity(embedded);\n      return embedded;\n    }\n    throw AppIdentityError.notFound([]);\n  }\n\n  // Read file\n  let content: string;\n  try {\n    content = await readFile(discovery.path, \"utf-8\");\n  } catch (error) {\n    throw AppIdentityError.readFailed(\n      discovery.path,\n      error instanceof Error ? error : new Error(String(error)),\n    );\n  }\n\n  // Parse YAML\n  let parsed: unknown;\n  try {\n    parsed = parseYAML(content);\n  } catch (error) {\n    throw AppIdentityError.parseFailed(\n      discovery.path,\n      error instanceof Error ? error : new Error(String(error)),\n    );\n  }\n\n  // Validate against schema (unless skipValidation)\n  if (!options?.skipValidation) {\n    const result = await validateDataBySchemaId(parsed, APP_IDENTITY_SCHEMA_ID);\n\n    if (!result.valid) {\n      throw AppIdentityError.validationFailed(discovery.path, result.diagnostics);\n    }\n  }\n\n  // Deep freeze for immutability\n  const identity = deepFreeze(structuredClone(parsed)) as Identity;\n\n  // Cache result\n  setCachedIdentity(identity);\n\n  return identity;\n}\n\n/**\n * Get cached identity without triggering load\n *\n * @returns Cached identity or null if not cached\n */\n/**\n * Clear the identity cache\n *\n * Useful for testing or when identity needs to be reloaded\n */\nexport { clearIdentityCache, getCachedIdentity };\n"]}

package/dist/chunk-WCCMRVZF.js

@@ -0,0 +1,130 @@
+import { FulmenError } from './chunk-GOTEQYAD.js';
+
+// src/appidentity/errors.ts
+var AppIdentityError = class _AppIdentityError extends FulmenError {
+  identityPath;
+  constructor(message, identityPath, cause) {
+    let errorData;
+    if (cause) {
+      errorData = FulmenError.fromError(cause, {
+        code: "APP_IDENTITY_ERROR",
+        severity: "high",
+        context: { identityPath }
+      }).data;
+    } else {
+      errorData = {
+        code: "APP_IDENTITY_ERROR",
+        message,
+        severity: "high",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        context: { identityPath }
+      };
+    }
+    super(errorData);
+    this.name = "AppIdentityError";
+    this.identityPath = identityPath;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _AppIdentityError);
+    }
+  }
+  /**
+   * Create error for identity not found
+   */
+  static notFound(searchedPaths) {
+    const message = `App identity not found
+Searched paths:
+${searchedPaths.map((p) => `  - ${p}`).join("\n")}`;
+    return new _AppIdentityError(message);
+  }
+  /**
+   * Create error for schema validation failure
+   */
+  static validationFailed(path, diagnostics) {
+    const errorCount = diagnostics.filter((d) => d.severity === "ERROR").length;
+    const warningCount = diagnostics.filter((d) => d.severity === "WARN").length;
+    let message = `Invalid app identity: ${path}
+`;
+    message += `Validation errors: ${errorCount} error(s), ${warningCount} warning(s)
+`;
+    const displayDiagnostics = diagnostics.slice(0, 3);
+    for (const diag of displayDiagnostics) {
+      message += `  - ${diag.message}`;
+      if (diag.pointer) {
+        message += ` at ${diag.pointer}`;
+      }
+      message += "\n";
+    }
+    if (diagnostics.length > 3) {
+      message += `  ... and ${diagnostics.length - 3} more
+`;
+    }
+    return new _AppIdentityError(message, path);
+  }
+  /**
+   * Create error for environment variable override pointing to missing file
+   */
+  static envOverrideMissing(envPath) {
+    const message = `FULMEN_APP_IDENTITY_PATH points to missing file: ${envPath}
+`;
+    return new _AppIdentityError(message, envPath);
+  }
+  /**
+   * Create error for YAML parsing failure
+   */
+  static parseFailed(path, cause) {
+    const message = `Failed to parse identity file: ${path}
+${cause.message}`;
+    return new _AppIdentityError(message, path, cause);
+  }
+  /**
+   * Create error for file read failure
+   */
+  static readFailed(path, cause) {
+    const message = `Failed to read identity file: ${path}
+${cause.message}`;
+    return new _AppIdentityError(message, path, cause);
+  }
+  /**
+   * Create error for embedded identity already registered
+   *
+   * Uses first-wins semantics - once registered, cannot be replaced
+   */
+  static alreadyRegistered() {
+    const message = "Embedded identity already registered. Registration uses first-wins semantics and cannot be replaced.";
+    return new _AppIdentityError(message);
+  }
+  /**
+   * Create error for embedded identity YAML parsing failure
+   */
+  static embeddedParseFailed(cause) {
+    const message = `Failed to parse embedded identity YAML: ${cause.message}`;
+    return new _AppIdentityError(message, void 0, cause);
+  }
+  /**
+   * Create error for embedded identity schema validation failure
+   */
+  static embeddedValidationFailed(diagnostics) {
+    const errorCount = diagnostics.filter((d) => d.severity === "ERROR").length;
+    const warningCount = diagnostics.filter((d) => d.severity === "WARN").length;
+    let message = "Invalid embedded identity\n";
+    message += `Validation errors: ${errorCount} error(s), ${warningCount} warning(s)
+`;
+    const displayDiagnostics = diagnostics.slice(0, 3);
+    for (const diag of displayDiagnostics) {
+      message += `  - ${diag.message}`;
+      if (diag.pointer) {
+        message += ` at ${diag.pointer}`;
+      }
+      message += "\n";
+    }
+    if (diagnostics.length > 3) {
+      message += `  ... and ${diagnostics.length - 3} more
+`;
+    }
+    return new _AppIdentityError(message);
+  }
+};
+
+export { AppIdentityError };
+//# sourceMappingURL=chunk-WCCMRVZF.js.map
+//# sourceMappingURL=chunk-WCCMRVZF.js.map

package/dist/chunk-WCCMRVZF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/appidentity/errors.ts"],"names":[],"mappings":"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","file":"chunk-WCCMRVZF.js","sourcesContent":["/**\n * Application Identity Errors\n *\n * Module-specific error classes for identity operations\n */\n\nimport { FulmenError, type FulmenErrorData } from \"../errors/index.js\";\nimport type { SchemaValidationDiagnostic } from \"../schema/types.js\";\n\n/**\n * Base error class for app identity operations\n */\nexport class AppIdentityError extends FulmenError {\n  public readonly identityPath?: string;\n\n  constructor(message: string, identityPath?: string, cause?: Error) {\n    // Build FulmenErrorData\n    let errorData: FulmenErrorData;\n\n    if (cause) {\n      errorData = FulmenError.fromError(cause, {\n        code: \"APP_IDENTITY_ERROR\",\n        severity: \"high\",\n        context: { identityPath },\n      }).data;\n    } else {\n      errorData = {\n        code: \"APP_IDENTITY_ERROR\",\n        message,\n        severity: \"high\",\n        timestamp: new Date().toISOString(),\n        context: { identityPath },\n      };\n    }\n\n    super(errorData);\n    this.name = \"AppIdentityError\";\n    this.identityPath = identityPath;\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, AppIdentityError);\n    }\n  }\n\n  /**\n   * Create error for identity not found\n   */\n  static notFound(searchedPaths: string[]): AppIdentityError {\n    const message = `App identity not found\\nSearched paths:\\n${searchedPaths.map((p) => `  - ${p}`).join(\"\\n\")}`;\n    return new AppIdentityError(message);\n  }\n\n  /**\n   * Create error for schema validation failure\n   */\n  static validationFailed(\n    path: string,\n    diagnostics: SchemaValidationDiagnostic[],\n  ): AppIdentityError {\n    const errorCount = diagnostics.filter((d) => d.severity === \"ERROR\").length;\n    const warningCount = diagnostics.filter((d) => d.severity === \"WARN\").length;\n\n    let message = `Invalid app identity: ${path}\\n`;\n    message += `Validation errors: ${errorCount} error(s), ${warningCount} warning(s)\\n`;\n\n    // Include first few diagnostics\n    const displayDiagnostics = diagnostics.slice(0, 3);\n    for (const diag of displayDiagnostics) {\n      message += `  - ${diag.message}`;\n      if (diag.pointer) {\n        message += ` at ${diag.pointer}`;\n      }\n      message += \"\\n\";\n    }\n\n    if (diagnostics.length > 3) {\n      message += `  ... and ${diagnostics.length - 3} more\\n`;\n    }\n\n    return new AppIdentityError(message, path);\n  }\n\n  /**\n   * Create error for environment variable override pointing to missing file\n   */\n  static envOverrideMissing(envPath: string): AppIdentityError {\n    const message = `FULMEN_APP_IDENTITY_PATH points to missing file: ${envPath}\\n`;\n    return new AppIdentityError(message, envPath);\n  }\n\n  /**\n   * Create error for YAML parsing failure\n   */\n  static parseFailed(path: string, cause: Error): AppIdentityError {\n    const message = `Failed to parse identity file: ${path}\\n${cause.message}`;\n    return new AppIdentityError(message, path, cause);\n  }\n\n  /**\n   * Create error for file read failure\n   */\n  static readFailed(path: string, cause: Error): AppIdentityError {\n    const message = `Failed to read identity file: ${path}\\n${cause.message}`;\n    return new AppIdentityError(message, path, cause);\n  }\n\n  /**\n   * Create error for embedded identity already registered\n   *\n   * Uses first-wins semantics - once registered, cannot be replaced\n   */\n  static alreadyRegistered(): AppIdentityError {\n    const message =\n      \"Embedded identity already registered. \" +\n      \"Registration uses first-wins semantics and cannot be replaced.\";\n    return new AppIdentityError(message);\n  }\n\n  /**\n   * Create error for embedded identity YAML parsing failure\n   */\n  static embeddedParseFailed(cause: Error): AppIdentityError {\n    const message = `Failed to parse embedded identity YAML: ${cause.message}`;\n    return new AppIdentityError(message, undefined, cause);\n  }\n\n  /**\n   * Create error for embedded identity schema validation failure\n   */\n  static embeddedValidationFailed(diagnostics: SchemaValidationDiagnostic[]): AppIdentityError {\n    const errorCount = diagnostics.filter((d) => d.severity === \"ERROR\").length;\n    const warningCount = diagnostics.filter((d) => d.severity === \"WARN\").length;\n\n    let message = \"Invalid embedded identity\\n\";\n    message += `Validation errors: ${errorCount} error(s), ${warningCount} warning(s)\\n`;\n\n    const displayDiagnostics = diagnostics.slice(0, 3);\n    for (const diag of displayDiagnostics) {\n      message += `  - ${diag.message}`;\n      if (diag.pointer) {\n        message += ` at ${diag.pointer}`;\n      }\n      message += \"\\n\";\n    }\n\n    if (diagnostics.length > 3) {\n      message += `  ... and ${diagnostics.length - 3} more\\n`;\n    }\n\n    return new AppIdentityError(message);\n  }\n}\n"]}