@nocobase/cli 2.1.0-beta.43 → 2.1.0-beta.44.test.1

package/dist/commands/revision/create.js

@@ -0,0 +1,89 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+import { Args, Command, Flags } from '@oclif/core';
+import { executeRawApiRequest } from '../../lib/api-client.js';
+import { ensureCrossEnvConfirmed } from '../../lib/env-guard.js';
+export default class RevisionCreate extends Command {
+    static summary = 'Save the current NocoBase build as a restorable revision';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> "description here"',
+        '<%= config.bin %> <%= command.id %> --env app1 "description here"',
+    ];
+    static args = {
+        description: Args.string({
+            required: true,
+            description: 'Revision description, up to 2000 characters.',
+        }),
+    };
+    static flags = {
+        'api-base-url': Flags.string({
+            description: 'NocoBase API base URL, for example http://localhost:13000/api',
+        }),
+        env: Flags.string({
+            char: 'e',
+            description: 'Environment name',
+        }),
+        role: Flags.string({
+            description: 'Role override, sent as X-Role',
+        }),
+        token: Flags.string({
+            char: 't',
+            description: 'API key override',
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Confirm using --env when it targets a different env than the current env',
+            default: false,
+        }),
+        'json-output': Flags.boolean({
+            char: 'j',
+            description: 'Print raw JSON response',
+            default: true,
+            allowNo: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(RevisionCreate);
+        const description = args.description;
+        if (description.length > 2000) {
+            this.error('Description length should not be over 2000');
+        }
+        const confirmed = await ensureCrossEnvConfirmed({
+            command: this,
+            requestedEnv: flags.env,
+            yes: flags.yes,
+        });
+        if (!confirmed) {
+            return;
+        }
+        const response = await executeRawApiRequest({
+            envName: flags.env,
+            baseUrl: flags['api-base-url'],
+            role: flags.role,
+            token: flags.token,
+            method: 'POST',
+            path: '/app:publishEvent',
+            body: {
+                plugin: 'plugin-version-control',
+                command: 'revision:create',
+                payload: {
+                    description,
+                },
+            },
+        });
+        if (!response.ok) {
+            this.error(`Request failed with status ${response.status}\n${JSON.stringify(response.data, null, 2)}`);
+        }
+        if (flags['json-output']) {
+            this.log(JSON.stringify(response.data, null, 2));
+            return;
+        }
+        this.log(`HTTP ${response.status}`);
+    }
+}

package/dist/locale/en-US.json

@@ -116,8 +116,90 @@
         }
       }
     },
+    "envProxy": {
+      "messages": {
+        "generating": "Generating proxy config for env \"{{envName}}\"...",
+        "printed": "Printed proxy config for env \"{{envName}}\".",
+        "saved": "Saved generated proxy config for env \"{{envName}}\" at {{outputPath}}.",
+        "savedWithAppEntryCreated": "Saved generated proxy config for env \"{{envName}}\" at {{outputPath}}, and created editable app entry config at {{appConfigPath}}.",
+        "savedWithAppEntryMigrated": "Saved generated proxy config for env \"{{envName}}\" at {{outputPath}}, and migrated the app entry config at {{appConfigPath}}.",
+        "savedNginxBundleCreated": "Saved nginx proxy files for env \"{{envName}}\" under {{entryDir}}, and created editable app entry config at {{appConfigPath}}.",
+        "savedNginxBundleUpdated": "Saved nginx proxy files for env \"{{envName}}\" under {{entryDir}}, and refreshed editable app entry config at {{appConfigPath}}.",
+        "savedCaddyBundleCreated": "Saved caddy proxy files for env \"{{envName}}\" under {{entryDir}}, and created editable app entry config at {{appConfigPath}}.",
+        "savedCaddyBundleMigrated": "Saved caddy proxy files for env \"{{envName}}\" under {{entryDir}}, and migrated the app entry config at {{appConfigPath}}.",
+        "savedCaddyBundleUpdated": "Saved caddy proxy files for env \"{{envName}}\" under {{entryDir}}, and refreshed editable app entry config at {{appConfigPath}}.",
+        "failed": "Failed to generate proxy config for env \"{{envName}}\".",
+        "installingProvider": "Installing the shared proxy config into {{provider}}...",
+        "providerInstalled": "Installed the shared proxy config into the {{provider}} main config at {{configPath}}.",
+        "providerAlreadyInstalled": "The shared proxy config is already installed in the {{provider}} main config at {{configPath}}.",
+        "installProviderFailed": "Failed to install the shared proxy config into {{provider}}.",
+        "reloadingProvider": "Validating and reloading {{provider}}...",
+        "providerReloaded": "Validated and reloaded {{provider}}.",
+        "reloadProviderFailed": "Failed to validate and reload {{provider}}."
+      },
+      "errors": {
+        "httpEnvUnsupported": "Can't generate a proxy config for \"{{envName}}\" from this machine because the env only has an API connection.",
+        "sshEnvUnsupported": "Can't generate a proxy config for \"{{envName}}\" yet because SSH envs are not implemented.",
+        "invalidProxyPort": "Invalid proxy entry port \"{{port}}\". Use an integer between 1 and 65535.",
+        "missingAppPort": "Missing appPort for env \"{{envName}}\". Save or update the app port before generating proxy config.",
+        "missingVersion": "Couldn't determine the app version for env \"{{envName}}\". Run `nb env update {{envName}}` and try again.",
+        "appEntryMissingInclude": "The editable app entry config at {{appConfigPath}} does not reference {{generatedConfigPath}}. Add the managed generated-config reference back into the editable app entry and rerun the command.",
+        "nginxOutputUnsupported": "The nginx provider does not support `--output`. It writes `app.conf`, `public/index-v1.html`, `public/index-v2.html`, and `nocobase.conf` into `~/.nocobase/proxy/nginx/<env>/`.",
+        "caddyOutputUnsupported": "The caddy provider does not support `--output`. It writes `app.caddy`, `generated.caddy`, `public/index-v1.html`, `public/index-v2.html`, and `nocobase.caddy` into `~/.nocobase/proxy/caddy/<env>/`.",
+        "nginxAppEntryMissingManagedBlock": "The editable nginx app entry config at {{appConfigPath}} does not contain the NocoBase managed block. Restore the managed block or delete the file and rerun `nb env proxy`."
+      }
+    },
     "shared": {
-      "missingCommand": "Couldn't run `{{action}}` because the {{displayName}} executable could not be found. Install {{displayName}} or update `nb config set {{configKey}} <path>` and try again."
+      "missingCommand": "Couldn't run `{{action}}` because the {{displayName}} executable could not be found. Install {{displayName}} or update `nb config set {{configKey}} <path>` and try again.",
+      "targetEnv": "Using env \"{{envName}}\".",
+      "crossEnv": {
+        "prompt": "Current env is \"{{currentEnv}}\", but this command targets \"{{requestedEnv}}\" via --env. Continue without switching the current env?",
+        "refusal": "Refusing to run against env \"{{requestedEnv}}\" because the current env is \"{{currentEnv}}\" and interactive confirmation is unavailable in the current agent session.\n\nFor safety, the agent will not switch envs automatically and will not add --yes on your behalf.\n\nTo continue:\n- run `nb env use {{requestedEnv}}` yourself and then re-run the command, or\n- re-run the same command with `--env {{requestedEnv}} --yes` to confirm this one-off cross-env operation."
+      }
+    },
+    "license": {
+      "activate": {
+        "interactive": {
+          "notice": {
+            "hostnameLabel": "❯ Hostname",
+            "instanceIdLabel": "❯ Instance ID",
+            "copyHintWithHostname": "Copy this hostname and instance ID when checking or activating the license key.",
+            "copyHintWithoutHostname": "Copy this instance ID when checking or activating the license key."
+          },
+          "prompts": {
+            "provideMethod": {
+              "message": "How do you want to provide the license key?",
+              "keyOption": "Paste the license key",
+              "fileOption": "Read the key from a file"
+            },
+            "key": {
+              "message": "License key",
+              "transformer": "Entered {{count}} chars",
+              "required": "License key is required."
+            },
+            "keyFile": {
+              "message": "Path to the license key file",
+              "required": "License key file path is required."
+            }
+          }
+        },
+        "errors": {
+          "provideKeyOrKeyFile": "Provide --key or --key-file to continue.",
+          "emptyInput": "License key input was empty.",
+          "activationFailed": "Failed to activate the license for env \"{{envName}}\": {{reason}}.",
+          "reasons": {
+            "keyStatus": "license key is {{status}}",
+            "envMismatch": "license key does not match the current instance environment",
+            "domainMismatch": "license key does not match the current app domain",
+            "licenseStatus": "license status is {{status}}",
+            "validationFailed": "license validation failed"
+          }
+        },
+        "messages": {
+          "activated": "Activated the license for env \"{{envName}}\".",
+          "savedLicenseKey": "Saved license key at {{licenseKeyPath}}"
+        }
+      }
     },
     "download": {
       "failures": {
@@ -236,9 +318,9 @@
         "lang": {
           "message": "Which language would you like to use?"
         },
-        "appRootPath": {
-          "message": "Where should this app be stored?",
-          "placeholder": "./<env>/source/"
+        "appPath": {
+          "message": "Where should this app be stored? (relative to {{root}})",
+          "placeholder": "./<env>/"
         },
         "appPort": {
           "message": "Which port should this app use?",
@@ -308,7 +390,7 @@
         "envExists": "Env \"{{envName}}\" already exists. Choose another env name."
       },
       "messages": {
-        "title": "Set Up NocoBase for Coding Agents",
+        "title": "Set up NocoBase for coding agents",
         "appNameRequiredWhenSkipped": "Env name is required when prompts are skipped.",
         "appNameEnvHelp": "Use `nb init --yes --env <envName>` to continue.",
         "resumeEnvRequired": "Env name is required when resuming setup.",
@@ -325,10 +407,14 @@
           "message": "What should this environment use for `--env`?",
           "placeholder": "local"
         },
-        "hasNocobase": {
-          "message": "Do you already have a NocoBase application?",
-          "noLabel": "I don't have a NocoBase application yet",
-          "yesLabel": "I already have a NocoBase application"
+        "setupMode": {
+          "message": "How would you like to set up this environment?",
+          "installNewLabel": "Install a new app",
+          "installNewHint": "Install a brand-new app from scratch. Best for first-time setup, evaluation, or a fresh local environment.",
+          "manageLocalLabel": "Manage an app already on this machine",
+          "manageLocalHint": "Bring an app on this machine under nb management so install, upgrade, and startup can be handled in one place. During takeover, nb will re-download the app source or image and upgrade the app; storage will be created automatically when needed.",
+          "connectRemoteLabel": "Connect a remote app",
+          "connectRemoteHint": "Save only the remote app connection. Nothing will be installed or taken over on this machine."
         },
         "installSkills": {
           "message": "Install NocoBase AI coding skills (nocobase/skills)?"
@@ -342,24 +428,24 @@
         }
       },
       "webUi": {
-        "pageTitle": "Set Up NocoBase for Coding Agents",
-        "documentHeading": "Set Up NocoBase for Coding Agents",
-        "documentHint": "Connect an existing NocoBase app, or install a new one, so coding agents can access and work with NocoBase.",
+        "pageTitle": "Set up NocoBase for coding agents",
+        "documentHeading": "Set up NocoBase for coding agents",
+        "documentHint": "Install a new app, manage one that already exists on this machine, or connect a remote app so coding agents can access and work with NocoBase.",
         "gettingStarted": {
           "title": "Getting started",
-          "description": "Choose whether to connect an existing app or install a new one."
+          "description": "Choose whether to install a new app, manage a local app, or connect a remote app."
         },
         "connectExistingApp": {
-          "title": "Connect an existing app",
-          "description": "Save your app connection."
+          "title": "Remote connection",
+          "description": "Save your remote app connection."
         },
         "createNewApp": {
-          "title": "Install a new app",
-          "description": "Set app basics and install options."
+          "title": "App environment",
+          "description": "Set the app basics, storage location, and runtime port."
         },
         "downloadAppFiles": {
-          "title": "Download app files",
-          "description": "Choose how to get the app files."
+          "title": "App source and version",
+          "description": "Choose how to get the app and which source and version to use."
         },
         "configureDatabase": {
           "title": "Configure the database",

package/dist/locale/zh-CN.json

@@ -116,8 +116,90 @@
         }
       }
     },
+    "envProxy": {
+      "messages": {
+        "generating": "正在为 env \"{{envName}}\" 生成代理配置...",
+        "printed": "已输出 env \"{{envName}}\" 的代理配置。",
+        "saved": "已将 env \"{{envName}}\" 的生成代理配置保存到 {{outputPath}}。",
+        "savedWithAppEntryCreated": "已将 env \"{{envName}}\" 的生成代理配置保存到 {{outputPath}}，并创建可编辑的入口配置 {{appConfigPath}}。",
+        "savedWithAppEntryMigrated": "已将 env \"{{envName}}\" 的生成代理配置保存到 {{outputPath}}，并将入口配置迁移为 {{appConfigPath}}。",
+        "savedNginxBundleCreated": "已将 env \"{{envName}}\" 的 nginx 代理文件保存到 {{entryDir}}，并创建可编辑的入口配置 {{appConfigPath}}。",
+        "savedNginxBundleUpdated": "已将 env \"{{envName}}\" 的 nginx 代理文件保存到 {{entryDir}}，并刷新可编辑的入口配置 {{appConfigPath}}。",
+        "savedCaddyBundleCreated": "已将 env \"{{envName}}\" 的 caddy 代理文件保存到 {{entryDir}}，并创建可编辑的入口配置 {{appConfigPath}}。",
+        "savedCaddyBundleMigrated": "已将 env \"{{envName}}\" 的 caddy 代理文件保存到 {{entryDir}}，并将入口配置迁移为 {{appConfigPath}}。",
+        "savedCaddyBundleUpdated": "已将 env \"{{envName}}\" 的 caddy 代理文件保存到 {{entryDir}}，并刷新可编辑的入口配置 {{appConfigPath}}。",
+        "failed": "为 env \"{{envName}}\" 生成代理配置失败。",
+        "installingProvider": "正在将共享代理配置安装到 {{provider}}...",
+        "providerInstalled": "已将共享代理配置安装到 {{provider}} 主配置 {{configPath}}。",
+        "providerAlreadyInstalled": "共享代理配置已存在于 {{provider}} 主配置 {{configPath}} 中。",
+        "installProviderFailed": "将共享代理配置安装到 {{provider}} 失败。",
+        "reloadingProvider": "正在校验并重载 {{provider}}...",
+        "providerReloaded": "已校验并重载 {{provider}}。",
+        "reloadProviderFailed": "校验并重载 {{provider}} 失败。"
+      },
+      "errors": {
+        "httpEnvUnsupported": "无法在当前机器上为 \"{{envName}}\" 生成代理配置，因为这个 env 只有 API 连接。",
+        "sshEnvUnsupported": "暂时无法为 \"{{envName}}\" 生成代理配置，因为 SSH env 还没有实现。",
+        "invalidProxyPort": "代理入口端口 \"{{port}}\" 无效。请使用 1 到 65535 之间的整数。",
+        "missingAppPort": "env \"{{envName}}\" 缺少 appPort。请先保存或更新应用端口后再生成代理配置。",
+        "missingVersion": "无法确定 env \"{{envName}}\" 的应用版本。请先运行 `nb env update {{envName}}`，然后再试一次。",
+        "appEntryMissingInclude": "可编辑入口配置 {{appConfigPath}} 没有引用 {{generatedConfigPath}}。请把托管的 generated 配置引用补回入口配置中，然后重新执行该命令。",
+        "nginxOutputUnsupported": "nginx provider 不支持 `--output`。它会把 `app.conf`、`public/index-v1.html`、`public/index-v2.html` 和 `nocobase.conf` 写入 `~/.nocobase/proxy/nginx/<env>/`。",
+        "caddyOutputUnsupported": "caddy provider 不支持 `--output`。它会把 `app.caddy`、`generated.caddy`、`public/index-v1.html`、`public/index-v2.html` 和 `nocobase.caddy` 写入 `~/.nocobase/proxy/caddy/<env>/`。",
+        "nginxAppEntryMissingManagedBlock": "可编辑的 nginx 入口配置 {{appConfigPath}} 不包含 NocoBase 的托管区块。请恢复这个托管区块，或删除该文件后重新执行 `nb env proxy`。"
+      }
+    },
     "shared": {
-      "missingCommand": "无法执行 `{{action}}`，因为找不到 {{displayName}} 可执行文件。请先安装 {{displayName}}，或更新 `nb config set {{configKey}} <path>` 后重试。"
+      "missingCommand": "无法执行 `{{action}}`，因为找不到 {{displayName}} 可执行文件。请先安装 {{displayName}}，或更新 `nb config set {{configKey}} <path>` 后重试。",
+      "targetEnv": "正在使用 env \"{{envName}}\"。",
+      "crossEnv": {
+        "prompt": "当前 env 是 \"{{currentEnv}}\"，但该命令通过 --env 指向了 \"{{requestedEnv}}\"。要在不切换当前 env 的情况下继续吗？",
+        "refusal": "拒绝对 env \"{{requestedEnv}}\" 执行该命令，因为当前 env 是 \"{{currentEnv}}\"，且当前 agent 会话无法进行交互确认。\n\n出于安全考虑，agent 不会自动切换 env，也不会替你自动补上 --yes。\n\n如果要继续：\n- 请先自行执行 `nb env use {{requestedEnv}}`，然后重新运行该命令，或\n- 使用相同命令并追加 `--env {{requestedEnv}} --yes`，以确认这是一次性的跨 env 操作。"
+      }
+    },
+    "license": {
+      "activate": {
+        "interactive": {
+          "notice": {
+            "hostnameLabel": "❯ 主机名",
+            "instanceIdLabel": "❯ 实例 ID",
+            "copyHintWithHostname": "校验或激活 license key 时，请复制这个主机名和实例 ID。",
+            "copyHintWithoutHostname": "校验或激活 license key 时，请复制这个实例 ID。"
+          },
+          "prompts": {
+            "provideMethod": {
+              "message": "你想通过哪种方式提供 license key？",
+              "keyOption": "直接粘贴 license key",
+              "fileOption": "从文件读取 key"
+            },
+            "key": {
+              "message": "License Key",
+              "transformer": "已输入 {{count}} 个字符",
+              "required": "必须提供 license key。"
+            },
+            "keyFile": {
+              "message": "license key 文件路径",
+              "required": "必须提供 license key 文件路径。"
+            }
+          }
+        },
+        "errors": {
+          "provideKeyOrKeyFile": "请通过 --key 或 --key-file 继续。",
+          "emptyInput": "license key 输入为空。",
+          "activationFailed": "为 env \"{{envName}}\" 激活 license 失败：{{reason}}。",
+          "reasons": {
+            "keyStatus": "license key 状态为 {{status}}",
+            "envMismatch": "license key 与当前实例环境不匹配",
+            "domainMismatch": "license key 与当前应用域名不匹配",
+            "licenseStatus": "license 状态为 {{status}}",
+            "validationFailed": "license 校验失败"
+          }
+        },
+        "messages": {
+          "activated": "已为 env \"{{envName}}\" 激活 license。",
+          "savedLicenseKey": "license key 已保存到 {{licenseKeyPath}}"
+        }
+      }
     },
     "download": {
       "failures": {
@@ -236,9 +318,9 @@
         "lang": {
           "message": "你想使用哪种语言？"
         },
-        "appRootPath": {
-          "message": "应用代码要放到哪里？",
-          "placeholder": "./<env>/source/"
+        "appPath": {
+          "message": "应用要放到哪里？（相对路径基于 {{root}}）",
+          "placeholder": "./<env>/"
         },
         "appPort": {
           "message": "应用要使用哪个端口？",
@@ -325,10 +407,14 @@
           "message": "这个环境要使用什么 `--env` 标识？",
           "placeholder": "local"
         },
-        "hasNocobase": {
-          "message": "你是否已经有一个 NocoBase 应用？",
-          "noLabel": "还没有 NocoBase 应用",
-          "yesLabel": "已经有 NocoBase 应用"
+        "setupMode": {
+          "message": "你想用哪种方式配置这个环境？",
+          "installNewLabel": "新安装",
+          "installNewHint": "从零安装一个新的应用，适合首次部署、试用或新建本地开发环境。",
+          "manageLocalLabel": "本机接管",
+          "manageLocalHint": "将本机已有应用纳入 nb 管理，后续可统一执行安装、升级和启动等操作。接管过程中会重新下载应用代码或镜像并升级应用，storage 会在需要时自动创建。",
+          "connectRemoteLabel": "远程连接",
+          "connectRemoteHint": "只保存远程应用的连接信息，不在本机安装或接管应用。"
         },
         "installSkills": {
           "message": "是否安装 NocoBase AI coding skills（nocobase/skills）？"
@@ -344,22 +430,22 @@
       "webUi": {
         "pageTitle": "配置供 Coding Agents 使用的 NocoBase",
         "documentHeading": "配置供 Coding Agents 使用的 NocoBase",
-        "documentHint": "连接已有的 NocoBase 应用，或安装一个新的应用，让 Coding Agents 可以在当前工作区中访问和操作 NocoBase。",
+        "documentHint": "安装一个新的应用、接管本机已有应用，或连接远程应用，让 Coding Agents 可以在当前工作区中访问和操作 NocoBase。",
         "gettingStarted": {
           "title": "开始设置",
-          "description": "选择连接已有应用，或安装一个新应用。"
+          "description": "选择新安装、本机接管，或远程连接。"
         },
         "connectExistingApp": {
-          "title": "连接已有应用",
-          "description": "保存现有应用连接。"
+          "title": "远程连接",
+          "description": "保存远程应用连接。"
         },
         "createNewApp": {
-          "title": "安装新应用",
-          "description": "设置应用基础信息和安装选项。"
+          "title": "应用环境信息",
+          "description": "设置应用的基础信息、存储位置和运行端口。"
         },
         "downloadAppFiles": {
-          "title": "下载应用文件",
-          "description": "选择获取应用文件的方式。"
+          "title": "应用来源和版本",
+          "description": "选择应用的获取方式，以及要使用的来源和版本。"
         },
         "configureDatabase": {
           "title": "配置数据库",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocobase/cli",
-  "version": "2.1.0-beta.43",
+  "version": "2.1.0-beta.44.test.1",
   "description": "NocoBase Command Line Tool",
   "type": "module",
   "main": "dist/generated/command-registry.js",
@@ -12,11 +12,6 @@
   "keywords": [],
   "author": "",
   "license": "Apache-2.0",
-  "files": [
-    "bin",
-    "dist",
-    "nocobase-ctl.config.json"
-  ],
   "bin": {
     "nb": "./bin/run.js"
   },
@@ -73,6 +68,9 @@
       "skills": {
         "description": "Inspect or synchronize NocoBase AI coding skills for the current workspace."
       },
+      "revision": {
+        "description": "Manage restorable revisions during NocoBase app building."
+      },
       "examples": {
         "description": "Internal example commands for prompt and UI experiments.",
         "hidden": true
@@ -139,6 +137,5 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nocobase/nocobase.git"
-  },
-  "gitHead": "6d7750e2373bf2451d246de88cc1f62491685e18"
+  }
 }

package/scripts/build.mjs

@@ -0,0 +1,34 @@
+import { copyFileSync, mkdirSync, readdirSync, rmSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const scriptsDir = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(scriptsDir, '..');
+const distDir = path.join(packageRoot, 'dist');
+const srcLocaleDir = path.join(packageRoot, 'src', 'locale');
+const distLocaleDir = path.join(distDir, 'locale');
+const tscBin = require.resolve('typescript/bin/tsc');
+
+rmSync(distDir, { recursive: true, force: true });
+
+const compile = spawnSync(process.execPath, [tscBin, '-p', path.join(packageRoot, 'tsconfig.json')], {
+  cwd: packageRoot,
+  stdio: 'inherit',
+});
+
+if (compile.status !== 0) {
+  process.exit(compile.status ?? 1);
+}
+
+mkdirSync(distLocaleDir, { recursive: true });
+
+for (const entry of readdirSync(srcLocaleDir, { withFileTypes: true })) {
+  if (!entry.isFile() || !entry.name.endsWith('.json')) {
+    continue;
+  }
+
+  copyFileSync(path.join(srcLocaleDir, entry.name), path.join(distLocaleDir, entry.name));
+}

package/scripts/clean.mjs

@@ -0,0 +1,9 @@
+import { rmSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const scriptsDir = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(scriptsDir, '..');
+const distDir = path.join(packageRoot, 'dist');
+
+rmSync(distDir, { recursive: true, force: true });

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rewriteRelativeImportExtensions": true,
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": false,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "types": ["node"],
+    "skipLibCheck": true,
+    "strict": false
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/__tests__/**"]
+}

package/LICENSE.txt

@@ -1,107 +0,0 @@
-Updated Date: February 24, 2026
-
-NocoBase License Agreement
-
-NOCOBASE PTE. LTD.，a Singaporean Exempt Private Company Limited by Shares with its principal place of business located at 112 ROBINSON ROAD, #03-01, SINGAPORE ("The Company") https://www.nocobase.com/ issues this License Agreement ("Agreement") to you. You, as an individual or a company ("The User"), will be deemed to voluntarily accept all terms of this Agreement by using NocoBase (including but not limited to obtaining NocoBase source code or installation package in any form, installing and using NocoBase, purchasing NocoBase commercial license and services, purchasing NocoBase commercial plugins). If the User does not agree to any term of this Agreement, or cannot accurately understand our interpretation of the relevant terms, please stop using it immediately.
-
-This Agreement applies to any use, quotation, contract, invoice, and all software delivered by the Company. The User and the Company or NocoBase's agents can no longer sign a separate license agreement for the sale and delivery of the software.
-
-The Company reserves the right to formulate and modify this Agreement from time to time as needed. If there are changes, the Company will announce them in the form of website announcements, without further individual notification. The changed Agreement will automatically take effect once it is announced, becoming part of this Agreement.
-
-==============
-1. Definitions
-==============
-
-1.1 "Software" refers to the NocoBase kernel and plugins placed in the same code repository as the kernel, including their source code, installation packages, images, and all their modifications, updates, and upgrades.
-
-1.2 "Community Edition" refers to the free version of the Software provided to the User through public channels.
-
-1.3 "Commercial Edition" refers to the paid version of the Software purchased by the User from the Company or its agents, downloaded through exclusive channels, and includes additional benefits. It consists of three versions: Standard Edition, Professional Edition, and Enterprise Edition.
-
-1.4 "Upper Layer Application" refers to a specific business use case application serving internal or external customers of the User, developed based on Software and Commercial Plugins, such as ERP/CRM.
-
-1.5 "Customer" refers to the clients who purchase the User's Upper Layer Application.
-
-1.6 "Third-Party Open Source Software" refers to open source software provided with Software and Commercial Plugins. They are licensed through various published open source software licenses or copyright notices accompanying such software.
-
-===================================
-2. Intellectual Property Protection
-===================================
-
-Except for Third-Party Open Source Software, the Company owns all copyrights, trademark rights, patent rights, trade secrets, and other intellectual property rights of the Software, and has registered and protected them in relevant countries and regions according to the "Paris Convention" or "TRIPS Agreement", ensuring that the intellectual property rights of the Software and Commercial Plugins are internationally recognized and protected.
-
-=============
-3. Disclaimer
-=============
-
-3.1 The User shall not use the Software and Commercial Plugins to engage in activities that contravene applicable laws and regulations or offend against public order or religious prohibitions. All legal liabilities and consequences arising from the User’s use shall be borne by the User.
-
-3.2 The Company shall not be liable for any direct, indirect, special, incidental, or consequential damages (including but not limited to loss of profits, business interruption, data loss, or business information disclosure) caused by the User's use of the Software and Commercial Plugins, even if it has been previously informed of the possibility of such damages.
-
-===============
-4. License Type
-===============
-
-4.1 This Agreement serves as the unified license agreement for NocoBase Software, applying to both the Community Edition and the Commercial Editions.
-
-4.2 This Agreement incorporates and references the full text of the Apache License, Version 2.0 ("Apache-2.0", available at: https://www.apache.org/licenses/LICENSE-2.0 ). Users must comply with the Apache-2.0 License as well as the supplementary terms set forth in this Agreement. In case of any inconsistency between Apache-2.0 and this Agreement, the supplementary terms of this Agreement shall prevail.
-
-================================================
-5. Rights and Obligations of Open Source License
-================================================
-
-5.1 The Software can be used for commercial purposes.
-
-5.2 It is not allowed to remove or change the brand, name, link, version number, license, and other information about NocoBase on the Software interface, except for the main LOGO in the upper left corner of the page.
-
-5.3 It is not allowed to remove or change all intellectual property statements about NocoBase in the code.
-
-5.4 It is not allowed to provide to the public any form of no-code, zero-code, low-code, AI platform SaaS/PaaS products using the original or modified Software.
-
-===============================
-6. Rights of Commercial License
-===============================
-
-6.1 Obtain a permanent commercial license of the Software.
-
-6.2 Get software upgrades and exclusive technical support during the upgrade validity period.
-
-6.3 The licensed Software can be used for commercial purposes with no restrictions on the number of applications and users.
-
-6.4 Can remove or change the brand, name, link, version number, license, and other information about NocoBase on the Software interface.
-
-6.5 The User holding a Professional or Enterprise Edition License can sell Upper Layer Application to its Customers.
-
-6.6 If there are other agreements in the contract for the above rights, the contract agreement shall prevail.
-
-====================================
-7. Obligations of Commercial License
-====================================
-
-7.1 It is not allowed to remove or change all intellectual property statements about NocoBase in the code.
-
-7.2 It is not allowed to sell, transfer, lease, share, gift, or distribute the Commercial License.
-
-7.3 It is not allowed to sell, transfer, lease, share, or distribute any form of no-code, zero-code, low-code, AI platform, or developer tools developed based on Software.
-
-7.4 It is not allowed to provide any form of no-code, zero-code, low-code, AI platform SaaS/PaaS products to the public using the original or modified Software.
-
-7.5 It is not allowed for the User holding a Standard Edition license to sell Upper Layer Application to Customers without a Commercial license.
-
-7.6 It is not allowed for the User holding a Professional or Enterprise Edition license to sell Upper Layer Application to Customers without a Commercial license with access to further development and configuration.
-
-7.7 If there is a violation of the above obligations or the terms of this Agreement, the rights owned by the User will be immediately terminated, the paid fees will not be refunded, and the Company reserves the right to pursue the User's legal responsibility.
-
-7.8 If there are other agreements in the contract for the above obligations, the contract agreement shall prevail.
-
-=============================================================
-8.  Legal Jurisdiction, Interpretation, and Dispute Resolution
-=============================================================
-
-8.1 Except for Mainland China, the interpretation, application, and all matters related to this agreement are subject to the jurisdiction of Singapore law.
-
-8.2 Any dispute related to this Agreement should first be resolved through friendly negotiation. If the negotiation fails to resolve the dispute, the dispute should be submitted to the International Chamber of Commerce (ICC) for arbitration. The arbitration venue should be Singapore, conducted in English.
-
-8.3 All terms and conditions of this Agreement shall be deemed enforceable to the maximum extent permitted by applicable law. If any term of this Agreement is deemed invalid by any applicable law, the invalidity of that term does not affect the validity of any other term of this Agreement, and it should be deemed that the invalid term has been modified as much as possible to make it valid and enforceable, or if the term cannot be modified, it should be deemed to have been deleted from this Agreement.
-
-8.4 The arbitration award is final, binding on both parties, and can be enforced in any court with jurisdiction.