@eclesia/indexer-engine 2.9.9 → 2.10.0-next.0

package/dist/validation/index.cjs

@@ -0,0 +1,150 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_index = require('../errors/index.cjs');
+let fs = require("fs");
+fs = require_rolldown_runtime.__toESM(fs);
+
+//#region src/validation/index.ts
+/**
+* Configuration validation utilities for the Eclesia indexer
+* Validates configuration parameters before initialization
+*/
+var validation_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	getChainPrefix: () => getChainPrefix,
+	validateFilePath: () => validateFilePath,
+	validatePort: () => validatePort,
+	validatePositiveInteger: () => validatePositiveInteger,
+	validatePostgresConnectionString: () => validatePostgresConnectionString,
+	validateUrl: () => validateUrl
+});
+/**
+* Validates a URL string
+* @param url - The URL to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If URL is invalid
+*/
+function validateUrl(url, fieldName = "URL") {
+	if (!url || typeof url !== "string") throw new require_index.ConfigurationError(`${fieldName} is required and must be a string`, {
+		fieldName,
+		value: url
+	});
+	try {
+		const parsed = new URL(url);
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:" && parsed.protocol !== "ws:" && parsed.protocol !== "wss:") throw new require_index.ConfigurationError(`${fieldName} must use http, https, ws, or wss protocol`, {
+			fieldName,
+			url,
+			protocol: parsed.protocol
+		});
+		if (!parsed.hostname) throw new require_index.ConfigurationError(`${fieldName} must include a hostname`, {
+			fieldName,
+			url
+		});
+	} catch (error) {
+		if (error instanceof require_index.ConfigurationError) throw error;
+		throw new require_index.ConfigurationError(`${fieldName} is not a valid URL: ${error}`, {
+			fieldName,
+			url
+		});
+	}
+}
+/**
+* Validates a file path exists and is readable
+* @param filePath - The file path to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If file doesn't exist or isn't readable
+*/
+function validateFilePath(filePath, fieldName = "File path") {
+	if (!filePath || typeof filePath !== "string") throw new require_index.ConfigurationError(`${fieldName} is required and must be a string`, {
+		fieldName,
+		value: filePath
+	});
+	if (!fs.existsSync(filePath)) throw new require_index.ConfigurationError(`${fieldName} does not exist: ${filePath}`, {
+		fieldName,
+		filePath
+	});
+	try {
+		fs.accessSync(filePath, fs.constants.R_OK);
+	} catch (error) {
+		throw new require_index.ConfigurationError(`${fieldName} is not readable: ${filePath}`, {
+			fieldName,
+			filePath,
+			error: String(error)
+		});
+	}
+}
+/**
+* Validates a PostgreSQL connection string
+* @param connectionString - The connection string to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If connection string is invalid
+*/
+function validatePostgresConnectionString(connectionString, fieldName = "Database connection string") {
+	if (!connectionString || typeof connectionString !== "string") throw new require_index.ConfigurationError(`${fieldName} is required and must be a string`, {
+		fieldName,
+		value: connectionString
+	});
+	if (!/^postgres(?:ql)?:\/\/(?:([^:]+)(?::([^@]+))?@)?([^:/]+)(?::(\d+))?\/(.+)$/.test(connectionString)) throw new require_index.ConfigurationError(`${fieldName} must be in format: postgres://user:password@host:port/database`, {
+		fieldName,
+		format: "postgres://user:password@host:port/database"
+	});
+}
+/**
+* Validates a port number
+* @param port - The port number to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If port is invalid
+*/
+function validatePort(port, fieldName = "Port") {
+	if (typeof port !== "number" || !Number.isInteger(port)) throw new require_index.ConfigurationError(`${fieldName} must be an integer`, {
+		fieldName,
+		value: port
+	});
+	if (port < 1 || port > 65535) throw new require_index.ConfigurationError(`${fieldName} must be between 1 and 65535`, {
+		fieldName,
+		value: port,
+		min: 1,
+		max: 65535
+	});
+}
+/**
+* Validates a positive integer
+* @param value - The value to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If value is not a positive integer
+*/
+function validatePositiveInteger(value, fieldName = "Value") {
+	if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) throw new require_index.ConfigurationError(`${fieldName} must be a positive integer`, {
+		fieldName,
+		value
+	});
+}
+/**
+* Gets and validates the chain prefix from environment variables
+* @param defaultPrefix - Default prefix to use if environment variable is not set
+* @returns The validated chain prefix
+* @throws {ConfigurationError} If chain prefix is invalid
+*/
+function getChainPrefix(defaultPrefix = "cosmos") {
+	const prefix = process.env.CHAIN_PREFIX ?? defaultPrefix;
+	if (!prefix || typeof prefix !== "string") throw new require_index.ConfigurationError("CHAIN_PREFIX must be a non-empty string", {
+		value: prefix,
+		defaultPrefix
+	});
+	if (!/^[a-z][a-z0-9]*$/.test(prefix)) throw new require_index.ConfigurationError("CHAIN_PREFIX must start with lowercase letter and contain only lowercase letters and numbers", {
+		value: prefix,
+		pattern: "^[a-z][a-z0-9]*$"
+	});
+	return prefix;
+}
+
+//#endregion
+exports.validateFilePath = validateFilePath;
+exports.validatePort = validatePort;
+exports.validatePositiveInteger = validatePositiveInteger;
+exports.validateUrl = validateUrl;
+Object.defineProperty(exports, 'validation_exports', {
+  enumerable: true,
+  get: function () {
+    return validation_exports;
+  }
+});
+//# sourceMappingURL=index.cjs.map

package/dist/validation/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["ConfigurationError"],"sources":["../../src/validation/index.ts"],"sourcesContent":["/**\n * Configuration validation utilities for the Eclesia indexer\n * Validates configuration parameters before initialization\n */\n\nimport * as fs from \"node:fs\";\n\nimport {\n  ConfigurationError,\n} from \"../errors/index.js\";\n\n/**\n * Validates a URL string\n * @param url - The URL to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If URL is invalid\n */\nexport function validateUrl(url: string, fieldName: string = \"URL\"): void {\n  if (!url || typeof url !== \"string\") {\n    throw new ConfigurationError(`${fieldName} is required and must be a string`, {\n      fieldName,\n      value: url,\n    });\n  }\n\n  try {\n    const parsed = new URL(url);\n\n    // Ensure protocol is http or https\n    if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\" && parsed.protocol !== \"ws:\" && parsed.protocol !== \"wss:\") {\n      throw new ConfigurationError(`${fieldName} must use http, https, ws, or wss protocol`, {\n        fieldName,\n        url,\n        protocol: parsed.protocol,\n      });\n    }\n\n    // Ensure hostname is present\n    if (!parsed.hostname) {\n      throw new ConfigurationError(`${fieldName} must include a hostname`, {\n        fieldName,\n        url,\n      });\n    }\n  }\n  catch (error) {\n    if (error instanceof ConfigurationError) {\n      throw error;\n    }\n    throw new ConfigurationError(`${fieldName} is not a valid URL: ${error}`, {\n      fieldName,\n      url,\n    });\n  }\n}\n\n/**\n * Validates a file path exists and is readable\n * @param filePath - The file path to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If file doesn't exist or isn't readable\n */\nexport function validateFilePath(filePath: string, fieldName: string = \"File path\"): void {\n  if (!filePath || typeof filePath !== \"string\") {\n    throw new ConfigurationError(`${fieldName} is required and must be a string`, {\n      fieldName,\n      value: filePath,\n    });\n  }\n\n  if (!fs.existsSync(filePath)) {\n    throw new ConfigurationError(`${fieldName} does not exist: ${filePath}`, {\n      fieldName,\n      filePath,\n    });\n  }\n\n  try {\n    fs.accessSync(filePath, fs.constants.R_OK);\n  }\n  catch (error) {\n    throw new ConfigurationError(`${fieldName} is not readable: ${filePath}`, {\n      fieldName,\n      filePath,\n      error: String(error),\n    });\n  }\n}\n\n/**\n * Validates a PostgreSQL connection string\n * @param connectionString - The connection string to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If connection string is invalid\n */\nexport function validatePostgresConnectionString(\n  connectionString: string,\n  fieldName: string = \"Database connection string\",\n): void {\n  if (!connectionString || typeof connectionString !== \"string\") {\n    throw new ConfigurationError(`${fieldName} is required and must be a string`, {\n      fieldName,\n      value: connectionString,\n    });\n  }\n\n  // Basic PostgreSQL connection string format validation\n  // Format: postgres://user:password@host:port/database\n  const pgRegex = /^postgres(?:ql)?:\\/\\/(?:([^:]+)(?::([^@]+))?@)?([^:/]+)(?::(\\d+))?\\/(.+)$/;\n\n  if (!pgRegex.test(connectionString)) {\n    throw new ConfigurationError(\n      `${fieldName} must be in format: postgres://user:password@host:port/database`,\n      {\n        fieldName,\n        format: \"postgres://user:password@host:port/database\",\n      },\n    );\n  }\n}\n\n/**\n * Validates a port number\n * @param port - The port number to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If port is invalid\n */\nexport function validatePort(port: number, fieldName: string = \"Port\"): void {\n  if (typeof port !== \"number\" || !Number.isInteger(port)) {\n    throw new ConfigurationError(`${fieldName} must be an integer`, {\n      fieldName,\n      value: port,\n    });\n  }\n\n  if (port < 1 || port > 65535) {\n    throw new ConfigurationError(`${fieldName} must be between 1 and 65535`, {\n      fieldName,\n      value: port,\n      min: 1,\n      max: 65535,\n    });\n  }\n}\n\n/**\n * Validates a positive integer\n * @param value - The value to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If value is not a positive integer\n */\nexport function validatePositiveInteger(value: number, fieldName: string = \"Value\"): void {\n  if (typeof value !== \"number\" || !Number.isInteger(value) || value <= 0) {\n    throw new ConfigurationError(`${fieldName} must be a positive integer`, {\n      fieldName,\n      value,\n    });\n  }\n}\n\n/**\n * Gets and validates the chain prefix from environment variables\n * @param defaultPrefix - Default prefix to use if environment variable is not set\n * @returns The validated chain prefix\n * @throws {ConfigurationError} If chain prefix is invalid\n */\nexport function getChainPrefix(defaultPrefix: string = \"cosmos\"): string {\n  const prefix = process.env.CHAIN_PREFIX ?? defaultPrefix;\n\n  if (!prefix || typeof prefix !== \"string\") {\n    throw new ConfigurationError(\"CHAIN_PREFIX must be a non-empty string\", {\n      value: prefix,\n      defaultPrefix,\n    });\n  }\n\n  // Validate prefix format (lowercase alphanumeric)\n  if (!/^[a-z][a-z0-9]*$/.test(prefix)) {\n    throw new ConfigurationError(\n      \"CHAIN_PREFIX must start with lowercase letter and contain only lowercase letters and numbers\",\n      {\n        value: prefix,\n        pattern: \"^[a-z][a-z0-9]*$\",\n      },\n    );\n  }\n\n  return prefix;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,YAAY,KAAa,YAAoB,OAAa;AACxE,KAAI,CAAC,OAAO,OAAO,QAAQ,SACzB,OAAM,IAAIA,iCAAmB,GAAG,UAAU,oCAAoC;EAC5E;EACA,OAAO;EACR,CAAC;AAGJ,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,IAAI;AAG3B,MAAI,OAAO,aAAa,WAAW,OAAO,aAAa,YAAY,OAAO,aAAa,SAAS,OAAO,aAAa,OAClH,OAAM,IAAIA,iCAAmB,GAAG,UAAU,6CAA6C;GACrF;GACA;GACA,UAAU,OAAO;GAClB,CAAC;AAIJ,MAAI,CAAC,OAAO,SACV,OAAM,IAAIA,iCAAmB,GAAG,UAAU,2BAA2B;GACnE;GACA;GACD,CAAC;UAGC,OAAO;AACZ,MAAI,iBAAiBA,iCACnB,OAAM;AAER,QAAM,IAAIA,iCAAmB,GAAG,UAAU,uBAAuB,SAAS;GACxE;GACA;GACD,CAAC;;;;;;;;;AAUN,SAAgB,iBAAiB,UAAkB,YAAoB,aAAmB;AACxF,KAAI,CAAC,YAAY,OAAO,aAAa,SACnC,OAAM,IAAIA,iCAAmB,GAAG,UAAU,oCAAoC;EAC5E;EACA,OAAO;EACR,CAAC;AAGJ,KAAI,CAAC,GAAG,WAAW,SAAS,CAC1B,OAAM,IAAIA,iCAAmB,GAAG,UAAU,mBAAmB,YAAY;EACvE;EACA;EACD,CAAC;AAGJ,KAAI;AACF,KAAG,WAAW,UAAU,GAAG,UAAU,KAAK;UAErC,OAAO;AACZ,QAAM,IAAIA,iCAAmB,GAAG,UAAU,oBAAoB,YAAY;GACxE;GACA;GACA,OAAO,OAAO,MAAM;GACrB,CAAC;;;;;;;;;AAUN,SAAgB,iCACd,kBACA,YAAoB,8BACd;AACN,KAAI,CAAC,oBAAoB,OAAO,qBAAqB,SACnD,OAAM,IAAIA,iCAAmB,GAAG,UAAU,oCAAoC;EAC5E;EACA,OAAO;EACR,CAAC;AAOJ,KAAI,CAFY,4EAEH,KAAK,iBAAiB,CACjC,OAAM,IAAIA,iCACR,GAAG,UAAU,kEACb;EACE;EACA,QAAQ;EACT,CACF;;;;;;;;AAUL,SAAgB,aAAa,MAAc,YAAoB,QAAc;AAC3E,KAAI,OAAO,SAAS,YAAY,CAAC,OAAO,UAAU,KAAK,CACrD,OAAM,IAAIA,iCAAmB,GAAG,UAAU,sBAAsB;EAC9D;EACA,OAAO;EACR,CAAC;AAGJ,KAAI,OAAO,KAAK,OAAO,MACrB,OAAM,IAAIA,iCAAmB,GAAG,UAAU,+BAA+B;EACvE;EACA,OAAO;EACP,KAAK;EACL,KAAK;EACN,CAAC;;;;;;;;AAUN,SAAgB,wBAAwB,OAAe,YAAoB,SAAe;AACxF,KAAI,OAAO,UAAU,YAAY,CAAC,OAAO,UAAU,MAAM,IAAI,SAAS,EACpE,OAAM,IAAIA,iCAAmB,GAAG,UAAU,8BAA8B;EACtE;EACA;EACD,CAAC;;;;;;;;AAUN,SAAgB,eAAe,gBAAwB,UAAkB;CACvE,MAAM,SAAS,QAAQ,IAAI,gBAAgB;AAE3C,KAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,OAAM,IAAIA,iCAAmB,2CAA2C;EACtE,OAAO;EACP;EACD,CAAC;AAIJ,KAAI,CAAC,mBAAmB,KAAK,OAAO,CAClC,OAAM,IAAIA,iCACR,gGACA;EACE,OAAO;EACP,SAAS;EACV,CACF;AAGH,QAAO"}

package/dist/validation/index.d.cts

@@ -0,0 +1,52 @@
+declare namespace index_d_exports {
+  export { getChainPrefix, validateFilePath, validatePort, validatePositiveInteger, validatePostgresConnectionString, validateUrl };
+}
+/**
+ * Configuration validation utilities for the Eclesia indexer
+ * Validates configuration parameters before initialization
+ */
+/**
+ * Validates a URL string
+ * @param url - The URL to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If URL is invalid
+ */
+declare function validateUrl(url: string, fieldName?: string): void;
+/**
+ * Validates a file path exists and is readable
+ * @param filePath - The file path to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If file doesn't exist or isn't readable
+ */
+declare function validateFilePath(filePath: string, fieldName?: string): void;
+/**
+ * Validates a PostgreSQL connection string
+ * @param connectionString - The connection string to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If connection string is invalid
+ */
+declare function validatePostgresConnectionString(connectionString: string, fieldName?: string): void;
+/**
+ * Validates a port number
+ * @param port - The port number to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If port is invalid
+ */
+declare function validatePort(port: number, fieldName?: string): void;
+/**
+ * Validates a positive integer
+ * @param value - The value to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If value is not a positive integer
+ */
+declare function validatePositiveInteger(value: number, fieldName?: string): void;
+/**
+ * Gets and validates the chain prefix from environment variables
+ * @param defaultPrefix - Default prefix to use if environment variable is not set
+ * @returns The validated chain prefix
+ * @throws {ConfigurationError} If chain prefix is invalid
+ */
+declare function getChainPrefix(defaultPrefix?: string): string;
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.cts.map

package/dist/validation/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/validation/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;iBAiBgB,WAAA;AAAhB;AA6CA;AAiCA;AAgCA;AAwBA;AAeA;iBAxGgB,gBAAA;;;;;;;iBAiCA,gCAAA;;;;;;;iBAgCA,YAAA;;;;;;;iBAwBA,uBAAA;;;;;;;iBAeA,cAAA"}

package/dist/validation/index.d.ts

@@ -0,0 +1,52 @@
+declare namespace index_d_exports {
+  export { getChainPrefix, validateFilePath, validatePort, validatePositiveInteger, validatePostgresConnectionString, validateUrl };
+}
+/**
+ * Configuration validation utilities for the Eclesia indexer
+ * Validates configuration parameters before initialization
+ */
+/**
+ * Validates a URL string
+ * @param url - The URL to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If URL is invalid
+ */
+declare function validateUrl(url: string, fieldName?: string): void;
+/**
+ * Validates a file path exists and is readable
+ * @param filePath - The file path to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If file doesn't exist or isn't readable
+ */
+declare function validateFilePath(filePath: string, fieldName?: string): void;
+/**
+ * Validates a PostgreSQL connection string
+ * @param connectionString - The connection string to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If connection string is invalid
+ */
+declare function validatePostgresConnectionString(connectionString: string, fieldName?: string): void;
+/**
+ * Validates a port number
+ * @param port - The port number to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If port is invalid
+ */
+declare function validatePort(port: number, fieldName?: string): void;
+/**
+ * Validates a positive integer
+ * @param value - The value to validate
+ * @param fieldName - Name of the field for error messages
+ * @throws {ConfigurationError} If value is not a positive integer
+ */
+declare function validatePositiveInteger(value: number, fieldName?: string): void;
+/**
+ * Gets and validates the chain prefix from environment variables
+ * @param defaultPrefix - Default prefix to use if environment variable is not set
+ * @returns The validated chain prefix
+ * @throws {ConfigurationError} If chain prefix is invalid
+ */
+declare function getChainPrefix(defaultPrefix?: string): string;
+//#endregion
+export { index_d_exports };
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/validation/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;iBAiBgB,WAAA;AAAhB;AA6CA;AAiCA;AAgCA;AAwBA;AAeA;iBAxGgB,gBAAA;;;;;;;iBAiCA,gCAAA;;;;;;;iBAgCA,YAAA;;;;;;;iBAwBA,uBAAA;;;;;;;iBAeA,cAAA"}

package/dist/validation/index.js

@@ -0,0 +1,140 @@
+import { __export } from "../_virtual/rolldown_runtime.js";
+import { ConfigurationError } from "../errors/index.js";
+import * as fs from "node:fs";
+
+//#region src/validation/index.ts
+/**
+* Configuration validation utilities for the Eclesia indexer
+* Validates configuration parameters before initialization
+*/
+var validation_exports = /* @__PURE__ */ __export({
+	getChainPrefix: () => getChainPrefix,
+	validateFilePath: () => validateFilePath,
+	validatePort: () => validatePort,
+	validatePositiveInteger: () => validatePositiveInteger,
+	validatePostgresConnectionString: () => validatePostgresConnectionString,
+	validateUrl: () => validateUrl
+});
+/**
+* Validates a URL string
+* @param url - The URL to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If URL is invalid
+*/
+function validateUrl(url, fieldName = "URL") {
+	if (!url || typeof url !== "string") throw new ConfigurationError(`${fieldName} is required and must be a string`, {
+		fieldName,
+		value: url
+	});
+	try {
+		const parsed = new URL(url);
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:" && parsed.protocol !== "ws:" && parsed.protocol !== "wss:") throw new ConfigurationError(`${fieldName} must use http, https, ws, or wss protocol`, {
+			fieldName,
+			url,
+			protocol: parsed.protocol
+		});
+		if (!parsed.hostname) throw new ConfigurationError(`${fieldName} must include a hostname`, {
+			fieldName,
+			url
+		});
+	} catch (error) {
+		if (error instanceof ConfigurationError) throw error;
+		throw new ConfigurationError(`${fieldName} is not a valid URL: ${error}`, {
+			fieldName,
+			url
+		});
+	}
+}
+/**
+* Validates a file path exists and is readable
+* @param filePath - The file path to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If file doesn't exist or isn't readable
+*/
+function validateFilePath(filePath, fieldName = "File path") {
+	if (!filePath || typeof filePath !== "string") throw new ConfigurationError(`${fieldName} is required and must be a string`, {
+		fieldName,
+		value: filePath
+	});
+	if (!fs.existsSync(filePath)) throw new ConfigurationError(`${fieldName} does not exist: ${filePath}`, {
+		fieldName,
+		filePath
+	});
+	try {
+		fs.accessSync(filePath, fs.constants.R_OK);
+	} catch (error) {
+		throw new ConfigurationError(`${fieldName} is not readable: ${filePath}`, {
+			fieldName,
+			filePath,
+			error: String(error)
+		});
+	}
+}
+/**
+* Validates a PostgreSQL connection string
+* @param connectionString - The connection string to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If connection string is invalid
+*/
+function validatePostgresConnectionString(connectionString, fieldName = "Database connection string") {
+	if (!connectionString || typeof connectionString !== "string") throw new ConfigurationError(`${fieldName} is required and must be a string`, {
+		fieldName,
+		value: connectionString
+	});
+	if (!/^postgres(?:ql)?:\/\/(?:([^:]+)(?::([^@]+))?@)?([^:/]+)(?::(\d+))?\/(.+)$/.test(connectionString)) throw new ConfigurationError(`${fieldName} must be in format: postgres://user:password@host:port/database`, {
+		fieldName,
+		format: "postgres://user:password@host:port/database"
+	});
+}
+/**
+* Validates a port number
+* @param port - The port number to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If port is invalid
+*/
+function validatePort(port, fieldName = "Port") {
+	if (typeof port !== "number" || !Number.isInteger(port)) throw new ConfigurationError(`${fieldName} must be an integer`, {
+		fieldName,
+		value: port
+	});
+	if (port < 1 || port > 65535) throw new ConfigurationError(`${fieldName} must be between 1 and 65535`, {
+		fieldName,
+		value: port,
+		min: 1,
+		max: 65535
+	});
+}
+/**
+* Validates a positive integer
+* @param value - The value to validate
+* @param fieldName - Name of the field for error messages
+* @throws {ConfigurationError} If value is not a positive integer
+*/
+function validatePositiveInteger(value, fieldName = "Value") {
+	if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) throw new ConfigurationError(`${fieldName} must be a positive integer`, {
+		fieldName,
+		value
+	});
+}
+/**
+* Gets and validates the chain prefix from environment variables
+* @param defaultPrefix - Default prefix to use if environment variable is not set
+* @returns The validated chain prefix
+* @throws {ConfigurationError} If chain prefix is invalid
+*/
+function getChainPrefix(defaultPrefix = "cosmos") {
+	const prefix = process.env.CHAIN_PREFIX ?? defaultPrefix;
+	if (!prefix || typeof prefix !== "string") throw new ConfigurationError("CHAIN_PREFIX must be a non-empty string", {
+		value: prefix,
+		defaultPrefix
+	});
+	if (!/^[a-z][a-z0-9]*$/.test(prefix)) throw new ConfigurationError("CHAIN_PREFIX must start with lowercase letter and contain only lowercase letters and numbers", {
+		value: prefix,
+		pattern: "^[a-z][a-z0-9]*$"
+	});
+	return prefix;
+}
+
+//#endregion
+export { validateFilePath, validatePort, validatePositiveInteger, validateUrl, validation_exports };
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/validation/index.ts"],"sourcesContent":["/**\n * Configuration validation utilities for the Eclesia indexer\n * Validates configuration parameters before initialization\n */\n\nimport * as fs from \"node:fs\";\n\nimport {\n  ConfigurationError,\n} from \"../errors/index.js\";\n\n/**\n * Validates a URL string\n * @param url - The URL to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If URL is invalid\n */\nexport function validateUrl(url: string, fieldName: string = \"URL\"): void {\n  if (!url || typeof url !== \"string\") {\n    throw new ConfigurationError(`${fieldName} is required and must be a string`, {\n      fieldName,\n      value: url,\n    });\n  }\n\n  try {\n    const parsed = new URL(url);\n\n    // Ensure protocol is http or https\n    if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\" && parsed.protocol !== \"ws:\" && parsed.protocol !== \"wss:\") {\n      throw new ConfigurationError(`${fieldName} must use http, https, ws, or wss protocol`, {\n        fieldName,\n        url,\n        protocol: parsed.protocol,\n      });\n    }\n\n    // Ensure hostname is present\n    if (!parsed.hostname) {\n      throw new ConfigurationError(`${fieldName} must include a hostname`, {\n        fieldName,\n        url,\n      });\n    }\n  }\n  catch (error) {\n    if (error instanceof ConfigurationError) {\n      throw error;\n    }\n    throw new ConfigurationError(`${fieldName} is not a valid URL: ${error}`, {\n      fieldName,\n      url,\n    });\n  }\n}\n\n/**\n * Validates a file path exists and is readable\n * @param filePath - The file path to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If file doesn't exist or isn't readable\n */\nexport function validateFilePath(filePath: string, fieldName: string = \"File path\"): void {\n  if (!filePath || typeof filePath !== \"string\") {\n    throw new ConfigurationError(`${fieldName} is required and must be a string`, {\n      fieldName,\n      value: filePath,\n    });\n  }\n\n  if (!fs.existsSync(filePath)) {\n    throw new ConfigurationError(`${fieldName} does not exist: ${filePath}`, {\n      fieldName,\n      filePath,\n    });\n  }\n\n  try {\n    fs.accessSync(filePath, fs.constants.R_OK);\n  }\n  catch (error) {\n    throw new ConfigurationError(`${fieldName} is not readable: ${filePath}`, {\n      fieldName,\n      filePath,\n      error: String(error),\n    });\n  }\n}\n\n/**\n * Validates a PostgreSQL connection string\n * @param connectionString - The connection string to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If connection string is invalid\n */\nexport function validatePostgresConnectionString(\n  connectionString: string,\n  fieldName: string = \"Database connection string\",\n): void {\n  if (!connectionString || typeof connectionString !== \"string\") {\n    throw new ConfigurationError(`${fieldName} is required and must be a string`, {\n      fieldName,\n      value: connectionString,\n    });\n  }\n\n  // Basic PostgreSQL connection string format validation\n  // Format: postgres://user:password@host:port/database\n  const pgRegex = /^postgres(?:ql)?:\\/\\/(?:([^:]+)(?::([^@]+))?@)?([^:/]+)(?::(\\d+))?\\/(.+)$/;\n\n  if (!pgRegex.test(connectionString)) {\n    throw new ConfigurationError(\n      `${fieldName} must be in format: postgres://user:password@host:port/database`,\n      {\n        fieldName,\n        format: \"postgres://user:password@host:port/database\",\n      },\n    );\n  }\n}\n\n/**\n * Validates a port number\n * @param port - The port number to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If port is invalid\n */\nexport function validatePort(port: number, fieldName: string = \"Port\"): void {\n  if (typeof port !== \"number\" || !Number.isInteger(port)) {\n    throw new ConfigurationError(`${fieldName} must be an integer`, {\n      fieldName,\n      value: port,\n    });\n  }\n\n  if (port < 1 || port > 65535) {\n    throw new ConfigurationError(`${fieldName} must be between 1 and 65535`, {\n      fieldName,\n      value: port,\n      min: 1,\n      max: 65535,\n    });\n  }\n}\n\n/**\n * Validates a positive integer\n * @param value - The value to validate\n * @param fieldName - Name of the field for error messages\n * @throws {ConfigurationError} If value is not a positive integer\n */\nexport function validatePositiveInteger(value: number, fieldName: string = \"Value\"): void {\n  if (typeof value !== \"number\" || !Number.isInteger(value) || value <= 0) {\n    throw new ConfigurationError(`${fieldName} must be a positive integer`, {\n      fieldName,\n      value,\n    });\n  }\n}\n\n/**\n * Gets and validates the chain prefix from environment variables\n * @param defaultPrefix - Default prefix to use if environment variable is not set\n * @returns The validated chain prefix\n * @throws {ConfigurationError} If chain prefix is invalid\n */\nexport function getChainPrefix(defaultPrefix: string = \"cosmos\"): string {\n  const prefix = process.env.CHAIN_PREFIX ?? defaultPrefix;\n\n  if (!prefix || typeof prefix !== \"string\") {\n    throw new ConfigurationError(\"CHAIN_PREFIX must be a non-empty string\", {\n      value: prefix,\n      defaultPrefix,\n    });\n  }\n\n  // Validate prefix format (lowercase alphanumeric)\n  if (!/^[a-z][a-z0-9]*$/.test(prefix)) {\n    throw new ConfigurationError(\n      \"CHAIN_PREFIX must start with lowercase letter and contain only lowercase letters and numbers\",\n      {\n        value: prefix,\n        pattern: \"^[a-z][a-z0-9]*$\",\n      },\n    );\n  }\n\n  return prefix;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,YAAY,KAAa,YAAoB,OAAa;AACxE,KAAI,CAAC,OAAO,OAAO,QAAQ,SACzB,OAAM,IAAI,mBAAmB,GAAG,UAAU,oCAAoC;EAC5E;EACA,OAAO;EACR,CAAC;AAGJ,KAAI;EACF,MAAM,SAAS,IAAI,IAAI,IAAI;AAG3B,MAAI,OAAO,aAAa,WAAW,OAAO,aAAa,YAAY,OAAO,aAAa,SAAS,OAAO,aAAa,OAClH,OAAM,IAAI,mBAAmB,GAAG,UAAU,6CAA6C;GACrF;GACA;GACA,UAAU,OAAO;GAClB,CAAC;AAIJ,MAAI,CAAC,OAAO,SACV,OAAM,IAAI,mBAAmB,GAAG,UAAU,2BAA2B;GACnE;GACA;GACD,CAAC;UAGC,OAAO;AACZ,MAAI,iBAAiB,mBACnB,OAAM;AAER,QAAM,IAAI,mBAAmB,GAAG,UAAU,uBAAuB,SAAS;GACxE;GACA;GACD,CAAC;;;;;;;;;AAUN,SAAgB,iBAAiB,UAAkB,YAAoB,aAAmB;AACxF,KAAI,CAAC,YAAY,OAAO,aAAa,SACnC,OAAM,IAAI,mBAAmB,GAAG,UAAU,oCAAoC;EAC5E;EACA,OAAO;EACR,CAAC;AAGJ,KAAI,CAAC,GAAG,WAAW,SAAS,CAC1B,OAAM,IAAI,mBAAmB,GAAG,UAAU,mBAAmB,YAAY;EACvE;EACA;EACD,CAAC;AAGJ,KAAI;AACF,KAAG,WAAW,UAAU,GAAG,UAAU,KAAK;UAErC,OAAO;AACZ,QAAM,IAAI,mBAAmB,GAAG,UAAU,oBAAoB,YAAY;GACxE;GACA;GACA,OAAO,OAAO,MAAM;GACrB,CAAC;;;;;;;;;AAUN,SAAgB,iCACd,kBACA,YAAoB,8BACd;AACN,KAAI,CAAC,oBAAoB,OAAO,qBAAqB,SACnD,OAAM,IAAI,mBAAmB,GAAG,UAAU,oCAAoC;EAC5E;EACA,OAAO;EACR,CAAC;AAOJ,KAAI,CAFY,4EAEH,KAAK,iBAAiB,CACjC,OAAM,IAAI,mBACR,GAAG,UAAU,kEACb;EACE;EACA,QAAQ;EACT,CACF;;;;;;;;AAUL,SAAgB,aAAa,MAAc,YAAoB,QAAc;AAC3E,KAAI,OAAO,SAAS,YAAY,CAAC,OAAO,UAAU,KAAK,CACrD,OAAM,IAAI,mBAAmB,GAAG,UAAU,sBAAsB;EAC9D;EACA,OAAO;EACR,CAAC;AAGJ,KAAI,OAAO,KAAK,OAAO,MACrB,OAAM,IAAI,mBAAmB,GAAG,UAAU,+BAA+B;EACvE;EACA,OAAO;EACP,KAAK;EACL,KAAK;EACN,CAAC;;;;;;;;AAUN,SAAgB,wBAAwB,OAAe,YAAoB,SAAe;AACxF,KAAI,OAAO,UAAU,YAAY,CAAC,OAAO,UAAU,MAAM,IAAI,SAAS,EACpE,OAAM,IAAI,mBAAmB,GAAG,UAAU,8BAA8B;EACtE;EACA;EACD,CAAC;;;;;;;;AAUN,SAAgB,eAAe,gBAAwB,UAAkB;CACvE,MAAM,SAAS,QAAQ,IAAI,gBAAgB;AAE3C,KAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,OAAM,IAAI,mBAAmB,2CAA2C;EACtE,OAAO;EACP;EACD,CAAC;AAIJ,KAAI,CAAC,mBAAmB,KAAK,OAAO,CAClC,OAAM,IAAI,mBACR,gGACA;EACE,OAAO;EACP,SAAS;EACV,CACF;AAGH,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eclesia/indexer-engine",
-  "version": "2.9.9",
+  "version": "2.10.0-next.0",
   "description": "Core eclesia indexer engine",
   "files": [
     "dist/",
@@ -40,6 +40,7 @@
     "cosmjs-types": "^0.10.1",
     "dayjs": "^1.11.18",
     "fastify": "^5.6.0",
+    "prom-client": "^15.1.3",
     "stream-chain": "^3.4.0",
     "stream-json": "^1.9.1",
     "uuid": "^13.0.0",
@@ -65,6 +66,7 @@
     "lint": "eslint",
     "lint:fix": "eslint --fix",
     "test": "vitest",
+    "typecheck": "tsc --noEmit",
     "start": "node dist/index.mjs"
   }
 }