@structured-world/gitlab-mcp 9.0.0 → 9.1.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 +13 -6
- package/README.md.in +12 -5
- package/dist/src/channel-gateway/format.d.ts +8 -0
- package/dist/src/channel-gateway/format.js +116 -0
- package/dist/src/channel-gateway/format.js.map +1 -0
- package/dist/src/channel-gateway/forwarding.d.ts +8 -0
- package/dist/src/channel-gateway/forwarding.js +23 -0
- package/dist/src/channel-gateway/forwarding.js.map +1 -0
- package/dist/src/channel-gateway/gateway.d.ts +35 -0
- package/dist/src/channel-gateway/gateway.js +164 -0
- package/dist/src/channel-gateway/gateway.js.map +1 -0
- package/dist/src/channel-gateway/interceptor.d.ts +19 -0
- package/dist/src/channel-gateway/interceptor.js +71 -0
- package/dist/src/channel-gateway/interceptor.js.map +1 -0
- package/dist/src/channel-gateway/main.d.ts +2 -0
- package/dist/src/channel-gateway/main.js +42 -0
- package/dist/src/channel-gateway/main.js.map +1 -0
- package/dist/src/channel-gateway/watch.d.ts +54 -0
- package/dist/src/channel-gateway/watch.js +143 -0
- package/dist/src/channel-gateway/watch.js.map +1 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +2 -1
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
export type CiResourceKind = 'pipeline' | 'job' | 'deployment';
|
|
2
|
+
export declare const NON_FINAL: ReadonlySet<string>;
|
|
3
|
+
export declare const TERMINAL: Record<CiResourceKind, ReadonlySet<string>>;
|
|
4
|
+
export interface WatchTarget {
|
|
5
|
+
kind: CiResourceKind;
|
|
6
|
+
projectId: string;
|
|
7
|
+
id: number;
|
|
8
|
+
}
|
|
9
|
+
export interface JobState {
|
|
10
|
+
id: number;
|
|
11
|
+
name: string;
|
|
12
|
+
stage: string;
|
|
13
|
+
status: string;
|
|
14
|
+
}
|
|
15
|
+
export interface JobTransition {
|
|
16
|
+
name: string;
|
|
17
|
+
from: string | null;
|
|
18
|
+
to: string;
|
|
19
|
+
}
|
|
20
|
+
export interface WatchEvent {
|
|
21
|
+
target: WatchTarget;
|
|
22
|
+
pipelineState: string;
|
|
23
|
+
jobs: JobState[];
|
|
24
|
+
transitions: JobTransition[];
|
|
25
|
+
terminal: boolean;
|
|
26
|
+
}
|
|
27
|
+
export declare function aggregateState(jobs: readonly JobState[]): string;
|
|
28
|
+
export declare function isTerminal(pipelineState: string): boolean;
|
|
29
|
+
export declare function diffJobs(prev: ReadonlyMap<string, string>, jobs: readonly JobState[]): JobTransition[];
|
|
30
|
+
export declare function snapshot(jobs: readonly JobState[]): Map<string, string>;
|
|
31
|
+
export declare function detectWatchable(projectId: string, result: unknown): WatchTarget | null;
|
|
32
|
+
export interface WatchDeps {
|
|
33
|
+
pollJobs: (target: WatchTarget) => Promise<JobState[]>;
|
|
34
|
+
emit: (event: WatchEvent) => void;
|
|
35
|
+
onError?: (target: WatchTarget, error: unknown) => void;
|
|
36
|
+
sleep?: (ms: number) => Promise<void>;
|
|
37
|
+
now?: () => number;
|
|
38
|
+
}
|
|
39
|
+
export interface WatchOptions {
|
|
40
|
+
pollMs?: number;
|
|
41
|
+
maxDurationMs?: number;
|
|
42
|
+
}
|
|
43
|
+
export declare class WatchManager {
|
|
44
|
+
private readonly active;
|
|
45
|
+
private readonly deps;
|
|
46
|
+
constructor(deps: WatchDeps);
|
|
47
|
+
static key(t: WatchTarget): string;
|
|
48
|
+
get size(): number;
|
|
49
|
+
has(target: WatchTarget): boolean;
|
|
50
|
+
watch(target: WatchTarget, opts?: WatchOptions): Promise<void>;
|
|
51
|
+
cancel(target: WatchTarget): void;
|
|
52
|
+
cancelAll(): void;
|
|
53
|
+
private run;
|
|
54
|
+
}
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.WatchManager = exports.TERMINAL = exports.NON_FINAL = void 0;
|
|
4
|
+
exports.aggregateState = aggregateState;
|
|
5
|
+
exports.isTerminal = isTerminal;
|
|
6
|
+
exports.diffJobs = diffJobs;
|
|
7
|
+
exports.snapshot = snapshot;
|
|
8
|
+
exports.detectWatchable = detectWatchable;
|
|
9
|
+
exports.NON_FINAL = new Set([
|
|
10
|
+
'created',
|
|
11
|
+
'pending',
|
|
12
|
+
'running',
|
|
13
|
+
'waiting_for_resource',
|
|
14
|
+
'preparing',
|
|
15
|
+
'scheduled',
|
|
16
|
+
'blocked',
|
|
17
|
+
]);
|
|
18
|
+
exports.TERMINAL = {
|
|
19
|
+
pipeline: new Set(['success', 'failed', 'canceled', 'skipped']),
|
|
20
|
+
job: new Set(['success', 'failed', 'canceled', 'skipped', 'manual']),
|
|
21
|
+
deployment: new Set(['success', 'failed', 'canceled', 'skipped']),
|
|
22
|
+
};
|
|
23
|
+
function aggregateState(jobs) {
|
|
24
|
+
if (jobs.length === 0)
|
|
25
|
+
return 'pending';
|
|
26
|
+
const states = new Set(jobs.map((j) => j.status));
|
|
27
|
+
for (const s of states)
|
|
28
|
+
if (exports.NON_FINAL.has(s))
|
|
29
|
+
return 'running';
|
|
30
|
+
if (states.has('failed'))
|
|
31
|
+
return 'failed';
|
|
32
|
+
if (states.has('canceled'))
|
|
33
|
+
return 'canceled';
|
|
34
|
+
if (states.has('skipped') && states.size === 1)
|
|
35
|
+
return 'skipped';
|
|
36
|
+
return 'success';
|
|
37
|
+
}
|
|
38
|
+
function isTerminal(pipelineState) {
|
|
39
|
+
return exports.TERMINAL.pipeline.has(pipelineState);
|
|
40
|
+
}
|
|
41
|
+
function diffJobs(prev, jobs) {
|
|
42
|
+
const out = [];
|
|
43
|
+
for (const j of jobs) {
|
|
44
|
+
const before = prev.get(j.name) ?? null;
|
|
45
|
+
if (before !== j.status)
|
|
46
|
+
out.push({ name: j.name, from: before, to: j.status });
|
|
47
|
+
}
|
|
48
|
+
return out;
|
|
49
|
+
}
|
|
50
|
+
function snapshot(jobs) {
|
|
51
|
+
return new Map(jobs.map((j) => [j.name, j.status]));
|
|
52
|
+
}
|
|
53
|
+
function detectWatchable(projectId, result) {
|
|
54
|
+
if (!projectId)
|
|
55
|
+
return null;
|
|
56
|
+
if (result && typeof result === 'object' && !Array.isArray(result)) {
|
|
57
|
+
const r = result;
|
|
58
|
+
const id = r.id;
|
|
59
|
+
const status = r.status;
|
|
60
|
+
if (typeof id === 'number' && typeof status === 'string') {
|
|
61
|
+
const isDeployment = 'environment' in r && 'deployable' in r;
|
|
62
|
+
const isPipeline = 'ref' in r || 'sha' in r || 'source' in r;
|
|
63
|
+
const kind = isDeployment
|
|
64
|
+
? 'deployment'
|
|
65
|
+
: isPipeline
|
|
66
|
+
? 'pipeline'
|
|
67
|
+
: null;
|
|
68
|
+
if (kind && !exports.TERMINAL[kind].has(status))
|
|
69
|
+
return { kind, projectId, id };
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
return null;
|
|
73
|
+
}
|
|
74
|
+
const defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
|
|
75
|
+
class WatchManager {
|
|
76
|
+
active = new Map();
|
|
77
|
+
deps;
|
|
78
|
+
constructor(deps) {
|
|
79
|
+
this.deps = {
|
|
80
|
+
sleep: defaultSleep,
|
|
81
|
+
now: () => Date.now(),
|
|
82
|
+
onError: () => { },
|
|
83
|
+
...deps,
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
static key(t) {
|
|
87
|
+
return `${t.projectId}#${t.kind}#${t.id}`;
|
|
88
|
+
}
|
|
89
|
+
get size() {
|
|
90
|
+
return this.active.size;
|
|
91
|
+
}
|
|
92
|
+
has(target) {
|
|
93
|
+
return this.active.has(WatchManager.key(target));
|
|
94
|
+
}
|
|
95
|
+
watch(target, opts = {}) {
|
|
96
|
+
const key = WatchManager.key(target);
|
|
97
|
+
if (this.active.has(key))
|
|
98
|
+
return Promise.resolve();
|
|
99
|
+
const ctrl = new AbortController();
|
|
100
|
+
this.active.set(key, ctrl);
|
|
101
|
+
return this.run(target, opts, ctrl.signal).finally(() => {
|
|
102
|
+
this.active.delete(key);
|
|
103
|
+
});
|
|
104
|
+
}
|
|
105
|
+
cancel(target) {
|
|
106
|
+
this.active.get(WatchManager.key(target))?.abort();
|
|
107
|
+
}
|
|
108
|
+
cancelAll() {
|
|
109
|
+
for (const ctrl of this.active.values())
|
|
110
|
+
ctrl.abort();
|
|
111
|
+
this.active.clear();
|
|
112
|
+
}
|
|
113
|
+
async run(target, opts, signal) {
|
|
114
|
+
const pollMs = opts.pollMs ?? 10_000;
|
|
115
|
+
const maxDurationMs = opts.maxDurationMs ?? 3_600_000;
|
|
116
|
+
const started = this.deps.now();
|
|
117
|
+
let prev = new Map();
|
|
118
|
+
while (!signal.aborted) {
|
|
119
|
+
let jobs;
|
|
120
|
+
try {
|
|
121
|
+
jobs = await this.deps.pollJobs(target);
|
|
122
|
+
}
|
|
123
|
+
catch (error) {
|
|
124
|
+
this.deps.onError(target, error);
|
|
125
|
+
return;
|
|
126
|
+
}
|
|
127
|
+
const pipelineState = aggregateState(jobs);
|
|
128
|
+
const transitions = diffJobs(prev, jobs);
|
|
129
|
+
const terminal = isTerminal(pipelineState);
|
|
130
|
+
if (transitions.length > 0 || terminal) {
|
|
131
|
+
this.deps.emit({ target, pipelineState, jobs, transitions, terminal });
|
|
132
|
+
}
|
|
133
|
+
prev = snapshot(jobs);
|
|
134
|
+
if (terminal)
|
|
135
|
+
return;
|
|
136
|
+
if (this.deps.now() - started >= maxDurationMs)
|
|
137
|
+
return;
|
|
138
|
+
await this.deps.sleep(pollMs);
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
exports.WatchManager = WatchManager;
|
|
143
|
+
//# sourceMappingURL=watch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/channel-gateway/watch.ts"],"names":[],"mappings":"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"}
|