@bleedingdev/modern-js-create 3.5.0-ultramodern.0 → 3.5.0-ultramodern.1

package/README.md

@@ -189,6 +189,30 @@ mise exec -- pnpm check
 mise exec -- pnpm build
 ```
 
+For strict Effect API migrations, update generated package metadata and Modern
+package aliases through the framework command before hand-editing app code:
+
+```bash
+pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.1 ultramodern \
+  migrate-strict-effect --version 3.5.0-ultramodern.1
+pnpm api:check
+pnpm contract:check
+pnpm check
+pnpm build
+```
+
+The command updates `.modernjs/ultramodern.json`, root `modernjs.packageSource`,
+generated Modern package aliases, old direct topology metadata, and the pnpm
+lockfile. It does not invent compatibility shims or move business code behind
+your back. If `pnpm api:check` still fails, migrate the source to
+`shared/api.ts`, `api/index.ts`, and `src/api/*-client.ts` and delete
+`api/effect`, `api/lambda`, `shared/effect`, and `src/effect` paths.
+
+Generated strict Effect workspaces pin the compatible Effect cohort through
+`pnpm-workspace.yaml` overrides: `effect@4.0.0-beta.89` and
+`@effect/vitest@4.0.0-beta.89`. Do not override those in app packages; update
+the framework cohort when the runtime moves.
+
 Use `--ultramodern-package-source=install` for published cohort proof and pin a
 specific release with `--ultramodern-package-version` when CI must prove an
 exact framework version. Keep `--workspace` only for local monorepo testing

package/dist/cjs/ultramodern-tooling/commands.cjs

@@ -51,6 +51,7 @@ const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
 const external_node_url_namespaceObject = require("node:url");
 const external_create_package_root_cjs_namespaceObject = require("../create-package-root.cjs");
+const external_ultramodern_package_source_cjs_namespaceObject = require("../ultramodern-package-source.cjs");
 const mf_validation_cjs_namespaceObject = require("../ultramodern-workspace/mf-validation.cjs");
 const workspace_scripts_cjs_namespaceObject = require("../ultramodern-workspace/workspace-scripts.cjs");
 const external_config_cjs_namespaceObject = require("./config.cjs");
@@ -64,6 +65,7 @@ Commands:
   validate
   typecheck
   mf-types
+  migrate-strict-effect
   public-surface
   cloudflare-proof
   performance-readiness
@@ -129,6 +131,248 @@ Checks real Module Federation config files and DTS archives for exposed apps.
     });
     return 0;
 }
+const modernPackageNames = new Set([
+    ...external_ultramodern_package_source_cjs_namespaceObject.ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES,
+    ...external_ultramodern_package_source_cjs_namespaceObject.ULTRAMODERN_WORKSPACE_MODERN_PACKAGES
+]);
+function readJsonFile(filePath) {
+    return JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf-8'));
+}
+function writeJsonFile(filePath, value) {
+    external_node_fs_default().writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf-8');
+}
+function readOption(args, name) {
+    const prefix = `${name}=`;
+    const inline = args.find((arg)=>arg.startsWith(prefix));
+    if (inline) {
+        const value = inline.slice(prefix.length);
+        if (!value) throw new Error(`${name} needs a value.`);
+        return value;
+    }
+    const index = args.indexOf(name);
+    if (-1 === index) return;
+    const value = args[index + 1];
+    if (!value || value.startsWith('--')) throw new Error(`${name} needs a value.`);
+    return value;
+}
+function hasFlag(args, name) {
+    return args.includes(name);
+}
+function listWorkspacePackageFiles(workspaceRoot) {
+    const packageFiles = [
+        'package.json'
+    ];
+    for (const directory of [
+        'apps',
+        'verticals',
+        'packages'
+    ]){
+        const absoluteDirectory = external_node_path_default().join(workspaceRoot, directory);
+        if (external_node_fs_default().existsSync(absoluteDirectory)) for (const entry of external_node_fs_default().readdirSync(absoluteDirectory, {
+            withFileTypes: true
+        })){
+            if (!entry.isDirectory()) continue;
+            const packageFile = external_node_path_default().join(directory, entry.name, 'package.json');
+            if (external_node_fs_default().existsSync(external_node_path_default().join(workspaceRoot, packageFile))) packageFiles.push(packageFile);
+        }
+    }
+    return packageFiles;
+}
+function updateModernDependencies(packageJson, packageSource) {
+    let changed = false;
+    for (const section of [
+        'dependencies',
+        'devDependencies',
+        'peerDependencies',
+        'optionalDependencies'
+    ]){
+        const dependencies = packageJson[section];
+        if (!(!dependencies || 'object' != typeof dependencies || Array.isArray(dependencies))) for (const packageName of Object.keys(dependencies)){
+            if (!modernPackageNames.has(packageName)) continue;
+            const nextSpecifier = (0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)(packageName, packageSource);
+            if (dependencies[packageName] !== nextSpecifier) {
+                dependencies[packageName] = nextSpecifier;
+                changed = true;
+            }
+        }
+    }
+    return changed;
+}
+function normalizeStrictEffectApiMetadata(value) {
+    const api = value.api;
+    if (!api || 'object' != typeof api || Array.isArray(api)) return false;
+    let changed = false;
+    const oldEffect = api.effect;
+    if (oldEffect && 'object' == typeof oldEffect && !Array.isArray(oldEffect)) {
+        if (void 0 === api.stem && 'string' == typeof oldEffect.stem) {
+            api.stem = oldEffect.stem;
+            changed = true;
+        }
+        if (void 0 === api.prefix && 'string' == typeof oldEffect.prefix) {
+            api.prefix = oldEffect.prefix;
+            changed = true;
+        }
+        if (void 0 === api.consumedBy && Array.isArray(oldEffect.consumedBy)) {
+            api.consumedBy = oldEffect.consumedBy;
+            changed = true;
+        }
+        delete api.effect;
+        changed = true;
+    }
+    if (void 0 !== api.runtime && 'effect' !== api.runtime) {
+        api.runtime = 'effect';
+        changed = true;
+    }
+    if (api.bff && 'object' == typeof api.bff && !Array.isArray(api.bff)) {
+        if (true !== api.bff.strictEffectApproach) {
+            api.bff.strictEffectApproach = true;
+            changed = true;
+        }
+    }
+    if ('string' == typeof value.path) {
+        const directServerEntry = `${value.path}/api/index.ts`;
+        if ('string' == typeof api.serverEntry && /\/api\/effect\/index\.[cm]?[jt]sx?$/u.test(api.serverEntry)) {
+            api.serverEntry = directServerEntry;
+            changed = true;
+        }
+        if (api.contract && 'object' == typeof api.contract && !Array.isArray(api.contract)) {
+            if ('./shared/effect/api' === api.contract.export) {
+                api.contract.export = './api';
+                changed = true;
+            }
+            if ('string' == typeof api.contract.path && /\/shared\/effect\/api\.[cm]?[jt]sx?$/u.test(api.contract.path)) {
+                api.contract.path = `${value.path}/shared/api.ts`;
+                changed = true;
+            }
+        }
+        if (api.client && 'object' == typeof api.client && !Array.isArray(api.client)) {
+            if ('./effect/client' === api.client.export) {
+                api.client.export = './api/client';
+                changed = true;
+            }
+            if ('string' == typeof api.client.path && /\/src\/effect\/[^/]+-client\.[cm]?ts$/u.test(api.client.path)) {
+                const basename = external_node_path_default().basename(api.client.path);
+                api.client.path = `${value.path}/src/api/${basename}`;
+                changed = true;
+            }
+        }
+        if (void 0 === api.serverEntry && 'effect' === api.runtime) {
+            api.serverEntry = directServerEntry;
+            changed = true;
+        }
+    }
+    return changed;
+}
+function updateUltramodernConfig(workspaceRoot, packageSource) {
+    const configPath = external_node_path_default().join(workspaceRoot, '.modernjs/ultramodern.json');
+    const config = readJsonFile(configPath);
+    config.packageSource = {
+        strategy: packageSource.strategy,
+        modernPackageVersion: packageSource.modernPackageVersion,
+        ...packageSource.registry ? {
+            registry: packageSource.registry
+        } : {},
+        ...packageSource.aliasScope ? {
+            aliasScope: packageSource.aliasScope
+        } : {},
+        ...packageSource.aliasPackageNamePrefix ? {
+            aliasPackageNamePrefix: packageSource.aliasPackageNamePrefix
+        } : {}
+    };
+    for (const app of config.topology?.apps ?? [])if (app && 'object' == typeof app && !Array.isArray(app)) normalizeStrictEffectApiMetadata(app);
+    writeJsonFile(configPath, config);
+}
+function updateReferenceTopology(workspaceRoot) {
+    const topologyPath = external_node_path_default().join(workspaceRoot, 'topology/reference-topology.json');
+    if (!external_node_fs_default().existsSync(topologyPath)) return false;
+    const topology = readJsonFile(topologyPath);
+    let changed = false;
+    for (const vertical of topology.verticals ?? [])if (vertical && 'object' == typeof vertical && !Array.isArray(vertical)) changed = normalizeStrictEffectApiMetadata(vertical) || changed;
+    if (changed) writeJsonFile(topologyPath, topology);
+    return changed;
+}
+function createMigrationPackageSource(args, current) {
+    const strategy = hasFlag(args, '--workspace') ? 'workspace' : 'install';
+    const registry = readOption(args, '--registry') ?? readOption(args, '--ultramodern-package-registry');
+    const explicitAliasScope = readOption(args, '--alias-scope') ?? readOption(args, '--ultramodern-package-scope');
+    const aliasScope = explicitAliasScope ?? ('install' === strategy && void 0 === registry ? current.packageSource?.aliasScope ?? external_ultramodern_package_source_cjs_namespaceObject.BLEEDINGDEV_PACKAGE_SCOPE : current.packageSource?.aliasScope);
+    const aliasPackageNamePrefix = readOption(args, '--alias-package-name-prefix') ?? readOption(args, '--ultramodern-package-name-prefix') ?? current.packageSource?.aliasPackageNamePrefix ?? (aliasScope ? external_ultramodern_package_source_cjs_namespaceObject.BLEEDINGDEV_PACKAGE_NAME_PREFIX : void 0);
+    if ('workspace' === strategy) return {
+        strategy,
+        modernPackageVersion: external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION,
+        ...registry ? {
+            registry
+        } : {},
+        ...aliasScope ? {
+            aliasScope
+        } : {},
+        ...aliasPackageNamePrefix ? {
+            aliasPackageNamePrefix
+        } : {}
+    };
+    const version = readOption(args, '--version') ?? readOption(args, '--ultramodern-package-version') ?? current.packageSource?.modernPackageVersion;
+    if (!version || version === external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION) throw new Error('migrate-strict-effect needs --version <published-ultramodern-version> for install package source.');
+    return {
+        strategy,
+        modernPackageVersion: version,
+        ...registry ? {
+            registry
+        } : {},
+        ...aliasScope ? {
+            aliasScope
+        } : {},
+        ...aliasPackageNamePrefix ? {
+            aliasPackageNamePrefix
+        } : {}
+    };
+}
+function runPnpmLockfileRefresh(context) {
+    const result = (0, external_node_child_process_namespaceObject.spawnSync)('pnpm', [
+        'install',
+        '--lockfile-only',
+        "--ignore-scripts"
+    ], {
+        cwd: context.workspaceRoot,
+        stdio: 'inherit'
+    });
+    if (result.error) throw result.error;
+    return result.status ?? 1;
+}
+function runMigrateStrictEffect(args, context) {
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(`Usage:
+  modern-js-create ultramodern migrate-strict-effect --version <version> [--skip-install]
+
+Updates generated UltraModern package-source metadata, Modern package aliases,
+direct Effect API topology metadata, and the pnpm lockfile for strict Effect
+workspaces. Source code still has to pass pnpm api:check and pnpm contract:check.
+`);
+        return 0;
+    }
+    const current = (0, external_config_cjs_namespaceObject.readUltramodernConfig)(context.workspaceRoot);
+    const packageSource = createMigrationPackageSource(args, current);
+    updateUltramodernConfig(context.workspaceRoot, packageSource);
+    updateReferenceTopology(context.workspaceRoot);
+    for (const relativePackageFile of listWorkspacePackageFiles(context.workspaceRoot)){
+        const packageFile = external_node_path_default().join(context.workspaceRoot, relativePackageFile);
+        const packageJson = readJsonFile(packageFile);
+        if ('package.json' === relativePackageFile) {
+            packageJson.modernjs ??= {};
+            packageJson.modernjs.packageSource = {
+                strategy: packageSource.strategy,
+                config: './.modernjs/ultramodern.json'
+            };
+        }
+        if (updateModernDependencies(packageJson, packageSource)) writeJsonFile(packageFile, packageJson);
+        else if ('package.json' === relativePackageFile) writeJsonFile(packageFile, packageJson);
+    }
+    if (!hasFlag(args, '--skip-install')) {
+        const status = runPnpmLockfileRefresh(context);
+        if (0 !== status) return status;
+    }
+    process.stdout.write(`UltraModern strict Effect metadata migrated to ${packageSource.modernPackageVersion}. Run pnpm api:check && pnpm contract:check next.\n`);
+    return 0;
+}
 function runSkills(args, context) {
     const [subcommand, ...rest] = args;
     if ('install' === subcommand) return spawnNodeScript("template-workspace/scripts/bootstrap-agent-skills.mjs", rest, context);
@@ -159,6 +403,8 @@ async function runUltramodernToolingCli(args, workspaceRoot = process.env.ULTRAM
                 });
             case 'mf-types':
                 return runMfTypes(rest, context);
+            case 'migrate-strict-effect':
+                return runMigrateStrictEffect(rest, context);
             case 'public-surface':
                 return spawnNodeScript("templates/workspace-scripts/generate-public-surface-assets.mjs", rest, context);
             case 'cloudflare-proof':

package/dist/cjs/ultramodern-workspace/contracts.cjs

@@ -289,6 +289,7 @@ function createUltramodernConfig(scope, modernVersion, packageSource, apps = [
                 publicSurface: "scripts/generate-public-surface-assets.mts",
                 cloudflareProof: "scripts/proof-cloudflare-version.mts",
                 performanceReadiness: "scripts/ultramodern-performance-readiness.mts",
+                migrateStrictEffect: "scripts/migrate-strict-effect.mts",
                 apiBoundaries: "scripts/check-ultramodern-api-boundaries.mts",
                 skills: "scripts/bootstrap-agent-skills.mts"
             }

package/dist/cjs/ultramodern-workspace/module-federation.cjs

@@ -144,6 +144,8 @@ ${defaultAssetPrefixSource}
 // load remoteEntry.js and exposed chunks from the remote origin, not the host.
 const assetPrefix =
   configuredModernAssetPrefix || configuredUltramodernAssetPrefix || defaultAssetPrefix;
+const buildCacheTarget = cloudflareDeployEnabled ? 'cloudflare' : 'web';
+const buildCacheDirectory = \`node_modules/.cache/rspack-\${appId}-\${buildCacheTarget}\`;
 
 if (
   cloudflareDeployEnabled &&
@@ -190,6 +192,10 @@ ${bffConfig}      ...(cloudflareDeployEnabled
         splitRouteChunks: true,
       },
       performance: {
+        buildCache: {
+          cacheDigest: [appId, buildCacheTarget],
+          cacheDirectory: buildCacheDirectory,
+        },
         rsdoctor: {
           disableClientServer: true,
           enabled: process.env['ULTRAMODERN_RSDOCTOR'] === 'true',

package/dist/cjs/ultramodern-workspace/package-json.cjs

@@ -224,6 +224,7 @@ function createRootPackageJson(scope, packageSource, remotes = [], bridge) {
             'agents:refs:check': "node ./scripts/setup-agent-reference-repos.mts --check",
             'mf:types': "node ./scripts/assert-mf-types.mts",
             'performance:readiness': "node ./scripts/ultramodern-performance-readiness.mts",
+            'migrate:strict-effect': "node ./scripts/migrate-strict-effect.mts",
             'contract:check': "node ./scripts/validate-ultramodern-workspace.mts",
             'api:check': "node ./scripts/check-ultramodern-api-boundaries.mts",
             'i18n:boundaries': "node ./scripts/check-ultramodern-i18n-boundaries.mts",

package/dist/cjs/ultramodern-workspace/versions.cjs

@@ -37,6 +37,8 @@ const CLOUDFLARE_COMPATIBILITY_DATE = '2026-06-02';
 const TAILWIND_VERSION = '4.3.1';
 const TAILWIND_POSTCSS_VERSION = '4.3.1';
 const POSTCSS_VERSION = '8.5.15';
+const EFFECT_VERSION = '4.0.0-beta.89';
+const EFFECT_VITEST_VERSION = '4.0.0-beta.89';
 const EFFECT_TSGO_VERSION = '0.14.6';
 const TYPESCRIPT_STABLE_VERSION = '6.0.3';
 const TYPESCRIPT_NATIVE_PREVIEW_VERSION = '7.0.0-dev.20260624.1';
@@ -60,12 +62,16 @@ const ultramodernWorkspaceVersions = {
     tanstackRouter: TANSTACK_ROUTER_VERSION,
     tanstackRouterCore: TANSTACK_ROUTER_CORE_VERSION,
     moduleFederation: MODULE_FEDERATION_VERSION,
+    effect: EFFECT_VERSION,
+    effectVitest: EFFECT_VITEST_VERSION,
     tailwind: TAILWIND_VERSION,
     tailwindPostcss: TAILWIND_POSTCSS_VERSION
 };
 __webpack_require__.d(__webpack_exports__, {}, {
     CLOUDFLARE_COMPATIBILITY_DATE: CLOUDFLARE_COMPATIBILITY_DATE,
     EFFECT_TSGO_VERSION: EFFECT_TSGO_VERSION,
+    EFFECT_VERSION: EFFECT_VERSION,
+    EFFECT_VITEST_VERSION: EFFECT_VITEST_VERSION,
     I18NEXT_VERSION: I18NEXT_VERSION,
     LEFTHOOK_VERSION: LEFTHOOK_VERSION,
     MODULE_FEDERATION_AGENT_SKILLS_COMMIT: MODULE_FEDERATION_AGENT_SKILLS_COMMIT,
@@ -97,6 +103,8 @@ __webpack_require__.d(__webpack_exports__, {}, {
 });
 exports.CLOUDFLARE_COMPATIBILITY_DATE = __webpack_exports__.CLOUDFLARE_COMPATIBILITY_DATE;
 exports.EFFECT_TSGO_VERSION = __webpack_exports__.EFFECT_TSGO_VERSION;
+exports.EFFECT_VERSION = __webpack_exports__.EFFECT_VERSION;
+exports.EFFECT_VITEST_VERSION = __webpack_exports__.EFFECT_VITEST_VERSION;
 exports.I18NEXT_VERSION = __webpack_exports__.I18NEXT_VERSION;
 exports.LEFTHOOK_VERSION = __webpack_exports__.LEFTHOOK_VERSION;
 exports.MODULE_FEDERATION_AGENT_SKILLS_COMMIT = __webpack_exports__.MODULE_FEDERATION_AGENT_SKILLS_COMMIT;
@@ -128,6 +136,8 @@ exports.ultramodernWorkspaceVersions = __webpack_exports__.ultramodernWorkspaceV
 for(var __rspack_i in __webpack_exports__)if (-1 === [
     "CLOUDFLARE_COMPATIBILITY_DATE",
     "EFFECT_TSGO_VERSION",
+    "EFFECT_VERSION",
+    "EFFECT_VITEST_VERSION",
     "I18NEXT_VERSION",
     "LEFTHOOK_VERSION",
     "MODULE_FEDERATION_AGENT_SKILLS_COMMIT",

package/dist/cjs/ultramodern-workspace/workspace-scripts.cjs

@@ -209,6 +209,7 @@ function writeGeneratedWorkspaceScripts(targetDir, _scope, _enableTailwind, _rem
     writeWorkspaceOwnedMtsScript(targetDir, 'proof-cloudflare-version', createToolWrapperScript('cloudflare-proof'));
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/ultramodern-performance-readiness.config.mjs", createPerformanceReadinessConfigScript());
     writeWorkspaceOwnedMtsScript(targetDir, 'ultramodern-performance-readiness', createToolWrapperScript('performance-readiness'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'migrate-strict-effect', createToolWrapperScript('migrate-strict-effect'));
     writeWorkspaceOwnedMtsScript(targetDir, 'ultramodern-typecheck', createToolWrapperScript('typecheck'));
     writeWorkspaceOwnedMtsScript(targetDir, 'bootstrap-agent-skills', createSkillsToolWrapperScript());
     migrateCopiedWorkspaceScriptToMts(targetDir, 'setup-agent-reference-repos');

package/dist/cjs/ultramodern-workspace/write-workspace.cjs

@@ -175,6 +175,8 @@ function generateUltramodernWorkspace(options) {
         nodeVersion: external_versions_cjs_namespaceObject.NODE_VERSION,
         pnpmVersion: external_versions_cjs_namespaceObject.PNPM_VERSION,
         nodeFetchVersion: external_versions_cjs_namespaceObject.NODE_FETCH_VERSION,
+        effectVersion: external_versions_cjs_namespaceObject.EFFECT_VERSION,
+        effectVitestVersion: external_versions_cjs_namespaceObject.EFFECT_VITEST_VERSION,
         tanstackRouterCoreVersion: external_versions_cjs_namespaceObject.TANSTACK_ROUTER_CORE_VERSION,
         tanstackRouterVersion: external_versions_cjs_namespaceObject.TANSTACK_ROUTER_VERSION,
         typescriptVersion: external_versions_cjs_namespaceObject.TYPESCRIPT_VERSION,