@firestartr/cli 1.47.0 → 1.48.0

package/build/packages/catalog_common/index.d.ts

@@ -88,5 +88,13 @@ declare const _default: {
             allowedOps: string[];
         }[];
     };
+    logger: {
+        error: (...args: any) => void;
+        warn: (...args: any) => void;
+        info: (...args: any) => void;
+        debug: (...args: any) => void;
+        verbose: (...args: any) => void;
+        silly: (...args: any) => void;
+    };
 };
 export default _default;

package/build/packages/catalog_common/src/io/write.d.ts

@@ -5,5 +5,5 @@ export declare function renameEntity(entity: any, catalogPath: string, oldname:
 export declare function removeEntity(entity: any, catalogPath: string): void;
 export declare function removeFile(path: string): void;
 export declare function moveFile(oldPath: string, newPath: string): void;
-export declare function writeFunctionLog(functionName: string, log: string): void;
-export declare function writeLogFile(fileName: string, log: string): void;
+export declare function writeFunctionLog(functionName: string, logStream: string): void;
+export declare function writeLogFile(fileName: string, logStream: string): void;

package/build/packages/catalog_common/src/logger/index.d.ts

@@ -0,0 +1,2 @@
+import logger from './logger';
+export default logger;

package/build/packages/catalog_common/src/logger/logger.d.ts

@@ -0,0 +1,9 @@
+declare const log: {
+    error: (...args: any) => void;
+    warn: (...args: any) => void;
+    info: (...args: any) => void;
+    debug: (...args: any) => void;
+    verbose: (...args: any) => void;
+    silly: (...args: any) => void;
+};
+export default log;

package/build/packages/catalog_common/src/logger/utils.d.ts

@@ -0,0 +1 @@
+export declare function fixCircularReferences(o: any): (k: string | symbol | number, v: any) => any;

package/build/packages/features_preparer/src/logger.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    error: (...args: any) => void;
+    warn: (...args: any) => void;
+    info: (...args: any) => void;
+    debug: (...args: any) => void;
+    verbose: (...args: any) => void;
+    silly: (...args: any) => void;
+};
+export default _default;

package/build/packages/features_renderer/index.d.ts

@@ -1,9 +1,18 @@
 import validate from './src/validate';
-import render from './src/render';
+import render, { buildContext, renderContent } from './src/render';
 import updateFileContent from './src/update_file';
 declare const _default: {
     validate: typeof validate;
     render: typeof render;
     updateFileContent: typeof updateFileContent;
+    auxiliar: {
+        mkNamedTmp: (...names: string[]) => Promise<string>;
+        loadYaml: <T = unknown>(file: string) => T;
+        buildExpectedOutput: (config: import("./src/auxiliar").FeatureConfig, renderDir: string) => import("./src/auxiliar").ExpectedOutput;
+        loadAndValidateRenderTests: (featurePath: string) => import("./src/auxiliar").RenderTestsFile;
+        resolveCrPath: (featurePath: string, crRelPath: string) => string;
+    };
+    buildContext: typeof buildContext;
+    renderContent: typeof renderContent;
 };
 export default _default;

package/build/packages/features_renderer/src/auxiliar.d.ts

@@ -0,0 +1,71 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+export interface ConfigFile {
+    dest: string;
+    src: string;
+    user_managed: boolean;
+}
+export interface FeatureConfig {
+    files?: ConfigFile[];
+    patches?: unknown[];
+}
+export interface ExpectedFile {
+    localPath: string;
+    repoPath: string;
+    userManaged: boolean;
+}
+export interface ExpectedOutput {
+    files: ExpectedFile[];
+    patches: unknown[];
+}
+export interface RenderTest {
+    name: string;
+    cr: string;
+    args?: Record<string, unknown>;
+}
+export interface RenderTestsFile {
+    tests: RenderTest[];
+}
+export interface RenderContext {
+    /** Absolute path to the temp dir */
+    getContextPath: () => string;
+    /** Join a relative path inside the temp dir */
+    join: (...p: string[]) => string;
+    /** Read a file (raw / JSON / YAML) from the temp dir */
+    getFile: <T = unknown>(relPath: string, opts?: {
+        yaml?: boolean;
+        json?: boolean;
+    }) => Promise<T | string>;
+    /** Absolute path of a file in the temp dir (no existence check) */
+    getFilePath: (relPath: string) => string;
+    /** Write a file (ensures parent dirs) */
+    setFile: (relPath: string, contents: string | Buffer | NodeJS.ArrayBufferView) => Promise<void>;
+    /** Whether a path exists in the temp dir */
+    exists: (relPath: string) => Promise<boolean>;
+    /** Convenience: read output.json from the temp dir */
+    getOutputJson: <T = unknown>() => Promise<T>;
+    /** List entries (name + isDir) in a subdirectory */
+    list: (relPath?: string) => Promise<Array<{
+        name: string;
+        isDir: boolean;
+    }>>;
+    /** Optional cleanup */
+    remove: () => Promise<void>;
+}
+declare function loadAndValidateRenderTests(featurePath: string): RenderTestsFile;
+declare function resolveCrPath(featurePath: string, crRelPath: string): string;
+export declare function listYamlFiles(dir: string): string[];
+declare function loadYaml<T = unknown>(file: string): T;
+declare function mkNamedTmp(...names: string[]): Promise<string>;
+export declare function mkTmp(prefix?: string): Promise<string>;
+declare function buildExpectedOutput(config: FeatureConfig, renderDir: string): ExpectedOutput;
+export declare function createRenderContext(prefix?: string): Promise<RenderContext>;
+declare const _default: {
+    mkNamedTmp: typeof mkNamedTmp;
+    loadYaml: typeof loadYaml;
+    buildExpectedOutput: typeof buildExpectedOutput;
+    loadAndValidateRenderTests: typeof loadAndValidateRenderTests;
+    resolveCrPath: typeof resolveCrPath;
+};
+export default _default;

package/build/packages/features_renderer/src/render.d.ts

@@ -1 +1,3 @@
 export default function render(featurePath: string, featureRenderPath: string, entity: any, firestartrConfig?: any, featureArgs?: any): any;
+export declare function buildContext(entity: any, args: any, firestartrConfig: any, featureArgs: any): any;
+export declare function renderContent(template: string, ctx: any): string;

package/build/packages/github/index.d.ts

@@ -1,3 +1,4 @@
+import { createCheckRun } from './src/check_run';
 import { getOctokitForOrg, getGithubAppToken, getOctokitFromPat } from './src/auth';
 declare const _default: {
     org: {
@@ -72,5 +73,9 @@ declare const _default: {
         createBranch: typeof import("./src/branches").createBranch;
         createOrphanBranch: typeof import("./src/branches").createOrphanBranch;
     };
+    feedback: {
+        createCheckRun: typeof createCheckRun;
+        CheckRun: typeof import("./src/check_run").GithubCheckRun;
+    };
 };
 export default _default;

package/build/packages/github/src/check_run.d.ts

@@ -0,0 +1,83 @@
+import type { Octokit } from '@octokit/rest';
+export type CheckRunStatus = 'queued' | 'in_progress' | 'completed';
+export type CheckRunConclusion = 'success' | 'failure' | 'neutral' | 'cancelled' | 'timed_out' | 'action_required' | 'skipped';
+export interface GithubCheckRunParams {
+    owner: string;
+    repo: string;
+    headSHA: string;
+    name: string;
+    detailsUrl?: string;
+    title?: string;
+    summary?: string;
+    pullNumber?: number;
+    includeCheckRunComment?: boolean;
+    checkRunComment?: string;
+}
+export declare class GithubCheckRun {
+    private readonly octokit;
+    private readonly owner;
+    private readonly repo;
+    private readonly headSHA;
+    private readonly name;
+    private readonly detailsUrl?;
+    private readonly title;
+    private readonly pullNumber?;
+    private readonly includeCheckRunComment;
+    private readonly checkRunComment?;
+    private hasCommented;
+    private closing;
+    private closed;
+    private buffer;
+    private checkRunId?;
+    private lastStatus;
+    private detailsFormatter;
+    private _summaryOverride?;
+    constructor(octokit: Octokit, params: GithubCheckRunParams);
+    /**
+     * Configure markdown formatting for the details (output.text).
+     * Example: ch.mdOptionsDetails({ quotes: 'terraform' })
+     * Result:
+     * ```terraform
+     * <log>
+     * ```
+     */
+    mdOptionsDetails(opts: {
+        quotes: string;
+    }): void;
+    set summary(data: string);
+    get summary(): string | undefined;
+    /**
+     * Append log text and optionally set status ('queued' | 'in_progress').
+     */
+    update(text: string, status?: Exclude<CheckRunStatus, 'completed'>): void;
+    /**
+     * Finalize the check with a conclusion. Flushes buffered text, marks completed.
+     */
+    close(finalText: string, ok: boolean): Promise<void>;
+    private __ensureCreated;
+    private __updateCheckRun;
+    private __buildCheckRunUrl;
+    private buildOutputTextAndSummary;
+}
+/**
+ * Factory: build a GithubCheckRun using an installation token for the given org.
+ */
+export declare function createCheckRunForOrg(org: string, owner: string, repo: string, name: string, opts?: {
+    headSHA?: string;
+    pullNumber?: number;
+    detailsUrl?: string;
+    title?: string;
+    summary?: string;
+    includeCheckRunComment?: boolean;
+    checkRunComment?: string;
+}): Promise<GithubCheckRun>;
+export declare function createCheckRun(owner: string, repo: string, name: string, opts?: {
+    headSHA?: string;
+    pullNumber?: number;
+    detailsUrl?: string;
+    title?: string;
+    summary?: string;
+    includeCheckRunComment?: boolean;
+    checkRunComment?: string;
+}): Promise<GithubCheckRun>;
+export declare const CheckRun: typeof GithubCheckRun;

package/build/packages/github/src/logger.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    error: (...args: any) => void;
+    warn: (...args: any) => void;
+    info: (...args: any) => void;
+    debug: (...args: any) => void;
+    verbose: (...args: any) => void;
+    silly: (...args: any) => void;
+};
+export default _default;

package/build/packages/operator/src/logger.d.ts

@@ -1,4 +1,4 @@
-declare const log: {
+declare const _default: {
     error: (...args: any) => void;
     warn: (...args: any) => void;
     info: (...args: any) => void;
@@ -6,4 +6,4 @@ declare const log: {
     verbose: (...args: any) => void;
     silly: (...args: any) => void;
 };
-export default log;
+export default _default;

package/build/packages/operator/src/user-feedback-ops/gh-checkrun.d.ts

@@ -0,0 +1,5 @@
+export declare function GHCheckRun(cmd: string, item: any): Promise<{
+    fnData: (d: any) => void;
+    fnEnd: () => void;
+    fnOnError: (err: any) => void;
+}>;

package/build/packages/operator/src/user-feedback-ops/tf-checkrun.d.ts

@@ -0,0 +1,5 @@
+export declare function TFCheckRun(cmd: string, item: any): Promise<{
+    fnData: (d: any) => void;
+    fnEnd: () => void;
+    fnOnError: (err: any) => void;
+}>;

package/build/packages/provisioner/src/cdktf.d.ts

@@ -1 +1,3 @@
-export declare function runCDKTF(entityPath: any, action: string, depsPath?: any): Promise<unknown>;
+/// <reference types="node" />
+import { PassThrough } from 'stream';
+export declare function runCDKTF(entityPath: any, action: string, depsPath?: any, stream?: PassThrough): Promise<unknown>;

package/build/packages/provisioner/src/logger.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    error: (...args: any) => void;
+    warn: (...args: any) => void;
+    info: (...args: any) => void;
+    debug: (...args: any) => void;
+    verbose: (...args: any) => void;
+    silly: (...args: any) => void;
+};
+export default _default;

package/build/packages/provisioner/src/resources/resource.d.ts

@@ -1,8 +1,18 @@
+/// <reference types="node" />
+import { PassThrough } from 'stream';
 export declare class Resource {
     data: any;
     output: string;
+    logStream: PassThrough;
     logFn: Function;
+    synthStreamCallbacks: any;
+    tfStreamCallbacks: any;
     setLogger(fn: Function): void;
+    setSynthStreamLogs(callbacks: any): void;
+    setTFStreamLogs(callbacks: any): void;
+    onSyncStreaming(): Promise<void>;
+    onTFStreaming(): Promise<void>;
+    setLogStream(fnData: Function, fnEnd: Function, reopen?: boolean): void;
     constructor(mainCR: any, operation: string, deps?: any[]);
     run(): Promise<void>;
     artifact(): any;

package/build/packages/provisioner/src/terraform.d.ts

@@ -1,5 +1,7 @@
-export declare function runTerraform(entity: any, command: Array<string>): Promise<unknown>;
-export declare function terraformInit(entity: any): Promise<unknown>;
-export declare function terraformPlan(entity: any): Promise<unknown>;
-export declare function terraformApply(entity: any, isImport?: boolean, skipPlan?: boolean): Promise<unknown>;
-export declare function terraformDestroy(entity: any): Promise<unknown>;
+/// <reference types="node" />
+import { PassThrough } from 'stream';
+export declare function runTerraform(entity: any, command: Array<string>, stream?: PassThrough): Promise<unknown>;
+export declare function terraformInit(entity: any, stream?: PassThrough): Promise<unknown>;
+export declare function terraformPlan(entity: any, stream?: PassThrough): Promise<unknown>;
+export declare function terraformApply(entity: any, isImport?: boolean, skipPlan?: boolean, stream?: PassThrough): Promise<unknown>;
+export declare function terraformDestroy(entity: any, stream?: PassThrough): Promise<unknown>;

package/build/packages/terraform_provisioner/index.d.ts

@@ -1,4 +1,4 @@
 export { TFProjectManager } from './src';
 export declare function validateContext(context: any): void;
 export declare function run(): Promise<void>;
-export declare function runTerraformProvisioner(context: any, command?: string): Promise<any>;
+export declare function runTerraformProvisioner(context: any, command?: string, streaming?: any): Promise<any>;

package/build/packages/terraform_provisioner/src/logger.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    error: (...args: any) => void;
+    warn: (...args: any) => void;
+    info: (...args: any) => void;
+    debug: (...args: any) => void;
+    verbose: (...args: any) => void;
+    silly: (...args: any) => void;
+};
+export default _default;

package/build/packages/terraform_provisioner/src/project_tf.d.ts

@@ -1,12 +1,16 @@
+/// <reference types="node" />
 import { WriterMainTf } from './writer_main_tf';
 import { WriterTfVarsJson } from './writer_tfvars_json';
+import { PassThrough } from 'stream';
 export declare class TFProjectManager {
     mainTfWriter: WriterMainTf;
     tfVarsJsonWriter: WriterTfVarsJson;
     secrets: any[];
     projectPath: string;
     tfOutput: any;
+    stream: PassThrough;
     constructor(ctx: any);
+    setStreamCallbacks(fnData: Function, fnEnd: (...args: any[]) => void, reopen?: boolean): void;
     getOutput(): any;
     build(): Promise<void>;
     __init(): Promise<void>;

package/build/packages/terraform_provisioner/src/project_tf_remote.d.ts

@@ -1,5 +1,7 @@
+/// <reference types="node" />
 import { WriterTerraform } from './writer_terraform';
 import { WriterTfVarsJson } from './writer_tfvars_json';
+import { PassThrough } from 'stream';
 export declare class TFProjectManagerRemote {
     writerTerraform: WriterTerraform;
     tfVarsJsonWriter: WriterTfVarsJson;
@@ -7,8 +9,10 @@ export declare class TFProjectManagerRemote {
     secrets: any[];
     projectPath: string;
     tfOutput: any;
+    stream: PassThrough;
     constructor(ctx: any);
     getOutput(): any;
+    setStreamCallbacks(fnData: Function, fnEnd: (...args: any[]) => void, reopen?: boolean): void;
     build(): Promise<void>;
     __configGit(): Promise<void>;
     __init(): Promise<void>;

package/build/packages/terraform_provisioner/src/utils.d.ts

@@ -1,9 +1,11 @@
+/// <reference types="node" />
+import { PassThrough } from 'stream';
 export declare function validate(path: string, secrets: any[]): Promise<unknown>;
-export declare function init(path: string, secrets: any[]): Promise<unknown>;
-export declare function initFromModule(path: string, source: string, secrets: any[]): Promise<unknown>;
-export declare function plan(path: string, secrets: any[], format: 'human' | 'json', args?: string[]): Promise<any>;
-export declare function apply(path: string, secrets: any[]): Promise<unknown>;
-export declare function destroy(path: string, secrets: any[]): Promise<unknown>;
+export declare function init(path: string, secrets: any[], stream?: PassThrough): Promise<unknown>;
+export declare function initFromModule(path: string, source: string, secrets: any[], stream?: PassThrough): Promise<unknown>;
+export declare function plan(path: string, secrets: any[], format: 'human' | 'json', args?: string[], stream?: PassThrough): Promise<any>;
+export declare function apply(path: string, secrets: any[], stream?: PassThrough): Promise<unknown>;
+export declare function destroy(path: string, secrets: any[], stream?: PassThrough): Promise<unknown>;
 export declare function output(path: string, secrets: any[]): Promise<unknown>;
-export declare function tfExec(path: string, args: Array<string>, secrets: any[], extraArgs?: string[]): Promise<unknown>;
+export declare function tfExec(path: string, args: Array<string>, secrets: any[], extraArgs?: string[], stream?: PassThrough): Promise<unknown>;
 export declare function configureGit(ghToken: string): Promise<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firestartr/cli",
-  "version": "1.47.0",
+  "version": "1.48.0",
   "private": false,
   "description": "Commandline tool",
   "main": "build/main.js",