initial commit

src/common/interfaces/inquiry-provider.interface.ts

@@ -0,0 +1,22 @@
+import { InquiryType } from '../enums/inquiry-type.enum';
+import { ProviderName } from '../enums/provider-name.enum';
+
+/**
+ * Contract every external provider adapter must fulfill.
+ * Keeps orchestration logic decoupled from provider implementations (Strategy pattern).
+ */
+export interface InquiryProvider<TRequest = unknown, TResponse = unknown> {
+  readonly name: ProviderName;
+  readonly supportedInquiryTypes: InquiryType[];
+  isEnabled(): boolean;
+  execute(
+    inquiryType: InquiryType,
+    payload: TRequest,
+    context: ProviderExecutionContext,
+  ): Promise<TResponse>;
+}
+
+export interface ProviderExecutionContext {
+  requestId: string;
+  trackingCode: string;
+}