mcp-http-webhook 1.0.5 → 1.0.7

package/src/types/index.ts

@@ -10,6 +10,42 @@ export interface JSONSchema {
   [key: string]: any;
 }
 
+export type CredentialFieldType =
+  | 'string'
+  | 'number'
+  | 'boolean'
+  | 'object'
+  | 'array'
+  | 'date'
+  | 'file'
+  | 'binary';
+
+export type CredentialFieldConfigType =
+  | 'jwt'
+  | 'bearer'
+  | 'basic'
+  | 'oauth'
+  | 'oidc'
+  | 'keyValue';
+
+export interface CredentialFieldConfig {
+  type?: CredentialFieldConfigType;
+  inject?: any;
+  [key: string]: any;
+}
+
+export interface CredentialFieldDefinition {
+  name: string;
+  description?: string;
+  type: CredentialFieldType;
+  required?: boolean;
+  default?: any;
+  innerFields?: CredentialFieldDefinition[];
+  or?: CredentialFieldDefinition[];
+  config?: CredentialFieldConfig;
+  metadata?: Record<string, any>;
+}
+
 /**
  * Authentication context passed to handlers
  */
@@ -161,9 +197,33 @@ export interface ResourceListItem {
 /**
  * Resource read result
  */
+/**
+ * Pagination metadata for responses
+ */
+export interface PaginationMetadata {
+  page: number;
+  limit: number;
+  total?: number;
+  hasMore?: boolean;
+  nextCursor?: string;
+  prevCursor?: string;
+}
+
+/**
+ * Resource read result with optional pagination
+ */
 export interface ResourceReadResult<TData = any> {
   contents: TData;
   metadata?: ResourceMetadata;
+  pagination?: PaginationMetadata;
+}
+
+/**
+ * Resource list result with optional pagination
+ */
+export interface ResourceListResult {
+  resources: ResourceListItem[];
+  pagination?: PaginationMetadata;
 }
 
 /**
@@ -173,6 +233,7 @@ export interface ResourceReadOptions {
   pagination?: {
     page?: number;
     limit?: number;
+    cursor?: string;
   };
 }
 
@@ -244,11 +305,52 @@ export interface ResourceDefinition<TData = any> {
     options?: ResourceReadOptions
   ) => Promise<ResourceReadResult<TData>>;
 
-  list?: (context: AuthContext) => Promise<ResourceListItem[]>;
+  list?: (
+    context: AuthContext,
+    options?: ResourceReadOptions
+  ) => Promise<ResourceListResult | ResourceListItem[]>;
 
   subscription?: ResourceSubscription;
+  
+  /**
+   * Optional completion handler for resource URI parameters
+   */
+  completion?: CompletionHandler;
+}
+
+/**
+ * Completion item returned by completion handlers
+ */
+export interface CompletionItem {
+  value: string;
+  label?: string;
+  description?: string;
+  type?: 'value' | 'function' | 'variable' | 'constant' | 'other';
 }
 
+/**
+ * Completion reference - identifies what to complete
+ */
+export type CompletionRef =
+  | {
+      type: 'ref/prompt';
+      name: string;
+      arguments?: Record<string, string>;
+    }
+  | {
+      type: 'ref/resource';
+      uri: string;
+    };
+
+/**
+ * Completion handler function
+ */
+export type CompletionHandler = (
+  ref: CompletionRef,
+  argument: string,
+  context: AuthContext
+) => Promise<CompletionItem[]>;
+
 /**
  * Prompt definition
  */
@@ -266,6 +368,10 @@ export interface PromptDefinition {
       content: string;
     }>;
   }>;
+  /**
+   * Optional completion handler for prompt arguments
+   */
+  completion?: CompletionHandler;
 }
 
 /**
@@ -355,6 +461,9 @@ export interface MCPServerConfig {
   tools: ToolDefinition[];
   resources: ResourceDefinition[];
   prompts?: PromptDefinition[];
+  
+  // Completions
+  completions?: CompletionHandler;
 
   // Storage
   store: KeyValueStore;
@@ -372,6 +481,8 @@ export interface MCPServerConfig {
   // Logging
   logger?: Logger;
   logLevel?: 'debug' | 'info' | 'warn' | 'error';
+
+  credentials?: CredentialFieldDefinition[];
 }
 
 /**