@antelopejs/dms-database 0.0.14 → 0.1.1

package/dist/routes/tables.js

@@ -14,80 +14,120 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DatabaseTablesController = void 0;
 const interface_api_1 = require("@antelopejs/interface-api");
+const interface_api_util_1 = require("@antelopejs/interface-api-util");
 const auth_1 = require("@antelopejs/interface-dms/auth");
+const messages_1 = require("../i18n/messages");
 const introspect_1 = require("../service/introspect");
+const schemaFilters_1 = require("../service/schemaFilters");
+const schemaRegistry_1 = require("../service/schemaRegistry");
 const query_1 = require("../utils/query");
-const DEFAULT_LIMIT = 25;
-const MAX_LIMIT = 200;
-async function listAllTables(instance) {
+const INSTANCE_LIMIT_DEFAULT = 100;
+const INSTANCE_LIMIT_MAX = 500;
+const instanceCollator = new Intl.Collator(undefined, { numeric: true });
+function relationTargets(schemaId, table) {
+    const targets = table.relations.map((relation) => relation.toSchema === schemaId
+        ? relation.toTable
+        : `${relation.toSchema}.${relation.toTable}`);
+    return [...new Set(targets)];
+}
+function modifierNames(table, locale) {
+    const ids = new Set(Object.values(table.modifiers).flat());
+    return [...ids].map((id) => (0, messages_1.formatModifier)(locale, id));
+}
+function matchesSearch(table, needle) {
+    if (table.name.toLowerCase().includes(needle))
+        return true;
+    return Object.keys(table.fields).some((field) => field.toLowerCase().includes(needle));
+}
+function needleOf(text) {
+    const needle = text?.trim().toLowerCase();
+    return needle || undefined;
+}
+function matchesStructure({ schemaId, table }, filters, needle) {
+    if (filters.scope && schemaId !== filters.scope)
+        return false;
+    if (needle && !matchesSearch(table, needle))
+        return false;
+    if (filters.has.includes("relations") && table.relations.length === 0)
+        return false;
+    if (filters.has.includes("modifiers") &&
+        Object.values(table.modifiers).every((ids) => ids.length === 0))
+        return false;
+    return true;
+}
+function countRows(schemaId, tableName, instance) {
+    if (instance.kind === "all")
+        return (0, introspect_1.getTableTotalCount)(schemaId, tableName);
+    if (instance.kind === "default")
+        return (0, introspect_1.getTableElementCount)(schemaId, tableName);
+    return (0, introspect_1.getTableElementCount)(schemaId, tableName, instance.id);
+}
+async function listTableSourceRows(locale, filters) {
+    const needle = needleOf(filters.q);
     const summaries = await (0, introspect_1.listSchemaSummaries)();
-    const rows = [];
-    for (const summary of summaries) {
-        const counts = await Promise.all(summary.tables.map((table) => (0, introspect_1.getTableElementCount)(summary.id, table.name, instance)));
-        summary.tables.forEach((table, idx) => {
-            rows.push({
-                id: `${summary.id}::${table.name}`,
-                schema: summary.id,
-                name: table.name,
-                columnCount: Object.keys(table.fields).length,
-                indexCount: Object.keys(table.indexes).length,
-                relationCount: (table.relations ?? []).length,
-                elementCount: counts[idx] ?? 0,
-            });
-        });
-    }
-    return rows;
+    const registered = summaries.flatMap((summary) => summary.tables.map((table) => ({ schemaId: summary.id, table })));
+    const tables = registered.filter((listed) => matchesStructure(listed, filters, needle));
+    const counts = await Promise.all(tables.map(({ schemaId, table }) => countRows(schemaId, table.name, filters.instance)));
+    const rows = tables.map(({ schemaId, table }, index) => ({
+        id: `${schemaId}::${table.name}`,
+        schema: schemaId,
+        name: table.name,
+        elementCount: counts[index] ?? 0,
+        columnCount: Object.keys(table.fields).length,
+        indexCount: Object.keys(table.indexes ?? {}).length,
+        relations: relationTargets(schemaId, table),
+        modifiers: modifierNames(table, locale),
+    }));
+    return {
+        rows: filters.has.includes("empty")
+            ? rows.filter((row) => row.elementCount === 0)
+            : rows,
+        all: registered.length,
+    };
 }
-async function selectMatchingTables(schemaFilter, instanceFilter, search) {
-    const all = await listAllTables((0, query_1.decodeInstanceFilter)(instanceFilter));
-    const bySchema = (0, query_1.applyFilterToList)(all, "schema", schemaFilter);
-    return (0, query_1.applySearchToList)(bySchema, "name", search);
+function matchNamedInstances(instances, search, limit) {
+    const needle = needleOf(search);
+    const matches = instances
+        .filter((id) => !needle || id.toLowerCase().includes(needle))
+        .sort((left, right) => instanceCollator.compare(left, right));
+    return { instances: matches.slice(0, limit), total: matches.length };
 }
 let DatabaseTablesController = class DatabaseTablesController extends (0, interface_api_1.Controller)("/api/database/tables") {
-    async list(_user, schemaFilter, instanceFilter, search, offsetRaw, limitRaw, sortKey, sortDirection) {
-        const matching = await selectMatchingTables(schemaFilter, instanceFilter, search);
-        const sorted = (0, query_1.applySortToList)(matching, sortKey, sortDirection);
-        const offset = Math.max(0, (0, query_1.parseInteger)(offsetRaw, 0));
-        const limit = (0, query_1.clamp)((0, query_1.parseInteger)(limitRaw, DEFAULT_LIMIT), 1, MAX_LIMIT);
-        return {
-            results: sorted.slice(offset, offset + limit),
-            total: sorted.length,
-            offset,
-            limit,
-        };
+    async source(user, scope, instance, q, has) {
+        const { rows, all } = await listTableSourceRows((0, messages_1.localeOf)(user), (0, schemaFilters_1.readSchemaFilters)({ scope, instance, q, has }));
+        return { results: rows, total: rows.length, all };
     }
-    async count(_user, schemaFilter, instanceFilter, search) {
-        return {
-            total: (await selectMatchingTables(schemaFilter, instanceFilter, search))
-                .length,
-        };
+    async instances(schemaRaw, search, limitRaw) {
+        const schema = (0, query_1.asNonEmptyString)(schemaRaw);
+        (0, interface_api_util_1.assert)(schema, 400, "Missing 'schema'");
+        const registered = (0, schemaRegistry_1.getRegistry)().get(schema);
+        (0, interface_api_util_1.assert)(registered, 404, `Unknown schema ${schema}`);
+        const named = await (0, introspect_1.listSchemaInstances)(registered);
+        const limit = (0, query_1.clamp)((0, query_1.parseInteger)(limitRaw, INSTANCE_LIMIT_DEFAULT), 1, INSTANCE_LIMIT_MAX);
+        return matchNamedInstances(named, (0, query_1.asNonEmptyString)(search), limit);
     }
 };
 exports.DatabaseTablesController = DatabaseTablesController;
 __decorate([
-    (0, interface_api_1.Get)("/list"),
+    (0, interface_api_1.Get)("/source"),
     __param(0, (0, auth_1.AuthRawUser)()),
-    __param(1, (0, interface_api_1.Parameter)("filter_schema", "query")),
+    __param(1, (0, interface_api_1.Parameter)("filter_scope", "query")),
     __param(2, (0, interface_api_1.Parameter)("filter_instance", "query")),
-    __param(3, (0, interface_api_1.Parameter)("search", "query")),
-    __param(4, (0, interface_api_1.Parameter)("offset", "query")),
-    __param(5, (0, interface_api_1.Parameter)("limit", "query")),
-    __param(6, (0, interface_api_1.Parameter)("sortKey", "query")),
-    __param(7, (0, interface_api_1.Parameter)("sortDirection", "query")),
+    __param(3, (0, interface_api_1.Parameter)("filter_q", "query")),
+    __param(4, (0, interface_api_1.Parameter)("filter_has", "query")),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Function, Object, Object, Object, Object, Object, Object, Object]),
+    __metadata("design:paramtypes", [Function, Object, Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], DatabaseTablesController.prototype, "list", null);
+], DatabaseTablesController.prototype, "source", null);
 __decorate([
-    (0, interface_api_1.Get)("/count"),
-    __param(0, (0, auth_1.AuthRawUser)()),
-    __param(1, (0, interface_api_1.Parameter)("filter_schema", "query")),
-    __param(2, (0, interface_api_1.Parameter)("filter_instance", "query")),
-    __param(3, (0, interface_api_1.Parameter)("search", "query")),
+    (0, interface_api_1.Get)("/instances"),
+    __param(0, (0, interface_api_1.Parameter)("schema", "query")),
+    __param(1, (0, interface_api_1.Parameter)("search", "query")),
+    __param(2, (0, interface_api_1.Parameter)("limit", "query")),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Function, Object, Object, Object]),
+    __metadata("design:paramtypes", [Object, Object, Object]),
     __metadata("design:returntype", Promise)
-], DatabaseTablesController.prototype, "count", null);
+], DatabaseTablesController.prototype, "instances", null);
 exports.DatabaseTablesController = DatabaseTablesController = __decorate([
     (0, auth_1.AuthOwnerOnly)()
 ], DatabaseTablesController);

package/dist/routes/tables.js.map

@@ -1 +1 @@
-{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/routes/tables.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6DAAuE;AAEvE,yDAA4E;AAE5E,sDAG+B;AAC/B,0CAOwB;AAExB,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,SAAS,GAAG,GAAG,CAAC;AActB,KAAK,UAAU,aAAa,CAAC,QAAqB;IAChD,MAAM,SAAS,GAAG,MAAM,IAAA,gCAAmB,GAAE,CAAC;IAC9C,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAIhC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC3B,IAAA,iCAAoB,EAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CACvD,CACF,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACpC,IAAI,CAAC,IAAI,CAAC;gBACR,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,EAAE;gBAClC,MAAM,EAAE,OAAO,CAAC,EAAE;gBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM;gBAC7C,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM;gBAC7C,aAAa,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM;gBAC7C,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,YAAqB,EACrB,cAAuB,EACvB,MAAe;IAEf,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAA,4BAAoB,EAAC,cAAc,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAA,yBAAiB,EAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,IAAA,yBAAiB,EAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAGM,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,IAAA,0BAAU,EACtD,sBAAsB,CACvB;IAMO,AAAN,KAAK,CAAC,IAAI,CACO,KAAW,EACW,YAAqB,EACnB,cAAuB,EAChC,MAAe,EACf,SAAkB,EACnB,QAAiB,EACf,OAAgB,EACV,aAAsB;QAE3D,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,YAAY,EACZ,cAAc,EACd,MAAM,CACP,CAAC;QACF,MAAM,MAAM,GAAG,IAAA,uBAAe,EAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAA,oBAAY,EAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAA,aAAK,EAAC,IAAA,oBAAY,EAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;YAC7C,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,MAAM;YACN,KAAK;SACN,CAAC;IACJ,CAAC;IAGK,AAAN,KAAK,CAAC,KAAK,CACM,KAAW,EACW,YAAqB,EACnB,cAAuB,EAChC,MAAe;QAE7C,OAAO;YACL,KAAK,EAAE,CAAC,MAAM,oBAAoB,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;iBACtE,MAAM;SACV,CAAC;IACJ,CAAC;CACF,CAAA;AA9CY,4DAAwB;AAQ7B;IALL,IAAA,mBAAG,EAAC,OAAO,CAAC;IAMV,WAAA,IAAA,kBAAW,GAAE,CAAA;IACb,WAAA,IAAA,yBAAS,EAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IACnC,WAAA,IAAA,yBAAS,EAAC,iBAAiB,EAAE,OAAO,CAAC,CAAA;IACrC,WAAA,IAAA,yBAAS,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC5B,WAAA,IAAA,yBAAS,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC5B,WAAA,IAAA,yBAAS,EAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC3B,WAAA,IAAA,yBAAS,EAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAC7B,WAAA,IAAA,yBAAS,EAAC,eAAe,EAAE,OAAO,CAAC,CAAA;;;;oDAgBrC;AAGK;IADL,IAAA,mBAAG,EAAC,QAAQ,CAAC;IAEX,WAAA,IAAA,kBAAW,GAAE,CAAA;IACb,WAAA,IAAA,yBAAS,EAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IACnC,WAAA,IAAA,yBAAS,EAAC,iBAAiB,EAAE,OAAO,CAAC,CAAA;IACrC,WAAA,IAAA,yBAAS,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;;;;qDAM9B;mCA7CU,wBAAwB;IADpC,IAAA,oBAAa,GAAE;GACH,wBAAwB,CA8CpC"}
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/routes/tables.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6DAAuE;AACvE,uEAAwD;AACxD,yDAA4E;AAE5E,+CAA+E;AAC/E,sDAK+B;AAC/B,4DAIkC;AAClC,8DAAwD;AAExD,0CAAuE;AA+BvE,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,gBAAgB,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAEzE,SAAS,eAAe,CAAC,QAAgB,EAAE,KAAmB;IAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC/C,QAAQ,CAAC,QAAQ,KAAK,QAAQ;QAC5B,CAAC,CAAC,QAAQ,CAAC,OAAO;QAClB,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAC/C,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,aAAa,CAAC,KAAmB,EAAE,MAAoB;IAC9D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,yBAAc,EAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAID,SAAS,aAAa,CAAC,KAAmB,EAAE,MAAc;IACxD,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9C,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CACrC,CAAC;AACJ,CAAC;AAOD,SAAS,QAAQ,CAAC,IAAwB;IACxC,MAAM,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,MAAM,IAAI,SAAS,CAAC;AAC7B,CAAC;AAID,SAAS,gBAAgB,CACvB,EAAE,QAAQ,EAAE,KAAK,EAAe,EAChC,OAAsB,EACtB,MAA0B;IAE1B,IAAI,OAAO,CAAC,KAAK,IAAI,QAAQ,KAAK,OAAO,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,IACE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC;QAE/D,OAAO,KAAK,CAAC;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAChB,QAAgB,EAChB,SAAiB,EACjB,QAAwB;IAExB,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAA,+BAAkB,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5E,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAC7B,OAAO,IAAA,iCAAoB,EAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnD,OAAO,IAAA,iCAAoB,EAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC;AAaD,KAAK,UAAU,mBAAmB,CAChC,MAAoB,EACpB,OAAsB;IAEtB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,IAAA,gCAAmB,GAAE,CAAC;IAC9C,MAAM,UAAU,GAAkB,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC9D,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CACjE,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC1C,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAC1C,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CACjC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAClD,CACF,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACvD,EAAE,EAAE,GAAG,QAAQ,KAAK,KAAK,CAAC,IAAI,EAAE;QAChC,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM;QAC7C,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM;QACnD,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC3C,SAAS,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC;KACxC,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YACjC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC,IAAI;QACR,GAAG,EAAE,UAAU,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAGD,SAAS,mBAAmB,CAC1B,SAA4B,EAC5B,MAA0B,EAC1B,KAAa;IAEb,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,SAAS;SACtB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC5D,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACvE,CAAC;AAGM,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,IAAA,0BAAU,EACtD,sBAAsB,CACvB;IAQO,AAAN,KAAK,CAAC,MAAM,CACK,IAAU,EACW,KAAc,EACX,QAAiB,EACxB,CAAU,EACR,GAAY;QAE9C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,mBAAmB,CAC7C,IAAA,mBAAQ,EAAC,IAAI,CAAC,EACd,IAAA,iCAAiB,EAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAC/C,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;IACpD,CAAC;IAQK,AAAN,KAAK,CAAC,SAAS,CACiB,SAAkB,EAClB,MAAe,EAChB,QAAiB;QAE9C,MAAM,MAAM,GAAG,IAAA,wBAAgB,EAAC,SAAS,CAAC,CAAC;QAC3C,IAAA,2BAAM,EAAC,MAAM,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,IAAA,4BAAW,GAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAA,2BAAM,EAAC,UAAU,EAAE,GAAG,EAAE,kBAAkB,MAAM,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,IAAA,gCAAmB,EAAC,UAAU,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,IAAA,aAAK,EACjB,IAAA,oBAAY,EAAC,QAAQ,EAAE,sBAAsB,CAAC,EAC9C,CAAC,EACD,kBAAkB,CACnB,CAAC;QACF,OAAO,mBAAmB,CAAC,KAAK,EAAE,IAAA,wBAAgB,EAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;CACF,CAAA;AA/CY,4DAAwB;AAU7B;IADL,IAAA,mBAAG,EAAC,SAAS,CAAC;IAEZ,WAAA,IAAA,kBAAW,GAAE,CAAA;IACb,WAAA,IAAA,yBAAS,EAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAClC,WAAA,IAAA,yBAAS,EAAC,iBAAiB,EAAE,OAAO,CAAC,CAAA;IACrC,WAAA,IAAA,yBAAS,EAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAC9B,WAAA,IAAA,yBAAS,EAAC,YAAY,EAAE,OAAO,CAAC,CAAA;;;;sDAOlC;AAQK;IADL,IAAA,mBAAG,EAAC,YAAY,CAAC;IAEf,WAAA,IAAA,yBAAS,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC5B,WAAA,IAAA,yBAAS,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC5B,WAAA,IAAA,yBAAS,EAAC,OAAO,EAAE,OAAO,CAAC,CAAA;;;;yDAa7B;mCA9CU,wBAAwB;IADpC,IAAA,oBAAa,GAAE;GACH,wBAAwB,CA+CpC"}

package/dist/service/catalog.d.ts

@@ -0,0 +1,3 @@
+import type { ModuleReadoutLine } from "@antelopejs/interface-dms/page";
+import { type LocaleCarrier } from "../i18n/messages";
+export declare function readCatalogReadout(user: LocaleCarrier | undefined): Promise<ModuleReadoutLine[]>;

package/dist/service/catalog.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCatalogReadout = readCatalogReadout;
+const messages_1 = require("../i18n/messages");
+const health_1 = require("./health");
+const SEPARATOR = " · ";
+async function readCatalogReadout(user) {
+    const locale = (0, messages_1.localeOf)(user);
+    const health = await (0, health_1.getOverviewHealth)();
+    if (health.status === "down") {
+        return [{ text: (0, messages_1.formatMessage)(locale, "connectionDown"), tone: "error" }];
+    }
+    const contents = [
+        (0, messages_1.formatCount)(locale, "tables", health.tableCount),
+        (0, messages_1.formatCount)(locale, "rows", health.totalRows),
+    ].join(SEPARATOR);
+    const connection = [(0, messages_1.formatCount)(locale, "schemas", health.schemaCount)];
+    if (health.latencyMs !== null) {
+        connection.push((0, messages_1.formatMessage)(locale, "latency", { value: String(health.latencyMs) }));
+    }
+    return [
+        { text: contents, tone: "success" },
+        { text: connection.join(SEPARATOR), tone: "info" },
+    ];
+}
+//# sourceMappingURL=catalog.js.map

package/dist/service/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/service/catalog.ts"],"names":[],"mappings":";;AAeA,gDAsBC;AApCD,+CAK0B;AAC1B,qCAA6C;AAE7C,MAAM,SAAS,GAAG,KAAK,CAAC;AAMjB,KAAK,UAAU,kBAAkB,CACtC,IAA+B;IAE/B,MAAM,MAAM,GAAG,IAAA,mBAAQ,EAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAiB,GAAE,CAAC;IACzC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,CAAC,EAAE,IAAI,EAAE,IAAA,wBAAa,EAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,QAAQ,GAAG;QACf,IAAA,sBAAW,EAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;QAChD,IAAA,sBAAW,EAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC;KAC9C,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClB,MAAM,UAAU,GAAG,CAAC,IAAA,sBAAW,EAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC9B,UAAU,CAAC,IAAI,CACb,IAAA,wBAAa,EAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CACtE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;QACnC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;KACnD,CAAC;AACJ,CAAC"}

package/dist/service/health.d.ts

@@ -8,13 +8,13 @@ export interface OverviewHealth {
     status: ConnectionStatus;
     latencyMs: number | null;
     driver: string | null;
-    pool: string | null;
-    collections: number;
+    checkedAt: string;
+    error: string | null;
     schemaCount: number;
     tableCount: number;
+    relationCount: number;
     indexCount: number;
     totalRows: number;
-    sizeBytes: number | null;
     storage: StorageEntry[];
 }
 export declare function getOverviewHealth(): Promise<OverviewHealth>;

package/dist/service/health.js

@@ -9,19 +9,24 @@ async function probeConnection() {
     const schemaIds = Array.from(registry.keys());
     const probeSchema = schemaIds[0] ? registry.get(schemaIds[0]) : undefined;
     if (!probeSchema)
-        return { status: "ok", latencyMs: null };
+        return { status: "ok", latencyMs: null, error: null };
     const startedAt = Date.now();
     try {
         await probeSchema.listInstances().run();
-        return { status: "ok", latencyMs: Date.now() - startedAt };
+        return { status: "ok", latencyMs: Date.now() - startedAt, error: null };
     }
-    catch {
-        return { status: "down", latencyMs: null };
+    catch (error) {
+        return {
+            status: "down",
+            latencyMs: null,
+            error: error instanceof Error ? error.message : String(error),
+        };
     }
 }
 async function aggregateStorage(summaries) {
     let tableCount = 0;
     let indexCount = 0;
+    let relationCount = 0;
     let totalRows = 0;
     const storage = [];
     for (const summary of summaries) {
@@ -31,28 +36,26 @@ async function aggregateStorage(summaries) {
             const rows = counts[idx] ?? 0;
             totalRows += rows;
             indexCount += Object.keys(table.indexes ?? {}).length;
+            relationCount += table.relations.length;
             storage.push({ schema: summary.id, table: table.name, rows });
         });
     }
     storage.sort((a, b) => b.rows - a.rows);
-    return { tableCount, indexCount, totalRows, storage };
+    return { tableCount, relationCount, indexCount, totalRows, storage };
 }
 async function getOverviewHealth() {
-    const { status, latencyMs } = await probeConnection();
+    const checkedAt = new Date().toISOString();
+    const { status, latencyMs, error } = await probeConnection();
     const summaries = await (0, introspect_1.listSchemaSummaries)();
-    const { tableCount, indexCount, totalRows, storage } = await aggregateStorage(summaries);
+    const aggregate = await aggregateStorage(summaries);
     return {
         status,
         latencyMs,
         driver: (0, config_1.getModuleConfig)().driverLabel ?? null,
-        pool: null,
-        collections: tableCount,
+        checkedAt,
+        error,
         schemaCount: summaries.length,
-        tableCount,
-        indexCount,
-        totalRows,
-        sizeBytes: null,
-        storage,
+        ...aggregate,
     };
 }
 //# sourceMappingURL=health.js.map

package/dist/service/health.js.map

@@ -1 +1 @@
-{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/service/health.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/service/health.ts"],"names":[],"mappings":"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"}

package/dist/service/introspect.d.ts

@@ -1,6 +1,8 @@
-import type { InstanceId } from "@antelopejs/interface-database";
+import { type InstanceId, type Schema } from "@antelopejs/interface-database";
 import type { SchemaSummary, SchemaSummaryWithStats } from "./types";
 export declare function listSchemaSummaries(): Promise<SchemaSummary[]>;
+export declare function listSchemaInstances(schema: Schema): Promise<string[]>;
 export declare function getTableElementCount(schemaId: string, tableName: string, instance?: InstanceId): Promise<number>;
+export declare function getTableTotalCount(schemaId: string, tableName: string): Promise<number>;
 export declare function listSchemaSummariesWithStats(): Promise<SchemaSummaryWithStats[]>;
 export declare function getTablePrimaryKey(schemaId: string, tableName: string): string | undefined;

package/dist/service/introspect.js

@@ -1,10 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listSchemaSummaries = listSchemaSummaries;
+exports.listSchemaInstances = listSchemaInstances;
 exports.getTableElementCount = getTableElementCount;
+exports.getTableTotalCount = getTableTotalCount;
 exports.listSchemaSummariesWithStats = listSchemaSummariesWithStats;
 exports.getTablePrimaryKey = getTablePrimaryKey;
 const logging_1 = require("@antelopejs/interface-core/logging");
+const interface_database_1 = require("@antelopejs/interface-database");
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const config_1 = require("../config");
 const fieldDescriptor_1 = require("./fieldDescriptor");
@@ -14,6 +17,7 @@ const STATS_TTL_MS = 30_000;
 const FIELDS_TTL_MS = 30_000;
 const FIELD_INFERENCE_SAMPLE_SIZE = 5;
 const UNKNOWN_DESCRIPTOR = { kind: "unknown" };
+const NULL_DESCRIPTOR = { kind: "null" };
 const warnedRelations = new Set();
 function warnOnce(key, message) {
     if (warnedRelations.has(key))
@@ -66,13 +70,39 @@ function resolveModifiers(TableClass) {
     return out;
 }
 const fieldsCache = new Map();
+function inferArrayType(items) {
+    const members = [];
+    for (const item of items) {
+        const type = inferFieldType(item);
+        if (!type)
+            continue;
+        const key = JSON.stringify(type);
+        if (!members.some((member) => JSON.stringify(member) === key))
+            members.push(type);
+    }
+    if (members.length === 0)
+        return { kind: "array" };
+    const [only] = members;
+    return {
+        kind: "array",
+        element: members.length === 1 && only ? only : { kind: "union", members },
+    };
+}
+function arrayOf(descriptor) {
+    const members = descriptor?.kind === "union" ? descriptor.members : [descriptor];
+    return members.find((member) => member?.kind === "array");
+}
+function refineSampled(seen, next) {
+    const untyped = seen?.kind === "array" && !seen.element;
+    return untyped && arrayOf(next)?.element ? next : (seen ?? next);
+}
 function inferFieldType(value) {
     if (value === null || value === undefined)
         return undefined;
     if (value instanceof Date)
         return { kind: "date" };
     if (Array.isArray(value))
-        return { kind: "array" };
+        return inferArrayType(value);
     if (typeof value === "object")
         return { kind: "object", fields: {} };
     if (typeof value === "string")
@@ -83,32 +113,80 @@ function inferFieldType(value) {
         return { kind: "boolean" };
     return undefined;
 }
-async function inferTableFields(schemaId, schema, tableName) {
-    const cacheKey = `${schemaId}::${tableName}`;
-    const cached = fieldsCache.get(cacheKey);
-    const now = Date.now();
-    if (cached && cached.expiresAt > now)
-        return cached.value;
-    const inferred = {};
+async function sampleRows(schema, tableName, instance) {
     try {
-        const sample = await schema
-            .instance()
+        return (await schema
+            .instance(instance)
             .table(tableName)
-            .slice(0, FIELD_INFERENCE_SAMPLE_SIZE);
-        for (const row of sample) {
-            if (!row || typeof row !== "object")
+            .slice(0, FIELD_INFERENCE_SAMPLE_SIZE));
+    }
+    catch {
+        return [];
+    }
+}
+async function sampleAnyInstance(schema, tableName) {
+    const rows = await sampleRows(schema, tableName);
+    if (rows.length > 0)
+        return rows;
+    for (const instance of await listSchemaInstances(schema)) {
+        const named = await sampleRows(schema, tableName, instance);
+        if (named.length > 0)
+            return named;
+    }
+    return [];
+}
+const INSTANCE_TAG_FIELD = "_instance";
+const NULLISH_KINDS = new Set([
+    "null",
+    "undefined",
+    "any",
+    "unknown",
+]);
+function admitsNull(descriptor) {
+    if (NULLISH_KINDS.has(descriptor.kind))
+        return true;
+    return (descriptor.kind === "union" &&
+        descriptor.members.some((member) => NULLISH_KINDS.has(member.kind)));
+}
+function withNull(descriptor) {
+    if (admitsNull(descriptor))
+        return descriptor;
+    if (descriptor.kind === "union")
+        return { kind: "union", members: [...descriptor.members, NULL_DESCRIPTOR] };
+    return { kind: "union", members: [descriptor, NULL_DESCRIPTOR] };
+}
+function inferFromRows(rows) {
+    const observed = new Map();
+    for (const row of rows) {
+        if (!row || typeof row !== "object")
+            continue;
+        for (const [key, value] of Object.entries(row)) {
+            if (key === INSTANCE_TAG_FIELD)
                 continue;
-            for (const [key, value] of Object.entries(row)) {
-                if (key in inferred)
-                    continue;
-                const type = inferFieldType(value);
-                if (type !== undefined)
-                    inferred[key] = type;
-            }
+            const field = observed.get(key) ?? { nullable: false };
+            if (value === null)
+                field.nullable = true;
+            else
+                field.type = refineSampled(field.type, inferFieldType(value));
+            observed.set(key, field);
         }
     }
-    catch {
+    const inferred = {};
+    for (const [key, { type, nullable }] of observed) {
+        if (type)
+            inferred[key] = nullable ? withNull(type) : type;
+        else if (nullable)
+            inferred[key] = NULL_DESCRIPTOR;
     }
+    return inferred;
+}
+async function inferTableFields(schemaId, schema, tableName) {
+    const cacheKey = `${schemaId}::${tableName}`;
+    const cached = fieldsCache.get(cacheKey);
+    const now = Date.now();
+    if (cached && cached.expiresAt > now)
+        return cached.value;
+    const inferred = inferFromRows(await sampleAnyInstance(schema, tableName));
     fieldsCache.set(cacheKey, {
         value: inferred,
         expiresAt: now + FIELDS_TTL_MS,
@@ -183,17 +261,24 @@ async function summarizeTable(id, schema, tableName, def, tableClasses) {
     for (const [name, value] of Object.entries(definitionFields)) {
         fromDefinition[name] = (0, fieldDescriptor_1.toFieldDescriptor)(value);
     }
+    const withSampled = (name, descriptor) => {
+        const seen = sampled[name];
+        const element = arrayOf(seen)?.element;
+        const typed = descriptor.kind === "array" && !descriptor.element && element
+            ? { kind: "array", element }
+            : descriptor;
+        return seen && admitsNull(seen) ? withNull(typed) : typed;
+    };
     const fields = {};
     for (const name of declared.ordered) {
-        fields[name] =
-            fromDefinition[name] ??
-                declared.types[name] ??
-                sampled[name] ??
-                UNKNOWN_DESCRIPTOR;
+        fields[name] = withSampled(name, fromDefinition[name] ??
+            declared.types[name] ??
+            sampled[name] ??
+            UNKNOWN_DESCRIPTOR);
     }
     for (const [name, descriptor] of Object.entries(fromDefinition)) {
         if (!(name in fields))
-            fields[name] = descriptor;
+            fields[name] = withSampled(name, descriptor);
     }
     for (const [name, descriptor] of Object.entries(sampled)) {
         if (!(name in fields))
@@ -225,14 +310,18 @@ function tableCountKey(schemaId, tableName, instance) {
     return `${schemaId}::${String(instance ?? "")}::${tableName}`;
 }
 async function countTableRows(schema, tableName, instance) {
-    try {
-        const table = schema.instance(instance).table(tableName);
-        const total = await table.count();
-        return typeof total === "number" && Number.isFinite(total) ? total : 0;
-    }
-    catch {
-        return 0;
-    }
+    const table = schema.instance(instance).table(tableName);
+    const total = await table.count();
+    return typeof total === "number" && Number.isFinite(total) ? total : 0;
+}
+async function cachedCount(key, count) {
+    const cached = tableCountCache.get(key);
+    const now = Date.now();
+    if (cached && cached.expiresAt > now)
+        return cached.value;
+    const value = await count();
+    tableCountCache.set(key, { value, expiresAt: now + STATS_TTL_MS });
+    return value;
 }
 async function listSchemaInstances(schema) {
     try {
@@ -246,17 +335,16 @@ async function listSchemaInstances(schema) {
     }
 }
 async function getTableElementCount(schemaId, tableName, instance) {
-    const key = tableCountKey(schemaId, tableName, instance);
-    const cached = tableCountCache.get(key);
-    const now = Date.now();
-    if (cached && cached.expiresAt > now)
-        return cached.value;
     const schema = (0, schemaRegistry_1.getRegistry)().get(schemaId);
     if (!schema)
         return 0;
-    const value = await countTableRows(schema, tableName, instance);
-    tableCountCache.set(key, { value, expiresAt: now + STATS_TTL_MS });
-    return value;
+    return cachedCount(tableCountKey(schemaId, tableName, instance), () => countTableRows(schema, tableName, instance).catch(() => 0));
+}
+async function getTableTotalCount(schemaId, tableName) {
+    const schema = (0, schemaRegistry_1.getRegistry)().get(schemaId);
+    if (!schema)
+        return 0;
+    return cachedCount(tableCountKey(schemaId, tableName, interface_database_1.CROSS_INSTANCE), () => countTableRows(schema, tableName, interface_database_1.CROSS_INSTANCE).catch(() => 0));
 }
 async function computeInsights(id, schema) {
     const tableNames = Object.keys(schema.definition);