@nocobase/app-plugin-foundation 0.0.0-stage → 0.1.0-beta.1

package/dist/server/provider-inventory.js

@@ -0,0 +1,180 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { apiDocsToken } from '@nocobase/app-server/router';
+import { CAPABILITY_COLLECTORS } from './capabilities/index.js';
+/** Explicit additions to the collector-owned catalog; this is not an npm-scope heuristic. */
+const ADDITIONAL_CATEGORIES = {
+    '@nocobase/app-plugin-foundation': ['interface'],
+    '@nocobase/app-plugin-database-explorer': ['dataModeling', 'interface'],
+    '@nocobase/app-plugin-i18n': ['interface'],
+    '@nocobase/app-plugin-template-print': ['interface'],
+    '@nocobase/app-plugin-projects': [],
+    '@nocobase/app-plugin-releases': [],
+};
+const CATEGORIES = new Map(Object.entries(ADDITIONAL_CATEGORIES));
+for (const collector of CAPABILITY_COLLECTORS) {
+    for (const name of collector.packages)
+        CATEGORIES.set(name, [
+            ...new Set([...(CATEGORIES.get(name) ?? []), collector.key]),
+        ]);
+}
+/** Reads public host contributions, without importing application code or accessing private runtime fields. */
+export function runtimeProviderEvidence(app) {
+    const evidence = [
+        { name: '@nocobase/app-plugin-foundation', evidence: 'foundationRuntime' },
+    ];
+    for (const plugin of app.registeredServerPlugins ?? [])
+        evidence.push({
+            name: plugin.packageName,
+            version: plugin.version,
+            rootDir: plugin.rootDir,
+            evidence: 'serverRegistration',
+        });
+    // Older hosts and hand-composed applications may not publish database task contributions.
+    if ('databaseTaskContributions' in app) {
+        const tasks = app.databaseTaskContributions;
+        if (isRecord(tasks)) {
+            for (const key of ['migrations', 'seeds']) {
+                const sources = tasks[key];
+                if (!Array.isArray(sources))
+                    continue;
+                for (const source of sources) {
+                    if (isRecord(source) &&
+                        typeof source.packageName === 'string' &&
+                        source.packageName !== tasks.appPackageName)
+                        evidence.push({
+                            name: source.packageName,
+                            evidence: 'databaseContribution',
+                        });
+                }
+            }
+        }
+    }
+    evidence.push(...apiProviderEvidence(app.container));
+    return evidence;
+}
+function apiProviderEvidence(container) {
+    if (!container.has(apiDocsToken))
+        return [];
+    const routes = container.resolve(apiDocsToken).forwardedApiRoutes;
+    return [...routes.routers, ...routes.undeclared].map(({ owner }) => ({
+        name: owner,
+        evidence: 'apiContribution',
+    }));
+}
+/** A deliberately bounded scan of direct application dependencies plus known providers and runtime owners. */
+export async function collectProviderInventory(rootDir, runtime = [], serverRegistrationsComplete = false) {
+    const app = await readManifest(path.join(rootDir, 'package.json'));
+    const unreadable = app ? [] : ['applicationManifest'];
+    const declared = new Set([
+        ...Object.keys(app?.dependencies ?? {}),
+        ...Object.keys(app?.devDependencies ?? {}),
+        ...Object.keys(app?.optionalDependencies ?? {}),
+    ]);
+    const names = [
+        ...new Set([
+            ...declared,
+            ...CATEGORIES.keys(),
+            ...runtime.map(({ name }) => name),
+        ]),
+    ].sort();
+    const entries = [];
+    // Serial manifest reads keep the scan bounded even in applications with many dependencies.
+    for (const name of names) {
+        if (!validPackageName(name) || name === app?.name)
+            continue;
+        const observed = runtime.filter((entry) => entry.name === name);
+        const registered = observed.find((entry) => entry.evidence === 'serverRegistration');
+        const resolvedManifest = registered?.rootDir
+            ? await readManifest(path.join(registered.rootDir, 'package.json'))
+            : undefined;
+        const manifest = resolvedManifest?.name === name
+            ? resolvedManifest
+            : await findManifest(rootDir, name);
+        const conventional = /(?:^|\/)app-plugin-[a-z0-9-]+$/.test(name);
+        const exports = manifest?.exports;
+        // A generic ./server or ./client export (for example react-dom/server) is not a plugin declaration.
+        const hasPluginEntry = exports && './client/plugin' in exports;
+        const known = CATEGORIES.has(name);
+        if (!known && !conventional && !hasPluginEntry && observed.length === 0)
+            continue;
+        if (!manifest &&
+            observed.length === 0 &&
+            !(declared.has(name) && conventional))
+            continue;
+        if (!manifest && (declared.has(name) || registered?.rootDir))
+            unreadable.push(name);
+        entries.push({
+            name,
+            ...(manifest?.displayName ? { displayName: manifest.displayName } : {}),
+            ...(manifest?.description ? { description: manifest.description } : {}),
+            version: registered?.version ?? manifest?.version ?? null,
+            installed: manifest !== undefined,
+            kind: conventional || !known ? 'plugin' : 'core',
+            origin: known ? 'nocobase' : 'unverified',
+            categories: CATEGORIES.get(name) ?? [],
+            registration: observed.length > 0 ? 'observed' : 'unknown',
+            evidence: [
+                ...new Set([
+                    ...(manifest ? ['manifest'] : []),
+                    ...observed.map((entry) => entry.evidence),
+                ]),
+            ],
+        });
+    }
+    return {
+        entries,
+        complete: unreadable.length === 0,
+        unreadable,
+        serverRegistrationsComplete,
+    };
+}
+async function findManifest(rootDir, name) {
+    let directory = rootDir;
+    for (;;) {
+        const manifest = await readManifest(path.join(directory, 'node_modules', name, 'package.json'));
+        if (manifest?.name === name)
+            return manifest;
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+}
+async function readManifest(file) {
+    try {
+        const value = JSON.parse(await readFile(file, 'utf8'));
+        if (!isRecord(value))
+            return undefined;
+        return {
+            ...(typeof value.name === 'string' ? { name: value.name } : {}),
+            ...(typeof value.version === 'string' ? { version: value.version } : {}),
+            ...(typeof value.displayName === 'string'
+                ? { displayName: value.displayName }
+                : {}),
+            ...(typeof value.description === 'string'
+                ? { description: value.description }
+                : {}),
+            ...(isRecord(value.exports) ? { exports: value.exports } : {}),
+            ...(isRecord(value.dependencies)
+                ? { dependencies: value.dependencies }
+                : {}),
+            ...(isRecord(value.devDependencies)
+                ? { devDependencies: value.devDependencies }
+                : {}),
+            ...(isRecord(value.optionalDependencies)
+                ? { optionalDependencies: value.optionalDependencies }
+                : {}),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function validPackageName(name) {
+    return /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/.test(name);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=provider-inventory.js.map

package/dist/server/provider-inventory.js.map

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

package/dist/server/providers/foundation.d.ts

@@ -0,0 +1,7 @@
+import type { AppPluginApplication } from '@nocobase/app-server/plugins';
+import { ServiceProvider } from '@nocobase/service-provider';
+export declare class FoundationProvider extends ServiceProvider<AppPluginApplication> {
+    readonly name: string;
+    register(): void;
+}
+//# sourceMappingURL=foundation.d.ts.map

package/dist/server/providers/foundation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation.d.ts","sourceRoot":"","sources":["../../../server/providers/foundation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D,qBAAa,kBAAmB,SAAQ,eAAe,CAAC,oBAAoB,CAAC;IAC3E,SAAgB,IAAI,EAAE,MAAM,CAAqC;IAEjD,QAAQ,IAAI,IAAI;CAoBjC"}

package/dist/server/providers/foundation.js

@@ -0,0 +1,24 @@
+import { existsSync } from 'node:fs';
+import { ServiceProvider } from '@nocobase/service-provider';
+import { DefaultFoundationService } from '../services/foundation.js';
+import { runtimeProviderEvidence } from '../provider-inventory.js';
+import { foundationServiceToken } from '../tokens.js';
+export class FoundationProvider extends ServiceProvider {
+    name = '@nocobase/app-plugin-foundation';
+    register() {
+        this.app.container.singleton(foundationServiceToken, () => new DefaultFoundationService({
+            container: this.app.container,
+            config: this.app.config,
+            rootDir: this.app.paths.rootDir,
+            runtimeProviders: () => runtimeProviderEvidence(this.app),
+            serverRegistrationsComplete: () => Array.isArray(this.app.registeredServerPlugins),
+            // A deployment serves its built client from `clientDir`; in development that build does not exist yet and
+            // Vite serves the sources in `client/`.
+            hasClient: [
+                this.app.paths.clientDir,
+                this.app.paths.root('client'),
+            ].some((directory) => existsSync(directory)),
+        }));
+    }
+}
+//# sourceMappingURL=foundation.js.map

package/dist/server/providers/foundation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation.js","sourceRoot":"","sources":["../../../server/providers/foundation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,OAAO,kBAAmB,SAAQ,eAAqC;IAC3D,IAAI,GAAW,iCAAiC,CAAC;IAEjD,QAAQ;QACtB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAC1B,sBAAsB,EACtB,GAAG,EAAE,CACH,IAAI,wBAAwB,CAAC;YAC3B,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS;YAC7B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM;YACvB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO;YAC/B,gBAAgB,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC;YACzD,2BAA2B,EAAE,GAAG,EAAE,CAChC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,uBAAuB,CAAC;YACjD,0GAA0G;YAC1G,wCAAwC;YACxC,SAAS,EAAE;gBACT,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS;gBACxB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;aAC9B,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;SAC7C,CAAC,CACL,CAAC;IACJ,CAAC;CACF"}

package/dist/server/providers/index.d.ts

@@ -0,0 +1,4 @@
+import type { AppPluginProviderConstructor } from '@nocobase/app-server/plugins';
+export declare const serviceProviders: readonly AppPluginProviderConstructor[];
+export default serviceProviders;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../server/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAIjF,eAAO,MAAM,gBAAgB,EAAE,SAAS,4BAA4B,EAEnE,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/server/providers/index.js

@@ -0,0 +1,6 @@
+import { FoundationProvider } from './foundation.js';
+export const serviceProviders = [
+    FoundationProvider,
+];
+export default serviceProviders;
+//# sourceMappingURL=index.js.map

package/dist/server/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/providers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAA4C;IACvE,kBAAkB;CACnB,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/server/read-queue.d.ts

@@ -0,0 +1,10 @@
+/** A service-wide bound that also covers reads left running by an earlier timed-out overview. */
+export declare class ReadQueue {
+    private readonly limit;
+    private active;
+    private readonly waiting;
+    constructor(limit?: number);
+    run<T>(read: () => Promise<T>, signal?: AbortSignal): Promise<T>;
+    private drain;
+}
+//# sourceMappingURL=read-queue.d.ts.map

package/dist/server/read-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-queue.d.ts","sourceRoot":"","sources":["../../server/read-queue.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,qBAAa,SAAS;IAID,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHzC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;gBAEV,KAAK,SAAI;IAEtC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAoCvE,OAAO,CAAC,KAAK;CAId"}

package/dist/server/read-queue.js

@@ -0,0 +1,50 @@
+/** A service-wide bound that also covers reads left running by an earlier timed-out overview. */
+export class ReadQueue {
+    limit;
+    active = 0;
+    waiting = [];
+    constructor(limit = 4) {
+        this.limit = limit;
+    }
+    run(read, signal) {
+        return new Promise((resolve, reject) => {
+            const abort = () => {
+                const index = this.waiting.indexOf(start);
+                if (index >= 0)
+                    this.waiting.splice(index, 1);
+                reject(new Error('Foundation read deadline exceeded.'));
+            };
+            const start = () => {
+                if (signal?.aborted) {
+                    abort();
+                    return;
+                }
+                this.active += 1;
+                void Promise.resolve()
+                    .then(() => {
+                    signal?.throwIfAborted();
+                    return read();
+                })
+                    .then(resolve, reject)
+                    .finally(() => {
+                    signal?.removeEventListener('abort', abort);
+                    // A driver read has no generic cancellation API. Keep its slot until it actually settles.
+                    this.active -= 1;
+                    this.drain();
+                });
+            };
+            if (signal?.aborted) {
+                reject(new Error('Foundation read deadline exceeded.'));
+                return;
+            }
+            signal?.addEventListener('abort', abort, { once: true });
+            this.waiting.push(start);
+            this.drain();
+        });
+    }
+    drain() {
+        while (this.active < this.limit && this.waiting.length)
+            this.waiting.shift()?.();
+    }
+}
+//# sourceMappingURL=read-queue.js.map

package/dist/server/read-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-queue.js","sourceRoot":"","sources":["../../server/read-queue.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,OAAO,SAAS;IAIgB;IAH5B,MAAM,GAAG,CAAC,CAAC;IACF,OAAO,GAAmB,EAAE,CAAC;IAE9C,YAAoC,QAAQ,CAAC;QAAT,UAAK,GAAL,KAAK,CAAI;IAAG,CAAC;IAE1C,GAAG,CAAI,IAAsB,EAAE,MAAoB;QACxD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,GAAS,EAAE;gBACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1C,IAAI,KAAK,IAAI,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC9C,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;YAC1D,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,GAAS,EAAE;gBACvB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,KAAK,EAAE,CAAC;oBACR,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;gBACjB,KAAK,OAAO,CAAC,OAAO,EAAE;qBACnB,IAAI,CAAC,GAAG,EAAE;oBACT,MAAM,EAAE,cAAc,EAAE,CAAC;oBACzB,OAAO,IAAI,EAAE,CAAC;gBAChB,CAAC,CAAC;qBACD,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;qBACrB,OAAO,CAAC,GAAG,EAAE;oBACZ,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;oBAC5C,0FAA0F;oBAC1F,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;oBACjB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,CAAC,CAAC,CAAC;YACP,CAAC,CAAC;YACF,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;gBACxD,OAAO;YACT,CAAC;YACD,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YACpD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/server/request-evidence.d.ts

@@ -0,0 +1,14 @@
+import ts from 'typescript';
+import type { SourceEvidence } from './source-evidence.js';
+export interface ApiReference {
+    readonly path: string;
+    readonly method: string;
+}
+export declare const REPOSITORY_ACTIONS: ReadonlySet<string>;
+export declare function objectProperty(node: ts.ObjectLiteralExpression, name: string): ts.Expression | undefined;
+export declare function returned(node: ts.Node): readonly ts.Node[];
+/** Only calls on a proven host API client count. Parameter bindings are local to one selected page slice. */
+export declare function pageRequests(sources: readonly {
+    readonly nodes: ReadonlySet<ts.Node>;
+}[], analysis: SourceEvidence): ApiReference[];
+//# sourceMappingURL=request-evidence.d.ts.map

package/dist/server/request-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-evidence.d.ts","sourceRoot":"","sources":["../../server/request-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAUjD,CAAC;AAEH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,EAAE,CAAC,uBAAuB,EAChC,IAAI,EAAE,MAAM,GACX,EAAE,CAAC,UAAU,GAAG,SAAS,CAY3B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,SAAS,EAAE,CAAC,IAAI,EAAE,CAU1D;AAED,6GAA6G;AAC7G,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;CAAE,EAAE,EAC5D,QAAQ,EAAE,cAAc,GACvB,YAAY,EAAE,CA2GhB"}

package/dist/server/request-evidence.js

@@ -0,0 +1,141 @@
+import ts from 'typescript';
+import { StaticValues } from './static-values.js';
+export const REPOSITORY_ACTIONS = new Set([
+    'findMany',
+    'findOne',
+    'count',
+    'aggregate',
+    'groupBy',
+    'exists',
+    'createOne',
+    'updateOne',
+    'deleteOne',
+]);
+export function objectProperty(node, name) {
+    const entry = node.properties.find((item) => item.name &&
+        (ts.isIdentifier(item.name) || ts.isStringLiteralLike(item.name)) &&
+        item.name.text === name);
+    return entry && ts.isPropertyAssignment(entry)
+        ? entry.initializer
+        : entry && ts.isShorthandPropertyAssignment(entry)
+            ? entry.name
+            : undefined;
+}
+export function returned(node) {
+    if (ts.isArrowFunction(node) && !ts.isBlock(node.body))
+        return [node.body];
+    const result = [];
+    const visit = (child) => {
+        if (ts.isReturnStatement(child) && child.expression)
+            result.push(child.expression);
+        else if (!ts.isFunctionLike(child))
+            ts.forEachChild(child, visit);
+    };
+    if (ts.isFunctionLike(node) && 'body' in node && node.body)
+        visit(node.body);
+    return result;
+}
+/** Only calls on a proven host API client count. Parameter bindings are local to one selected page slice. */
+export function pageRequests(sources, analysis) {
+    const selected = new Set(sources.flatMap((source) => [...source.nodes]));
+    const bindings = new Map();
+    for (const node of selected) {
+        const expression = ts.isCallExpression(node)
+            ? node.expression
+            : ts.isJsxSelfClosingElement(node) || ts.isJsxOpeningElement(node)
+                ? node.tagName
+                : undefined;
+        if (!expression)
+            continue;
+        for (const value of analysis.values(expression)) {
+            if (!ts.isFunctionLike(value))
+                continue;
+            value.parameters.forEach((parameter, index) => {
+                const argument = ts.isCallExpression(node)
+                    ? node.arguments[index]
+                    : (ts.isJsxSelfClosingElement(node) ||
+                        ts.isJsxOpeningElement(node)) &&
+                        index === 0
+                        ? node.attributes
+                        : undefined;
+                if (argument)
+                    bindings.set(parameter, [
+                        ...(bindings.get(parameter) ?? []),
+                        argument,
+                    ]);
+            });
+        }
+    }
+    const literals = new StaticValues(analysis, bindings);
+    const values = (node) => literals.values(node);
+    const imported = (node, name) => {
+        const symbol = analysis.symbol(node);
+        return (symbol?.declarations ?? []).some((declaration) => {
+            if (!ts.isImportSpecifier(declaration) ||
+                declaration.isTypeOnly ||
+                (declaration.propertyName?.text ?? declaration.name.text) !== name)
+                return false;
+            const statement = declaration.parent.parent.parent;
+            return (ts.isImportDeclaration(statement) &&
+                !statement.importClause?.isTypeOnly &&
+                ts.isStringLiteralLike(statement.moduleSpecifier) &&
+                statement.moduleSpecifier.text === '@nocobase/app-client');
+        });
+    };
+    const client = (node, seen = new Set()) => {
+        if (seen.has(node))
+            return false;
+        seen.add(node);
+        return values(node).some((value) => {
+            if (!ts.isCallExpression(value))
+                return false;
+            if (imported(value.expression, 'useApiClient'))
+                return true;
+            if (ts.isPropertyAccessExpression(value.expression) &&
+                value.expression.name.text === 'resolve' &&
+                value.arguments[0] &&
+                imported(value.arguments[0], 'apiClientToken'))
+                return true;
+            return analysis
+                .values(value.expression)
+                .some((fn) => returned(fn).some((result) => client(result, new Set(seen))));
+        });
+    };
+    const strings = (node) => literals.strings(node, true);
+    const paths = [];
+    for (const node of selected) {
+        if (!ts.isCallExpression(node) ||
+            !ts.isPropertyAccessExpression(node.expression))
+            continue;
+        const methodName = node.expression.name.text;
+        const receiver = node.expression.expression;
+        if (methodName === 'request' && client(receiver)) {
+            for (const argument of node.arguments[0]
+                ? values(node.arguments[0])
+                : []) {
+                if (!ts.isObjectLiteralExpression(argument))
+                    continue;
+                const path = objectProperty(argument, 'path');
+                const method = objectProperty(argument, 'method');
+                for (const verb of method ? strings(method) : ['GET'])
+                    for (const pathValue of path ? strings(path) : [])
+                        paths.push({ path: pathValue, method: verb.toUpperCase() });
+            }
+        }
+        if (REPOSITORY_ACTIONS.has(methodName)) {
+            for (const repository of values(receiver)) {
+                if (!ts.isCallExpression(repository) ||
+                    !ts.isPropertyAccessExpression(repository.expression) ||
+                    repository.expression.name.text !== 'repository' ||
+                    !client(repository.expression.expression))
+                    continue;
+                for (const name of repository.arguments[0]
+                    ? strings(repository.arguments[0])
+                    : [])
+                    paths.push({ path: `${name}/${methodName}`, method: 'POST' });
+            }
+        }
+    }
+    return paths;
+}
+//# sourceMappingURL=request-evidence.js.map

package/dist/server/request-evidence.js.map

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

package/dist/server/routes/index.d.ts

@@ -0,0 +1,6 @@
+import type { AppPluginApplication } from '@nocobase/app-server/plugins';
+import { type AppApiRouteContribution, type AppRouteContribution } from '@nocobase/app-server/router';
+export declare const apiRoutes: AppApiRouteContribution<AppPluginApplication>;
+declare const routes: readonly AppRouteContribution<AppPluginApplication>[];
+export default routes;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../server/routes/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAUL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAcrC,eAAO,MAAM,SAAS,EAAE,uBAAuB,CAAC,oBAAoB,CAmFhE,CAAC;AAEL,QAAA,MAAM,MAAM,EAAE,SAAS,oBAAoB,CAAC,oBAAoB,CAAC,EAEhE,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/server/routes/index.js

@@ -0,0 +1,77 @@
+import { authenticationToken } from '@nocobase/app-plugin-authentication';
+import { authorizationToken, } from '@nocobase/app-plugin-authorization';
+import { ApiError, apiErrorHandler, apiErrorResponses, apiErrorResponse, apiValidator, dataResponse, listResponse, defineApiRoutes, describeRoute, } from '@nocobase/app-server/router';
+import { Hono } from 'hono';
+import { FOUNDATION_NAMESPACE } from '../../shared/foundation.js';
+import { foundationServiceToken } from '../tokens.js';
+import { OverviewQuery, OverviewSchema, CollectionsQuery, CollectionItemSchema, } from './schemas.js';
+const tags = ['Foundation'];
+export const apiRoutes = defineApiRoutes((app) => {
+    const { container } = app;
+    const router = new Hono();
+    const routes = new Hono();
+    const authentication = container.resolve(authenticationToken);
+    const authorization = container.resolve(authorizationToken);
+    routes.onError((error, context) => apiErrorHandler(error, context));
+    routes.use('*', authentication.required(), authorization.middleware());
+    // Only an identity with unrestricted access, such as a holder of the root Permission Set, reads the overview. It is
+    // not a grant anyone can be given: the page shows every capability's internals, settings and statistics at once.
+    routes.use('*', async (context, next) => {
+        const { unrestricted } = await context.get('authz').snapshot();
+        if (!unrestricted) {
+            throw new ApiError({
+                status: 'PERMISSION_DENIED',
+                reason: 'FOUNDATION_FORBIDDEN',
+                domain: FOUNDATION_NAMESPACE,
+                message: 'Only an administrator with unrestricted access can read the App Foundation.',
+            });
+        }
+        await next();
+    });
+    routes.get('/overview', describeRoute({
+        tags,
+        summary: 'Get what the application uses of NocoBase Core',
+        operationId: 'foundationGetOverview',
+        description: 'Every NocoBase Core capability with its status, the evidence behind it, live statistics and the providing packages at their installed versions. Collected read-only by the plugin and cached for 30 seconds; `refresh=true` collects again. Requires unrestricted access, such as the root Permission Set.',
+        responses: {
+            200: dataResponse(OverviewSchema),
+            ...apiErrorResponses,
+        },
+    }), apiValidator('query', OverviewQuery), async (context) => {
+        const { refresh, countRecords } = context.req.valid('query');
+        const data = await container.resolve(foundationServiceToken).overview({
+            refresh: refresh === true,
+            countRecords: countRecords === true,
+        });
+        return context.json({ data });
+    });
+    routes.get('/collections', describeRoute({
+        tags,
+        summary: 'List application Collections on demand',
+        operationId: 'foundationListCollections',
+        responses: {
+            200: listResponse(CollectionItemSchema),
+            ...apiErrorResponses,
+            503: apiErrorResponse(503),
+        },
+    }), apiValidator('query', CollectionsQuery), async (context) => {
+        const data = await container
+            .resolve(foundationServiceToken)
+            .collections(context.req.valid('query'));
+        if (!data)
+            throw new ApiError({
+                status: 'UNAVAILABLE',
+                reason: 'FOUNDATION_COLLECTIONS_UNAVAILABLE',
+                domain: FOUNDATION_NAMESPACE,
+                message: 'Application Collection ownership could not be determined.',
+            });
+        return context.json({ data: data.items, meta: { total: data.total } });
+    });
+    router.route(`/${FOUNDATION_NAMESPACE}`, routes);
+    return router;
+});
+const routes = [
+    apiRoutes,
+];
+export default routes;
+//# sourceMappingURL=index.js.map

package/dist/server/routes/index.js.map

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

package/dist/server/routes/schemas.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { type FoundationOverview, type FoundationCollectionPage } from '../../shared/foundation.js';
+export declare const OverviewQuery: z.ZodObject<{
+    refresh: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
+    countRecords: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
+}, z.core.$strip>;
+export declare const CollectionsQuery: z.ZodType<{
+    offset: number;
+    search: string;
+}>;
+export declare const CollectionItemSchema: z.ZodType<FoundationCollectionPage['items'][number]>;
+export declare const OverviewSchema: z.ZodType<FoundationOverview>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/server/routes/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../server/routes/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,SAAS,CACrC;IACE,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACpE,EACD,CAAC,CAAC,IAAI,CAAC,MAAM,CAUb,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAUvE,CAAC;AACL,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAC1C,wBAAwB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAOH,CAAC;AA4FzC,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAyEnB,CAAC"}