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

package/dist/server/capabilities/platform.js

@@ -0,0 +1,143 @@
+import { cachingToken } from '@nocobase/app-server/caching';
+import { i18nToken } from '@nocobase/app-server/i18n';
+import { jobExecutorServiceToken } from '@nocobase/app-server/jobs';
+import { queueServiceToken } from '@nocobase/app-server/queue';
+import { secretsServiceToken } from '@nocobase/app-server/secrets';
+import { fact, metric, NO_DATABASE, } from './types.js';
+export const integrations = {
+    key: 'integrations',
+    packages: ['@nocobase/app-plugin-api-keys'],
+    async collect({ probe }) {
+        if (!probe)
+            return NO_DATABASE;
+        if (!probe.has('apikey'))
+            return { status: 'unused', reason: 'notRegistered' };
+        const [enabled, used] = await Promise.all([
+            probe.count('apikey', { enabled: true }),
+            // A key someone has called the API with; holding one proves nothing about an integration.
+            probe.count('apikey', (filter) => filter.and([
+                filter.boolean('enabled').isTrue(),
+                filter.date('lastRequest').notEmpty(),
+            ])),
+        ]);
+        const active = (used ?? 0) > 0;
+        return {
+            status: active ? 'active' : 'unused',
+            ...(active
+                ? {}
+                : { reason: (enabled ?? 0) > 0 ? 'noUsedApiKey' : 'noApiKey' }),
+            facts: active ? [fact('usedApiKeys', { count: used ?? 0 })] : [],
+            metrics: [metric('usedApiKeys', used), metric('apiKeys', enabled)],
+        };
+    },
+};
+/**
+ * What the server can tell about the interface: whether the NocoBase client serves it and which languages the
+ * application offers. The page adds the pages and menu entries it registers, which only the browser knows.
+ */
+export const userInterface = {
+    key: 'interface',
+    packages: [
+        '@nocobase/app-client',
+        '@nocobase/i18n',
+        '@nocobase/app-plugin-i18n',
+    ],
+    collect({ container, hasClient }) {
+        if (!hasClient)
+            return Promise.resolve({ status: 'unused', reason: 'noClient' });
+        const locales = container.has(i18nToken)
+            ? container.resolve(i18nToken).getLocales()
+            : undefined;
+        return Promise.resolve({
+            status: 'active',
+            facts: locales === undefined
+                ? []
+                : [fact('locales', { count: locales.length, names: [...locales] })],
+            metrics: locales === undefined ? [] : [metric('locales', locales.length)],
+        });
+    },
+};
+export const audit = {
+    key: 'audit',
+    packages: [],
+    collect() {
+        // No supported audit collector exists yet. Other providers may supply audit capabilities; do not claim their
+        // absence or use lifecycle history as a substitute for an operation audit.
+        return Promise.resolve({ status: 'unused', reason: 'noRecognizedAudit' });
+    },
+};
+/** The migration history the database layer keeps (`DEFAULT_MIGRATION_TABLE` in `@nocobase/db`). */
+const MIGRATIONS_TABLE = '__nocobase_migrations';
+const SEEDS_TABLE = '__nocobase_seeds';
+const INFRASTRUCTURE = [
+    { key: 'jobs', token: jobExecutorServiceToken },
+    { key: 'queue', token: queueServiceToken },
+    { key: 'secrets', token: secretsServiceToken },
+    { key: 'caching', token: cachingToken },
+];
+export const operations = {
+    key: 'operations',
+    packages: [
+        '@nocobase/app-server',
+        '@nocobase/app-cli',
+        '@nocobase/jobs',
+        '@nocobase/queue',
+        '@nocobase/caching',
+        '@nocobase/secrets',
+    ],
+    async collect({ probe, container, applicationName }) {
+        const parts = INFRASTRUCTURE.map(({ key, token }) => container.has(token)
+            ? { key, status: 'active' }
+            : { key, status: 'unused', reason: 'notConfigured' });
+        if (!probe)
+            return { ...NO_DATABASE, parts };
+        const [migrations, ownMigrations, seeds, latest] = await Promise.all([
+            probe.internalCount(MIGRATIONS_TABLE),
+            applicationName === undefined
+                ? Promise.resolve(null)
+                : probe.internalCount(MIGRATIONS_TABLE, {
+                    column: 'package_name',
+                    value: applicationName,
+                }),
+            probe.internalCount(SEEDS_TABLE),
+            probe.internalMax(MIGRATIONS_TABLE, 'executed_at'),
+        ]);
+        const latestAt = toIsoTime(latest);
+        return {
+            status: 'active',
+            facts: [
+                ...(migrations === null
+                    ? []
+                    : [
+                        fact('migrations', {
+                            count: migrations,
+                            own: ownMigrations ?? 0,
+                        }),
+                    ]),
+                ...(latestAt === undefined
+                    ? []
+                    : [fact('latestMigration', { at: latestAt })]),
+            ],
+            metrics: [
+                metric('migrations', migrations),
+                metric('applicationMigrations', ownMigrations),
+                metric('seeds', seeds),
+            ],
+            parts: [{ key: 'migrations', status: 'active' }, ...parts],
+        };
+    },
+};
+/** The history stores times as epoch milliseconds or as a date string, depending on the dialect. */
+function toIsoTime(value) {
+    const time = value instanceof Date
+        ? value.getTime()
+        : typeof value === 'number'
+            ? value
+            : typeof value === 'string'
+                ? /^\d+$/.test(value)
+                    ? Number(value)
+                    : Date.parse(value)
+                : Number.NaN;
+    return Number.isFinite(time) ? new Date(time).toISOString() : undefined;
+}
+//# sourceMappingURL=platform.js.map

package/dist/server/capabilities/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../../server/capabilities/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,EACL,IAAI,EACJ,MAAM,EACN,WAAW,GAEZ,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,YAAY,GAAwB;IAC/C,GAAG,EAAE,cAAc;IACnB,QAAQ,EAAE,CAAC,+BAA+B,CAAC;IAC3C,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE;QACrB,IAAI,CAAC,KAAK;YAAE,OAAO,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QACvD,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACxC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACxC,0FAA0F;YAC1F,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAC/B,MAAM,CAAC,GAAG,CAAC;gBACT,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE;gBAClC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;aACtC,CAAC,CACH;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YACpC,GAAG,CAAC,MAAM;gBACR,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;YACjE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YAChE,OAAO,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;SACnE,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,GAAG,EAAE,WAAW;IAChB,QAAQ,EAAE;QACR,sBAAsB;QACtB,gBAAgB;QAChB,2BAA2B;KAC5B;IACD,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE;QAC9B,IAAI,CAAC,SAAS;YACZ,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;YACtC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE;YAC3C,CAAC,CAAC,SAAS,CAAC;QACd,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,MAAM,EAAE,QAAQ;YAChB,KAAK,EACH,OAAO,KAAK,SAAS;gBACnB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;SAC1E,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAwB;IACxC,GAAG,EAAE,OAAO;IACZ,QAAQ,EAAE,EAAE;IACZ,OAAO;QACL,6GAA6G;QAC7G,2EAA2E;QAC3E,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF,CAAC;AAEF,oGAAoG;AACpG,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAEvC,MAAM,cAAc,GAGd;IACJ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,EAAE;IAC/C,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC1C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,EAAE;IAC9C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,GAAG,EAAE,YAAY;IACjB,QAAQ,EAAE;QACR,sBAAsB;QACtB,mBAAmB;QACnB,gBAAgB;QAChB,iBAAiB;QACjB,mBAAmB;QACnB,mBAAmB;KACpB;IACD,KAAK,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE;QACjD,MAAM,KAAK,GAAqB,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CACpE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAClB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE;YAC3B,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,CACvD,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,GAAG,WAAW,EAAE,KAAK,EAAE,CAAC;QAC7C,MAAM,CAAC,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnE,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC;YACrC,eAAe,KAAK,SAAS;gBAC3B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBACvB,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,gBAAgB,EAAE;oBACpC,MAAM,EAAE,cAAc;oBACtB,KAAK,EAAE,eAAe;iBACvB,CAAC;YACN,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC;YAChC,KAAK,CAAC,WAAW,CAAC,gBAAgB,EAAE,aAAa,CAAC;SACnD,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE;gBACL,GAAG,CAAC,UAAU,KAAK,IAAI;oBACrB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC;wBACE,IAAI,CAAC,YAAY,EAAE;4BACjB,KAAK,EAAE,UAAU;4BACjB,GAAG,EAAE,aAAa,IAAI,CAAC;yBACxB,CAAC;qBACH,CAAC;gBACN,GAAG,CAAC,QAAQ,KAAK,SAAS;oBACxB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;aACjD;YACD,OAAO,EAAE;gBACP,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC;gBAChC,MAAM,CAAC,uBAAuB,EAAE,aAAa,CAAC;gBAC9C,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;aACvB;YACD,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC;SAC3D,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,oGAAoG;AACpG,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,IAAI,GACR,KAAK,YAAY,IAAI;QACnB,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE;QACjB,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;oBACnB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBACf,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;gBACrB,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IACrB,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC"}

package/dist/server/capabilities/processes.d.ts

@@ -0,0 +1,3 @@
+import { type CapabilityCollector } from './types.js';
+export declare const workflows: CapabilityCollector;
+//# sourceMappingURL=processes.d.ts.map

package/dist/server/capabilities/processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes.d.ts","sourceRoot":"","sources":["../../../server/capabilities/processes.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,SAAS,EAAE,mBAyFvB,CAAC"}

package/dist/server/capabilities/processes.js

@@ -0,0 +1,86 @@
+import { countOf, fact, metric, NO_DATABASE, } from './types.js';
+export const workflows = {
+    key: 'workflows',
+    packages: ['@nocobase/lifecycle', '@nocobase/app-plugin-scheduler'],
+    async collect({ probe }) {
+        if (!probe)
+            return NO_DATABASE;
+        const findings = [];
+        const parts = [];
+        // The lifecycle store's two Collections exist once the application persists its lifecycles, which is the
+        // integration itself: a lifecycle nobody has moved yet is still in use.
+        if (probe.has('lifecycleTransitions')) {
+            const byLifecycle = await probe.groupCount('lifecycleTransitions', 'lifecycle');
+            const effects = probe.has('lifecycleEffectRuns')
+                ? await probe.groupCount('lifecycleEffectRuns', 'status')
+                : new Map();
+            const transitions = byLifecycle === null
+                ? null
+                : [...byLifecycle.values()].reduce((sum, count) => sum + count, 0);
+            parts.push({ key: 'lifecycles', status: 'active' });
+            findings.push({
+                status: 'active',
+                facts: [
+                    byLifecycle === null || byLifecycle.size === 0
+                        ? fact('lifecyclesWithoutTransitions')
+                        : fact('lifecycles', {
+                            count: byLifecycle.size,
+                            names: [...byLifecycle.keys()],
+                            transitions: transitions ?? 0,
+                        }),
+                ],
+                metrics: [
+                    metric('transitions', transitions),
+                    metric('lifecycles', byLifecycle?.size ?? null),
+                    metric('effectsSucceeded', countOf(effects, ['succeeded'])),
+                    metric('effectsFailed', countOf(effects, ['failed', 'dead'])),
+                    metric('effectsPending', countOf(effects, ['queued', 'running'])),
+                ],
+            });
+        }
+        else {
+            parts.push({
+                key: 'lifecycles',
+                status: 'unused',
+                reason: 'notRegistered',
+            });
+        }
+        if (probe.has('scheduleDefinitions')) {
+            const enabled = await probe.count('scheduleDefinitions', {
+                enabled: true,
+            });
+            const occurrences = probe.has('scheduleOccurrences')
+                ? await probe.count('scheduleOccurrences')
+                : null;
+            const active = (enabled ?? 0) > 0;
+            parts.push(active
+                ? { key: 'schedules', status: 'active' }
+                : { key: 'schedules', status: 'unused', reason: 'noSchedules' });
+            if (active)
+                findings.push({
+                    status: 'active',
+                    facts: [fact('schedules', { count: enabled ?? 0 })],
+                    metrics: [
+                        metric('schedules', enabled),
+                        metric('scheduleOccurrences', occurrences),
+                    ],
+                });
+        }
+        else {
+            parts.push({
+                key: 'schedules',
+                status: 'unused',
+                reason: 'notRegistered',
+            });
+        }
+        if (findings.length === 0)
+            return { status: 'unused', reason: 'noWorkflows', parts };
+        return {
+            status: 'active',
+            facts: findings.flatMap((finding) => finding.facts ?? []),
+            metrics: findings.flatMap((finding) => finding.metrics ?? []),
+            parts,
+        };
+    },
+};
+//# sourceMappingURL=processes.js.map

package/dist/server/capabilities/processes.js.map

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

package/dist/server/capabilities/types.d.ts

@@ -0,0 +1,38 @@
+import type { AppConfigAccessor } from '@nocobase/app-server/config';
+import type { ServiceContainer } from '@nocobase/service-provider';
+import type { FoundationCapabilityKey, FoundationFact, FoundationMetric, FoundationMetricUnit, FoundationPart, FoundationStatus } from '../../shared/foundation.js';
+import type { Probe } from '../inventory.js';
+export interface CollectorContext {
+    /** Reads of the default connection; absent when the application runs without a database. */
+    readonly probe: Probe | undefined;
+    readonly container: ServiceContainer;
+    readonly config: Pick<AppConfigAccessor, 'get'>;
+    /** The application's package name, which its own migrations are recorded under. */
+    readonly applicationName: string | undefined;
+    /** Whether the application ships a client the NocoBase client runtime serves. */
+    readonly hasClient: boolean;
+}
+/** What one capability's collector established. The service adds packages, completeness and issues. */
+export interface CapabilityFindings {
+    readonly status: FoundationStatus;
+    readonly reason?: string;
+    readonly facts?: readonly FoundationFact[];
+    readonly metrics?: readonly FoundationMetric[];
+    readonly parts?: readonly FoundationPart[];
+}
+export interface CapabilityCollector {
+    readonly key: FoundationCapabilityKey;
+    /** The NocoBase packages that provide it; only those the application resolves are reported. */
+    readonly packages: readonly string[];
+    collect(context: CollectorContext): Promise<CapabilityFindings>;
+}
+export declare function metric(key: string, value: number | null, options?: {
+    readonly unit?: FoundationMetricUnit;
+    readonly complete?: boolean;
+}): FoundationMetric;
+export declare function fact(code: string, params?: FoundationFact['params']): FoundationFact;
+/** Sums the counts of the given keys in a per-status map. */
+export declare function countOf(groups: ReadonlyMap<string, number> | null, keys: readonly string[]): number | null;
+/** A capability whose evidence lives in a database the application runs without. */
+export declare const NO_DATABASE: CapabilityFindings;
+//# sourceMappingURL=types.d.ts.map

package/dist/server/capabilities/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../server/capabilities/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAChD,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,uGAAuG;AACvG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,uBAAuB,CAAC;IACtC,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjE;AAED,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,OAAO,GAAE;IACP,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACxB,GACL,gBAAgB,CAOlB;AAED,wBAAgB,IAAI,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GAChC,cAAc,CAEhB;AAED,6DAA6D;AAC7D,wBAAgB,OAAO,CACrB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,EAC1C,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,GAAG,IAAI,CAGf;AAED,oFAAoF;AACpF,eAAO,MAAM,WAAW,EAAE,kBAGzB,CAAC"}

package/dist/server/capabilities/types.js

@@ -0,0 +1,23 @@
+export function metric(key, value, options = {}) {
+    return {
+        key,
+        value,
+        unit: options.unit ?? 'count',
+        complete: value !== null && (options.complete ?? true),
+    };
+}
+export function fact(code, params) {
+    return params === undefined ? { code } : { code, params };
+}
+/** Sums the counts of the given keys in a per-status map. */
+export function countOf(groups, keys) {
+    if (groups === null)
+        return null;
+    return keys.reduce((sum, key) => sum + (groups.get(key) ?? 0), 0);
+}
+/** A capability whose evidence lives in a database the application runs without. */
+export const NO_DATABASE = {
+    status: 'unused',
+    reason: 'noDatabase',
+};
+//# sourceMappingURL=types.js.map

package/dist/server/capabilities/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../server/capabilities/types.ts"],"names":[],"mappings":"AAwCA,MAAM,UAAU,MAAM,CACpB,GAAW,EACX,KAAoB,EACpB,UAGI,EAAE;IAEN,OAAO;QACL,GAAG;QACH,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO;QAC7B,QAAQ,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,IAAY,EACZ,MAAiC;IAEjC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5D,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,OAAO,CACrB,MAA0C,EAC1C,IAAuB;IAEvB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC7C,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,YAAY;CACrB,CAAC"}

package/dist/server/catalog.d.ts

@@ -0,0 +1,3 @@
+/** The NocoBase package that keeps a Collection, or `undefined` for one of the application's own. */
+export declare function systemCollectionOwner(name: string): string | undefined;
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../server/catalog.ts"],"names":[],"mappings":"AAqDA,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE"}

package/dist/server/catalog.js

@@ -0,0 +1,44 @@
+const SYSTEM_COLLECTION_OWNERS = [
+    {
+        // Better Auth's own tables, under the names it gives them.
+        packageName: '@nocobase/app-plugin-authentication',
+        names: ['user', 'account', 'session', 'verification', 'deviceCode', 'jwks'],
+    },
+    {
+        packageName: '@nocobase/app-plugin-api-keys',
+        names: ['apikey'],
+    },
+    {
+        packageName: '@nocobase/app-plugin-users',
+        names: ['userInvitations', 'userPreferences'],
+    },
+    {
+        packageName: '@nocobase/app-plugin-authorization',
+        pattern: /^authorization[A-Z]/,
+    },
+    { packageName: '@nocobase/app-plugin-mail', pattern: /^mail[A-Z]/ },
+    {
+        packageName: '@nocobase/app-plugin-notification',
+        pattern: /^notification[A-Z]/,
+    },
+    { packageName: '@nocobase/app-plugin-scheduler', pattern: /^schedule[A-Z]/ },
+    {
+        // The library ships no migration: the application that runs lifecycles creates these two under these names.
+        packageName: '@nocobase/lifecycle',
+        names: ['lifecycleTransitions', 'lifecycleEffectRuns'],
+    },
+    { packageName: '@nocobase/app-plugin-agents', pattern: /^ag[A-Z]/ },
+    {
+        packageName: '@nocobase/app-plugin-agent-sessions',
+        pattern: /^agentSession/,
+    },
+    { packageName: '@nocobase/app-plugin-knowledge', pattern: /^kb[A-Z]/ },
+    { packageName: '@nocobase/app-plugin-projects', pattern: /^pm[A-Z]/ },
+    { packageName: '@nocobase/app-plugin-releases', pattern: /^rel[A-Z]/ },
+];
+/** The NocoBase package that keeps a Collection, or `undefined` for one of the application's own. */
+export function systemCollectionOwner(name) {
+    return SYSTEM_COLLECTION_OWNERS.find((owner) => owner.names?.includes(name) === true ||
+        owner.pattern?.test(name) === true)?.packageName;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/server/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../server/catalog.ts"],"names":[],"mappings":"AAcA,MAAM,wBAAwB,GAAqC;IACjE;QACE,2DAA2D;QAC3D,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,CAAC;KAC5E;IACD;QACE,WAAW,EAAE,+BAA+B;QAC5C,KAAK,EAAE,CAAC,QAAQ,CAAC;KAClB;IACD;QACE,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;KAC9C;IACD;QACE,WAAW,EAAE,oCAAoC;QACjD,OAAO,EAAE,qBAAqB;KAC/B;IACD,EAAE,WAAW,EAAE,2BAA2B,EAAE,OAAO,EAAE,YAAY,EAAE;IACnE;QACE,WAAW,EAAE,mCAAmC;QAChD,OAAO,EAAE,oBAAoB;KAC9B;IACD,EAAE,WAAW,EAAE,gCAAgC,EAAE,OAAO,EAAE,gBAAgB,EAAE;IAC5E;QACE,4GAA4G;QAC5G,WAAW,EAAE,qBAAqB;QAClC,KAAK,EAAE,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;KACvD;IACD,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,UAAU,EAAE;IACnE;QACE,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,eAAe;KACzB;IACD,EAAE,WAAW,EAAE,gCAAgC,EAAE,OAAO,EAAE,UAAU,EAAE;IACtE,EAAE,WAAW,EAAE,+BAA+B,EAAE,OAAO,EAAE,UAAU,EAAE;IACrE,EAAE,WAAW,EAAE,+BAA+B,EAAE,OAAO,EAAE,WAAW,EAAE;CACvE,CAAC;AAEF,qGAAqG;AACrG,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,wBAAwB,CAAC,IAAI,CAClC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI;QACpC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CACrC,EAAE,WAAW,CAAC;AACjB,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './plugin.js';
+export { foundationServiceToken, type FoundationOverviewOptions, type FoundationService, } from './tokens.js';
+export { DefaultFoundationService, type FoundationServiceOptions, } from './services/foundation.js';
+export { systemCollectionOwner } from './catalog.js';
+export type * from '../shared/foundation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,mBAAmB,yBAAyB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,5 @@
+export { default } from './plugin.js';
+export { foundationServiceToken, } from './tokens.js';
+export { DefaultFoundationService, } from './services/foundation.js';
+export { systemCollectionOwner } from './catalog.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,sBAAsB,GAGvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/server/inventory.d.ts

@@ -0,0 +1,48 @@
+import type { CollectionDefinition, DatabaseManager, RepositoryFilter, RepositoryRecord } from '@nocobase/db';
+import type { FoundationIssue } from '../shared/foundation.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[];
+    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): Promise<Inventory>;
+    has(name: string): boolean;
+    definition(name: string): 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 issues: FoundationIssue[];
+    constructor(inventory: Inventory);
+    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;
+}
+/** 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":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG,OAAO,CACrC,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAC/D,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnB,wGAAwG;AACxG,qBAAa,SAAS;aAOF,QAAQ,EAAE,eAAe;aACzB,WAAW,EAAE,SAAS,iBAAiB,EAAE;IAP3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IAEJ,OAAO;IAKP,wGAAwG;WACpF,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAahE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;CAQ3E;AAED;;;GAGG;AACH,qBAAa,KAAK;aAGmB,SAAS,EAAE,SAAS;IAFvD,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAM;gBAEZ,SAAS,EAAE,SAAS;IAEhD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAOjE,KAAK,CACV,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAC1C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQzB,mEAAmE;IAC5D,UAAU,CACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAcvC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW/D,4GAA4G;IACrG,OAAO,CACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAO,GACd,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;IAqBrD;;;OAGG;IACI,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYlB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAWrD,IAAI;CAkBnB;AAYD,6EAA6E;AAC7E,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CASA"}

package/dist/server/inventory.js

@@ -0,0 +1,158 @@
+/** The Collections of the default connection, read once per overview and shared by every capability. */
+export class Inventory {
+    database;
+    collections;
+    definitions = new Map();
+    constructor(database, collections) {
+        this.database = database;
+        this.collections = collections;
+    }
+    /** Lists every Collection of the default connection. Throws when the database cannot be read at all. */
+    static async read(database) {
+        const collections = [];
+        let cursor;
+        do {
+            const page = await database
+                .collections()
+                .list({ limit: 500, ...(cursor === undefined ? {} : { cursor }) });
+            collections.push(...page.items);
+            cursor = page.nextCursor;
+        } while (cursor !== undefined);
+        return new Inventory(database, collections);
+    }
+    has(name) {
+        return this.collections.some((collection) => collection.name === name);
+    }
+    definition(name) {
+        let pending = this.definitions.get(name);
+        if (!pending) {
+            pending = this.database.collections().get(name);
+            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;
+    issues = [];
+    constructor(inventory) {
+        this.inventory = inventory;
+    }
+    has(name) {
+        return this.inventory.has(name);
+    }
+    async fieldNames(name) {
+        return this.read(name, async () => {
+            const definition = await this.inventory.definition(name);
+            return (definition?.fields ?? []).map((field) => field.name);
+        });
+    }
+    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) {
+                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 run();
+        }
+        catch {
+            // The cause is not kept: a driver's error can quote the host, database and account it failed to reach.
+            if (!this.issues.some((issue) => issue.code === 'SOURCE_UNREADABLE' && issue.source === source))
+                this.issues.push({ code: 'SOURCE_UNREADABLE', source });
+            return null;
+        }
+    }
+}
+/** 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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"}