@ticatec/omniflow-gitlab 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ticatec
+
+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/README.md

@@ -0,0 +1,94 @@
+# @ticatec/omniflow-gitlab
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org/)
+
+[中文文档](./README_CN.md)
+
+All-in-one GitLab artifact provider for OmniFlow. Provides full-stack artifact publishing (Docker/OCI, NPM, Maven, and Generic archive packages) under a single unified credential model.
+
+---
+
+## Features
+
+- **Container Registry**: Push Docker/OCI container images directly to GitLab's built-in Container Registry (`GitLabContainerPublisher`).
+- **NPM Package Registry**: Publish scoped npm packages to GitLab Package Registry (`GitLabNpmPublisher`).
+- **Maven Package Registry**: Publish Java JAR and POM packages via direct HTTP PUT or Maven deploy (`GitLabMavenPublisher`).
+- **Generic Package Registry**: Publish frontend distribution archives, binaries, or release assets (`GitLabGenericPublisher`). Also implements `download()`, which `deploy.web` uses to fetch an archive by name and version.
+- **Unified Client & Credentials**: Same Personal Access Token (PAT), Project Deploy Token, or CI Job Token powers all package registries.
+
+---
+
+## How to Register
+
+### 1. One-Click Registration (Recommended)
+
+```typescript
+import { defaultArtifactPublisherRegistry } from '@ticatec/omniflow-artifact'
+import { registerGitLab } from '@ticatec/omniflow-gitlab'
+
+// Register all GitLab drivers (Container + NPM + Maven + Generic)
+registerGitLab({
+  artifactRegistry: defaultArtifactPublisherRegistry
+})
+```
+
+### 2. Granular Registration
+
+```typescript
+import { registerArtifactPublisher } from '@ticatec/omniflow-artifact'
+import {
+  GitLabContainerPublisher,
+  GitLabNpmPublisher,
+  GitLabMavenPublisher,
+  GitLabGenericPublisher
+} from '@ticatec/omniflow-gitlab'
+
+registerArtifactPublisher(new GitLabContainerPublisher())
+registerArtifactPublisher(new GitLabNpmPublisher())
+registerArtifactPublisher(new GitLabMavenPublisher())
+registerArtifactPublisher(new GitLabGenericPublisher())
+```
+
+---
+
+## Configuration Example (`omniflow.yaml`)
+
+```yaml
+omniflow:
+  registries:
+    # 1. GitLab Container Registry
+    docker:
+      gitlab:
+        server: registry.gitlab.com
+        namespace: my-group/my-project
+        username: deploy-token-user
+        password: ${GITLAB_DEPLOY_TOKEN}
+
+    # 2. GitLab NPM Registry
+    npm:
+      gitlab:
+        server: https://gitlab.com
+        namespace: my-group/my-project
+        token: ${GITLAB_TOKEN}
+
+    # 3. GitLab Maven Registry
+    maven:
+      gitlab:
+        server: https://gitlab.com
+        namespace: my-group/my-project
+        token: ${GITLAB_TOKEN}
+
+    # 4. GitLab Generic Packages Registry
+    generic:
+      gitlab:
+        server: https://gitlab.com
+        namespace: my-group/my-project
+        token: ${GITLAB_TOKEN}
+```
+
+---
+
+## License
+
+MIT License.

package/README_CN.md

@@ -0,0 +1,95 @@
+# @ticatec/omniflow-gitlab
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org/)
+
+[English Documentation](./README.md)
+
+OmniFlow 的 GitLab 一体化制品库驱动插件。在统一凭证（Personal Access Token / Project Deploy Token / CI Job Token）体系下，提供全栈制品发布能力（Docker/OCI 镜像、NPM、Maven、Generic 通用归档包）。
+
+---
+
+## 特性
+
+- **容器镜像仓库 (Container Registry)**：将 Docker/OCI 镜像推送到 GitLab 内置容器镜像仓库 (`GitLabContainerPublisher`)。
+- **NPM 制品库 (NPM Registry)**：自动生成 `.npmrc` 并发布 scoped npm 包到 GitLab Package Registry (`GitLabNpmPublisher`)。
+- **Maven 制品库 (Maven Registry)**：直接通过 HTTP PUT 或 Maven 构建将 Java JAR 和 POM 包发布到 GitLab (`GitLabMavenPublisher`)。
+- **Generic 通用包发布 (Generic Packages)**：发布前端构建产物压缩包、二进制文件或 Release 归档文件 (`GitLabGenericPublisher`)；同时实现 `download()`，`deploy.web` 用它按名称和版本取回归档。
+- **统一客户端与凭证体系**：同一套 Personal Access Token (PAT)、Deploy Token 或 CI Job Token 即可覆盖全品类制品库。
+
+---
+
+## 如何注册
+
+### 1. 一键全量注册（推荐）
+
+```typescript
+import { defaultArtifactPublisherRegistry } from '@ticatec/omniflow-artifact'
+import { registerGitLab } from '@ticatec/omniflow-gitlab'
+
+// 注册所有 GitLab 驱动（容器镜像 + NPM + Maven + 通用包）
+registerGitLab({
+  artifactRegistry: defaultArtifactPublisherRegistry
+})
+```
+
+### 2. 按需单项注册
+
+```typescript
+import { registerArtifactPublisher } from '@ticatec/omniflow-artifact'
+import {
+  GitLabContainerPublisher,
+  GitLabNpmPublisher,
+  GitLabMavenPublisher,
+  GitLabGenericPublisher
+} from '@ticatec/omniflow-gitlab'
+
+// 仅注册需要的制品发布器
+registerArtifactPublisher(new GitLabContainerPublisher())
+registerArtifactPublisher(new GitLabNpmPublisher())
+registerArtifactPublisher(new GitLabMavenPublisher())
+registerArtifactPublisher(new GitLabGenericPublisher())
+```
+
+---
+
+## 配置示例 (`omniflow.yaml`)
+
+```yaml
+omniflow:
+  registries:
+    # 1. GitLab 容器镜像仓库
+    docker:
+      gitlab:
+        server: registry.gitlab.com
+        namespace: my-group/my-project
+        username: deploy-token-user
+        password: ${GITLAB_DEPLOY_TOKEN}
+
+    # 2. GitLab NPM 制品库
+    npm:
+      gitlab:
+        server: https://gitlab.com
+        namespace: my-group/my-project
+        token: ${GITLAB_TOKEN}
+
+    # 3. GitLab Maven 制品库
+    maven:
+      gitlab:
+        server: https://gitlab.com
+        namespace: my-group/my-project
+        token: ${GITLAB_TOKEN}
+
+    # 4. GitLab Generic 通用制品包
+    generic:
+      gitlab:
+        server: https://gitlab.com
+        namespace: my-group/my-project
+        token: ${GITLAB_TOKEN}
+```
+
+---
+
+## 许可证
+
+MIT License.

package/dist/artifacts/GitLabContainerPublisher.d.ts

@@ -0,0 +1,17 @@
+import { BaseDockerPublisher } from '@ticatec/omniflow-artifact';
+import type { RegistryConfig } from '@ticatec/omniflow-artifact';
+/**
+ * GitLab Container Registry Publisher.
+ *
+ * Supports both gitlab.com Container Registry (registry.gitlab.com)
+ * and self-hosted GitLab container registries.
+ */
+export declare class GitLabContainerPublisher extends BaseDockerPublisher {
+    readonly id = "gitlab-container";
+    readonly name = "GitLab Container Registry";
+    readonly platform = "gitlab";
+    readonly priority = 20;
+    detect(registry: RegistryConfig): boolean;
+    buildRepositoryUrl(registry: RegistryConfig, imageName: string): string;
+}
+//# sourceMappingURL=GitLabContainerPublisher.d.ts.map

package/dist/artifacts/GitLabContainerPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitLabContainerPublisher.d.ts","sourceRoot":"","sources":["../../src/artifacts/GitLabContainerPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAGhE;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB;IAC/D,QAAQ,CAAC,EAAE,sBAAqB;IAChC,QAAQ,CAAC,IAAI,+BAA8B;IAC3C,QAAQ,CAAC,QAAQ,YAAW;IAC5B,SAAkB,QAAQ,MAAK;IAEtB,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAmBzC,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAcjF"}

package/dist/artifacts/GitLabContainerPublisher.js

@@ -0,0 +1,44 @@
+import { BaseDockerPublisher } from '@ticatec/omniflow-artifact';
+import { isGitLabHost } from '../client/GitLabClient.js';
+/**
+ * GitLab Container Registry Publisher.
+ *
+ * Supports both gitlab.com Container Registry (registry.gitlab.com)
+ * and self-hosted GitLab container registries.
+ */
+export class GitLabContainerPublisher extends BaseDockerPublisher {
+    id = 'gitlab-container';
+    name = 'GitLab Container Registry';
+    platform = 'gitlab';
+    priority = 20;
+    detect(registry) {
+        if (registry.type !== 'docker' && registry.type !== 'container') {
+            return false;
+        }
+        const regName = (registry.name || '').toLowerCase();
+        if (regName === 'gitlab' || regName.startsWith('gitlab-')) {
+            return true;
+        }
+        const server = (registry.server || '').toLowerCase();
+        try {
+            const parsed = new URL(server.includes('://') ? server : `https://${server}`);
+            return isGitLabHost(parsed.hostname);
+        }
+        catch {
+            return false;
+        }
+    }
+    buildRepositoryUrl(registry, imageName) {
+        const host = this.normalizeServerHost(registry.server);
+        const cleanImage = imageName.replace(/^\/+/, '');
+        const ns = (registry.namespace || '').replace(/\/+$/, '');
+        if (ns) {
+            if (cleanImage.startsWith(`${ns}/`)) {
+                return `${host}/${cleanImage}`;
+            }
+            return `${host}/${ns}/${cleanImage}`;
+        }
+        return `${host}/${cleanImage}`;
+    }
+}
+//# sourceMappingURL=GitLabContainerPublisher.js.map

package/dist/artifacts/GitLabContainerPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitLabContainerPublisher.js","sourceRoot":"","sources":["../../src/artifacts/GitLabContainerPublisher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,mBAAmB;IACtD,EAAE,GAAG,kBAAkB,CAAA;IACvB,IAAI,GAAG,2BAA2B,CAAA;IAClC,QAAQ,GAAG,QAAQ,CAAA;IACV,QAAQ,GAAG,EAAE,CAAA;IAEtB,MAAM,CAAC,QAAwB;QACtC,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChE,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QACnD,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,CAAA;YAC7E,OAAO,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAEQ,kBAAkB,CAAC,QAAwB,EAAE,SAAiB;QACrE,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;QACtD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAEhD,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACzD,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,GAAG,IAAI,IAAI,UAAU,EAAE,CAAA;YAChC,CAAC;YACD,OAAO,GAAG,IAAI,IAAI,EAAE,IAAI,UAAU,EAAE,CAAA;QACtC,CAAC;QAED,OAAO,GAAG,IAAI,IAAI,UAAU,EAAE,CAAA;IAChC,CAAC;CACF"}

package/dist/artifacts/GitLabGenericPublisher.d.ts

@@ -0,0 +1,27 @@
+import { BasePublisher } from '@ticatec/omniflow-artifact';
+import type { ArtifactPayload, DownloadOptions, DownloadResult, PublishOptions, RegistryConfig } from '@ticatec/omniflow-artifact';
+/**
+ * GitLab Generic Package Registry Publisher.
+ *
+ * Publishes arbitrary binary artifacts, tarballs (tar.gz), or zip files
+ * to GitLab's built-in Generic package registry.
+ * Endpoint format: PUT https://<gitlab_host>/api/v4/projects/<projectId>/packages/generic/<packageName>/<version>/<filename>
+ */
+export declare class GitLabGenericPublisher extends BasePublisher {
+    readonly id = "gitlab-generic";
+    readonly name = "GitLab Generic Package Registry";
+    readonly platform = "gitlab";
+    readonly artifactType = "generic";
+    readonly priority = 20;
+    detect(registry: RegistryConfig): boolean;
+    buildTargetRef(artifact: ArtifactPayload, _registry: RegistryConfig): string;
+    exists(artifact: ArtifactPayload, registry: RegistryConfig): Promise<boolean>;
+    download(artifact: ArtifactPayload, registry: RegistryConfig, dest: string, options?: DownloadOptions): Promise<DownloadResult>;
+    login(registry: RegistryConfig, _options?: PublishOptions): Promise<void>;
+    protected doPublish(artifact: ArtifactPayload, registry: RegistryConfig, options?: PublishOptions): Promise<{
+        ref: string;
+        digest?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=GitLabGenericPublisher.d.ts.map

package/dist/artifacts/GitLabGenericPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitLabGenericPublisher.d.ts","sourceRoot":"","sources":["../../src/artifacts/GitLabGenericPublisher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAGlI;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,EAAE,oBAAmB;IAC9B,QAAQ,CAAC,IAAI,qCAAoC;IACjD,QAAQ,CAAC,QAAQ,YAAW;IAC5B,QAAQ,CAAC,YAAY,aAAY;IACjC,SAAkB,QAAQ,MAAK;IAEtB,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAmBzC,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM;IAMtE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA8C7E,QAAQ,CACrB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC;IAiCpB,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;cAO/D,SAAS,CACvB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QACT,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,CAAC;CA2EH"}

package/dist/artifacts/GitLabGenericPublisher.js

@@ -0,0 +1,176 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+import { BasePublisher } from '@ticatec/omniflow-artifact';
+import { GitLabClient, isGitLabHost } from '../client/GitLabClient.js';
+/**
+ * GitLab Generic Package Registry Publisher.
+ *
+ * Publishes arbitrary binary artifacts, tarballs (tar.gz), or zip files
+ * to GitLab's built-in Generic package registry.
+ * Endpoint format: PUT https://<gitlab_host>/api/v4/projects/<projectId>/packages/generic/<packageName>/<version>/<filename>
+ */
+export class GitLabGenericPublisher extends BasePublisher {
+    id = 'gitlab-generic';
+    name = 'GitLab Generic Package Registry';
+    platform = 'gitlab';
+    artifactType = 'generic';
+    priority = 20;
+    detect(registry) {
+        if (registry.type !== 'generic' && registry.type !== 'archive') {
+            return false;
+        }
+        const regName = (registry.name || '').toLowerCase();
+        if (regName === 'gitlab' || regName.startsWith('gitlab-')) {
+            return true;
+        }
+        const server = (registry.server || '').toLowerCase();
+        try {
+            const parsed = new URL(server.includes('://') ? server : `https://${server}`);
+            return isGitLabHost(parsed.hostname);
+        }
+        catch {
+            return false;
+        }
+    }
+    buildTargetRef(artifact, _registry) {
+        const version = artifact.tags && artifact.tags.length > 0 ? artifact.tags[0] : 'latest';
+        const filename = path.basename(artifact.source);
+        return `${artifact.name}/${version}/${filename}`;
+    }
+    async exists(artifact, registry) {
+        const creds = this.resolveCredentials(registry);
+        const token = creds.token || creds.password;
+        const reg = registry;
+        const projectId = reg.namespace?.trim() ||
+            reg.options?.projectId?.trim() ||
+            reg.metadata?.projectId?.trim();
+        if (!projectId)
+            return false;
+        const client = new GitLabClient({
+            baseUrl: registry.server,
+            token,
+            username: creds.username,
+            password: creds.password
+        });
+        const version = artifact.tags && artifact.tags.length > 0 ? artifact.tags[0] : 'latest';
+        const packageName = artifact.name;
+        const filename = path.basename(artifact.source);
+        const baseUrl = client.getPackageApiUrl(projectId, 'generic');
+        const cleanBaseUrl = baseUrl.replace(/\/+$/, '');
+        const targetUrl = `${cleanBaseUrl}/${encodeURIComponent(packageName)}/${encodeURIComponent(version)}/${encodeURIComponent(filename)}`;
+        try {
+            const res = await client.request(targetUrl, { method: 'HEAD' });
+            if (res.ok || res.status === 200 || res.status === 204) {
+                return true;
+            }
+            if (res.status === 404) {
+                return false;
+            }
+            const errText = await client.extractErrorMessage(res);
+            throw new Error(`Failed to check artifact existence in GitLab Generic registry (${res.status}): ${errText}`);
+        }
+        catch (err) {
+            if (err?.message?.includes('Failed to check artifact existence in GitLab')) {
+                throw err;
+            }
+            throw new Error(`Failed to check artifact existence in GitLab Generic registry: ${client.maskSecrets(err?.message || String(err))}`);
+        }
+    }
+    async download(artifact, registry, dest, options) {
+        const creds = this.resolveCredentials(registry);
+        const reg = registry;
+        const projectId = reg.namespace?.trim() ||
+            reg.options?.projectId?.trim() ||
+            reg.metadata?.projectId?.trim();
+        if (!projectId) {
+            throw new Error(`GitLab Generic registry requires a valid project ID (specify via registry.namespace)`);
+        }
+        const client = new GitLabClient({
+            baseUrl: registry.server,
+            token: creds.token || creds.password,
+            username: creds.username,
+            password: creds.password,
+            timeoutMs: options?.timeoutMs
+        });
+        const version = artifact.tags?.[0] || 'latest';
+        const filename = path.basename(artifact.source);
+        const baseUrl = client.getPackageApiUrl(projectId, 'generic').replace(/\/+$/, '');
+        const targetUrl = `${baseUrl}/${encodeURIComponent(artifact.name)}/${encodeURIComponent(version)}/${encodeURIComponent(filename)}`;
+        const masked = client.maskSecrets(targetUrl);
+        this.log(`  📥 Downloading ${artifact.name} ${version} from GitLab: ${masked}`);
+        const res = await client.request(targetUrl, { method: 'GET' });
+        if (!res.ok) {
+            throw await this.downloadError(res, `${artifact.name} ${version} (${filename})`, masked);
+        }
+        return this.saveResponse(res, dest, masked);
+    }
+    async login(registry, _options) {
+        const creds = this.resolveCredentials(registry);
+        if (!creds.token && !creds.password) {
+            this.log(`  ℹ No auth token configured for GitLab Generic registry ${registry.server}`);
+        }
+    }
+    async doPublish(artifact, registry, options) {
+        const creds = this.resolveCredentials(registry);
+        const token = creds.token || creds.password;
+        const reg = registry;
+        const projectId = reg.namespace?.trim() ||
+            reg.options?.projectId?.trim() ||
+            reg.metadata?.projectId?.trim();
+        if (!projectId) {
+            throw new Error(`GitLab Generic registry requires a valid project ID (specify via registry.namespace)`);
+        }
+        const client = new GitLabClient({
+            baseUrl: registry.server,
+            token,
+            username: creds.username,
+            password: creds.password
+        });
+        const version = artifact.tags && artifact.tags.length > 0 ? artifact.tags[0] : 'latest';
+        const packageName = artifact.name;
+        let filePath = artifact.source;
+        const stat = await fs.stat(filePath).catch(() => null);
+        if (!stat || !stat.isFile()) {
+            throw new Error(`Generic artifact source must be an existing file: ${filePath}`);
+        }
+        const filename = path.basename(filePath);
+        const fileBuffer = await fs.readFile(filePath);
+        const digest = `sha256:${crypto.createHash('sha256').update(fileBuffer).digest('hex')}`;
+        const baseUrl = client.getPackageApiUrl(projectId, 'generic');
+        const cleanBaseUrl = baseUrl.replace(/\/+$/, '');
+        const targetUrl = `${cleanBaseUrl}/${encodeURIComponent(packageName)}/${encodeURIComponent(version)}/${encodeURIComponent(filename)}`;
+        this.log(`  📤 Uploading Generic package file to GitLab: ${targetUrl}`);
+        if (options?.dryRun) {
+            this.log(`  [dryRun] Would PUT ${filename} (${fileBuffer.length} bytes) to ${targetUrl}`);
+            return {
+                ref: `${packageName}/${version}/${filename}`,
+                digest,
+                metadata: { targetUrl, size: fileBuffer.length }
+            };
+        }
+        const res = await client.request(targetUrl, {
+            method: 'PUT',
+            headers: {
+                'Content-Type': 'application/octet-stream'
+            },
+            body: fileBuffer
+        });
+        if (!res.ok && res.status !== 201 && res.status !== 200) {
+            const errText = await client.extractErrorMessage(res);
+            throw new Error(`Failed to upload generic package to GitLab (${res.status}): ${errText}`);
+        }
+        return {
+            ref: `${packageName}/${version}/${filename}`,
+            digest,
+            metadata: {
+                packageName,
+                version,
+                filename,
+                targetUrl,
+                size: fileBuffer.length
+            }
+        };
+    }
+}
+//# sourceMappingURL=GitLabGenericPublisher.js.map

package/dist/artifacts/GitLabGenericPublisher.js.map

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

package/dist/artifacts/GitLabMavenPublisher.d.ts

@@ -0,0 +1,24 @@
+import { BasePublisher } from '@ticatec/omniflow-artifact';
+import type { ArtifactPayload, PublishOptions, RegistryConfig } from '@ticatec/omniflow-artifact';
+/**
+ * GitLab Maven Package Registry Publisher.
+ *
+ * Endpoint format: PUT https://<gitlab_host>/api/v4/projects/<projectId>/packages/maven/{groupId}/{artifactId}/{version}/{filename}
+ */
+export declare class GitLabMavenPublisher extends BasePublisher {
+    readonly id = "gitlab-maven";
+    readonly name = "GitLab Maven Repository";
+    readonly platform = "gitlab";
+    readonly artifactType = "maven";
+    readonly priority = 20;
+    detect(registry: RegistryConfig): boolean;
+    buildTargetRef(artifact: ArtifactPayload, _registry: RegistryConfig): string;
+    exists(artifact: ArtifactPayload, registry: RegistryConfig): Promise<boolean>;
+    login(registry: RegistryConfig, _options?: PublishOptions): Promise<void>;
+    protected doPublish(artifact: ArtifactPayload, registry: RegistryConfig, options?: PublishOptions): Promise<{
+        ref: string;
+        digest?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=GitLabMavenPublisher.d.ts.map

package/dist/artifacts/GitLabMavenPublisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitLabMavenPublisher.d.ts","sourceRoot":"","sources":["../../src/artifacts/GitLabMavenPublisher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAuE,MAAM,4BAA4B,CAAA;AAC/H,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAGjG;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,QAAQ,CAAC,EAAE,kBAAiB;IAC5B,QAAQ,CAAC,IAAI,6BAA4B;IACzC,QAAQ,CAAC,QAAQ,YAAW;IAC5B,QAAQ,CAAC,YAAY,WAAU;IAC/B,SAAkB,QAAQ,MAAK;IAEtB,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;IAmBzC,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,GAAG,MAAM;IAOtE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAwDtF,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;cAO/D,SAAS,CACvB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QACT,GAAG,EAAE,MAAM,CAAA;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,CAAC;CA2GH"}