@numa-tech/numa 1.13.4 → 1.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +140 -26
- package/dist/application-onboarding/client.d.ts +1 -0
- package/dist/application-onboarding/commands.d.ts +2 -0
- package/dist/application-onboarding/commands.js +41 -16
- package/dist/application-onboarding/commands.js.map +1 -1
- package/dist/application-onboarding/errors.js +1 -1
- package/dist/application-onboarding/errors.js.map +1 -1
- package/dist/application-onboarding/schemas.d.ts +8 -0
- package/dist/application-onboarding/schemas.js +4 -2
- package/dist/application-onboarding/schemas.js.map +1 -1
- package/dist/application-onboarding/scm-credentials.d.ts +5 -2
- package/dist/application-onboarding/scm-credentials.js +64 -13
- package/dist/application-onboarding/scm-credentials.js.map +1 -1
- package/dist/cli.js +4 -2
- package/dist/cli.js.map +1 -1
- package/dist/command-catalog.js +252 -15
- package/dist/command-catalog.js.map +1 -1
- package/dist/integration-bootstrap/client.d.ts +23 -0
- package/dist/integration-bootstrap/client.js +124 -0
- package/dist/integration-bootstrap/client.js.map +1 -0
- package/dist/integration-bootstrap/commands.d.ts +20 -0
- package/dist/integration-bootstrap/commands.js +129 -0
- package/dist/integration-bootstrap/commands.js.map +1 -0
- package/dist/integration-bootstrap/schemas.d.ts +422 -0
- package/dist/integration-bootstrap/schemas.js +216 -0
- package/dist/integration-bootstrap/schemas.js.map +1 -0
- package/dist/jenkins/commands.d.ts +10 -0
- package/dist/jenkins/commands.js +15 -0
- package/dist/jenkins/commands.js.map +1 -0
- package/dist/jenkins-jobs/client.d.ts +12 -12
- package/dist/jenkins-jobs/schemas.d.ts +96 -8
- package/dist/jenkins-jobs/schemas.js +2 -2
- package/dist/jenkins-jobs/schemas.js.map +1 -1
- package/dist/pipeline/client.d.ts +5 -0
- package/dist/pipeline/commands.js +2 -0
- package/dist/pipeline/commands.js.map +1 -1
- package/dist/pipeline/schemas.d.ts +6 -0
- package/dist/pipeline/schemas.js +2 -0
- package/dist/pipeline/schemas.js.map +1 -1
- package/dist/platform-build-job-replans/client.d.ts +283 -0
- package/dist/platform-build-job-replans/client.js +148 -0
- package/dist/platform-build-job-replans/client.js.map +1 -0
- package/dist/platform-build-job-replans/commands.d.ts +6 -0
- package/dist/platform-build-job-replans/commands.js +371 -0
- package/dist/platform-build-job-replans/commands.js.map +1 -0
- package/dist/platform-build-job-replans/schemas.d.ts +145 -0
- package/dist/platform-build-job-replans/schemas.js +150 -0
- package/dist/platform-build-job-replans/schemas.js.map +1 -0
- package/dist/platform-build-rollouts/client.d.ts +346 -0
- package/dist/platform-build-rollouts/client.js +153 -0
- package/dist/platform-build-rollouts/client.js.map +1 -0
- package/dist/platform-build-rollouts/commands.d.ts +98 -0
- package/dist/platform-build-rollouts/commands.js +465 -0
- package/dist/platform-build-rollouts/commands.js.map +1 -0
- package/dist/platform-build-rollouts/schemas.d.ts +348 -0
- package/dist/platform-build-rollouts/schemas.js +257 -0
- package/dist/platform-build-rollouts/schemas.js.map +1 -0
- package/dist/platform-builds/client.d.ts +147 -0
- package/dist/platform-builds/client.js +115 -0
- package/dist/platform-builds/client.js.map +1 -0
- package/dist/platform-builds/commands.d.ts +7 -0
- package/dist/platform-builds/commands.js +226 -0
- package/dist/platform-builds/commands.js.map +1 -0
- package/dist/platform-builds/schemas.d.ts +127 -0
- package/dist/platform-builds/schemas.js +66 -0
- package/dist/platform-builds/schemas.js.map +1 -0
- package/dist/publications/client.d.ts +30 -0
- package/dist/publications/client.js +6 -1
- package/dist/publications/client.js.map +1 -1
- package/dist/publications/commands.d.ts +2 -0
- package/dist/publications/commands.js +84 -5
- package/dist/publications/commands.js.map +1 -1
- package/dist/repositories/client.d.ts +6 -0
- package/dist/repositories/commands.d.ts +3 -1
- package/dist/repositories/commands.js +22 -8
- package/dist/repositories/commands.js.map +1 -1
- package/dist/repositories/errors.d.ts +2 -1
- package/dist/repositories/errors.js +4 -2
- package/dist/repositories/errors.js.map +1 -1
- package/dist/repositories/schemas.d.ts +32 -0
- package/dist/repositories/schemas.js +4 -0
- package/dist/repositories/schemas.js.map +1 -1
- package/package.json +4 -4
- package/skills/numa-create-application/SKILL.md +26 -13
- package/skills/numa-create-application/agents/openai.yaml +2 -2
- package/skills/numa-create-application/evals/evals.json +72 -12
- package/skills/numa-create-application/references/checklist.md +12 -5
- package/skills/numa-create-application/references/numa-cli.md +55 -13
- package/skills/numa-create-application/references/promote-workflows.md +63 -24
- package/skills/numa-create-application/scripts/inspect-project.mjs +1 -0
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
import type { AuthConfig } from "../config.js";
|
|
2
|
+
import { type KeycloakTokenProvider } from "../oauth.js";
|
|
3
|
+
import { type PlatformBuildJobActionRequest, type PlatformBuildJobApplyRequest, type PlatformBuildJobPlanRequest } from "./schemas.js";
|
|
4
|
+
export declare const PLATFORM_BUILD_JOB_REPLAN_API_ROOT = "/api/v1/admin/jenkins/platform-build-job-replans";
|
|
5
|
+
export declare const PLATFORM_BUILD_JOB_PLAN_API_ROOT = "/api/v1/admin/jenkins/platform-build-job-replan-plans";
|
|
6
|
+
export interface PlatformBuildJobReplanClientDependencies {
|
|
7
|
+
fetch?: typeof fetch;
|
|
8
|
+
tokenProvider?: KeycloakTokenProvider;
|
|
9
|
+
}
|
|
10
|
+
export declare class PlatformBuildJobReplanClient {
|
|
11
|
+
private readonly config;
|
|
12
|
+
private readonly fetchImpl;
|
|
13
|
+
private readonly tokenProvider;
|
|
14
|
+
constructor(config: AuthConfig, dependencies?: PlatformBuildJobReplanClientDependencies);
|
|
15
|
+
private authenticatedFetch;
|
|
16
|
+
private json;
|
|
17
|
+
createPlan(input: PlatformBuildJobPlanRequest, headerKey: string): Promise<{
|
|
18
|
+
planNo: string;
|
|
19
|
+
operation: "USE_EXISTING";
|
|
20
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
21
|
+
planHash: string;
|
|
22
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
23
|
+
clientRequestId: string;
|
|
24
|
+
requestDigest: string;
|
|
25
|
+
applicationCode: string;
|
|
26
|
+
instanceCode: string;
|
|
27
|
+
canonicalJobId: number;
|
|
28
|
+
canonicalJobFullName: string;
|
|
29
|
+
repositoryKey: string;
|
|
30
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
31
|
+
observedConfigDigest: string;
|
|
32
|
+
sideEffects: string[];
|
|
33
|
+
warnings: string[];
|
|
34
|
+
blockers: string[];
|
|
35
|
+
expiresAt: string;
|
|
36
|
+
}>;
|
|
37
|
+
resolvePlan(clientRequestId: string): Promise<{
|
|
38
|
+
planNo: string;
|
|
39
|
+
operation: "USE_EXISTING";
|
|
40
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
41
|
+
planHash: string;
|
|
42
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
43
|
+
clientRequestId: string;
|
|
44
|
+
requestDigest: string;
|
|
45
|
+
applicationCode: string;
|
|
46
|
+
instanceCode: string;
|
|
47
|
+
canonicalJobId: number;
|
|
48
|
+
canonicalJobFullName: string;
|
|
49
|
+
repositoryKey: string;
|
|
50
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
51
|
+
observedConfigDigest: string;
|
|
52
|
+
sideEffects: string[];
|
|
53
|
+
warnings: string[];
|
|
54
|
+
blockers: string[];
|
|
55
|
+
expiresAt: string;
|
|
56
|
+
}>;
|
|
57
|
+
getPlan(planNo: string): Promise<{
|
|
58
|
+
planNo: string;
|
|
59
|
+
operation: "USE_EXISTING";
|
|
60
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
61
|
+
planHash: string;
|
|
62
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
63
|
+
clientRequestId: string;
|
|
64
|
+
requestDigest: string;
|
|
65
|
+
applicationCode: string;
|
|
66
|
+
instanceCode: string;
|
|
67
|
+
canonicalJobId: number;
|
|
68
|
+
canonicalJobFullName: string;
|
|
69
|
+
repositoryKey: string;
|
|
70
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
71
|
+
observedConfigDigest: string;
|
|
72
|
+
sideEffects: string[];
|
|
73
|
+
warnings: string[];
|
|
74
|
+
blockers: string[];
|
|
75
|
+
expiresAt: string;
|
|
76
|
+
}>;
|
|
77
|
+
apply(input: PlatformBuildJobApplyRequest, headerKey: string): Promise<{
|
|
78
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
79
|
+
plan: {
|
|
80
|
+
planNo: string;
|
|
81
|
+
operation: "USE_EXISTING";
|
|
82
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
83
|
+
planHash: string;
|
|
84
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
85
|
+
clientRequestId: string;
|
|
86
|
+
requestDigest: string;
|
|
87
|
+
applicationCode: string;
|
|
88
|
+
instanceCode: string;
|
|
89
|
+
canonicalJobId: number;
|
|
90
|
+
canonicalJobFullName: string;
|
|
91
|
+
repositoryKey: string;
|
|
92
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
93
|
+
observedConfigDigest: string;
|
|
94
|
+
sideEffects: string[];
|
|
95
|
+
warnings: string[];
|
|
96
|
+
blockers: string[];
|
|
97
|
+
expiresAt: string;
|
|
98
|
+
};
|
|
99
|
+
run: {
|
|
100
|
+
runNo: string;
|
|
101
|
+
planNo: string;
|
|
102
|
+
clientRequestId: string;
|
|
103
|
+
requestDigest: string;
|
|
104
|
+
state: "ACCEPTED" | "FAILED" | "RUNNING" | "SUCCEEDED" | "UNKNOWN";
|
|
105
|
+
stepCode: string;
|
|
106
|
+
canonicalJobId: number;
|
|
107
|
+
canonicalJobFullName: string;
|
|
108
|
+
bindingId: number;
|
|
109
|
+
observedConfigDigest: string | null;
|
|
110
|
+
retryable: boolean;
|
|
111
|
+
errorCode: string | null;
|
|
112
|
+
errorMessage: string | null;
|
|
113
|
+
acceptedAt: string;
|
|
114
|
+
startedAt: string | null;
|
|
115
|
+
completedAt: string | null;
|
|
116
|
+
};
|
|
117
|
+
}>;
|
|
118
|
+
resolve(clientRequestId: string): Promise<{
|
|
119
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
120
|
+
plan: {
|
|
121
|
+
planNo: string;
|
|
122
|
+
operation: "USE_EXISTING";
|
|
123
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
124
|
+
planHash: string;
|
|
125
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
126
|
+
clientRequestId: string;
|
|
127
|
+
requestDigest: string;
|
|
128
|
+
applicationCode: string;
|
|
129
|
+
instanceCode: string;
|
|
130
|
+
canonicalJobId: number;
|
|
131
|
+
canonicalJobFullName: string;
|
|
132
|
+
repositoryKey: string;
|
|
133
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
134
|
+
observedConfigDigest: string;
|
|
135
|
+
sideEffects: string[];
|
|
136
|
+
warnings: string[];
|
|
137
|
+
blockers: string[];
|
|
138
|
+
expiresAt: string;
|
|
139
|
+
};
|
|
140
|
+
run: {
|
|
141
|
+
runNo: string;
|
|
142
|
+
planNo: string;
|
|
143
|
+
clientRequestId: string;
|
|
144
|
+
requestDigest: string;
|
|
145
|
+
state: "ACCEPTED" | "FAILED" | "RUNNING" | "SUCCEEDED" | "UNKNOWN";
|
|
146
|
+
stepCode: string;
|
|
147
|
+
canonicalJobId: number;
|
|
148
|
+
canonicalJobFullName: string;
|
|
149
|
+
bindingId: number;
|
|
150
|
+
observedConfigDigest: string | null;
|
|
151
|
+
retryable: boolean;
|
|
152
|
+
errorCode: string | null;
|
|
153
|
+
errorMessage: string | null;
|
|
154
|
+
acceptedAt: string;
|
|
155
|
+
startedAt: string | null;
|
|
156
|
+
completedAt: string | null;
|
|
157
|
+
};
|
|
158
|
+
}>;
|
|
159
|
+
get(runNo: string): Promise<{
|
|
160
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
161
|
+
plan: {
|
|
162
|
+
planNo: string;
|
|
163
|
+
operation: "USE_EXISTING";
|
|
164
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
165
|
+
planHash: string;
|
|
166
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
167
|
+
clientRequestId: string;
|
|
168
|
+
requestDigest: string;
|
|
169
|
+
applicationCode: string;
|
|
170
|
+
instanceCode: string;
|
|
171
|
+
canonicalJobId: number;
|
|
172
|
+
canonicalJobFullName: string;
|
|
173
|
+
repositoryKey: string;
|
|
174
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
175
|
+
observedConfigDigest: string;
|
|
176
|
+
sideEffects: string[];
|
|
177
|
+
warnings: string[];
|
|
178
|
+
blockers: string[];
|
|
179
|
+
expiresAt: string;
|
|
180
|
+
};
|
|
181
|
+
run: {
|
|
182
|
+
runNo: string;
|
|
183
|
+
planNo: string;
|
|
184
|
+
clientRequestId: string;
|
|
185
|
+
requestDigest: string;
|
|
186
|
+
state: "ACCEPTED" | "FAILED" | "RUNNING" | "SUCCEEDED" | "UNKNOWN";
|
|
187
|
+
stepCode: string;
|
|
188
|
+
canonicalJobId: number;
|
|
189
|
+
canonicalJobFullName: string;
|
|
190
|
+
bindingId: number;
|
|
191
|
+
observedConfigDigest: string | null;
|
|
192
|
+
retryable: boolean;
|
|
193
|
+
errorCode: string | null;
|
|
194
|
+
errorMessage: string | null;
|
|
195
|
+
acceptedAt: string;
|
|
196
|
+
startedAt: string | null;
|
|
197
|
+
completedAt: string | null;
|
|
198
|
+
};
|
|
199
|
+
}>;
|
|
200
|
+
retry(runNo: string, input: PlatformBuildJobActionRequest, headerKey: string): Promise<{
|
|
201
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
202
|
+
plan: {
|
|
203
|
+
planNo: string;
|
|
204
|
+
operation: "USE_EXISTING";
|
|
205
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
206
|
+
planHash: string;
|
|
207
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
208
|
+
clientRequestId: string;
|
|
209
|
+
requestDigest: string;
|
|
210
|
+
applicationCode: string;
|
|
211
|
+
instanceCode: string;
|
|
212
|
+
canonicalJobId: number;
|
|
213
|
+
canonicalJobFullName: string;
|
|
214
|
+
repositoryKey: string;
|
|
215
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
216
|
+
observedConfigDigest: string;
|
|
217
|
+
sideEffects: string[];
|
|
218
|
+
warnings: string[];
|
|
219
|
+
blockers: string[];
|
|
220
|
+
expiresAt: string;
|
|
221
|
+
};
|
|
222
|
+
run: {
|
|
223
|
+
runNo: string;
|
|
224
|
+
planNo: string;
|
|
225
|
+
clientRequestId: string;
|
|
226
|
+
requestDigest: string;
|
|
227
|
+
state: "ACCEPTED" | "FAILED" | "RUNNING" | "SUCCEEDED" | "UNKNOWN";
|
|
228
|
+
stepCode: string;
|
|
229
|
+
canonicalJobId: number;
|
|
230
|
+
canonicalJobFullName: string;
|
|
231
|
+
bindingId: number;
|
|
232
|
+
observedConfigDigest: string | null;
|
|
233
|
+
retryable: boolean;
|
|
234
|
+
errorCode: string | null;
|
|
235
|
+
errorMessage: string | null;
|
|
236
|
+
acceptedAt: string;
|
|
237
|
+
startedAt: string | null;
|
|
238
|
+
completedAt: string | null;
|
|
239
|
+
};
|
|
240
|
+
}>;
|
|
241
|
+
reconcile(runNo: string, input: PlatformBuildJobActionRequest, headerKey: string): Promise<{
|
|
242
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
243
|
+
plan: {
|
|
244
|
+
planNo: string;
|
|
245
|
+
operation: "USE_EXISTING";
|
|
246
|
+
state: "BLOCKED" | "CONSUMED" | "EXPIRED" | "READY";
|
|
247
|
+
planHash: string;
|
|
248
|
+
policyVersion: "jenkins-job-plan/v2";
|
|
249
|
+
clientRequestId: string;
|
|
250
|
+
requestDigest: string;
|
|
251
|
+
applicationCode: string;
|
|
252
|
+
instanceCode: string;
|
|
253
|
+
canonicalJobId: number;
|
|
254
|
+
canonicalJobFullName: string;
|
|
255
|
+
repositoryKey: string;
|
|
256
|
+
tier: "DEVELOP" | "PRODUCTION" | "STAGING" | "UNKNOWN";
|
|
257
|
+
observedConfigDigest: string;
|
|
258
|
+
sideEffects: string[];
|
|
259
|
+
warnings: string[];
|
|
260
|
+
blockers: string[];
|
|
261
|
+
expiresAt: string;
|
|
262
|
+
};
|
|
263
|
+
run: {
|
|
264
|
+
runNo: string;
|
|
265
|
+
planNo: string;
|
|
266
|
+
clientRequestId: string;
|
|
267
|
+
requestDigest: string;
|
|
268
|
+
state: "ACCEPTED" | "FAILED" | "RUNNING" | "SUCCEEDED" | "UNKNOWN";
|
|
269
|
+
stepCode: string;
|
|
270
|
+
canonicalJobId: number;
|
|
271
|
+
canonicalJobFullName: string;
|
|
272
|
+
bindingId: number;
|
|
273
|
+
observedConfigDigest: string | null;
|
|
274
|
+
retryable: boolean;
|
|
275
|
+
errorCode: string | null;
|
|
276
|
+
errorMessage: string | null;
|
|
277
|
+
acceptedAt: string;
|
|
278
|
+
startedAt: string | null;
|
|
279
|
+
completedAt: string | null;
|
|
280
|
+
};
|
|
281
|
+
}>;
|
|
282
|
+
private action;
|
|
283
|
+
}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
import { resolveBackendUrl } from "../backend.js";
|
|
2
|
+
import { ensureAccessToken, fetchWithKeycloakIdentity } from "../oauth.js";
|
|
3
|
+
import { PipelineError, redactPipelineText } from "../pipeline/errors.js";
|
|
4
|
+
import { ApiErrorSchema } from "../pipeline/schemas.js";
|
|
5
|
+
import { PlatformBuildJobActionRequestSchema, PlatformBuildJobApplyRequestSchema, PlatformBuildJobPlanRequestSchema, PlatformBuildJobPlanSchema, PlatformBuildJobReplanSchema } from "./schemas.js";
|
|
6
|
+
export const PLATFORM_BUILD_JOB_REPLAN_API_ROOT = "/api/v1/admin/jenkins/platform-build-job-replans";
|
|
7
|
+
export const PLATFORM_BUILD_JOB_PLAN_API_ROOT = "/api/v1/admin/jenkins/platform-build-job-replan-plans";
|
|
8
|
+
function safeIdentifier(value, label, maximum = 200) {
|
|
9
|
+
const trimmed = value.trim();
|
|
10
|
+
if (!trimmed || trimmed.length > maximum
|
|
11
|
+
|| !/^[A-Za-z0-9][A-Za-z0-9._:/+-]*$/u.test(trimmed)) {
|
|
12
|
+
throw new PipelineError(`${label} must be 1-${maximum} safe opaque characters.`, "JENKINS_PLATFORM_BUILD_JOB_REPLAN_INPUT_INVALID");
|
|
13
|
+
}
|
|
14
|
+
return trimmed;
|
|
15
|
+
}
|
|
16
|
+
async function responseBody(response) {
|
|
17
|
+
const text = await response.text();
|
|
18
|
+
if (!text)
|
|
19
|
+
return {};
|
|
20
|
+
try {
|
|
21
|
+
return JSON.parse(text);
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
return text;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
function requestIdFrom(response, body) {
|
|
28
|
+
if (body && typeof body === "object" && "requestId" in body
|
|
29
|
+
&& typeof body.requestId === "string")
|
|
30
|
+
return body.requestId;
|
|
31
|
+
return response.headers.get("x-request-id") ?? undefined;
|
|
32
|
+
}
|
|
33
|
+
function apiFailure(response, body) {
|
|
34
|
+
const parsed = ApiErrorSchema.safeParse(body);
|
|
35
|
+
const message = parsed.success
|
|
36
|
+
? parsed.data.message ?? response.statusText ?? "Platform-build job replan API failed."
|
|
37
|
+
: typeof body === "string" ? body
|
|
38
|
+
: response.statusText || "Platform-build job replan API failed.";
|
|
39
|
+
return new PipelineError(`Platform-build job replan API HTTP ${response.status}: ${redactPipelineText(message)}`, parsed.success
|
|
40
|
+
? parsed.data.code ?? "JENKINS_PLATFORM_BUILD_JOB_REPLAN_API_ERROR"
|
|
41
|
+
: "JENKINS_PLATFORM_BUILD_JOB_REPLAN_API_ERROR", response.status, requestIdFrom(response, body));
|
|
42
|
+
}
|
|
43
|
+
export class PlatformBuildJobReplanClient {
|
|
44
|
+
config;
|
|
45
|
+
fetchImpl;
|
|
46
|
+
tokenProvider;
|
|
47
|
+
constructor(config, dependencies = {}) {
|
|
48
|
+
this.config = config;
|
|
49
|
+
this.fetchImpl = dependencies.fetch ?? fetch;
|
|
50
|
+
this.tokenProvider = dependencies.tokenProvider ?? ensureAccessToken;
|
|
51
|
+
}
|
|
52
|
+
async authenticatedFetch(path, init = {}) {
|
|
53
|
+
const method = String(init.method ?? "GET").toUpperCase();
|
|
54
|
+
const url = resolveBackendUrl(this.config, { method, path });
|
|
55
|
+
const headers = new Headers(init.headers);
|
|
56
|
+
headers.set("Accept", "application/json");
|
|
57
|
+
if (init.body != null)
|
|
58
|
+
headers.set("Content-Type", "application/json");
|
|
59
|
+
return fetchWithKeycloakIdentity(this.config, url, () => ({ ...init, headers }), {
|
|
60
|
+
fetch: this.fetchImpl,
|
|
61
|
+
tokenProvider: this.tokenProvider
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
async json(path, schema, init = {}, expectedStatuses) {
|
|
65
|
+
const response = await this.authenticatedFetch(path, init);
|
|
66
|
+
const body = await responseBody(response);
|
|
67
|
+
if (!response.ok)
|
|
68
|
+
throw apiFailure(response, body);
|
|
69
|
+
if (expectedStatuses && !expectedStatuses.includes(response.status)) {
|
|
70
|
+
throw new PipelineError(`Platform-build job replan API returned HTTP ${response.status}; expected ${expectedStatuses.join(" or ")}.`, "JENKINS_PLATFORM_BUILD_JOB_REPLAN_INVALID_RESPONSE", response.status, requestIdFrom(response, body));
|
|
71
|
+
}
|
|
72
|
+
const parsed = schema.safeParse(body);
|
|
73
|
+
if (!parsed.success) {
|
|
74
|
+
throw new PipelineError(`Platform-build job replan API returned an invalid response: ${parsed.error.message}`, "JENKINS_PLATFORM_BUILD_JOB_REPLAN_INVALID_RESPONSE", response.status, requestIdFrom(response, body));
|
|
75
|
+
}
|
|
76
|
+
return parsed.data;
|
|
77
|
+
}
|
|
78
|
+
createPlan(input, headerKey) {
|
|
79
|
+
const parsed = PlatformBuildJobPlanRequestSchema.safeParse(input);
|
|
80
|
+
if (!parsed.success) {
|
|
81
|
+
throw new PipelineError(`Platform-build job replan plan input is invalid: ${parsed.error.message}`, "JENKINS_PLATFORM_BUILD_JOB_REPLAN_INPUT_INVALID");
|
|
82
|
+
}
|
|
83
|
+
const key = safeIdentifier(headerKey, "idempotency-key");
|
|
84
|
+
if (key !== parsed.data.idempotencyKey) {
|
|
85
|
+
throw new PipelineError("Idempotency-Key header must exactly match body.idempotencyKey.", "JENKINS_PLATFORM_BUILD_JOB_REPLAN_IDEMPOTENCY_INVALID");
|
|
86
|
+
}
|
|
87
|
+
return this.json(PLATFORM_BUILD_JOB_PLAN_API_ROOT, PlatformBuildJobPlanSchema, {
|
|
88
|
+
method: "POST",
|
|
89
|
+
headers: { "Idempotency-Key": key },
|
|
90
|
+
body: JSON.stringify(parsed.data)
|
|
91
|
+
}, [200]);
|
|
92
|
+
}
|
|
93
|
+
resolvePlan(clientRequestId) {
|
|
94
|
+
const query = new URLSearchParams({
|
|
95
|
+
clientRequestId: safeIdentifier(clientRequestId, "client-request-id")
|
|
96
|
+
});
|
|
97
|
+
return this.json(`${PLATFORM_BUILD_JOB_PLAN_API_ROOT}/resolve?${query.toString()}`, PlatformBuildJobPlanSchema, {}, [200]);
|
|
98
|
+
}
|
|
99
|
+
getPlan(planNo) {
|
|
100
|
+
return this.json(`${PLATFORM_BUILD_JOB_PLAN_API_ROOT}/${encodeURIComponent(safeIdentifier(planNo, "plan-no", 120))}`, PlatformBuildJobPlanSchema, {}, [200]);
|
|
101
|
+
}
|
|
102
|
+
apply(input, headerKey) {
|
|
103
|
+
const parsed = PlatformBuildJobApplyRequestSchema.safeParse(input);
|
|
104
|
+
if (!parsed.success) {
|
|
105
|
+
throw new PipelineError(`Platform-build job apply input is invalid: ${parsed.error.message}`, "JENKINS_PLATFORM_BUILD_JOB_REPLAN_INPUT_INVALID");
|
|
106
|
+
}
|
|
107
|
+
const key = safeIdentifier(headerKey, "idempotency-key");
|
|
108
|
+
if (key !== parsed.data.idempotencyKey) {
|
|
109
|
+
throw new PipelineError("Idempotency-Key header must exactly match body.idempotencyKey.", "JENKINS_PLATFORM_BUILD_JOB_REPLAN_IDEMPOTENCY_INVALID");
|
|
110
|
+
}
|
|
111
|
+
return this.json(PLATFORM_BUILD_JOB_REPLAN_API_ROOT, PlatformBuildJobReplanSchema, {
|
|
112
|
+
method: "POST",
|
|
113
|
+
headers: { "Idempotency-Key": key },
|
|
114
|
+
body: JSON.stringify(parsed.data)
|
|
115
|
+
}, [202]);
|
|
116
|
+
}
|
|
117
|
+
resolve(clientRequestId) {
|
|
118
|
+
const query = new URLSearchParams({
|
|
119
|
+
clientRequestId: safeIdentifier(clientRequestId, "client-request-id")
|
|
120
|
+
});
|
|
121
|
+
return this.json(`${PLATFORM_BUILD_JOB_REPLAN_API_ROOT}/resolve?${query.toString()}`, PlatformBuildJobReplanSchema, {}, [200]);
|
|
122
|
+
}
|
|
123
|
+
get(runNo) {
|
|
124
|
+
return this.json(`${PLATFORM_BUILD_JOB_REPLAN_API_ROOT}/${encodeURIComponent(safeIdentifier(runNo, "run-no", 120))}`, PlatformBuildJobReplanSchema, {}, [200]);
|
|
125
|
+
}
|
|
126
|
+
retry(runNo, input, headerKey) {
|
|
127
|
+
return this.action(runNo, "retry", input, headerKey);
|
|
128
|
+
}
|
|
129
|
+
reconcile(runNo, input, headerKey) {
|
|
130
|
+
return this.action(runNo, "reconcile", input, headerKey);
|
|
131
|
+
}
|
|
132
|
+
action(runNo, action, input, headerKey) {
|
|
133
|
+
const parsed = PlatformBuildJobActionRequestSchema.safeParse(input);
|
|
134
|
+
if (!parsed.success) {
|
|
135
|
+
throw new PipelineError(`Platform-build job ${action} input is invalid: ${parsed.error.message}`, "JENKINS_PLATFORM_BUILD_JOB_REPLAN_INPUT_INVALID");
|
|
136
|
+
}
|
|
137
|
+
const key = safeIdentifier(headerKey, "idempotency-key");
|
|
138
|
+
if (key !== parsed.data.idempotencyKey) {
|
|
139
|
+
throw new PipelineError("Idempotency-Key header must exactly match body.idempotencyKey.", "JENKINS_PLATFORM_BUILD_JOB_REPLAN_IDEMPOTENCY_INVALID");
|
|
140
|
+
}
|
|
141
|
+
return this.json(`${PLATFORM_BUILD_JOB_REPLAN_API_ROOT}/${encodeURIComponent(safeIdentifier(runNo, "run-no", 120))}/${action}`, PlatformBuildJobReplanSchema, {
|
|
142
|
+
method: "POST",
|
|
143
|
+
headers: { "Idempotency-Key": key },
|
|
144
|
+
body: JSON.stringify(parsed.data)
|
|
145
|
+
}, [202]);
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/platform-build-job-replans/client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { Command } from "commander";
|
|
2
|
+
import { PlatformBuildJobReplanClient } from "./client.js";
|
|
3
|
+
export interface PlatformBuildJobCommandDependencies {
|
|
4
|
+
clientFactory?: () => PlatformBuildJobReplanClient;
|
|
5
|
+
}
|
|
6
|
+
export declare function registerPlatformBuildJobCommands(jenkins: Command, dependencies?: PlatformBuildJobCommandDependencies): void;
|