@frontmcp/sdk 0.6.1 → 0.6.2

package/src/utils/naming.utils.js

@@ -1,136 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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/server.utils.js

@@ -1,59 +0,0 @@
-"use strict";
-// utils/with-response-handler.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withResponseHandler = withResponseHandler;
-function withResponseHandler(runner) {
-    let onSuccess = (res, result) => {
-        throw new Error('No success writer set');
-    };
-    let onError = (res, err) => {
-        const status = typeof err?.status === 'number' ? err.status : 500;
-        const code = err?.code ?? 'server_error';
-        const message = typeof err?.message === 'string' ? err.message : 'internal error';
-        res.status(status);
-        res.setHeader('Content-Type', 'application/json');
-        res.json({ error: code, message });
-    };
-    const builder = {
-        /** Set the success writer; chainable. */
-        success(fn) {
-            onSuccess = fn;
-            return builder;
-        },
-        /**
-         * Set the error writer and finalize into a ServerHookHandler.
-         * Calling this returns the Express-like/host handler.
-         */
-        fail(fn) {
-            onError = fn;
-            const handler = async (req, res) => {
-                try {
-                    const result = await Promise.resolve(runner(req));
-                    await onSuccess(res, result);
-                }
-                catch (err) {
-                    await onError(res, err);
-                }
-            };
-            return handler;
-        },
-        /**
-         * If you prefer not to end with .fail(), you can call .build() after setting .success().
-         * It will use the default error writer unless overridden via .fail() earlier.
-         */
-        build() {
-            const handler = async (req, res) => {
-                try {
-                    const result = await Promise.resolve(runner(req));
-                    await onSuccess(res, result);
-                }
-                catch (err) {
-                    await onError(res, err);
-                }
-            };
-            return handler;
-        },
-    };
-    return builder;
-}
-//# sourceMappingURL=server.utils.js.map

package/src/utils/server.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.utils.js","sourceRoot":"","sources":["../../../src/utils/server.utils.ts"],"names":[],"mappings":";AAAA,iCAAiC;;AAQjC,kDAwDC;AAxDD,SAAgB,mBAAmB,CAAI,MAAiB;IACtD,IAAI,SAAS,GAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;QAChD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC,CAAC;IAEF,IAAI,OAAO,GAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,OAAO,GAAG,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QAClE,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,cAAc,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,yCAAyC;QACzC,OAAO,CAAC,EAAoB;YAC1B,SAAS,GAAG,EAAE,CAAC;YACf,OAAO,OAAO,CAAC;QACjB,CAAC;QAED;;;WAGG;QACH,IAAI,CAAC,EAAe;YAClB,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAyB,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;gBACvD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAClD,MAAM,SAAS,CAAC,GAAG,EAAE,MAAW,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;QAED;;;WAGG;QACH,KAAK;YACH,MAAM,OAAO,GAAyB,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;gBACvD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAClD,MAAM,SAAS,CAAC,GAAG,EAAE,MAAW,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["// utils/with-response-handler.ts\n\nimport { ServerRequest, ServerRequestHandler, ServerResponse } from '../common';\n\ntype Runner<T> = (req: ServerRequest) => Promise<T> | T;\ntype SuccessWriter<T> = (res: ServerResponse, result: T) => void | Promise<void>;\ntype ErrorWriter = (res: ServerResponse, err: any) => void | Promise<void>;\n\nexport function withResponseHandler<T>(runner: Runner<T>) {\n  let onSuccess: SuccessWriter<T> = (res, result) => {\n    throw new Error('No success writer set');\n  };\n\n  let onError: ErrorWriter = (res, err) => {\n    const status = typeof err?.status === 'number' ? err.status : 500;\n    const code = err?.code ?? 'server_error';\n    const message = typeof err?.message === 'string' ? err.message : 'internal error';\n    res.status(status);\n    res.setHeader('Content-Type', 'application/json');\n    res.json({ error: code, message });\n  };\n\n  const builder = {\n    /** Set the success writer; chainable. */\n    success(fn: SuccessWriter<T>) {\n      onSuccess = fn;\n      return builder;\n    },\n\n    /**\n     * Set the error writer and finalize into a ServerHookHandler.\n     * Calling this returns the Express-like/host handler.\n     */\n    fail(fn: ErrorWriter): ServerRequestHandler {\n      onError = fn;\n      const handler: ServerRequestHandler = async (req, res) => {\n        try {\n          const result = await Promise.resolve(runner(req));\n          await onSuccess(res, result as T);\n        } catch (err: any) {\n          await onError(res, err);\n        }\n      };\n      return handler;\n    },\n\n    /**\n     * If you prefer not to end with .fail(), you can call .build() after setting .success().\n     * It will use the default error writer unless overridden via .fail() earlier.\n     */\n    build(): ServerRequestHandler {\n      const handler: ServerRequestHandler = async (req, res) => {\n        try {\n          const result = await Promise.resolve(runner(req));\n          await onSuccess(res, result as T);\n        } catch (err: any) {\n          await onError(res, err);\n        }\n      };\n      return handler;\n    },\n  };\n\n  return builder;\n}\n"]}

package/src/utils/string.utils.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.idFromString = idFromString;
-function idFromString(name) {
-    // Replace any invalid run with '-'
-    const cleaned = name.replace(/[^A-Za-z0-9_-]+/g, '-');
-    // Trim to max length and remove leading/trailing hyphens produced by cleaning
-    return cleaned.replace(/^-+|-+$/g, '').slice(0, 64);
-}
-//# sourceMappingURL=string.utils.js.map

package/src/utils/string.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"string.utils.js","sourceRoot":"","sources":["../../../src/utils/string.utils.ts"],"names":[],"mappings":";;AAAA,oCAKC;AALD,SAAgB,YAAY,CAAC,IAAY;IACvC,mCAAmC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACtD,8EAA8E;IAC9E,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC","sourcesContent":["export function idFromString(name: string): string {\n  // Replace any invalid run with '-'\n  const cleaned = name.replace(/[^A-Za-z0-9_-]+/g, '-');\n  // Trim to max length and remove leading/trailing hyphens produced by cleaning\n  return cleaned.replace(/^-+|-+$/g, '').slice(0, 64);\n}\n"]}

package/src/utils/token.utils.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPromise = exports.isClass = exports.tokenName = void 0;
-exports.getAsyncWithTokens = getAsyncWithTokens;
-exports.readWithParamTypes = readWithParamTypes;
-exports.depsOfClass = depsOfClass;
-exports.depsOfFunc = depsOfFunc;
-const common_1 = require("../common");
-const metadata_utils_1 = require("./metadata.utils");
-const tokenName = (t) => typeof t === 'function' && !!t.prototype
-    ? t.name
-    : t?.name ?? '[ref]';
-exports.tokenName = tokenName;
-const isClass = (x) => typeof x === 'function' && !!x.prototype;
-exports.isClass = isClass;
-const isPromise = (v) => !!v && typeof v.then === 'function';
-exports.isPromise = isPromise;
-function getAsyncWithTokens(klass) {
-    const resolver = (0, metadata_utils_1.getMetadata)(common_1.META_ASYNC_WITH_TOKENS, klass);
-    if (!resolver)
-        return null;
-    const arr = resolver() ?? [];
-    return arr.filter(exports.isClass);
-}
-/** Read param types for static with(...) only; TDZ-friendly. */
-function readWithParamTypes(klass, forWhat) {
-    const lazy = getAsyncWithTokens(klass);
-    if (lazy)
-        return lazy;
-    const meta = (0, metadata_utils_1.getMetadata)(common_1.DESIGN_PARAMTYPES, klass, 'with');
-    if (meta === undefined) {
-        const where = `${klass.name}.with(...)`;
-        const hint = 'Add @AsyncWith(() => [DepA, DepB]) to lazily declare deps, or decorate \'with\' so TypeScript emits design:paramtypes.';
-        throw new Error(`Cannot discover ${forWhat} deps for ${where}. ${hint}`);
-    }
-    const tdzIdx = meta.findIndex((t) => t === undefined);
-    if (tdzIdx !== -1) {
-        const where = `${klass.name}.with(...)`;
-        throw new Error(`Unresolved dependency at param #${tdzIdx} in ${where} (ESM circular import / TDZ).\n` +
-            `Fix: add @AsyncWith(() => [/* deps */]) on ${klass.name} to avoid TDZ, or refactor the import cycle.`);
-    }
-    return meta.filter(exports.isClass);
-}
-/** Discover deps for a CLASS token or a concrete Type (ctor/with). */
-function depsOfClass(klass, phase) {
-    if ((0, metadata_utils_1.hasAsyncWith)(klass))
-        return readWithParamTypes(klass, phase);
-    const ctorMeta = (0, metadata_utils_1.getMetadata)(common_1.DESIGN_PARAMTYPES, klass) ?? [];
-    const tdzIdx = ctorMeta.findIndex((t) => t === undefined);
-    if (tdzIdx !== -1) {
-        throw new Error(`Unresolved constructor dependency in ${klass.name} at param #${tdzIdx} (ESM circular import / TDZ).\n` +
-            `Fix: convert this provider to @AsyncWith(() => [/* deps */]) and use a static with(...), or break the import cycle.`);
-    }
-    return ctorMeta.filter(exports.isClass);
-}
-/** Discover deps for a Function token  without the first N args. */
-function depsOfFunc(fn, phase) {
-    const [_ignoreInput, ...fnMeta] = (0, metadata_utils_1.getMetadata)(common_1.DESIGN_PARAMTYPES, fn) ?? [];
-    const tdzIdx = fnMeta.findIndex((t) => t === undefined);
-    if (tdzIdx !== -1) {
-        throw new Error(`Unresolved function dependency in ${fn.name} at param #${tdzIdx} (ESM circular import / TDZ).\n`);
-    }
-    return fnMeta.filter(exports.isClass);
-}
-//# sourceMappingURL=token.utils.js.map

package/src/utils/token.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"token.utils.js","sourceRoot":"","sources":["../../../src/utils/token.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { DESIGN_PARAMTYPES, META_ASYNC_WITH_TOKENS, Token, Type } from '../common';\nimport { getMetadata, hasAsyncWith } from './metadata.utils';\n\nexport const tokenName = (t: Token): string =>\n  typeof t === 'function' && !!(t as any).prototype\n    ? (t as any).name\n    : (t as any)?.name ?? '[ref]';\n\nexport const isClass = (x: any): x is Type =>\n  typeof x === 'function' && !!x.prototype;\n\nexport const isPromise = (v: any): v is Promise<any> =>\n  !!v && typeof v.then === 'function';\n\nexport function getAsyncWithTokens(klass: Type<any>): Type<any>[] | null {\n  const resolver = getMetadata<null | (() => any[])>(\n    META_ASYNC_WITH_TOKENS,\n    klass,\n  ) as null | (() => any[]);\n  if (!resolver) return null;\n  const arr = resolver() ?? [];\n  return arr.filter(isClass) as Type<any>[];\n}\n\n/** Read param types for static with(...) only; TDZ-friendly. */\nexport function readWithParamTypes(klass: Type, forWhat: 'discovery' | 'invocation'): Type[] {\n  const lazy = getAsyncWithTokens(klass);\n  if (lazy) return lazy;\n\n  const meta = getMetadata<unknown[]>(DESIGN_PARAMTYPES, klass, 'with') as unknown[] | undefined;\n  if (meta === undefined) {\n    const where = `${klass.name}.with(...)`;\n    const hint =\n      'Add @AsyncWith(() => [DepA, DepB]) to lazily declare deps, or decorate \\'with\\' so TypeScript emits design:paramtypes.';\n    throw new Error(`Cannot discover ${forWhat} deps for ${where}. ${hint}`);\n  }\n\n  const tdzIdx = meta.findIndex((t) => t === undefined);\n  if (tdzIdx !== -1) {\n    const where = `${klass.name}.with(...)`;\n    throw new Error(\n      `Unresolved dependency at param #${tdzIdx} in ${where} (ESM circular import / TDZ).\\n` +\n      `Fix: add @AsyncWith(() => [/* deps */]) on ${klass.name} to avoid TDZ, or refactor the import cycle.`,\n    );\n  }\n\n  return (meta as any[]).filter(isClass) as Type[];\n}\n\n\n/** Discover deps for a CLASS token or a concrete Type (ctor/with). */\nexport function depsOfClass(klass: Type, phase: 'discovery' | 'invocation'): Type[] {\n  if (hasAsyncWith(klass)) return readWithParamTypes(klass, phase);\n  const ctorMeta: unknown[] = getMetadata<unknown[]>(DESIGN_PARAMTYPES, klass) ?? [];\n  const tdzIdx = ctorMeta.findIndex((t) => t === undefined);\n  if (tdzIdx !== -1) {\n    throw new Error(\n      `Unresolved constructor dependency in ${klass.name} at param #${tdzIdx} (ESM circular import / TDZ).\\n` +\n      `Fix: convert this provider to @AsyncWith(() => [/* deps */]) and use a static with(...), or break the import cycle.`,\n    );\n  }\n  return (ctorMeta as any[]).filter(isClass) as Type[];\n}\n\n\n/** Discover deps for a Function token  without the first N args. */\nexport function depsOfFunc(fn: (...args: any[])=>any | Promise<any>, phase: 'discovery' | 'invocation'): Type[] {\n  const [_ignoreInput, ...fnMeta]: unknown[] = getMetadata<unknown[]>(DESIGN_PARAMTYPES, fn) ?? [];\n  const tdzIdx = fnMeta.findIndex((t) => t === undefined);\n  if (tdzIdx !== -1) {\n    throw new Error(`Unresolved function dependency in ${fn.name} at param #${tdzIdx} (ESM circular import / TDZ).\\n`);\n  }\n  return (fnMeta as any[]).filter(isClass) as Type[];\n}\n"]}

package/src/utils/types.utils.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.utils.js.map

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

@@ -1 +0,0 @@
-{"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.js

@@ -1,113 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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.js

@@ -1,76 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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"]}