@apiclient.xyz/gitlab 2.0.1

package/dist_ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@apiclient.xyz/gitlab',
+    version: '2.0.1',
+    description: 'A TypeScript client for the GitLab API, providing easy access to projects, groups, CI/CD variables, and pipelines.'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx1QkFBdUI7SUFDN0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLG9IQUFvSDtDQUNsSSxDQUFBIn0=

package/dist_ts/gitlab.classes.gitlabclient.d.ts

@@ -0,0 +1,24 @@
+import type { IGitLabProject, IGitLabGroup, IGitLabVariable, IVariableOptions, IGitLabPipeline, IGitLabJob, ITestConnectionResult, IListOptions } from './gitlab.interfaces.js';
+export declare class GitLabClient {
+    private baseUrl;
+    private token;
+    constructor(baseUrl: string, token: string);
+    private request;
+    private requestText;
+    testConnection(): Promise<ITestConnectionResult>;
+    getProjects(opts?: IListOptions): Promise<IGitLabProject[]>;
+    getGroups(opts?: IListOptions): Promise<IGitLabGroup[]>;
+    getProjectVariables(projectId: number | string): Promise<IGitLabVariable[]>;
+    createProjectVariable(projectId: number | string, key: string, value: string, opts?: IVariableOptions): Promise<IGitLabVariable>;
+    updateProjectVariable(projectId: number | string, key: string, value: string, opts?: IVariableOptions): Promise<IGitLabVariable>;
+    deleteProjectVariable(projectId: number | string, key: string): Promise<void>;
+    getGroupVariables(groupId: number | string): Promise<IGitLabVariable[]>;
+    createGroupVariable(groupId: number | string, key: string, value: string, opts?: IVariableOptions): Promise<IGitLabVariable>;
+    updateGroupVariable(groupId: number | string, key: string, value: string, opts?: IVariableOptions): Promise<IGitLabVariable>;
+    deleteGroupVariable(groupId: number | string, key: string): Promise<void>;
+    getPipelines(projectId: number | string, opts?: IListOptions): Promise<IGitLabPipeline[]>;
+    getPipelineJobs(projectId: number | string, pipelineId: number): Promise<IGitLabJob[]>;
+    getJobLog(projectId: number | string, jobId: number): Promise<string>;
+    retryPipeline(projectId: number | string, pipelineId: number): Promise<void>;
+    cancelPipeline(projectId: number | string, pipelineId: number): Promise<void>;
+}

package/dist_ts/gitlab.classes.gitlabclient.js

@@ -0,0 +1,192 @@
+import * as plugins from './gitlab.plugins.js';
+import { logger } from './gitlab.logging.js';
+export class GitLabClient {
+    constructor(baseUrl, token) {
+        // Remove trailing slash if present
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.token = token;
+    }
+    // ---------------------------------------------------------------------------
+    // HTTP helpers
+    // ---------------------------------------------------------------------------
+    async request(method, path, data, customHeaders) {
+        const url = `${this.baseUrl}${path}`;
+        let builder = plugins.smartrequest.SmartRequest.create()
+            .url(url)
+            .header('PRIVATE-TOKEN', this.token)
+            .header('Content-Type', 'application/json');
+        if (customHeaders) {
+            for (const [k, v] of Object.entries(customHeaders)) {
+                builder = builder.header(k, v);
+            }
+        }
+        if (data) {
+            builder = builder.json(data);
+        }
+        let response;
+        switch (method) {
+            case 'GET':
+                response = await builder.get();
+                break;
+            case 'POST':
+                response = await builder.post();
+                break;
+            case 'PUT':
+                response = await builder.put();
+                break;
+            case 'DELETE':
+                response = await builder.delete();
+                break;
+        }
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`${method} ${path}: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        try {
+            return await response.json();
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async requestText(method, path) {
+        const url = `${this.baseUrl}${path}`;
+        let builder = plugins.smartrequest.SmartRequest.create()
+            .url(url)
+            .header('PRIVATE-TOKEN', this.token)
+            .header('Accept', 'text/plain');
+        let response;
+        switch (method) {
+            case 'GET':
+                response = await builder.get();
+                break;
+            case 'POST':
+                response = await builder.post();
+                break;
+            case 'PUT':
+                response = await builder.put();
+                break;
+            case 'DELETE':
+                response = await builder.delete();
+                break;
+        }
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`${method} ${path}: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        return response.text();
+    }
+    // ---------------------------------------------------------------------------
+    // Connection
+    // ---------------------------------------------------------------------------
+    async testConnection() {
+        try {
+            await this.request('GET', '/api/v4/user');
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Projects
+    // ---------------------------------------------------------------------------
+    async getProjects(opts) {
+        const page = opts?.page || 1;
+        const perPage = opts?.perPage || 50;
+        let url = `/api/v4/projects?membership=true&order_by=updated_at&sort=desc&page=${page}&per_page=${perPage}`;
+        if (opts?.search) {
+            url += `&search=${encodeURIComponent(opts.search)}`;
+        }
+        return this.request('GET', url);
+    }
+    // ---------------------------------------------------------------------------
+    // Groups
+    // ---------------------------------------------------------------------------
+    async getGroups(opts) {
+        const page = opts?.page || 1;
+        const perPage = opts?.perPage || 50;
+        let url = `/api/v4/groups?order_by=name&sort=asc&page=${page}&per_page=${perPage}`;
+        if (opts?.search) {
+            url += `&search=${encodeURIComponent(opts.search)}`;
+        }
+        return this.request('GET', url);
+    }
+    // ---------------------------------------------------------------------------
+    // Project Variables (CI/CD)
+    // ---------------------------------------------------------------------------
+    async getProjectVariables(projectId) {
+        return this.request('GET', `/api/v4/projects/${encodeURIComponent(projectId)}/variables`);
+    }
+    async createProjectVariable(projectId, key, value, opts) {
+        return this.request('POST', `/api/v4/projects/${encodeURIComponent(projectId)}/variables`, {
+            key,
+            value,
+            protected: opts?.protected ?? false,
+            masked: opts?.masked ?? false,
+            environment_scope: opts?.environment_scope ?? '*',
+        });
+    }
+    async updateProjectVariable(projectId, key, value, opts) {
+        const body = { value };
+        if (opts?.protected !== undefined)
+            body.protected = opts.protected;
+        if (opts?.masked !== undefined)
+            body.masked = opts.masked;
+        if (opts?.environment_scope !== undefined)
+            body.environment_scope = opts.environment_scope;
+        return this.request('PUT', `/api/v4/projects/${encodeURIComponent(projectId)}/variables/${encodeURIComponent(key)}`, body);
+    }
+    async deleteProjectVariable(projectId, key) {
+        await this.request('DELETE', `/api/v4/projects/${encodeURIComponent(projectId)}/variables/${encodeURIComponent(key)}`);
+    }
+    // ---------------------------------------------------------------------------
+    // Group Variables (CI/CD)
+    // ---------------------------------------------------------------------------
+    async getGroupVariables(groupId) {
+        return this.request('GET', `/api/v4/groups/${encodeURIComponent(groupId)}/variables`);
+    }
+    async createGroupVariable(groupId, key, value, opts) {
+        return this.request('POST', `/api/v4/groups/${encodeURIComponent(groupId)}/variables`, {
+            key,
+            value,
+            protected: opts?.protected ?? false,
+            masked: opts?.masked ?? false,
+            environment_scope: opts?.environment_scope ?? '*',
+        });
+    }
+    async updateGroupVariable(groupId, key, value, opts) {
+        const body = { value };
+        if (opts?.protected !== undefined)
+            body.protected = opts.protected;
+        if (opts?.masked !== undefined)
+            body.masked = opts.masked;
+        if (opts?.environment_scope !== undefined)
+            body.environment_scope = opts.environment_scope;
+        return this.request('PUT', `/api/v4/groups/${encodeURIComponent(groupId)}/variables/${encodeURIComponent(key)}`, body);
+    }
+    async deleteGroupVariable(groupId, key) {
+        await this.request('DELETE', `/api/v4/groups/${encodeURIComponent(groupId)}/variables/${encodeURIComponent(key)}`);
+    }
+    // ---------------------------------------------------------------------------
+    // Pipelines
+    // ---------------------------------------------------------------------------
+    async getPipelines(projectId, opts) {
+        const page = opts?.page || 1;
+        const perPage = opts?.perPage || 30;
+        return this.request('GET', `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines?page=${page}&per_page=${perPage}&order_by=updated_at&sort=desc`);
+    }
+    async getPipelineJobs(projectId, pipelineId) {
+        return this.request('GET', `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/jobs`);
+    }
+    async getJobLog(projectId, jobId) {
+        return this.requestText('GET', `/api/v4/projects/${encodeURIComponent(projectId)}/jobs/${jobId}/trace`);
+    }
+    async retryPipeline(projectId, pipelineId) {
+        await this.request('POST', `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/retry`);
+    }
+    async cancelPipeline(projectId, pipelineId) {
+        await this.request('POST', `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/cancel`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2l0bGFiLmNsYXNzZXMuZ2l0bGFiY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvZ2l0bGFiLmNsYXNzZXMuZ2l0bGFiY2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0scUJBQXFCLENBQUM7QUFDL0MsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBYTdDLE1BQU0sT0FBTyxZQUFZO0lBSXZCLFlBQVksT0FBZSxFQUFFLEtBQWE7UUFDeEMsbUNBQW1DO1FBQ25DLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLENBQUM7UUFDM0MsSUFBSSxDQUFDLEtBQUssR0FBRyxLQUFLLENBQUM7SUFDckIsQ0FBQztJQUVELDhFQUE4RTtJQUM5RSxlQUFlO0lBQ2YsOEVBQThFO0lBRXRFLEtBQUssQ0FBQyxPQUFPLENBQ25CLE1BQXlDLEVBQ3pDLElBQVksRUFDWixJQUFVLEVBQ1YsYUFBc0M7UUFFdEMsTUFBTSxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksRUFBRSxDQUFDO1FBRXJDLElBQUksT0FBTyxHQUFHLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxDQUFDLE1BQU0sRUFBRTthQUNyRCxHQUFHLENBQUMsR0FBRyxDQUFDO2FBQ1IsTUFBTSxDQUFDLGVBQWUsRUFBRSxJQUFJLENBQUMsS0FBSyxDQUFDO2FBQ25DLE1BQU0sQ0FBQyxjQUFjLEVBQUUsa0JBQWtCLENBQUMsQ0FBQztRQUU5QyxJQUFJLGFBQWEsRUFBRSxDQUFDO1lBQ2xCLEtBQUssTUFBTSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLGFBQWEsQ0FBQyxFQUFFLENBQUM7Z0JBQ25ELE9BQU8sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQztZQUNqQyxDQUFDO1FBQ0gsQ0FBQztRQUVELElBQUksSUFBSSxFQUFFLENBQUM7WUFDVCxPQUFPLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUMvQixDQUFDO1FBRUQsSUFBSSxRQUFpRCxDQUFDO1FBQ3RELFFBQVEsTUFBTSxFQUFFLENBQUM7WUFDZixLQUFLLEtBQUs7Z0JBQ1IsUUFBUSxHQUFHLE1BQU0sT0FBTyxDQUFDLEdBQUcsRUFBRSxDQUFDO2dCQUMvQixNQUFNO1lBQ1IsS0FBSyxNQUFNO2dCQUNULFFBQVEsR0FBRyxNQUFNLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQztnQkFDaEMsTUFBTTtZQUNSLEtBQUssS0FBSztnQkFDUixRQUFRLEdBQUcsTUFBTSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUM7Z0JBQy9CLE1BQU07WUFDUixLQUFLLFFBQVE7Z0JBQ1gsUUFBUSxHQUFHLE1BQU0sT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDO2dCQUNsQyxNQUFNO1FBQ1YsQ0FBQztRQUVELElBQUksQ0FBQyxRQUFRLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDakIsTUFBTSxTQUFTLEdBQUcsTUFBTSxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDeEMsTUFBTSxJQUFJLEtBQUssQ0FBQyxHQUFHLE1BQU0sSUFBSSxJQUFJLEtBQUssUUFBUSxDQUFDLE1BQU0sSUFBSSxRQUFRLENBQUMsVUFBVSxNQUFNLFNBQVMsRUFBRSxDQUFDLENBQUM7UUFDakcsQ0FBQztRQUVELElBQUksQ0FBQztZQUNILE9BQU8sTUFBTSxRQUFRLENBQUMsSUFBSSxFQUFPLENBQUM7UUFDcEMsQ0FBQztRQUFDLE1BQU0sQ0FBQztZQUNQLE9BQU8sU0FBeUIsQ0FBQztRQUNuQyxDQUFDO0lBQ0gsQ0FBQztJQUVPLEtBQUssQ0FBQyxXQUFXLENBQ3ZCLE1BQXlDLEVBQ3pDLElBQVk7UUFFWixNQUFNLEdBQUcsR0FBRyxHQUFHLElBQUksQ0FBQyxPQUFPLEdBQUcsSUFBSSxFQUFFLENBQUM7UUFFckMsSUFBSSxPQUFPLEdBQUcsT0FBTyxDQUFDLFlBQVksQ0FBQyxZQUFZLENBQUMsTUFBTSxFQUFFO2FBQ3JELEdBQUcsQ0FBQyxHQUFHLENBQUM7YUFDUixNQUFNLENBQUMsZUFBZSxFQUFFLElBQUksQ0FBQyxLQUFLLENBQUM7YUFDbkMsTUFBTSxDQUFDLFFBQVEsRUFBRSxZQUFZLENBQUMsQ0FBQztRQUVsQyxJQUFJLFFBQWlELENBQUM7UUFDdEQsUUFBUSxNQUFNLEVBQUUsQ0FBQztZQUNmLEtBQUssS0FBSztnQkFDUixRQUFRLEdBQUcsTUFBTSxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUM7Z0JBQy9CLE1BQU07WUFDUixLQUFLLE1BQU07Z0JBQ1QsUUFBUSxHQUFHLE1BQU0sT0FBTyxDQUFDLElBQUksRUFBRSxDQUFDO2dCQUNoQyxNQUFNO1lBQ1IsS0FBSyxLQUFLO2dCQUNSLFFBQVEsR0FBRyxNQUFNLE9BQU8sQ0FBQyxHQUFHLEVBQUUsQ0FBQztnQkFDL0IsTUFBTTtZQUNSLEtBQUssUUFBUTtnQkFDWCxRQUFRLEdBQUcsTUFBTSxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUM7Z0JBQ2xDLE1BQU07UUFDVixDQUFDO1FBRUQsSUFBSSxDQUFDLFFBQVEsQ0FBQyxFQUFFLEVBQUUsQ0FBQztZQUNqQixNQUFNLFNBQVMsR0FBRyxNQUFNLFFBQVEsQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUN4QyxNQUFNLElBQUksS0FBSyxDQUFDLEdBQUcsTUFBTSxJQUFJLElBQUksS0FBSyxRQUFRLENBQUMsTUFBTSxJQUFJLFFBQVEsQ0FBQyxVQUFVLE1BQU0sU0FBUyxFQUFFLENBQUMsQ0FBQztRQUNqRyxDQUFDO1FBRUQsT0FBTyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDekIsQ0FBQztJQUVELDhFQUE4RTtJQUM5RSxhQUFhO0lBQ2IsOEVBQThFO0lBRXZFLEtBQUssQ0FBQyxjQUFjO1FBQ3pCLElBQUksQ0FBQztZQUNILE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBYyxLQUFLLEVBQUUsY0FBYyxDQUFDLENBQUM7WUFDdkQsT0FBTyxFQUFFLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQztRQUN0QixDQUFDO1FBQUMsT0FBTyxHQUFHLEVBQUUsQ0FBQztZQUNiLE9BQU8sRUFBRSxFQUFFLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxHQUFHLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUNoRixDQUFDO0lBQ0gsQ0FBQztJQUVELDhFQUE4RTtJQUM5RSxXQUFXO0lBQ1gsOEVBQThFO0lBRXZFLEtBQUssQ0FBQyxXQUFXLENBQUMsSUFBbUI7UUFDMUMsTUFBTSxJQUFJLEdBQUcsSUFBSSxFQUFFLElBQUksSUFBSSxDQUFDLENBQUM7UUFDN0IsTUFBTSxPQUFPLEdBQUcsSUFBSSxFQUFFLE9BQU8sSUFBSSxFQUFFLENBQUM7UUFDcEMsSUFBSSxHQUFHLEdBQUcsdUVBQXVFLElBQUksYUFBYSxPQUFPLEVBQUUsQ0FBQztRQUM1RyxJQUFJLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztZQUNqQixHQUFHLElBQUksV0FBVyxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztRQUN0RCxDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFtQixLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDcEQsQ0FBQztJQUVELDhFQUE4RTtJQUM5RSxTQUFTO0lBQ1QsOEVBQThFO0lBRXZFLEtBQUssQ0FBQyxTQUFTLENBQUMsSUFBbUI7UUFDeEMsTUFBTSxJQUFJLEdBQUcsSUFBSSxFQUFFLElBQUksSUFBSSxDQUFDLENBQUM7UUFDN0IsTUFBTSxPQUFPLEdBQUcsSUFBSSxFQUFFLE9BQU8sSUFBSSxFQUFFLENBQUM7UUFDcEMsSUFBSSxHQUFHLEdBQUcsOENBQThDLElBQUksYUFBYSxPQUFPLEVBQUUsQ0FBQztRQUNuRixJQUFJLElBQUksRUFBRSxNQUFNLEVBQUUsQ0FBQztZQUNqQixHQUFHLElBQUksV0FBVyxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztRQUN0RCxDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFpQixLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDbEQsQ0FBQztJQUVELDhFQUE4RTtJQUM5RSw0QkFBNEI7SUFDNUIsOEVBQThFO0lBRXZFLEtBQUssQ0FBQyxtQkFBbUIsQ0FBQyxTQUEwQjtRQUN6RCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQ2pCLEtBQUssRUFDTCxvQkFBb0Isa0JBQWtCLENBQUMsU0FBUyxDQUFDLFlBQVksQ0FDOUQsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMscUJBQXFCLENBQ2hDLFNBQTBCLEVBQzFCLEdBQVcsRUFDWCxLQUFhLEVBQ2IsSUFBdUI7UUFFdkIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUNqQixNQUFNLEVBQ04sb0JBQW9CLGtCQUFrQixDQUFDLFNBQVMsQ0FBQyxZQUFZLEVBQzdEO1lBQ0UsR0FBRztZQUNILEtBQUs7WUFDTCxTQUFTLEVBQUUsSUFBSSxFQUFFLFNBQVMsSUFBSSxLQUFLO1lBQ25DLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxJQUFJLEtBQUs7WUFDN0IsaUJBQWlCLEVBQUUsSUFBSSxFQUFFLGlCQUFpQixJQUFJLEdBQUc7U0FDbEQsQ0FDRixDQUFDO0lBQ0osQ0FBQztJQUVNLEtBQUssQ0FBQyxxQkFBcUIsQ0FDaEMsU0FBMEIsRUFDMUIsR0FBVyxFQUNYLEtBQWEsRUFDYixJQUF1QjtRQUV2QixNQUFNLElBQUksR0FBUSxFQUFFLEtBQUssRUFBRSxDQUFDO1FBQzVCLElBQUksSUFBSSxFQUFFLFNBQVMsS0FBSyxTQUFTO1lBQUUsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDO1FBQ25FLElBQUksSUFBSSxFQUFFLE1BQU0sS0FBSyxTQUFTO1lBQUUsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDO1FBQzFELElBQUksSUFBSSxFQUFFLGlCQUFpQixLQUFLLFNBQVM7WUFBRSxJQUFJLENBQUMsaUJBQWlCLEdBQUcsSUFBSSxDQUFDLGlCQUFpQixDQUFDO1FBQzNGLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FDakIsS0FBSyxFQUNMLG9CQUFvQixrQkFBa0IsQ0FBQyxTQUFTLENBQUMsY0FBYyxrQkFBa0IsQ0FBQyxHQUFHLENBQUMsRUFBRSxFQUN4RixJQUFJLENBQ0wsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMscUJBQXFCLENBQUMsU0FBMEIsRUFBRSxHQUFXO1FBQ3hFLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FDaEIsUUFBUSxFQUNSLG9CQUFvQixrQkFBa0IsQ0FBQyxTQUFTLENBQUMsY0FBYyxrQkFBa0IsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUN6RixDQUFDO0lBQ0osQ0FBQztJQUVELDhFQUE4RTtJQUM5RSwwQkFBMEI7SUFDMUIsOEVBQThFO0lBRXZFLEtBQUssQ0FBQyxpQkFBaUIsQ0FBQyxPQUF3QjtRQUNyRCxPQUFPLElBQUksQ0FBQyxPQUFPLENBQ2pCLEtBQUssRUFDTCxrQkFBa0Isa0JBQWtCLENBQUMsT0FBTyxDQUFDLFlBQVksQ0FDMUQsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMsbUJBQW1CLENBQzlCLE9BQXdCLEVBQ3hCLEdBQVcsRUFDWCxLQUFhLEVBQ2IsSUFBdUI7UUFFdkIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUNqQixNQUFNLEVBQ04sa0JBQWtCLGtCQUFrQixDQUFDLE9BQU8sQ0FBQyxZQUFZLEVBQ3pEO1lBQ0UsR0FBRztZQUNILEtBQUs7WUFDTCxTQUFTLEVBQUUsSUFBSSxFQUFFLFNBQVMsSUFBSSxLQUFLO1lBQ25DLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxJQUFJLEtBQUs7WUFDN0IsaUJBQWlCLEVBQUUsSUFBSSxFQUFFLGlCQUFpQixJQUFJLEdBQUc7U0FDbEQsQ0FDRixDQUFDO0lBQ0osQ0FBQztJQUVNLEtBQUssQ0FBQyxtQkFBbUIsQ0FDOUIsT0FBd0IsRUFDeEIsR0FBVyxFQUNYLEtBQWEsRUFDYixJQUF1QjtRQUV2QixNQUFNLElBQUksR0FBUSxFQUFFLEtBQUssRUFBRSxDQUFDO1FBQzVCLElBQUksSUFBSSxFQUFFLFNBQVMsS0FBSyxTQUFTO1lBQUUsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDO1FBQ25FLElBQUksSUFBSSxFQUFFLE1BQU0sS0FBSyxTQUFTO1lBQUUsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDO1FBQzFELElBQUksSUFBSSxFQUFFLGlCQUFpQixLQUFLLFNBQVM7WUFBRSxJQUFJLENBQUMsaUJBQWlCLEdBQUcsSUFBSSxDQUFDLGlCQUFpQixDQUFDO1FBQzNGLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FDakIsS0FBSyxFQUNMLGtCQUFrQixrQkFBa0IsQ0FBQyxPQUFPLENBQUMsY0FBYyxrQkFBa0IsQ0FBQyxHQUFHLENBQUMsRUFBRSxFQUNwRixJQUFJLENBQ0wsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMsbUJBQW1CLENBQUMsT0FBd0IsRUFBRSxHQUFXO1FBQ3BFLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FDaEIsUUFBUSxFQUNSLGtCQUFrQixrQkFBa0IsQ0FBQyxPQUFPLENBQUMsY0FBYyxrQkFBa0IsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUNyRixDQUFDO0lBQ0osQ0FBQztJQUVELDhFQUE4RTtJQUM5RSxZQUFZO0lBQ1osOEVBQThFO0lBRXZFLEtBQUssQ0FBQyxZQUFZLENBQUMsU0FBMEIsRUFBRSxJQUFtQjtRQUN2RSxNQUFNLElBQUksR0FBRyxJQUFJLEVBQUUsSUFBSSxJQUFJLENBQUMsQ0FBQztRQUM3QixNQUFNLE9BQU8sR0FBRyxJQUFJLEVBQUUsT0FBTyxJQUFJLEVBQUUsQ0FBQztRQUNwQyxPQUFPLElBQUksQ0FBQyxPQUFPLENBQ2pCLEtBQUssRUFDTCxvQkFBb0Isa0JBQWtCLENBQUMsU0FBUyxDQUFDLG1CQUFtQixJQUFJLGFBQWEsT0FBTyxnQ0FBZ0MsQ0FDN0gsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMsZUFBZSxDQUFDLFNBQTBCLEVBQUUsVUFBa0I7UUFDekUsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUNqQixLQUFLLEVBQ0wsb0JBQW9CLGtCQUFrQixDQUFDLFNBQVMsQ0FBQyxjQUFjLFVBQVUsT0FBTyxDQUNqRixDQUFDO0lBQ0osQ0FBQztJQUVNLEtBQUssQ0FBQyxTQUFTLENBQUMsU0FBMEIsRUFBRSxLQUFhO1FBQzlELE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FDckIsS0FBSyxFQUNMLG9CQUFvQixrQkFBa0IsQ0FBQyxTQUFTLENBQUMsU0FBUyxLQUFLLFFBQVEsQ0FDeEUsQ0FBQztJQUNKLENBQUM7SUFFTSxLQUFLLENBQUMsYUFBYSxDQUFDLFNBQTBCLEVBQUUsVUFBa0I7UUFDdkUsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUNoQixNQUFNLEVBQ04sb0JBQW9CLGtCQUFrQixDQUFDLFNBQVMsQ0FBQyxjQUFjLFVBQVUsUUFBUSxDQUNsRixDQUFDO0lBQ0osQ0FBQztJQUVNLEtBQUssQ0FBQyxjQUFjLENBQUMsU0FBMEIsRUFBRSxVQUFrQjtRQUN4RSxNQUFNLElBQUksQ0FBQyxPQUFPLENBQ2hCLE1BQU0sRUFDTixvQkFBb0Isa0JBQWtCLENBQUMsU0FBUyxDQUFDLGNBQWMsVUFBVSxTQUFTLENBQ25GLENBQUM7SUFDSixDQUFDO0NBQ0YifQ==

package/dist_ts/gitlab.interfaces.d.ts

@@ -0,0 +1,68 @@
+export interface IGitLabUser {
+    id: number;
+    username: string;
+    name: string;
+    email: string;
+    avatar_url: string;
+    web_url: string;
+    state: string;
+}
+export interface IGitLabProject {
+    id: number;
+    name: string;
+    path_with_namespace: string;
+    description: string;
+    default_branch: string;
+    web_url: string;
+    visibility: string;
+    topics: string[];
+    last_activity_at: string;
+}
+export interface IGitLabGroup {
+    id: number;
+    name: string;
+    full_path: string;
+    description: string;
+    web_url: string;
+    visibility: string;
+}
+export interface IGitLabVariable {
+    key: string;
+    value: string;
+    variable_type: string;
+    protected: boolean;
+    masked: boolean;
+    environment_scope: string;
+}
+export interface IVariableOptions {
+    protected?: boolean;
+    masked?: boolean;
+    environment_scope?: string;
+}
+export interface IGitLabPipeline {
+    id: number;
+    project_id: number;
+    status: string;
+    ref: string;
+    sha: string;
+    web_url: string;
+    duration: number;
+    created_at: string;
+    source: string;
+}
+export interface IGitLabJob {
+    id: number;
+    name: string;
+    stage: string;
+    status: string;
+    duration: number;
+}
+export interface ITestConnectionResult {
+    ok: boolean;
+    error?: string;
+}
+export interface IListOptions {
+    search?: string;
+    page?: number;
+    perPage?: number;
+}

package/dist_ts/gitlab.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2l0bGFiLmludGVyZmFjZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9naXRsYWIuaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist_ts/gitlab.logging.d.ts

@@ -0,0 +1,2 @@
+import * as plugins from './gitlab.plugins.js';
+export declare const logger: plugins.smartlog.ConsoleLog;

package/dist_ts/gitlab.logging.js

@@ -0,0 +1,3 @@
+import * as plugins from './gitlab.plugins.js';
+export const logger = new plugins.smartlog.ConsoleLog();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2l0bGFiLmxvZ2dpbmcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9naXRsYWIubG9nZ2luZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLHFCQUFxQixDQUFDO0FBRS9DLE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxJQUFJLE9BQU8sQ0FBQyxRQUFRLENBQUMsVUFBVSxFQUFFLENBQUMifQ==

package/dist_ts/gitlab.plugins.d.ts

@@ -0,0 +1,3 @@
+import * as smartlog from '@push.rocks/smartlog';
+import * as smartrequest from '@push.rocks/smartrequest';
+export { smartlog, smartrequest };

package/dist_ts/gitlab.plugins.js

@@ -0,0 +1,4 @@
+import * as smartlog from '@push.rocks/smartlog';
+import * as smartrequest from '@push.rocks/smartrequest';
+export { smartlog, smartrequest };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2l0bGFiLnBsdWdpbnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9naXRsYWIucGx1Z2lucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssUUFBUSxNQUFNLHNCQUFzQixDQUFDO0FBQ2pELE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFFekQsT0FBTyxFQUFFLFFBQVEsRUFBRSxZQUFZLEVBQUUsQ0FBQyJ9

package/dist_ts/index.d.ts

@@ -0,0 +1,3 @@
+export { GitLabClient } from './gitlab.classes.gitlabclient.js';
+export type { IGitLabUser, IGitLabProject, IGitLabGroup, IGitLabVariable, IVariableOptions, IGitLabPipeline, IGitLabJob, ITestConnectionResult, IListOptions, } from './gitlab.interfaces.js';
+export { commitinfo } from './00_commitinfo_data.js';

package/dist_ts/index.js

@@ -0,0 +1,3 @@
+export { GitLabClient } from './gitlab.classes.gitlabclient.js';
+export { commitinfo } from './00_commitinfo_data.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFZaEUsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLHlCQUF5QixDQUFDIn0=

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lossless GmbH (https://lossless.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/npmextra.json

@@ -0,0 +1,34 @@
+{
+  "npmci": {
+    "npmGlobalTools": [],
+    "npmAccessLevel": "public"
+  },
+  "gitzone": {
+    "projectType": "npm",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "apiclient.xyz",
+      "gitrepo": "gitlab",
+      "description": "A TypeScript client for the GitLab API, providing easy access to projects, groups, CI/CD variables, and pipelines.",
+      "npmPackagename": "@apiclient.xyz/gitlab",
+      "license": "MIT",
+      "keywords": [
+        "gitlab",
+        "api client",
+        "TypeScript",
+        "CI/CD",
+        "pipelines",
+        "variables",
+        "devops"
+      ]
+    }
+  },
+  "@git.zone/cli": {
+    "release": {
+      "registries": [
+        "https://registry.npmjs.org"
+      ],
+      "accessLevel": "public"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@apiclient.xyz/gitlab",
+  "version": "2.0.1",
+  "private": false,
+  "description": "A TypeScript client for the GitLab API, providing easy access to projects, groups, CI/CD variables, and pipelines.",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "test": "(tstest test/ --verbose --timeout 600)",
+    "build": "(tsbuild --web --allowimplicitany)"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://code.foss.global/apiclient.xyz/gitlab.git"
+  },
+  "keywords": [
+    "gitlab",
+    "api client",
+    "TypeScript",
+    "CI/CD",
+    "pipelines",
+    "variables",
+    "devops"
+  ],
+  "author": "Lossless GmbH",
+  "license": "MIT",
+  "dependencies": {
+    "@push.rocks/smartlog": "^3.1.10",
+    "@push.rocks/smartrequest": "^5.0.1"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^3.1.0",
+    "@git.zone/tsrun": "^2.0.0",
+    "@git.zone/tstest": "^2.8.2",
+    "@push.rocks/qenv": "^6.1.3",
+    "@push.rocks/tapbundle": "^5.6.0",
+    "@types/node": "^22.15.3"
+  },
+  "files": [
+    "ts/**/*",
+    "ts_web/**/*",
+    "dist/**/*",
+    "dist_*/**/*",
+    "dist_ts/**/*",
+    "dist_ts_web/**/*",
+    "assets/**/*",
+    "cli.js",
+    "npmextra.json",
+    "readme.md"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ]
+}

package/readme.md

@@ -0,0 +1,30 @@
+# @apiclient.xyz/gitlab
+
+A TypeScript client for the GitLab API, providing easy access to projects, groups, CI/CD variables, and pipelines.
+
+## Install
+
+```sh
+npm install @apiclient.xyz/gitlab
+```
+
+## Usage
+
+```typescript
+import { GitLabClient } from '@apiclient.xyz/gitlab';
+
+const client = new GitLabClient('https://gitlab.com', 'your-private-token');
+
+// Test connection
+const result = await client.testConnection();
+
+// List projects
+const projects = await client.getProjects();
+
+// Manage CI/CD variables
+await client.createProjectVariable(123, 'SECRET_KEY', 'secret-value');
+```
+
+## License
+
+MIT

package/ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@apiclient.xyz/gitlab',
+  version: '2.0.1',
+  description: 'A TypeScript client for the GitLab API, providing easy access to projects, groups, CI/CD variables, and pipelines.'
+}

package/ts/gitlab.classes.gitlabclient.ts

@@ -0,0 +1,304 @@
+import * as plugins from './gitlab.plugins.js';
+import { logger } from './gitlab.logging.js';
+import type {
+  IGitLabUser,
+  IGitLabProject,
+  IGitLabGroup,
+  IGitLabVariable,
+  IVariableOptions,
+  IGitLabPipeline,
+  IGitLabJob,
+  ITestConnectionResult,
+  IListOptions,
+} from './gitlab.interfaces.js';
+
+export class GitLabClient {
+  private baseUrl: string;
+  private token: string;
+
+  constructor(baseUrl: string, token: string) {
+    // Remove trailing slash if present
+    this.baseUrl = baseUrl.replace(/\/+$/, '');
+    this.token = token;
+  }
+
+  // ---------------------------------------------------------------------------
+  // HTTP helpers
+  // ---------------------------------------------------------------------------
+
+  private async request<T = any>(
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE',
+    path: string,
+    data?: any,
+    customHeaders?: Record<string, string>,
+  ): Promise<T> {
+    const url = `${this.baseUrl}${path}`;
+
+    let builder = plugins.smartrequest.SmartRequest.create()
+      .url(url)
+      .header('PRIVATE-TOKEN', this.token)
+      .header('Content-Type', 'application/json');
+
+    if (customHeaders) {
+      for (const [k, v] of Object.entries(customHeaders)) {
+        builder = builder.header(k, v);
+      }
+    }
+
+    if (data) {
+      builder = builder.json(data);
+    }
+
+    let response: Awaited<ReturnType<typeof builder.get>>;
+    switch (method) {
+      case 'GET':
+        response = await builder.get();
+        break;
+      case 'POST':
+        response = await builder.post();
+        break;
+      case 'PUT':
+        response = await builder.put();
+        break;
+      case 'DELETE':
+        response = await builder.delete();
+        break;
+    }
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`${method} ${path}: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+
+    try {
+      return await response.json() as T;
+    } catch {
+      return undefined as unknown as T;
+    }
+  }
+
+  private async requestText(
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE',
+    path: string,
+  ): Promise<string> {
+    const url = `${this.baseUrl}${path}`;
+
+    let builder = plugins.smartrequest.SmartRequest.create()
+      .url(url)
+      .header('PRIVATE-TOKEN', this.token)
+      .header('Accept', 'text/plain');
+
+    let response: Awaited<ReturnType<typeof builder.get>>;
+    switch (method) {
+      case 'GET':
+        response = await builder.get();
+        break;
+      case 'POST':
+        response = await builder.post();
+        break;
+      case 'PUT':
+        response = await builder.put();
+        break;
+      case 'DELETE':
+        response = await builder.delete();
+        break;
+    }
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`${method} ${path}: ${response.status} ${response.statusText} - ${errorText}`);
+    }
+
+    return response.text();
+  }
+
+  // ---------------------------------------------------------------------------
+  // Connection
+  // ---------------------------------------------------------------------------
+
+  public async testConnection(): Promise<ITestConnectionResult> {
+    try {
+      await this.request<IGitLabUser>('GET', '/api/v4/user');
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+  }
+
+  // ---------------------------------------------------------------------------
+  // Projects
+  // ---------------------------------------------------------------------------
+
+  public async getProjects(opts?: IListOptions): Promise<IGitLabProject[]> {
+    const page = opts?.page || 1;
+    const perPage = opts?.perPage || 50;
+    let url = `/api/v4/projects?membership=true&order_by=updated_at&sort=desc&page=${page}&per_page=${perPage}`;
+    if (opts?.search) {
+      url += `&search=${encodeURIComponent(opts.search)}`;
+    }
+    return this.request<IGitLabProject[]>('GET', url);
+  }
+
+  // ---------------------------------------------------------------------------
+  // Groups
+  // ---------------------------------------------------------------------------
+
+  public async getGroups(opts?: IListOptions): Promise<IGitLabGroup[]> {
+    const page = opts?.page || 1;
+    const perPage = opts?.perPage || 50;
+    let url = `/api/v4/groups?order_by=name&sort=asc&page=${page}&per_page=${perPage}`;
+    if (opts?.search) {
+      url += `&search=${encodeURIComponent(opts.search)}`;
+    }
+    return this.request<IGitLabGroup[]>('GET', url);
+  }
+
+  // ---------------------------------------------------------------------------
+  // Project Variables (CI/CD)
+  // ---------------------------------------------------------------------------
+
+  public async getProjectVariables(projectId: number | string): Promise<IGitLabVariable[]> {
+    return this.request<IGitLabVariable[]>(
+      'GET',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/variables`,
+    );
+  }
+
+  public async createProjectVariable(
+    projectId: number | string,
+    key: string,
+    value: string,
+    opts?: IVariableOptions,
+  ): Promise<IGitLabVariable> {
+    return this.request<IGitLabVariable>(
+      'POST',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/variables`,
+      {
+        key,
+        value,
+        protected: opts?.protected ?? false,
+        masked: opts?.masked ?? false,
+        environment_scope: opts?.environment_scope ?? '*',
+      },
+    );
+  }
+
+  public async updateProjectVariable(
+    projectId: number | string,
+    key: string,
+    value: string,
+    opts?: IVariableOptions,
+  ): Promise<IGitLabVariable> {
+    const body: any = { value };
+    if (opts?.protected !== undefined) body.protected = opts.protected;
+    if (opts?.masked !== undefined) body.masked = opts.masked;
+    if (opts?.environment_scope !== undefined) body.environment_scope = opts.environment_scope;
+    return this.request<IGitLabVariable>(
+      'PUT',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/variables/${encodeURIComponent(key)}`,
+      body,
+    );
+  }
+
+  public async deleteProjectVariable(projectId: number | string, key: string): Promise<void> {
+    await this.request(
+      'DELETE',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/variables/${encodeURIComponent(key)}`,
+    );
+  }
+
+  // ---------------------------------------------------------------------------
+  // Group Variables (CI/CD)
+  // ---------------------------------------------------------------------------
+
+  public async getGroupVariables(groupId: number | string): Promise<IGitLabVariable[]> {
+    return this.request<IGitLabVariable[]>(
+      'GET',
+      `/api/v4/groups/${encodeURIComponent(groupId)}/variables`,
+    );
+  }
+
+  public async createGroupVariable(
+    groupId: number | string,
+    key: string,
+    value: string,
+    opts?: IVariableOptions,
+  ): Promise<IGitLabVariable> {
+    return this.request<IGitLabVariable>(
+      'POST',
+      `/api/v4/groups/${encodeURIComponent(groupId)}/variables`,
+      {
+        key,
+        value,
+        protected: opts?.protected ?? false,
+        masked: opts?.masked ?? false,
+        environment_scope: opts?.environment_scope ?? '*',
+      },
+    );
+  }
+
+  public async updateGroupVariable(
+    groupId: number | string,
+    key: string,
+    value: string,
+    opts?: IVariableOptions,
+  ): Promise<IGitLabVariable> {
+    const body: any = { value };
+    if (opts?.protected !== undefined) body.protected = opts.protected;
+    if (opts?.masked !== undefined) body.masked = opts.masked;
+    if (opts?.environment_scope !== undefined) body.environment_scope = opts.environment_scope;
+    return this.request<IGitLabVariable>(
+      'PUT',
+      `/api/v4/groups/${encodeURIComponent(groupId)}/variables/${encodeURIComponent(key)}`,
+      body,
+    );
+  }
+
+  public async deleteGroupVariable(groupId: number | string, key: string): Promise<void> {
+    await this.request(
+      'DELETE',
+      `/api/v4/groups/${encodeURIComponent(groupId)}/variables/${encodeURIComponent(key)}`,
+    );
+  }
+
+  // ---------------------------------------------------------------------------
+  // Pipelines
+  // ---------------------------------------------------------------------------
+
+  public async getPipelines(projectId: number | string, opts?: IListOptions): Promise<IGitLabPipeline[]> {
+    const page = opts?.page || 1;
+    const perPage = opts?.perPage || 30;
+    return this.request<IGitLabPipeline[]>(
+      'GET',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines?page=${page}&per_page=${perPage}&order_by=updated_at&sort=desc`,
+    );
+  }
+
+  public async getPipelineJobs(projectId: number | string, pipelineId: number): Promise<IGitLabJob[]> {
+    return this.request<IGitLabJob[]>(
+      'GET',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/jobs`,
+    );
+  }
+
+  public async getJobLog(projectId: number | string, jobId: number): Promise<string> {
+    return this.requestText(
+      'GET',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/jobs/${jobId}/trace`,
+    );
+  }
+
+  public async retryPipeline(projectId: number | string, pipelineId: number): Promise<void> {
+    await this.request(
+      'POST',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/retry`,
+    );
+  }
+
+  public async cancelPipeline(projectId: number | string, pipelineId: number): Promise<void> {
+    await this.request(
+      'POST',
+      `/api/v4/projects/${encodeURIComponent(projectId)}/pipelines/${pipelineId}/cancel`,
+    );
+  }
+}

package/ts/gitlab.interfaces.ts

@@ -0,0 +1,76 @@
+export interface IGitLabUser {
+  id: number;
+  username: string;
+  name: string;
+  email: string;
+  avatar_url: string;
+  web_url: string;
+  state: string;
+}
+
+export interface IGitLabProject {
+  id: number;
+  name: string;
+  path_with_namespace: string;
+  description: string;
+  default_branch: string;
+  web_url: string;
+  visibility: string;
+  topics: string[];
+  last_activity_at: string;
+}
+
+export interface IGitLabGroup {
+  id: number;
+  name: string;
+  full_path: string;
+  description: string;
+  web_url: string;
+  visibility: string;
+}
+
+export interface IGitLabVariable {
+  key: string;
+  value: string;
+  variable_type: string;
+  protected: boolean;
+  masked: boolean;
+  environment_scope: string;
+}
+
+export interface IVariableOptions {
+  protected?: boolean;
+  masked?: boolean;
+  environment_scope?: string;
+}
+
+export interface IGitLabPipeline {
+  id: number;
+  project_id: number;
+  status: string;
+  ref: string;
+  sha: string;
+  web_url: string;
+  duration: number;
+  created_at: string;
+  source: string;
+}
+
+export interface IGitLabJob {
+  id: number;
+  name: string;
+  stage: string;
+  status: string;
+  duration: number;
+}
+
+export interface ITestConnectionResult {
+  ok: boolean;
+  error?: string;
+}
+
+export interface IListOptions {
+  search?: string;
+  page?: number;
+  perPage?: number;
+}

package/ts/gitlab.logging.ts

@@ -0,0 +1,3 @@
+import * as plugins from './gitlab.plugins.js';
+
+export const logger = new plugins.smartlog.ConsoleLog();

package/ts/gitlab.plugins.ts

@@ -0,0 +1,4 @@
+import * as smartlog from '@push.rocks/smartlog';
+import * as smartrequest from '@push.rocks/smartrequest';
+
+export { smartlog, smartrequest };

package/ts/index.ts

@@ -0,0 +1,13 @@
+export { GitLabClient } from './gitlab.classes.gitlabclient.js';
+export type {
+  IGitLabUser,
+  IGitLabProject,
+  IGitLabGroup,
+  IGitLabVariable,
+  IVariableOptions,
+  IGitLabPipeline,
+  IGitLabJob,
+  ITestConnectionResult,
+  IListOptions,
+} from './gitlab.interfaces.js';
+export { commitinfo } from './00_commitinfo_data.js';