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

package/dist/server/routes/schemas.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { FOUNDATION_STATUSES, } from '../../shared/foundation.js';
+export const OverviewQuery = z.object({
+    refresh: z.stringbool().optional().meta({
+        description: 'Collects again instead of answering a result collected within the last 30 seconds.',
+    }),
+});
+const FactSchema = z
+    .object({
+    code: z.string().meta({
+        description: 'What was established, such as `applicationCollections`; the page words it.',
+    }),
+    params: z
+        .record(z.string(), z.union([
+        z.string(),
+        z.number(),
+        z.array(z.union([
+            z.string(),
+            z.object({ key: z.string(), ns: z.string() }).meta({
+                description: 'A translation key in the namespace `ns`.',
+            }),
+        ])),
+    ]))
+        .optional()
+        .meta({ description: 'The values the wording quotes.' }),
+})
+    .meta({ ref: 'FoundationFact' });
+const MetricSchema = z
+    .object({
+    key: z.string(),
+    value: z.number().nullable().meta({
+        description: 'Null when it could not be read; never a stand-in zero.',
+    }),
+    unit: z.enum(['count', 'bytes', 'tokens']),
+    complete: z.boolean().meta({
+        description: 'False when part of what it adds up could not be read, so the value is a lower bound.',
+    }),
+})
+    .meta({ ref: 'FoundationMetric' });
+const StatusSchema = z.enum(FOUNDATION_STATUSES);
+const CapabilitySchema = z
+    .object({
+    key: z.string(),
+    status: StatusSchema.nullable().meta({
+        description: '`active`, `needsSetup` or `unused`; null when usage is not recognized or its evidence could not be read.',
+    }),
+    title: z
+        .union([z.string(), z.object({ key: z.string(), ns: z.string() })])
+        .optional(),
+    description: z.string().optional(),
+    reason: z.string().optional().meta({
+        description: 'Why it needs setup or is unused, such as `noChannel`.',
+    }),
+    facts: z.array(FactSchema),
+    metrics: z.array(MetricSchema),
+    parts: z.array(z.object({
+        key: z.string(),
+        status: StatusSchema,
+        reason: z.string().optional(),
+    })),
+    packages: z
+        .array(z.object({ name: z.string(), version: z.string().nullable() }))
+        .meta({
+        description: 'The NocoBase packages that provide it, at the versions the application resolves.',
+    }),
+    completeness: z.enum(['complete', 'partial', 'failed']),
+    issues: z.array(z.object({
+        code: z.enum([
+            'COLLECTOR_FAILED',
+            'COLLECTOR_TIMEOUT',
+            'SOURCE_UNREADABLE',
+        ]),
+        source: z.string().optional().meta({
+            description: 'The Collection or service that could not be read.',
+        }),
+    })),
+})
+    .meta({ ref: 'FoundationCapability' });
+export const OverviewSchema = z
+    .object({
+    capabilities: z.array(CapabilitySchema).meta({
+        description: 'Built-in adapter observations. The visible band uses runtime-specific availableCapabilities.',
+    }),
+    availableCapabilities: z.array(CapabilitySchema).optional(),
+    moduleSources: z
+        .object({
+        routes: z.array(z.object({
+            packageName: z.string(),
+            routeName: z.string(),
+            providers: z.array(z.string()),
+            apiProviders: z.array(z.string()).optional(),
+            complete: z.boolean(),
+        })),
+        complete: z.boolean(),
+    })
+        .optional()
+        .meta({
+        description: 'Read-only static page dependency evidence. It proves integration references, not execution or per-module runtime counts; unavailable sources remain incomplete. No filesystem paths or source code are returned.',
+    }),
+    inventory: z
+        .object({
+        entries: z.array(z.object({
+            name: z.string(),
+            displayName: z.string().optional(),
+            description: z.string().optional(),
+            version: z.string().nullable(),
+            installed: z.boolean(),
+            kind: z.enum(['core', 'plugin']),
+            origin: z.enum(['nocobase', 'unverified']),
+            categories: z.array(z.string()),
+            registration: z.enum(['observed', 'unknown']),
+            evidence: z.array(z.enum([
+                'manifest',
+                'databaseContribution',
+                'apiContribution',
+                'foundationRuntime',
+                'serverRegistration',
+                'clientContribution',
+            ])),
+        })),
+        serverRegistrationsComplete: z.boolean().optional(),
+        complete: z.boolean(),
+        unreadable: z.array(z.string()),
+    })
+        .optional()
+        .meta({
+        description: 'Installed provider manifests and observed current runtime contributions. Registration and category mapping do not prove individual package usage. Pro and custom providers without a catalog entry remain unclassified.',
+    }),
+    checkedAt: z.string().meta({
+        description: 'When the result was collected; a cached one keeps its time.',
+    }),
+    durationMs: z.number(),
+    connection: z.literal('default').meta({
+        description: 'The database connection the statistics read.',
+    }),
+})
+    .meta({ ref: 'FoundationOverview' });
+//# sourceMappingURL=schemas.js.map

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

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

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

@@ -0,0 +1,37 @@
+import type { AppConfigAccessor } from '@nocobase/app-server/config';
+import type { ServiceContainer } from '@nocobase/service-provider';
+import type { FoundationOverview } from '../../shared/foundation.js';
+import { type CapabilityCollector } from '../capabilities/index.js';
+import { type RuntimeProviderEvidence } from '../provider-inventory.js';
+import type { FoundationOverviewOptions, FoundationService } from '../tokens.js';
+export interface FoundationServiceOptions {
+    readonly container: ServiceContainer;
+    readonly config: Pick<AppConfigAccessor, 'get'>;
+    /** The application's root, where its `package.json` and `node_modules` are. */
+    readonly rootDir: string;
+    readonly hasClient: boolean;
+    readonly runtimeProviders?: () => readonly RuntimeProviderEvidence[];
+    readonly serverRegistrationsComplete?: () => boolean;
+    /** How long a result is answered again before it is collected anew. Defaults to 30 seconds. */
+    readonly cacheTtlMs?: number;
+    /** How long one capability may take before it is reported as timed out. Defaults to 10 seconds. */
+    readonly collectorTimeoutMs?: number;
+    readonly collectors?: readonly CapabilityCollector[];
+    readonly now?: () => number;
+}
+export declare class DefaultFoundationService implements FoundationService {
+    private readonly options;
+    private cached?;
+    private pending?;
+    private readonly packages;
+    private readonly cacheTtlMs;
+    private readonly collectorTimeoutMs;
+    private readonly collectors;
+    private readonly now;
+    constructor(options: FoundationServiceOptions);
+    overview(options?: FoundationOverviewOptions): Promise<FoundationOverview>;
+    private collect;
+    private run;
+    private resolvePackages;
+}
+//# sourceMappingURL=foundation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"foundation.d.ts","sourceRoot":"","sources":["../../../server/services/foundation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EAGV,kBAAkB,EAEnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAChD,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,SAAS,uBAAuB,EAAE,CAAC;IACrE,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,OAAO,CAAC;IACrD,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,mGAAmG;IACnG,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAQD,qBAAa,wBAAyB,YAAW,iBAAiB;IAY7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX3C,OAAO,CAAC,MAAM,CAAC,CAGb;IACF,OAAO,CAAC,OAAO,CAAC,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEC,OAAO,EAAE,wBAAwB;IAQxD,QAAQ,CACnB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,kBAAkB,CAAC;YAchB,OAAO;YA6FP,GAAG;YAkCH,eAAe;CAa9B"}

package/dist/server/services/foundation.js

@@ -0,0 +1,175 @@
+import { databaseManagerToken } from '@nocobase/db';
+import { availableCapabilities } from '../../shared/available-capabilities.js';
+import { CAPABILITY_COLLECTORS, } from '../capabilities/index.js';
+import { Inventory, Probe } from '../inventory.js';
+import { InstalledPackages } from '../packages.js';
+import { collectModuleSources } from '../module-sources.js';
+import { collectProviderInventory, } from '../provider-inventory.js';
+/** Capabilities that read nothing from the database. */
+const DATABASE_FREE = new Set(['interface', 'audit']);
+/** How many capabilities read the database at once. */
+const CONCURRENCY = 4;
+export class DefaultFoundationService {
+    options;
+    cached;
+    pending;
+    packages;
+    cacheTtlMs;
+    collectorTimeoutMs;
+    collectors;
+    now;
+    constructor(options) {
+        this.options = options;
+        this.packages = new InstalledPackages(options.rootDir);
+        this.cacheTtlMs = options.cacheTtlMs ?? 30_000;
+        this.collectorTimeoutMs = options.collectorTimeoutMs ?? 10_000;
+        this.collectors = options.collectors ?? CAPABILITY_COLLECTORS;
+        this.now = options.now ?? Date.now;
+    }
+    async overview(options = {}) {
+        if (!options.refresh &&
+            this.cached &&
+            this.now() - this.cached.at < this.cacheTtlMs)
+            return this.cached.overview;
+        // Concurrent requests share one collection rather than each scanning every table.
+        this.pending ??= this.collect().finally(() => {
+            this.pending = undefined;
+        });
+        return this.pending;
+    }
+    async collect() {
+        const started = this.now();
+        const { container } = this.options;
+        const database = container.has(databaseManagerToken)
+            ? container.resolve(databaseManagerToken)
+            : undefined;
+        let inventory;
+        let databaseUnreadable = false;
+        if (database) {
+            try {
+                inventory = await Inventory.read(database);
+            }
+            catch {
+                databaseUnreadable = true;
+            }
+        }
+        const applicationName = await this.packages.applicationName();
+        const capabilities = await mapWithConcurrency(this.collectors, CONCURRENCY, (collector) => databaseUnreadable && !DATABASE_FREE.has(collector.key)
+            ? Promise.resolve(failed(collector, [
+                { code: 'SOURCE_UNREADABLE', source: 'database' },
+            ]))
+            : this.run(collector, {
+                probe: inventory ? new Probe(inventory) : undefined,
+                container,
+                config: this.options.config,
+                applicationName,
+                hasClient: this.options.hasClient,
+            }));
+        const inventoryOfProviders = await collectProviderInventory(this.options.rootDir, this.options.runtimeProviders?.(), this.options.serverRegistrationsComplete?.());
+        // An unclassified runtime extension may own Collections absent from our ownership catalog. Its rows must not be
+        // presented as an exact business-only count until ownership is known.
+        if (inventoryOfProviders.entries.some((entry) => entry.categories.length === 0 &&
+            entry.origin === 'unverified' &&
+            entry.registration === 'observed')) {
+            const index = capabilities.findIndex((entry) => entry.key === 'dataModeling');
+            const data = capabilities[index];
+            if (data && data.completeness !== 'failed')
+                capabilities[index] = {
+                    ...data,
+                    completeness: 'partial',
+                    facts: [{ code: 'collectionOwnershipUnknown' }],
+                    metrics: data.metrics.map((metric) => ({
+                        ...metric,
+                        value: metric.key === 'systemCollections' ? metric.value : null,
+                        complete: false,
+                    })),
+                    issues: [
+                        ...data.issues,
+                        {
+                            code: 'SOURCE_UNREADABLE',
+                            source: 'extensionCollectionOwnership',
+                        },
+                    ],
+                };
+        }
+        const moduleSources = await collectModuleSources(this.options.rootDir, this.options.runtimeProviders?.());
+        const finished = this.now();
+        const overview = {
+            capabilities,
+            moduleSources,
+            inventory: inventoryOfProviders,
+            availableCapabilities: availableCapabilities(capabilities, inventoryOfProviders),
+            checkedAt: new Date(finished).toISOString(),
+            durationMs: finished - started,
+            connection: 'default',
+        };
+        this.cached = { at: finished, overview };
+        return overview;
+    }
+    async run(collector, context) {
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => resolve('timeout'), this.collectorTimeoutMs);
+        });
+        try {
+            const findings = await Promise.race([
+                collector.collect(context),
+                timeout,
+            ]);
+            if (findings === 'timeout')
+                return failed(collector, [{ code: 'COLLECTOR_TIMEOUT' }]);
+            const issues = context.probe?.issues ?? [];
+            return {
+                key: collector.key,
+                status: findings.status,
+                ...(findings.reason === undefined ? {} : { reason: findings.reason }),
+                facts: findings.facts ?? [],
+                metrics: findings.metrics ?? [],
+                parts: findings.parts ?? [],
+                packages: await this.resolvePackages(collector.packages),
+                completeness: issues.length > 0 ? 'partial' : 'complete',
+                issues: [...issues],
+            };
+        }
+        catch {
+            return failed(collector, [{ code: 'COLLECTOR_FAILED' }]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async resolvePackages(names) {
+        const resolved = await Promise.all(names.map(async (name) => {
+            const version = await this.packages.version(name);
+            return version === undefined ? undefined : { name, version };
+        }));
+        return resolved.filter((entry) => entry !== undefined);
+    }
+}
+/** A capability whose evidence could not be read: it has no status rather than a guessed one. */
+function failed(collector, issues) {
+    return {
+        key: collector.key,
+        status: null,
+        facts: [],
+        metrics: [],
+        parts: [],
+        packages: [],
+        completeness: 'failed',
+        issues,
+    };
+}
+async function mapWithConcurrency(items, limit, map) {
+    const results = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (next < items.length) {
+            const index = next;
+            next += 1;
+            results[index] = await map(items[index]);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=foundation.js.map

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

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

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

@@ -0,0 +1,19 @@
+import ts from 'typescript';
+export interface EvidenceSource {
+    readonly file: string;
+    readonly ast: ts.SourceFile;
+}
+/** Package-local value reachability. The host never loads dependencies, libraries or application code. */
+export declare class SourceEvidence {
+    private readonly resolutions;
+    private readonly checker;
+    private readonly sources;
+    constructor(sources: readonly EvidenceSource[], resolutions: ReadonlyMap<string, string>);
+    collect(file: string, roots?: readonly ts.Node[]): {
+        references: Set<string>;
+        nodes: Map<string, Set<ts.Node>>;
+        complete: boolean;
+    };
+    symbol(node: ts.Node): ts.Symbol | undefined;
+}
+//# sourceMappingURL=source-evidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-evidence.d.ts","sourceRoot":"","sources":["../../server/source-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC;CAC7B;AAED,0GAA0G;AAC1G,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAL9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAGpD,OAAO,EAAE,SAAS,cAAc,EAAE,EACjB,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAyBpD,OAAO,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GACzB;QACD,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC;KACnB;IAyIM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS;CAGpD"}

package/dist/server/source-evidence.js

@@ -0,0 +1,169 @@
+import ts from 'typescript';
+/** Package-local value reachability. The host never loads dependencies, libraries or application code. */
+export class SourceEvidence {
+    resolutions;
+    checker;
+    sources;
+    constructor(sources, resolutions) {
+        this.resolutions = resolutions;
+        this.sources = new Map(sources.map((source) => [source.file, source]));
+        const options = {
+            noLib: true,
+            noResolve: false,
+            allowJs: true,
+            target: ts.ScriptTarget.Latest,
+            module: ts.ModuleKind.ESNext,
+            jsx: ts.JsxEmit.Preserve,
+        };
+        const host = ts.createCompilerHost(options);
+        host.getSourceFile = (file) => this.sources.get(file)?.ast;
+        host.readFile = () => undefined;
+        host.fileExists = (file) => this.sources.has(file);
+        host.resolveModuleNames = (names, from) => names.map((name) => {
+            const file = resolutions.get(`${from}\0${name}`);
+            return file ? { resolvedFileName: file } : undefined;
+        });
+        this.checker = ts
+            .createProgram([...this.sources.keys()], options, host)
+            .getTypeChecker();
+    }
+    collect(file, roots) {
+        const references = new Set();
+        const nodes = new Map();
+        const visited = new Set();
+        const symbols = new Set();
+        let complete = true;
+        const exported = (target, name) => {
+            const ast = this.sources.get(target)?.ast;
+            const symbol = ast && this.checker.getSymbolAtLocation(ast);
+            const value = symbol &&
+                this.checker
+                    .getExportsOfModule(symbol)
+                    .find((item) => item.name === name);
+            if (!value) {
+                complete = false;
+                return;
+            }
+            follow(value);
+        };
+        const imported = (declaration, name) => {
+            let statement = declaration;
+            while (statement &&
+                !ts.isImportDeclaration(statement) &&
+                !ts.isExportDeclaration(statement))
+                statement = statement.parent;
+            if (!statement ||
+                !statement.moduleSpecifier ||
+                !ts.isStringLiteralLike(statement.moduleSpecifier))
+                return false;
+            const specifier = statement.moduleSpecifier.text;
+            const target = this.resolutions.get(`${statement.getSourceFile().fileName}\0${specifier}`);
+            if (!target) {
+                if (/^[.#/]/.test(specifier))
+                    complete = false;
+                else
+                    references.add(specifier);
+            }
+            else if (name)
+                exported(target, name);
+            else
+                complete = false;
+            return true;
+        };
+        const follow = (symbol) => {
+            if (symbols.has(symbol))
+                return;
+            symbols.add(symbol);
+            for (const declaration of symbol.declarations ?? []) {
+                if (ts.isImportSpecifier(declaration) ||
+                    ts.isExportSpecifier(declaration)) {
+                    if (declaration.isTypeOnly)
+                        continue;
+                    if (imported(declaration, declaration.propertyName?.text ?? declaration.name.text))
+                        continue;
+                    if (symbol.flags & ts.SymbolFlags.Alias)
+                        follow(this.checker.getAliasedSymbol(symbol));
+                }
+                else if (ts.isImportClause(declaration)) {
+                    if (!declaration.isTypeOnly)
+                        imported(declaration, 'default');
+                }
+                else if (ts.isNamespaceImport(declaration)) {
+                    imported(declaration);
+                }
+                else if (this.sources.has(declaration.getSourceFile().fileName)) {
+                    visit(declaration);
+                }
+            }
+        };
+        const visit = (node) => {
+            if (visited.has(node) || ts.isTypeNode(node))
+                return;
+            visited.add(node);
+            const sourceFile = node.getSourceFile();
+            const selected = nodes.get(sourceFile.fileName) ?? new Set();
+            selected.add(node);
+            nodes.set(sourceFile.fileName, selected);
+            if (ts.isImportDeclaration(node) || ts.isExportDeclaration(node))
+                return;
+            if (ts.isVariableDeclaration(node) ||
+                ts.isParameter(node) ||
+                ts.isPropertyDeclaration(node)) {
+                if (node.initializer)
+                    visit(node.initializer);
+                return;
+            }
+            if (ts.isClassDeclaration(node) || ts.isClassExpression(node)) {
+                // Referring to a class does not mean all its methods are used.
+                for (const member of node.members)
+                    if (ts.isConstructorDeclaration(member) ||
+                        ts.isPropertyDeclaration(member))
+                        visit(member);
+                return;
+            }
+            if (ts.isPropertyAccessExpression(node) &&
+                ts.isIdentifier(node.expression)) {
+                const receiver = this.checker.getSymbolAtLocation(node.expression);
+                const namespace = receiver?.declarations?.find(ts.isNamespaceImport);
+                if (namespace) {
+                    imported(namespace, node.name.text);
+                    return;
+                }
+            }
+            if (ts.isIdentifier(node)) {
+                const symbol = this.checker.getSymbolAtLocation(node);
+                if (symbol)
+                    follow(symbol);
+            }
+            if (ts.isCallExpression(node) &&
+                node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+                const argument = node.arguments[0];
+                if (argument && ts.isStringLiteralLike(argument)) {
+                    const target = this.resolutions.get(`${sourceFile.fileName}\0${argument.text}`);
+                    if (target)
+                        exported(target, 'default');
+                    else if (/^[.#/]/.test(argument.text))
+                        complete = false;
+                    else
+                        references.add(argument.text);
+                }
+                else
+                    complete = false;
+            }
+            ts.forEachChild(node, (child) => {
+                // A nested helper declaration is not a call. Follow it only when a value reference reaches it.
+                if (!ts.isFunctionDeclaration(child))
+                    visit(child);
+            });
+        };
+        if (roots)
+            roots.forEach(visit);
+        else
+            exported(file, 'default');
+        return { references, nodes, complete };
+    }
+    symbol(node) {
+        return this.checker.getSymbolAtLocation(node);
+    }
+}
+//# sourceMappingURL=source-evidence.js.map

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

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

package/dist/server/tokens.d.ts

@@ -0,0 +1,12 @@
+import { type ServiceToken } from '@nocobase/service-provider';
+import type { FoundationOverview } from '../shared/foundation.js';
+export interface FoundationOverviewOptions {
+    /** Collects again instead of answering a result younger than the cache lifetime. */
+    readonly refresh?: boolean;
+}
+/** What the application uses of NocoBase Core, collected by this plugin alone. Read-only. */
+export interface FoundationService {
+    overview(options?: FoundationOverviewOptions): Promise<FoundationOverview>;
+}
+export declare const foundationServiceToken: ServiceToken<FoundationService>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/server/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../server/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,6FAA6F;AAC7F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5E;AAED,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,iBAAiB,CAGhE,CAAC"}

package/dist/server/tokens.js

@@ -0,0 +1,3 @@
+import { createServiceToken, } from '@nocobase/service-provider';
+export const foundationServiceToken = createServiceToken('@nocobase/app-plugin-foundation/service');
+//# sourceMappingURL=tokens.js.map

package/dist/server/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../server/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAEnB,MAAM,4BAA4B,CAAC;AAcpC,MAAM,CAAC,MAAM,sBAAsB,GACjC,kBAAkB,CAChB,yCAAyC,CAC1C,CAAC"}

package/dist/shared/available-capabilities.d.ts

@@ -0,0 +1,6 @@
+import type { FoundationCapability, FoundationOverview, FoundationProviderInventory } from './foundation.js';
+/** Show recognized installed capabilities as well as current runtime capabilities; installation never proves use. */
+export declare function availableCapabilities(observations: readonly FoundationCapability[], inventory: FoundationProviderInventory): readonly FoundationCapability[];
+/** Client-only registrations are added to the same model without changing server usage evidence. */
+export declare function withAvailableCapabilities(overview: FoundationOverview, inventory: FoundationProviderInventory): FoundationOverview;
+//# sourceMappingURL=available-capabilities.d.ts.map

package/dist/shared/available-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"available-capabilities.d.ts","sourceRoot":"","sources":["../../shared/available-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AASzB,qHAAqH;AACrH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,oBAAoB,EAAE,EAC7C,SAAS,EAAE,2BAA2B,GACrC,SAAS,oBAAoB,EAAE,CA2DjC;AAED,oGAAoG;AACpG,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,2BAA2B,GACrC,kBAAkB,CASpB"}