@fulmenhq/tsfulmen 0.2.2 → 0.2.4

package/dist/schema/index.js

@@ -1,3 +1,4 @@
+import addFormats from 'ajv-formats';
 import { spawn } from 'child_process';
 import { access, readFile, mkdir, writeFile } from 'fs/promises';
 import { parse, stringify } from 'yaml';
@@ -8,7 +9,6 @@ import Ajv from 'ajv';
 import Ajv2019 from 'ajv/dist/2019';
 import Ajv2020 from 'ajv/dist/2020';
 import AjvDraft04 from 'ajv-draft-04';
-import addFormats from 'ajv-formats';
 import { Readable } from 'stream';
 import picomatch from 'picomatch';
 import { suggest as suggest$1, substringSimilarity, score as score$1, normalize as normalize$1, jaro_winkler, damerau_levenshtein, osa_distance, levenshtein } from '@3leaps/string-metrics-wasm';
@@ -24,6 +24,27 @@ var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
+function applyFulmenAjvFormats(ajv, options = {}) {
+  const mode = options.mode ?? "fast";
+  const formats = options.formats ?? DEFAULT_FORMATS;
+  addFormats(ajv, { mode, formats });
+  return ajv;
+}
+var DEFAULT_FORMATS;
+var init_ajv_formats = __esm({
+  "src/schema/ajv-formats.ts"() {
+    DEFAULT_FORMATS = [
+      "date-time",
+      "email",
+      "hostname",
+      "ipv4",
+      "ipv6",
+      "uri",
+      "uri-reference",
+      "uuid"
+    ];
+  }
+});
 
 // src/schema/errors.ts
 var errors_exports = {};
@@ -1625,10 +1646,7 @@ function createAjv(dialect) {
     // Enable async schema loading for YAML references
     loadSchema: loadReferencedSchema
   });
-  addFormats(ajv, {
-    mode: "fast",
-    formats: ["date-time", "email", "hostname", "ipv4", "ipv6", "uri", "uri-reference"]
-  });
+  applyFulmenAjvFormats(ajv);
   return ajv;
 }
 async function getAjv(dialect) {
@@ -1874,6 +1892,7 @@ var ajvInstances, metaschemaReady, schemaCache;
 var init_validator = __esm({
   "src/schema/validator.ts"() {
     init_telemetry();
+    init_ajv_formats();
     init_errors();
     init_registry();
     init_utils();
@@ -3833,6 +3852,224 @@ var init_capabilities2 = __esm({
   }
 });
 
+// src/foundry/signals/config-reload-endpoint.ts
+function createConfigReloadEndpoint(options) {
+  const { loader, validator, onReload: onReload2, auth, rateLimit, logger, telemetry } = options;
+  return async (payload, req) => {
+    const correlationId = payload.correlation_id ?? generateCorrelationId();
+    const authResult = await auth(req);
+    if (!authResult.authenticated) {
+      if (logger) {
+        logger.warn("Config reload endpoint: authentication failed", {
+          correlation_id: correlationId,
+          reason: authResult.reason
+        });
+      }
+      if (telemetry) {
+        telemetry.emit("fulmen.config.http_endpoint.auth_failed", {
+          correlation_id: correlationId
+        });
+      }
+      return {
+        status: "error",
+        error: "authentication_failed",
+        message: authResult.reason || "Authentication required",
+        statusCode: 401
+      };
+    }
+    const identity = authResult.identity || "unknown";
+    if (rateLimit) {
+      const rateLimitResult = await rateLimit(identity);
+      if (!rateLimitResult.allowed) {
+        if (logger) {
+          logger.warn("Config reload endpoint: rate limit exceeded", {
+            correlation_id: correlationId,
+            identity
+          });
+        }
+        if (telemetry) {
+          telemetry.emit("fulmen.config.http_endpoint.rate_limited", {
+            correlation_id: correlationId
+          });
+        }
+        return {
+          status: "error",
+          error: "rate_limit_exceeded",
+          message: "Rate limit exceeded. Please try again later.",
+          statusCode: 429
+        };
+      }
+    }
+    if (telemetry) {
+      telemetry.emit("fulmen.config.http_endpoint.reload_requested", {
+        correlation_id: correlationId
+      });
+    }
+    try {
+      const config = await loader();
+      if (validator) {
+        const validation = await validator(config);
+        if (!validation.valid) {
+          if (logger) {
+            logger.warn("Config reload endpoint: validation failed", {
+              correlation_id: correlationId,
+              error_count: validation.errors?.length ?? 0
+            });
+          }
+          if (telemetry) {
+            telemetry.emit("fulmen.config.http_endpoint.reload_rejected", {
+              correlation_id: correlationId,
+              reason: "validation_failed"
+            });
+          }
+          return {
+            status: "error",
+            error: "validation_failed",
+            message: "Configuration validation failed",
+            validation_errors: validation.errors,
+            statusCode: 422
+          };
+        }
+      }
+      if (onReload2) {
+        await onReload2(config);
+      }
+      if (telemetry) {
+        telemetry.emit("fulmen.config.http_endpoint.reload_accepted", {
+          correlation_id: correlationId
+        });
+      }
+      if (logger) {
+        logger.info("Config reload endpoint: reload accepted", {
+          correlation_id: correlationId,
+          reason: payload.reason
+        });
+      }
+      return {
+        status: "reloaded",
+        correlation_id: correlationId,
+        message: "Configuration reloaded",
+        statusCode: 200
+      };
+    } catch (error) {
+      if (logger) {
+        logger.warn("Config reload endpoint: reload failed", {
+          correlation_id: correlationId,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+      if (telemetry) {
+        telemetry.emit("fulmen.config.http_endpoint.reload_error", {
+          correlation_id: correlationId,
+          error_type: error instanceof Error ? error.constructor.name : "unknown"
+        });
+      }
+      return {
+        status: "error",
+        error: "reload_failed",
+        message: error instanceof Error ? error.message : String(error),
+        statusCode: 500
+      };
+    }
+  };
+}
+function generateCorrelationId() {
+  return `cfg-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+var init_config_reload_endpoint = __esm({
+  "src/foundry/signals/config-reload-endpoint.ts"() {
+  }
+});
+
+// src/appidentity/runtime.ts
+function detectRuntime() {
+  const versions = process.versions;
+  if (typeof versions.bun === "string" && versions.bun.length > 0) {
+    return { name: "bun", version: versions.bun };
+  }
+  if (typeof versions.node === "string" && versions.node.length > 0) {
+    return { name: "node", version: versions.node };
+  }
+  return { name: "unknown" };
+}
+function buildRuntimeInfo(options = {}) {
+  const runtime = detectRuntime();
+  const serviceName = options.serviceName ?? options.identity?.app.binary_name ?? "unknown-service";
+  const vendor = options.vendor ?? options.identity?.app.vendor;
+  return {
+    service: {
+      name: serviceName,
+      vendor,
+      version: options.version
+    },
+    runtime,
+    platform: {
+      os: process.platform,
+      arch: process.arch
+    }
+  };
+}
+var init_runtime = __esm({
+  "src/appidentity/runtime.ts"() {
+  }
+});
+
+// src/foundry/signals/control-discovery-endpoint.ts
+function createControlDiscoveryEndpoint(options) {
+  const { identity, version, endpoints, auth, authSummary, logger, telemetry } = options;
+  return async (req) => {
+    if (auth) {
+      const authResult = await auth(req);
+      if (!authResult.authenticated) {
+        if (logger) {
+          logger.warn("Control discovery endpoint: authentication failed", {
+            reason: authResult.reason
+          });
+        }
+        if (telemetry) {
+          telemetry.emit("fulmen.control.discovery.auth_failed", {
+            service: identity.app.binary_name
+          });
+        }
+        return {
+          status: "error",
+          error: "authentication_failed",
+          message: authResult.reason || "Authentication required",
+          statusCode: 401
+        };
+      }
+    }
+    if (telemetry) {
+      telemetry.emit("fulmen.control.discovery.served", {
+        service: identity.app.binary_name
+      });
+    }
+    const runtime = buildRuntimeInfo({ identity, version });
+    return {
+      status: "ok",
+      service: {
+        name: identity.app.binary_name,
+        vendor: identity.app.vendor,
+        version
+      },
+      runtime: {
+        name: runtime.runtime.name,
+        version: runtime.runtime.version,
+        platform: runtime.platform.os,
+        arch: runtime.platform.arch
+      },
+      auth_summary: authSummary,
+      endpoints,
+      statusCode: 200
+    };
+  };
+}
+var init_control_discovery_endpoint = __esm({
+  "src/foundry/signals/control-discovery-endpoint.ts"() {
+    init_runtime();
+  }
+});
+
 // src/foundry/signals/convenience.ts
 async function onShutdown(manager, handler, options = {}) {
   await manager.register("SIGTERM", handler, options);
@@ -4092,7 +4329,7 @@ var init_guards = __esm({
 function createSignalEndpoint(options) {
   const { manager, auth, rateLimit, logger, telemetry, allowedSignals } = options;
   return async (payload, req) => {
-    const correlationId = payload.correlation_id ?? generateCorrelationId();
+    const correlationId = payload.correlation_id ?? generateCorrelationId2();
     const authResult = await auth(req);
     if (!authResult.authenticated) {
       if (logger) {
@@ -4215,7 +4452,7 @@ function normalizeSignalName(signal) {
   }
   return `SIG${upper}`;
 }
-function generateCorrelationId() {
+function generateCorrelationId2() {
   return `sig-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
 }
 function createBearerTokenAuth(expectedToken) {
@@ -4682,6 +4919,8 @@ var init_signals = __esm({
   "src/foundry/signals/index.ts"() {
     init_capabilities2();
     init_catalog();
+    init_config_reload_endpoint();
+    init_control_discovery_endpoint();
     init_convenience();
     init_double_tap();
     init_guards();
@@ -4827,7 +5066,9 @@ __export(foundry_exports, {
   clearMimeTypeCache: () => clearMimeTypeCache,
   clearPatternCache: () => clearPatternCache,
   createBearerTokenAuth: () => createBearerTokenAuth,
+  createConfigReloadEndpoint: () => createConfigReloadEndpoint,
   createConfigReloadHandler: () => createConfigReloadHandler,
+  createControlDiscoveryEndpoint: () => createControlDiscoveryEndpoint,
   createDoubleTapTracker: () => createDoubleTapTracker,
   createSignalEndpoint: () => createSignalEndpoint,
   createSignalManager: () => createSignalManager,
@@ -5884,6 +6125,7 @@ var init_cli = __esm({
 var VERSION2;
 var init_schema = __esm({
   "src/schema/index.ts"() {
+    init_ajv_formats();
     init_cli();
     init_errors();
     init_export();
@@ -5897,6 +6139,6 @@ var init_schema = __esm({
 });
 init_schema();
 
-export { ExportErrorReason, SchemaExportError, SchemaRegistry, SchemaValidationError, VERSION2 as VERSION, clearCache, compareSchemas, compileSchema, compileSchemaById, countDiagnostics, createCLI, createDiagnostic, detectGoneat, exportSchema, formatDiagnostics, formatValidationResult, getCacheSize, getSchema, getSchemaByPath, getSchemaRegistry, groupDiagnosticsBySeverity, hasSchema, isGoneatAvailable, isValidationError, listSchemas, normalizePointer, normalizeSchema, runGoneatValidation, stripProvenance, validateData, validateDataBySchemaId, validateFile, validateFileBySchemaId, validateSchema };
+export { ExportErrorReason, SchemaExportError, SchemaRegistry, SchemaValidationError, VERSION2 as VERSION, applyFulmenAjvFormats, clearCache, compareSchemas, compileSchema, compileSchemaById, countDiagnostics, createCLI, createDiagnostic, detectGoneat, exportSchema, formatDiagnostics, formatValidationResult, getCacheSize, getSchema, getSchemaByPath, getSchemaRegistry, groupDiagnosticsBySeverity, hasSchema, isGoneatAvailable, isValidationError, listSchemas, normalizePointer, normalizeSchema, runGoneatValidation, stripProvenance, validateData, validateDataBySchemaId, validateFile, validateFileBySchemaId, validateSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map