@bleedingdev/modern-js-code-tools 3.9.0-ultramodern.3 → 3.9.0-ultramodern.5

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

@@ -4,7 +4,8 @@ import node_path from "node:path";
 import { parse } from "@babel/parser";
 import traverse, { Hub, NodePath } from "@babel/traverse";
 import * as __rspack_external__babel_types_6e8337dd from "@babel/types";
-const edge = '@modern-js/plugin-bff/effect-edge';
+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();
@@ -120,23 +121,38 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
         const imported = (node)=>{
             const value = binding(node);
             const decl = value?.path.node;
-            if (!decl || !__rspack_external__babel_types_6e8337dd.isImportSpecifier(decl) || 'type' === decl.importKind) return;
+            if (!decl || !__rspack_external__babel_types_6e8337dd.isImportSpecifier(decl) && !__rspack_external__babel_types_6e8337dd.isImportNamespaceSpecifier(decl) || __rspack_external__babel_types_6e8337dd.isImportSpecifier(decl) && 'type' === decl.importKind) return;
             const statement = value.path.parent;
             if (!__rspack_external__babel_types_6e8337dd.isImportDeclaration(statement) || 'type' === statement.importKind) return;
             return {
-                name: __rspack_external__babel_types_6e8337dd.isIdentifier(decl.imported) ? decl.imported.name : decl.imported.value,
+                namespace: __rspack_external__babel_types_6e8337dd.isImportNamespaceSpecifier(decl),
+                name: __rspack_external__babel_types_6e8337dd.isImportNamespaceSpecifier(decl) ? '*' : __rspack_external__babel_types_6e8337dd.isIdentifier(decl.imported) ? decl.imported.name : decl.imported.value,
                 specifier: statement.source.value
             };
         };
-        const native = (node, name, sources = [
-            edge
-        ])=>{
+        const namespaceSources = {
+            HttpApi: [
+                edge,
+                'effect/unstable/httpapi'
+            ],
+            HttpApiBuilder: [
+                edge,
+                'effect/unstable/httpapi'
+            ],
+            HttpRouter: [
+                edge,
+                'effect/unstable/http'
+            ]
+        };
+        const native = (node, name, sources)=>{
             const value = imported(node);
-            return value?.name === name && sources.includes(value.specifier);
+            if (!value) return false;
+            const importedNameMatches = value.namespace ? value.specifier === `effect/${name}` : value.name === name && value.specifier !== `effect/${name}`;
+            return importedNameMatches && (sources ?? namespaceSources[name] ?? [
+                edge
+            ]).includes(value.specifier);
         };
-        const method = (node, namespace, member, sources = [
-            edge
-        ])=>{
+        const method = (node, namespace, member, sources)=>{
             node = unwrap(node);
             return __rspack_external__babel_types_6e8337dd.isMemberExpression(node) && !node.computed && __rspack_external__babel_types_6e8337dd.isIdentifier(node.property, {
                 name: member
@@ -214,8 +230,15 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
         };
         const layerSources = [
             edge,
-            'effect'
+            'effect',
+            'effect/Layer'
         ];
+        const returned = (body)=>{
+            if (!__rspack_external__babel_types_6e8337dd.isBlockStatement(body)) return body;
+            const statements = body.body;
+            const last = statements.at(-1);
+            return statements.slice(0, -1).every((statement)=>__rspack_external__babel_types_6e8337dd.isVariableDeclaration(statement)) && __rspack_external__babel_types_6e8337dd.isReturnStatement(last) ? last.argument : void 0;
+        };
         const pipe = (node, check)=>__rspack_external__babel_types_6e8337dd.isMemberExpression(node.callee) && !node.callee.computed && __rspack_external__babel_types_6e8337dd.isIdentifier(node.callee.property, {
                 name: 'pipe'
             }) && check(node.callee.object) && node.arguments.every((argument)=>method(argument, 'Layer', 'orDie', layerSources) || __rspack_external__babel_types_6e8337dd.isCallExpression(argument) && method(argument.callee, 'Layer', 'provide', layerSources) && argument.arguments.length > 0);
@@ -224,7 +247,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
             if (!__rspack_external__babel_types_6e8337dd.isArrowFunctionExpression(node) && !__rspack_external__babel_types_6e8337dd.isFunctionExpression(node)) return false;
             const parameter = node.params[0];
             if (!__rspack_external__babel_types_6e8337dd.isIdentifier(parameter)) return false;
-            const body = __rspack_external__babel_types_6e8337dd.isBlockStatement(node.body) ? 1 === node.body.body.length && __rspack_external__babel_types_6e8337dd.isReturnStatement(node.body.body[0]) ? node.body.body[0].argument : void 0 : node.body;
+            const body = returned(node.body);
             const chain = (value, count = 0)=>{
                 value = unwrap(value);
                 if (__rspack_external__babel_types_6e8337dd.isIdentifier(value)) return count > 0 && declaration(value) === parameter;
@@ -280,7 +303,7 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
             const groupInit = groupValue && initialized(groupValue);
             if (!groupInit || !__rspack_external__babel_types_6e8337dd.isCallExpression(groupInit) || !method(groupInit.callee, 'RpcGroup', 'make', [
                 'effect/unstable/rpc',
-                '@modern-js/plugin-bff/effect-client'
+                '@modern-js/bff-effect/effect-client'
             ])) return false;
             const layerInit = initialized(layer) ?? unwrap(layer);
             if (!__rspack_external__babel_types_6e8337dd.isCallExpression(layerInit) || !__rspack_external__babel_types_6e8337dd.isMemberExpression(layerInit.callee) || layerInit.callee.computed || !__rspack_external__babel_types_6e8337dd.isIdentifier(layerInit.callee.property, {
@@ -300,7 +323,10 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
                 if (init) return runtime(init);
                 if (!__rspack_external__babel_types_6e8337dd.isCallExpression(node)) return false;
                 const value = imported(node.callee);
-                if (value?.name === 'defineEffectBff' && value.specifier === edge || value?.name === 'assembleEffectBffRuntime' && sharedRuntime.test(value.specifier)) {
+                if (value?.name === 'defineEffectBff' && [
+                    edge,
+                    nodeRuntime
+                ].includes(value.specifier) || value?.name === 'assembleEffectBffRuntime' && sharedRuntime.test(value.specifier)) {
                     if (1 !== node.arguments.length) return false;
                     const values = properties(node.arguments[0]);
                     if (!values) return false;
@@ -316,11 +342,9 @@ function strictEffectRuntimeTopologyViolation(source, resolveImport) {
                 }
                 const decl = declaration(node.callee);
                 const factory = decl && __rspack_external__babel_types_6e8337dd.isFunctionDeclaration(decl) ? decl : initialized(node.callee);
-                if (!factory || !__rspack_external__babel_types_6e8337dd.isFunctionDeclaration(factory) && !__rspack_external__babel_types_6e8337dd.isArrowFunctionExpression(factory) && !__rspack_external__babel_types_6e8337dd.isFunctionExpression(factory) || factory.params.length || node.arguments.length || !factory.body) return false;
-                if (!__rspack_external__babel_types_6e8337dd.isBlockStatement(factory.body)) return runtime(factory.body);
-                const statements = factory.body.body;
-                const last = statements.at(-1);
-                return statements.slice(0, -1).every((statement)=>__rspack_external__babel_types_6e8337dd.isVariableDeclaration(statement)) && !!last && __rspack_external__babel_types_6e8337dd.isReturnStatement(last) && !!last.argument && runtime(last.argument);
+                if (!factory || !__rspack_external__babel_types_6e8337dd.isFunctionDeclaration(factory) && !__rspack_external__babel_types_6e8337dd.isArrowFunctionExpression(factory) && !__rspack_external__babel_types_6e8337dd.isFunctionExpression(factory) || !factory.body) return false;
+                const result = returned(factory.body);
+                return !!result && runtime(result);
             });
         const root = entry.file.program.body.find((statement)=>__rspack_external__babel_types_6e8337dd.isExportDefaultDeclaration(statement));
         return root && runtime(root.declaration) ? void 0 : failure;

package/dist/types/cli/microvertical-api-check.d.ts

@@ -0,0 +1 @@
+export declare function runMicroVerticalApiCheckCli(args?: string[], filesOnly?: boolean): number;

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

@@ -0,0 +1,23 @@
+export interface MicroVerticalApiBaselineExpectation {
+    /** Optional override for operation IDs outside reachable endpoint naming conventions. */
+    readonly operationPaths?: Readonly<Record<string, string>>;
+    readonly additionalPaths: Readonly<Record<string, string>>;
+    readonly apiPrefix: string;
+    readonly basePath: string;
+    readonly effectClientPackage: string;
+    readonly ownerId: string;
+    readonly readinessPath: string;
+    readonly baselinePackage: '@modern-js/bff-effect/microvertical-api';
+    readonly baselinePackageDirectory: string;
+}
+export interface MicroVerticalTopologyEntry {
+    readonly api?: {
+        readonly readiness?: {
+            readonly endpoint?: string;
+        };
+    };
+    readonly id: string;
+    readonly path?: string;
+}
+export declare const configuredMicroVerticalApiStem: (verticalPath: string, verticals: readonly MicroVerticalTopologyEntry[]) => string | undefined;
+export declare const microVerticalApiBaselineViolation: (stem: string, filePath: string, expectation: MicroVerticalApiBaselineExpectation) => string | undefined;

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

@@ -0,0 +1,32 @@
+export type { MicroVerticalApiBaselineExpectation, MicroVerticalTopologyEntry, } from './microvertical-api-baseline.js';
+export { configuredMicroVerticalApiStem, microVerticalApiBaselineViolation, } from './microvertical-api-baseline.js';
+export interface MicroVerticalConfiguredApp {
+    readonly path: string;
+    readonly id?: string;
+    readonly kind?: string;
+    readonly package?: string;
+    readonly surfaceProfile?: string;
+    readonly deliveryUnitKind?: string;
+    readonly api?: {
+        readonly stem?: string;
+        readonly prefix?: string;
+        readonly protocol?: 'rest' | 'rpc';
+        readonly operationPaths?: Readonly<Record<string, string>>;
+        readonly additionalPaths?: Readonly<Record<string, string>>;
+    };
+}
+export interface MicroVerticalApiCheckOptions {
+    readonly workspaceRoot: string;
+    readonly configuredApps?: readonly MicroVerticalConfiguredApp[];
+    /** Explicit expected installed owner, useful for isolated/non-hoisted installations. */
+    readonly baselinePackageDirectory?: string;
+}
+export interface MicroVerticalApiCheckResult {
+    readonly diagnostics: readonly string[];
+    readonly toolErrors: readonly string[];
+    readonly topologyFilesAnalyzed: number;
+}
+/** Full standalone check: source runtime topology is analyzed once per entry. */
+export declare const checkMicroVerticalApiBoundaries: (options: MicroVerticalApiCheckOptions) => MicroVerticalApiCheckResult;
+/** Consumer files/export/owner checks; caller must separately run runtime topology analysis. */
+export declare const checkMicroVerticalApiConsumerFiles: (options: MicroVerticalApiCheckOptions) => MicroVerticalApiCheckResult;

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

@@ -0,0 +1,6 @@
+import type { MicroVerticalApiBaselineExpectation } from './microvertical-api-baseline.js';
+export declare const baselinePackage = "@modern-js/bff-effect/microvertical-api";
+/** Locate the installed package from this consumer's resolver, never this tool's installation. */
+export declare function resolveBaselinePackageDirectory(fromFile: string): string;
+/** Follow only public bindings and local barrels. Never examine schema implementation expressions. */
+export declare function baselinePublicIdentityIsExact(fromFile: string, expectation: MicroVerticalApiBaselineExpectation): boolean;

package/package.json

@@ -23,7 +23,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.9.0-ultramodern.3",
+  "version": "3.9.0-ultramodern.5",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/esm-node/index.js",
   "typesVersions": {
@@ -33,6 +33,9 @@
       ],
       "oxlint-plugin": [
         "./dist/types/oxlint-plugin.d.ts"
+      ],
+      "microvertical-api-boundary": [
+        "./dist/types/microvertical-api-boundary.d.ts"
       ]
     }
   },
@@ -57,10 +60,16 @@
         "require": "./dist/cjs/oxlint-plugin.cjs"
       },
       "default": "./dist/esm-node/oxlint-plugin.js"
+    },
+    "./microvertical-api-boundary": {
+      "types": "./dist/types/microvertical-api-boundary.d.ts",
+      "import": "./dist/esm-node/microvertical-api-boundary.js",
+      "require": "./dist/cjs/microvertical-api-boundary.cjs"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "bin"
   ],
   "dependencies": {
     "@babel/parser": "^8.0.4",
@@ -79,6 +88,10 @@
     "access": "public"
   },
   "modern:source": "./src/index.ts",
+  "bin": {
+    "modern-api-check": "bin/modern-api-check.mjs",
+    "modern-api-check-files": "bin/modern-api-check-files.mjs"
+  },
   "scripts": {
     "build": "rm -rf dist && rslib build -c rslib.config.mts",
     "dev": "rslib build -c rslib.config.mts -w",