rabbitmq-sdk 0.0.1-security → 1.2.0

package/src/interfaces/IResource.ts

@@ -0,0 +1,35 @@
+/**
+ * Queue options for resource creation
+ */
+export interface QueueOptions {
+  durable?: boolean;
+  exclusive?: boolean;
+  autoDelete?: boolean;
+  arguments?: Record<string, any>;
+}
+
+/**
+ * Exchange options for resource creation
+ */
+export interface ExchangeOptions {
+  durable?: boolean;
+  autoDelete?: boolean;
+  arguments?: Record<string, any>;
+}
+
+/**
+ * Resource creator interface for auto-creating exchanges and queues
+ */
+export interface IResourceCreator {
+  /** Ensure exchange exists, create if it doesn't */
+  ensureExchange(exchange: string, type?: string, options?: ExchangeOptions): Promise<void>;
+  
+  /** Ensure queue exists, create if it doesn't */
+  ensureQueue(queue: string, options?: QueueOptions): Promise<void>;
+  
+  /** Bind queue to exchange with routing key */
+  bindQueue(queue: string, exchange: string, routingKey: string): Promise<void>;
+  
+  /** Unbind queue from exchange with routing key */
+  unbindQueue(queue: string, exchange: string, routingKey: string): Promise<void>;
+}

package/src/interfaces/ISdkRabbitmq.ts

@@ -0,0 +1,26 @@
+import { MessageCallback } from './IMessage';
+
+/**
+ * Main SDK RabbitMQ interface - the public API
+ */
+export interface ISdkRabbitmq {
+  /** Publish a message to an exchange */
+  publish(exchange: string, routingKey: string, payload: any): Promise<boolean>;
+  
+  /** Subscribe to messages from a queue */
+  subscribe(
+    exchange: string,
+    queue: string,
+    routingKey: string,
+    callback: MessageCallback
+  ): Promise<void>;
+  
+  /** Bind a queue to an exchange with a routing key */
+  bind(queue: string, exchange: string, routingKey: string): Promise<void>;
+  
+  /** Unbind a queue from an exchange with a routing key */
+  unbind(queue: string, exchange: string, routingKey: string): Promise<void>;
+  
+  /** Disconnect from RabbitMQ gracefully */
+  disconnect(): Promise<void>;
+}

package/src/interfaces/index.ts

@@ -0,0 +1,23 @@
+// Configuration interfaces
+export * from './IConfiguration';
+
+// Connection interfaces
+export * from './IConnection';
+
+// Message interfaces
+export * from './IMessage';
+
+// Resource interfaces
+export * from './IResource';
+
+// DLQ interfaces
+export * from './IDLQ';
+
+// Logger interfaces
+export * from './ILogger';
+
+// Main SDK interface
+export * from './ISdkRabbitmq';
+
+// Error classes
+export * from './IErrors';

package/src/utils/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the utils directory is tracked by git

package/src/utils/configSchema.ts

@@ -0,0 +1,58 @@
+import { IConfiguration } from '../interfaces/IConfiguration';
+import { ConfigurationError } from '../interfaces/IErrors';
+
+/**
+ * Validates the configuration object against the expected schema
+ * @param config - Configuration object to validate
+ * @throws ConfigurationError if validation fails
+ */
+export function validateConfigurationSchema(config: any): asserts config is IConfiguration {
+  if (!config || typeof config !== 'object') {
+    throw new ConfigurationError('Configuration must be a valid object');
+  }
+
+  // Validate required url property
+  if (!config.url || typeof config.url !== 'string') {
+    throw new ConfigurationError('Configuration must include a valid "url" string property');
+  }
+
+  // Validate required dlq property
+  if (!config.dlq || typeof config.dlq !== 'object') {
+    throw new ConfigurationError('Configuration must include a valid "dlq" object property');
+  }
+
+  // Validate dlq.active property
+  if (typeof config.dlq.active !== 'boolean') {
+    throw new ConfigurationError('Configuration dlq.active must be a boolean value');
+  }
+
+  // Validate optional dlq properties
+  if (config.dlq.ttl !== undefined && (typeof config.dlq.ttl !== 'number' || config.dlq.ttl < 0)) {
+    throw new ConfigurationError('Configuration dlq.ttl must be a positive number');
+  }
+
+  if (config.dlq.maxRetries !== undefined && (typeof config.dlq.maxRetries !== 'number' || config.dlq.maxRetries < 0)) {
+    throw new ConfigurationError('Configuration dlq.maxRetries must be a positive number');
+  }
+
+  if (config.dlq.retryDelay !== undefined && (typeof config.dlq.retryDelay !== 'number' || config.dlq.retryDelay < 0)) {
+    throw new ConfigurationError('Configuration dlq.retryDelay must be a positive number');
+  }
+
+  // Validate optional logging property
+  if (config.logging !== undefined) {
+    if (typeof config.logging !== 'object') {
+      throw new ConfigurationError('Configuration logging must be an object');
+    }
+
+    const validLevels = ['error', 'warn', 'info', 'debug'];
+    if (config.logging.level !== undefined && !validLevels.includes(config.logging.level)) {
+      throw new ConfigurationError(`Configuration logging.level must be one of: ${validLevels.join(', ')}`);
+    }
+
+    const validFormats = ['json', 'text'];
+    if (config.logging.format !== undefined && !validFormats.includes(config.logging.format)) {
+      throw new ConfigurationError(`Configuration logging.format must be one of: ${validFormats.join(', ')}`);
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.test.ts",
+    "**/*.spec.ts"
+  ]
+}