@frontmcp/sdk 0.4.0 → 0.5.0

package/src/utils/naming.utils.js

@@ -0,0 +1,136 @@
+"use strict";
+// file: libs/sdk/src/utils/naming.utils.ts
+// Shared naming and case conversion utilities for MCP-compliant identifiers
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitWords = splitWords;
+exports.toCase = toCase;
+exports.sepFor = sepFor;
+exports.normalizeSegment = normalizeSegment;
+exports.normalizeProviderId = normalizeProviderId;
+exports.normalizeOwnerPath = normalizeOwnerPath;
+exports.shortHash = shortHash;
+exports.ensureMaxLen = ensureMaxLen;
+// Allowed chars per MCP spec: a-zA-Z0-9 _ - . /
+const MCP_ALLOWED = /[A-Za-z0-9_\-./]/;
+/**
+ * Split a string into words, handling camelCase, PascalCase, and delimiters.
+ *
+ * @example
+ * splitWords("myFunctionName") => ["my", "Function", "Name"]
+ * splitWords("my_function_name") => ["my", "function", "name"]
+ */
+function splitWords(input) {
+    const parts = [];
+    let buff = '';
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        const isAlphaNum = /[A-Za-z0-9]/.test(ch);
+        if (!isAlphaNum) {
+            if (buff) {
+                parts.push(buff);
+                buff = '';
+            }
+            continue;
+        }
+        if (buff && /[a-z]/.test(buff[buff.length - 1]) && /[A-Z]/.test(ch)) {
+            parts.push(buff);
+            buff = ch;
+        }
+        else {
+            buff += ch;
+        }
+    }
+    if (buff)
+        parts.push(buff);
+    return parts;
+}
+/**
+ * Convert words to a specific naming case.
+ *
+ * @example
+ * toCase(["my", "function"], "snake") => "my_function"
+ * toCase(["my", "function"], "camel") => "myFunction"
+ */
+function toCase(words, kind) {
+    const safe = words.filter(Boolean);
+    switch (kind) {
+        case 'snake':
+            return safe.map((w) => w.toLowerCase()).join('_');
+        case 'kebab':
+            return safe.map((w) => w.toLowerCase()).join('-');
+        case 'dot':
+            return safe.map((w) => w.toLowerCase()).join('.');
+        case 'camel':
+            if (safe.length === 0)
+                return '';
+            return (safe[0].toLowerCase() +
+                safe
+                    .slice(1)
+                    .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+                    .join(''));
+    }
+}
+/**
+ * Get the separator character for a naming case.
+ */
+function sepFor(kind) {
+    return kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '';
+}
+/**
+ * Normalize a single segment (name part) to MCP-safe characters.
+ */
+function normalizeSegment(raw, kind) {
+    const words = splitWords(raw);
+    let cased = toCase(words, kind);
+    cased = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');
+    return cased || 'x';
+}
+/**
+ * Normalize a provider ID to MCP-safe characters.
+ */
+function normalizeProviderId(raw, kind) {
+    if (!raw)
+        return undefined;
+    const tokens = raw.split(/\W+/);
+    const cased = toCase(tokens, kind);
+    const safe = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');
+    return safe || undefined;
+}
+/**
+ * Normalize an owner path (app:id/plugin:id) to the specified naming case.
+ */
+function normalizeOwnerPath(ownerKey, kind) {
+    const levels = ownerKey.split('/');
+    const normLevels = levels.map((level) => {
+        const parts = level.split(':'); // ["app","Portal"]
+        return parts.map((p) => normalizeSegment(p, kind)).join(sepFor(kind));
+    });
+    if (kind === 'camel')
+        return normLevels.map((seg) => seg.charAt(0).toLowerCase() + seg.slice(1)).join('');
+    return normLevels.join(sepFor(kind));
+}
+/**
+ * Generate a short hash (6 hex chars) from a string.
+ * Uses djb2 algorithm for fast, reasonable distribution.
+ */
+function shortHash(s) {
+    let h = 5381;
+    for (let i = 0; i < s.length; i++)
+        h = (h << 5) + h + s.charCodeAt(i);
+    return (h >>> 0).toString(16).slice(-6).padStart(6, '0');
+}
+/**
+ * Ensure a name fits within a maximum length, using hash truncation if needed.
+ * Preserves meaningful suffix while adding a hash for uniqueness.
+ */
+function ensureMaxLen(name, max) {
+    if (name.length <= max)
+        return name;
+    const hash = shortHash(name);
+    const lastSep = Math.max(name.lastIndexOf('_'), name.lastIndexOf('-'), name.lastIndexOf('.'), name.lastIndexOf('/'));
+    const tail = lastSep > 0 ? name.slice(lastSep + 1) : name.slice(-Math.max(3, Math.min(16, Math.floor(max / 4))));
+    const budget = Math.max(1, max - (1 + hash.length + 1 + tail.length));
+    const prefix = name.slice(0, budget);
+    return `${prefix}-${hash}-${tail}`.slice(0, max);
+}
+//# sourceMappingURL=naming.utils.js.map

package/src/utils/naming.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.utils.js","sourceRoot":"","sources":["../../../src/utils/naming.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/utils/naming.utils.ts\n// Shared naming and case conversion utilities for MCP-compliant identifiers\n\n/**\n * Supported naming conventions for MCP identifiers\n */\nexport type NameCase = 'snake' | 'kebab' | 'dot' | 'camel';\n\n// Allowed chars per MCP spec: a-zA-Z0-9 _ - . /\nconst MCP_ALLOWED = /[A-Za-z0-9_\\-./]/;\n\n/**\n * Split a string into words, handling camelCase, PascalCase, and delimiters.\n *\n * @example\n * splitWords(\"myFunctionName\") => [\"my\", \"Function\", \"Name\"]\n * splitWords(\"my_function_name\") => [\"my\", \"function\", \"name\"]\n */\nexport function splitWords(input: string): string[] {\n  const parts: string[] = [];\n  let buff = '';\n  for (let i = 0; i < input.length; i++) {\n    const ch = input[i];\n    const isAlphaNum = /[A-Za-z0-9]/.test(ch);\n    if (!isAlphaNum) {\n      if (buff) {\n        parts.push(buff);\n        buff = '';\n      }\n      continue;\n    }\n    if (buff && /[a-z]/.test(buff[buff.length - 1]) && /[A-Z]/.test(ch)) {\n      parts.push(buff);\n      buff = ch;\n    } else {\n      buff += ch;\n    }\n  }\n  if (buff) parts.push(buff);\n  return parts;\n}\n\n/**\n * Convert words to a specific naming case.\n *\n * @example\n * toCase([\"my\", \"function\"], \"snake\") => \"my_function\"\n * toCase([\"my\", \"function\"], \"camel\") => \"myFunction\"\n */\nexport function toCase(words: string[], kind: NameCase): string {\n  const safe = words.filter(Boolean);\n  switch (kind) {\n    case 'snake':\n      return safe.map((w) => w.toLowerCase()).join('_');\n    case 'kebab':\n      return safe.map((w) => w.toLowerCase()).join('-');\n    case 'dot':\n      return safe.map((w) => w.toLowerCase()).join('.');\n    case 'camel':\n      if (safe.length === 0) return '';\n      return (\n        safe[0].toLowerCase() +\n        safe\n          .slice(1)\n          .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())\n          .join('')\n      );\n  }\n}\n\n/**\n * Get the separator character for a naming case.\n */\nexport function sepFor(kind: NameCase): string {\n  return kind === 'snake' ? '_' : kind === 'kebab' ? '-' : kind === 'dot' ? '.' : '';\n}\n\n/**\n * Normalize a single segment (name part) to MCP-safe characters.\n */\nexport function normalizeSegment(raw: string, kind: NameCase): string {\n  const words = splitWords(raw);\n  let cased = toCase(words, kind);\n  cased = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');\n  return cased || 'x';\n}\n\n/**\n * Normalize a provider ID to MCP-safe characters.\n */\nexport function normalizeProviderId(raw: string | undefined, kind: NameCase): string | undefined {\n  if (!raw) return undefined;\n  const tokens = raw.split(/\\W+/);\n  const cased = toCase(tokens, kind);\n  const safe = [...cased].filter((ch) => MCP_ALLOWED.test(ch)).join('');\n  return safe || undefined;\n}\n\n/**\n * Normalize an owner path (app:id/plugin:id) to the specified naming case.\n */\nexport function normalizeOwnerPath(ownerKey: string, kind: NameCase): string {\n  const levels = ownerKey.split('/');\n  const normLevels = levels.map((level) => {\n    const parts = level.split(':'); // [\"app\",\"Portal\"]\n    return parts.map((p) => normalizeSegment(p, kind)).join(sepFor(kind));\n  });\n  if (kind === 'camel') return normLevels.map((seg) => seg.charAt(0).toLowerCase() + seg.slice(1)).join('');\n  return normLevels.join(sepFor(kind));\n}\n\n/**\n * Generate a short hash (6 hex chars) from a string.\n * Uses djb2 algorithm for fast, reasonable distribution.\n */\nexport function shortHash(s: string): string {\n  let h = 5381;\n  for (let i = 0; i < s.length; i++) h = (h << 5) + h + s.charCodeAt(i);\n  return (h >>> 0).toString(16).slice(-6).padStart(6, '0');\n}\n\n/**\n * Ensure a name fits within a maximum length, using hash truncation if needed.\n * Preserves meaningful suffix while adding a hash for uniqueness.\n */\nexport function ensureMaxLen(name: string, max: number): string {\n  if (name.length <= max) return name;\n  const hash = shortHash(name);\n  const lastSep = Math.max(name.lastIndexOf('_'), name.lastIndexOf('-'), name.lastIndexOf('.'), name.lastIndexOf('/'));\n  const tail = lastSep > 0 ? name.slice(lastSep + 1) : name.slice(-Math.max(3, Math.min(16, Math.floor(max / 4))));\n  const budget = Math.max(1, max - (1 + hash.length + 1 + tail.length));\n  const prefix = name.slice(0, budget);\n  return `${prefix}-${hash}-${tail}`.slice(0, max);\n}\n"]}

package/src/utils/types.utils.d.ts

@@ -1,7 +1,7 @@
-import { z, ZodTypeAny } from 'zod';
+import { z, ZodType } from 'zod';
 type Primitive = string | number | boolean | bigint | null | undefined;
 type Flatten<T> = T extends Primitive ? T : T extends Array<infer U> ? Array<Flatten<U>> : T extends Set<infer U> ? Set<Flatten<U>> : T extends Map<infer K, infer V> ? Map<Flatten<K>, Flatten<V>> : T extends object ? {
     [K in keyof T]: Flatten<T[K]>;
 } : T;
-export type Infer<Schema extends ZodTypeAny> = Flatten<z.infer<Schema>>;
+export type Infer<Schema extends ZodType> = Flatten<z.infer<Schema>>;
 export {};

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":";AAAA,iDAAiD;AACjD,0CAA0C;;AAuB1C,4CA6BC;AAaD,4CAYC;AAcD,8CAQC;AAQD,sDAOC;AAKD,sCAEC;AA/GD;;;;;;;;;;;;GAYG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,QAAQ,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC/D,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,mEAAmE;IACnE,IAAI,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC/D,8DAA8D;QAC9D,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACjD,OAAO,IAAI,GAAG,KAAK,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE;QAC3D,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,kDAAkD;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC;QACpC,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,GAAW;IAC5D,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEjC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjC,MAAM,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,MAA8B;IAChF,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,uBAAuB,QAAQ,GAAG,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,QAAgB;IACpD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE;QAChD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,GAAW;IACvC,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC","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