@copado/agentia-cli 0.57.0-alpha.0 → 0.59.0-alpha.0

package/dist/lib/function-flags.js

@@ -0,0 +1,199 @@
+import { Flags } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { FUNCTION_RUNTIME_EXTENSION, FUNCTION_RUNTIMES, normalizeFunctionUpsertPayload, parseParameterAssignments, } from './function-types.js';
+export const functionUpsertFlags = {
+    'apex-class': Flags.string({
+        description: 'Apex callback class',
+    }),
+    callback: Flags.string({
+        description: 'Function callback type',
+    }),
+    description: Flags.string({
+        description: 'Function description',
+    }),
+    file: Flags.string({
+        description: 'Path to a JSON file with the full upsert payload (overrides individual script flags)',
+    }),
+    'flow-handler': Flags.string({
+        description: 'Flow handler name',
+    }),
+    'image-name': Flags.string({
+        description: 'Function container image',
+    }),
+    name: Flags.string({
+        description: 'Function display name (defaults to the API name argument)',
+    }),
+    'parameters-file': Flags.string({
+        description: 'Path to a JSON file containing the parameters array',
+    }),
+    runtime: Flags.string({
+        description: 'Script runtime',
+        options: [...FUNCTION_RUNTIMES],
+    }),
+    script: Flags.string({
+        description: 'Inline script content',
+    }),
+    'script-file': Flags.string({
+        description: 'Path to a file whose contents become the script',
+    }),
+    size: Flags.string({
+        description: 'Function size',
+    }),
+    timeout: Flags.integer({
+        description: 'Function timeout in seconds',
+    }),
+    type: Flags.string({
+        description: 'Function type',
+    }),
+    version: Flags.string({
+        description: 'Function version',
+    }),
+};
+export const functionDefaultsFlags = {
+    'image-name': Flags.string({
+        default: 'copado-function-core:v1',
+        description: 'Function container image',
+    }),
+    name: Flags.string({
+        description: 'Function display name used to scaffold defaults',
+        required: true,
+    }),
+    runtime: Flags.string({
+        default: 'bash',
+        description: 'Script runtime',
+        options: [...FUNCTION_RUNTIMES],
+    }),
+};
+export const functionRunFlags = {
+    'context-id': Flags.string({
+        description: 'Execution context Id',
+    }),
+    'deploy-first': Flags.boolean({
+        default: false,
+        description: 'Deploy related metadata before running the function',
+    }),
+    parameter: Flags.string({
+        description: 'Run parameter as key=value (repeatable)',
+        multiple: true,
+    }),
+    'show-validation-errors': Flags.boolean({
+        allowNo: true,
+        default: true,
+        description: 'Surface validation errors from the gateway',
+    }),
+};
+async function readJsonFile(path, label) {
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch (error) {
+        throw new Error(`Unable to read ${label} file ${path}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${label} file ${path} is not valid JSON.`);
+    }
+}
+function buildScript(flags, content) {
+    const runtime = (flags.runtime ?? 'bash');
+    return {
+        content,
+        extension: FUNCTION_RUNTIME_EXTENSION[runtime],
+        runtime,
+    };
+}
+async function resolveScriptContent(flags) {
+    if (flags.script !== undefined && flags['script-file'] !== undefined) {
+        throw new Error('Cannot provide --script and --script-file together.');
+    }
+    if (flags.script !== undefined) {
+        return flags.script;
+    }
+    if (flags['script-file'] === undefined) {
+        throw new Error('Must provide --script, --script-file, or --file.');
+    }
+    try {
+        return await readFile(flags['script-file'], 'utf8');
+    }
+    catch (error) {
+        throw new Error(`Unable to read script file ${flags['script-file']}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function resolveParameters(flags) {
+    if (flags['parameters-file'] === undefined) {
+        return undefined;
+    }
+    const parameters = await readJsonFile(flags['parameters-file'], 'Parameters');
+    if (!Array.isArray(parameters)) {
+        throw new TypeError('Parameters file must contain a JSON array.');
+    }
+    return parameters;
+}
+function applyOptionalUpsertFields(payload, flags, parameters) {
+    return {
+        ...payload,
+        ...(flags.description === undefined ? {} : { description: flags.description }),
+        ...(flags['apex-class'] === undefined ? {} : { apexClass: flags['apex-class'] }),
+        ...(flags.callback === undefined ? {} : { callback: flags.callback }),
+        ...(flags['flow-handler'] === undefined ? {} : { flowHandler: flags['flow-handler'] }),
+        ...(flags.timeout === undefined ? {} : { timeout: flags.timeout }),
+        ...(parameters === undefined ? {} : { parameters }),
+    };
+}
+export async function buildFunctionUpsertPayload(apiName, flags) {
+    if (flags.file !== undefined) {
+        const conflictingFlags = Object.entries(flags)
+            .filter(([key, value]) => key !== 'file' && value !== undefined)
+            .map(([key]) => `--${key}`);
+        if (conflictingFlags.length > 0) {
+            throw new Error(`Cannot combine --file with payload flags: ${conflictingFlags.join(', ')}.`);
+        }
+        const fromFile = await readJsonFile(flags.file, 'Upsert');
+        return normalizeFunctionUpsertPayload(apiName, fromFile);
+    }
+    const scriptContent = await resolveScriptContent(flags);
+    const parameters = await resolveParameters(flags);
+    const payload = {
+        apiName,
+        imageName: flags['image-name'] ?? 'copado-function-core:v1',
+        name: flags.name?.trim() || apiName,
+        script: buildScript(flags, scriptContent),
+        size: flags.size ?? 'S',
+        type: flags.type ?? 'Custom',
+        version: flags.version ?? '1',
+    };
+    return normalizeFunctionUpsertPayload(apiName, applyOptionalUpsertFields(payload, flags, parameters));
+}
+export function buildFunctionDefaultsPayload(flags) {
+    return {
+        imageName: flags['image-name'] ?? 'copado-function-core:v1',
+        name: flags.name,
+        runtime: (flags.runtime ?? 'bash'),
+    };
+}
+export function buildFunctionRunPayload(flags) {
+    try {
+        const parameters = parseParameterAssignments(flags.parameter);
+        return {
+            payload: {
+                deployFirst: flags['deploy-first'] ?? false,
+                showValidationErrors: flags['show-validation-errors'] ?? true,
+                ...(flags['context-id'] === undefined ? {} : { contextId: flags['context-id'] }),
+                ...(parameters === undefined ? {} : { parameters }),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            error: error instanceof Error ? error.message : String(error),
+            payload: {
+                deployFirst: false,
+                showValidationErrors: true,
+            },
+        };
+    }
+}
+//# sourceMappingURL=function-flags.js.map

package/dist/lib/function-flags.js.map

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

package/dist/lib/function-local-run.d.ts

@@ -0,0 +1,64 @@
+import { type FunctionRuntime } from './function-types.js';
+/** Default Copado Function image; partners can override when the Copado registry is unavailable. */
+export declare const DEFAULT_FUNCTION_LOCAL_IMAGE = "copado-function-core:v1";
+/** Container working directory (matches Copado Function runtime). */
+export declare const FUNCTION_LOCAL_CONTAINER_APP_DIR = "/app";
+/** Fixed container path for the function script (matches Copado Function runtime). */
+export declare const FUNCTION_LOCAL_CONTAINER_SCRIPT_PATH = "/tmp/cf_function.sh";
+export type LocalFunctionRunInvocation = {
+    args: string[];
+    command: string;
+    display: string;
+};
+export type LocalFunctionRunResult = {
+    args: string[];
+    command: string;
+    cwd: string;
+    exitCode: null | number;
+    image: string;
+    runtime: FunctionRuntime;
+    script: string;
+    stderr: string;
+    stdout: string;
+};
+export type LocalFunctionProcessRunner = (invocation: LocalFunctionRunInvocation, options: {
+    cwd: string;
+}) => Promise<{
+    exitCode: null | number;
+    stderr: string;
+    stdout: string;
+}>;
+export declare function runtimeFromFunctionScriptPath(scriptPath: string): FunctionRuntime;
+export declare function runtimeInterpreter(runtime: FunctionRuntime): string;
+export declare function resolveLocalFunctionRuntime(scriptPath: string, runtimeFlag: string | undefined): FunctionRuntime;
+export declare function assertLocalFunctionScriptReadable(scriptPath: string): Promise<string>;
+/**
+ * Host directory bind-mounted at `/app`.
+ * Defaults to the current process working directory (workspace root when invoked from a project).
+ */
+export declare function resolveLocalFunctionHostAppDir(cwdFlag: string | undefined): string;
+export declare function buildDockerLocalFunctionRunInvocation(options: {
+    env?: Record<string, string>;
+    hostAppDir: string;
+    image: string;
+    platform?: string;
+    runtime: FunctionRuntime;
+    scriptPath: string;
+}): LocalFunctionRunInvocation;
+export declare function runLocalFunctionProcess(invocation: LocalFunctionRunInvocation, options: {
+    cwd: string;
+}): Promise<{
+    exitCode: null | number;
+    stderr: string;
+    stdout: string;
+}>;
+export declare function executeLocalFunctionRun(options: {
+    cwd?: string;
+    image?: string;
+    parameter?: string[];
+    platform?: string;
+    runProcess?: LocalFunctionProcessRunner;
+    runtime?: string;
+    script: string;
+}): Promise<LocalFunctionRunResult>;
+export declare function formatLocalFunctionRunResult(result: LocalFunctionRunResult): string;

package/dist/lib/function-local-run.js

@@ -0,0 +1,148 @@
+import { spawn } from 'node:child_process';
+import { access } from 'node:fs/promises';
+import path from 'node:path';
+import { FUNCTION_RUNTIMES, parseParameterAssignments } from './function-types.js';
+/** Default Copado Function image; partners can override when the Copado registry is unavailable. */
+export const DEFAULT_FUNCTION_LOCAL_IMAGE = 'copado-function-core:v1';
+/** Container working directory (matches Copado Function runtime). */
+export const FUNCTION_LOCAL_CONTAINER_APP_DIR = '/app';
+/** Fixed container path for the function script (matches Copado Function runtime). */
+export const FUNCTION_LOCAL_CONTAINER_SCRIPT_PATH = '/tmp/cf_function.sh';
+export function runtimeFromFunctionScriptPath(scriptPath) {
+    const normalized = scriptPath.replaceAll('\\', '/').toLowerCase();
+    if (normalized.endsWith('.js')) {
+        return 'node';
+    }
+    if (normalized.endsWith('.py')) {
+        return 'python';
+    }
+    return 'bash';
+}
+export function runtimeInterpreter(runtime) {
+    if (runtime === 'node') {
+        return 'node';
+    }
+    if (runtime === 'python') {
+        return 'python3';
+    }
+    return 'bash';
+}
+export function resolveLocalFunctionRuntime(scriptPath, runtimeFlag) {
+    if (runtimeFlag === undefined) {
+        return runtimeFromFunctionScriptPath(scriptPath);
+    }
+    if (!FUNCTION_RUNTIMES.includes(runtimeFlag)) {
+        throw new Error(`Unsupported runtime "${runtimeFlag}". Expected one of: ${FUNCTION_RUNTIMES.join(', ')}.`);
+    }
+    return runtimeFlag;
+}
+export async function assertLocalFunctionScriptReadable(scriptPath) {
+    const resolved = path.resolve(scriptPath);
+    try {
+        await access(resolved);
+    }
+    catch {
+        throw new Error(`Function script not found or unreadable: ${resolved}`);
+    }
+    return resolved;
+}
+/**
+ * Host directory bind-mounted at `/app`.
+ * Defaults to the current process working directory (workspace root when invoked from a project).
+ */
+export function resolveLocalFunctionHostAppDir(cwdFlag) {
+    if (cwdFlag === undefined || cwdFlag.trim().length === 0) {
+        return process.cwd();
+    }
+    return path.resolve(cwdFlag);
+}
+export function buildDockerLocalFunctionRunInvocation(options) {
+    const image = options.image.trim();
+    if (image.length === 0) {
+        throw new Error('Docker image must not be empty. Pass --image to override the default Copado Function image.');
+    }
+    const args = ['run', '--rm'];
+    if (options.platform !== undefined && options.platform.trim().length > 0) {
+        args.push('--platform', options.platform.trim());
+    }
+    for (const [key, value] of Object.entries(options.env ?? {})) {
+        args.push('-e', `${key}=${value}`);
+    }
+    args.push('-v', `${options.hostAppDir}:${FUNCTION_LOCAL_CONTAINER_APP_DIR}`, '-v', `${options.scriptPath}:${FUNCTION_LOCAL_CONTAINER_SCRIPT_PATH}`, '-w', FUNCTION_LOCAL_CONTAINER_APP_DIR, image, runtimeInterpreter(options.runtime), FUNCTION_LOCAL_CONTAINER_SCRIPT_PATH);
+    return {
+        args,
+        command: 'docker',
+        display: `docker ${args.join(' ')}`,
+    };
+}
+export function runLocalFunctionProcess(invocation, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(invocation.command, invocation.args, {
+            cwd: options.cwd,
+            env: process.env,
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on('error', (error) => {
+            reject(error);
+        });
+        child.on('close', (code) => {
+            resolve({ exitCode: code, stderr, stdout });
+        });
+    });
+}
+export async function executeLocalFunctionRun(options) {
+    const script = await assertLocalFunctionScriptReadable(options.script);
+    const runtime = resolveLocalFunctionRuntime(script, options.runtime);
+    const hostAppDir = resolveLocalFunctionHostAppDir(options.cwd);
+    const image = options.image === undefined || options.image.trim().length === 0
+        ? DEFAULT_FUNCTION_LOCAL_IMAGE
+        : options.image.trim();
+    const env = parseParameterAssignments(options.parameter);
+    const invocation = buildDockerLocalFunctionRunInvocation({
+        hostAppDir,
+        image,
+        runtime,
+        scriptPath: script,
+        ...(env === undefined ? {} : { env }),
+        ...(options.platform === undefined ? {} : { platform: options.platform }),
+    });
+    const runProcess = options.runProcess ?? runLocalFunctionProcess;
+    const processResult = await runProcess(invocation, { cwd: hostAppDir });
+    return {
+        args: invocation.args,
+        command: invocation.command,
+        cwd: hostAppDir,
+        exitCode: processResult.exitCode,
+        image,
+        runtime,
+        script,
+        stderr: processResult.stderr,
+        stdout: processResult.stdout,
+    };
+}
+export function formatLocalFunctionRunResult(result) {
+    const lines = [
+        `Script: ${result.script}`,
+        `Runtime: ${result.runtime}`,
+        `Image: ${result.image}`,
+        `Command: ${result.command} ${result.args.join(' ')}`,
+        `App mount (/app): ${result.cwd}`,
+        `Container script: ${FUNCTION_LOCAL_CONTAINER_SCRIPT_PATH}`,
+        `Exit code: ${result.exitCode ?? 'null'}`,
+    ];
+    if (result.stdout.trim().length > 0) {
+        lines.push('', 'stdout:', result.stdout.endsWith('\n') ? result.stdout.slice(0, -1) : result.stdout);
+    }
+    if (result.stderr.trim().length > 0) {
+        lines.push('', 'stderr:', result.stderr.endsWith('\n') ? result.stderr.slice(0, -1) : result.stderr);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=function-local-run.js.map

package/dist/lib/function-local-run.js.map

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

package/dist/lib/function-types.d.ts

@@ -0,0 +1,106 @@
+export declare const FUNCTION_LIST_TYPES: readonly ["custom", "all"];
+export type FunctionListType = (typeof FUNCTION_LIST_TYPES)[number];
+export declare const FUNCTION_RUNTIMES: readonly ["bash", "node", "python"];
+export type FunctionRuntime = (typeof FUNCTION_RUNTIMES)[number];
+export declare const FUNCTION_EXTENSIONS: readonly ["sh", "js", "py"];
+export type FunctionExtension = (typeof FUNCTION_EXTENSIONS)[number];
+export declare const FUNCTION_RUNTIME_EXTENSION: Record<FunctionRuntime, FunctionExtension>;
+export type FunctionParameter = {
+    defaultValue?: string;
+    name: string;
+    required?: boolean;
+};
+export type FunctionScript = {
+    content?: string;
+    extension?: FunctionExtension;
+    runtime?: FunctionRuntime;
+};
+export type CopadoFunction = {
+    apexClass?: null | string;
+    apiName: string;
+    callback?: null | string;
+    description?: null | string;
+    flowHandler?: null | string;
+    id?: null | string;
+    imageName?: null | string;
+    name: string;
+    options?: null | Record<string, unknown>[];
+    ownerName?: null | string;
+    parameters?: FunctionParameter[];
+    script?: FunctionScript | null;
+    size?: null | string;
+    timeout?: null | number;
+    type?: null | string;
+    version?: null | string;
+};
+export type FunctionUpsertPayload = {
+    apexClass?: null | string;
+    apiName: string;
+    callback?: null | string;
+    description?: null | string;
+    flowHandler?: null | string;
+    imageName?: string;
+    name: string;
+    parameters?: FunctionParameter[];
+    script: FunctionScript;
+    size?: string;
+    timeout?: null | number;
+    type?: string;
+    version?: string;
+};
+export type FunctionUpsertInput = Omit<Partial<FunctionUpsertPayload>, 'script'> & {
+    script?: Partial<FunctionScript>;
+};
+export type FunctionCreateDefaultsPayload = {
+    imageName?: string;
+    name: string;
+    runtime?: FunctionRuntime;
+};
+export type FunctionRunPayload = {
+    contextId?: null | string;
+    deployFirst?: boolean;
+    function?: FunctionUpsertPayload | null;
+    parameters?: null | Record<string, string>;
+    showValidationErrors?: boolean;
+};
+export type FunctionRunResult = {
+    apiName: string;
+    resultId: string;
+    status: string;
+};
+export type FunctionResultStatus = {
+    messages?: null | string[];
+    resultData?: unknown;
+    resultId: string;
+    status: string;
+};
+export type FunctionsListResponse = CopadoFunction[] | {
+    data?: CopadoFunction[];
+};
+export type FunctionResponse = CopadoFunction | {
+    data?: CopadoFunction;
+};
+export type FunctionRunResponse = FunctionRunResult | {
+    data?: FunctionRunResult;
+};
+export type FunctionResultStatusResponse = FunctionResultStatus | {
+    data?: FunctionResultStatus;
+};
+export type FunctionListFilters = {
+    type?: FunctionListType;
+};
+export declare function functionsEndpoint(filters?: FunctionListFilters): string;
+export declare function functionEndpoint(apiName: string): string;
+export declare function functionRunEndpoint(apiName: string): string;
+export declare function functionResultEndpoint(resultId: string): string;
+export declare function functionResultLogEndpoint(resultId: string, fileType?: string): string;
+export declare function normalizeFunctionUpsertPayload(apiNameValue: string, input: FunctionUpsertInput): FunctionUpsertPayload;
+export declare function normalizeFunctionsList(response: FunctionsListResponse): CopadoFunction[];
+export declare function normalizeFunction(response: FunctionResponse): CopadoFunction;
+export declare function normalizeFunctionRunResult(response: FunctionRunResponse): FunctionRunResult;
+export declare function normalizeFunctionResultStatus(response: FunctionResultStatusResponse): FunctionResultStatus;
+export declare function formatFunctionTable(functions: CopadoFunction[]): string;
+export declare function formatFunctionDetail(fn: CopadoFunction): string;
+export declare function formatFunctionRunResult(result: FunctionRunResult): string;
+export declare function formatFunctionResultStatus(result: FunctionResultStatus): string;
+export declare function parseParameterAssignments(values: string[] | undefined): Record<string, string> | undefined;