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

package/dist/router/cli/types.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Command-line hints on API routes, and the command manifest a CLI builds its commands from. The API document is the
+ * single source: every documented operation is a command, named from its tag, path and method unless its `x-cli`
+ * extension names it, and `x-cli: false` leaves it out.
+ */
+/** Who calls a command: a person (a session or an API key), or an agent's run (its run token). */
+export type CliIdentity = 'person' | 'run';
+export declare const CLI_IDENTITIES: readonly CliIdentity[];
+/**
+ * Where a CLI finds an input the command line leaves out: an environment variable by name, such as
+ * `GITHUB_REPOSITORY`, or a field of the JSON file an environment variable names, such as `{ file: 'GITHUB_EVENT_PATH',
+ * path: 'pull_request.head.sha' }` (dot-separated keys). An unset or empty variable, an unreadable file and a missing
+ * field all fall through to the next source.
+ */
+export type CliEnvDefault = string | {
+    readonly file: string;
+    readonly path: string;
+};
+/** How one input of a route appears on the command line, keyed by its field name in `CliRouteOptions.flags`. */
+export interface CliFlagOptions {
+    /** The flag's name when it is not the kebab-case of the field, such as `reply-to` for `parentId`. */
+    readonly name?: string;
+    /** A one-letter alias, such as `m`. */
+    readonly alias?: string;
+    /** Also take `--<flag>-file <path>`, whose contents become the value; for long text such as Markdown. */
+    readonly contentFile?: boolean;
+    /** Ask for a missing value when a terminal is attached. */
+    readonly prompt?: boolean;
+    /**
+     * Also take `--from-env` instead of a value: the CLI reads it from its own environment variable whose name is the
+     * value given for this other field (such as `name`), so a secret never sits on the command line.
+     */
+    readonly fromEnv?: string;
+    /**
+     * Defaults read from the caller's environment when the flag is not given, the first found wins; a flag given
+     * explicitly always wins. For values CI already knows, such as the repository (`['GITHUB_REPOSITORY',
+     * 'CI_PROJECT_PATH']`) or the commit being built.
+     */
+    readonly env?: readonly CliEnvDefault[];
+    /** Replaces the schema's description. */
+    readonly description?: string;
+    /** Not offered on the command line; the field keeps its default. */
+    readonly hidden?: boolean;
+}
+/**
+ * Files sent before the request itself: each file named by `--<flag>` is uploaded to the operation `upload` (a
+ * `multipart/form-data` route answering `{ data: { id } }`), and the ids it answers fill the body field `field`.
+ */
+export interface CliUploadOptions {
+    /** The operationId of the upload route. */
+    readonly upload: string;
+    /** The body field the uploaded ids fill. */
+    readonly field: string;
+    /** The form field the file goes in on the upload route; `file` when left out. */
+    readonly part?: string;
+    readonly multiple?: boolean;
+    readonly description?: string;
+    /** Per file. */
+    readonly maxBytes?: number;
+}
+/**
+ * One file sent beside the request rather than in it: the route answers an upload ticket (`{ data: { url, method,
+ * headers, message? } }`) and the CLI streams the file named by `--<flag>` straight to it, with the ticket's headers
+ * only. The upload's answer is the command's result.
+ */
+export interface CliTicketUploadOptions {
+    /** The flag naming the file, such as `file`. */
+    readonly flag: string;
+    readonly maxBytes: number;
+    /** Extensions such as `.tar.gz`; any when left out. */
+    readonly accept?: readonly string[];
+    readonly description?: string;
+    /**
+     * The file may be left out, and the route then answers its own result rather than a ticket. To tell the two apart,
+     * the CLI sends the file's name in the body field named like the flag when it is given: the route's body declares
+     * that field (a string), which the command does not offer as a flag of its own.
+     */
+    readonly optional?: boolean;
+}
+/**
+ * The files of a directory on the caller's machine that differ from the manifest it holds, sent with the request as
+ * `multipart/form-data` parts named `field`, each file named by its path inside the directory. The CLI looks for
+ * `dir` at its working directory and each one above it; `manifest` is a JSON array of `{ path, hash }` (SHA-256, hex).
+ * The boolean `--<flag>` sends them; without it the request goes as it would without the input.
+ */
+export interface CliChangedFilesOptions {
+    /** The boolean flag, such as `changed`. */
+    readonly flag: string;
+    /** The form field each file goes in. */
+    readonly field: string;
+    /** Relative, such as `.nocobase-runner/knowledge`. */
+    readonly dir: string;
+    /** Inside `dir`, such as `.manifest.json`. */
+    readonly manifest: string;
+    /** Per file. */
+    readonly maxBytes: number;
+    readonly maxFiles: number;
+    /** Extensions such as `.md`; any when left out. */
+    readonly accept?: readonly string[];
+    readonly description?: string;
+}
+/** The `x-cli` extension of an operation. */
+export interface CliRouteOptions {
+    /** The command's words, such as `issue comment add`; derived from the tag, path and method when left out. */
+    readonly command?: string;
+    /** The fields given as positional arguments, in order; the path parameters, in path order, when left out. */
+    readonly args?: readonly string[];
+    /** Per field: how it appears on the command line. */
+    readonly flags?: Readonly<Record<string, CliFlagOptions>>;
+    /** A flag whose JSON file is the whole request body, such as `file` for `--file issue.json`. */
+    readonly bodyFile?: string;
+    /** Files uploaded first, by flag name. */
+    readonly uploads?: Readonly<Record<string, CliUploadOptions>>;
+    /** A file streamed to the upload ticket the route answers. */
+    readonly ticketUpload?: CliTicketUploadOptions;
+    /** Changed files of a directory, sent with the request. */
+    readonly changedFiles?: CliChangedFilesOptions;
+    /** The fields a list shows as a table, in order; the first scalar fields when left out. */
+    readonly columns?: readonly string[];
+    /** Asks before running, with this question, unless `--yes` is given. */
+    readonly confirm?: string;
+    /** Who may call it; from the operation's security requirements when left out. */
+    readonly identities?: readonly CliIdentity[];
+    /** Example command lines, without the CLI's name. */
+    readonly examples?: readonly string[];
+    /** The business action the command performs, such as `pm.issues/comment`; a caller without it is not offered it. */
+    readonly action?: string;
+    /** Left out of the manifest, while staying documented. */
+    readonly hidden?: boolean;
+}
+/** The operation extension `cliRoute()` produces. */
+export declare const CLI_EXTENSION = "x-cli";
+export interface CliRouteExtension {
+    readonly 'x-cli': CliRouteOptions | false;
+}
+/**
+ * The `x-cli` extension for `describeRoute()`: `describeRoute({ tags, summary, operationId, ...cliRoute({ command:
+ * 'issue comment add', args: ['issueId'] }) })`. `cliRoute(false)` keeps the route out of the CLI.
+ */
+export declare function cliRoute(options: CliRouteOptions | false): CliRouteExtension;
+/**
+ * Operations an application keeps off its command line while they stay documented (`CliService.exclude()`), such as a
+ * library's browser-only flows or the protocol between the application and its own machines.
+ */
+export interface CliExclusion {
+    /** Every operation whose first tag is one of these, such as `Authorization`. */
+    readonly tags?: readonly string[];
+    /** Every operation whose path starts with one of these, such as `/api/auth/`; the path is below the base path. */
+    readonly paths?: readonly string[];
+    readonly operationIds?: readonly string[];
+}
+/** One input of a command, as the manifest describes it. */
+export interface CliParameter {
+    /** The argument's or flag's name on the command line. */
+    readonly name: string;
+    /** Its name in the request: the path or query parameter, or the body field. */
+    readonly field: string;
+    readonly in: 'path' | 'query' | 'body' | 'file';
+    /** Its place among the positional arguments; a flag has none. */
+    readonly position?: number;
+    readonly type: 'string' | 'number' | 'integer' | 'boolean' | 'string[]' | 'number[]' | 'json';
+    readonly required: boolean;
+    readonly description?: string;
+    readonly enum?: readonly string[];
+    readonly default?: unknown;
+    readonly alias?: string;
+    readonly contentFile?: boolean;
+    readonly prompt?: boolean;
+    /** `--from-env` fills it from the environment variable named by the value of this field (`CliFlagOptions.fromEnv`). */
+    readonly fromEnv?: string;
+    /** Read from the caller's environment when not given, the first found wins (`CliFlagOptions.env`). */
+    readonly env?: readonly CliEnvDefault[];
+    /** For `in: 'file'`: where each file is uploaded first, and which body field its id fills. */
+    readonly upload?: {
+        readonly method: string;
+        readonly path: string;
+        readonly part: string;
+        readonly field: string;
+        readonly multiple: boolean;
+        readonly maxBytes?: number;
+    };
+    /** For `in: 'file'`: the file is streamed to the upload ticket the route answers. */
+    readonly ticket?: {
+        readonly maxBytes: number;
+        readonly accept?: readonly string[];
+        /** The file may be left out; when given, its name goes in the body field `field` (`CliTicketUploadOptions.optional`). */
+        readonly optional?: boolean;
+    };
+    /** For `in: 'file'`: the boolean flag sends the changed files of a directory as `field` parts. */
+    readonly changed?: {
+        readonly dir: string;
+        readonly manifest: string;
+        readonly maxBytes: number;
+        readonly maxFiles: number;
+        readonly accept?: readonly string[];
+    };
+    /** A file part of a `multipart/form-data` body (`in: 'body'`). */
+    readonly binary?: boolean;
+    readonly multiple?: boolean;
+}
+export type CliOutputKind = 'data' | 'list' | 'empty' | 'download';
+/** One command of the manifest. */
+export interface CliCommand {
+    /** Its words joined by `:`, such as `issue:comment:add`. */
+    readonly id: string;
+    readonly summary: string;
+    readonly description?: string;
+    readonly operationId?: string;
+    readonly method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** The request path below the server's origin, the application's base path included, with `{name}` placeholders. */
+    readonly path: string;
+    readonly parameters: readonly CliParameter[];
+    /** How the body travels; none for a request without one. */
+    readonly body?: {
+        readonly media: 'application/json' | 'multipart/form-data';
+        /** A flag whose JSON file is the whole body. */
+        readonly file?: string;
+        readonly required?: boolean;
+    };
+    readonly output: {
+        readonly kind: CliOutputKind;
+        readonly columns?: readonly string[];
+    };
+    readonly confirm?: string;
+    readonly examples?: readonly string[];
+    readonly identities: readonly CliIdentity[];
+    readonly action?: string;
+}
+/** Who a manifest is built for. */
+export interface CliCaller {
+    readonly kind: CliIdentity;
+    /** The person: the caller, or for a run the person who woke the agent. */
+    readonly userId: string;
+    readonly displayName: string;
+    readonly runId?: string;
+    /** The business actions the caller holds; a command with an action outside them is left out. None when absent. */
+    readonly actions?: ReadonlySet<string>;
+}
+export interface CliManifestIdentity {
+    readonly kind: CliIdentity;
+    readonly userId: string;
+    readonly displayName: string;
+    readonly runId?: string;
+    /** The business actions the caller holds, sorted; what decides which commands that name one it is offered. */
+    readonly actions: readonly string[];
+}
+/**
+ * A command the API document describes that the caller is not offered, so a CLI can say why instead of "unknown
+ * command": it is another identity's (`identity`), or it names an action the caller does not hold (`action`).
+ */
+export interface CliWithheldCommand {
+    readonly id: string;
+    readonly summary: string;
+    readonly reason: 'identity' | 'action';
+    readonly identities: readonly CliIdentity[];
+    readonly action?: string;
+}
+/** What `CliService.describe()` tells about the application's CLI, for the agent-readable reference. */
+export interface CliDescription {
+    /** The CLI's command name, such as `acme`. */
+    readonly bin?: string;
+    /** The application's name, such as `Acme`. */
+    readonly title?: string;
+    /** Lines added to the reference's introduction, such as where the guides are. */
+    readonly notes?: readonly string[];
+}
+/** The `version` of the manifest format. */
+export declare const CLI_MANIFEST_VERSION = 4;
+export interface CliManifest {
+    readonly version: number;
+    /** Changes whenever the commands change; a CLI caches by it. */
+    readonly etag: string;
+    readonly identity: CliManifestIdentity;
+    readonly commands: readonly CliCommand[];
+    /** The commands the caller is not offered, and why. */
+    readonly withheld: readonly CliWithheldCommand[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/router/cli/types.d.ts.map

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

package/dist/router/cli/types.js

@@ -0,0 +1,18 @@
+/**
+ * Command-line hints on API routes, and the command manifest a CLI builds its commands from. The API document is the
+ * single source: every documented operation is a command, named from its tag, path and method unless its `x-cli`
+ * extension names it, and `x-cli: false` leaves it out.
+ */
+export const CLI_IDENTITIES = ['person', 'run'];
+/** The operation extension `cliRoute()` produces. */
+export const CLI_EXTENSION = 'x-cli';
+/**
+ * The `x-cli` extension for `describeRoute()`: `describeRoute({ tags, summary, operationId, ...cliRoute({ command:
+ * 'issue comment add', args: ['issueId'] }) })`. `cliRoute(false)` keeps the route out of the CLI.
+ */
+export function cliRoute(options) {
+    return { 'x-cli': options };
+}
+/** The `version` of the manifest format. */
+export const CLI_MANIFEST_VERSION = 4;
+//# sourceMappingURL=types.js.map

package/dist/router/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/router/cli/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,cAAc,GAA2B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAgIxE,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAMrC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAgC;IACvD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AA+ID,4CAA4C;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/router/duplicate-routes.d.ts

@@ -0,0 +1,25 @@
+import type { Hono } from 'hono';
+/** One API contribution's router, labelled with whatever registered it. */
+export interface OwnedApiRouter {
+    readonly owner: string;
+    readonly router: Hono;
+    /**
+     * Where the router's paths start below the API prefix, such as `/authorization` for a router a dispatcher forwards
+     * requests under `/api/authorization` to. Defaults to none: the router is mounted on the API router itself.
+     */
+    readonly mount?: string;
+    /** Which of the router's endpoints, by path below the API prefix, take part in the check. Defaults to all of them. */
+    readonly includes?: (path: string) => boolean;
+}
+/**
+ * Fails when two API routes answer the same method and path. Hono matches in registration order and lets the first
+ * match win, so the second registration would never run and nothing would say so.
+ *
+ * Hono records one entry per handler, so `router.post('/x', limit, validate, handle)` is three entries for a single
+ * route, and `router.use()` is an `ALL` entry. Only entries whose handler is not a middleware — Hono's own test, a
+ * handler that does not take `next` — count as endpoints, which leaves exactly one per route. Two endpoints conflict
+ * when their patterns match and their methods are equal or either is `ALL`, whether they come from two contributions
+ * or from the same router.
+ */
+export declare function assertNoDuplicateApiRoutes(routers: readonly OwnedApiRouter[], prefix?: string): void;
+//# sourceMappingURL=duplicate-routes.d.ts.map

package/dist/router/duplicate-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-routes.d.ts","sourceRoot":"","sources":["../../src/router/duplicate-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sHAAsH;IACtH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,MAAM,GAAE,MAAe,GACtB,IAAI,CA4BN"}

package/dist/router/duplicate-routes.js

@@ -0,0 +1,51 @@
+import { inspectRoutes } from 'hono/dev';
+/**
+ * Reduces a Hono path to its pattern: a parameter's name does not change what it matches, so `/a/:x` and `/a/:y` are
+ * the same route, while a regular expression or an optional marker after the name does and is kept.
+ */
+function normalizeRoutePattern(path) {
+    return path
+        .split('/')
+        .map((segment) => segment.startsWith(':') ? segment.replace(/^:[^{?]*/, ':') : segment)
+        .join('/');
+}
+function describeEndpoint(endpoint, prefix) {
+    return `${endpoint.method} ${prefix}${endpoint.path} from ${endpoint.owner}`;
+}
+/**
+ * Fails when two API routes answer the same method and path. Hono matches in registration order and lets the first
+ * match win, so the second registration would never run and nothing would say so.
+ *
+ * Hono records one entry per handler, so `router.post('/x', limit, validate, handle)` is three entries for a single
+ * route, and `router.use()` is an `ALL` entry. Only entries whose handler is not a middleware — Hono's own test, a
+ * handler that does not take `next` — count as endpoints, which leaves exactly one per route. Two endpoints conflict
+ * when their patterns match and their methods are equal or either is `ALL`, whether they come from two contributions
+ * or from the same router.
+ */
+export function assertNoDuplicateApiRoutes(routers, prefix = '/api') {
+    const endpoints = new Map();
+    for (const { owner, router, mount = '', includes } of routers) {
+        for (const route of inspectRoutes(router)) {
+            if (route.isMiddleware)
+                continue;
+            const endpoint = {
+                owner,
+                method: route.method,
+                path: `${mount}${route.path === '/' && mount ? '' : route.path}`,
+            };
+            if (includes && !includes(endpoint.path))
+                continue;
+            const pattern = normalizeRoutePattern(endpoint.path);
+            const registered = endpoints.get(pattern) ?? [];
+            const existing = registered.find((candidate) => candidate.method === endpoint.method ||
+                candidate.method === 'ALL' ||
+                endpoint.method === 'ALL');
+            if (existing) {
+                throw new Error(`Duplicate API route: ${describeEndpoint(existing, prefix)} and ${describeEndpoint(endpoint, prefix)} answer the same requests. Only the first would ever run; remove or rename one of them.`);
+            }
+            registered.push(endpoint);
+            endpoints.set(pattern, registered);
+        }
+    }
+}
+//# sourceMappingURL=duplicate-routes.js.map

package/dist/router/duplicate-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-routes.js","sourceRoot":"","sources":["../../src/router/duplicate-routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqBzC;;;GAGG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CACrE;SACA,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CACvB,QAA4B,EAC5B,MAAc;IAEd,OAAO,GAAG,QAAQ,CAAC,MAAM,IAAI,MAAM,GAAG,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC/E,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAkC,EAClC,SAAiB,MAAM;IAEvB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC1D,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC;QAC9D,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,YAAY;gBAAE,SAAS;YACjC,MAAM,QAAQ,GAAuB;gBACnC,KAAK;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,GAAG,KAAK,GAAG,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE;aACjE,CAAC;YACF,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YACnD,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAC9B,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;gBACpC,SAAS,CAAC,MAAM,KAAK,KAAK;gBAC1B,QAAQ,CAAC,MAAM,KAAK,KAAK,CAC5B,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,wBAAwB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,yFAAyF,CAC9L,CAAC;YACJ,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/router/health.d.ts

@@ -0,0 +1,7 @@
+import { type AppApiRouteContribution } from './routes.js';
+export interface HealthCheckRoutesApplication {
+    readonly appName: string;
+    readonly publicBasePath: string;
+}
+export declare const healthCheckApiRoutes: AppApiRouteContribution<HealthCheckRoutesApplication>;
+//# sourceMappingURL=health.d.ts.map

package/dist/router/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/router/health.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,oBAAoB,EAAE,uBAAuB,CAAC,4BAA4B,CAmDnF,CAAC"}

package/dist/router/health.js

@@ -0,0 +1,48 @@
+import { Hono } from 'hono';
+import { describeRoute } from 'hono-openapi';
+import { defineApiRoutes } from './routes.js';
+export const healthCheckApiRoutes = defineApiRoutes((app) => {
+    const router = new Hono();
+    router.get('/healthz', describeRoute({
+        tags: ['App'],
+        summary: 'Check that the application is up',
+        operationId: 'checkHealth',
+        // Probes call it without a credential.
+        security: [],
+        description: 'Answers while the application serves requests. Probes and load balancers read this body, which keeps its own shape rather than `{ data }`.',
+        responses: {
+            '200': {
+                description: 'The application is up.',
+                content: {
+                    'application/json': {
+                        schema: {
+                            type: 'object',
+                            required: ['ok', 'app', 'basePath'],
+                            properties: {
+                                ok: { const: true },
+                                app: {
+                                    type: 'object',
+                                    required: ['name', 'basePath'],
+                                    properties: {
+                                        name: { type: 'string' },
+                                        basePath: { type: 'string' },
+                                    },
+                                },
+                                basePath: { type: 'string' },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    }), (context) => context.json({
+        ok: true,
+        app: {
+            name: app.appName,
+            basePath: app.publicBasePath,
+        },
+        basePath: app.publicBasePath,
+    }));
+    return router;
+});
+//# sourceMappingURL=health.js.map

package/dist/router/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/router/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAgC,MAAM,aAAa,CAAC;AAO5E,MAAM,CAAC,MAAM,oBAAoB,GAC/B,eAAe,CAAC,CAAC,GAAiC,EAAQ,EAAE;IAC1D,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAE1B,MAAM,CAAC,GAAG,CACR,UAAU,EACV,aAAa,CAAC;QACZ,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,aAAa;QAC1B,uCAAuC;QACvC,QAAQ,EAAE,EAAE;QACZ,WAAW,EACT,4IAA4I;QAC9I,SAAS,EAAE;YACT,KAAK,EAAE;gBACL,WAAW,EAAE,wBAAwB;gBACrC,OAAO,EAAE;oBACP,kBAAkB,EAAE;wBAClB,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC;4BACnC,UAAU,EAAE;gCACV,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gCACnB,GAAG,EAAE;oCACH,IAAI,EAAE,QAAQ;oCACd,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;oCAC9B,UAAU,EAAE;wCACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wCACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qCAC7B;iCACF;gCACD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BAC7B;yBACF;qBACF;iBACF;aACF;SACF;KACF,CAAC,EACF,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,IAAI,CAAC;QACX,EAAE,EAAE,IAAI;QACR,GAAG,EAAE;YACH,IAAI,EAAE,GAAG,CAAC,OAAO;YACjB,QAAQ,EAAE,GAAG,CAAC,cAAc;SAC7B;QACD,QAAQ,EAAE,GAAG,CAAC,cAAc;KAC7B,CAAC,CACL,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/dist/router/index.d.ts

@@ -0,0 +1,26 @@
+import { Hono } from 'hono';
+import { ServiceProvider, type ServiceContainer, type ServiceToken } from '@nocobase/service-provider';
+export * from './api-error.js';
+export * from './api-limits.js';
+export * from './health.js';
+export * from './routes.js';
+export * from './repository-routes.js';
+export * from './openapi/index.js';
+export * from './cli/index.js';
+export { addRepositoryRequestConstraint, type RepositoryRequestConstraint, } from './repository-constraints.js';
+/**
+ * The HTTP router owned by an application.
+ *
+ * The router is deliberately exposed as a service rather than being treated
+ * as the application itself. This keeps the application lifecycle and
+ * framework-specific HTTP implementation separate.
+ */
+export declare const routerToken: ServiceToken<Hono>;
+export interface RouterProviderApplication {
+    readonly container: ServiceContainer;
+}
+export declare class RouterProvider<TApplication extends RouterProviderApplication = RouterProviderApplication> extends ServiceProvider<TApplication> {
+    readonly name: string;
+    register(): void;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AAEpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,8BAA8B,EAC9B,KAAK,2BAA2B,GACjC,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,YAAY,CAAC,IAAI,CAE1C,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED,qBAAa,cAAc,CACzB,YAAY,SAAS,yBAAyB,GAAG,yBAAyB,CAC1E,SAAQ,eAAe,CAAC,YAAY,CAAC;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAY;IAExB,QAAQ,IAAI,IAAI;CAKjC"}

package/dist/router/index.js

@@ -0,0 +1,29 @@
+import { Hono } from 'hono';
+import { CliService, cliToken } from './cli/service.js';
+import { ApiDocsService, apiDocsToken } from './openapi/service.js';
+import { ServiceProvider, createServiceToken, } from '@nocobase/service-provider';
+export * from './api-error.js';
+export * from './api-limits.js';
+export * from './health.js';
+export * from './routes.js';
+export * from './repository-routes.js';
+export * from './openapi/index.js';
+export * from './cli/index.js';
+export { addRepositoryRequestConstraint, } from './repository-constraints.js';
+/**
+ * The HTTP router owned by an application.
+ *
+ * The router is deliberately exposed as a service rather than being treated
+ * as the application itself. This keeps the application lifecycle and
+ * framework-specific HTTP implementation separate.
+ */
+export const routerToken = createServiceToken('@nocobase/app/router');
+export class RouterProvider extends ServiceProvider {
+    name = 'router';
+    register() {
+        this.app.container.instance(routerToken, new Hono());
+        this.app.container.instance(apiDocsToken, new ApiDocsService());
+        this.app.container.instance(cliToken, new CliService());
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACL,eAAe,EAEf,kBAAkB,GAEnB,MAAM,4BAA4B,CAAC;AAEpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,8BAA8B,GAE/B,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuB,kBAAkB,CAC/D,sBAAsB,CACvB,CAAC;AAMF,MAAM,OAAO,cAEX,SAAQ,eAA6B;IACrB,IAAI,GAAW,QAAQ,CAAC;IAExB,QAAQ;QACtB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,cAAc,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF"}

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

@@ -0,0 +1,24 @@
+import type { OpenAPIV3_1 } from 'openapi-types';
+/** The HTTP statuses that have a shared error response component, with the component's name. */
+export declare const apiErrorResponseNames: {
+    readonly 400: 'BadRequest';
+    readonly 401: 'Unauthenticated';
+    readonly 403: 'PermissionDenied';
+    readonly 404: 'NotFound';
+    readonly 409: 'Conflict';
+    readonly 413: 'PayloadTooLarge';
+    readonly 415: 'UnsupportedMediaType';
+    readonly 429: 'TooManyRequests';
+    readonly 500: 'InternalError';
+    readonly 501: 'NotImplemented';
+    readonly 503: 'Unavailable';
+    readonly 504: 'DeadlineExceeded';
+};
+export type ApiErrorResponseCode = keyof typeof apiErrorResponseNames;
+/** The schemas and responses every API document carries: the standard error body and list metadata. */
+export declare function apiDocumentBaseComponents(): OpenAPIV3_1.ComponentsObject;
+/** The description of the 400 a route answers when `apiValidator()` rejects its input. */
+export declare const invalidInputDescription: string;
+/** The shared response `apiValidator()` failures are documented with: the 400 every route with a validator can answer. */
+export declare const invalidInputResponseName = "InvalidInput";
+//# sourceMappingURL=components.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/router/openapi/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQjD,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,EAAE;IAClC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,sBAAsB,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;CAcjC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAiBtE,uGAAuG;AACvG,wBAAgB,yBAAyB,IAAI,WAAW,CAAC,gBAAgB,CA+FxE;AAED,0FAA0F;AAC1F,eAAO,MAAM,uBAAuB,EAAE,MACsI,CAAC;AAE7K,0HAA0H;AAC1H,eAAO,MAAM,wBAAwB,iBAAiB,CAAC"}