@nocobase/plugin-data-source-manager 2.1.0-beta.32 → 2.1.0-beta.33

package/dist/externalVersion.js

@@ -8,27 +8,27 @@
  */
 
 module.exports = {
-  "@nocobase/client": "2.1.0-beta.32",
+  "@nocobase/client": "2.1.0-beta.33",
   "react": "18.2.0",
-  "@nocobase/plugin-acl": "2.1.0-beta.32",
-  "@nocobase/utils": "2.1.0-beta.32",
-  "@nocobase/ai": "2.1.0-beta.32",
-  "@nocobase/server": "2.1.0-beta.32",
-  "@nocobase/data-source-manager": "2.1.0-beta.32",
+  "@nocobase/plugin-acl": "2.1.0-beta.33",
+  "@nocobase/utils": "2.1.0-beta.33",
+  "@nocobase/ai": "2.1.0-beta.33",
+  "@nocobase/server": "2.1.0-beta.33",
+  "@nocobase/data-source-manager": "2.1.0-beta.33",
   "lodash": "4.18.1",
-  "@nocobase/acl": "2.1.0-beta.32",
-  "@nocobase/database": "2.1.0-beta.32",
+  "@nocobase/acl": "2.1.0-beta.33",
+  "@nocobase/database": "2.1.0-beta.33",
   "@ant-design/icons": "5.6.1",
   "antd": "5.24.2",
   "react-router-dom": "6.30.1",
-  "@nocobase/flow-engine": "2.1.0-beta.32",
+  "@nocobase/flow-engine": "2.1.0-beta.33",
   "@formily/shared": "2.3.7",
   "@formily/react": "2.3.7",
   "react-i18next": "11.18.6",
   "@emotion/css": "11.13.0",
-  "@nocobase/actions": "2.1.0-beta.32",
+  "@nocobase/actions": "2.1.0-beta.33",
   "sequelize": "6.35.2",
-  "@nocobase/test": "2.1.0-beta.32",
+  "@nocobase/test": "2.1.0-beta.33",
   "@formily/antd-v5": "1.2.3",
   "@formily/core": "2.3.7",
   "@formily/reactive": "2.3.7",

package/dist/node_modules/zod/package.json

@@ -1 +1 @@
-{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-05-13T05:25:04.478Z"}
+{"name":"zod","version":"4.3.5","type":"module","license":"MIT","author":"Colin McDonnell <zod@colinhacks.com>","description":"TypeScript-first schema declaration and validation library with static type inference","homepage":"https://zod.dev","llms":"https://zod.dev/llms.txt","llmsFull":"https://zod.dev/llms-full.txt","mcpServer":"https://mcp.inkeep.com/zod/mcp","funding":"https://github.com/sponsors/colinhacks","sideEffects":false,"files":["src","**/*.js","**/*.mjs","**/*.cjs","**/*.d.ts","**/*.d.mts","**/*.d.cts","**/package.json"],"keywords":["typescript","schema","validation","type","inference"],"main":"./index.cjs","types":"./index.d.cts","module":"./index.js","zshy":{"exports":{"./package.json":"./package.json",".":"./src/index.ts","./mini":"./src/mini/index.ts","./locales":"./src/locales/index.ts","./v3":"./src/v3/index.ts","./v4":"./src/v4/index.ts","./v4-mini":"./src/v4-mini/index.ts","./v4/mini":"./src/v4/mini/index.ts","./v4/core":"./src/v4/core/index.ts","./v4/locales":"./src/v4/locales/index.ts","./v4/locales/*":"./src/v4/locales/*"},"conditions":{"@zod/source":"src"}},"exports":{"./package.json":"./package.json",".":{"@zod/source":"./src/index.ts","types":"./index.d.cts","import":"./index.js","require":"./index.cjs"},"./mini":{"@zod/source":"./src/mini/index.ts","types":"./mini/index.d.cts","import":"./mini/index.js","require":"./mini/index.cjs"},"./locales":{"@zod/source":"./src/locales/index.ts","types":"./locales/index.d.cts","import":"./locales/index.js","require":"./locales/index.cjs"},"./v3":{"@zod/source":"./src/v3/index.ts","types":"./v3/index.d.cts","import":"./v3/index.js","require":"./v3/index.cjs"},"./v4":{"@zod/source":"./src/v4/index.ts","types":"./v4/index.d.cts","import":"./v4/index.js","require":"./v4/index.cjs"},"./v4-mini":{"@zod/source":"./src/v4-mini/index.ts","types":"./v4-mini/index.d.cts","import":"./v4-mini/index.js","require":"./v4-mini/index.cjs"},"./v4/mini":{"@zod/source":"./src/v4/mini/index.ts","types":"./v4/mini/index.d.cts","import":"./v4/mini/index.js","require":"./v4/mini/index.cjs"},"./v4/core":{"@zod/source":"./src/v4/core/index.ts","types":"./v4/core/index.d.cts","import":"./v4/core/index.js","require":"./v4/core/index.cjs"},"./v4/locales":{"@zod/source":"./src/v4/locales/index.ts","types":"./v4/locales/index.d.cts","import":"./v4/locales/index.js","require":"./v4/locales/index.cjs"},"./v4/locales/*":{"@zod/source":"./src/v4/locales/*","types":"./v4/locales/*","import":"./v4/locales/*","require":"./v4/locales/*"}},"repository":{"type":"git","url":"git+https://github.com/colinhacks/zod.git"},"bugs":{"url":"https://github.com/colinhacks/zod/issues"},"support":{"backing":{"npm-funding":true}},"scripts":{"clean":"git clean -xdf . -e node_modules","build":"zshy --project tsconfig.build.json","postbuild":"tsx ../../scripts/write-stub-package-jsons.ts && pnpm biome check --write .","test:watch":"pnpm vitest","test":"pnpm vitest run","prepublishOnly":"tsx ../../scripts/check-versions.ts"},"_lastModified":"2026-05-15T15:54:13.068Z"}

package/dist/server/resourcers/data-sources-collections-fields.d.ts

@@ -13,6 +13,7 @@ declare const _default: {
         get(ctx: any, next: any): Promise<void>;
         update(ctx: any, next: any): Promise<void>;
         create(ctx: any, next: any): Promise<void>;
+        apply(ctx: any, next: any): Promise<void>;
         destroy(ctx: any, next: any): Promise<void>;
     };
 };

package/dist/server/resourcers/data-sources-collections-fields.js

@@ -40,6 +40,7 @@ __export(data_sources_collections_fields_exports, {
 });
 module.exports = __toCommonJS(data_sources_collections_fields_exports);
 var import_lodash = __toESM(require("lodash"));
+var import_external_field_apply = require("../services/external-field-apply");
 var data_sources_collections_fields_default = {
   name: "dataSourcesCollections.fields",
   actions: {
@@ -130,6 +131,14 @@ var data_sources_collections_fields_default = {
       ctx.body = fieldRecord.toJSON();
       await next();
     },
+    async apply(ctx, next) {
+      const rawValues = ctx.action.params.values || ctx.request.body || {};
+      const defaults = (0, import_external_field_apply.parseCollectionNameWithDataSourceKey)(ctx.action.params.associatedIndex);
+      ctx.body = {
+        data: await (0, import_external_field_apply.applyExternalFieldDefinition)(ctx, rawValues, defaults)
+      };
+      await next();
+    },
     async destroy(ctx, next) {
       const { associatedIndex: collectionNameWithDataSourceKey, filterByTk: name } = ctx.action.params;
       const [dataSourceKey, collectionName] = collectionNameWithDataSourceKey.split(".");

package/dist/server/services/external-field-apply.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+export declare function parseCollectionNameWithDataSourceKey(value?: string): {
+    dataSourceKey?: undefined;
+    collectionName?: undefined;
+} | {
+    dataSourceKey: string;
+    collectionName: string;
+};
+export declare function normalizeExternalFieldInput(rawValues: any, defaults: {
+    dataSourceKey?: string;
+    collectionName?: string;
+}): any;
+export declare function applyExternalFieldDefinition(ctx: any, rawValues: any, defaults?: {
+    dataSourceKey?: string;
+    collectionName?: string;
+}): Promise<any>;

package/dist/server/services/external-field-apply.js

@@ -0,0 +1,208 @@
+/**
+ * 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.
+ */
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var external_field_apply_exports = {};
+__export(external_field_apply_exports, {
+  applyExternalFieldDefinition: () => applyExternalFieldDefinition,
+  normalizeExternalFieldInput: () => normalizeExternalFieldInput,
+  parseCollectionNameWithDataSourceKey: () => parseCollectionNameWithDataSourceKey
+});
+module.exports = __toCommonJS(external_field_apply_exports);
+var import_lodash = __toESM(require("lodash"));
+var import_sequelize = require("sequelize");
+const RELATION_INTERFACE_TYPE_MAP = {
+  m2o: "belongsTo",
+  obo: "belongsTo",
+  o2m: "hasMany",
+  oho: "hasOne",
+  m2m: "belongsToMany"
+};
+const RELATION_TYPES = /* @__PURE__ */ new Set(["belongsTo", "hasMany", "hasOne", "belongsToMany"]);
+function parseCollectionNameWithDataSourceKey(value) {
+  if (!value) {
+    return {};
+  }
+  const separatorIndex = value.indexOf(".");
+  if (separatorIndex === -1) {
+    return {};
+  }
+  return {
+    dataSourceKey: value.slice(0, separatorIndex),
+    collectionName: value.slice(separatorIndex + 1)
+  };
+}
+function mergeSettings(input = {}) {
+  const { settings, ...rest } = input;
+  return {
+    ...settings || {},
+    ...rest
+  };
+}
+function buildRelationKeyName(name, key = "id") {
+  return import_sequelize.Utils.camelize([import_sequelize.Utils.singularize(name || ""), key].join("_"));
+}
+function buildThroughName(source, target) {
+  return import_sequelize.Utils.camelize(
+    [source, target].filter(Boolean).map((name) => String(name).toLowerCase()).sort().join("_")
+  );
+}
+function normalizeExternalFieldInput(rawValues, defaults) {
+  var _a;
+  const values = mergeSettings(rawValues);
+  const dataSourceKey = values.dataSourceKey || defaults.dataSourceKey;
+  const collectionName = values.collectionName || defaults.collectionName;
+  if (!dataSourceKey) {
+    throw new Error("dataSourcesCollections.fields:apply requires dataSourceKey");
+  }
+  if (!collectionName) {
+    throw new Error("dataSourcesCollections.fields:apply requires collectionName");
+  }
+  if (!values.name) {
+    throw new Error("dataSourcesCollections.fields:apply requires name");
+  }
+  const interfaceType = values.interface;
+  const type = values.type || RELATION_INTERFACE_TYPE_MAP[interfaceType];
+  const normalized = {
+    ...values,
+    dataSourceKey,
+    collectionName,
+    type
+  };
+  if (RELATION_TYPES.has(normalized.type)) {
+    if (!normalized.target) {
+      throw new Error(`Relation field ${normalized.name} requires target`);
+    }
+    normalized.interface = normalized.interface || {
+      belongsTo: "m2o",
+      hasMany: "o2m",
+      hasOne: "oho",
+      belongsToMany: "m2m"
+    }[normalized.type];
+    normalized.sourceKey = normalized.sourceKey || "id";
+    normalized.targetKey = normalized.targetKey || "id";
+    if (normalized.type === "belongsTo") {
+      normalized.foreignKey = normalized.foreignKey || buildRelationKeyName(normalized.name, normalized.targetKey);
+    }
+    if (normalized.type === "hasMany" || normalized.type === "hasOne") {
+      normalized.foreignKey = normalized.foreignKey || buildRelationKeyName(collectionName, normalized.sourceKey);
+    }
+    if (normalized.type === "belongsToMany") {
+      normalized.foreignKey = normalized.foreignKey || buildRelationKeyName(collectionName, normalized.sourceKey);
+      normalized.otherKey = normalized.otherKey || buildRelationKeyName(normalized.target, normalized.targetKey);
+      normalized.through = normalized.through || buildThroughName(collectionName, normalized.target);
+    }
+    normalized.uiSchema = import_lodash.default.merge(
+      {
+        type: normalized.type === "belongsTo" || normalized.type === "hasOne" ? "object" : "array",
+        title: normalized.title || ((_a = normalized.uiSchema) == null ? void 0 : _a.title) || normalized.name,
+        "x-component": "AssociationField",
+        "x-component-props": {
+          multiple: normalized.type === "hasMany" || normalized.type === "belongsToMany",
+          fieldNames: {
+            value: normalized.targetKey,
+            label: normalized.targetTitleField || normalized.titleField || normalized.targetKey
+          }
+        }
+      },
+      normalized.uiSchema || {}
+    );
+  }
+  delete normalized.settings;
+  delete normalized.title;
+  delete normalized.titleField;
+  delete normalized.targetTitleField;
+  return normalized;
+}
+function validateExternalRelationField(values) {
+  if (!RELATION_TYPES.has(values.type)) {
+    return;
+  }
+  const validatePresent = (name) => {
+    if (!values[name]) {
+      throw new Error(`"${name}" is required`);
+    }
+  };
+  const validatePresents = (names) => names.forEach((name) => validatePresent(name));
+  if (values.type === "belongsTo") {
+    validatePresents(["foreignKey", "targetKey", "target"]);
+  }
+  if (values.type === "hasMany" || values.type === "hasOne") {
+    validatePresents(["foreignKey", "sourceKey", "target"]);
+  }
+  if (values.type === "belongsToMany") {
+    validatePresents(["foreignKey", "otherKey", "sourceKey", "targetKey", "through", "target"]);
+  }
+}
+function getFieldOptions(ctx, values) {
+  var _a;
+  return (_a = ctx.app.dataSourceManager.dataSources.get(values.dataSourceKey).collectionManager.getCollection(values.collectionName).getField(values.name)) == null ? void 0 : _a.options;
+}
+async function applyExternalFieldDefinition(ctx, rawValues, defaults = {}) {
+  const values = normalizeExternalFieldInput(rawValues, defaults);
+  validateExternalRelationField(values);
+  const dataSource = ctx.app.dataSourceManager.dataSources.get(values.dataSourceKey);
+  if (!dataSource) {
+    throw new Error(`dataSource ${values.dataSourceKey} not found`);
+  }
+  const collection = dataSource.collectionManager.getCollection(values.collectionName);
+  if (!collection) {
+    throw new Error(`collection ${values.collectionName} not found in dataSource ${values.dataSourceKey}`);
+  }
+  const repository = ctx.app.db.getRepository("dataSourcesFields");
+  const filter = {
+    name: values.name,
+    collectionName: values.collectionName,
+    dataSourceKey: values.dataSourceKey
+  };
+  const existing = await repository.findOne({ filter });
+  if (existing) {
+    await repository.update({
+      filter,
+      values
+    });
+  } else {
+    await repository.create({
+      values
+    });
+  }
+  return getFieldOptions(ctx, values);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyExternalFieldDefinition,
+  normalizeExternalFieldInput,
+  parseCollectionNameWithDataSourceKey
+});

package/dist/swagger/index.d.ts

@@ -52,6 +52,139 @@ declare const _default: {
                 };
             };
         };
+        '/dataSources/{associatedIndex}/collections:list': {
+            get: {
+                tags: string[];
+                summary: string;
+                description: string;
+                parameters: ({
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    description: string;
+                    schema: {
+                        type: string;
+                        additionalProperties?: undefined;
+                    };
+                } | {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    description: string;
+                    schema: {
+                        type: string;
+                        additionalProperties: boolean;
+                    };
+                } | {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                        additionalProperties?: undefined;
+                    };
+                    description?: undefined;
+                })[];
+                responses: {
+                    200: {
+                        description: string;
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        data: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        meta: {
+                                            type: string;
+                                            additionalProperties: boolean;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        '/dataSourcesCollections/{associatedIndex}/fields:list': {
+            get: {
+                tags: string[];
+                summary: string;
+                description: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    description: string;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    200: {
+                        description: string;
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                        additionalProperties: boolean;
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        '/dataSourcesCollections/{associatedIndex}/fields:apply': {
+            post: {
+                tags: string[];
+                summary: string;
+                description: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    description: string;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    200: {
+                        description: string;
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        data: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
     };
     components: {
         schemas: {
@@ -116,6 +249,77 @@ declare const _default: {
                 };
                 additionalProperties: boolean;
             };
+            DataSourceFieldApplyInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    dataSourceKey: {
+                        type: string;
+                        description: string;
+                    };
+                    collectionName: {
+                        type: string;
+                        description: string;
+                    };
+                    name: {
+                        type: string;
+                    };
+                    title: {
+                        type: string;
+                    };
+                    interface: {
+                        type: string;
+                        description: string;
+                    };
+                    type: {
+                        type: string;
+                        description: string;
+                    };
+                    target: {
+                        type: string;
+                    };
+                    foreignKey: {
+                        type: string;
+                    };
+                    sourceKey: {
+                        type: string;
+                    };
+                    targetKey: {
+                        type: string;
+                    };
+                    through: {
+                        type: string;
+                    };
+                    otherKey: {
+                        type: string;
+                    };
+                    targetTitleField: {
+                        type: string;
+                    };
+                    titleField: {
+                        type: string;
+                    };
+                    uiSchema: {
+                        type: string;
+                        additionalProperties: boolean;
+                    };
+                    settings: {
+                        type: string;
+                        additionalProperties: boolean;
+                    };
+                };
+                additionalProperties: boolean;
+            };
+            DataSourceFieldApplyResult: {
+                type: string;
+                properties: {
+                    data: {
+                        type: string;
+                        additionalProperties: boolean;
+                    };
+                };
+                additionalProperties: boolean;
+            };
         };
     };
 };

package/dist/swagger/index.js

@@ -76,6 +76,174 @@ var swagger_default = {
           }
         }
       }
+    },
+    "/dataSources/{associatedIndex}/collections:list": {
+      get: {
+        tags: ["dataSources.collections"],
+        summary: "List external data source collections",
+        description: [
+          "List loaded collections in one external data source, including field metadata.",
+          "",
+          "Use this endpoint to discover external table names before applying relation field metadata."
+        ].join("\n"),
+        parameters: [
+          {
+            name: "associatedIndex",
+            in: "path",
+            required: true,
+            description: "External data source key, for example `external`.",
+            schema: {
+              type: "string"
+            }
+          },
+          {
+            name: "filter",
+            in: "query",
+            required: false,
+            description: "Filter object matched against collection options.",
+            schema: {
+              type: "object",
+              additionalProperties: true
+            }
+          },
+          {
+            name: "page",
+            in: "query",
+            required: false,
+            schema: {
+              type: "integer"
+            }
+          },
+          {
+            name: "pageSize",
+            in: "query",
+            required: false,
+            schema: {
+              type: "integer"
+            }
+          },
+          {
+            name: "paginate",
+            in: "query",
+            required: false,
+            schema: {
+              type: "boolean"
+            }
+          }
+        ],
+        responses: {
+          200: {
+            description: "OK",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    data: {
+                      type: "array",
+                      items: {
+                        $ref: "#/components/schemas/DataSourceCollectionInfo"
+                      }
+                    },
+                    meta: {
+                      type: "object",
+                      additionalProperties: true
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/dataSourcesCollections/{associatedIndex}/fields:list": {
+      get: {
+        tags: ["dataSourcesCollections.fields"],
+        summary: "List external data source collection fields",
+        description: [
+          "List loaded field metadata for one external data source collection.",
+          "",
+          "The associatedIndex path parameter is `<dataSourceKey>.<collectionName>`."
+        ].join("\n"),
+        parameters: [
+          {
+            name: "associatedIndex",
+            in: "path",
+            required: true,
+            description: "External data source collection locator, for example `external.orders`.",
+            schema: {
+              type: "string"
+            }
+          }
+        ],
+        responses: {
+          200: {
+            description: "OK",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    additionalProperties: true
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/dataSourcesCollections/{associatedIndex}/fields:apply": {
+      post: {
+        tags: ["dataSourcesCollections.fields"],
+        summary: "Create or update an external data source field",
+        description: [
+          "Upsert one external data source field from a compact request body.",
+          "",
+          "Use this endpoint for external data source field metadata, including relation fields.",
+          "The associatedIndex path parameter is `<dataSourceKey>.<collectionName>`.",
+          "",
+          "Relation fields may use compact interfaces such as `m2o`, `o2m`, `oho`, and `m2m`.",
+          "The server fills readable relation key defaults when explicit keys are omitted."
+        ].join("\n"),
+        parameters: [
+          {
+            name: "associatedIndex",
+            in: "path",
+            required: true,
+            description: "External data source collection locator, for example `external.orders`.",
+            schema: {
+              type: "string"
+            }
+          }
+        ],
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: { $ref: "#/components/schemas/DataSourceFieldApplyInput" }
+            }
+          }
+        },
+        responses: {
+          200: {
+            description: "OK",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    data: {
+                      $ref: "#/components/schemas/DataSourceFieldApplyResult"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
     }
   },
   components: {
@@ -140,6 +308,77 @@ var swagger_default = {
           }
         },
         additionalProperties: true
+      },
+      DataSourceFieldApplyInput: {
+        type: "object",
+        required: ["name"],
+        properties: {
+          dataSourceKey: {
+            type: "string",
+            description: "Optional when the path associatedIndex supplies the data source key."
+          },
+          collectionName: {
+            type: "string",
+            description: "Optional when the path associatedIndex supplies the collection name."
+          },
+          name: {
+            type: "string"
+          },
+          title: {
+            type: "string"
+          },
+          interface: {
+            type: "string",
+            description: "Compact field interface, for example `input`, `m2o`, `o2m`, `oho`, or `m2m`."
+          },
+          type: {
+            type: "string",
+            description: "Raw field type. Relation types include `belongsTo`, `hasMany`, `hasOne`, and `belongsToMany`."
+          },
+          target: {
+            type: "string"
+          },
+          foreignKey: {
+            type: "string"
+          },
+          sourceKey: {
+            type: "string"
+          },
+          targetKey: {
+            type: "string"
+          },
+          through: {
+            type: "string"
+          },
+          otherKey: {
+            type: "string"
+          },
+          targetTitleField: {
+            type: "string"
+          },
+          titleField: {
+            type: "string"
+          },
+          uiSchema: {
+            type: "object",
+            additionalProperties: true
+          },
+          settings: {
+            type: "object",
+            additionalProperties: true
+          }
+        },
+        additionalProperties: true
+      },
+      DataSourceFieldApplyResult: {
+        type: "object",
+        properties: {
+          data: {
+            type: "object",
+            additionalProperties: true
+          }
+        },
+        additionalProperties: true
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nocobase/plugin-data-source-manager",
-  "version": "2.1.0-beta.32",
+  "version": "2.1.0-beta.33",
   "main": "dist/server/index.js",
   "displayName": "Data source manager",
   "displayName.ru-RU": "Менеджер управления источниками данных",
@@ -20,6 +20,6 @@
   "keywords": [
     "Data model tools"
   ],
-  "gitHead": "659c5efe992da7118d33c768bbd9e837a2c4716f",
+  "gitHead": "4815c394e80a264fa8ed619246280923c47aeb72",
   "license": "Apache-2.0"
 }