@bleedingdev/modern-js-plugin-bff 3.2.0-ultramodern.0

package/dist/types/utils/crossProjectApiPlugin.d.ts

@@ -0,0 +1,9 @@
+import type { AppTools, CliPlugin } from '@modern-js/app-tools';
+export declare const PACKAGE_NAME = "{packageName}";
+export declare const PREFIX = "{prefix}";
+export declare const API_DIR = "{apiDirectory}";
+export declare const LAMBDA_DIR = "{lambdaDirectory}";
+export declare const DIST_DIR = "{distDirectory}";
+export declare const RUNTIME_FRAMEWORK: string;
+export declare const crossProjectApiPlugin: () => CliPlugin<AppTools>;
+export default crossProjectApiPlugin;

package/dist/types/utils/effectClientGenerator.d.ts

@@ -0,0 +1,27 @@
+import type { HttpMethodDecider } from '@modern-js/types';
+export type EffectClientCodegenOptions = {
+    appDir: string;
+    apiDir: string;
+    resourcePath: string;
+    prefix: string;
+    port: number;
+    target?: string;
+    requestCreator?: string;
+    httpMethodDecider?: HttpMethodDecider;
+    dataPlatformBatch?: {
+        enabled?: boolean;
+        endpoint?: string;
+        flushIntervalMs?: number;
+        maxBatchSize?: number;
+        maxBatchBytes?: number;
+        requestTimeoutMs?: number;
+        allowedMethods?: string[];
+    };
+};
+export declare function renderEffectClientDeclaration(): string;
+export declare function generateEffectClientCode(options: EffectClientCodegenOptions): Promise<string | null>;
+export declare function resolveEffectEntryFile(options: {
+    appDir: string;
+    apiDir: string;
+    effectEntry?: string;
+}): string | false | undefined;

package/dist/types/utils/pluginGenerator.d.ts

@@ -0,0 +1,9 @@
+declare function pluginGenerator({ prefix, appDirectory, relativeDistPath, relativeApiPath, relativeLambdaPath, runtimeFramework, }: {
+    prefix: string;
+    appDirectory: string;
+    relativeDistPath: string;
+    relativeApiPath: string;
+    relativeLambdaPath: string;
+    runtimeFramework: 'hono' | 'effect';
+}): Promise<void>;
+export default pluginGenerator;

package/dist/types/utils/runtimeGenerator.d.ts

@@ -0,0 +1,7 @@
+declare function runtimeGenerator({ runtime, appDirectory, relativeDistPath, packageName, }: {
+    runtime: string;
+    appDirectory: string;
+    relativeDistPath: string;
+    packageName?: string;
+}): Promise<void>;
+export default runtimeGenerator;

package/docs/data-platform-architecture.md

@@ -0,0 +1,61 @@
+# UltraModern Data Platform Architecture (MF-safe)
+
+This document defines a clean, greenfield data architecture for Fate-style orchestration while preserving Module Federation and micro-frontend interoperability.
+
+## Goals
+
+- One canonical data contract for requests, views, actions, hydration, and invalidation.
+- Deterministic behavior across SSR/CSR and host/remote applications.
+- Strong tenant/app isolation by default, explicit cross-app communication only.
+- Protocol-level observability and integrity checks.
+
+## Core Contracts
+
+Implemented in `src/runtime/data-platform/index.ts`:
+
+- Operation identity: `createOperationId`
+- Cache/request scoping: `buildScopeKey`, `buildQueryKey`
+- Selection safety: `validateSelectionPlan`
+- Distributed tracing: `parseTraceparentHeader`, `formatTraceparentHeader`, `deriveChildTraceContext`
+- Request envelope: `createRequestEnvelope`, `validateRequestEnvelope`
+- Hydration integrity: `createHydrationEnvelope`, `validateHydrationEnvelope`
+- Invalidation routing: `createInvalidationEvent`, `shouldApplyInvalidation`
+
+## Mitigations Applied
+
+1. Operation ID collisions
+- IDs include namespace + api/group/endpoint + version + schema hash contribution.
+- IDs are deterministic and hashed from canonical payloads.
+
+2. Cross-app cache contamination
+- Scope key includes normalized origin + app namespace + identity dimensions.
+- Query keys include scope key and selection/input fingerprints.
+
+3. Invalid selection pushdown
+- Selection plans are depth-limited, field-limited, and optional allow-list validated.
+
+4. Trace discontinuity across host/remotes
+- Trace context is first-class and validated through W3C traceparent format.
+- Child spans preserve trace id and parent linkage.
+
+5. Hydration poisoning/staleness
+- Hydration payloads include checksum over canonical serialized payload + metadata.
+- Runtime/namespace/origin/protocol checks are validated.
+
+6. Unintended cross-namespace invalidation
+- Default: no cross-namespace invalidation.
+- Cross-app invalidation requires explicit target namespace + opt-in subscriber.
+
+## Test Strategy
+
+Contract and scenario coverage is in `tests/data-platform-contract.test.ts`:
+
+- Deterministic and collision-resistant operation IDs.
+- Scope/query key isolation across namespaces and normalized origins.
+- Selection validation guardrails (depth, count, allow-list, shape).
+- Request envelope integrity and required trace context checks.
+- Hydration checksum tamper detection.
+- Invalidation routing policy enforcement.
+- Simulated host/remote mutation and trace propagation scenarios.
+
+This suite is intended to be the non-negotiable compatibility gate for future data-runtime changes.

package/package.json

@@ -0,0 +1,172 @@
+{
+  "name": "@bleedingdev/modern-js-plugin-bff",
+  "description": "A Progressive React Framework for modern web development.",
+  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "bugs": {
+    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "directory": "packages/cli/plugin-bff"
+  },
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "framework",
+    "modern",
+    "modern.js"
+  ],
+  "version": "3.2.0-ultramodern.0",
+  "types": "./dist/types/cli.d.ts",
+  "main": "./dist/cjs/cli.js",
+  "exports": {
+    ".": {
+      "types": "./dist/types/cli.d.ts",
+      "node": {
+        "import": "./dist/esm-node/cli.mjs",
+        "require": "./dist/cjs/cli.js"
+      },
+      "default": "./dist/cjs/cli.js"
+    },
+    "./cli": {
+      "types": "./dist/types/cli.d.ts",
+      "node": {
+        "import": "./dist/esm-node/cli.mjs",
+        "require": "./dist/cjs/cli.js"
+      },
+      "default": "./dist/cjs/cli.js"
+    },
+    "./server-plugin": {
+      "types": "./dist/types/server.d.ts",
+      "node": {
+        "import": "./dist/esm-node/server.mjs",
+        "require": "./dist/cjs/server.js"
+      },
+      "default": "./dist/cjs/server.js"
+    },
+    "./server": {
+      "types": "./dist/types/runtime/effect/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime/effect/index.mjs",
+        "require": "./dist/cjs/runtime/effect/index.js"
+      },
+      "default": "./dist/cjs/runtime/effect/index.js"
+    },
+    "./hono-server": {
+      "types": "./dist/types/runtime/hono/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime/hono/index.mjs",
+        "require": "./dist/cjs/runtime/hono/index.js"
+      },
+      "default": "./dist/cjs/runtime/hono/index.js"
+    },
+    "./effect-server": {
+      "types": "./dist/types/runtime/effect/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime/effect/index.mjs",
+        "require": "./dist/cjs/runtime/effect/index.js"
+      },
+      "default": "./dist/cjs/runtime/effect/index.js"
+    },
+    "./effect-client": {
+      "types": "./dist/types/runtime/effect-client/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime/effect-client/index.mjs",
+        "require": "./dist/cjs/runtime/effect-client/index.js"
+      },
+      "default": "./dist/cjs/runtime/effect-client/index.js"
+    },
+    "./data-platform": {
+      "types": "./dist/types/runtime/data-platform/index.d.ts",
+      "node": {
+        "import": "./dist/esm-node/runtime/data-platform/index.mjs",
+        "require": "./dist/cjs/runtime/data-platform/index.js"
+      },
+      "default": "./dist/cjs/runtime/data-platform/index.js"
+    },
+    "./client": {
+      "types": "./dist/types/runtime/create-request/index.d.ts",
+      "default": "./dist/esm/runtime/create-request/index.mjs"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      ".": [
+        "./dist/types/index.d.ts"
+      ],
+      "cli": [
+        "./dist/types/cli.d.ts"
+      ],
+      "server-plugin": [
+        "./dist/types/server.d.ts"
+      ],
+      "server": [
+        "./dist/types/runtime/effect/index.d.ts"
+      ],
+      "hono-server": [
+        "./dist/types/runtime/hono/index.d.ts"
+      ],
+      "effect-server": [
+        "./dist/types/runtime/effect/index.d.ts"
+      ],
+      "effect-client": [
+        "./dist/types/runtime/effect-client/index.d.ts"
+      ],
+      "data-platform": [
+        "./dist/types/runtime/data-platform/index.d.ts"
+      ],
+      "client": [
+        "./dist/types/runtime/create-request/index.d.ts"
+      ]
+    }
+  },
+  "dependencies": {
+    "@effect/opentelemetry": "4.0.0-beta.66",
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/api-logs": "0.218.0",
+    "@opentelemetry/resources": "2.7.1",
+    "@opentelemetry/sdk-logs": "0.218.0",
+    "@opentelemetry/sdk-metrics": "2.7.1",
+    "@opentelemetry/sdk-trace-base": "2.7.1",
+    "@opentelemetry/sdk-trace-node": "2.7.1",
+    "@opentelemetry/sdk-trace-web": "2.7.1",
+    "@opentelemetry/semantic-conventions": "1.41.1",
+    "@swc/helpers": "^0.5.21",
+    "effect": "4.0.0-beta.66",
+    "qs": "^6.15.1",
+    "type-is": "^2.1.0",
+    "@modern-js/create-request": "npm:@bleedingdev/modern-js-create-request@3.2.0-ultramodern.0",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.2.0-ultramodern.0",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.2.0-ultramodern.0",
+    "@modern-js/bff-core": "npm:@bleedingdev/modern-js-bff-core@3.2.0-ultramodern.0",
+    "@modern-js/server-utils": "npm:@bleedingdev/modern-js-server-utils@3.2.0-ultramodern.0",
+    "@modern-js/builder": "npm:@bleedingdev/modern-js-builder@3.2.0-ultramodern.0"
+  },
+  "devDependencies": {
+    "@rsbuild/core": "2.0.6",
+    "@rslib/core": "0.21.5",
+    "@types/node": "^25.8.0",
+    "@types/qs": "^6.15.1",
+    "@types/type-is": "^1.6.7",
+    "@typescript/native-preview": "7.0.0-dev.20260516.1",
+    "memfs": "^4.57.2",
+    "zod": "^4.4.3",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.2.0-ultramodern.0",
+    "@modern-js/bff-runtime": "npm:@bleedingdev/modern-js-bff-runtime@3.2.0-ultramodern.0",
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.2.0-ultramodern.0",
+    "@scripts/rstest-config": "2.66.0",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.2.0-ultramodern.0",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.2.0-ultramodern.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rslib build && pnpm -w tsgo:dts \"$PWD\"",
+    "dev": "rslib build --watch",
+    "test": "rstest --passWithNoTests"
+  }
+}

package/rslib.config.mts

@@ -0,0 +1,4 @@
+import { rslibConfig } from '@modern-js/rslib';
+import { defineConfig } from '@rslib/core';
+
+export default defineConfig(rslibConfig);

package/rstest.config.mts

@@ -0,0 +1,10 @@
+import { withTestPreset } from '@scripts/rstest-config';
+
+export default withTestPreset({
+  setupFiles: ['@scripts/rstest-config/setup.ts'],
+  root: __dirname,
+  globals: true,
+  env: {
+    npm_package_name: 'tests',
+  },
+});

package/server.js

@@ -0,0 +1 @@
+module.exports = require('./dist/cjs/server');