@catladder/cli 0.0.0-main-8dbb6c76 → 0.0.0-main-a6b45abe

package/dist/packages/pipeline/src/types/gitlab-ci-yml.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=gitlab-ci-yml.js.map

package/dist/packages/pipeline/src/types/gitlab-ci-yml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-ci-yml.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/gitlab-ci-yml.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/packages/pipeline/src/types/gitlab-types.d.ts

@@ -0,0 +1,33 @@
+import type { GitlabJobWithContext } from "../backends/gitlab/createGitlabJobs";
+import type { Artifacts as GitlabCiArtifacts, JobTemplate, Cache as GitlabJobCache, Rules } from "./gitlab-ci-yml";
+export { Retry, Image as GitlabJobImage } from "./gitlab-ci-yml";
+export type Artifacts = GitlabCiArtifacts;
+export type { GitlabJobCache };
+export type GitlabRule = Exclude<Exclude<Rules, null>[number], string | string[]>;
+export type GitlabEnvironment = Omit<Exclude<JobTemplate["environment"], undefined | string>, "deployment_tier">;
+export interface GitlabJobDef extends Pick<JobTemplate, "after_script" | "allow_failure" | "artifacts" | "before_script" | "coverage" | "dependencies" | "environment" | "except" | "hooks" | "image" | "interruptible" | "needs" | "only" | "parallel" | "release" | "resource_group" | "retry" | "rules" | "script" | "services" | "stage" | "tags" | "trigger" | "variables"> {
+    stage: JobTemplate["stage"];
+    rules?: GitlabRule[];
+    pages?: boolean | {
+        path_prefix?: string;
+    };
+    cache?: GitlabJobCache | GitlabJobCache[];
+    artifacts?: Artifacts;
+    tags?: string[];
+}
+/**
+ * this is not precicily the type of a gitlab-pipeline
+ * the jobs nee to be merge into the object.
+ * Problem is, that this type cannot be represented properly with typescript, see https://github.com/microsoft/TypeScript/issues/17867
+ */
+export interface GitlabPipeline extends Pick<JobTemplate, "variables"> {
+    image: string;
+    workflow?: {
+        rules: GitlabRule[];
+        name?: string;
+        variables?: Record<string, string>;
+    };
+    stages: string[];
+    jobs: Record<string, GitlabJobWithContext>;
+    before_script?: string[];
+}

package/dist/packages/pipeline/src/types/gitlab-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=gitlab-types.js.map

package/dist/packages/pipeline/src/types/gitlab-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-types.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/gitlab-types.ts"],"names":[],"mappings":""}

package/dist/packages/pipeline/src/types/hooks.d.ts

@@ -0,0 +1,45 @@
+export type BaseHookContext = {
+    /**
+     * the filename of the file
+     */
+    filename: string;
+    /**
+     * the path of the file
+     */
+    path: string;
+    /**
+     * the extension of the file
+     */
+    extension: string;
+};
+export type YamlHookContext = BaseHookContext & {
+    data: any;
+};
+export type FileHookContext = BaseHookContext & {
+    /**
+     * the content of the file
+     */
+    content: string;
+};
+type MaybePromise<T> = T | Promise<T>;
+/**
+ * Transform hooks are a last-resort escape hatch: they rewrite the
+ * generated output right before it is written, so they depend on the
+ * exact shape of catladder's output and a catladder upgrade can break
+ * them silently. Prefer a first-class config option whenever one exists.
+ *
+ * If you need a hook, please raise an issue on
+ * https://github.com/panter/catladder/issues describing the use
+ * case. This feedback helps us generalize it into a supported feature.
+ */
+export type Hooks = {
+    /**
+     * transform the file before it is written. If undefined is returned, the file is not modified
+     */
+    transformFileBeforeWrite?: (fileHookContext: FileHookContext) => MaybePromise<string | undefined>;
+    /**
+     * transform the yaml before it is written. If undefined is returned, the yaml is not modified
+     */
+    transformYamlBeforeWrite?: (fileHookContext: YamlHookContext) => MaybePromise<any | undefined>;
+};
+export {};

package/dist/packages/pipeline/src/types/hooks.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=hooks.js.map

package/dist/packages/pipeline/src/types/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/hooks.ts"],"names":[],"mappings":""}

package/dist/packages/pipeline/src/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./config";
+export * from "./gitlab-types";
+export * from "./context";
+export * from "./jobDefinition";
+export * from "./pipeline";
+export * from "./jobs";
+export * from "./agent";

package/dist/packages/pipeline/src/types/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+__exportStar(require("./gitlab-types"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./jobDefinition"), exports);
+__exportStar(require("./pipeline"), exports);
+__exportStar(require("./jobs"), exports);
+__exportStar(require("./agent"), exports);
+//# sourceMappingURL=index.js.map

package/dist/packages/pipeline/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,4CAA0B;AAC1B,kDAAgC;AAChC,6CAA2B;AAC3B,yCAAuB;AACvB,0CAAwB"}

package/dist/packages/pipeline/src/types/jobDefinition.d.ts

@@ -0,0 +1,11 @@
+import type { CacheConfig } from "../build";
+import type { CatladderJobSpec } from "./jobs";
+export type AppBuildJobDefinition = Partial<Omit<CatladderJobSpec, "artifacts" | "cache">> & {
+    cache?: CacheConfig[];
+};
+export type DockerBuildJobDefinition = AppBuildJobDefinition;
+export type DeployJobDefinition = Pick<CatladderJobSpec, "script" | "variables" | "image" | "artifacts" | "services" | "runnerVariables" | "allow_failure" | "pages" | "idToken"> & {
+    cache?: CacheConfig[];
+};
+export type StopJobDefinition = Pick<CatladderJobSpec, "script" | "variables" | "image" | "runnerVariables">;
+export type RollbackJobDefinition = Pick<CatladderJobSpec, "script" | "variables" | "runnerVariables" | "image">;

package/dist/packages/pipeline/src/types/jobDefinition.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=jobDefinition.js.map

package/dist/packages/pipeline/src/types/jobDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobDefinition.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/jobDefinition.ts"],"names":[],"mappings":""}

package/dist/packages/pipeline/src/types/jobs.d.ts

@@ -0,0 +1,248 @@
+import type { UnspecifiedEnvVars } from "..";
+import type { CatladderImageRef } from "../runner";
+import type { ProjectImageRef } from "../customImages/projectImages";
+import type { CacheConfig } from "../build/types";
+import type { Artifacts, GitlabJobCache, GitlabJobDef, GitlabJobImage, GitlabRule } from "./gitlab-types";
+export type CatladderJobCache = GitlabJobCache & {
+    /**
+     * content-key hint carried over from {@link CacheConfig} — consumed
+     * by the github lowering (hashFiles key), stripped by gitlab
+     */
+    keyFiles?: string[];
+    /**
+     * cross-cache hints carried over from {@link CacheConfig} — consumed
+     * by the github lowering (conditional restore), stripped by gitlab
+     */
+    cacheId?: string;
+    redundantOnExactHitOf?: string;
+};
+export declare const BASE_STAGES: readonly ["setup", "test", "build", "deploy", "verify", "agents", "rollback", "stop"];
+export type BaseStage = (typeof BASE_STAGES)[number];
+export type CatladderJobNeed = string | {
+    job: string;
+    artifacts: boolean;
+    componentName?: string;
+} | {
+    job: string;
+    artifacts: boolean;
+    workspaceName: string;
+} | {
+    job: string;
+    artifacts: boolean;
+    optional?: boolean;
+    global: true;
+};
+export declare const CAPABILITIES: readonly ["build", "buildArtifacts", "dockerImage", "qualityGate", "deployment"];
+/**
+ * something a job provides to other jobs. Jobs declare what they require
+ * via {@link Requirement}s and a planner resolves them to concrete job
+ * dependencies over the whole pipeline.
+ */
+export type CapabilityName = (typeof CAPABILITIES)[number];
+/**
+ * a semantic dependency on a capability provided by other jobs
+ */
+export type Requirement = {
+    /**
+     * the capability the job requires
+     */
+    capability: CapabilityName;
+    /**
+     * whether the artifacts of the providing jobs are consumed
+     */
+    artifacts?: boolean;
+    /**
+     * where the capability must come from. Defaults to the job's own
+     * component (or workspace for workspace jobs).
+     */
+    from?: {
+        component?: string;
+        workspace?: string;
+    };
+    /**
+     * whether pipeline generation fails when no job provides the
+     * capability.
+     *
+     * Defaults to the value of `artifacts`: consuming artifacts from
+     * nobody is almost always a broken configuration, while a plain
+     * ordering requirement nobody provides simply creates no dependency
+     * (e.g. quality gates don't run on tagged releases).
+     */
+    strict?: boolean;
+};
+/**
+ * how a job interacts with a deployment environment.
+ * Each pipeline type translates this to its own mechanism
+ * (gitlab: the job `environment:` config incl. name and url).
+ */
+export type CatladderJobEnvironmentConfig = {
+    /**
+     * - start (default): the job creates/deploys the environment
+     * - stop: the job tears the environment down
+     * - access: the job uses the environment without changing it
+     */
+    action?: "start" | "stop" | "access";
+    /**
+     * name of the job (of the same component) that stops this environment
+     */
+    onStop?: string;
+    /**
+     * automatically stop the environment after this duration (e.g. "1 week")
+     */
+    autoStopIn?: string;
+};
+/**
+ * the platform-agnostic properties of a job
+ */
+export type CatladderJobCore<S = BaseStage> = {
+    /**
+     * the name of the job (without any env or app prefix and suffix)
+     */
+    name: string;
+    /**
+     * envMode sets the behavior of the job regarding multiple envs:
+     * - jobPerEnv: the job runs once per env (default)
+     * - stagePerEnv: the job runs once per env and is organized in its own stage. This mproves usability in gitlab, but works the same as `jobPerEnv`
+     */
+    envMode?: "jobPerEnv" | "stagePerEnv";
+    /**
+     * the stage of the job
+     */
+    stage: S;
+    /**
+     * whether the job starts automatically ("auto") or requires a manual
+     * action ("manual"). Each pipeline type translates this to its own
+     * mechanism (gitlab: `when` + `allow_failure`).
+     *
+     * Prefer this over the gitlab-specific `when`/`allow_failure` fields.
+     */
+    gate?: "auto" | "manual";
+    /**
+     * script to run
+     */
+    script: (string | undefined)[];
+    /**
+     * semantic requirements on capabilities provided by other jobs.
+     * A planner resolves them to concrete job dependencies (`needs`)
+     * once all jobs of the pipeline are known.
+     */
+    requires?: Requirement[];
+    /**
+     * the capabilities this job provides to other jobs.
+     * If not set, it is derived from the stage:
+     * build -> "build", test -> "qualityGate", deploy -> "deployment"
+     */
+    provides?: CapabilityName[];
+    /**
+     * does this require another job (from the same component)?
+     *
+     * You can also require a job from another component if you set `componentName`
+     *
+     */
+    needs?: Array<CatladderJobNeed>;
+    /**
+     * platform-neutral cache declarations. Each pipeline type resolves
+     * them to its own cache mechanism (gitlab: the job `cache:` config).
+     *
+     * Prefer this over the gitlab-shaped `cache` field, which remains as
+     * an escape hatch and takes precedence when set.
+     */
+    caches?: CacheConfig[];
+    /**
+     * declares that this job interacts with a deployment environment
+     */
+    environment?: CatladderJobEnvironmentConfig;
+    /**
+     * the job needs a workload-identity token from the CI system, to
+     * authenticate against a third party without a stored secret (e.g.
+     * npm trusted publishing).
+     *
+     * Lowered by the github backend to `permissions: id-token: write`.
+     * Ignored on gitlab, whose ID tokens are configured per job instead.
+     */
+    idToken?: boolean;
+    /**
+     * variables to pass
+     */
+    variables: UnspecifiedEnvVars | undefined;
+    /**
+     * additional vars only for the runner.
+     * Also if you use services: that require env vars, you need to set them here.
+     *
+     */
+    runnerVariables?: Record<string, string>;
+};
+/**
+ * job properties that (still) use GitLab CI shapes or semantics directly.
+ *
+ * Long-term these should either be generalized into {@link CatladderJobCore}
+ * or be resolved by a pipeline-type specific renderer.
+ */
+export type GitlabJobFields = {
+    /**
+     * cache config, we use here the same shape as gitlab itself
+     */
+    cache?: CatladderJobCache | CatladderJobCache[];
+    /**
+     * job artifacts, we also use gitlab shape here
+     */
+    artifacts?: Artifacts;
+    /**
+     * additional services, mainly used for docker
+     */
+    services?: GitlabJobDef["services"];
+    /**
+     * image to use: a concrete image or a reference to a
+     * catladder-provided job image (resolved by the backend to an image
+     * built in the repository's own registry)
+     */
+    image?: GitlabJobImage | CatladderImageRef | ProjectImageRef;
+    /**
+     * whether failures are allowed
+     */
+    allow_failure?: boolean;
+    /**
+     * gitlab pages publishing for this job (lowered only by the gitlab
+     * backend); `path_prefix` enables parallel deployments (e.g. MR
+     * previews)
+     */
+    pages?: boolean | {
+        path_prefix?: string;
+    };
+    /** */
+    when?: GitlabRule["when"];
+    rules?: GitlabRule[];
+    /**
+     * How many instances of a job should be run in parallel.
+     * Useful for big test suites that can be split into multiple pipeline jobs.
+     * We use the same shape as GitLab itself.
+     */
+    parallel?: number;
+    /**
+     * tags for the underlying job runner (e.g gitlab)
+     */
+    jobTags?: string[];
+    /**
+     * whether the job is interruptible (default: true)
+     */
+    interruptible?: boolean;
+};
+/**
+ * the plain-data shape of a job. This is what job creators resolve
+ * and what users can provide for e.g. `customJobs`.
+ */
+export type CatladderJobSpec<S = BaseStage> = CatladderJobCore<S> & GitlabJobFields;
+export interface CatladderJob<S = BaseStage> extends CatladderJobCore<S>, GitlabJobFields {
+}
+/**
+ * a pipeline job. Subclasses encapsulate how a specific kind of job
+ * (build, deploy, ...) is resolved from its context and definition.
+ *
+ * Instances are plain-data compatible with {@link CatladderJobSpec}:
+ * only the spec's own (defined) properties are assigned, so spreading /
+ * destructuring an instance behaves exactly like the spec object.
+ */
+export declare class CatladderJob<S = BaseStage> {
+    constructor(spec: CatladderJobSpec<S>);
+    static from<Stage>(job: CatladderJobSpec<Stage> | CatladderJob<Stage>): CatladderJob<Stage>;
+}

package/dist/packages/pipeline/src/types/jobs.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CatladderJob = exports.CAPABILITIES = exports.BASE_STAGES = void 0;
+const removeUndefined_1 = require("../utils/removeUndefined");
+exports.BASE_STAGES = [
+    "setup",
+    "test",
+    "build",
+    "deploy",
+    "verify",
+    "agents",
+    "rollback",
+    "stop",
+];
+exports.CAPABILITIES = [
+    "build",
+    "buildArtifacts",
+    "dockerImage",
+    "qualityGate",
+    "deployment",
+];
+/**
+ * a pipeline job. Subclasses encapsulate how a specific kind of job
+ * (build, deploy, ...) is resolved from its context and definition.
+ *
+ * Instances are plain-data compatible with {@link CatladderJobSpec}:
+ * only the spec's own (defined) properties are assigned, so spreading /
+ * destructuring an instance behaves exactly like the spec object.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging -- the merged interface declares exactly the properties the constructor assigns
+class CatladderJob {
+    constructor(spec) {
+        // skip undefined values so that defaults applied later
+        // (e.g. when converting to a gitlab job) are not clobbered
+        Object.assign(this, (0, removeUndefined_1.removeUndefined)(spec));
+    }
+    static from(job) {
+        return job instanceof CatladderJob ? job : new CatladderJob(job);
+    }
+}
+exports.CatladderJob = CatladderJob;
+//# sourceMappingURL=jobs.js.map

package/dist/packages/pipeline/src/types/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/jobs.ts"],"names":[],"mappings":";;;AAIA,8DAA2D;AAsB9C,QAAA,WAAW,GAAG;IACzB,OAAO;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,MAAM;CACE,CAAC;AAWE,QAAA,YAAY,GAAG;IAC1B,OAAO;IACP,gBAAgB;IAChB,aAAa;IACb,aAAa;IACb,YAAY;CACJ,CAAC;AAuOX;;;;;;;GAOG;AACH,4JAA4J;AAC5J,MAAa,YAAY;IACvB,YAAY,IAAyB;QACnC,uDAAuD;QACvD,2DAA2D;QAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAA,iCAAe,EAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,IAAI,CACT,GAAkD;QAElD,OAAO,GAAG,YAAY,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC;CACF;AAZD,oCAYC"}

package/dist/packages/pipeline/src/types/pipeline.d.ts

@@ -0,0 +1,5 @@
+import type { GithubJob, GithubWorkflow } from "./github-types";
+import type { GitlabJobDef, GitlabPipeline } from "./gitlab-types";
+export type PipelineType = "gitlab" | "github";
+export type PipelineJob<T extends PipelineType> = T extends "gitlab" ? GitlabJobDef : T extends "github" ? GithubJob : never;
+export type Pipeline<T extends PipelineType> = T extends "gitlab" ? GitlabPipeline : T extends "github" ? Record<string, GithubWorkflow> : never;

package/dist/packages/pipeline/src/types/pipeline.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pipeline.js.map

package/dist/packages/pipeline/src/types/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/pipeline.ts"],"names":[],"mappings":""}

package/dist/packages/pipeline/src/types/release.d.ts

@@ -0,0 +1,31 @@
+/**
+ * how releases are created:
+ * - "semantic-release" (default): the version is derived automatically
+ *   from conventional commit messages since the last release
+ * - "changesets": developers declare changes intentionally as
+ *   `.changeset/*.md` files (bump type + human-written summary,
+ *   official changesets format); the release job consumes them and
+ *   derives the version from the last `v*` git tag
+ *
+ * Both methods gate on the security audit, commit a changelog and push
+ * a `vX.Y.Z` tag that triggers the taggedRelease pipeline.
+ */
+export type ReleaseMethod = "semantic-release" | "changesets";
+export type ReleaseConfig = {
+    /**
+     * Whether to release automatically or manually on main branch.
+     * - "manual" (default): the pipeline offers a `create release`
+     *   button that can be clicked at any time — the release then runs
+     *   automatically as soon as every other job of the pipeline
+     *   succeeded (clicking after a green pipeline releases right away).
+     *   A `force create release` button releases immediately, ignoring
+     *   the pipeline state.
+     * - "auto": every main-branch pipeline releases at the end.
+     */
+    when?: "manual" | "auto";
+    /**
+     * how the release version and changelog are created.
+     * Defaults to "semantic-release".
+     */
+    method?: ReleaseMethod;
+};

package/dist/packages/pipeline/src/types/release.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=release.js.map

package/dist/packages/pipeline/src/types/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/release.ts"],"names":[],"mappings":""}

package/dist/packages/pipeline/src/types/utils.d.ts

@@ -0,0 +1,3 @@
+export type PartialDeep<T> = T extends any[] ? T : T extends Record<string, any> ? {
+    [P in keyof T]?: PartialDeep<T[P]>;
+} : T;

package/dist/packages/pipeline/src/types/utils.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=utils.js.map

package/dist/packages/pipeline/src/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/types/utils.ts"],"names":[],"mappings":""}

package/dist/packages/pipeline/src/utils/gitlab.d.ts

@@ -0,0 +1,11 @@
+export declare const allowFailureInScripts: (script: string[]) => string[];
+export declare const sanitizeForBashVariable: (name: string) => string;
+export declare const repeatOnFailure: (command: string, options: {
+    pauseInSeconds: number;
+    /**
+     * fail the job after this many attempts — permanent errors (e.g. a
+     * 403) must fail loudly instead of retrying until the job timeout
+     */
+    maxAttempts: number;
+}) => string;
+export declare const collapseableSection: (name: string, header: string) => (commands: string[]) => string[];

package/dist/packages/pipeline/src/utils/gitlab.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collapseableSection = exports.repeatOnFailure = exports.sanitizeForBashVariable = exports.allowFailureInScripts = void 0;
+const bash_1 = require("../../../bash/src/index.js");
+const allowFailureInScripts = (script) => [
+    "set +e", // disable fail job on error
+    ...script,
+    "set -e", // reenable
+];
+exports.allowFailureInScripts = allowFailureInScripts;
+const sanitizeForBashVariable = (name) => name.replace(/-/g, "_");
+exports.sanitizeForBashVariable = sanitizeForBashVariable;
+const repeatOnFailure = (command, options) => {
+    return `
+    _attempt=0
+    until ${command}
+    do
+      _attempt=$((_attempt+1))
+      if [ "$_attempt" -ge ${options.maxAttempts} ]; then
+        echo "giving up after ${options.maxAttempts} attempts"
+        exit 1
+      fi
+      echo "Trying again."
+      sleep ${options.pauseInSeconds}
+    done
+  `;
+};
+exports.repeatOnFailure = repeatOnFailure;
+const start = (0, bash_1.registerGlobalScriptFunction)("collapseable_section_start", `local section_title="\${1}"
+  local section_description="\${2:-$section_title}"
+  echo -e "section_start:\`date +%s\`:\${section_title}[collapsed=true]\\r\\e[0K$\{section_description}"
+`);
+const end = (0, bash_1.registerGlobalScriptFunction)("collapseable_section_end", `local section_title="\${1}"
+  echo -e "section_end:\`date +%s\`:\${section_title}\\r\\e[0K"
+`);
+const collapseableSection = (name, header) => (commands) => {
+    return [
+        start.invoke(`"${name}"`, `"${header}"`),
+        ...commands,
+        end.invoke(`"${name}"`),
+    ];
+};
+exports.collapseableSection = collapseableSection;
+//# sourceMappingURL=gitlab.js.map

package/dist/packages/pipeline/src/utils/gitlab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/utils/gitlab.ts"],"names":[],"mappings":";;;AAAA,0CAA+D;AAExD,MAAM,qBAAqB,GAAG,CAAC,MAAgB,EAAY,EAAE,CAAC;IACnE,QAAQ,EAAE,4BAA4B;IACtC,GAAG,MAAM;IACT,QAAQ,EAAE,WAAW;CACtB,CAAC;AAJW,QAAA,qBAAqB,yBAIhC;AAEK,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,EAAE,CACtD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AADb,QAAA,uBAAuB,2BACV;AAEnB,MAAM,eAAe,GAAG,CAC7B,OAAe,EACf,OAOC,EACO,EAAE;IACV,OAAO;;YAEG,OAAO;;;6BAGU,OAAO,CAAC,WAAW;gCAChB,OAAO,CAAC,WAAW;;;;cAIrC,OAAO,CAAC,cAAc;;GAEjC,CAAC;AACJ,CAAC,CAAC;AAxBW,QAAA,eAAe,mBAwB1B;AAEF,MAAM,KAAK,GAAG,IAAA,mCAA4B,EACxC,4BAA4B,EAC5B;;;CAGD,CACA,CAAC;AAEF,MAAM,GAAG,GAAG,IAAA,mCAA4B,EACtC,0BAA0B,EAC1B;;CAED,CACA,CAAC;AAEK,MAAM,mBAAmB,GAC9B,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE,CACjC,CAAC,QAAkB,EAAY,EAAE;IAC/B,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,IAAI,MAAM,GAAG,CAAC;QACxC,GAAG,QAAQ;QACX,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC;KACxB,CAAC;AACJ,CAAC,CAAC;AARS,QAAA,mBAAmB,uBAQ5B"}

package/dist/packages/pipeline/src/utils/index.d.ts

@@ -0,0 +1,4 @@
+export declare function notNil<TValue>(value: TValue | null | undefined): value is TValue;
+export declare const ensureArrayOrNull: <T>(s: undefined | T | T[]) => T[] | null;
+export declare const ensureArray: <T>(s: undefined | T | T[]) => T[];
+export declare const mergeWithMergingArrays: <A, B>(obj1: A, obj2: B) => A & B;

package/dist/packages/pipeline/src/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeWithMergingArrays = exports.ensureArray = exports.ensureArrayOrNull = exports.notNil = void 0;
+const lodash_es_1 = require("lodash-es");
+function notNil(value) {
+    return value !== null && value !== undefined;
+}
+exports.notNil = notNil;
+const ensureArrayOrNull = (s) => (0, lodash_es_1.isNil)(s) ? null : Array.isArray(s) ? s : [s];
+exports.ensureArrayOrNull = ensureArrayOrNull;
+const ensureArray = (s) => { var _a; return (_a = (0, exports.ensureArrayOrNull)(s)) !== null && _a !== void 0 ? _a : []; };
+exports.ensureArray = ensureArray;
+// see https://github.com/lodash/lodash/issues/5384
+const mergeWithMergingArrays = (obj1, obj2) => {
+    return (0, lodash_es_1.mergeWith)({}, obj1, obj2, (prop1, prop2) => Array.isArray(prop1) && Array.isArray(prop2)
+        ? [...prop1, ...prop2]
+        : undefined);
+};
+exports.mergeWithMergingArrays = mergeWithMergingArrays;
+//# sourceMappingURL=index.js.map

package/dist/packages/pipeline/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/utils/index.ts"],"names":[],"mappings":";;;AAAA,yCAA6C;AAE7C,SAAgB,MAAM,CACpB,KAAgC;IAEhC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAJD,wBAIC;AAEM,MAAM,iBAAiB,GAAG,CAAI,CAAsB,EAAc,EAAE,CACzE,IAAA,iBAAK,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AADlC,QAAA,iBAAiB,qBACiB;AAExC,MAAM,WAAW,GAAG,CAAI,CAAsB,EAAO,EAAE,WAC5D,OAAA,MAAA,IAAA,yBAAiB,EAAC,CAAC,CAAC,mCAAI,EAAE,CAAA,EAAA,CAAC;AADhB,QAAA,WAAW,eACK;AAE7B,mDAAmD;AAC5C,MAAM,sBAAsB,GAAG,CAAO,IAAO,EAAE,IAAO,EAAS,EAAE;IACtE,OAAO,IAAA,qBAAS,EAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAChD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1C,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;QACtB,CAAC,CAAC,SAAS,CACd,CAAC;AACJ,CAAC,CAAC;AANW,QAAA,sBAAsB,0BAMjC"}

package/dist/packages/pipeline/src/utils/jsonParse.d.ts

@@ -0,0 +1 @@
+export declare const jsonParseOrThrow: (str: string) => any;

package/dist/packages/pipeline/src/utils/jsonParse.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonParseOrThrow = void 0;
+const jsonParseOrThrow = (str) => {
+    try {
+        return JSON.parse(str);
+    }
+    catch (e) {
+        throw new Error(`could not parse json: ${str}`);
+    }
+};
+exports.jsonParseOrThrow = jsonParseOrThrow;
+//# sourceMappingURL=jsonParse.js.map

package/dist/packages/pipeline/src/utils/jsonParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonParse.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/utils/jsonParse.ts"],"names":[],"mappings":";;;AAAO,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAO,EAAE;IACnD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B"}