@nocobase/app-server 0.11.1-alpha.4 → 2.0.0-beta.1

package/dist/router/openapi/document.js

@@ -0,0 +1,471 @@
+import { generateSpecs, uniqueSymbol, } from 'hono-openapi';
+import { findTargetHandler, isMiddleware } from 'hono/utils/handler';
+import { apiNotFoundHandler } from '../api-error.js';
+import { apiDocumentBaseComponents, invalidInputDescription, invalidInputResponseName, } from './components.js';
+import { expandRepositoryOperations } from './repository-document.js';
+const httpMethods = [
+    'get',
+    'put',
+    'post',
+    'delete',
+    'options',
+    'head',
+    'patch',
+    'trace',
+];
+function isRouterSource(source) {
+    return 'apiRouter' in source;
+}
+function forwardedOf(source) {
+    return isRouterSource(source) ? source.forwardedApiRoutes : undefined;
+}
+function resolveApiRouter(source) {
+    const router = isRouterSource(source) ? source.apiRouter : source;
+    if (!router) {
+        throw new Error('The application has not registered its routes yet. Start it before inspecting its API.');
+    }
+    return router;
+}
+/** The `describeRoute()` declaration a handler carries, if it is one. */
+export function describeSpecOf(handler) {
+    const metadata = findTargetHandler(handler)[uniqueSymbol];
+    return metadata?.spec;
+}
+function pathPrefixOf(path) {
+    return path.endsWith('/*') ? path.slice(0, -2) : path;
+}
+/**
+ * Every endpoint of an API router with what `describeRoute()` declares for it, in registration order. The application's
+ * catch-all for unknown paths is not an endpoint and is left out. A declaration applied with `router.use()` counts for
+ * the paths below it, as it does in the document.
+ *
+ * For an application, or anything else carrying `forwardedApiRoutes`, the routes of every router registered with
+ * `addApiRouter` follow at their own prefix, judged the same way, and every endpoint registered with
+ * `addUndeclaredApiRoute` follows as undeclared.
+ */
+export function inspectApiRoutes(source, prefix = '/api') {
+    const declarations = inspectRouter(resolveApiRouter(source), prefix);
+    const forwarded = forwardedOf(source);
+    for (const registration of forwarded?.routers ?? []) {
+        const base = forwardedPath(registration);
+        for (const route of inspectRouter(registration.router, registration.prefix)) {
+            declarations.push(isForwardedTo(registration, route.path)
+                ? route
+                : {
+                    method: route.method,
+                    path: route.path,
+                    declared: false,
+                    hidden: false,
+                    reason: `Declared outside the forwarded path ${base}, which the dispatcher never forwards to this router.`,
+                });
+        }
+    }
+    for (const { method, path, reason } of forwarded?.undeclared ?? [])
+        declarations.push({
+            method,
+            path,
+            declared: false,
+            hidden: false,
+            ...(reason ? { reason } : {}),
+        });
+    return declarations;
+}
+/** The full path a dispatcher forwards to a registered router: its prefix followed by its scope. */
+export function forwardedPath(registration) {
+    return joinPath(registration.prefix, registration.scope ?? '/');
+}
+/** Whether the dispatcher forwards a request for `path`, a full path such as `/api/authorization/x`, to the router. */
+export function isForwardedTo(registration, path) {
+    const base = forwardedPath(registration);
+    return path === base || path.startsWith(base === '/' ? '/' : `${base}/`);
+}
+function joinPath(prefix, path) {
+    return `${prefix}${path === '/' ? '' : path}` || '/';
+}
+function inspectRouter(router, prefix) {
+    const contexts = [];
+    const endpoints = new Map();
+    for (const route of router.routes) {
+        const target = findTargetHandler(route.handler);
+        if (target === apiNotFoundHandler)
+            continue;
+        const spec = describeSpecOf(route.handler);
+        const key = `${route.method} ${route.path}`;
+        const middleware = isMiddleware(target);
+        if (route.method === 'ALL' && middleware) {
+            if (spec)
+                contexts.push({ prefix: pathPrefixOf(route.path), spec });
+            continue;
+        }
+        let endpoint = endpoints.get(key);
+        if (!endpoint && !middleware) {
+            endpoint = { method: route.method, path: route.path, specs: [] };
+            endpoints.set(key, endpoint);
+        }
+        if (endpoint && spec)
+            endpoint.specs.push(spec);
+        // A describeRoute() registered before the endpoint's handler under the same method and path.
+        if (!endpoint && spec) {
+            endpoints.set(key, {
+                method: route.method,
+                path: route.path,
+                specs: [spec],
+            });
+        }
+    }
+    const declarations = [];
+    for (const endpoint of endpoints.values()) {
+        const applicable = [
+            ...contexts
+                .filter((context) => endpoint.path === context.prefix ||
+                endpoint.path.startsWith(`${context.prefix}/`))
+                .map((context) => context.spec),
+            ...endpoint.specs,
+        ];
+        let hidden = false;
+        let operationId;
+        let summary;
+        const tags = new Set();
+        for (const spec of applicable) {
+            if (spec.hide)
+                hidden = true;
+            if (typeof spec.operationId === 'string')
+                operationId = spec.operationId;
+            if (spec.summary)
+                summary = spec.summary;
+            for (const tag of spec.tags ?? [])
+                tags.add(tag);
+        }
+        declarations.push({
+            method: endpoint.method,
+            path: joinPath(prefix, endpoint.path),
+            declared: applicable.length > 0,
+            hidden,
+            ...(operationId ? { operationId } : {}),
+            ...(tags.size > 0 ? { tags: [...tags] } : {}),
+            ...(summary ? { summary } : {}),
+        });
+    }
+    return declarations;
+}
+/**
+ * The endpoints that declare nothing: neither `describeRoute({...})` nor `describeRoute({ hide: true })`. For an
+ * application this includes the routes behind runtime dispatchers, and every endpoint registered with
+ * `addUndeclaredApiRoute`. Each is a defect the API document check reports.
+ */
+export function findUndeclaredApiRoutes(source, prefix = '/api') {
+    return inspectApiRoutes(source, prefix)
+        .filter((route) => !route.declared)
+        .map(({ method, path }) => ({ method, path }));
+}
+/**
+ * Generate the OpenAPI 3.1 document for an API router: every route declared with `describeRoute()` and not hidden,
+ * data endpoints expanded from their Collections, and the fragments merged in.
+ */
+export async function generateApiDocument(source, options) {
+    const router = resolveApiRouter(source);
+    const prefix = options.prefix ?? '/api';
+    const base = apiDocumentBaseComponents();
+    const generated = await generateRouterSpecs(router, options, base);
+    const paths = {};
+    for (const [path, item] of Object.entries(generated.paths)) {
+        paths[joinPath(prefix, path)] = item;
+    }
+    const document = {
+        openapi: '3.1.0',
+        // hono-openapi fills in a description of its own when none is given.
+        info: {
+            title: options.info.title,
+            version: options.info.version,
+            ...(options.info.description
+                ? { description: options.info.description }
+                : {}),
+        },
+        ...(generated.servers ? { servers: generated.servers } : {}),
+        paths,
+        components: {
+            ...generated.components,
+            schemas: { ...base.schemas, ...generated.components.schemas },
+            responses: { ...base.responses, ...generated.components.responses },
+        },
+    };
+    const warn = options.onWarning ?? (() => undefined);
+    // Routes behind a runtime dispatcher are declared routes too: merged before the fragments, so a fragment operation on
+    // the same method and path is the one dropped. Their components are generated from the same base, so the shared
+    // ones are identical and stay shared.
+    for (const forwarded of (options.forwarded ?? forwardedOf(source))?.routers ??
+        []) {
+        const specs = await generateRouterSpecs(forwarded.router, options, apiDocumentBaseComponents());
+        const forwardedPaths = {};
+        for (const [path, item] of Object.entries(specs.paths)) {
+            const full = joinPath(forwarded.prefix, path);
+            // A route outside the forwarded path is never reached; `inspectApiRoutes` reports it instead.
+            if (isForwardedTo(forwarded, full))
+                forwardedPaths[full] = item;
+        }
+        mergeApiDocumentFragment(document, {
+            owner: forwarded.owner,
+            paths: forwardedPaths,
+            components: specs.components,
+        }, warn);
+    }
+    // Data endpoints are expanded once every router is in, so a dispatcher forwarding one documents it in full too.
+    // Fragments come after: they carry finished operations, never a data endpoint placeholder.
+    await expandRepositoryOperations(document);
+    for (const fragment of options.fragments ?? []) {
+        mergeApiDocumentFragment(document, fragment, warn);
+    }
+    document.tags = collectTags(document, options.fragments ?? []);
+    return document;
+}
+async function generateRouterSpecs(router, options, base) {
+    const specs = await generateSpecs(router, {
+        documentation: {
+            info: {
+                title: options.info.title,
+                version: options.info.version,
+                ...(options.info.description
+                    ? { description: options.info.description }
+                    : {}),
+            },
+            ...(options.servers ? { servers: [...options.servers] } : {}),
+            components: base,
+        },
+        // The 400 for invalid input is added below, also to an operation that declares a 400 of its own.
+        defaultValidationErrorResponse: false,
+        excludeMethods: ['OPTIONS'],
+    });
+    addInvalidInputResponses(specs.paths, validatedOperations(router));
+    return specs;
+}
+/** An OpenAPI path for a Hono path, `/apps/:appId{[a-z]+}` becoming `/apps/{appId}`, as hono-openapi converts it. */
+function toOpenApiPath(path) {
+    return path
+        .split('/')
+        .map((segment) => {
+        if (!segment.startsWith(':'))
+            return segment;
+        const match = /^:([^{?]+)/.exec(segment);
+        return `{${match ? match[1] : segment.slice(1).replace(/\?$/, '')}}`;
+    })
+        .join('/');
+}
+/** The operations of a router that validate their input with `apiValidator()` (or any hono-openapi validator). */
+function validatedOperations(router) {
+    const endpoints = new Set();
+    const prefixes = [];
+    for (const route of router.routes) {
+        const metadata = findTargetHandler(route.handler)[uniqueSymbol];
+        // describeRoute() metadata carries `spec`; a validator's carries the schema conversion instead.
+        if (!metadata || 'spec' in metadata || !('toOpenAPISchema' in metadata))
+            continue;
+        const path = toOpenApiPath(route.path);
+        if (route.method === 'ALL')
+            prefixes.push(pathPrefixOf(path));
+        else
+            endpoints.add(`${route.method} ${path}`);
+    }
+    return { endpoints, prefixes };
+}
+/**
+ * Document the 400 an `apiValidator()` answers on every operation that has one, and on no other. A route declares a
+ * 400 itself only for another reason, such as a failed precondition: a declared `apiErrorResponse(400)` without a
+ * description already covers invalid input and is kept as it is, and a declared 400 with a description keeps it after
+ * the description of invalid input.
+ */
+function addInvalidInputResponses(paths, validated) {
+    for (const [path, item] of Object.entries(paths)) {
+        for (const method of httpMethods) {
+            const operation = item?.[method];
+            if (!operation)
+                continue;
+            const covered = validated.endpoints.has(`${method.toUpperCase()} ${path}`) ||
+                validated.prefixes.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
+            if (!covered)
+                continue;
+            const responses = (operation.responses ??= {});
+            const declared = responses['400'];
+            if (!declared) {
+                responses['400'] = {
+                    $ref: `#/components/responses/${invalidInputResponseName}`,
+                };
+            }
+            else if (!('$ref' in declared)) {
+                responses['400'] = {
+                    ...declared,
+                    description: `${invalidInputDescription}\n\n${declared.description}`,
+                };
+            }
+        }
+    }
+}
+function collectTags(document, fragments) {
+    const described = new Map();
+    for (const tag of [
+        ...(document.tags ?? []),
+        ...fragments.flatMap((fragment) => fragment.tags ?? []),
+    ]) {
+        const existing = described.get(tag.name);
+        described.set(tag.name, existing
+            ? {
+                ...tag,
+                ...existing,
+                description: existing.description ?? tag.description,
+            }
+            : tag);
+    }
+    const used = new Set();
+    for (const item of Object.values(document.paths ?? {})) {
+        for (const method of httpMethods) {
+            for (const tag of item?.[method]?.tags ?? [])
+                used.add(tag);
+        }
+    }
+    return [...used]
+        .sort((left, right) => left.localeCompare(right))
+        .map((name) => described.get(name) ?? { name });
+}
+const componentKinds = [
+    'schemas',
+    'responses',
+    'parameters',
+    'examples',
+    'requestBodies',
+    'headers',
+    'securitySchemes',
+    'links',
+    'callbacks',
+    'pathItems',
+];
+function defaultNamespace(owner) {
+    const bare = owner.replace(/^@[^/]+\//, '').replace(/^app-plugin-/, '');
+    return bare.replace(/[-_.\s]+([a-zA-Z0-9])/g, (_match, letter) => letter.toUpperCase());
+}
+function capitalize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+function uniqueName(base, taken) {
+    if (!taken(base))
+        return base;
+    let index = 2;
+    while (taken(`${base}${index}`))
+        index += 1;
+    return `${base}${index}`;
+}
+function rewriteRefs(value, renames) {
+    if (Array.isArray(value))
+        return value.map((item) => rewriteRefs(item, renames));
+    if (typeof value !== 'object' || value === null)
+        return value;
+    const result = {};
+    for (const [key, child] of Object.entries(value)) {
+        result[key] =
+            key === '$ref' && typeof child === 'string'
+                ? (renames.get(child) ?? child)
+                : rewriteRefs(child, renames);
+    }
+    return result;
+}
+function sameJson(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+/**
+ * Merge one fragment into a document in place.
+ *
+ * - A component whose name is free is added; one identical to an existing component is shared; one that differs is
+ *   renamed with the fragment's namespace in PascalCase as prefix (`AuthSession`; a security scheme takes it in
+ *   camelCase, `authCookieAuth`), and every `$ref` and security requirement in the fragment follows the rename.
+ * - An operation whose method and path the document already has is dropped with a warning: a declared route is what
+ *   actually answers.
+ * - An `operationId` already in use is prefixed with the namespace (`authSignIn`), then numbered if still taken.
+ * - Tags merge by name; a description already in the document wins.
+ * - Security requirements are appended to the document's top-level `security` unless an identical one is already
+ *   there, following any rename of the security schemes they name.
+ */
+export function mergeApiDocumentFragment(document, fragment, onWarning = () => undefined) {
+    const namespace = fragment.namespace ?? defaultNamespace(fragment.owner);
+    const components = (document.components ??= {});
+    const renames = new Map();
+    const additions = [];
+    const fragmentComponents = (fragment.components ?? {});
+    for (const kind of componentKinds) {
+        for (const [name, component] of Object.entries(fragmentComponents[kind] ?? {})) {
+            const existing = components[kind]?.[name];
+            if (existing === undefined) {
+                additions.push([kind, name, component]);
+                continue;
+            }
+            if (sameJson(existing, component))
+                continue;
+            // Security schemes are named in camelCase, as a requirement names them (`authCookieAuth`); every other component
+            // in PascalCase (`AuthSession`).
+            const renamed = uniqueName(kind === 'securitySchemes'
+                ? `${namespace}${capitalize(name)}`
+                : `${capitalize(namespace)}${name}`, (candidate) => components[kind]?.[candidate] !== undefined ||
+                fragmentComponents[kind]?.[candidate] !== undefined);
+            renames.set(`#/components/${kind}/${name}`, `#/components/${kind}/${renamed}`);
+            additions.push([kind, renamed, component]);
+            onWarning(`${fragment.owner}: component ${kind}/${name} differs from the one already in the API document and was renamed to ${renamed}.`);
+        }
+    }
+    for (const [kind, name, component] of additions) {
+        (components[kind] ??= {})[name] = rewriteRefs(component, renames);
+    }
+    // A security requirement names its scheme by key rather than by `$ref`, so a renamed scheme is followed here.
+    const schemeRenames = new Map();
+    for (const [from, to] of renames) {
+        const prefix = '#/components/securitySchemes/';
+        if (from.startsWith(prefix))
+            schemeRenames.set(from.slice(prefix.length), to.slice(prefix.length));
+    }
+    const renameSecurity = (requirements) => requirements.map((requirement) => Object.fromEntries(Object.entries(requirement).map(([name, scopes]) => [
+        schemeRenames.get(name) ?? name,
+        scopes,
+    ])));
+    if (fragment.security && fragment.security.length > 0) {
+        const security = (document.security ??= []);
+        for (const requirement of renameSecurity(fragment.security)) {
+            if (!security.some((existing) => sameJson(existing, requirement)))
+                security.push(requirement);
+        }
+    }
+    const operationIds = new Set();
+    for (const item of Object.values(document.paths ?? {})) {
+        for (const method of httpMethods) {
+            const operationId = item?.[method]?.operationId;
+            if (operationId)
+                operationIds.add(operationId);
+        }
+    }
+    const paths = (document.paths ??= {});
+    for (const [path, rawItem] of Object.entries(fragment.paths ?? {})) {
+        if (!rawItem)
+            continue;
+        const item = rewriteRefs(rawItem, renames);
+        const target = (paths[path] ??= {});
+        for (const [key, value] of Object.entries(item)) {
+            const method = key;
+            if (!httpMethods.includes(method)) {
+                if (!(key in target))
+                    target[key] = value;
+                continue;
+            }
+            if (target[method]) {
+                onWarning(`${fragment.owner}: ${method.toUpperCase()} ${path} is already declared by a route and was left out of the fragment.`);
+                continue;
+            }
+            const operation = { ...value };
+            if (operation.security && schemeRenames.size > 0)
+                operation.security = renameSecurity(operation.security);
+            if (operation.operationId && operationIds.has(operation.operationId)) {
+                const renamed = uniqueName(`${namespace}${capitalize(operation.operationId)}`, (candidate) => operationIds.has(candidate));
+                onWarning(`${fragment.owner}: operationId ${operation.operationId} of ${method.toUpperCase()} ${path} is already used and was renamed to ${renamed}.`);
+                operation.operationId = renamed;
+            }
+            if (operation.operationId)
+                operationIds.add(operation.operationId);
+            target[method] = operation;
+        }
+    }
+}
+//# sourceMappingURL=document.js.map

package/dist/router/openapi/document.js.map

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

package/dist/router/openapi/index.d.ts

@@ -0,0 +1,7 @@
+export { apiErrorResponse, apiErrorResponses, apiValidator, dataResponse, describeRoute, emptyResponse, listResponse, resolver, type ApiResponseObject, type ApiSchema, type ApiValidatorInput, type ApiValidatorOptions, type DescribeRouteOptions, type OpenAPIV3_1, type ResolverReturnType, } from './describe.js';
+export { apiErrorResponseNames, type ApiErrorResponseCode, } from './components.js';
+export { findUndeclaredApiRoutes, generateApiDocument, inspectApiRoutes, mergeApiDocumentFragment, type ApiDocument, type ApiDocumentFragment, type ApiDocumentInfo, type ApiForwardedRouter, type ApiForwardedRoutes, type ApiRouteDeclaration, type ApiRouterSource, type ApiUndeclaredRoute, type GenerateApiDocumentOptions, } from './document.js';
+export { declaredRouteActionOf, declaredRouteOf, routeAcceptsScheme, } from './declared.js';
+export { findApiDocumentSchemaProblems, type ApiSchemaDirection, } from './schema.js';
+export { ApiDocsService, apiDocsToken, type ApiDocsAccess, type ApiDocsAccessCheck, type ApiDocsDescription, type ApiDocsTarget, type ApiDocumentFragmentSource, type ApiDocumentTransform, } from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/router/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/openapi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAC"}

package/dist/router/openapi/index.js

@@ -0,0 +1,7 @@
+export { apiErrorResponse, apiErrorResponses, apiValidator, dataResponse, describeRoute, emptyResponse, listResponse, resolver, } from './describe.js';
+export { apiErrorResponseNames, } from './components.js';
+export { findUndeclaredApiRoutes, generateApiDocument, inspectApiRoutes, mergeApiDocumentFragment, } from './document.js';
+export { declaredRouteActionOf, declaredRouteOf, routeAcceptsScheme, } from './declared.js';
+export { findApiDocumentSchemaProblems, } from './schema.js';
+export { ApiDocsService, apiDocsToken, } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/router/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/router/openapi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,QAAQ,GAQT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,GAUzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,GAE9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,YAAY,GAOb,MAAM,cAAc,CAAC"}

package/dist/router/openapi/repository-document.d.ts

@@ -0,0 +1,30 @@
+import { type CollectionDefinition, type FieldDefinition, type NormalizedRepositoryPolicy } from '@nocobase/db';
+import type { MiddlewareHandler } from 'hono';
+import type { OpenAPIV3_1 } from 'openapi-types';
+import type { RepositoryApiAction } from '../repository-routes.js';
+import type { ApiSchema } from './describe.js';
+/** What the document generator needs to describe one data endpoint. */
+export interface RepositoryEndpointDescriptor {
+    readonly exposure: string;
+    readonly collection: string;
+    readonly connection: string | undefined;
+    readonly action: RepositoryApiAction;
+    readonly maxLimit: number;
+    /** The exposure's fixed Policy, or `undefined` when the Policy is built per request from the principal. */
+    readonly policy: NormalizedRepositoryPolicy | undefined;
+    /** Fields the exposure adds to every returned record, documented read-only in its record schema. */
+    readonly computedFields: Readonly<Record<string, ApiSchema>>;
+    readonly loadCollection: () => Promise<CollectionDefinition | undefined>;
+}
+type SchemaObject = OpenAPIV3_1.SchemaObject;
+/** The declaration a data endpoint registers, so it is documented without a hand-written `describeRoute()`. */
+export declare function describeRepositoryEndpoint(descriptor: RepositoryEndpointDescriptor): MiddlewareHandler;
+/** The JSON shape a scalar field's value takes over HTTP, before nullability. */
+export declare function fieldValueSchema(field: FieldDefinition): SchemaObject;
+/**
+ * Replace each data endpoint's placeholder declaration in `document` with its operation: per-field record, `values`
+ * and filter schemas read from the Collection, and the shared Repository components.
+ */
+export declare function expandRepositoryOperations(document: OpenAPIV3_1.Document): Promise<void>;
+export {};
+//# sourceMappingURL=repository-document.d.ts.map

package/dist/router/openapi/repository-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-document.d.ts","sourceRoot":"","sources":["../../../src/router/openapi/repository-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAEhC,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAQ/C,uEAAuE;AACvE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2GAA2G;IAC3G,QAAQ,CAAC,MAAM,EAAE,0BAA0B,GAAG,SAAS,CAAC;IACxD,oGAAoG;IACpG,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CAC1E;AAED,KAAK,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC;AAuB7C,+GAA+G;AAC/G,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,4BAA4B,GACvC,iBAAiB,CAQnB;AAyND,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA4DrE;AAsjBD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,WAAW,CAAC,QAAQ,GAC7B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}