@nocobase/app-cli-client 0.0.0-stage → 0.1.0-beta.0

package/dist/dynamic/rest.js

@@ -0,0 +1,212 @@
+// Running a request command of the manifest (`kind: 'rest'`). The line is read by the shared parser
+// (`../parse/arguments.ts`, also `@nocobase/app-cli-client/parse`), over this machine: files relative to the working
+// directory, this process's environment, and a prompt for a missing value when there is a terminal to ask in. Each
+// upload parameter's files are then uploaded to their route first and the ids they answer fill the body field; a ticket
+// parameter's file is streamed to the upload ticket the request answers; a changed-files parameter sends its
+// directory's changed files as multipart parts; a binary body field is a part of its own; a `download` command saves
+// to `--out`; a command that asks first takes `--yes`.
+import { openAsBlob } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { EXIT_CODES } from '@nocobase/agent-protocol';
+import { appCliConfig } from "../config.js";
+import { UsageError } from "../lib/command.js";
+import { CliCommandError } from "../lib/envelope.js";
+import { globalFlags } from "../lib/globals.js";
+import { AppApiError } from "../lib/http.js";
+import { mediaTypeOf } from "../lib/mime.js";
+import { CliParseError, parameterLabel, parseCommandLine, } from "../parse/arguments.js";
+import { fillRequest, requestText } from "../request.js";
+import { download, send } from "./execute.js";
+import { changedFiles } from "./files.js";
+import { urlFor } from "./session.js";
+import { streamToTicket } from "./ticket.js";
+async function ask(question) {
+    const lines = createInterface({
+        input: process.stdin,
+        output: process.stderr,
+    });
+    try {
+        return await lines.question(question);
+    }
+    finally {
+        lines.close();
+    }
+}
+const interactive = () => Boolean(process.stdin.isTTY) && Boolean(process.stderr.isTTY);
+async function askFor(parameter) {
+    const choices = parameter.enum ? ` (${parameter.enum.join(', ')})` : '';
+    const what = parameter.description
+        ? `${parameterLabel(parameter)}, ${parameter.description.replace(/\.$/u, '')}`
+        : parameterLabel(parameter);
+    for (;;) {
+        const answer = (await ask(`${what}${choices}: `)).trim();
+        if (answer !== '')
+            return answer;
+    }
+}
+/** This machine, as the parser reads it: files relative to `cwd`, this process's environment, and its terminal. */
+export function localIo(cwd) {
+    return {
+        readText: (file) => readFile(path.resolve(cwd, file), 'utf8').catch(() => undefined),
+        env: (name) => process.env[name],
+        file: async (file) => {
+            const full = path.resolve(cwd, file);
+            const info = await stat(full).catch(() => undefined);
+            return info?.isFile()
+                ? { path: full, name: path.basename(full), size: info.size }
+                : undefined;
+        },
+        changed: (spec, flag) => changedFiles(spec, flag, cwd),
+        ...(interactive() ? { ask: askFor } : {}),
+    };
+}
+/** Reads the rest of the line against the command's parameters; files are read relative to `cwd`. */
+export async function parseRestCall(command, rest, cwd = process.cwd()) {
+    let call;
+    try {
+        call = await parseCommandLine(command, rest, {
+            bin: appCliConfig().bin,
+            io: localIo(cwd),
+            yes: globalFlags().yes,
+            dryRun: globalFlags().dryRun,
+        });
+    }
+    catch (error) {
+        // A plain usage error stays one, so it reads as before: its message, with no suggestions.
+        if (error instanceof CliParseError)
+            throw error.code === 'INVALID_USAGE' && error.suggestions.length === 0
+                ? new UsageError(error.message, error.exit)
+                : new CliCommandError(error.code, error.message, {
+                    exit: error.exit,
+                    suggestions: error.suggestions,
+                    details: error.details,
+                });
+        throw error;
+    }
+    return call.out === undefined
+        ? call
+        : { ...call, out: path.resolve(cwd, call.out) };
+}
+/** Uploads each file of the call's upload parameters; the ids, by parameter. */
+async function uploadAll(session, call, options, uploaded) {
+    const ids = new Map();
+    for (const [parameter, files] of call.uploads) {
+        const upload = parameter.upload;
+        if (!upload)
+            continue;
+        const list = [];
+        for (const file of files) {
+            const form = new FormData();
+            form.append(upload.part, new File([await openAsBlob(file.path)], file.name, {
+                type: mediaTypeOf(file.name),
+            }));
+            const answer = await send(urlFor(session.server, upload.path), {
+                method: upload.method,
+                headers: { accept: 'application/json', ...session.headers },
+                body: form,
+            }, { ...options, timeoutMs: options.timeoutMs ?? 30 * 60_000 });
+            const id = answer?.data?.id;
+            if (typeof id !== 'string')
+                throw new AppApiError(0, 'UPLOAD_FAILED', `${upload.path} answered no id for ${file.name}.`);
+            uploaded.push({ path: upload.path, id });
+            list.push(id);
+        }
+        ids.set(parameter, list);
+    }
+    return ids;
+}
+/** Removes what was uploaded for a request that then failed; a removal that fails leaves the upload to expire. */
+async function discard(session, uploaded, options) {
+    for (const { path: uploadPath, id } of uploaded)
+        await send(urlFor(session.server, `${uploadPath.replace(/\/+$/u, '')}/${encodeURIComponent(id)}`), { method: 'DELETE', headers: session.headers }, options).catch(() => undefined);
+}
+/** The request a call makes: its URL, and its body. */
+export async function buildRequest(session, command, call, uploadedIds = new Map()) {
+    const filled = fillRequest(command, call.values, call.bodyFile);
+    const fields = filled.fields;
+    for (const [parameter, ids] of uploadedIds)
+        fields[parameter.field] = parameter.upload?.multiple ? ids : ids[0];
+    // An optional ticket file says it is coming: the route answers a ticket rather than its own result.
+    const ticketParameter = command.parameters.find((parameter) => parameter.ticket?.optional);
+    if (ticketParameter && call.ticket)
+        fields[ticketParameter.field] = call.ticket.name;
+    const url = urlFor(session.server, filled.path);
+    if (!command.body && !call.changed)
+        return { url };
+    // Changed files go as parts beside the fields; without files a JSON body keeps line breaks as they are.
+    if (call.changed)
+        fields[call.changed.field] = [...call.changed.files];
+    if (call.changed || command.body?.media === 'multipart/form-data') {
+        const form = new FormData();
+        for (const [field, value] of Object.entries(fields)) {
+            const items = Array.isArray(value) ? value : [value];
+            for (const item of items) {
+                if (item === undefined || item === null)
+                    continue;
+                if (item && typeof item === 'object' && 'path' in item) {
+                    const local = item;
+                    form.append(field, new File([await openAsBlob(local.path)], local.name, {
+                        type: mediaTypeOf(local.name),
+                    }));
+                }
+                else
+                    form.append(field, requestText(item));
+            }
+        }
+        return { url, body: form };
+    }
+    return { url, body: JSON.stringify(fields), type: 'application/json' };
+}
+/** Sends the call; the API's answer, or for a download the saved file. */
+export async function executeRest(session, command, call, options = {}) {
+    if (command.confirm && !call.yes && !globalFlags().yes) {
+        if (!interactive())
+            throw new CliCommandError('CONFIRMATION_REQUIRED', `${command.confirm} Nothing was done without a terminal to ask in.`, {
+                exit: EXIT_CODES.validation,
+                suggestions: [{ message: 'Pass --yes to go ahead without asking.' }],
+            });
+        const answer = (await ask(`${command.confirm} [y/N] `)).trim();
+        if (!/^y(es)?$/iu.test(answer))
+            throw new UsageError('Not done.', EXIT_CODES.general);
+    }
+    const uploaded = [];
+    try {
+        const ids = await uploadAll(session, call, options, uploaded);
+        const { url, body, type } = await buildRequest(session, command, call, ids);
+        const init = {
+            method: command.method,
+            headers: {
+                accept: command.output.kind === 'download' ? '*/*' : 'application/json',
+                ...(type ? { 'content-type': type } : {}),
+                ...session.headers,
+            },
+            ...(body === undefined ? {} : { body }),
+        };
+        if (command.output.kind === 'download') {
+            const saved = await download(url, init, call.out, options);
+            return {
+                data: saved.data,
+                ...(saved.message ? { meta: { message: saved.message } } : {}),
+            };
+        }
+        const answer = (await send(url, init, options));
+        if (call.ticket) {
+            const uploaded = await streamToTicket(session, answer?.data, call.ticket, options);
+            return {
+                data: uploaded.data,
+                ...(uploaded.message ? { meta: { message: uploaded.message } } : {}),
+            };
+        }
+        return {
+            data: answer?.data ?? null,
+            ...(answer?.meta ? { meta: answer.meta } : {}),
+        };
+    }
+    catch (error) {
+        await discard(session, uploaded, options);
+        throw error;
+    }
+}
+//# sourceMappingURL=rest.js.map

package/dist/dynamic/rest.js.map

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

package/dist/dynamic/session.d.ts

@@ -0,0 +1,20 @@
+import { type AppCliConfig, type AppCliPaths } from '../config.ts';
+export interface Session {
+    readonly kind: 'run' | 'user';
+    /** As configured: `https://host/app`. */
+    readonly server: string;
+    readonly headers: Readonly<Record<string, string>>;
+    /** Where the manifest is, relative to the origin. */
+    readonly manifestPath: string;
+    /** Separates cached manifests: one per run, one for the user. */
+    readonly cacheKey: string;
+}
+/** `path` (origin-relative, or relative to the server when it has no leading slash) as a URL. */
+export declare function urlFor(server: string, path: string): URL;
+/** A route of the server (`/api/...`) below the base path its address has, such as `/app/api/...`. */
+export declare function serverPath(server: string, route: string): string;
+/** The session for `cwd`, or undefined when the CLI is neither in a run nor signed in. */
+export declare function currentSession(cwd?: string, paths?: AppCliPaths, config?: AppCliConfig): Promise<Session | undefined>;
+/** Where the session's manifest is cached, found without reading any key: what completion reads. */
+export declare function peekSession(cwd?: string, paths?: AppCliPaths, config?: AppCliConfig): Promise<Pick<Session, 'server' | 'cacheKey'> | undefined>;
+//# sourceMappingURL=session.d.ts.map

package/dist/dynamic/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/dynamic/session.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAUtB,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,iGAAiG;AACjG,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAKxD;AAED,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhE;AAOD,0FAA0F;AAC1F,wBAAsB,cAAc,CAClC,GAAG,GAAE,MAAsB,EAC3B,KAAK,GAAE,WAA2B,EAClC,MAAM,GAAE,YAA6B,GACpC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAyB9B;AAED,oGAAoG;AACpG,wBAAsB,WAAW,CAC/B,GAAG,GAAE,MAAsB,EAC3B,KAAK,GAAE,WAA2B,EAClC,MAAM,GAAE,YAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG,SAAS,CAAC,CAgB3D"}

package/dist/dynamic/session.js

@@ -0,0 +1,70 @@
+// Who the business commands act as, and where they go. Inside a run's working directory the CLI is the run (the token
+// in the run's credentials file); anywhere else it is the user who signed in. Command and manifest paths are relative
+// to the server's origin (they already include any base path the application is served under).
+import { HEADERS } from '@nocobase/agent-protocol';
+import { appCliConfig, appCliPaths, manifestPathOf, } from "../config.js";
+import { credentialHeaders, findRunCredentials, peekUserConfig, readRunCredentials, readUserConfig, } from "../lib/credentials.js";
+import { globalFlags } from "../lib/globals.js";
+/** `path` (origin-relative, or relative to the server when it has no leading slash) as a URL. */
+export function urlFor(server, path) {
+    const base = new URL(server.endsWith('/') ? server : `${server}/`);
+    return path.startsWith('/')
+        ? new URL(path, base.origin)
+        : new URL(path, base);
+}
+/** A route of the server (`/api/...`) below the base path its address has, such as `/app/api/...`. */
+export function serverPath(server, route) {
+    const base = new URL(server).pathname.replace(/\/+$/u, '');
+    return `${base}${route.startsWith('/') ? '' : '/'}${route}`;
+}
+/** The manifest path the server would give for a server address with a base path. */
+function defaultManifestPath(server, config) {
+    return serverPath(server, manifestPathOf(config));
+}
+/** The session for `cwd`, or undefined when the CLI is neither in a run nor signed in. */
+export async function currentSession(cwd = process.cwd(), paths = appCliPaths(), config = appCliConfig()) {
+    const runFile = findRunCredentials(cwd, config);
+    if (runFile !== undefined) {
+        const run = await readRunCredentials(runFile);
+        return {
+            kind: 'run',
+            server: run.server,
+            headers: { [HEADERS.runToken]: run.token },
+            manifestPath: run.manifestUrl || defaultManifestPath(run.server, config),
+            cacheKey: `run-${run.runId}`,
+        };
+    }
+    const user = await readUserConfig({
+        paths,
+        config,
+        profile: globalFlags().profile,
+    });
+    if (user === undefined)
+        return undefined;
+    return {
+        kind: 'user',
+        server: user.server,
+        headers: credentialHeaders(user),
+        manifestPath: defaultManifestPath(user.server, config),
+        cacheKey: `user:${user.profile ?? 'env'}`,
+    };
+}
+/** Where the session's manifest is cached, found without reading any key: what completion reads. */
+export async function peekSession(cwd = process.cwd(), paths = appCliPaths(), config = appCliConfig()) {
+    const runFile = findRunCredentials(cwd, config);
+    if (runFile !== undefined) {
+        const run = await readRunCredentials(runFile).catch(() => undefined);
+        return run
+            ? { server: run.server, cacheKey: `run-${run.runId}` }
+            : undefined;
+    }
+    const user = await peekUserConfig({
+        paths,
+        config,
+        profile: globalFlags().profile,
+    });
+    return user
+        ? { server: user.server, cacheKey: `user:${user.profile ?? 'env'}` }
+        : undefined;
+}
+//# sourceMappingURL=session.js.map

package/dist/dynamic/session.js.map

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

package/dist/dynamic/ticket.d.ts

@@ -0,0 +1,13 @@
+import type { LocalFile } from './files.ts';
+import { type Session } from './session.ts';
+/** What the upload answered: its `data`, and its message or else the ticket's. */
+export interface TicketAnswer {
+    readonly data: unknown;
+    readonly message?: string;
+}
+/** Streams `file` to the ticket a request answered (`ticketData`, the answer's `data`). */
+export declare function streamToTicket(session: Session, ticketData: unknown, file: LocalFile, options: {
+    readonly fetch?: typeof fetch;
+    readonly timeoutMs?: number;
+}): Promise<TicketAnswer>;
+//# sourceMappingURL=ticket.d.ts.map

package/dist/dynamic/ticket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.d.ts","sourceRoot":"","sources":["../../src/dynamic/ticket.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAEpD,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,2FAA2F;AAC3F,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAAC,YAAY,CAAC,CA2CvB"}

package/dist/dynamic/ticket.js

@@ -0,0 +1,40 @@
+// A file sent beside a request (`ticket` on a manifest parameter): the request answers an upload ticket, and the file
+// is streamed straight to the ticket's URL with the ticket's headers only, never the session's. The upload's answer is
+// the command's.
+import { openAsBlob } from 'node:fs';
+import { UploadTicketSchema } from '@nocobase/agent-protocol';
+import { AppApiError } from "../lib/http.js";
+import { send } from "./execute.js";
+import { urlFor } from "./session.js";
+/** Streams `file` to the ticket a request answered (`ticketData`, the answer's `data`). */
+export async function streamToTicket(session, ticketData, file, options) {
+    const parsed = UploadTicketSchema.safeParse(ticketData);
+    if (!parsed.success)
+        throw new AppApiError(0, 'UPLOAD_FAILED', 'The server answered no upload ticket.');
+    const ticket = parsed.data;
+    const url = urlFor(session.server, ticket.url);
+    if (url.protocol !== 'http:' && url.protocol !== 'https:')
+        throw new AppApiError(0, 'INVALID_REQUEST', `The upload ticket points at ${url.protocol}, which the CLI does not send to.`);
+    // A file-backed Blob: the body is read from disk as it is sent, never held in memory whole.
+    const answer = await send(url, {
+        method: ticket.method,
+        headers: {
+            accept: 'application/json',
+            'content-type': 'application/gzip',
+            // The file's own name, for a ticket that does not know it.
+            'content-disposition': `attachment; filename*=UTF-8''${encodeURIComponent(file.name)}`,
+            ...ticket.headers,
+        },
+        body: await openAsBlob(file.path),
+    }, { ...options, timeoutMs: options.timeoutMs ?? 30 * 60_000 });
+    const record = answer && typeof answer === 'object'
+        ? answer
+        : undefined;
+    const data = record && 'data' in record ? record.data : (answer ?? null);
+    // The upload's own message says what it became; the ticket's is said before the file was sent.
+    const message = typeof record?.meta?.message === 'string'
+        ? record.meta.message
+        : ticket.message;
+    return { data, ...(message ? { message } : {}) };
+}
+//# sourceMappingURL=ticket.js.map

package/dist/dynamic/ticket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket.js","sourceRoot":"","sources":["../../src/dynamic/ticket.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,uHAAuH;AACvH,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAgB,MAAM,cAAc,CAAC;AAQpD,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgB,EAChB,UAAmB,EACnB,IAAe,EACf,OAAuE;IAEvE,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO;QACjB,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,eAAe,EACf,uCAAuC,CACxC,CAAC;IACJ,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QACvD,MAAM,IAAI,WAAW,CACnB,CAAC,EACD,iBAAiB,EACjB,+BAA+B,GAAG,CAAC,QAAQ,mCAAmC,CAC/E,CAAC;IACJ,4FAA4F;IAC5F,MAAM,MAAM,GAAG,MAAM,IAAI,CACvB,GAAG,EACH;QACE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE;YACP,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;YAClC,2DAA2D;YAC3D,qBAAqB,EAAE,gCAAgC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACtF,GAAG,MAAM,CAAC,OAAO;SAClB;QACD,IAAI,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;KAClC,EACD,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,GAAG,MAAM,EAAE,CAC5D,CAAC;IACF,MAAM,MAAM,GACV,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAClC,CAAC,CAAE,MAA2D;QAC9D,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IACzE,+FAA+F;IAC/F,MAAM,OAAO,GACX,OAAO,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,QAAQ;QACvC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO;QACrB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IACrB,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/hooks/command-not-found.d.ts

@@ -0,0 +1,4 @@
+import type { Hook } from '@oclif/core';
+declare const hook: Hook.CommandNotFound;
+export default hook;
+//# sourceMappingURL=command-not-found.d.ts.map

package/dist/hooks/command-not-found.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-not-found.d.ts","sourceRoot":"","sources":["../../src/hooks/command-not-found.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAIxC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,eAEhB,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/hooks/command-not-found.js

@@ -0,0 +1,6 @@
+import { getOriginalArgv, runDynamic } from "../dynamic/index.js";
+const hook = async function () {
+    await runDynamic(getOriginalArgv());
+};
+export default hook;
+//# sourceMappingURL=command-not-found.js.map

package/dist/hooks/command-not-found.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-not-found.js","sourceRoot":"","sources":["../../src/hooks/command-not-found.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,IAAI,GAAyB,KAAK;IACtC,MAAM,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { runAppCli, type RunAppCliOptions } from './run.ts';
+export { appCliConfigOf, readAppCliPackage, runAppCliPackage, type AppCliBrand, type AppCliPackageInfo, } from './brand.ts';
+export type { AppCliAuth, AppCliConfig, AppCliSelfUpdate, AppCliSession, } from './config.ts';
+export { HINT_INTERVAL_MS, updateCli, updatedBy, updateHint, type CliUpdateResult, type UpdatedBy, type UpdateEnvironment, } from './update.ts';
+export { currentSession, type Session } from './dynamic/session.ts';
+export type { CliCommand, CliManifest, CliParameter, CliWithheldCommand, } from './dynamic/manifest.ts';
+export { fillRequest, requestText, type FilledRequest, type RequestCommand, type RequestParameter, } from './request.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+// A branded command line for a NocoBase application. It ships no business commands: `login`, `logout`, `whoami`,
+// `profile`, `docs` and `completion` are its own, and every other command comes from the command manifest the
+// application publishes for the caller (`GET /api/cli/manifest`), each a request to one API route.
+//
+// An application declares its CLI under `nocobase.cli` in its `package.json` (`AppCliBrand`), and `nocobase cli build`
+// of `@nocobase/app-cli` packages it with an entry that calls `runAppCliPackage`. A CLI may also call `runAppCli` with
+// an `AppCliConfig` of its own and add static commands. A CLI the application's install script installs names
+// `selfUpdate` and gets `<bin> update`; the installation layout is `@nocobase/app-cli-client/install`.
+export { runAppCli } from "./run.js";
+export { appCliConfigOf, readAppCliPackage, runAppCliPackage, } from "./brand.js";
+export { HINT_INTERVAL_MS, updateCli, updatedBy, updateHint, } from "./update.js";
+export { currentSession } from "./dynamic/session.js";
+export { fillRequest, requestText, } from "./request.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,8GAA8G;AAC9G,mGAAmG;AACnG,EAAE;AACF,uHAAuH;AACvH,uHAAuH;AACvH,8GAA8G;AAC9G,uGAAuG;AACvG,OAAO,EAAE,SAAS,EAAyB,MAAM,UAAU,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GAGjB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,UAAU,GAIX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAC;AAOpE,OAAO,EACL,WAAW,EACX,WAAW,GAIZ,MAAM,cAAc,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,72 @@
+import type { z } from 'zod';
+import { type DistArtifact } from '@nocobase/agent-protocol';
+export interface Installation {
+    prefix: string;
+    /** This version's directory, `<prefix>/versions/<version>`. */
+    versionDir: string;
+    version: string;
+    /** `<prefix>/current`. */
+    current: string;
+    /** The command link the install script made, if it recorded one. */
+    binLink?: string;
+    /**
+     * What the install script set up: the CLI alone (`<bin> update` updates it), or a runtime (the runner updates
+     * itself). Installations from before the CLI could be installed alone are runtimes.
+     */
+    mode: 'cli' | 'runner';
+}
+/** The installation whose version directory is `root`, the root of the installed package; undefined for any other. */
+export declare function detectInstallation(root: string): Installation | undefined;
+/** The command that starts whichever version is current. */
+export declare function launcherOf(installation: Pick<Installation, 'current'>, bin: string): string;
+export declare class ChecksumError extends Error {
+    name: string;
+}
+export declare function sha256Of(bytes: Uint8Array): string;
+/**
+ * Checks `bytes` against `sha256` and unpacks the standalone tarball into `dest` (its top directory stripped), through
+ * a sibling `.partial` directory so `dest` is either complete or absent.
+ */
+export declare function unpackTarball(bytes: Uint8Array, sha256: string, dest: string): Promise<void>;
+/** Points `<prefix>/current` at `version`, replacing the link in one rename. */
+export declare function activateVersion(installation: Pick<Installation, 'prefix' | 'current'>, version: string): Promise<void>;
+/** The version `current` points at. */
+export declare function currentVersion(installation: Pick<Installation, 'current'>): Promise<string | undefined>;
+/** Removes every version but `keep`. */
+export declare function pruneVersions(installation: Pick<Installation, 'prefix'>, keep: readonly string[]): Promise<string[]>;
+/** What to update to: a version, where its tarball is, and its checksum. */
+export interface UpdateTarget {
+    version: string;
+    url: string;
+    sha256: string;
+}
+/** Reads a `{ data }` answer of the application, as a JSON client with the caller's credential does. */
+export interface ArtifactReader {
+    get<T>(route: string, schema: z.ZodType<T>): Promise<T>;
+}
+/** Downloads a file of the application, with the caller's credential. */
+export interface ArtifactDownloader {
+    download(route: string): Promise<Uint8Array>;
+}
+/** The newest version of `product` the application serves for `target`. */
+export declare function latestArtifact(client: ArtifactReader, product: string, target?: string): Promise<DistArtifact>;
+export declare function isNewer(candidate: string, running: string): boolean;
+export interface ApplyUpdateOptions {
+    installation: Pick<Installation, 'prefix' | 'current'>;
+    /** The command the tarball carries, `bin/<bin>`; also how the log names it. */
+    bin: string;
+    client: ArtifactDownloader;
+    update: UpdateTarget;
+    log?: (message: string) => void;
+}
+/** What `applyUpdate` replaced: the version `current` pointed at, and the versions it removed. */
+export interface AppliedUpdate {
+    previous: string | undefined;
+    removed: string[];
+}
+/**
+ * Installs `update` beside the running version and makes it current; the previous version stays until the next
+ * update, so a bad one can be switched back by hand. The process has to restart to run it.
+ */
+export declare function applyUpdate(options: ApplyUpdateOptions): Promise<AppliedUpdate>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

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