@pcircle/memesh 2.6.6 → 2.7.0

package/dist/utils/tracing/TraceContext.js

@@ -0,0 +1,127 @@
+import { AsyncLocalStorage } from 'async_hooks';
+import crypto from 'crypto';
+const traceStorage = new AsyncLocalStorage();
+export function generateTraceId() {
+    const timestamp = Date.now();
+    const random = crypto.randomBytes(6).toString('hex');
+    return `trace-${timestamp}-${random}`;
+}
+export function generateSpanId() {
+    const random = crypto.randomBytes(4).toString('hex');
+    return `span-${random}`;
+}
+export function isValidTraceId(traceId) {
+    return /^trace-\d{13}-[0-9a-f]{12}$/.test(traceId);
+}
+export function isValidSpanId(spanId) {
+    return /^span-[0-9a-f]{8}$/.test(spanId);
+}
+export function parseW3CTraceparent(traceparent) {
+    const parts = traceparent.split('-');
+    if (parts.length !== 4 || parts[0] !== '00') {
+        return null;
+    }
+    const [, traceId, parentId, flags] = parts;
+    const sampled = (parseInt(flags, 16) & 1) === 1;
+    return {
+        traceId: `trace-${Date.now()}-${traceId.substring(0, 12)}`,
+        parentSpanId: `span-${parentId.substring(0, 8)}`,
+        sampled,
+    };
+}
+export function formatW3CTraceparent(context) {
+    const traceHex = context.traceId.split('-')[2] || '000000000000';
+    const spanHex = context.spanId.split('-')[1] || '00000000';
+    const paddedTrace = traceHex.padEnd(32, '0');
+    const paddedSpan = spanHex.padEnd(16, '0');
+    const flags = context.sampled ? '01' : '00';
+    return `00-${paddedTrace}-${paddedSpan}-${flags}`;
+}
+export function extractTraceContext(headers) {
+    const normalizedHeaders = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (value !== undefined) {
+            normalizedHeaders[key.toLowerCase()] = Array.isArray(value) ? value[0] : value;
+        }
+    }
+    const traceparent = normalizedHeaders['traceparent'];
+    if (traceparent) {
+        const parsed = parseW3CTraceparent(traceparent);
+        if (parsed) {
+            return {
+                traceId: parsed.traceId,
+                parentSpanId: parsed.parentSpanId,
+                sampled: parsed.sampled,
+            };
+        }
+    }
+    const xTraceId = normalizedHeaders['x-trace-id'];
+    if (xTraceId && isValidTraceId(xTraceId)) {
+        return {
+            traceId: xTraceId,
+            sampled: true,
+        };
+    }
+    const xRequestId = normalizedHeaders['x-request-id'];
+    if (xRequestId) {
+        return {
+            traceId: xRequestId.replace(/^req-/, 'trace-'),
+            sampled: true,
+        };
+    }
+    return null;
+}
+export function injectTraceContext(headers, context) {
+    return {
+        ...headers,
+        'traceparent': formatW3CTraceparent(context),
+        'X-Trace-Id': context.traceId,
+        'X-Request-Id': context.traceId,
+    };
+}
+export function createTraceContext(parentContext, sampled = true) {
+    return {
+        traceId: parentContext?.traceId || generateTraceId(),
+        spanId: generateSpanId(),
+        parentSpanId: parentContext?.spanId,
+        sampled,
+        baggage: parentContext?.baggage,
+    };
+}
+export function getTraceContext() {
+    return traceStorage.getStore();
+}
+export function runWithTraceContext(context, callback) {
+    return traceStorage.run(context, callback);
+}
+export function createChildSpan(spanName) {
+    const parent = getTraceContext();
+    const context = createTraceContext(parent, parent?.sampled ?? true);
+    if (spanName) {
+        context.baggage = {
+            ...context.baggage,
+            spanName,
+        };
+    }
+    return context;
+}
+export function withChildSpan(spanName, callback) {
+    const childContext = createChildSpan(spanName);
+    return runWithTraceContext(childContext, callback);
+}
+export async function withChildSpanAsync(spanName, callback) {
+    const childContext = createChildSpan(spanName);
+    return new Promise((resolve, reject) => {
+        runWithTraceContext(childContext, () => {
+            callback().then(resolve).catch(reject);
+        });
+    });
+}
+export function extractTraceTimestamp(traceId) {
+    const match = traceId.match(/^trace-(\d{13})-[0-9a-f]{12}$/);
+    if (!match) {
+        return null;
+    }
+    return parseInt(match[1], 10);
+}
+//# sourceMappingURL=TraceContext.js.map

package/dist/utils/tracing/TraceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceContext.js","sourceRoot":"","sources":["../../../src/utils/tracing/TraceContext.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,MAAM,MAAM,QAAQ,CAAC;AAwB5B,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAAgB,CAAC;AAU3D,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,SAAS,SAAS,IAAI,MAAM,EAAE,CAAC;AACxC,CAAC;AAUD,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,QAAQ,MAAM,EAAE,CAAC;AAC1B,CAAC;AAQD,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC;AAQD,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAWD,MAAM,UAAU,mBAAmB,CACjC,WAAmB;IAEnB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IAC3C,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAEhD,OAAO;QACL,OAAO,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QAC1D,YAAY,EAAE,QAAQ,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAChD,OAAO;KACR,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IAExD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC;IAG3D,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5C,OAAO,MAAM,WAAW,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;AACpD,CAAC;AAaD,MAAM,UAAU,mBAAmB,CACjC,OAAsD;IAGtD,MAAM,iBAAiB,GAA2B,EAAE,CAAC;IACrD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACjF,CAAC;IACH,CAAC;IAGD,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACrD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;IAGD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,QAAQ,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAGD,MAAM,UAAU,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACrD,IAAI,UAAU,EAAE,CAAC;QAEf,OAAO;YACL,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;YAC9C,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAcD,MAAM,UAAU,kBAAkB,CAChC,OAA+B,EAC/B,OAAqB;IAErB,OAAO;QACL,GAAG,OAAO;QACV,aAAa,EAAE,oBAAoB,CAAC,OAAO,CAAC;QAC5C,YAAY,EAAE,OAAO,CAAC,OAAO;QAC7B,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC;AASD,MAAM,UAAU,kBAAkB,CAChC,aAAqC,EACrC,OAAO,GAAG,IAAI;IAEd,OAAO;QACL,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,eAAe,EAAE;QACpD,MAAM,EAAE,cAAc,EAAE;QACxB,YAAY,EAAE,aAAa,EAAE,MAAM;QACnC,OAAO;QACP,OAAO,EAAE,aAAa,EAAE,OAAO;KAChC,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC;AACjC,CAAC;AASD,MAAM,UAAU,mBAAmB,CACjC,OAAqB,EACrB,QAAiB;IAEjB,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAQD,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;IAEpE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,OAAO,GAAG;YAChB,GAAG,OAAO,CAAC,OAAO;YAClB,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AASD,MAAM,UAAU,aAAa,CAAI,QAAgB,EAAE,QAAiB;IAClE,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,QAA0B;IAE1B,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE;YACrC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/utils/tracing/index.d.ts

@@ -0,0 +1,3 @@
+export { type TraceContext, generateTraceId, generateSpanId, isValidTraceId, isValidSpanId, parseW3CTraceparent, formatW3CTraceparent, extractTraceContext, injectTraceContext, createTraceContext, getTraceContext, runWithTraceContext, createChildSpan, withChildSpan, withChildSpanAsync, extractTraceTimestamp, } from './TraceContext.js';
+export { type TracedRequest, type TracingMiddlewareOptions, tracingMiddleware, getRequestTraceContext, spanMiddleware, } from './middleware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/tracing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/tracing/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,YAAY,EACjB,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/utils/tracing/index.js

@@ -0,0 +1,3 @@
+export { generateTraceId, generateSpanId, isValidTraceId, isValidSpanId, parseW3CTraceparent, formatW3CTraceparent, extractTraceContext, injectTraceContext, createTraceContext, getTraceContext, runWithTraceContext, createChildSpan, withChildSpan, withChildSpanAsync, extractTraceTimestamp, } from './TraceContext.js';
+export { tracingMiddleware, getRequestTraceContext, spanMiddleware, } from './middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/tracing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/tracing/index.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAGL,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/utils/tracing/middleware.d.ts

@@ -0,0 +1,15 @@
+import type { Request, Response, NextFunction } from 'express';
+import { type TraceContext } from './TraceContext.js';
+export interface TracedRequest extends Request {
+    traceContext?: TraceContext;
+}
+export interface TracingMiddlewareOptions {
+    enabled?: boolean;
+    samplingRate?: number;
+    headerName?: string;
+    injectResponseHeaders?: boolean;
+}
+export declare function tracingMiddleware(options?: TracingMiddlewareOptions): (req: Request, res: Response, next: NextFunction) => void;
+export declare function getRequestTraceContext(req: Request): TraceContext | undefined;
+export declare function spanMiddleware(spanName: string): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/utils/tracing/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/utils/tracing/middleware.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAKD,MAAM,WAAW,wBAAwB;IAEvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAmCD,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAsC3D;AAQD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAE7E;AAkBD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GACf,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAiC3D"}

package/dist/utils/tracing/middleware.js

@@ -0,0 +1,49 @@
+import { extractTraceContext, createTraceContext, runWithTraceContext, injectTraceContext, } from './TraceContext.js';
+export function tracingMiddleware(options = {}) {
+    const { enabled = true, samplingRate = 1.0, injectResponseHeaders = true, } = options;
+    return (req, res, next) => {
+        if (!enabled) {
+            next();
+            return;
+        }
+        const shouldSample = Math.random() < samplingRate;
+        const extracted = extractTraceContext(req.headers);
+        const traceContext = createTraceContext(extracted ?? undefined, shouldSample);
+        req.traceContext = traceContext;
+        if (injectResponseHeaders && traceContext.sampled) {
+            const headers = {};
+            injectTraceContext(headers, traceContext);
+            for (const [key, value] of Object.entries(headers)) {
+                res.setHeader(key, value);
+            }
+        }
+        runWithTraceContext(traceContext, () => {
+            next();
+        });
+    };
+}
+export function getRequestTraceContext(req) {
+    return req.traceContext;
+}
+export function spanMiddleware(spanName) {
+    return (req, res, next) => {
+        const parentContext = getRequestTraceContext(req);
+        if (!parentContext) {
+            next();
+            return;
+        }
+        const childContext = createTraceContext({
+            ...parentContext,
+            spanId: parentContext.spanId,
+        }, parentContext.sampled);
+        childContext.baggage = {
+            ...childContext.baggage,
+            spanName,
+        };
+        req.traceContext = childContext;
+        runWithTraceContext(childContext, () => {
+            next();
+        });
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/utils/tracing/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/utils/tracing/middleware.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAwD3B,MAAM,UAAU,iBAAiB,CAC/B,UAAoC,EAAE;IAEtC,MAAM,EACJ,OAAO,GAAG,IAAI,EACd,YAAY,GAAG,GAAG,EAClB,qBAAqB,GAAG,IAAI,GAC7B,GAAG,OAAO,CAAC;IAEZ,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAGD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC;QAGlD,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,kBAAkB,CAAC,SAAS,IAAI,SAAS,EAAE,YAAY,CAAC,CAAC;QAG7E,GAAqB,CAAC,YAAY,GAAG,YAAY,CAAC;QAGnD,IAAI,qBAAqB,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YAClD,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,kBAAkB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAGD,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,OAAQ,GAAqB,CAAC,YAAY,CAAC;AAC7C,CAAC;AAkBD,MAAM,UAAU,cAAc,CAC5B,QAAgB;IAEhB,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,MAAM,aAAa,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAElD,IAAI,CAAC,aAAa,EAAE,CAAC;YAEnB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAGD,MAAM,YAAY,GAAG,kBAAkB,CACrC;YACE,GAAG,aAAa;YAChB,MAAM,EAAE,aAAa,CAAC,MAAM;SAC7B,EACD,aAAa,CAAC,OAAO,CACtB,CAAC;QAGF,YAAY,CAAC,OAAO,GAAG;YACrB,GAAG,YAAY,CAAC,OAAO;YACvB,QAAQ;SACT,CAAC;QAGD,GAAqB,CAAC,YAAY,GAAG,YAAY,CAAC;QAGnD,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,12 @@
+export declare function validateFiniteNumber(value: number, name: string, options?: {
+    min?: number;
+    max?: number;
+}): void;
+export declare function validateSafeInteger(value: number, name: string): void;
+export declare function validatePercentage(value: number, name: string): void;
+export declare function validateNormalized(value: number, name: string): void;
+export declare function validateNonEmptyString(value: string, name: string): void;
+export declare function validateEnum<T extends string>(value: string, name: string, allowedValues: readonly T[]): asserts value is T;
+export declare function validateNonEmptyArray<T>(value: unknown, name: string): asserts value is T[];
+export declare function validateObjectSize(value: object, name: string, maxChars: number): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,IAAI,CAoBN;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAOrE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAWxE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,SAAS,CAAC,EAAE,GAC1B,OAAO,CAAC,KAAK,IAAI,CAAC,CAOpB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAWtB;AAYD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,IAAI,CA0BN"}

package/dist/utils/validation.js

@@ -0,0 +1,87 @@
+import { ValidationError } from '../errors/index.js';
+export function validateFiniteNumber(value, name, options) {
+    if (!Number.isFinite(value)) {
+        throw new ValidationError(`${name} must be finite number`, {
+            providedValue: value,
+        });
+    }
+    if (options?.min !== undefined && value < options.min) {
+        throw new ValidationError(`${name} must be >= ${options.min}`, {
+            providedValue: value,
+            min: options.min,
+        });
+    }
+    if (options?.max !== undefined && value > options.max) {
+        throw new ValidationError(`${name} must be <= ${options.max}`, {
+            providedValue: value,
+            max: options.max,
+        });
+    }
+}
+export function validateSafeInteger(value, name) {
+    if (!Number.isSafeInteger(value)) {
+        throw new ValidationError(`${name} must be safe integer`, {
+            providedValue: value,
+            max: Number.MAX_SAFE_INTEGER,
+        });
+    }
+}
+export function validatePercentage(value, name) {
+    validateFiniteNumber(value, name, { min: 0, max: 100 });
+}
+export function validateNormalized(value, name) {
+    validateFiniteNumber(value, name, { min: 0, max: 1 });
+}
+export function validateNonEmptyString(value, name) {
+    if (typeof value !== 'string') {
+        throw new ValidationError(`${name} must be string`, {
+            providedType: typeof value,
+        });
+    }
+    if (value.trim() === '') {
+        throw new ValidationError(`${name} cannot be empty`, {
+            providedValue: value,
+        });
+    }
+}
+export function validateEnum(value, name, allowedValues) {
+    if (!allowedValues.includes(value)) {
+        throw new ValidationError(`Invalid ${name}`, {
+            providedValue: value,
+            allowedValues: [...allowedValues],
+        });
+    }
+}
+export function validateNonEmptyArray(value, name) {
+    if (!Array.isArray(value)) {
+        throw new ValidationError(`${name} must be array`, {
+            providedType: typeof value,
+        });
+    }
+    if (value.length === 0) {
+        throw new ValidationError(`${name} cannot be empty array`, {
+            providedLength: 0,
+        });
+    }
+}
+export function validateObjectSize(value, name, maxChars) {
+    let serialized;
+    try {
+        serialized = JSON.stringify(value);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new ValidationError(`${name} cannot be serialized for size validation: ${reason}`, {
+            errorType: error instanceof Error ? error.constructor.name : typeof error,
+            hint: 'The object may contain circular references or non-serializable values (e.g., BigInt)',
+        });
+    }
+    const charCount = serialized.length;
+    if (charCount > maxChars) {
+        throw new ValidationError(`${name} exceeds character limit`, {
+            providedChars: charCount,
+            maxChars: maxChars,
+        });
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"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"}

package/mcp.json

@@ -0,0 +1,10 @@
+{
+  "memesh": {
+    "command": "node",
+    "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp/server-bootstrap.js"],
+    "env": {
+      "NODE_ENV": "production",
+      "MEMESH_DISABLE_DAEMON": "1"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pcircle/memesh",
-  "version": "2.6.6",
+  "version": "2.7.0",
   "description": "MeMesh - Your AI memory mesh for Claude Code. Smart routing, persistent memory, and intelligent task management.",
   "main": "dist/index.js",
   "type": "module",
@@ -11,6 +11,7 @@
     "dist/",
     "scripts/postinstall.js",
     "plugin.json",
+    "mcp.json",
     "README.md",
     "README.zh-TW.md",
     "LICENSE"
@@ -47,7 +48,10 @@
     "processes:restart": "./scripts/manage-mcp-processes.sh restart",
     "processes:orphaned": "./scripts/manage-mcp-processes.sh orphaned",
     "processes:config": "./scripts/manage-mcp-processes.sh config",
-    "verify:migration": "tsx scripts/verify-migration.ts"
+    "verify:migration": "tsx scripts/verify-migration.ts",
+    "a2a:generate-token": "bash scripts/generate-a2a-token.sh",
+    "a2a:regenerate-token": "bash scripts/generate-a2a-token.sh --force",
+    "a2a:show-token": "grep '^MEMESH_A2A_TOKEN=' .env | cut -d'=' -f2 || echo 'Token not found in .env'"
   },
   "keywords": [
     "claude",
@@ -73,6 +77,7 @@
     "@modelcontextprotocol/sdk": "^1.25.3",
     "@types/form-data": "^2.2.1",
     "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
     "@types/multer": "^2.0.0",
     "asciichart": "^1.5.25",
     "axios": "^1.13.2",
@@ -90,6 +95,7 @@
     "glob": "^13.0.0",
     "ink": "^6.6.0",
     "ink-spinner": "^5.0.0",
+    "inquirer": "^13.2.2",
     "log-update": "^7.0.2",
     "minimatch": "^10.1.1",
     "multer": "^2.0.2",
@@ -106,6 +112,7 @@
     "@types/express": "^5.0.6",
     "@types/node": "^25.0.9",
     "@types/react": "^19.2.8",
+    "@types/supertest": "^6.0.3",
     "@types/uuid": "^11.0.0",
     "@types/winston": "^2.4.4",
     "@typescript-eslint/eslint-plugin": "^8.53.0",
@@ -114,6 +121,7 @@
     "ajv": "^8.17.1",
     "eslint": "^9.39.2",
     "prettier": "^3.8.0",
+    "supertest": "^7.2.2",
     "tsx": "^4.19.2",
     "typedoc": "^0.28.16",
     "typescript": "^5.9.3",

package/plugin.json

@@ -4,18 +4,8 @@
   "author": {
     "name": "PCIRCLE AI"
   },
-  "version": "2.6.4",
+  "version": "2.6.6",
   "homepage": "https://github.com/PCIRCLE-AI/claude-code-buddy",
   "repository": "https://github.com/PCIRCLE-AI/claude-code-buddy",
-  "license": "AGPL-3.0",
-  "mcpServers": {
-    "memesh": {
-      "type": "stdio",
-      "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp/server-bootstrap.js"],
-      "env": {
-        "NODE_ENV": "production"
-      }
-    }
-  }
+  "license": "AGPL-3.0"
 }