@axova/shared 1.0.0

package/dist/configs/index.js

@@ -0,0 +1,555 @@
+"use strict";
+// =============================================================================
+// AXOVA SHARED CONFIGURATIONS
+// Service-specific configuration profiles for the Axova platform
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICE_PROFILES = exports.OXA_SERVICE_PROFILE = exports.ADMIN_API_SERVICE_PROFILE = exports.INVENTORY_SERVICE_PROFILE = exports.PRODUCT_SERVICE_PROFILE = exports.COMPLIANCE_SERVICE_PROFILE = exports.STORE_SERVICE_PROFILE = void 0;
+exports.getServiceProfile = getServiceProfile;
+exports.initializeServiceWithProfile = initializeServiceWithProfile;
+exports.validateServiceConfig = validateServiceConfig;
+const kafka_1 = require("../events/kafka");
+const serviceAuth_1 = require("../middleware/serviceAuth");
+// =============================================================================
+// Service-Specific Configurations
+// =============================================================================
+exports.STORE_SERVICE_PROFILE = {
+    base: {
+        serviceName: "store-service",
+        port: Number(process.env.PORT) || 3001,
+        host: process.env.HOST || "0.0.0.0",
+        environment: process.env.NODE_ENV || "development",
+        cors: {
+            origins: process.env.CORS_ORIGINS?.split(",") || [
+                "http://localhost:3000",
+            ],
+            credentials: true,
+        },
+        rateLimiting: {
+            max: Number(process.env.RATE_LIMIT_MAX) || 100,
+            timeWindow: process.env.RATE_LIMIT_WINDOW || "1 minute",
+        },
+    },
+    database: {
+        url: process.env.DATABASE_URL ||
+            "postgresql://postgres:password@localhost:5432/axova_store_db",
+        host: process.env.POSTGRES_HOST || "localhost",
+        port: Number(process.env.POSTGRES_PORT) || 5432,
+        user: process.env.POSTGRES_USER || "postgres",
+        password: process.env.POSTGRES_PASSWORD || "password",
+        database: process.env.POSTGRES_DB || "axova_store_db",
+        ssl: process.env.DB_SSL === "true",
+        poolSize: Number(process.env.DB_POOL_SIZE) || 10,
+    },
+    kafka: {
+        enabled: process.env.KAFKA_ENABLED !== "false",
+        clientId: process.env.KAFKA_CLIENT_ID || "store-service",
+        groupId: process.env.KAFKA_GROUP_ID || "store-service-group",
+        topics: [
+            "store.created",
+            "store.updated",
+            "store.deleted",
+            "store.business.updated",
+            "store.social.updated",
+            "store.blog.created",
+            "store.blog.updated",
+            "store.contact.updated",
+        ],
+        autoCommit: process.env.KAFKA_AUTO_COMMIT !== "false",
+    },
+    redis: {
+        host: process.env.REDIS_HOST || "localhost",
+        port: Number(process.env.REDIS_PORT) || 6379,
+        password: process.env.REDIS_PASSWORD,
+        db: Number(process.env.REDIS_DB) || 0,
+        ttl: Number(process.env.REDIS_TTL) || 3600,
+    },
+    audit: {
+        enabled: process.env.AUDIT_ENABLED !== "false",
+        level: process.env.AUDIT_LEVEL || "comprehensive",
+        bufferSize: Number(process.env.AUDIT_BUFFER_SIZE) || 100,
+        flushInterval: Number(process.env.AUDIT_FLUSH_INTERVAL) || 5000,
+        sensitiveFieldMasking: process.env.AUDIT_MASK_SENSITIVE !== "false",
+    },
+    features: {
+        realTimeSync: process.env.ENABLE_REAL_TIME_SYNC !== "false",
+        auditLogging: process.env.ENABLE_AUDIT_LOGGING !== "false",
+        advancedAnalytics: process.env.ENABLE_ADVANCED_ANALYTICS === "true",
+        multiTenant: true,
+        storeCustomization: true,
+        blogManagement: true,
+        socialProfiles: true,
+        businessDetails: true,
+        contactManagement: true,
+    },
+    customConfig: {
+        storeDomain: process.env.STORE_DOMAIN || "myaxova.store",
+        maxStoresPerUser: Number(process.env.MAX_STORES_PER_USER) || 5,
+        storeCustomizationLimits: {
+            maxThemes: 10,
+            maxPages: 50,
+            maxProducts: 10000,
+        },
+    },
+};
+exports.COMPLIANCE_SERVICE_PROFILE = {
+    base: {
+        serviceName: "compliance-service",
+        port: Number(process.env.PORT) || 3002,
+        host: process.env.HOST || "0.0.0.0",
+        environment: process.env.NODE_ENV || "development",
+        cors: {
+            origins: process.env.CORS_ORIGINS?.split(",") || [
+                "http://localhost:3000",
+            ],
+            credentials: true,
+        },
+        rateLimiting: {
+            max: Number(process.env.RATE_LIMIT_MAX) || 200,
+            timeWindow: process.env.RATE_LIMIT_WINDOW || "1 minute",
+        },
+    },
+    database: {
+        url: process.env.DATABASE_URL ||
+            "postgresql://postgres:password@localhost:5432/axova_compliance_db",
+        host: process.env.POSTGRES_HOST || "localhost",
+        port: Number(process.env.POSTGRES_PORT) || 5432,
+        user: process.env.POSTGRES_USER || "postgres",
+        password: process.env.POSTGRES_PASSWORD || "password",
+        database: process.env.POSTGRES_DB || "axova_compliance_db",
+        ssl: process.env.DB_SSL === "true",
+        poolSize: Number(process.env.DB_POOL_SIZE) || 15,
+    },
+    kafka: {
+        enabled: process.env.KAFKA_ENABLED !== "false",
+        clientId: process.env.KAFKA_CLIENT_ID || "compliance-service",
+        groupId: process.env.KAFKA_GROUP_ID || "compliance-service-group",
+        topics: [
+            "store.created",
+            "store.updated",
+            "compliance.violation.detected",
+            "compliance.violation.resolved",
+            "appeal.submitted",
+            "appeal.reviewed",
+            "store.suspended",
+            "store.unbanned",
+            "audit.logged",
+        ],
+        autoCommit: process.env.KAFKA_AUTO_COMMIT !== "false",
+    },
+    audit: {
+        enabled: process.env.AUDIT_ENABLED !== "false",
+        level: process.env.AUDIT_LEVEL || "comprehensive",
+        bufferSize: Number(process.env.AUDIT_BUFFER_SIZE) || 200,
+        flushInterval: Number(process.env.AUDIT_FLUSH_INTERVAL) || 3000,
+        sensitiveFieldMasking: process.env.AUDIT_MASK_SENSITIVE !== "false",
+    },
+    features: {
+        realTimeMonitoring: true,
+        automaticViolationDetection: true,
+        appealManagement: true,
+        riskAssessment: true,
+        complianceReporting: true,
+        auditTrails: true,
+        escalationMatrix: true,
+        mlBasedDetection: process.env.ENABLE_ML_DETECTION === "true",
+    },
+    customConfig: {
+        violationThresholds: {
+            low: 3,
+            medium: 5,
+            high: 2,
+            critical: 1,
+        },
+        appealProcessing: {
+            autoReviewEnabled: process.env.AUTO_REVIEW_APPEALS === "true",
+            maxAppealTime: Number(process.env.MAX_APPEAL_TIME) || 72, // hours
+            escalationLevels: 3,
+        },
+        suspensionRules: {
+            automaticSuspension: process.env.AUTO_SUSPEND === "true",
+            gracePeriod: Number(process.env.SUSPENSION_GRACE_PERIOD) || 24, // hours
+        },
+    },
+};
+exports.PRODUCT_SERVICE_PROFILE = {
+    base: {
+        serviceName: "product-service",
+        port: Number(process.env.PORT) || 3003,
+        host: process.env.HOST || "0.0.0.0",
+        environment: process.env.NODE_ENV || "development",
+        cors: {
+            origins: process.env.CORS_ORIGINS?.split(",") || [
+                "http://localhost:3000",
+            ],
+            credentials: true,
+        },
+        rateLimiting: {
+            max: Number(process.env.RATE_LIMIT_MAX) || 500,
+            timeWindow: process.env.RATE_LIMIT_WINDOW || "1 minute",
+        },
+    },
+    database: {
+        url: process.env.DATABASE_URL ||
+            "postgresql://postgres:password@localhost:5432/axova_product_db",
+        host: process.env.POSTGRES_HOST || "localhost",
+        port: Number(process.env.POSTGRES_PORT) || 5432,
+        user: process.env.POSTGRES_USER || "postgres",
+        password: process.env.POSTGRES_PASSWORD || "password",
+        database: process.env.POSTGRES_DB || "axova_product_db",
+        ssl: process.env.DB_SSL === "true",
+        poolSize: Number(process.env.DB_POOL_SIZE) || 20,
+    },
+    kafka: {
+        enabled: process.env.KAFKA_ENABLED !== "false",
+        clientId: process.env.KAFKA_CLIENT_ID || "product-service",
+        groupId: process.env.KAFKA_GROUP_ID || "product-service-group",
+        topics: [
+            "product.created",
+            "product.updated",
+            "product.deleted",
+            "variant.created",
+            "variant.updated",
+            "variant.deleted",
+            "collection.created",
+            "collection.updated",
+            "collection.deleted",
+            "inventory.updated",
+        ],
+        autoCommit: process.env.KAFKA_AUTO_COMMIT !== "false",
+    },
+    redis: {
+        host: process.env.REDIS_HOST || "localhost",
+        port: Number(process.env.REDIS_PORT) || 6379,
+        password: process.env.REDIS_PASSWORD,
+        db: Number(process.env.REDIS_DB) || 1,
+        ttl: Number(process.env.REDIS_TTL) || 7200,
+    },
+    audit: {
+        enabled: process.env.AUDIT_ENABLED !== "false",
+        level: process.env.AUDIT_LEVEL || "standard",
+        bufferSize: Number(process.env.AUDIT_BUFFER_SIZE) || 150,
+        flushInterval: Number(process.env.AUDIT_FLUSH_INTERVAL) || 4000,
+        sensitiveFieldMasking: process.env.AUDIT_MASK_SENSITIVE !== "false",
+    },
+    features: {
+        searchOptimization: true,
+        imageProcessing: true,
+        variantManagement: true,
+        collectionManagement: true,
+        bulkOperations: true,
+        seoOptimization: true,
+        analyticsIntegration: true,
+        recommendationEngine: process.env.ENABLE_RECOMMENDATIONS === "true",
+    },
+    customConfig: {
+        searchConfig: {
+            indexingEnabled: process.env.SEARCH_INDEXING !== "false",
+            elasticsearchUrl: process.env.ELASTICSEARCH_URL,
+            algoliaAppId: process.env.ALGOLIA_APP_ID,
+            algoliaApiKey: process.env.ALGOLIA_API_KEY,
+        },
+        imageProcessing: {
+            maxFileSize: Number(process.env.MAX_IMAGE_SIZE) || 10485760, // 10MB
+            allowedFormats: ["jpg", "jpeg", "png", "webp"],
+            autoOptimization: process.env.AUTO_OPTIMIZE_IMAGES !== "false",
+        },
+        productLimits: {
+            maxVariants: Number(process.env.MAX_VARIANTS_PER_PRODUCT) || 100,
+            maxImages: Number(process.env.MAX_IMAGES_PER_PRODUCT) || 20,
+            maxCategories: Number(process.env.MAX_CATEGORIES_PER_PRODUCT) || 5,
+        },
+    },
+};
+exports.INVENTORY_SERVICE_PROFILE = {
+    base: {
+        serviceName: "inventory-core-service",
+        port: Number(process.env.PORT) || 3005,
+        host: process.env.HOST || "0.0.0.0",
+        environment: process.env.NODE_ENV || "development",
+        cors: {
+            origins: process.env.CORS_ORIGINS?.split(",") || [
+                "http://localhost:3000",
+            ],
+            credentials: true,
+        },
+        rateLimiting: {
+            max: Number(process.env.RATE_LIMIT_MAX) || 300,
+            timeWindow: process.env.RATE_LIMIT_WINDOW || "1 minute",
+        },
+    },
+    database: {
+        url: process.env.DATABASE_URL ||
+            "postgresql://postgres:password@localhost:5432/inventory_core_db",
+        host: process.env.DB_HOST || "localhost",
+        port: Number(process.env.DB_PORT) || 5432,
+        user: process.env.DB_USER || "postgres",
+        password: process.env.DB_PASSWORD || "password",
+        database: process.env.DB_NAME || "inventory_core_db",
+        ssl: process.env.DB_SSL === "true",
+        poolSize: Number(process.env.DB_POOL_SIZE) || 15,
+    },
+    kafka: {
+        enabled: process.env.KAFKA_ENABLED !== "false",
+        clientId: process.env.KAFKA_CLIENT_ID || "inventory-core-service",
+        groupId: process.env.KAFKA_GROUP_ID || "inventory-core-group",
+        topics: [
+            "inventory.created",
+            "inventory.updated",
+            "inventory.adjusted",
+            "inventory.reserved",
+            "inventory.released",
+            "warehouse.created",
+            "warehouse.updated",
+            "pos.location.created",
+            "pos.location.updated",
+        ],
+        autoCommit: process.env.KAFKA_AUTO_COMMIT !== "false",
+    },
+    redis: {
+        host: process.env.REDIS_HOST || "localhost",
+        port: Number(process.env.REDIS_PORT) || 6379,
+        password: process.env.REDIS_PASSWORD,
+        db: Number(process.env.REDIS_DB) || 2,
+        ttl: Number(process.env.REDIS_TTL) || 1800,
+    },
+    audit: {
+        enabled: process.env.ENABLE_AUDIT_LOGGING !== "false",
+        level: process.env.AUDIT_LEVEL || "comprehensive",
+        bufferSize: Number(process.env.AUDIT_BUFFER_SIZE) || 200,
+        flushInterval: Number(process.env.AUDIT_FLUSH_INTERVAL) || 3000,
+        sensitiveFieldMasking: process.env.AUDIT_MASK_SENSITIVE !== "false",
+    },
+    features: {
+        realTimeSync: process.env.ENABLE_REAL_TIME_SYNC !== "false",
+        batchProcessing: process.env.ENABLE_BATCH_PROCESSING !== "false",
+        warehouseManagement: true,
+        posLocationManagement: true,
+        inventoryReservations: true,
+        movementTracking: true,
+        qualityControl: true,
+        supplierManagement: true,
+    },
+    customConfig: {
+        inventoryLimits: {
+            maxReservationTime: Number(process.env.MAX_RESERVATION_TIME) || 1440, // minutes
+            lowStockThreshold: Number(process.env.LOW_STOCK_THRESHOLD) || 10,
+            criticalStockThreshold: Number(process.env.CRITICAL_STOCK_THRESHOLD) || 5,
+        },
+        warehouseConfig: {
+            maxWarehouses: Number(process.env.MAX_WAREHOUSES) || 100,
+            maxLocationsPerWarehouse: Number(process.env.MAX_LOCATIONS_PER_WAREHOUSE) || 1000,
+        },
+        posConfig: {
+            maxPosLocations: Number(process.env.MAX_POS_LOCATIONS) || 500,
+            syncInterval: Number(process.env.POS_SYNC_INTERVAL) || 300, // seconds
+        },
+    },
+};
+exports.ADMIN_API_SERVICE_PROFILE = {
+    base: {
+        serviceName: "admin-api-service",
+        port: Number(process.env.PORT) || 3004,
+        host: process.env.HOST || "0.0.0.0",
+        environment: process.env.NODE_ENV || "development",
+        cors: {
+            origins: process.env.CORS_ORIGINS?.split(",") || [
+                "http://localhost:3000",
+            ],
+            credentials: true,
+        },
+        rateLimiting: {
+            max: Number(process.env.RATE_LIMIT_MAX) || 100,
+            timeWindow: process.env.RATE_LIMIT_WINDOW || "1 minute",
+        },
+    },
+    database: {
+        url: process.env.DATABASE_URL ||
+            "postgresql://postgres:password@localhost:5432/axova_admin_db",
+        host: process.env.POSTGRES_HOST || "localhost",
+        port: Number(process.env.POSTGRES_PORT) || 5432,
+        user: process.env.POSTGRES_USER || "postgres",
+        password: process.env.POSTGRES_PASSWORD || "password",
+        database: process.env.POSTGRES_DB || "axova_admin_db",
+        ssl: process.env.DB_SSL === "true",
+        poolSize: Number(process.env.DB_POOL_SIZE) || 10,
+    },
+    kafka: {
+        enabled: process.env.KAFKA_ENABLED !== "false",
+        clientId: process.env.KAFKA_CLIENT_ID || "admin-api-service",
+        groupId: process.env.KAFKA_GROUP_ID || "admin-api-service-group",
+        topics: [
+            "admin.action.performed",
+            "user.created",
+            "user.updated",
+            "user.deleted",
+            "system.configuration.changed",
+            "audit.requested",
+        ],
+        autoCommit: process.env.KAFKA_AUTO_COMMIT !== "false",
+    },
+    audit: {
+        enabled: process.env.AUDIT_ENABLED !== "false",
+        level: process.env.AUDIT_LEVEL || "comprehensive",
+        bufferSize: Number(process.env.AUDIT_BUFFER_SIZE) || 50,
+        flushInterval: Number(process.env.AUDIT_FLUSH_INTERVAL) || 2000,
+        sensitiveFieldMasking: process.env.AUDIT_MASK_SENSITIVE !== "false",
+    },
+    features: {
+        userManagement: true,
+        systemConfiguration: true,
+        auditReporting: true,
+        complianceMonitoring: true,
+        serviceManagement: true,
+        analyticsAccess: true,
+        backupManagement: true,
+        securityMonitoring: true,
+    },
+    customConfig: {
+        adminSecurity: {
+            mfaRequired: process.env.ADMIN_MFA_REQUIRED !== "false",
+            sessionTimeout: Number(process.env.ADMIN_SESSION_TIMEOUT) || 1800, // seconds
+            maxLoginAttempts: Number(process.env.MAX_LOGIN_ATTEMPTS) || 3,
+        },
+        permissions: {
+            superAdminRoles: process.env.SUPER_ADMIN_ROLES?.split(",") || [
+                "super_admin",
+            ],
+            adminRoles: process.env.ADMIN_ROLES?.split(",") || [
+                "admin",
+                "super_admin",
+            ],
+            moderatorRoles: process.env.MODERATOR_ROLES?.split(",") || [
+                "moderator",
+                "admin",
+                "super_admin",
+            ],
+        },
+    },
+};
+exports.OXA_SERVICE_PROFILE = {
+    base: {
+        serviceName: "oxa-service",
+        port: Number(process.env.PORT) || 3010,
+        host: process.env.HOST || "0.0.0.0",
+        environment: process.env.NODE_ENV || "development",
+        cors: {
+            origins: process.env.CORS_ORIGINS?.split(",") || [
+                "http://localhost:3000",
+                "http://localhost:3010",
+            ],
+            credentials: true,
+        },
+        rateLimiting: {
+            max: Number(process.env.RATE_LIMIT_MAX) || 600,
+            timeWindow: process.env.RATE_LIMIT_WINDOW || "1 minute",
+        },
+    },
+    database: {
+        url: process.env.DATABASE_URL ||
+            "postgresql://postgres:password@localhost:5432/axova_oxa_db",
+        host: process.env.POSTGRES_HOST || "localhost",
+        port: Number(process.env.POSTGRES_PORT) || 5432,
+        user: process.env.POSTGRES_USER || "postgres",
+        password: process.env.POSTGRES_PASSWORD || "password",
+        database: process.env.POSTGRES_DB || "axova_oxa_db",
+        ssl: process.env.DB_SSL === "true",
+        poolSize: Number(process.env.DB_POOL_SIZE) || 10,
+    },
+    kafka: {
+        enabled: process.env.KAFKA_ENABLED === "true",
+        clientId: process.env.KAFKA_CLIENT_ID || "oxa-service",
+        groupId: process.env.KAFKA_GROUP_ID || "oxa-service-group",
+        topics: ["audit.logged", "notification.send"],
+        autoCommit: process.env.KAFKA_AUTO_COMMIT !== "false",
+    },
+    audit: {
+        enabled: process.env.AUDIT_ENABLED !== "false",
+        level: process.env.AUDIT_LEVEL || "comprehensive",
+        bufferSize: Number(process.env.AUDIT_BUFFER_SIZE) || 100,
+        flushInterval: Number(process.env.AUDIT_FLUSH_INTERVAL) || 5000,
+        sensitiveFieldMasking: process.env.AUDIT_MASK_SENSITIVE !== "false",
+    },
+    features: {
+        aiChat: true,
+        aiStreaming: true,
+        embeddings: true,
+        moderation: true,
+        tracing: process.env.OXA_TRACING === "true",
+        ratelimit: true,
+    },
+    customConfig: {
+        oxa: {
+            defaultModel: process.env.OXA_DEFAULT_MODEL || "gpt-4o-mini",
+            defaultEmbeddingModel: process.env.OXA_EMBEDDING_MODEL || "text-embedding-3-small",
+            requestTimeoutMs: Number(process.env.OXA_REQUEST_TIMEOUT_MS) || 60000,
+            maxRetries: Number(process.env.OXA_MAX_RETRIES) || 2,
+        },
+    },
+};
+exports.SERVICE_PROFILES = {
+    "store-service": exports.STORE_SERVICE_PROFILE,
+    "compliance-service": exports.COMPLIANCE_SERVICE_PROFILE,
+    "product-service": exports.PRODUCT_SERVICE_PROFILE,
+    "inventory-core-service": exports.INVENTORY_SERVICE_PROFILE,
+    "admin-api-service": exports.ADMIN_API_SERVICE_PROFILE,
+    "oxa-service": exports.OXA_SERVICE_PROFILE,
+};
+/**
+ * Get configuration profile for a specific service
+ */
+function getServiceProfile(serviceName) {
+    const profile = exports.SERVICE_PROFILES[serviceName];
+    if (!profile) {
+        throw new Error(`Unknown service: ${serviceName}`);
+    }
+    return profile;
+}
+/**
+ * Initialize service with its profile and return configured instances
+ */
+async function initializeServiceWithProfile(serviceName) {
+    const profile = getServiceProfile(serviceName);
+    // Get base configurations
+    const kafkaConfig = (0, kafka_1.getKafkaConfigFromEnv)();
+    const serviceAuthConfig = (0, serviceAuth_1.getServiceAuthConfigFromEnv)();
+    // Return initialized configuration
+    return {
+        profile,
+        kafkaConfig,
+        serviceAuthConfig,
+        // Add convenience methods
+        isFeatureEnabled: (feature) => profile.features[feature] === true,
+        getCustomConfig: (key) => profile.customConfig?.[key],
+        isDevelopment: () => profile.base.environment === "development",
+        isProduction: () => profile.base.environment === "production",
+    };
+}
+/**
+ * Validate service configuration
+ */
+function validateServiceConfig(profile) {
+    const errors = [];
+    // Validate required fields
+    if (!profile.base.serviceName)
+        errors.push("Service name is required");
+    if (!profile.base.port ||
+        profile.base.port < 1 ||
+        profile.base.port > 65535) {
+        errors.push("Valid port number is required");
+    }
+    if (!profile.database.url)
+        errors.push("Database URL is required");
+    // Validate kafka configuration
+    if (profile.kafka.enabled && !profile.kafka.clientId) {
+        errors.push("Kafka client ID is required when Kafka is enabled");
+    }
+    // Validate audit configuration
+    if (profile.audit.enabled && profile.audit.bufferSize < 1) {
+        errors.push("Valid audit buffer size is required when audit is enabled");
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}

package/dist/events/kafka.d.ts

@@ -0,0 +1,40 @@
+import { type ConsumerConfig, type ProducerConfig } from "kafkajs";
+import { type AxovaEvent, KAFKA_TOPICS, type KafkaTopic } from "../types/events";
+export interface AxovaKafkaConfig {
+    brokers: string[];
+    clientId: string;
+    ssl?: boolean;
+    sasl?: {
+        mechanism: "plain";
+        username: string;
+        password: string;
+    } | {
+        mechanism: "scram-sha-256";
+        username: string;
+        password: string;
+    } | {
+        mechanism: "scram-sha-512";
+        username: string;
+        password: string;
+    };
+}
+export type EventHandler<T = unknown> = (event: T) => Promise<void>;
+export declare class AxovaKafka {
+    private kafka;
+    private producer;
+    private consumers;
+    private eventHandlers;
+    constructor(config: AxovaKafkaConfig);
+    initializeProducer(config?: ProducerConfig): Promise<void>;
+    initializeConsumer(groupId: string, topics: KafkaTopic[], config?: ConsumerConfig): Promise<void>;
+    publishEvent(topic: KafkaTopic, event: AxovaEvent): Promise<void>;
+    publishEventsBatch(topic: KafkaTopic, events: AxovaEvent[]): Promise<void>;
+    onEvent<T extends AxovaEvent>(eventType: T["type"], handler: EventHandler<T>): void;
+    startConsuming(groupId: string): Promise<void>;
+    disconnect(): Promise<void>;
+    createEvent<T extends AxovaEvent>(type: T["type"], data: T["data"], source: string): T;
+}
+export declare function createKafkaInstance(config: AxovaKafkaConfig): AxovaKafka;
+export declare function getKafkaInstance(): AxovaKafka;
+export declare function getKafkaConfigFromEnv(): AxovaKafkaConfig;
+export { KAFKA_TOPICS };