@modernedi/configuration-runner 0.2.0-rc.0

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,MAAM,GACP,MAAM,UAAU,CAAC;AAElB,IAAI,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,32 @@
+import { type ConfigurationPlanRequest, type ModernEdiClient } from "@modernedi/sdk";
+import { type ConfigurationApplyResultArtifact, type ConfigurationPlanArtifact } from "./artifacts.js";
+export declare const DEFAULT_APPLY_TIMEOUT_MS: number;
+type ConfigurationAsCodeClient = Pick<ModernEdiClient["configurationAsCode"], "applyIntegrationConfigurationRaw" | "getIntegrationConfigurationApplyOperation" | "planIntegrationConfiguration">;
+export interface ConfigurationRunnerClient {
+    configurationAsCode: ConfigurationAsCodeClient;
+}
+export interface ApplyReviewedOptions {
+    client: ConfigurationRunnerClient;
+    request: ConfigurationPlanRequest;
+    reviewedPlan: ConfigurationPlanArtifact;
+    idempotencyKey: string;
+    timeoutMs?: number;
+    appUrl?: string;
+    now?: () => number;
+    sleep?: (milliseconds: number) => Promise<void>;
+    onResult?: (result: ConfigurationApplyResultArtifact) => Promise<void>;
+}
+export interface WaitForConfigurationApplyOptions {
+    client: ConfigurationRunnerClient;
+    result: ConfigurationApplyResultArtifact;
+    timeoutMs?: number;
+    appUrl?: string;
+    now?: () => number;
+    sleep?: (milliseconds: number) => Promise<void>;
+    onResult?: (result: ConfigurationApplyResultArtifact) => Promise<void>;
+}
+export declare function planConfiguration(client: ConfigurationRunnerClient, request: ConfigurationPlanRequest): Promise<ConfigurationPlanArtifact>;
+export declare function applyReviewedConfiguration(options: ApplyReviewedOptions): Promise<ConfigurationApplyResultArtifact>;
+export declare function waitForConfigurationApply(options: WaitForConfigurationApplyOptions): Promise<ConfigurationApplyResultArtifact>;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,wBAAwB,EAE7B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAGL,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAKxB,eAAO,MAAM,wBAAwB,QAAc,CAAC;AAEpD,KAAK,yBAAyB,GAAG,IAAI,CACnC,eAAe,CAAC,qBAAqB,CAAC,EACpC,kCAAkC,GAClC,2CAA2C,GAC3C,8BAA8B,CACjC,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,yBAAyB,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,wBAAwB,CAAC;IAClC,YAAY,EAAE,yBAAyB,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gCAAgC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,yBAAyB,CAAC;IAClC,MAAM,EAAE,gCAAgC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gCAAgC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,yBAAyB,EACjC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,yBAAyB,CAAC,CAGpC;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,gCAAgC,CAAC,CAuD3C;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,gCAAgC,CAAC,CAgD3C"}

package/dist/runner.js

@@ -0,0 +1,174 @@
+import { ConfigurationPlanResponseToJSON, getModernEdiResponseMetadata, } from "@modernedi/sdk";
+import { configurationApplyResultArtifact, configurationPlanArtifact, } from "./artifacts.js";
+import { canonicalJson } from "./canonical-json.js";
+import { runnerError } from "./errors.js";
+const DEFAULT_POLL_INTERVAL_MS = 15_000;
+export const DEFAULT_APPLY_TIMEOUT_MS = 15 * 60_000;
+export async function planConfiguration(client, request) {
+    const plan = await currentPlan(client, request);
+    return configurationPlanArtifact(plan);
+}
+export async function applyReviewedConfiguration(options) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_APPLY_TIMEOUT_MS;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+        throw runnerError("APPLY_TIMEOUT_INVALID", "Apply timeout must be a positive whole number of milliseconds.", 64);
+    }
+    assertIdempotencyKey(options.idempotencyKey);
+    assertReviewedPlanApplicable(options.reviewedPlan);
+    const replanned = await currentPlan(options.client, options.request);
+    assertReviewedPlanMatches(options.reviewedPlan, replanned);
+    const submitted = await options.client.configurationAsCode
+        .applyIntegrationConfigurationRaw({
+        idempotencyKey: options.idempotencyKey,
+        ifMatch: replanned.currentSnapshotEtag,
+        configurationApplyRequest: {
+            planSha256: replanned.planSha256,
+            files: options.request.files,
+        },
+    });
+    const metadata = getModernEdiResponseMetadata(submitted.raw);
+    let result = await submitted.value();
+    assertOperationMatchesReviewedPlan(options.reviewedPlan, result);
+    const submittedOperationId = result.operation.operationId;
+    let artifact = configurationApplyResultArtifact(options.reviewedPlan, result, metadata.idempotencyReplayed ?? false, options.appUrl);
+    await options.onResult?.(artifact);
+    result = await waitForApplyOperation(options.client, result, {
+        timeoutMs,
+        initialPollIntervalMs: retryAfterMilliseconds(metadata.retryAfter),
+        now: options.now,
+        sleep: options.sleep,
+        onOperation: async (operation) => {
+            assertOperationMatchesReviewedPlan(options.reviewedPlan, operation, submittedOperationId);
+            artifact = configurationApplyResultArtifact(options.reviewedPlan, operation, metadata.idempotencyReplayed ?? false, options.appUrl);
+            await options.onResult?.(artifact);
+        },
+    });
+    return artifact;
+}
+export async function waitForConfigurationApply(options) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_APPLY_TIMEOUT_MS;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+        throw runnerError("APPLY_TIMEOUT_INVALID", "Apply timeout must be a positive whole number of milliseconds.", 64);
+    }
+    const operationId = requireStoredOperationString(options.result, "operationId");
+    const storedStatus = requireStoredOperationString(options.result, "status");
+    if (storedStatus !== "PENDING" && storedStatus !== "SUCCEEDED") {
+        throw runnerError("APPLY_RESULT_STATUS_INVALID", `Stored configuration apply ${operationId} has unsupported status ${storedStatus}.`, 4);
+    }
+    let response = await options.client.configurationAsCode
+        .getIntegrationConfigurationApplyOperation({ operationId });
+    assertOperationMatchesStoredResult(options.result, response);
+    let artifact = configurationApplyResultArtifact(options.result.reviewed, response, options.result.idempotencyReplayed, options.appUrl);
+    await options.onResult?.(artifact);
+    response = await waitForApplyOperation(options.client, response, {
+        timeoutMs,
+        now: options.now,
+        sleep: options.sleep,
+        onOperation: async (operation) => {
+            assertOperationMatchesStoredResult(options.result, operation);
+            artifact = configurationApplyResultArtifact(options.result.reviewed, operation, options.result.idempotencyReplayed, options.appUrl);
+            await options.onResult?.(artifact);
+        },
+    });
+    return artifact;
+}
+async function currentPlan(client, request) {
+    return client.configurationAsCode.planIntegrationConfiguration({
+        configurationPlanRequest: request,
+    });
+}
+async function waitForApplyOperation(client, initial, options) {
+    const now = options.now ?? Date.now;
+    const sleep = options.sleep ?? delay;
+    const startedAt = now();
+    const deadline = startedAt + options.timeoutMs;
+    const pollIntervalMs = options.initialPollIntervalMs
+        ?? DEFAULT_POLL_INTERVAL_MS;
+    let current = initial;
+    const operationId = initial.operation.operationId;
+    while (current.operation.status === "PENDING") {
+        const remaining = deadline - now();
+        if (remaining <= 0) {
+            throw runnerError("APPLY_POLL_TIMEOUT", `Configuration apply ${current.operation.operationId} is still PENDING after ${options.timeoutMs} ms. The database change may already be committed; resume polling this operation instead of submitting another apply.`, 4);
+        }
+        await sleep(Math.min(pollIntervalMs, remaining));
+        current = await client.configurationAsCode
+            .getIntegrationConfigurationApplyOperation({
+            operationId,
+        });
+        if (current.operation.operationId !== operationId) {
+            throw runnerError("APPLY_OPERATION_IDENTITY_MISMATCH", `ModernEDI returned operation ${current.operation.operationId} while polling ${operationId}.`, 4);
+        }
+        await options.onOperation?.(current);
+    }
+    if (current.operation.status !== "SUCCEEDED") {
+        throw runnerError("APPLY_STATUS_UNSUPPORTED", `Configuration apply ${current.operation.operationId} returned unsupported status ${current.operation.status}.`);
+    }
+    return current;
+}
+function assertOperationMatchesReviewedPlan(reviewed, current, operationId) {
+    if ((operationId !== undefined && current.operation.operationId !== operationId)
+        || current.operation.desiredBundleSha256 !== reviewed.desiredBundleSha256
+        || current.operation.planSha256 !== reviewed.planSha256) {
+        throw runnerError("APPLY_OPERATION_IDENTITY_MISMATCH", "ModernEDI returned an apply operation that does not match the reviewed bundle and plan identities.", 4);
+    }
+}
+function assertOperationMatchesStoredResult(stored, current) {
+    const operationId = requireStoredOperationString(stored, "operationId");
+    if (current.operation.operationId !== operationId
+        || current.operation.desiredBundleSha256
+            !== stored.reviewed.desiredBundleSha256
+        || current.operation.planSha256 !== stored.reviewed.planSha256) {
+        throw runnerError("APPLY_OPERATION_IDENTITY_MISMATCH", `ModernEDI returned an operation that does not match stored apply ${operationId}.`, 4);
+    }
+}
+function requireStoredOperationString(stored, field) {
+    const value = stored.operation[field];
+    if (typeof value !== "string" || !value) {
+        throw runnerError("APPLY_RESULT_INVALID", `Stored apply operation ${field} must be a non-empty string.`, 4);
+    }
+    return value;
+}
+function assertReviewedPlanApplicable(reviewed) {
+    if (reviewed.planSha256 === null
+        || reviewed.plan.applicable !== true) {
+        throw runnerError("REVIEWED_PLAN_NOT_APPLICABLE", "Reviewed plan is not applicable and cannot authorize configuration changes.", 3);
+    }
+}
+function assertReviewedPlanMatches(reviewed, current) {
+    if (!current.applicable || current.planSha256 === null) {
+        throw runnerError("REVIEWED_PLAN_NO_LONGER_APPLICABLE", "Protected apply re-plan is not applicable. Review the new diagnostics; no apply was submitted.", 3);
+    }
+    if (current.desiredBundleSha256 !== reviewed.desiredBundleSha256) {
+        throw runnerError("REVIEWED_BUNDLE_MISMATCH", `Protected apply bundle ${current.desiredBundleSha256} does not match reviewed bundle ${reviewed.desiredBundleSha256}. No apply was submitted.`, 3);
+    }
+    if (current.planSha256 !== reviewed.planSha256) {
+        throw runnerError("REVIEWED_PLAN_MISMATCH", `Protected apply plan ${current.planSha256} does not match reviewed plan ${reviewed.planSha256}. Workspace state or validation context changed; review a fresh plan before applying.`, 3);
+    }
+    const currentWire = JSON.parse(JSON.stringify(ConfigurationPlanResponseToJSON(current)));
+    if (canonicalJson(currentWire) !== canonicalJson(reviewed.plan)) {
+        throw runnerError("REVIEWED_PLAN_CONTENT_MISMATCH", "Fresh protected apply plan does not exactly match the complete reviewed plan artifact. No apply was submitted.", 3);
+    }
+}
+function assertIdempotencyKey(value) {
+    if (!value.trim()
+        || value !== value.trim()
+        || value.length > 200
+        || /[\r\n]/u.test(value)) {
+        throw runnerError("IDEMPOTENCY_KEY_INVALID", "MODERNEDI_IDEMPOTENCY_KEY must be a persisted non-empty value of at most 200 characters without surrounding whitespace or line breaks.", 64);
+    }
+}
+function retryAfterMilliseconds(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const seconds = Number(value);
+    if (!Number.isFinite(seconds) || seconds < 0) {
+        return undefined;
+    }
+    return Math.max(1, Math.ceil(seconds * 1_000));
+}
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@modernedi/configuration-runner",
+  "version": "0.2.0-rc.0",
+  "description": "Vendor-neutral CI runner for reviewed ModernEDI configuration plans",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brcolow/modernedi.git",
+    "directory": "automation/configuration-runner"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "modernedi-configuration": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "build:repo": "npm --prefix ../../sdks/typescript run build && node ./scripts/link-repository-sdk.mjs && npm run clean && node ../../sdks/typescript/node_modules/typescript/bin/tsc -p tsconfig.json",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "test:repo": "npm run build:repo && node --test test/*.test.mjs",
+    "verify:dependency-contract": "node ./scripts/verify-dependency-contract.mjs",
+    "verify": "npm run verify:dependency-contract && npm test && npm pack --dry-run",
+    "verify:repo": "npm run verify:dependency-contract && npm run test:repo && npm run verify:dependency-contract && npm pack --dry-run --ignore-scripts",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "dependencies": {
+    "@modernedi/sdk": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.43",
+    "typescript": "^7.0.2"
+  }
+}

package/schemas/configuration-apply-result-artifact.schema.json

@@ -0,0 +1,218 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://www.modernedi.com/schemas/configuration-runner/v1/configuration-apply-result-artifact.schema.json",
+  "title": "ModernEDI Configuration Apply Result Artifact",
+  "description": "Deterministic result artifact emitted by @modernedi/configuration-runner after a reviewed apply.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "apiVersion",
+    "kind",
+    "reviewed",
+    "idempotencyReplayed",
+    "workspaceUrl",
+    "operation"
+  ],
+  "properties": {
+    "apiVersion": {
+      "const": "modernedi.com/configuration-runner/v1"
+    },
+    "kind": {
+      "const": "ConfigurationApplyResultArtifact"
+    },
+    "reviewed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "desiredBundleSha256",
+        "planSha256"
+      ],
+      "properties": {
+        "desiredBundleSha256": {
+          "$ref": "configuration-plan-artifact.schema.json#/$defs/sha256"
+        },
+        "planSha256": {
+          "$ref": "configuration-plan-artifact.schema.json#/$defs/sha256"
+        }
+      }
+    },
+    "idempotencyReplayed": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "workspaceUrl": {
+      "type": "string",
+      "format": "uri"
+    },
+    "operation": {
+      "$ref": "#/$defs/applyOperation"
+    }
+  },
+  "$defs": {
+    "runtimePublication": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "state",
+        "retrying"
+      ],
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": [
+            "published",
+            "pending",
+            "not_provisioned"
+          ]
+        },
+        "retrying": {
+          "type": "boolean"
+        },
+        "message": {
+          "type": "string"
+        }
+      }
+    },
+    "applyOperation": {
+      "type": "object",
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "status": {
+                "const": "PENDING"
+              }
+            },
+            "required": [
+              "status"
+            ]
+          },
+          "then": {
+            "properties": {
+              "completedAt": {
+                "type": "null"
+              },
+              "runtimePublication": {
+                "properties": {
+                  "state": {
+                    "const": "pending"
+                  },
+                  "retrying": {
+                    "const": true
+                  }
+                }
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "status": {
+                "const": "SUCCEEDED"
+              }
+            },
+            "required": [
+              "status"
+            ]
+          },
+          "then": {
+            "properties": {
+              "completedAt": {
+                "type": "string",
+                "format": "date-time"
+              },
+              "runtimePublication": {
+                "properties": {
+                  "state": {
+                    "enum": [
+                      "published",
+                      "not_provisioned"
+                    ]
+                  },
+                  "retrying": {
+                    "const": false
+                  }
+                }
+              }
+            }
+          }
+        }
+      ],
+      "required": [
+        "operationId",
+        "status",
+        "desiredBundleSha256",
+        "planSha256",
+        "baseSnapshotEtag",
+        "appliedSnapshotEtag",
+        "runtimeConfigurationRevision",
+        "summary",
+        "operations",
+        "runtimePublication",
+        "requestedAt",
+        "committedAt",
+        "completedAt"
+      ],
+      "properties": {
+        "operationId": {
+          "type": "string",
+          "pattern": "^apply-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "PENDING",
+            "SUCCEEDED"
+          ]
+        },
+        "desiredBundleSha256": {
+          "$ref": "configuration-plan-artifact.schema.json#/$defs/sha256"
+        },
+        "planSha256": {
+          "$ref": "configuration-plan-artifact.schema.json#/$defs/sha256"
+        },
+        "baseSnapshotEtag": {
+          "$ref": "configuration-plan-artifact.schema.json#/$defs/etag"
+        },
+        "appliedSnapshotEtag": {
+          "$ref": "configuration-plan-artifact.schema.json#/$defs/etag"
+        },
+        "runtimeConfigurationRevision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "summary": {
+          "$ref": "configuration-plan-artifact.schema.json#/$defs/summary"
+        },
+        "operations": {
+          "type": "array",
+          "items": {
+            "$ref": "configuration-plan-artifact.schema.json#/$defs/operation"
+          }
+        },
+        "runtimePublication": {
+          "$ref": "#/$defs/runtimePublication"
+        },
+        "requestedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "committedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "completedAt": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "format": "date-time"
+        }
+      }
+    }
+  }
+}