@frontmcp/sdk 0.4.1 → 0.5.1

package/src/utils/types.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.utils.js","sourceRoot":"","sources":["../../../src/utils/types.utils.ts"],"names":[],"mappings":"","sourcesContent":["import { z, ZodTypeAny } from 'zod';\n\ntype Primitive = string | number | boolean | bigint | null | undefined;\ntype Flatten<T> = T extends Primitive\n  ? T\n  : T extends Array<infer U>\n    ? Array<Flatten<U>>\n    : T extends Set<infer U>\n      ? Set<Flatten<U>>\n      : T extends Map<infer K, infer V>\n        ? Map<Flatten<K>, Flatten<V>>\n        : T extends object\n          ? {\n            [K in keyof T]: Flatten<T[K]>;\n          }\n          : T;\nexport type Infer<Schema extends ZodTypeAny> = Flatten<z.infer<Schema>>;\n"]}
+{"version":3,"file":"types.utils.js","sourceRoot":"","sources":["../../../src/utils/types.utils.ts"],"names":[],"mappings":"","sourcesContent":["import { z, ZodType } from 'zod';\n\ntype Primitive = string | number | boolean | bigint | null | undefined;\ntype Flatten<T> = T extends Primitive\n  ? T\n  : T extends Array<infer U>\n  ? Array<Flatten<U>>\n  : T extends Set<infer U>\n  ? Set<Flatten<U>>\n  : T extends Map<infer K, infer V>\n  ? Map<Flatten<K>, Flatten<V>>\n  : T extends object\n  ? {\n      [K in keyof T]: Flatten<T[K]>;\n    }\n  : T;\nexport type Infer<Schema extends ZodType> = Flatten<z.infer<Schema>>;\n"]}

package/src/utils/uri-template.utils.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Parsed URI template information
+ */
+export interface ParsedUriTemplate {
+    pattern: RegExp;
+    paramNames: string[];
+}
+/**
+ * Parse a URI template (RFC 6570 Level 1) into a regex pattern and parameter names.
+ * Supports simple string substitution: {param}
+ *
+ * Note: This implements RFC 6570 Level 1 only (simple string substitution).
+ * Advanced operators like {+path}, {#fragment}, or {?query} are not supported.
+ *
+ * @example
+ * parseUriTemplate("file:///{path}") => { pattern: /^file:\/\/\/([^/]+)$/, paramNames: ["path"] }
+ * parseUriTemplate("users/{userId}/posts/{postId}") => { pattern: /^users\/([^/]+)\/posts\/([^/]+)$/, paramNames: ["userId", "postId"] }
+ *
+ * @throws Error if template is too long (>1000 chars) or has too many parameters (>50)
+ */
+export declare function parseUriTemplate(template: string): ParsedUriTemplate;
+/**
+ * Match a URI against a URI template and extract parameters.
+ * Returns null if no match, or an object with extracted parameters.
+ *
+ * @example
+ * matchUriTemplate("file:///{path}", "file:///documents/readme.txt")
+ * => { path: "documents" } // Note: only captures first segment
+ *
+ * matchUriTemplate("users/{userId}/posts/{postId}", "users/123/posts/456")
+ * => { userId: "123", postId: "456" }
+ */
+export declare function matchUriTemplate(template: string, uri: string): Record<string, string> | null;
+/**
+ * Expand a URI template with the given parameters.
+ *
+ * @example
+ * expandUriTemplate("file:///{path}", { path: "documents/readme.txt" })
+ * => "file:///documents%2Freadme.txt"
+ *
+ * expandUriTemplate("users/{userId}/posts/{postId}", { userId: "123", postId: "456" })
+ * => "users/123/posts/456"
+ *
+ * @throws Error if a required parameter is missing
+ */
+export declare function expandUriTemplate(template: string, params: Record<string, string>): string;
+/**
+ * Extract parameter names from a URI template.
+ *
+ * @example
+ * extractTemplateParams("users/{userId}/posts/{postId}") => ["userId", "postId"]
+ */
+export declare function extractTemplateParams(template: string): string[];
+/**
+ * Check if a string is a URI template (contains {param} placeholders).
+ */
+export declare function isUriTemplate(uri: string): boolean;

package/src/utils/uri-template.utils.js

@@ -0,0 +1,113 @@
+"use strict";
+// file: libs/sdk/src/utils/uri-template.utils.ts
+// RFC 6570 Level 1 URI Template utilities
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUriTemplate = parseUriTemplate;
+exports.matchUriTemplate = matchUriTemplate;
+exports.expandUriTemplate = expandUriTemplate;
+exports.extractTemplateParams = extractTemplateParams;
+exports.isUriTemplate = isUriTemplate;
+/**
+ * Parse a URI template (RFC 6570 Level 1) into a regex pattern and parameter names.
+ * Supports simple string substitution: {param}
+ *
+ * Note: This implements RFC 6570 Level 1 only (simple string substitution).
+ * Advanced operators like {+path}, {#fragment}, or {?query} are not supported.
+ *
+ * @example
+ * parseUriTemplate("file:///{path}") => { pattern: /^file:\/\/\/([^/]+)$/, paramNames: ["path"] }
+ * parseUriTemplate("users/{userId}/posts/{postId}") => { pattern: /^users\/([^/]+)\/posts\/([^/]+)$/, paramNames: ["userId", "postId"] }
+ *
+ * @throws Error if template is too long (>1000 chars) or has too many parameters (>50)
+ */
+function parseUriTemplate(template) {
+    if (template.length > 1000) {
+        throw new Error('URI template too long (max 1000 characters)');
+    }
+    const paramCount = (template.match(/\{[^}]+\}/g) || []).length;
+    if (paramCount > 50) {
+        throw new Error('URI template has too many parameters (max 50)');
+    }
+    const paramNames = [];
+    // Escape special regex characters, but handle {param} placeholders
+    let regexStr = template.replace(/[.*+?^${}()|[\]\\]/g, (match) => {
+        // Don't escape { and } yet - we'll handle them for parameters
+        if (match === '{' || match === '}')
+            return match;
+        return '\\' + match;
+    });
+    // Replace {param} with capture groups
+    regexStr = regexStr.replace(/\{([^}]+)\}/g, (_, paramName) => {
+        paramNames.push(paramName);
+        // Match any non-empty string segment (stops at /)
+        return '([^/]+)';
+    });
+    return {
+        pattern: new RegExp(`^${regexStr}$`),
+        paramNames,
+    };
+}
+/**
+ * Match a URI against a URI template and extract parameters.
+ * Returns null if no match, or an object with extracted parameters.
+ *
+ * @example
+ * matchUriTemplate("file:///{path}", "file:///documents/readme.txt")
+ * => { path: "documents" } // Note: only captures first segment
+ *
+ * matchUriTemplate("users/{userId}/posts/{postId}", "users/123/posts/456")
+ * => { userId: "123", postId: "456" }
+ */
+function matchUriTemplate(template, uri) {
+    const { pattern, paramNames } = parseUriTemplate(template);
+    const match = uri.match(pattern);
+    if (!match)
+        return null;
+    const params = {};
+    paramNames.forEach((name, index) => {
+        params[name] = decodeURIComponent(match[index + 1]);
+    });
+    return params;
+}
+/**
+ * Expand a URI template with the given parameters.
+ *
+ * @example
+ * expandUriTemplate("file:///{path}", { path: "documents/readme.txt" })
+ * => "file:///documents%2Freadme.txt"
+ *
+ * expandUriTemplate("users/{userId}/posts/{postId}", { userId: "123", postId: "456" })
+ * => "users/123/posts/456"
+ *
+ * @throws Error if a required parameter is missing
+ */
+function expandUriTemplate(template, params) {
+    return template.replace(/\{([^}]+)\}/g, (_, paramName) => {
+        const value = params[paramName];
+        if (value === undefined) {
+            throw new Error(`Missing parameter '${paramName}' for URI template '${template}'`);
+        }
+        return encodeURIComponent(value);
+    });
+}
+/**
+ * Extract parameter names from a URI template.
+ *
+ * @example
+ * extractTemplateParams("users/{userId}/posts/{postId}") => ["userId", "postId"]
+ */
+function extractTemplateParams(template) {
+    const params = [];
+    template.replace(/\{([^}]+)\}/g, (_, paramName) => {
+        params.push(paramName);
+        return '';
+    });
+    return params;
+}
+/**
+ * Check if a string is a URI template (contains {param} placeholders).
+ */
+function isUriTemplate(uri) {
+    return /\{[^}]+\}/.test(uri);
+}
+//# sourceMappingURL=uri-template.utils.js.map

package/src/utils/uri-template.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-template.utils.js","sourceRoot":"","sources":["../../../src/utils/uri-template.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/utils/uri-template.utils.ts\n// RFC 6570 Level 1 URI Template utilities\n\n/**\n * Parsed URI template information\n */\nexport interface ParsedUriTemplate {\n  pattern: RegExp;\n  paramNames: string[];\n}\n\n/**\n * Parse a URI template (RFC 6570 Level 1) into a regex pattern and parameter names.\n * Supports simple string substitution: {param}\n *\n * Note: This implements RFC 6570 Level 1 only (simple string substitution).\n * Advanced operators like {+path}, {#fragment}, or {?query} are not supported.\n *\n * @example\n * parseUriTemplate(\"file:///{path}\") => { pattern: /^file:\\/\\/\\/([^/]+)$/, paramNames: [\"path\"] }\n * parseUriTemplate(\"users/{userId}/posts/{postId}\") => { pattern: /^users\\/([^/]+)\\/posts\\/([^/]+)$/, paramNames: [\"userId\", \"postId\"] }\n *\n * @throws Error if template is too long (>1000 chars) or has too many parameters (>50)\n */\nexport function parseUriTemplate(template: string): ParsedUriTemplate {\n  if (template.length > 1000) {\n    throw new Error('URI template too long (max 1000 characters)');\n  }\n  const paramCount = (template.match(/\\{[^}]+\\}/g) || []).length;\n  if (paramCount > 50) {\n    throw new Error('URI template has too many parameters (max 50)');\n  }\n\n  const paramNames: string[] = [];\n\n  // Escape special regex characters, but handle {param} placeholders\n  let regexStr = template.replace(/[.*+?^${}()|[\\]\\\\]/g, (match) => {\n    // Don't escape { and } yet - we'll handle them for parameters\n    if (match === '{' || match === '}') return match;\n    return '\\\\' + match;\n  });\n\n  // Replace {param} with capture groups\n  regexStr = regexStr.replace(/\\{([^}]+)\\}/g, (_, paramName) => {\n    paramNames.push(paramName);\n    // Match any non-empty string segment (stops at /)\n    return '([^/]+)';\n  });\n\n  return {\n    pattern: new RegExp(`^${regexStr}$`),\n    paramNames,\n  };\n}\n\n/**\n * Match a URI against a URI template and extract parameters.\n * Returns null if no match, or an object with extracted parameters.\n *\n * @example\n * matchUriTemplate(\"file:///{path}\", \"file:///documents/readme.txt\")\n * => { path: \"documents\" } // Note: only captures first segment\n *\n * matchUriTemplate(\"users/{userId}/posts/{postId}\", \"users/123/posts/456\")\n * => { userId: \"123\", postId: \"456\" }\n */\nexport function matchUriTemplate(template: string, uri: string): Record<string, string> | null {\n  const { pattern, paramNames } = parseUriTemplate(template);\n  const match = uri.match(pattern);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = decodeURIComponent(match[index + 1]);\n  });\n\n  return params;\n}\n\n/**\n * Expand a URI template with the given parameters.\n *\n * @example\n * expandUriTemplate(\"file:///{path}\", { path: \"documents/readme.txt\" })\n * => \"file:///documents%2Freadme.txt\"\n *\n * expandUriTemplate(\"users/{userId}/posts/{postId}\", { userId: \"123\", postId: \"456\" })\n * => \"users/123/posts/456\"\n *\n * @throws Error if a required parameter is missing\n */\nexport function expandUriTemplate(template: string, params: Record<string, string>): string {\n  return template.replace(/\\{([^}]+)\\}/g, (_, paramName) => {\n    const value = params[paramName];\n    if (value === undefined) {\n      throw new Error(`Missing parameter '${paramName}' for URI template '${template}'`);\n    }\n    return encodeURIComponent(value);\n  });\n}\n\n/**\n * Extract parameter names from a URI template.\n *\n * @example\n * extractTemplateParams(\"users/{userId}/posts/{postId}\") => [\"userId\", \"postId\"]\n */\nexport function extractTemplateParams(template: string): string[] {\n  const params: string[] = [];\n  template.replace(/\\{([^}]+)\\}/g, (_, paramName) => {\n    params.push(paramName);\n    return '';\n  });\n  return params;\n}\n\n/**\n * Check if a string is a URI template (contains {param} placeholders).\n */\nexport function isUriTemplate(uri: string): boolean {\n  return /\\{[^}]+\\}/.test(uri);\n}\n"]}

package/src/utils/uri-validation.utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Validate that a URI has a valid scheme per RFC 3986.
+ *
+ * @param uri - The URI to validate
+ * @returns true if the URI has a valid scheme, false otherwise
+ *
+ * @example
+ * isValidMcpUri('file:///path/to/file') // true
+ * isValidMcpUri('https://example.com/resource') // true
+ * isValidMcpUri('custom://my-resource') // true
+ * isValidMcpUri('/path/to/file') // false (no scheme)
+ * isValidMcpUri('123://invalid') // false (scheme must start with letter)
+ */
+export declare function isValidMcpUri(uri: string): boolean;
+/**
+ * Extract the scheme from a URI.
+ *
+ * @param uri - The URI to extract the scheme from
+ * @returns The scheme in lowercase, or null if no valid scheme found
+ *
+ * @example
+ * extractUriScheme('file:///path') // 'file'
+ * extractUriScheme('HTTPS://example.com') // 'https'
+ * extractUriScheme('/no/scheme') // null
+ */
+export declare function extractUriScheme(uri: string): string | null;
+/**
+ * Validate that a URI template has a valid scheme per RFC 3986.
+ * URI templates follow RFC 6570 and can contain template expressions like {var}.
+ * The scheme portion should still be a valid static scheme.
+ *
+ * @param uriTemplate - The URI template to validate
+ * @returns true if the URI template has a valid scheme, false otherwise
+ *
+ * @example
+ * isValidMcpUriTemplate('users://{userId}/profile') // true
+ * isValidMcpUriTemplate('file:///{path}') // true
+ * isValidMcpUriTemplate('{scheme}://dynamic') // false (scheme must be static)
+ */
+export declare function isValidMcpUriTemplate(uriTemplate: string): boolean;

package/src/utils/uri-validation.utils.js

@@ -0,0 +1,76 @@
+"use strict";
+// file: libs/sdk/src/utils/uri-validation.utils.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidMcpUri = isValidMcpUri;
+exports.extractUriScheme = extractUriScheme;
+exports.isValidMcpUriTemplate = isValidMcpUriTemplate;
+/**
+ * URI validation utilities for MCP resource URIs.
+ *
+ * Per MCP specification, resource URIs should follow RFC 3986 and include
+ * a valid scheme (e.g., file://, https://, custom://).
+ */
+/**
+ * RFC 3986 compliant URI scheme pattern.
+ * scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." )
+ *
+ * The pattern validates that the URI:
+ * 1. Starts with a letter (case insensitive)
+ * 2. Followed by any combination of letters, digits, +, -, or .
+ * 3. Followed by ://
+ */
+const RFC_3986_SCHEME_PATTERN = /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//;
+/**
+ * Pattern to extract the scheme from a URI.
+ */
+const SCHEME_EXTRACT_PATTERN = /^([a-zA-Z][a-zA-Z0-9+.-]*):/;
+/**
+ * Validate that a URI has a valid scheme per RFC 3986.
+ *
+ * @param uri - The URI to validate
+ * @returns true if the URI has a valid scheme, false otherwise
+ *
+ * @example
+ * isValidMcpUri('file:///path/to/file') // true
+ * isValidMcpUri('https://example.com/resource') // true
+ * isValidMcpUri('custom://my-resource') // true
+ * isValidMcpUri('/path/to/file') // false (no scheme)
+ * isValidMcpUri('123://invalid') // false (scheme must start with letter)
+ */
+function isValidMcpUri(uri) {
+    return RFC_3986_SCHEME_PATTERN.test(uri);
+}
+/**
+ * Extract the scheme from a URI.
+ *
+ * @param uri - The URI to extract the scheme from
+ * @returns The scheme in lowercase, or null if no valid scheme found
+ *
+ * @example
+ * extractUriScheme('file:///path') // 'file'
+ * extractUriScheme('HTTPS://example.com') // 'https'
+ * extractUriScheme('/no/scheme') // null
+ */
+function extractUriScheme(uri) {
+    const match = uri.match(SCHEME_EXTRACT_PATTERN);
+    return match ? match[1].toLowerCase() : null;
+}
+/**
+ * Validate that a URI template has a valid scheme per RFC 3986.
+ * URI templates follow RFC 6570 and can contain template expressions like {var}.
+ * The scheme portion should still be a valid static scheme.
+ *
+ * @param uriTemplate - The URI template to validate
+ * @returns true if the URI template has a valid scheme, false otherwise
+ *
+ * @example
+ * isValidMcpUriTemplate('users://{userId}/profile') // true
+ * isValidMcpUriTemplate('file:///{path}') // true
+ * isValidMcpUriTemplate('{scheme}://dynamic') // false (scheme must be static)
+ */
+function isValidMcpUriTemplate(uriTemplate) {
+    // For templates, we just need to check if it starts with a valid scheme
+    // The template expressions come after the scheme
+    return RFC_3986_SCHEME_PATTERN.test(uriTemplate);
+}
+//# sourceMappingURL=uri-validation.utils.js.map

package/src/utils/uri-validation.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-validation.utils.js","sourceRoot":"","sources":["../../../src/utils/uri-validation.utils.ts"],"names":[],"mappings":";AAAA,mDAAmD;;AAsCnD,sCAEC;AAaD,4CAGC;AAeD,sDAIC;AAzED;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,uBAAuB,GAAG,+BAA+B,CAAC;AAEhE;;GAEG;AACH,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,SAAgB,aAAa,CAAC,GAAW;IACvC,OAAO,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,qBAAqB,CAAC,WAAmB;IACvD,wEAAwE;IACxE,iDAAiD;IACjD,OAAO,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACnD,CAAC","sourcesContent":["// file: libs/sdk/src/utils/uri-validation.utils.ts\n\n/**\n * URI validation utilities for MCP resource URIs.\n *\n * Per MCP specification, resource URIs should follow RFC 3986 and include\n * a valid scheme (e.g., file://, https://, custom://).\n */\n\n/**\n * RFC 3986 compliant URI scheme pattern.\n * scheme = ALPHA *( ALPHA / DIGIT / \"+\" / \"-\" / \".\" )\n *\n * The pattern validates that the URI:\n * 1. Starts with a letter (case insensitive)\n * 2. Followed by any combination of letters, digits, +, -, or .\n * 3. Followed by ://\n */\nconst RFC_3986_SCHEME_PATTERN = /^[a-zA-Z][a-zA-Z0-9+.-]*:\\/\\//;\n\n/**\n * Pattern to extract the scheme from a URI.\n */\nconst SCHEME_EXTRACT_PATTERN = /^([a-zA-Z][a-zA-Z0-9+.-]*):/;\n\n/**\n * Validate that a URI has a valid scheme per RFC 3986.\n *\n * @param uri - The URI to validate\n * @returns true if the URI has a valid scheme, false otherwise\n *\n * @example\n * isValidMcpUri('file:///path/to/file') // true\n * isValidMcpUri('https://example.com/resource') // true\n * isValidMcpUri('custom://my-resource') // true\n * isValidMcpUri('/path/to/file') // false (no scheme)\n * isValidMcpUri('123://invalid') // false (scheme must start with letter)\n */\nexport function isValidMcpUri(uri: string): boolean {\n  return RFC_3986_SCHEME_PATTERN.test(uri);\n}\n\n/**\n * Extract the scheme from a URI.\n *\n * @param uri - The URI to extract the scheme from\n * @returns The scheme in lowercase, or null if no valid scheme found\n *\n * @example\n * extractUriScheme('file:///path') // 'file'\n * extractUriScheme('HTTPS://example.com') // 'https'\n * extractUriScheme('/no/scheme') // null\n */\nexport function extractUriScheme(uri: string): string | null {\n  const match = uri.match(SCHEME_EXTRACT_PATTERN);\n  return match ? match[1].toLowerCase() : null;\n}\n\n/**\n * Validate that a URI template has a valid scheme per RFC 3986.\n * URI templates follow RFC 6570 and can contain template expressions like {var}.\n * The scheme portion should still be a valid static scheme.\n *\n * @param uriTemplate - The URI template to validate\n * @returns true if the URI template has a valid scheme, false otherwise\n *\n * @example\n * isValidMcpUriTemplate('users://{userId}/profile') // true\n * isValidMcpUriTemplate('file:///{path}') // true\n * isValidMcpUriTemplate('{scheme}://dynamic') // false (scheme must be static)\n */\nexport function isValidMcpUriTemplate(uriTemplate: string): boolean {\n  // For templates, we just need to check if it starts with a valid scheme\n  // The template expressions come after the scheme\n  return RFC_3986_SCHEME_PATTERN.test(uriTemplate);\n}\n"]}

package/src/__test-utils__/fixtures/hook.fixtures.d.ts

@@ -1,46 +0,0 @@
-/**
- * Test fixtures for hooks
- */
-import { HookMetadata } from '../../common/metadata';
-import { Token } from '../../common/interfaces';
-/**
- * Test token for hook target
- */
-export declare const TEST_HOOK_TARGET: Token;
-/**
- * Creates a simple hook metadata object
- */
-export declare function createHookMetadata(overrides?: Partial<HookMetadata>): HookMetadata;
-/**
- * Creates a "will" stage hook metadata
- */
-export declare function createWillHookMetadata(flow?: string, stage?: string): HookMetadata;
-/**
- * Creates a "did" stage hook metadata
- */
-export declare function createDidHookMetadata(flow?: string, stage?: string): HookMetadata;
-/**
- * Creates an "around" stage hook metadata
- */
-export declare function createAroundHookMetadata(flow?: string, stage?: string): HookMetadata;
-/**
- * Mock hook class for testing
- */
-export declare class MockHookClass {
-    onExecute: jest.Mock<Promise<void>, [ctx: any], any>;
-    willExecute: jest.Mock<Promise<void>, [ctx: any], any>;
-    didExecute: jest.Mock<Promise<void>, [ctx: any], any>;
-    aroundExecute: jest.Mock<Promise<any>, [ctx: any, next: () => Promise<any>], any>;
-}
-/**
- * Creates a mock hook instance for testing
- */
-export declare function createMockHookInstance(metadata?: Partial<HookMetadata>): {
-    metadata: HookMetadata<keyof ExtendFlows, string, any>;
-    instance: MockHookClass;
-    execute: jest.Mock<Promise<void>, [ctx: any], any>;
-};
-/**
- * Creates multiple hooks with different priorities
- */
-export declare function createPriorityHooks(priorities: number[]): HookMetadata[];

package/src/__test-utils__/fixtures/hook.fixtures.js

@@ -1,114 +0,0 @@
-"use strict";
-/// <reference types="jest" />
-/**
- * Test fixtures for hooks
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MockHookClass = exports.TEST_HOOK_TARGET = void 0;
-exports.createHookMetadata = createHookMetadata;
-exports.createWillHookMetadata = createWillHookMetadata;
-exports.createDidHookMetadata = createDidHookMetadata;
-exports.createAroundHookMetadata = createAroundHookMetadata;
-exports.createMockHookInstance = createMockHookInstance;
-exports.createPriorityHooks = createPriorityHooks;
-/**
- * Test token for hook target
- */
-exports.TEST_HOOK_TARGET = Symbol('TEST_HOOK_TARGET');
-/**
- * Creates a simple hook metadata object
- */
-function createHookMetadata(overrides = {}) {
-    return {
-        type: 'stage',
-        flow: 'CallToolFlow',
-        stage: 'execute',
-        target: exports.TEST_HOOK_TARGET,
-        method: 'onExecute',
-        priority: 0,
-        ...overrides,
-    };
-}
-/**
- * Creates a "will" stage hook metadata
- */
-function createWillHookMetadata(flow = 'CallToolFlow', stage = 'execute') {
-    return {
-        type: 'will',
-        flow: flow,
-        stage,
-        target: exports.TEST_HOOK_TARGET,
-        method: 'willExecute',
-        priority: 0,
-    };
-}
-/**
- * Creates a "did" stage hook metadata
- */
-function createDidHookMetadata(flow = 'CallToolFlow', stage = 'execute') {
-    return {
-        type: 'did',
-        flow: flow,
-        stage,
-        target: exports.TEST_HOOK_TARGET,
-        method: 'didExecute',
-        priority: 0,
-    };
-}
-/**
- * Creates an "around" stage hook metadata
- */
-function createAroundHookMetadata(flow = 'CallToolFlow', stage = 'execute') {
-    return {
-        type: 'around',
-        flow: flow,
-        stage,
-        target: exports.TEST_HOOK_TARGET,
-        method: 'aroundExecute',
-        priority: 0,
-    };
-}
-/**
- * Mock hook class for testing
- */
-class MockHookClass {
-    onExecute = jest.fn(async (ctx) => {
-        // Mock hook implementation
-    });
-    willExecute = jest.fn(async (ctx) => {
-        // Mock will hook implementation
-    });
-    didExecute = jest.fn(async (ctx) => {
-        // Mock did hook implementation
-    });
-    aroundExecute = jest.fn(async (ctx, next) => {
-        // Mock around hook implementation
-        return await next();
-    });
-}
-exports.MockHookClass = MockHookClass;
-/**
- * Creates a mock hook instance for testing
- */
-function createMockHookInstance(metadata) {
-    const mockClass = new MockHookClass();
-    return {
-        metadata: createHookMetadata(metadata),
-        instance: mockClass,
-        execute: mockClass.onExecute,
-    };
-}
-/**
- * Creates multiple hooks with different priorities
- */
-function createPriorityHooks(priorities) {
-    return priorities.map((priority, index) => ({
-        type: 'stage',
-        flow: 'CallToolFlow',
-        stage: 'execute',
-        target: Symbol(`HOOK_${index}`),
-        method: 'onExecute',
-        priority,
-    }));
-}
-//# sourceMappingURL=hook.fixtures.js.map

package/src/__test-utils__/fixtures/hook.fixtures.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook.fixtures.js","sourceRoot":"","sources":["../../../../src/__test-utils__/fixtures/hook.fixtures.ts"],"names":[],"mappings":";AAAA,8BAA8B;AAC9B;;GAEG;;;AAaH,gDAYC;AAKD,wDAYC;AAKD,sDAYC;AAKD,4DAYC;AA2BD,wDAOC;AAKD,kDASC;AAvHD;;GAEG;AACU,QAAA,gBAAgB,GAAU,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAElE;;GAEG;AACH,SAAgB,kBAAkB,CAChC,YAAmC,EAAE;IAErC,OAAO;QACL,IAAI,EAAE,OAAwB;QAC9B,IAAI,EAAE,cAAqB;QAC3B,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,wBAAgB;QACxB,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,CAAC;QACX,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CACpC,OAAe,cAAc,EAC7B,QAAgB,SAAS;IAEzB,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,IAAW;QACjB,KAAK;QACL,MAAM,EAAE,wBAAgB;QACxB,MAAM,EAAE,aAAa;QACrB,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACnC,OAAe,cAAc,EAC7B,QAAgB,SAAS;IAEzB,OAAO;QACL,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,IAAW;QACjB,KAAK;QACL,MAAM,EAAE,wBAAgB;QACxB,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CACtC,OAAe,cAAc,EAC7B,QAAgB,SAAS;IAEzB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,IAAW;QACjB,KAAK;QACL,MAAM,EAAE,wBAAgB;QACxB,MAAM,EAAE,eAAe;QACvB,QAAQ,EAAE,CAAC;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAa,aAAa;IACxB,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE;QACrC,2BAA2B;IAC7B,CAAC,CAAC,CAAC;IAEH,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE;QACvC,gCAAgC;IAClC,CAAC,CAAC,CAAC;IAEH,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAQ,EAAE,EAAE;QACtC,+BAA+B;IACjC,CAAC,CAAC,CAAC;IAEH,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAQ,EAAE,IAAwB,EAAE,EAAE;QACnE,kCAAkC;QAClC,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;CACJ;AAjBD,sCAiBC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,QAAgC;IACrE,MAAM,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;IACtC,OAAO;QACL,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC;QACtC,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,UAAoB;IACtD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,EAAE,OAAwB;QAC9B,IAAI,EAAE,cAAqB;QAC3B,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC;QAC/B,MAAM,EAAE,WAAW;QACnB,QAAQ;KACT,CAAC,CAAC,CAAC;AACN,CAAC","sourcesContent":["/// <reference types=\"jest\" />\n/**\n * Test fixtures for hooks\n */\n\nimport { HookMetadata, HookStageType } from '../../common/metadata';\nimport { Token } from '../../common/interfaces';\n\n/**\n * Test token for hook target\n */\nexport const TEST_HOOK_TARGET: Token = Symbol('TEST_HOOK_TARGET');\n\n/**\n * Creates a simple hook metadata object\n */\nexport function createHookMetadata(\n  overrides: Partial<HookMetadata> = {}\n): HookMetadata {\n  return {\n    type: 'stage' as HookStageType,\n    flow: 'CallToolFlow' as any,\n    stage: 'execute',\n    target: TEST_HOOK_TARGET,\n    method: 'onExecute',\n    priority: 0,\n    ...overrides,\n  };\n}\n\n/**\n * Creates a \"will\" stage hook metadata\n */\nexport function createWillHookMetadata(\n  flow: string = 'CallToolFlow',\n  stage: string = 'execute'\n): HookMetadata {\n  return {\n    type: 'will',\n    flow: flow as any,\n    stage,\n    target: TEST_HOOK_TARGET,\n    method: 'willExecute',\n    priority: 0,\n  };\n}\n\n/**\n * Creates a \"did\" stage hook metadata\n */\nexport function createDidHookMetadata(\n  flow: string = 'CallToolFlow',\n  stage: string = 'execute'\n): HookMetadata {\n  return {\n    type: 'did',\n    flow: flow as any,\n    stage,\n    target: TEST_HOOK_TARGET,\n    method: 'didExecute',\n    priority: 0,\n  };\n}\n\n/**\n * Creates an \"around\" stage hook metadata\n */\nexport function createAroundHookMetadata(\n  flow: string = 'CallToolFlow',\n  stage: string = 'execute'\n): HookMetadata {\n  return {\n    type: 'around',\n    flow: flow as any,\n    stage,\n    target: TEST_HOOK_TARGET,\n    method: 'aroundExecute',\n    priority: 0,\n  };\n}\n\n/**\n * Mock hook class for testing\n */\nexport class MockHookClass {\n  onExecute = jest.fn(async (ctx: any) => {\n    // Mock hook implementation\n  });\n\n  willExecute = jest.fn(async (ctx: any) => {\n    // Mock will hook implementation\n  });\n\n  didExecute = jest.fn(async (ctx: any) => {\n    // Mock did hook implementation\n  });\n\n  aroundExecute = jest.fn(async (ctx: any, next: () => Promise<any>) => {\n    // Mock around hook implementation\n    return await next();\n  });\n}\n\n/**\n * Creates a mock hook instance for testing\n */\nexport function createMockHookInstance(metadata?: Partial<HookMetadata>) {\n  const mockClass = new MockHookClass();\n  return {\n    metadata: createHookMetadata(metadata),\n    instance: mockClass,\n    execute: mockClass.onExecute,\n  };\n}\n\n/**\n * Creates multiple hooks with different priorities\n */\nexport function createPriorityHooks(priorities: number[]): HookMetadata[] {\n  return priorities.map((priority, index) => ({\n    type: 'stage' as HookStageType,\n    flow: 'CallToolFlow' as any,\n    stage: 'execute',\n    target: Symbol(`HOOK_${index}`),\n    method: 'onExecute',\n    priority,\n  }));\n}\n"]}

package/src/__test-utils__/fixtures/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Test fixtures for common SDK entities
- */
-export * from './plugin.fixtures';
-export * from './tool.fixtures';
-export * from './hook.fixtures';
-export * from './provider.fixtures';

package/src/__test-utils__/fixtures/index.js

@@ -1,11 +0,0 @@
-"use strict";
-/**
- * Test fixtures for common SDK entities
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./plugin.fixtures"), exports);
-tslib_1.__exportStar(require("./tool.fixtures"), exports);
-tslib_1.__exportStar(require("./hook.fixtures"), exports);
-tslib_1.__exportStar(require("./provider.fixtures"), exports);
-//# sourceMappingURL=index.js.map

package/src/__test-utils__/fixtures/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/__test-utils__/fixtures/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,4DAAkC;AAClC,0DAAgC;AAChC,0DAAgC;AAChC,8DAAoC","sourcesContent":["/**\n * Test fixtures for common SDK entities\n */\n\nexport * from './plugin.fixtures';\nexport * from './tool.fixtures';\nexport * from './hook.fixtures';\nexport * from './provider.fixtures';\n"]}

package/src/__test-utils__/fixtures/plugin.fixtures.d.ts

@@ -1,46 +0,0 @@
-/**
- * Test fixtures for plugins
- */
-import { PluginMetadata } from '../../common/metadata';
-import { PluginInterface } from '../../common/interfaces';
-/**
- * Creates a simple plugin metadata object
- */
-export declare function createPluginMetadata(overrides?: Partial<PluginMetadata>): PluginMetadata;
-/**
- * Creates a plugin with providers
- */
-export declare function createPluginWithProviders(): PluginMetadata;
-/**
- * Creates a plugin with tools
- */
-export declare function createPluginWithTools(): PluginMetadata;
-/**
- * Creates a plugin with nested plugins
- */
-export declare function createPluginWithNestedPlugins(): PluginMetadata;
-/**
- * Mock plugin class for testing
- */
-export declare class MockPluginClass implements PluginInterface {
-    static readonly metadata: PluginMetadata;
-    constructor();
-    onInit?(): Promise<void>;
-    onDestroy?(): Promise<void>;
-}
-/**
- * Creates a mock plugin instance
- */
-export declare function createMockPluginInstance(metadata?: Partial<PluginMetadata>): {
-    metadata: PluginMetadata;
-    onInit: jest.Mock<Promise<void>, [], any>;
-    onDestroy: jest.Mock<Promise<void>, [], any>;
-};
-/**
- * Creates multiple plugins for dependency testing
- */
-export declare function createPluginDependencyChain(): {
-    pluginA: PluginMetadata;
-    pluginB: PluginMetadata;
-    pluginC: PluginMetadata;
-};