@kinwan/infrascript 0.1.0

package/README.md

@@ -0,0 +1,291 @@
+# infrascript
+
+Typed TypeScript DSL for generating GitHub Actions workflows and Kubernetes manifests.
+
+Write your infrastructure config once in TypeScript — fully typed, with autocomplete and compile-time validation — and let infrascript emit the YAML files exactly where they need to go.
+
+```bash
+npx infrascript build
+# → .github/workflows/ci.yml
+# → .github/workflows/deploy.yml
+# → k8s/api-configmap.yaml
+# → k8s/api-secret.yaml
+# → k8s/api-pvc.yaml
+# → k8s/api-deployment.yaml
+# → k8s/api-service.yaml
+# → k8s/api-ingress.yaml
+```
+
+---
+
+## Why
+
+Writing YAML by hand has real costs:
+
+- No type safety — invalid fields and typos fail silently until runtime
+- Cross-manifest references (service names, secret names, label selectors) break when you rename things
+- K8s requires 5–7 separate files for a single app — all manually kept in sync
+- GitHub Actions has no guard against referencing a job that doesn't exist
+
+infrascript fixes all of this. Your config is TypeScript, so your editor catches errors before `kubectl apply` does.
+
+---
+
+## Installation
+
+```bash
+npm install -D infrascript ts-node
+```
+
+---
+
+## Quick start
+
+Create `infrascript.config.ts` at your project root:
+
+```typescript
+import { defineConfig, ActionsWorkflow, K8sApp } from "infrascript";
+
+const ci = new ActionsWorkflow("ci")
+  .on("push", { branches: ["main"] })
+  .on("pull_request")
+  .job("test", (j) =>
+    j
+      .runsOn("ubuntu-latest")
+      .step("Checkout").uses("actions/checkout@v4")
+      .step("Install").run("npm ci")
+      .step("Test").run("npm test")
+  );
+
+const api = new K8sApp("api")
+  .image("ghcr.io/myorg/api:latest")
+  .replicas(2)
+  .port(3000)
+  .env({ NODE_ENV: "production" })
+  .secret({ DB_PASSWORD: "replace-me" })
+  .ingress({ host: "api.myapp.com", tls: true });
+
+export default defineConfig({
+  actions: { ci },
+  k8s: { apps: { api } },
+});
+```
+
+Then run:
+
+```bash
+npx infrascript build
+```
+
+Files are written in-place — `.github/workflows/` and `k8s/` — exactly where GitHub and `kubectl` expect them. Directories are created automatically if they don't exist. Existing files are overwritten; git is your undo.
+
+---
+
+## CLI
+
+```bash
+npx infrascript build       # generate all YAML files
+npx infrascript validate    # validate config without writing files
+```
+
+Build output is colored by result:
+
+```
+  ✓ created   .github/workflows/ci.yml
+  ↻ updated   k8s/api-deployment.yaml
+  – unchanged k8s/api-service.yaml
+```
+
+---
+
+## GitHub Actions
+
+### `ActionsWorkflow`
+
+```typescript
+const deploy = new ActionsWorkflow("deploy")
+  .on("push", { branches: ["main"] })
+  .on("schedule", "0 2 * * *")
+  .on("workflow_dispatch")
+  .permissions({ contents: "read", packages: "write" })
+  .concurrency("deploy-${{ github.ref }}", true)
+  .env({ NODE_ENV: "production" })
+  .job("build", (j) => j
+    .runsOn("ubuntu-latest")
+    .step("Checkout").uses("actions/checkout@v4")
+    .step("Build").run("npm run build")
+  )
+  .job("deploy", (j) => j
+    .runsOn("ubuntu-latest")
+    .needs("build")
+    .step("Deploy").run("./scripts/deploy.sh")
+  );
+```
+
+Outputs to `.github/workflows/deploy.yml`.
+
+### `Job`
+
+| Method | Description |
+|---|---|
+| `.runsOn(runner)` | Runner label — typed union of all GitHub-hosted runners |
+| `.needs(...jobIds)` | Job dependencies — must be IDs defined in the same workflow |
+| `.step(name)` | Add a step, returns `Step` for chaining |
+| `.env(vars)` | Job-level env vars |
+| `.permissions(perms)` | Job-level permissions |
+| `.matrix(matrix)` | Build matrix strategy |
+| `.timeoutMinutes(n)` | Job timeout |
+| `.if(condition)` | Conditional expression |
+
+### `Step`
+
+```typescript
+// Use a community action
+j.step("Login").uses("docker/login-action@v3", {
+  registry: "ghcr.io",
+  username: "${{ github.actor }}",
+  password: "${{ secrets.GITHUB_TOKEN }}",
+});
+
+// Run a shell command
+j.step("Test").run("npm test");
+
+// With extras
+j.step("Deploy")
+  .run("kubectl apply -f k8s/")
+  .env({ KUBECONFIG: "${{ secrets.KUBECONFIG }}" })
+  .if("github.ref == 'refs/heads/main'")
+  .workingDirectory("./infra");
+```
+
+---
+
+## Kubernetes
+
+### `K8sApp` — recommended
+
+`K8sApp` is a high-level facade. Define your app once and it generates all required manifests with names and cross-references kept consistent automatically.
+
+```typescript
+const api = new K8sApp("api")
+  .image("ghcr.io/myorg/api:latest")
+  .replicas(2)
+  .port(3000)
+  .namespace("production")
+  .imagePullPolicy("Always")
+  .env({ NODE_ENV: "production", LOG_LEVEL: "info" })
+  .secret({ DB_PASSWORD: "replace-me", JWT_SECRET: "replace-me" })
+  .resources({
+    requests: { cpu: "100m", memory: "128Mi" },
+    limits:   { cpu: "500m", memory: "512Mi" },
+  })
+  .ingress({ host: "api.myapp.com", tls: true, ingressClassName: "nginx" })
+  .volume({ mountPath: "/data", size: "5Gi" });
+```
+
+This single definition emits:
+
+| File | What |
+|---|---|
+| `k8s/api-configmap.yaml` | Plain env vars from `.env()` |
+| `k8s/api-secret.yaml` | Secret env vars from `.secret()` |
+| `k8s/api-pvc.yaml` | Persistent volume claim from `.volume()` |
+| `k8s/api-deployment.yaml` | Deployment with env refs wired to ConfigMap and Secret |
+| `k8s/api-service.yaml` | ClusterIP Service |
+| `k8s/api-ingress.yaml` | Ingress with optional TLS |
+
+Cross-references — ConfigMap name in envFrom, Secret name in envFrom, PVC name in volumeMounts — are guaranteed consistent because they all derive from the app name.
+
+> **Note on secrets:** `.secret()` values are placeholders. The generated Secret uses `stringData` so you can fill in real values before applying, or replace the file with a sealed secret. Never commit real secret values.
+
+### Low-level escape hatch
+
+For advanced cases, use individual manifest builders directly. Each emits exactly one file.
+
+```typescript
+import {
+  defineConfig,
+  Deployment, K8sService, Ingress,
+  ConfigMap, Secret, PVC,
+  secretRef, configMapRef,
+} from "infrascript";
+
+const worker = new Deployment("worker", "ghcr.io/myorg/worker:latest")
+  .replicas(3)
+  .port(8080)
+  .env({ QUEUE: "jobs" })
+  .envFrom("DB_PASS", secretRef("db-secret", "password"))
+  .resources({ limits: { cpu: "200m", memory: "256Mi" } })
+  .livenessProbe({
+    httpGet: { path: "/healthz", port: 8080 },
+    initialDelaySeconds: 10,
+    periodSeconds: 5,
+  });
+
+const workerSvc = new K8sService("worker")
+  .type("ClusterIP")
+  .port(8080);
+
+export default defineConfig({
+  k8s: {
+    manifests: { worker, workerSvc },
+  },
+});
+```
+
+### Mixing both
+
+```typescript
+export default defineConfig({
+  k8s: {
+    apps: {
+      api,      // high-level: emits 6 files automatically
+    },
+    manifests: {
+      worker,   // low-level: one deployment, explicit control
+      workerSvc,
+    },
+  },
+});
+```
+
+---
+
+## Output paths
+
+| Config | Output path |
+|---|---|
+| `actions: { ci }` | `.github/workflows/ci.yml` |
+| `actions: { deploy }` | `.github/workflows/deploy.yml` |
+| `k8s.apps: { api }` | `k8s/api-*.yaml` (one per manifest type) |
+| `k8s.manifests: { worker }` (Deployment) | `k8s/worker-deployment.yaml` |
+| `k8s.manifests: { workerSvc }` (Service) | `k8s/worker-service.yaml` |
+
+Namespaced resources are placed in a subdirectory:
+
+```
+k8s/production/api-deployment.yaml
+k8s/production/api-service.yaml
+```
+
+---
+
+## Design philosophy
+
+**One source of truth.** Your TypeScript config is the authoritative definition of your infrastructure. The YAML files are build artifacts — generated, not hand-maintained.
+
+**Files go where tools expect them.** No intermediate output folder to copy from. `.github/workflows/` is where GitHub reads Actions. `k8s/` is where you point `kubectl apply -f`. infrascript writes there directly.
+
+**Git is the safety net.** infrascript overwrites existing files without prompting. Review diffs in git before committing. This mirrors how most YAML changes are reviewed anyway.
+
+**Newbie-friendly, expert-capable.** `K8sApp` covers the common case with zero K8s knowledge required. The low-level builders are there when you need full control.
+
+---
+
+## Roadmap
+
+- `infrascript diff` — show pending changes without writing
+- `infrascript watch` — regenerate on config file change
+- HorizontalPodAutoscaler builder
+- Helm values.yaml output target
+- JSON Schema export for editor validation

package/dist/actions/Job.d.ts

@@ -0,0 +1,36 @@
+import { Step } from "./Step";
+import type { Runner, Permissions, StepEnv } from "./types";
+export declare class Job {
+    private _runsOn;
+    private _steps;
+    private _needs;
+    private _if?;
+    private _env;
+    private _permissions?;
+    private _strategy?;
+    private _outputs;
+    private _timeoutMinutes?;
+    private _continueOnError?;
+    runsOn(runner: Runner): this;
+    needs(...jobIds: string[]): this;
+    if(condition: string): this;
+    env(vars: StepEnv): this;
+    permissions(perms: Permissions): this;
+    timeoutMinutes(minutes: number): this;
+    continueOnError(value: boolean): this;
+    /** Add a build matrix strategy */
+    matrix(matrix: Record<string, unknown[]>): this;
+    output(name: string, value: string): this;
+    /**
+     * Add a step via callback. The callback receives a Step builder;
+     * Job is returned for continued chaining.
+     *
+     * @example
+     * j.step("Checkout", s => s.uses("actions/checkout@v4"))
+     *  .step("Install",  s => s.run("npm ci"))
+     *  .step("Test",     s => s.run("npm test"))
+     */
+    step(name: string, configure: (step: Step) => void): this;
+    toObject(): Record<string, unknown>;
+}
+//# sourceMappingURL=Job.d.ts.map

package/dist/actions/Job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Job.d.ts","sourceRoot":"","sources":["../../src/actions/Job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE5D,qBAAa,GAAG;IACd,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,SAAS,CAAC,CAA0B;IAC5C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAAU;IAEnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,KAAK,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAKhC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK3B,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKxB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAKrC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKrC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKrC,kCAAkC;IAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAK/C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzC;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;IAOzD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAsBpC"}

package/dist/actions/Job.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Job = void 0;
+const Step_1 = require("./Step");
+class Job {
+    constructor() {
+        this._runsOn = "ubuntu-latest";
+        this._steps = [];
+        this._needs = [];
+        this._env = {};
+        this._outputs = {};
+    }
+    runsOn(runner) {
+        this._runsOn = runner;
+        return this;
+    }
+    needs(...jobIds) {
+        this._needs.push(...jobIds);
+        return this;
+    }
+    if(condition) {
+        this._if = condition;
+        return this;
+    }
+    env(vars) {
+        this._env = { ...this._env, ...vars };
+        return this;
+    }
+    permissions(perms) {
+        this._permissions = perms;
+        return this;
+    }
+    timeoutMinutes(minutes) {
+        this._timeoutMinutes = minutes;
+        return this;
+    }
+    continueOnError(value) {
+        this._continueOnError = value;
+        return this;
+    }
+    /** Add a build matrix strategy */
+    matrix(matrix) {
+        this._strategy = { matrix };
+        return this;
+    }
+    output(name, value) {
+        this._outputs[name] = value;
+        return this;
+    }
+    /**
+     * Add a step via callback. The callback receives a Step builder;
+     * Job is returned for continued chaining.
+     *
+     * @example
+     * j.step("Checkout", s => s.uses("actions/checkout@v4"))
+     *  .step("Install",  s => s.run("npm ci"))
+     *  .step("Test",     s => s.run("npm test"))
+     */
+    step(name, configure) {
+        const s = new Step_1.Step(name);
+        configure(s);
+        this._steps.push(s);
+        return this;
+    }
+    toObject() {
+        if (this._steps.length === 0) {
+            throw new Error("Job must have at least one step");
+        }
+        const obj = {
+            "runs-on": this._runsOn,
+        };
+        if (this._needs.length > 0)
+            obj["needs"] = this._needs;
+        if (this._if)
+            obj["if"] = this._if;
+        if (this._permissions)
+            obj["permissions"] = this._permissions;
+        if (Object.keys(this._env).length > 0)
+            obj["env"] = this._env;
+        if (this._timeoutMinutes)
+            obj["timeout-minutes"] = this._timeoutMinutes;
+        if (this._continueOnError !== undefined)
+            obj["continue-on-error"] = this._continueOnError;
+        if (this._strategy)
+            obj["strategy"] = this._strategy;
+        if (Object.keys(this._outputs).length > 0)
+            obj["outputs"] = this._outputs;
+        obj["steps"] = this._steps.map((s) => s.toObject());
+        return obj;
+    }
+}
+exports.Job = Job;
+//# sourceMappingURL=Job.js.map

package/dist/actions/Job.js.map

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

package/dist/actions/Step.d.ts

@@ -0,0 +1,25 @@
+import type { StepEnv } from "./types";
+export declare class Step {
+    private _name;
+    private _uses?;
+    private _run?;
+    private _with;
+    private _env;
+    private _id?;
+    private _if?;
+    private _workingDirectory?;
+    private _shell?;
+    constructor(name: string);
+    id(id: string): this;
+    /** Reference a GitHub Action, e.g. "actions/checkout@v4" */
+    uses(action: string, withOptions?: Record<string, string>): this;
+    /** Shell command(s) to run */
+    run(command: string): this;
+    with(options: Record<string, string>): this;
+    env(vars: StepEnv): this;
+    if(condition: string): this;
+    workingDirectory(dir: string): this;
+    shell(shell: "bash" | "sh" | "pwsh" | "python" | "cmd" | (string & {})): this;
+    toObject(): Record<string, unknown>;
+}
+//# sourceMappingURL=Step.d.ts.map

package/dist/actions/Step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Step.d.ts","sourceRoot":"","sources":["../../src/actions/Step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,qBAAa,IAAI;IACf,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,IAAI,EAAE,MAAM;IAIxB,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKpB,4DAA4D;IAC5D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQhE,8BAA8B;IAC9B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK1B,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK3C,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKxB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK3B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI;IAK7E,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAkBpC"}

package/dist/actions/Step.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Step = void 0;
+class Step {
+    constructor(name) {
+        this._with = {};
+        this._env = {};
+        this._name = name;
+    }
+    id(id) {
+        this._id = id;
+        return this;
+    }
+    /** Reference a GitHub Action, e.g. "actions/checkout@v4" */
+    uses(action, withOptions) {
+        this._uses = action;
+        if (withOptions) {
+            this._with = { ...this._with, ...withOptions };
+        }
+        return this;
+    }
+    /** Shell command(s) to run */
+    run(command) {
+        this._run = command;
+        return this;
+    }
+    with(options) {
+        this._with = { ...this._with, ...options };
+        return this;
+    }
+    env(vars) {
+        this._env = { ...this._env, ...vars };
+        return this;
+    }
+    if(condition) {
+        this._if = condition;
+        return this;
+    }
+    workingDirectory(dir) {
+        this._workingDirectory = dir;
+        return this;
+    }
+    shell(shell) {
+        this._shell = shell;
+        return this;
+    }
+    toObject() {
+        if (!this._uses && !this._run) {
+            throw new Error(`Step "${this._name}" must have either .uses() or .run()`);
+        }
+        const obj = { name: this._name };
+        if (this._id)
+            obj["id"] = this._id;
+        if (this._if)
+            obj["if"] = this._if;
+        if (this._uses)
+            obj["uses"] = this._uses;
+        if (Object.keys(this._with).length > 0)
+            obj["with"] = this._with;
+        if (this._run)
+            obj["run"] = this._run;
+        if (this._workingDirectory)
+            obj["working-directory"] = this._workingDirectory;
+        if (this._shell)
+            obj["shell"] = this._shell;
+        if (Object.keys(this._env).length > 0)
+            obj["env"] = this._env;
+        return obj;
+    }
+}
+exports.Step = Step;
+//# sourceMappingURL=Step.js.map

package/dist/actions/Step.js.map

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

package/dist/actions/Workflow.d.ts

@@ -0,0 +1,27 @@
+import { Builder } from "../core/Builder";
+import { Job } from "./Job";
+import type { PushTriggerOptions, PullRequestTriggerOptions, Permissions, StepEnv } from "./types";
+type JobFactory = (job: Job) => void;
+export declare class ActionsWorkflow extends Builder {
+    readonly kind = "ActionsWorkflow";
+    private _name;
+    private _triggers;
+    private _jobs;
+    private _env;
+    private _permissions?;
+    private _concurrency?;
+    constructor(name: string);
+    on(event: "push", options?: PushTriggerOptions): this;
+    on(event: "pull_request" | "pull_request_target", options?: PullRequestTriggerOptions): this;
+    on(event: "workflow_dispatch" | "workflow_call"): this;
+    on(event: "schedule", cron: string): this;
+    env(vars: StepEnv): this;
+    permissions(perms: Permissions): this;
+    concurrency(group: string, cancelInProgress?: boolean): this;
+    /** Define a job. The factory receives a Job builder to configure. */
+    job(id: string, factory: JobFactory): this;
+    outputPath(): string;
+    toObject(): Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=Workflow.d.ts.map

package/dist/actions/Workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.d.ts","sourceRoot":"","sources":["../../src/actions/Workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,KAAK,EAEV,kBAAkB,EAClB,yBAAyB,EACzB,WAAW,EACX,OAAO,EACR,MAAM,SAAS,CAAC;AAEjB,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAErC,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,QAAQ,CAAC,IAAI,qBAAqB;IAElC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,YAAY,CAAC,CAAoD;gBAE7D,IAAI,EAAE,MAAM;IAKxB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IACrD,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,qBAAqB,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAC5F,EAAE,CAAC,KAAK,EAAE,mBAAmB,GAAG,eAAe,GAAG,IAAI;IACtD,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAczC,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKxB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAKrC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,UAAO,GAAG,IAAI;IAKzD,qEAAqE;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI;IAO1C,UAAU,IAAI,MAAM;IAIpB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAyBpC"}

package/dist/actions/Workflow.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionsWorkflow = void 0;
+const Builder_1 = require("../core/Builder");
+const Job_1 = require("./Job");
+class ActionsWorkflow extends Builder_1.Builder {
+    constructor(name) {
+        super();
+        this.kind = "ActionsWorkflow";
+        this._triggers = {};
+        this._jobs = new Map();
+        this._env = {};
+        this._name = name;
+    }
+    on(event, optionsOrCron) {
+        if (event === "schedule" && typeof optionsOrCron === "string") {
+            const existing = this._triggers["schedule"] ?? [];
+            this._triggers["schedule"] = [...existing, { cron: optionsOrCron }];
+        }
+        else if (optionsOrCron && typeof optionsOrCron === "object") {
+            this._triggers[event] = optionsOrCron;
+        }
+        else {
+            // null means the trigger fires with no filter options
+            this._triggers[event] = null;
+        }
+        return this;
+    }
+    env(vars) {
+        this._env = { ...this._env, ...vars };
+        return this;
+    }
+    permissions(perms) {
+        this._permissions = perms;
+        return this;
+    }
+    concurrency(group, cancelInProgress = true) {
+        this._concurrency = { group, "cancel-in-progress": cancelInProgress };
+        return this;
+    }
+    /** Define a job. The factory receives a Job builder to configure. */
+    job(id, factory) {
+        const j = new Job_1.Job();
+        factory(j);
+        this._jobs.set(id, j);
+        return this;
+    }
+    outputPath() {
+        return `.github/workflows/${this._name}.yml`;
+    }
+    toObject() {
+        if (Object.keys(this._triggers).length === 0) {
+            throw new Error(`Workflow "${this._name}" must have at least one trigger via .on()`);
+        }
+        if (this._jobs.size === 0) {
+            throw new Error(`Workflow "${this._name}" must have at least one job`);
+        }
+        const obj = {
+            name: this._name,
+            on: this._triggers,
+        };
+        if (this._permissions)
+            obj["permissions"] = this._permissions;
+        if (Object.keys(this._env).length > 0)
+            obj["env"] = this._env;
+        if (this._concurrency)
+            obj["concurrency"] = this._concurrency;
+        const jobs = {};
+        for (const [id, job] of this._jobs) {
+            jobs[id] = job.toObject();
+        }
+        obj["jobs"] = jobs;
+        return obj;
+    }
+}
+exports.ActionsWorkflow = ActionsWorkflow;
+//# sourceMappingURL=Workflow.js.map

package/dist/actions/Workflow.js.map

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