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

package/dist/server/inventory.d.ts

@@ -0,0 +1,54 @@
+import type { CollectionDefinition, DatabaseManager, RepositoryFilter, RepositoryRecord } from '@nocobase/db';
+import type { FoundationIssue } from '../shared/foundation.js';
+import { ReadQueue } from './read-queue.js';
+/** One Collection as the default connection lists it: logical name, table, kind and title. */
+export type CollectionSummary = Awaited<ReturnType<ReturnType<DatabaseManager['collections']>['list']>>['items'][number];
+/** The Collections of the default connection, read once per overview and shared by every capability. */
+export declare class Inventory {
+    readonly database: DatabaseManager;
+    readonly collections: readonly CollectionSummary[];
+    readonly reads: ReadQueue;
+    private readonly definitions;
+    private constructor();
+    /** Lists every Collection of the default connection. Throws when the database cannot be read at all. */
+    static read(database: DatabaseManager, reads?: ReadQueue, signal?: AbortSignal): Promise<Inventory>;
+    has(name: string): boolean;
+    definition(name: string, signal?: AbortSignal): Promise<CollectionDefinition | undefined>;
+}
+/**
+ * Reads for one capability. Every read answers `null` instead of throwing and records what it could not read, so one
+ * unreadable source leaves the rest of the capability standing and is never mistaken for zero.
+ */
+export declare class Probe {
+    readonly inventory: Inventory;
+    readonly signal: AbortSignal | undefined;
+    readonly issues: FoundationIssue[];
+    constructor(inventory: Inventory, signal?: AbortSignal | undefined);
+    /** Schedule only a small number of table operations, and stop dispatching when the collector expires. */
+    map<T, R>(items: readonly T[], read: (item: T) => Promise<R>): Promise<R[]>;
+    has(name: string): boolean;
+    fieldNames(name: string): Promise<readonly string[] | null>;
+    count(name: string, filter?: RepositoryFilter<RepositoryRecord>): Promise<number | null>;
+    /** Records per value of `field`, such as deliveries per status. */
+    groupCount(name: string, field: string): Promise<ReadonlyMap<string, number> | null>;
+    sum(name: string, field: string): Promise<number | null>;
+    /** Read configuration Collections in stable pages; never present a truncated prefix as a complete total. */
+    records(name: string, pageSize?: number): Promise<readonly Record<string, unknown>[] | null>;
+    /**
+     * Rows of a table the database layer keeps for itself, such as the migration history, which no Collection
+     * describes.
+     */
+    internalCount(table: string, where?: {
+        readonly column: string;
+        readonly value: string;
+    }): Promise<number | null>;
+    internalMax(table: string, column: string): Promise<unknown>;
+    private read;
+    private unreadable;
+}
+/** Adds counts, keeping track of whether every one of them could be read. */
+export declare function total(values: readonly (number | null)[]): {
+    readonly value: number | null;
+    readonly complete: boolean;
+};
+//# sourceMappingURL=inventory.d.ts.map

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

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

package/dist/server/inventory.js

@@ -0,0 +1,184 @@
+import { ReadQueue } from './read-queue.js';
+/** The Collections of the default connection, read once per overview and shared by every capability. */
+export class Inventory {
+    database;
+    collections;
+    reads;
+    definitions = new Map();
+    constructor(database, collections, reads) {
+        this.database = database;
+        this.collections = collections;
+        this.reads = reads;
+    }
+    /** Lists every Collection of the default connection. Throws when the database cannot be read at all. */
+    static async read(database, reads = new ReadQueue(), signal) {
+        const collections = [];
+        let cursor;
+        do {
+            const page = await reads.run(() => database
+                .collections()
+                .list({ limit: 500, ...(cursor === undefined ? {} : { cursor }) }), signal);
+            collections.push(...page.items);
+            cursor = page.nextCursor;
+        } while (cursor !== undefined);
+        return new Inventory(database, collections, reads);
+    }
+    has(name) {
+        return this.collections.some((collection) => collection.name === name);
+    }
+    definition(name, signal) {
+        let pending = this.definitions.get(name);
+        if (!pending) {
+            pending = this.reads.run(() => this.database.collections().get(name), signal);
+            this.definitions.set(name, pending);
+        }
+        return pending;
+    }
+}
+/**
+ * Reads for one capability. Every read answers `null` instead of throwing and records what it could not read, so one
+ * unreadable source leaves the rest of the capability standing and is never mistaken for zero.
+ */
+export class Probe {
+    inventory;
+    signal;
+    issues = [];
+    constructor(inventory, signal = undefined) {
+        this.inventory = inventory;
+        this.signal = signal;
+    }
+    /** Schedule only a small number of table operations, and stop dispatching when the collector expires. */
+    async map(items, read) {
+        const results = new Array(items.length);
+        let next = 0;
+        await Promise.all(Array.from({ length: Math.min(4, items.length) }, async () => {
+            while (next < items.length) {
+                this.signal?.throwIfAborted();
+                const index = next++;
+                results[index] = await read(items[index]);
+            }
+        }));
+        return results;
+    }
+    has(name) {
+        return this.inventory.has(name);
+    }
+    async fieldNames(name) {
+        try {
+            const definition = await this.inventory.definition(name, this.signal);
+            return (definition?.fields ?? []).map((field) => field.name);
+        }
+        catch {
+            this.unreadable(name);
+            return null;
+        }
+    }
+    count(name, filter) {
+        return this.read(name, () => this.inventory.database
+            .repository(name)
+            .count(filter === undefined ? {} : { filter }));
+    }
+    /** Records per value of `field`, such as deliveries per status. */
+    groupCount(name, field) {
+        return this.read(name, async () => {
+            const groups = await this.inventory.database
+                .repository(name)
+                .groupBy({
+                by: [field],
+                aggregate: (aggregate) => ({ count: aggregate.count() }),
+            });
+            return new Map(groups.map((group) => [groupKey(group[field]), Number(group.count)]));
+        });
+    }
+    sum(name, field) {
+        return this.read(name, async () => {
+            const result = await this.inventory.database
+                .repository(name)
+                .aggregate({
+                aggregate: (aggregate) => ({ total: aggregate.sum(field) }),
+            });
+            return Number(result.total ?? 0);
+        });
+    }
+    /** Read configuration Collections in stable pages; never present a truncated prefix as a complete total. */
+    records(name, pageSize = 1000) {
+        return this.read(name, async () => {
+            if (!Number.isSafeInteger(pageSize) || pageSize < 1)
+                throw new RangeError('Configuration page size must be a positive integer.');
+            const records = [];
+            const repository = this.inventory.database.repository(name);
+            for (let offset = 0;; offset += pageSize) {
+                this.signal?.throwIfAborted();
+                const page = await repository.findMany({
+                    limit: pageSize,
+                    offset,
+                    sort: (sort) => sort.field('id').asc(),
+                });
+                records.push(...page);
+                if (page.length < pageSize)
+                    return records;
+            }
+        });
+    }
+    /**
+     * Rows of a table the database layer keeps for itself, such as the migration history, which no Collection
+     * describes.
+     */
+    internalCount(table, where) {
+        return this.read(table, async () => {
+            let query = this.inventory.database
+                .query()
+                .selectFrom(table)
+                .select((expression) => [expression.fn.countAll().as('count')]);
+            if (where)
+                query = query.where(where.column, '=', where.value);
+            const row = await query.executeTakeFirst();
+            return Number(row?.count ?? 0);
+        });
+    }
+    internalMax(table, column) {
+        return this.read(table, async () => {
+            const row = await this.inventory.database
+                .query()
+                .selectFrom(table)
+                .select((expression) => [expression.fn.max(column).as('latest')])
+                .executeTakeFirst();
+            return row?.latest ?? null;
+        });
+    }
+    async read(source, run) {
+        try {
+            return await this.inventory.reads.run(run, this.signal);
+        }
+        catch {
+            // The cause is not kept: a driver's error can quote the host, database and account it failed to reach.
+            this.unreadable(source);
+            return null;
+        }
+    }
+    unreadable(source) {
+        if (!this.issues.some((issue) => issue.code === 'SOURCE_UNREADABLE' && issue.source === source))
+            this.issues.push({ code: 'SOURCE_UNREADABLE', source });
+    }
+}
+/** A grouped value as a map key: statuses and names are strings, an absent value is the empty string. */
+function groupKey(value) {
+    if (value === null || value === undefined)
+        return '';
+    return typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean'
+        ? String(value)
+        : JSON.stringify(value);
+}
+/** Adds counts, keeping track of whether every one of them could be read. */
+export function total(values) {
+    const known = values.filter((value) => value !== null);
+    return {
+        value: known.length === 0 && values.length > 0
+            ? null
+            : known.reduce((sum, value) => sum + value, 0),
+        complete: known.length === values.length,
+    };
+}
+//# sourceMappingURL=inventory.js.map

package/dist/server/inventory.js.map

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

package/dist/server/module-manifest.d.ts

@@ -0,0 +1,10 @@
+import type { FoundationModuleSources } from '../shared/foundation.js';
+export declare const MODULE_MANIFEST_FILE: string;
+/** Deployment metadata contains association evidence only, never source text or filesystem locations. */
+export declare function readModuleManifest(rootDir: string, packageName: string): Promise<FoundationModuleSources | undefined>;
+/** Repeat builds converge on the same bytes; replace the artifact only after a complete write. */
+export declare function writeModuleManifest(rootDir: string): Promise<{
+    readonly routes: number;
+    readonly complete: boolean;
+}>;
+//# sourceMappingURL=module-manifest.d.ts.map

package/dist/server/module-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-manifest.d.ts","sourceRoot":"","sources":["../../server/module-manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,eAAO,MAAM,oBAAoB,EAAE,MAAkC,CAAC;AA2BtE,yGAAyG;AACzG,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAmB9C;AAED,kGAAkG;AAClG,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBlE"}

package/dist/server/module-manifest.js

@@ -0,0 +1,66 @@
+import { mkdir, readFile, rename, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+export const MODULE_MANIFEST_FILE = 'foundation-modules.json';
+const manifestSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    packageName: z.string(),
+    sources: z
+        .object({
+        complete: z.boolean(),
+        routes: z
+            .array(z
+            .object({
+            packageName: z.string(),
+            routeName: z.string(),
+            providers: z.array(z.string()),
+            apiProviders: z.array(z.string()).optional(),
+            collections: z.array(z.string()).optional(),
+            complete: z.boolean(),
+        })
+            .strict())
+            .max(10000),
+    })
+        .strict(),
+})
+    .strict();
+/** Deployment metadata contains association evidence only, never source text or filesystem locations. */
+export async function readModuleManifest(rootDir, packageName) {
+    const file = path.join(rootDir, 'server', MODULE_MANIFEST_FILE);
+    try {
+        if ((await stat(file)).size > 5_000_000)
+            return undefined;
+        const parsed = manifestSchema.safeParse(JSON.parse(await readFile(file, 'utf8')));
+        if (!parsed.success ||
+            parsed.data.packageName !== packageName ||
+            parsed.data.sources.routes.some((route) => route.packageName !== packageName))
+            return undefined;
+        return parsed.data.sources;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Repeat builds converge on the same bytes; replace the artifact only after a complete write. */
+export async function writeModuleManifest(rootDir) {
+    const { collectModuleSources } = await import('./module-sources.js');
+    const manifest = JSON.parse(await readFile(path.join(rootDir, 'package.json'), 'utf8'));
+    const sources = await collectModuleSources(rootDir);
+    const document = manifestSchema.parse({
+        schemaVersion: 1,
+        packageName: manifest.name,
+        sources,
+    });
+    const file = path.join(rootDir, 'dist', 'server', MODULE_MANIFEST_FILE);
+    const contents = JSON.stringify(document) + '\n';
+    await mkdir(path.dirname(file), { recursive: true });
+    const previous = await readFile(file, 'utf8').catch(() => undefined);
+    if (previous !== contents) {
+        const temporary = `${file}.${process.pid}.tmp`;
+        await writeFile(temporary, contents);
+        await rename(temporary, file);
+    }
+    return { routes: sources.routes.length, complete: sources.complete };
+}
+//# sourceMappingURL=module-manifest.js.map

package/dist/server/module-manifest.js.map

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

package/dist/server/module-sources.d.ts

@@ -0,0 +1,5 @@
+import type { FoundationModuleSources } from '../shared/foundation.js';
+import type { RuntimeProviderEvidence } from './provider-inventory.js';
+/** Reads static declarations and value imports only. Never imports an application module or invokes a loader. */
+export declare function collectModuleSources(rootDir: string, runtime?: readonly RuntimeProviderEvidence[]): Promise<FoundationModuleSources>;
+//# sourceMappingURL=module-sources.d.ts.map

package/dist/server/module-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-sources.d.ts","sourceRoot":"","sources":["../../server/module-sources.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAiBvE,iHAAiH;AACjH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,SAAS,uBAAuB,EAAO,GAC/C,OAAO,CAAC,uBAAuB,CAAC,CA+FlC"}