@bleedingdev/modern-js-code-tools 3.9.0-ultramodern.10 → 3.9.0-ultramodern.12

package/dist/cjs/microvertical-api-baseline.cjs

@@ -38,63 +38,29 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     configuredMicroVerticalApiStem: ()=>configuredMicroVerticalApiStem,
-    consumerParserPlugins: ()=>consumerParserPlugins,
     microVerticalApiBaselineViolation: ()=>microVerticalApiBaselineViolation
 });
 const external_node_fs_namespaceObject = require("node:fs");
 var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
 const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
-const parser_namespaceObject = require("@babel/parser");
-const traverse_namespaceObject = require("@babel/traverse");
-var traverse_default = /*#__PURE__*/ __webpack_require__.n(traverse_namespaceObject);
 const types_namespaceObject = require("@babel/types");
 const external_microvertical_api_owner_cjs_namespaceObject = require("./microvertical-api-owner.cjs");
-const consumerParserPlugins = (filePath)=>filePath.endsWith('.tsx') || filePath.endsWith('.jsx') ? [
-        "typescript",
-        'jsx'
-    ] : [
-        "typescript"
-    ];
-class ConsumerSyntaxError extends Error {
-}
-class ConsumerValidationHub extends traverse_namespaceObject.Hub {
-    buildError(_node, message) {
-        return new ConsumerSyntaxError(message);
-    }
-}
+const external_source_analysis_cjs_namespaceObject = require("./source-analysis.cjs");
 function parseConsumer(filePath) {
     if (external_node_fs_default().statSync(filePath).size > 1000000) throw new Error(`${filePath}: consumer source exceeds 1 MB analysis budget`);
-    let file;
-    try {
-        file = (0, parser_namespaceObject.parse)(external_node_fs_default().readFileSync(filePath, 'utf8'), {
-            sourceType: 'module',
-            sourceFilename: filePath,
-            plugins: consumerParserPlugins(filePath)
-        });
-    } catch (error) {
-        if ('object' == typeof error && null !== error && 'code' in error && 'BABEL_PARSER_SYNTAX_ERROR' === error.code) throw new ConsumerSyntaxError(error instanceof Error ? error.message : String(error));
-        throw error;
-    }
-    const program = traverse_namespaceObject.NodePath.get({
-        hub: new ConsumerValidationHub(),
-        parentPath: void 0,
-        parent: file,
-        container: file,
-        key: 'program'
-    });
-    program.setContext();
-    traverse_default()(file, {
+    const file = (0, external_source_analysis_cjs_namespaceObject.parseSource)(external_node_fs_default().readFileSync(filePath, 'utf8'), filePath);
+    (0, external_source_analysis_cjs_namespaceObject.traverseSource)(file, {
         AssignmentExpression (p) {
-            throw new ConsumerSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+            throw new external_source_analysis_cjs_namespaceObject.SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
         },
         UpdateExpression (p) {
-            throw new ConsumerSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+            throw new external_source_analysis_cjs_namespaceObject.SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
         },
         TSModuleDeclaration () {
-            throw new ConsumerSyntaxError('contract bindings must not be merged with namespaces');
+            throw new external_source_analysis_cjs_namespaceObject.SourceSyntaxError('contract bindings must not be merged with namespaces');
         }
-    }, program.scope, void 0, program);
+    });
     return file;
 }
 const camelCaseStem = (stem)=>stem.replaceAll(/-([a-z0-9])/gu, (_match, letter)=>letter.toUpperCase());
@@ -119,24 +85,19 @@ const accessPath = (node)=>{
     }
 };
 const isAccessPath = (node, expected)=>accessPath(node)?.join('.') === expected.join('.');
-const unwrapExpression = (expression)=>{
-    let current = expression;
-    while(types_namespaceObject.isTSAsExpression(current) || types_namespaceObject.isParenthesizedExpression(current) || types_namespaceObject.isTSSatisfiesExpression(current))current = current.expression;
-    return current;
-};
 const stringLiteral = (expression)=>{
     if (null == expression) return;
-    const unwrapped = unwrapExpression(expression);
+    const unwrapped = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
     return types_namespaceObject.isStringLiteral(unwrapped) ? unwrapped.value : void 0;
 };
 const numericLiteral = (expression)=>{
     if (null == expression) return;
-    const unwrapped = unwrapExpression(expression);
+    const unwrapped = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
     return types_namespaceObject.isNumericLiteral(unwrapped) ? Number(unwrapped.value) : void 0;
 };
 const callExpression = (expression, callee)=>{
     if (null == expression) return;
-    const unwrapped = unwrapExpression(expression);
+    const unwrapped = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
     return types_namespaceObject.isCallExpression(unwrapped) && isAccessPath(unwrapped.callee, callee) ? unwrapped : void 0;
 };
 const localConst = (sourceFile, name)=>{
@@ -270,7 +231,7 @@ const resolveBinding = (module, name, scope, readModule, seen)=>{
 };
 const objectLiteral = (expression)=>{
     if (null == expression) return;
-    const unwrapped = unwrapExpression(expression);
+    const unwrapped = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
     return types_namespaceObject.isObjectExpression(unwrapped) ? unwrapped : void 0;
 };
 const propertyAssignments = (properties)=>{
@@ -289,7 +250,7 @@ const exactCall = (expression, callee, argumentCount)=>{
 };
 const sharedSchemaObject = (declaration, sharedSchemaName, protectedFields)=>{
     if (declaration?.init == null) return;
-    const initializer = unwrapExpression(declaration.init);
+    const initializer = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(declaration.init);
     if (types_namespaceObject.isIdentifier(initializer) && initializer.name === sharedSchemaName) return {
         assignments: new Map(),
         identity: true
@@ -313,14 +274,14 @@ const sharedSchemaObject = (declaration, sharedSchemaName, protectedFields)=>{
 };
 const directCallChain = (expression)=>{
     if (null == expression) return;
-    let current = unwrapExpression(expression);
+    let current = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
     const methods = [];
     while(types_namespaceObject.isCallExpression(current) && types_namespaceObject.isMemberExpression(current.callee) && !current.callee.computed && types_namespaceObject.isIdentifier(current.callee.property) && !types_namespaceObject.isIdentifier(current.callee.object)){
         methods.unshift({
             arguments: current.arguments,
             name: current.callee.property.name
         });
-        current = unwrapExpression(current.callee.object);
+        current = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(current.callee.object);
     }
     if (!types_namespaceObject.isCallExpression(current)) return;
     return {
@@ -331,7 +292,7 @@ const directCallChain = (expression)=>{
 const brandedStringSchemaIsExact = (declaration, brand)=>{
     const initializer = declaration?.init;
     if (null == initializer) return false;
-    const pipeCall = unwrapExpression(initializer);
+    const pipeCall = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(initializer);
     if (!types_namespaceObject.isCallExpression(pipeCall) || !types_namespaceObject.isMemberExpression(pipeCall.callee) || pipeCall.callee.computed || !types_namespaceObject.isIdentifier(pipeCall.callee.property, {
         name: 'pipe'
     }) || !isAccessPath(pipeCall.callee.object, [
@@ -431,7 +392,7 @@ const reachableEndpoints = (rootModule, declaration)=>{
     let visits = 0;
     const visit = (expression, module, kind, group = '')=>{
         if (!expression) return false;
-        const node = unwrapExpression(expression);
+        const node = (0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(expression);
         if (active.has(node) || active.size >= 128 || ++visits > 2048) return false;
         active.add(node);
         try {
@@ -622,7 +583,7 @@ const readinessSchemaIsShared = (declaration, markerSchemaName, ownerMarkerIsIde
     ]);
     return void 0 !== schema && (schema.identity && ownerMarkerIsIdentity || 1 === schema.assignments.size && identifierName(schema.assignments.get('marker')?.value) === markerSchemaName);
 };
-const declarationIsIdentifier = (declaration, identifier)=>declaration?.init != null && identifierName(unwrapExpression(declaration.init)) === identifier;
+const declarationIsIdentifier = (declaration, identifier)=>declaration?.init != null && identifierName((0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(declaration.init)) === identifier;
 const validateParsedContract = (module, stem, expectation)=>{
     const sourceFile = module.file;
     const exportStem = camelCaseStem(stem);
@@ -660,16 +621,14 @@ const microVerticalApiBaselineViolation = (stem, filePath, expectation)=>{
             path: filePath
         }, stem, expectation);
     } catch (error) {
-        if (error instanceof ConsumerSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
+        if (error instanceof external_source_analysis_cjs_namespaceObject.SourceSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
         throw error;
     }
 };
 exports.configuredMicroVerticalApiStem = __webpack_exports__.configuredMicroVerticalApiStem;
-exports.consumerParserPlugins = __webpack_exports__.consumerParserPlugins;
 exports.microVerticalApiBaselineViolation = __webpack_exports__.microVerticalApiBaselineViolation;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "configuredMicroVerticalApiStem",
-    "consumerParserPlugins",
     "microVerticalApiBaselineViolation"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {

package/dist/cjs/microvertical-api-boundary.cjs

@@ -50,6 +50,7 @@ const parser_namespaceObject = require("@babel/parser");
 const types_namespaceObject = require("@babel/types");
 const external_microvertical_api_baseline_cjs_namespaceObject = require("./microvertical-api-baseline.cjs");
 const external_microvertical_api_owner_cjs_namespaceObject = require("./microvertical-api-owner.cjs");
+const external_source_analysis_cjs_namespaceObject = require("./source-analysis.cjs");
 const external_strict_effect_runtime_cjs_namespaceObject = require("./strict-effect-runtime.cjs");
 const ignored = new Set([
     '.git',
@@ -159,7 +160,7 @@ function check(options, topology) {
                 const ast = (0, parser_namespaceObject.parse)(read(file), {
                     sourceType: 'module',
                     sourceFilename: file,
-                    plugins: (0, external_microvertical_api_baseline_cjs_namespaceObject.consumerParserPlugins)(file)
+                    plugins: (0, external_source_analysis_cjs_namespaceObject.consumerParserPlugins)(file)
                 });
                 parsed.set(file, ast);
                 return ast;

package/dist/cjs/source-analysis.cjs

@@ -0,0 +1,104 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    SourceSyntaxError: ()=>SourceSyntaxError,
+    consumerParserPlugins: ()=>consumerParserPlugins,
+    parseSource: ()=>parseSource,
+    traverseSource: ()=>traverseSource,
+    unwrapExpression: ()=>unwrapExpression
+});
+const parser_namespaceObject = require("@babel/parser");
+const traverse_namespaceObject = require("@babel/traverse");
+var traverse_default = /*#__PURE__*/ __webpack_require__.n(traverse_namespaceObject);
+const types_namespaceObject = require("@babel/types");
+const consumerParserPlugins = (filePath)=>/\.[jt]sx$/u.test(filePath) ? [
+        "typescript",
+        'jsx'
+    ] : [
+        "typescript"
+    ];
+class SourceSyntaxError extends Error {
+}
+class SourceValidationHub extends traverse_namespaceObject.Hub {
+    buildError(_node, message) {
+        return new SourceSyntaxError(message);
+    }
+}
+function parseSource(source, filename, syntaxMessage) {
+    try {
+        return (0, parser_namespaceObject.parse)(source, {
+            sourceType: 'module',
+            sourceFilename: filename,
+            plugins: consumerParserPlugins(filename)
+        });
+    } catch (cause) {
+        if ('object' == typeof cause && null !== cause && 'code' in cause && 'BABEL_PARSER_SYNTAX_ERROR' === cause.code && 'reasonCode' in cause && 'string' == typeof cause.reasonCode) throw new SourceSyntaxError(syntaxMessage ?? (cause instanceof Error ? cause.message : String(cause)));
+        throw cause;
+    }
+}
+function traverseSource(file, visitor) {
+    const program = traverse_namespaceObject.NodePath.get({
+        hub: new SourceValidationHub(),
+        parentPath: void 0,
+        parent: file,
+        container: file,
+        key: 'program'
+    });
+    program.setContext();
+    traverse_default()(file, visitor, program.scope, void 0, program);
+}
+function unwrapExpression(node, includeAssertions = false) {
+    while(types_namespaceObject.isTSAsExpression(node) || types_namespaceObject.isParenthesizedExpression(node) || types_namespaceObject.isTSSatisfiesExpression(node) || includeAssertions && (types_namespaceObject.isTSTypeAssertion(node) || types_namespaceObject.isTSNonNullExpression(node)))node = node.expression;
+    return node;
+}
+exports.SourceSyntaxError = __webpack_exports__.SourceSyntaxError;
+exports.consumerParserPlugins = __webpack_exports__.consumerParserPlugins;
+exports.parseSource = __webpack_exports__.parseSource;
+exports.traverseSource = __webpack_exports__.traverseSource;
+exports.unwrapExpression = __webpack_exports__.unwrapExpression;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "SourceSyntaxError",
+    "consumerParserPlugins",
+    "parseSource",
+    "traverseSource",
+    "unwrapExpression"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/strict-effect-runtime.cjs

@@ -44,25 +44,12 @@ const external_node_fs_namespaceObject = require("node:fs");
 var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
 const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
-const parser_namespaceObject = require("@babel/parser");
-const traverse_namespaceObject = require("@babel/traverse");
-var traverse_default = /*#__PURE__*/ __webpack_require__.n(traverse_namespaceObject);
 const types_namespaceObject = require("@babel/types");
+const external_source_analysis_cjs_namespaceObject = require("./source-analysis.cjs");
 const edge = '@modern-js/bff-effect/effect-edge';
 const nodeRuntime = '@modern-js/bff-effect/effect';
 const sharedRuntime = /^@[^/]+\/shared-contracts\/server\/effect-bff-runtime$/u;
 const failure = 'Generated API entries must export defineEffectBff(...) or the server-only shared Effect BFF assembly helper with an explicitly composed handler Layer and an unshadowed executable root; entries must implement handlers through HttpApiBuilder.group.';
-const invalidSources = new WeakSet();
-function invalidSource(message) {
-    const error = new Error(message);
-    invalidSources.add(error);
-    return error;
-}
-class SourceValidationHub extends traverse_namespaceObject.Hub {
-    buildError(_node, message) {
-        return invalidSource(message);
-    }
-}
 function createEffectApiImportResolver(filename) {
     const directory = external_node_fs_default().realpathSync(external_node_path_default().dirname(filename));
     const owner = external_node_fs_default().realpathSync(external_node_path_default().resolve(directory, '..'));
@@ -94,34 +81,14 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
     const load = (input)=>{
         const existing = modules.get(input.id);
         if (existing) return existing;
-        if (modules.size >= 64 || input.source.length > 1000000) throw invalidSource('API source budget exceeded');
-        let file;
-        try {
-            file = (0, parser_namespaceObject.parse)(input.source, {
-                sourceType: 'module',
-                sourceFilename: input.id,
-                plugins: [
-                    "typescript"
-                ]
-            });
-        } catch (cause) {
-            if ('object' == typeof cause && null !== cause && 'code' in cause && 'BABEL_PARSER_SYNTAX_ERROR' === cause.code && 'reasonCode' in cause && 'string' == typeof cause.reasonCode) throw invalidSource('Invalid API syntax');
-            throw cause;
-        }
+        if (modules.size >= 64 || input.source.length > 1000000) throw new external_source_analysis_cjs_namespaceObject.SourceSyntaxError('API source budget exceeded');
+        const file = (0, external_source_analysis_cjs_namespaceObject.parseSource)(input.source, input.id, 'Invalid API syntax');
         const module = {
             ...input,
             file
         };
         modules.set(input.id, module);
-        const program = traverse_namespaceObject.NodePath.get({
-            hub: new SourceValidationHub(),
-            parentPath: void 0,
-            parent: file,
-            container: file,
-            key: 'program'
-        });
-        program.setContext();
-        traverse_default()(file, {
+        (0, external_source_analysis_cjs_namespaceObject.traverseSource)(file, {
             enter (nodePath) {
                 paths.set(nodePath.node, nodePath);
                 owners.set(nodePath.node, module);
@@ -140,7 +107,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
                     if (binding) mutated.add(binding);
                 }
             }
-        }, program.scope, void 0, program);
+        });
         return module;
     };
     try {
@@ -149,10 +116,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
             source,
             resolveImport
         });
-        const unwrap = (node)=>{
-            while(types_namespaceObject.isParenthesizedExpression(node) || types_namespaceObject.isTSSatisfiesExpression(node) || types_namespaceObject.isTSAsExpression(node) || types_namespaceObject.isTSTypeAssertion(node) || types_namespaceObject.isTSNonNullExpression(node))node = node.expression;
-            return node;
-        };
+        const unwrap = (node)=>(0, external_source_analysis_cjs_namespaceObject.unwrapExpression)(node, true);
         const binding = (node)=>{
             node = unwrap(node);
             if (!types_namespaceObject.isIdentifier(node)) return;
@@ -393,7 +357,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
         const root = entry.file.program.body.find((statement)=>types_namespaceObject.isExportDefaultDeclaration(statement));
         return root && runtime(root.declaration) ? void 0 : failure;
     } catch (cause) {
-        if ('object' == typeof cause && null !== cause && invalidSources.has(cause)) return failure;
+        if (cause instanceof external_source_analysis_cjs_namespaceObject.SourceSyntaxError) return failure;
         const message = 'object' == typeof cause && null !== cause && 'message' in cause && 'string' == typeof cause.message ? cause.message : String(cause);
         throw new Error(`Strict Effect API analysis failed: ${message}`, {
             cause

package/dist/esm/microvertical-api-baseline.js

@@ -1,54 +1,22 @@
 import node_fs from "node:fs";
 import node_path from "node:path";
-import { parse } from "@babel/parser";
-import traverse, { Hub, NodePath } from "@babel/traverse";
 import { baselinePublicIdentityIsExact } from "./microvertical-api-owner.js";
+import { SourceSyntaxError, parseSource, traverseSource, unwrapExpression } from "./source-analysis.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
-const consumerParserPlugins = (filePath)=>filePath.endsWith('.tsx') || filePath.endsWith('.jsx') ? [
-        "typescript",
-        'jsx'
-    ] : [
-        "typescript"
-    ];
-class ConsumerSyntaxError extends Error {
-}
-class ConsumerValidationHub extends Hub {
-    buildError(_node, message) {
-        return new ConsumerSyntaxError(message);
-    }
-}
 function parseConsumer(filePath) {
     if (node_fs.statSync(filePath).size > 1000000) throw new Error(`${filePath}: consumer source exceeds 1 MB analysis budget`);
-    let file;
-    try {
-        file = parse(node_fs.readFileSync(filePath, 'utf8'), {
-            sourceType: 'module',
-            sourceFilename: filePath,
-            plugins: consumerParserPlugins(filePath)
-        });
-    } catch (error) {
-        if ('object' == typeof error && null !== error && 'code' in error && 'BABEL_PARSER_SYNTAX_ERROR' === error.code) throw new ConsumerSyntaxError(error instanceof Error ? error.message : String(error));
-        throw error;
-    }
-    const program = NodePath.get({
-        hub: new ConsumerValidationHub(),
-        parentPath: void 0,
-        parent: file,
-        container: file,
-        key: 'program'
-    });
-    program.setContext();
-    traverse(file, {
+    const file = parseSource(node_fs.readFileSync(filePath, 'utf8'), filePath);
+    traverseSource(file, {
         AssignmentExpression (p) {
-            throw new ConsumerSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
         },
         UpdateExpression (p) {
-            throw new ConsumerSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
         },
         TSModuleDeclaration () {
-            throw new ConsumerSyntaxError('contract bindings must not be merged with namespaces');
+            throw new SourceSyntaxError('contract bindings must not be merged with namespaces');
         }
-    }, program.scope, void 0, program);
+    });
     return file;
 }
 const camelCaseStem = (stem)=>stem.replaceAll(/-([a-z0-9])/gu, (_match, letter)=>letter.toUpperCase());
@@ -73,11 +41,6 @@ const accessPath = (node)=>{
     }
 };
 const isAccessPath = (node, expected)=>accessPath(node)?.join('.') === expected.join('.');
-const unwrapExpression = (expression)=>{
-    let current = expression;
-    while(__rspack_external__babel_types_6e8337dd.isTSAsExpression(current) || __rspack_external__babel_types_6e8337dd.isParenthesizedExpression(current) || __rspack_external__babel_types_6e8337dd.isTSSatisfiesExpression(current))current = current.expression;
-    return current;
-};
 const stringLiteral = (expression)=>{
     if (null == expression) return;
     const unwrapped = unwrapExpression(expression);
@@ -614,8 +577,8 @@ const microVerticalApiBaselineViolation = (stem, filePath, expectation)=>{
             path: filePath
         }, stem, expectation);
     } catch (error) {
-        if (error instanceof ConsumerSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
+        if (error instanceof SourceSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
         throw error;
     }
 };
-export { configuredMicroVerticalApiStem, consumerParserPlugins, microVerticalApiBaselineViolation };
+export { configuredMicroVerticalApiStem, microVerticalApiBaselineViolation };

package/dist/esm/microvertical-api-boundary.js

@@ -1,8 +1,9 @@
 import node_fs from "node:fs";
 import node_path from "node:path";
 import { parse } from "@babel/parser";
-import { configuredMicroVerticalApiStem, consumerParserPlugins, microVerticalApiBaselineViolation } from "./microvertical-api-baseline.js";
+import { configuredMicroVerticalApiStem, microVerticalApiBaselineViolation } from "./microvertical-api-baseline.js";
 import { baselinePackage, resolveBaselinePackageDirectory } from "./microvertical-api-owner.js";
+import { consumerParserPlugins } from "./source-analysis.js";
 import { createEffectApiImportResolver, strictEffectRuntimeTopologyViolation } from "./strict-effect-runtime.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
 const ignored = new Set([

package/dist/esm/source-analysis.js

@@ -0,0 +1,44 @@
+import { parse } from "@babel/parser";
+import traverse, { Hub, NodePath } from "@babel/traverse";
+import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
+const consumerParserPlugins = (filePath)=>/\.[jt]sx$/u.test(filePath) ? [
+        "typescript",
+        'jsx'
+    ] : [
+        "typescript"
+    ];
+class SourceSyntaxError extends Error {
+}
+class SourceValidationHub extends Hub {
+    buildError(_node, message) {
+        return new SourceSyntaxError(message);
+    }
+}
+function parseSource(source, filename, syntaxMessage) {
+    try {
+        return parse(source, {
+            sourceType: 'module',
+            sourceFilename: filename,
+            plugins: consumerParserPlugins(filename)
+        });
+    } catch (cause) {
+        if ('object' == typeof cause && null !== cause && 'code' in cause && 'BABEL_PARSER_SYNTAX_ERROR' === cause.code && 'reasonCode' in cause && 'string' == typeof cause.reasonCode) throw new SourceSyntaxError(syntaxMessage ?? (cause instanceof Error ? cause.message : String(cause)));
+        throw cause;
+    }
+}
+function traverseSource(file, visitor) {
+    const program = NodePath.get({
+        hub: new SourceValidationHub(),
+        parentPath: void 0,
+        parent: file,
+        container: file,
+        key: 'program'
+    });
+    program.setContext();
+    traverse(file, visitor, program.scope, void 0, program);
+}
+function unwrapExpression(node, includeAssertions = false) {
+    while(__rspack_external__babel_types_6e8337dd.isTSAsExpression(node) || __rspack_external__babel_types_6e8337dd.isParenthesizedExpression(node) || __rspack_external__babel_types_6e8337dd.isTSSatisfiesExpression(node) || includeAssertions && (__rspack_external__babel_types_6e8337dd.isTSTypeAssertion(node) || __rspack_external__babel_types_6e8337dd.isTSNonNullExpression(node)))node = node.expression;
+    return node;
+}
+export { SourceSyntaxError, consumerParserPlugins, parseSource, traverseSource, unwrapExpression };

package/dist/esm/strict-effect-runtime.js

@@ -1,23 +1,11 @@
 import node_fs from "node:fs";
 import node_path from "node:path";
-import { parse } from "@babel/parser";
-import traverse, { Hub, NodePath } from "@babel/traverse";
+import { SourceSyntaxError, parseSource, traverseSource, unwrapExpression } from "./source-analysis.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
 const edge = '@modern-js/bff-effect/effect-edge';
 const nodeRuntime = '@modern-js/bff-effect/effect';
 const sharedRuntime = /^@[^/]+\/shared-contracts\/server\/effect-bff-runtime$/u;
 const failure = 'Generated API entries must export defineEffectBff(...) or the server-only shared Effect BFF assembly helper with an explicitly composed handler Layer and an unshadowed executable root; entries must implement handlers through HttpApiBuilder.group.';
-const invalidSources = new WeakSet();
-function invalidSource(message) {
-    const error = new Error(message);
-    invalidSources.add(error);
-    return error;
-}
-class SourceValidationHub extends Hub {
-    buildError(_node, message) {
-        return invalidSource(message);
-    }
-}
 function createEffectApiImportResolver(filename) {
     const directory = node_fs.realpathSync(node_path.dirname(filename));
     const owner = node_fs.realpathSync(node_path.resolve(directory, '..'));
@@ -49,34 +37,14 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
     const load = (input)=>{
         const existing = modules.get(input.id);
         if (existing) return existing;
-        if (modules.size >= 64 || input.source.length > 1000000) throw invalidSource('API source budget exceeded');
-        let file;
-        try {
-            file = parse(input.source, {
-                sourceType: 'module',
-                sourceFilename: input.id,
-                plugins: [
-                    "typescript"
-                ]
-            });
-        } catch (cause) {
-            if ('object' == typeof cause && null !== cause && 'code' in cause && 'BABEL_PARSER_SYNTAX_ERROR' === cause.code && 'reasonCode' in cause && 'string' == typeof cause.reasonCode) throw invalidSource('Invalid API syntax');
-            throw cause;
-        }
+        if (modules.size >= 64 || input.source.length > 1000000) throw new SourceSyntaxError('API source budget exceeded');
+        const file = parseSource(input.source, input.id, 'Invalid API syntax');
         const module = {
             ...input,
             file
         };
         modules.set(input.id, module);
-        const program = NodePath.get({
-            hub: new SourceValidationHub(),
-            parentPath: void 0,
-            parent: file,
-            container: file,
-            key: 'program'
-        });
-        program.setContext();
-        traverse(file, {
+        traverseSource(file, {
             enter (nodePath) {
                 paths.set(nodePath.node, nodePath);
                 owners.set(nodePath.node, module);
@@ -95,7 +63,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
                     if (binding) mutated.add(binding);
                 }
             }
-        }, program.scope, void 0, program);
+        });
         return module;
     };
     try {
@@ -104,10 +72,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
             source,
             resolveImport
         });
-        const unwrap = (node)=>{
-            while(__rspack_external__babel_types_6e8337dd.isParenthesizedExpression(node) || __rspack_external__babel_types_6e8337dd.isTSSatisfiesExpression(node) || __rspack_external__babel_types_6e8337dd.isTSAsExpression(node) || __rspack_external__babel_types_6e8337dd.isTSTypeAssertion(node) || __rspack_external__babel_types_6e8337dd.isTSNonNullExpression(node))node = node.expression;
-            return node;
-        };
+        const unwrap = (node)=>unwrapExpression(node, true);
         const binding = (node)=>{
             node = unwrap(node);
             if (!__rspack_external__babel_types_6e8337dd.isIdentifier(node)) return;
@@ -348,7 +313,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
         const root = entry.file.program.body.find((statement)=>__rspack_external__babel_types_6e8337dd.isExportDefaultDeclaration(statement));
         return root && runtime(root.declaration) ? void 0 : failure;
     } catch (cause) {
-        if ('object' == typeof cause && null !== cause && invalidSources.has(cause)) return failure;
+        if (cause instanceof SourceSyntaxError) return failure;
         const message = 'object' == typeof cause && null !== cause && 'message' in cause && 'string' == typeof cause.message ? cause.message : String(cause);
         throw new Error(`Strict Effect API analysis failed: ${message}`, {
             cause

package/dist/esm-node/microvertical-api-baseline.js

@@ -1,55 +1,23 @@
 import "node:module";
 import node_fs from "node:fs";
 import node_path from "node:path";
-import { parse } from "@babel/parser";
-import traverse, { Hub, NodePath } from "@babel/traverse";
 import { baselinePublicIdentityIsExact } from "./microvertical-api-owner.js";
+import { SourceSyntaxError, parseSource, traverseSource, unwrapExpression } from "./source-analysis.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
-const consumerParserPlugins = (filePath)=>filePath.endsWith('.tsx') || filePath.endsWith('.jsx') ? [
-        "typescript",
-        'jsx'
-    ] : [
-        "typescript"
-    ];
-class ConsumerSyntaxError extends Error {
-}
-class ConsumerValidationHub extends Hub {
-    buildError(_node, message) {
-        return new ConsumerSyntaxError(message);
-    }
-}
 function parseConsumer(filePath) {
     if (node_fs.statSync(filePath).size > 1000000) throw new Error(`${filePath}: consumer source exceeds 1 MB analysis budget`);
-    let file;
-    try {
-        file = parse(node_fs.readFileSync(filePath, 'utf8'), {
-            sourceType: 'module',
-            sourceFilename: filePath,
-            plugins: consumerParserPlugins(filePath)
-        });
-    } catch (error) {
-        if ('object' == typeof error && null !== error && 'code' in error && 'BABEL_PARSER_SYNTAX_ERROR' === error.code) throw new ConsumerSyntaxError(error instanceof Error ? error.message : String(error));
-        throw error;
-    }
-    const program = NodePath.get({
-        hub: new ConsumerValidationHub(),
-        parentPath: void 0,
-        parent: file,
-        container: file,
-        key: 'program'
-    });
-    program.setContext();
-    traverse(file, {
+    const file = parseSource(node_fs.readFileSync(filePath, 'utf8'), filePath);
+    traverseSource(file, {
         AssignmentExpression (p) {
-            throw new ConsumerSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
         },
         UpdateExpression (p) {
-            throw new ConsumerSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
+            throw new SourceSyntaxError(`contract bindings must be immutable at ${p.node.start}`);
         },
         TSModuleDeclaration () {
-            throw new ConsumerSyntaxError('contract bindings must not be merged with namespaces');
+            throw new SourceSyntaxError('contract bindings must not be merged with namespaces');
         }
-    }, program.scope, void 0, program);
+    });
     return file;
 }
 const camelCaseStem = (stem)=>stem.replaceAll(/-([a-z0-9])/gu, (_match, letter)=>letter.toUpperCase());
@@ -74,11 +42,6 @@ const accessPath = (node)=>{
     }
 };
 const isAccessPath = (node, expected)=>accessPath(node)?.join('.') === expected.join('.');
-const unwrapExpression = (expression)=>{
-    let current = expression;
-    while(__rspack_external__babel_types_6e8337dd.isTSAsExpression(current) || __rspack_external__babel_types_6e8337dd.isParenthesizedExpression(current) || __rspack_external__babel_types_6e8337dd.isTSSatisfiesExpression(current))current = current.expression;
-    return current;
-};
 const stringLiteral = (expression)=>{
     if (null == expression) return;
     const unwrapped = unwrapExpression(expression);
@@ -615,8 +578,8 @@ const microVerticalApiBaselineViolation = (stem, filePath, expectation)=>{
             path: filePath
         }, stem, expectation);
     } catch (error) {
-        if (error instanceof ConsumerSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
+        if (error instanceof SourceSyntaxError) return `MicroVertical root contract must be valid TypeScript syntax (${error.message})`;
         throw error;
     }
 };
-export { configuredMicroVerticalApiStem, consumerParserPlugins, microVerticalApiBaselineViolation };
+export { configuredMicroVerticalApiStem, microVerticalApiBaselineViolation };

package/dist/esm-node/microvertical-api-boundary.js

@@ -2,8 +2,9 @@ import "node:module";
 import node_fs from "node:fs";
 import node_path from "node:path";
 import { parse } from "@babel/parser";
-import { configuredMicroVerticalApiStem, consumerParserPlugins, microVerticalApiBaselineViolation } from "./microvertical-api-baseline.js";
+import { configuredMicroVerticalApiStem, microVerticalApiBaselineViolation } from "./microvertical-api-baseline.js";
 import { baselinePackage, resolveBaselinePackageDirectory } from "./microvertical-api-owner.js";
+import { consumerParserPlugins } from "./source-analysis.js";
 import { createEffectApiImportResolver, strictEffectRuntimeTopologyViolation } from "./strict-effect-runtime.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
 const ignored = new Set([

package/dist/esm-node/source-analysis.js

@@ -0,0 +1,45 @@
+import "node:module";
+import { parse } from "@babel/parser";
+import traverse, { Hub, NodePath } from "@babel/traverse";
+import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
+const consumerParserPlugins = (filePath)=>/\.[jt]sx$/u.test(filePath) ? [
+        "typescript",
+        'jsx'
+    ] : [
+        "typescript"
+    ];
+class SourceSyntaxError extends Error {
+}
+class SourceValidationHub extends Hub {
+    buildError(_node, message) {
+        return new SourceSyntaxError(message);
+    }
+}
+function parseSource(source, filename, syntaxMessage) {
+    try {
+        return parse(source, {
+            sourceType: 'module',
+            sourceFilename: filename,
+            plugins: consumerParserPlugins(filename)
+        });
+    } catch (cause) {
+        if ('object' == typeof cause && null !== cause && 'code' in cause && 'BABEL_PARSER_SYNTAX_ERROR' === cause.code && 'reasonCode' in cause && 'string' == typeof cause.reasonCode) throw new SourceSyntaxError(syntaxMessage ?? (cause instanceof Error ? cause.message : String(cause)));
+        throw cause;
+    }
+}
+function traverseSource(file, visitor) {
+    const program = NodePath.get({
+        hub: new SourceValidationHub(),
+        parentPath: void 0,
+        parent: file,
+        container: file,
+        key: 'program'
+    });
+    program.setContext();
+    traverse(file, visitor, program.scope, void 0, program);
+}
+function unwrapExpression(node, includeAssertions = false) {
+    while(__rspack_external__babel_types_6e8337dd.isTSAsExpression(node) || __rspack_external__babel_types_6e8337dd.isParenthesizedExpression(node) || __rspack_external__babel_types_6e8337dd.isTSSatisfiesExpression(node) || includeAssertions && (__rspack_external__babel_types_6e8337dd.isTSTypeAssertion(node) || __rspack_external__babel_types_6e8337dd.isTSNonNullExpression(node)))node = node.expression;
+    return node;
+}
+export { SourceSyntaxError, consumerParserPlugins, parseSource, traverseSource, unwrapExpression };

package/dist/esm-node/strict-effect-runtime.js

@@ -1,24 +1,12 @@
 import "node:module";
 import node_fs from "node:fs";
 import node_path from "node:path";
-import { parse } from "@babel/parser";
-import traverse, { Hub, NodePath } from "@babel/traverse";
+import { SourceSyntaxError, parseSource, traverseSource, unwrapExpression } from "./source-analysis.js";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
 const edge = '@modern-js/bff-effect/effect-edge';
 const nodeRuntime = '@modern-js/bff-effect/effect';
 const sharedRuntime = /^@[^/]+\/shared-contracts\/server\/effect-bff-runtime$/u;
 const failure = 'Generated API entries must export defineEffectBff(...) or the server-only shared Effect BFF assembly helper with an explicitly composed handler Layer and an unshadowed executable root; entries must implement handlers through HttpApiBuilder.group.';
-const invalidSources = new WeakSet();
-function invalidSource(message) {
-    const error = new Error(message);
-    invalidSources.add(error);
-    return error;
-}
-class SourceValidationHub extends Hub {
-    buildError(_node, message) {
-        return invalidSource(message);
-    }
-}
 function createEffectApiImportResolver(filename) {
     const directory = node_fs.realpathSync(node_path.dirname(filename));
     const owner = node_fs.realpathSync(node_path.resolve(directory, '..'));
@@ -50,34 +38,14 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
     const load = (input)=>{
         const existing = modules.get(input.id);
         if (existing) return existing;
-        if (modules.size >= 64 || input.source.length > 1000000) throw invalidSource('API source budget exceeded');
-        let file;
-        try {
-            file = parse(input.source, {
-                sourceType: 'module',
-                sourceFilename: input.id,
-                plugins: [
-                    "typescript"
-                ]
-            });
-        } catch (cause) {
-            if ('object' == typeof cause && null !== cause && 'code' in cause && 'BABEL_PARSER_SYNTAX_ERROR' === cause.code && 'reasonCode' in cause && 'string' == typeof cause.reasonCode) throw invalidSource('Invalid API syntax');
-            throw cause;
-        }
+        if (modules.size >= 64 || input.source.length > 1000000) throw new SourceSyntaxError('API source budget exceeded');
+        const file = parseSource(input.source, input.id, 'Invalid API syntax');
         const module = {
             ...input,
             file
         };
         modules.set(input.id, module);
-        const program = NodePath.get({
-            hub: new SourceValidationHub(),
-            parentPath: void 0,
-            parent: file,
-            container: file,
-            key: 'program'
-        });
-        program.setContext();
-        traverse(file, {
+        traverseSource(file, {
             enter (nodePath) {
                 paths.set(nodePath.node, nodePath);
                 owners.set(nodePath.node, module);
@@ -96,7 +64,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
                     if (binding) mutated.add(binding);
                 }
             }
-        }, program.scope, void 0, program);
+        });
         return module;
     };
     try {
@@ -105,10 +73,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
             source,
             resolveImport
         });
-        const unwrap = (node)=>{
-            while(__rspack_external__babel_types_6e8337dd.isParenthesizedExpression(node) || __rspack_external__babel_types_6e8337dd.isTSSatisfiesExpression(node) || __rspack_external__babel_types_6e8337dd.isTSAsExpression(node) || __rspack_external__babel_types_6e8337dd.isTSTypeAssertion(node) || __rspack_external__babel_types_6e8337dd.isTSNonNullExpression(node))node = node.expression;
-            return node;
-        };
+        const unwrap = (node)=>unwrapExpression(node, true);
         const binding = (node)=>{
             node = unwrap(node);
             if (!__rspack_external__babel_types_6e8337dd.isIdentifier(node)) return;
@@ -349,7 +314,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
         const root = entry.file.program.body.find((statement)=>__rspack_external__babel_types_6e8337dd.isExportDefaultDeclaration(statement));
         return root && runtime(root.declaration) ? void 0 : failure;
     } catch (cause) {
-        if ('object' == typeof cause && null !== cause && invalidSources.has(cause)) return failure;
+        if (cause instanceof SourceSyntaxError) return failure;
         const message = 'object' == typeof cause && null !== cause && 'message' in cause && 'string' == typeof cause.message ? cause.message : String(cause);
         throw new Error(`Strict Effect API analysis failed: ${message}`, {
             cause

package/dist/types/microvertical-api-baseline.d.ts

@@ -1,8 +1,3 @@
-/**
- * Only `.tsx` is JSX. Enabling JSX for a `.ts` file misreads a generic arrow
- * such as `const f = <T>(value: T) => value` as an unclosed JSX element.
- */
-export declare const consumerParserPlugins: (filePath: string) => ('typescript' | 'jsx')[];
 export interface MicroVerticalApiBaselineExpectation {
     /** Optional override for operation IDs outside reachable endpoint naming conventions. */
     readonly operationPaths?: Readonly<Record<string, string>>;

package/dist/types/source-analysis.d.ts

@@ -0,0 +1,10 @@
+import { type Visitor } from '@babel/traverse';
+import * as t from '@babel/types';
+/** Only JSX extensions enable JSX: generic arrows in .ts must remain valid. */
+export declare const consumerParserPlugins: (filePath: string) => ('typescript' | 'jsx')[];
+/** Only parser/binder diagnostics are policy violations; tool failures escape. */
+export declare class SourceSyntaxError extends Error {
+}
+export declare function parseSource(source: string, filename: string, syntaxMessage?: string): t.File;
+export declare function traverseSource(file: t.File, visitor: Visitor): void;
+export declare function unwrapExpression(node: t.Node, includeAssertions?: boolean): t.Node;

package/package.json

@@ -23,7 +23,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.9.0-ultramodern.10",
+  "version": "3.9.0-ultramodern.12",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/esm-node/index.js",
   "typesVersions": {