@ticatec/omniflow-github 1.0.0

package/dist/artifacts/GitHubReleasePublisher.js

@@ -0,0 +1,192 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+import { BasePublisher } from '@ticatec/omniflow-artifact';
+import { GitHubClient } from '../client/GitHubClient.js';
+/**
+ * GitHub Releases (Generic Artifact / Asset) Publisher.
+ *
+ * Publishes arbitrary binary artifacts, distribution tarballs (.tar.gz),
+ * or zip files to GitHub Releases under the specified version tag.
+ */
+export class GitHubReleasePublisher extends BasePublisher {
+    id = 'github-release';
+    name = 'GitHub Releases';
+    platform = 'github';
+    artifactType = 'generic';
+    priority = 20;
+    detect(registry) {
+        if (registry.type !== 'generic' && registry.type !== 'archive' && registry.type !== 'release') {
+            return false;
+        }
+        const regName = (registry.name || '').toLowerCase();
+        if (regName === 'github' || regName === 'github-release' || regName.startsWith('github-')) {
+            return true;
+        }
+        const server = (registry.server || '').toLowerCase();
+        try {
+            const parsed = new URL(server.includes('://') ? server : `https://${server}`);
+            return GitHubClient.isGitHubHost(parsed.hostname);
+        }
+        catch {
+            return false;
+        }
+    }
+    buildTargetRef(artifact, registry) {
+        const version = artifact.tags && artifact.tags.length > 0 ? artifact.tags[0] : 'v1.0.0';
+        const tagName = version.startsWith('v') || /^\d/.test(version) ? version : `v${version}`;
+        const filename = artifact.source ? path.basename(artifact.source) : artifact.name;
+        try {
+            const { owner, repo } = this.resolveOwnerRepo(registry);
+            return `${owner}/${repo}@${tagName}#${filename}`;
+        }
+        catch {
+            return `${artifact.name}@${tagName}#${filename}`;
+        }
+    }
+    resolveOwnerRepo(registry) {
+        let namespace = registry.namespace || '';
+        let owner = '';
+        let repo = '';
+        if (namespace.includes('/')) {
+            const parts = namespace.split('/');
+            owner = parts[0];
+            repo = parts[1];
+        }
+        else if (registry.server && registry.server.includes('/')) {
+            try {
+                const parsed = GitHubClient.parseRepo(registry.server);
+                owner = parsed.owner;
+                repo = parsed.repo;
+            }
+            catch {
+                // fall through
+            }
+        }
+        if (!owner || !repo) {
+            throw new Error(`GitHub Releases publisher requires repository namespace in "owner/repo" format (got "${registry.namespace || registry.server}").`);
+        }
+        return { owner, repo };
+    }
+    async exists(artifact, registry, options) {
+        const creds = this.resolveCredentials(registry);
+        const token = creds.token || creds.password;
+        let owner = '';
+        let repo = '';
+        try {
+            const resolved = this.resolveOwnerRepo(registry);
+            owner = resolved.owner;
+            repo = resolved.repo;
+        }
+        catch {
+            return false;
+        }
+        const client = new GitHubClient({
+            baseUrl: registry.server && registry.server.startsWith('http') ? registry.server : undefined,
+            token,
+            timeoutMs: options?.timeoutMs
+        });
+        const version = artifact.tags && artifact.tags.length > 0 ? artifact.tags[0] : 'v1.0.0';
+        const tagName = version.startsWith('v') || /^\d/.test(version) ? version : `v${version}`;
+        const filename = artifact.source ? path.basename(artifact.source) : artifact.name;
+        try {
+            const release = await client.getReleaseByTag(owner, repo, tagName);
+            if (!release) {
+                return false;
+            }
+            return Boolean(release.assets?.some(a => a.name === filename));
+        }
+        catch (err) {
+            throw new Error(`Failed to check artifact existence in GitHub Releases: ${client.maskSecrets(err?.message || String(err))}`);
+        }
+    }
+    async download(artifact, registry, dest, options) {
+        const creds = this.resolveCredentials(registry);
+        const { owner, repo } = this.resolveOwnerRepo(registry);
+        const client = new GitHubClient({
+            baseUrl: registry.server && registry.server.startsWith('http') ? registry.server : undefined,
+            token: creds.token || creds.password,
+            timeoutMs: options?.timeoutMs
+        });
+        const version = artifact.tags?.[0] || 'v1.0.0';
+        const tagName = version.startsWith('v') || /^\d/.test(version) ? version : `v${version}`;
+        const filename = artifact.source ? path.basename(artifact.source) : artifact.name;
+        const what = `${artifact.name} ${version} (${filename})`;
+        const release = await client.getReleaseByTag(owner, repo, tagName);
+        const asset = release?.assets?.find(a => a.name === filename);
+        if (!asset) {
+            throw new Error(`${what} not found in GitHub release ${owner}/${repo}@${tagName}`);
+        }
+        // The asset API answers with a redirect to storage when asked for octet-stream
+        const assetUrl = client.getRepoApiUrl(owner, repo, `/releases/assets/${asset.id}`);
+        this.log(`  📥 Downloading ${what} from GitHub release ${owner}/${repo}@${tagName}`);
+        const res = await client.request(assetUrl, { headers: { Accept: 'application/octet-stream' } });
+        if (!res.ok) {
+            throw await this.downloadError(res, what, assetUrl);
+        }
+        return this.saveResponse(res, dest, assetUrl);
+    }
+    async login(registry, _options) {
+        const creds = this.resolveCredentials(registry);
+        if (!creds.token && !creds.password) {
+            this.log(`  ℹ No auth token configured for GitHub Releases ${registry.server}`);
+        }
+    }
+    async doPublish(artifact, registry, options) {
+        const creds = this.resolveCredentials(registry);
+        const token = creds.token || creds.password;
+        const { owner, repo } = this.resolveOwnerRepo(registry);
+        const client = new GitHubClient({
+            baseUrl: registry.server && registry.server.startsWith('http') ? registry.server : undefined,
+            token,
+            timeoutMs: options?.timeoutMs
+        });
+        const version = artifact.tags && artifact.tags.length > 0 ? artifact.tags[0] : 'v1.0.0';
+        const tagName = version.startsWith('v') || /^\d/.test(version) ? version : `v${version}`;
+        let filePath = artifact.source;
+        const stat = await fs.stat(filePath).catch(() => null);
+        if (!stat || !stat.isFile()) {
+            throw new Error(`GitHub Release asset 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')}`;
+        this.log(`  📤 Uploading release asset "${filename}" to GitHub ${owner}/${repo} release ${tagName}...`);
+        if (options?.dryRun) {
+            this.log(`  [dryRun] Would upload asset ${filename} (${fileBuffer.length} bytes) to GitHub release ${tagName}`);
+            return {
+                ref: `${owner}/${repo}@${tagName}#${filename}`,
+                digest,
+                metadata: { owner, repo, tagName, filename, size: fileBuffer.length }
+            };
+        }
+        // Get or create release
+        let release = await client.getReleaseByTag(owner, repo, tagName);
+        if (!release) {
+            this.log(`  ✨ Creating new GitHub release ${tagName} in ${owner}/${repo}...`);
+            release = await client.createRelease(owner, repo, {
+                tagName,
+                name: artifact.name || tagName,
+                body: `Release ${tagName} published via OmniFlow.`
+            });
+        }
+        const uploaded = await client.uploadReleaseAsset(release.upload_url, filename, fileBuffer);
+        return {
+            ref: `${owner}/${repo}@${tagName}#${filename}`,
+            digest,
+            metadata: {
+                owner,
+                repo,
+                tagName,
+                filename,
+                assetId: uploaded.id,
+                downloadUrl: uploaded.browser_download_url,
+                releaseUrl: release.html_url,
+                size: fileBuffer.length
+            }
+        };
+    }
+}
+// Convenient alias
+export { GitHubReleasePublisher as GitHubGenericPublisher };
+//# sourceMappingURL=GitHubReleasePublisher.js.map

package/dist/artifacts/GitHubReleasePublisher.js.map

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

package/dist/client/GitHubClient.d.ts

@@ -0,0 +1,76 @@
+export interface GitHubClientConfig {
+    baseUrl?: string;
+    token?: string;
+    timeoutMs?: number;
+}
+export interface ParsedGitHubRepo {
+    host: string;
+    owner: string;
+    repo: string;
+    fullName: string;
+}
+export interface GitHubReleaseAsset {
+    id: number;
+    name: string;
+    size?: number;
+    browser_download_url?: string;
+}
+export interface GitHubRelease {
+    id: number;
+    tag_name: string;
+    name: string;
+    upload_url: string;
+    html_url: string;
+    assets?: GitHubReleaseAsset[];
+}
+export declare class GitHubClient {
+    readonly baseUrl: string;
+    readonly token?: string;
+    readonly timeoutMs: number;
+    constructor(config?: GitHubClientConfig);
+    get isGitHubCom(): boolean;
+    /**
+     * Return sensitive credential strings of length >= 3 for scrubbing.
+     */
+    getSecrets(): string[];
+    maskSecrets(input: string): string;
+    extractErrorMessage(response: Response): Promise<string>;
+    getAuthHeaders(): Record<string, string>;
+    getRepoApiUrl(owner: string, repo: string, subpath?: string): string;
+    request(url: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Get release by tag. Returns null if not found (404).
+     */
+    getReleaseByTag(owner: string, repo: string, tag: string): Promise<GitHubRelease | null>;
+    /**
+     * Create a new GitHub Release.
+     */
+    createRelease(owner: string, repo: string, params: {
+        tagName: string;
+        name?: string;
+        body?: string;
+        draft?: boolean;
+        prerelease?: boolean;
+    }): Promise<GitHubRelease>;
+    /**
+     * Upload binary asset to a release.
+     */
+    uploadReleaseAsset(uploadUrlTemplate: string, fileName: string, data: Buffer | Uint8Array, contentType?: string): Promise<{
+        id: number;
+        name: string;
+        browser_download_url: string;
+    }>;
+    /**
+     * Parse GitHub repo URL or slug into host, owner, and repo.
+     */
+    static parseRepo(urlOrSlug: string, defaultHost?: string): ParsedGitHubRepo;
+    /**
+     * Determine the API base URL from serverUrl and optional contextPath.
+     */
+    static resolveApiBase(serverUrl: string, contextPath?: string): string;
+    /**
+     * Determine whether a hostname is a genuine GitHub host (avoiding suffix/substring spoofing).
+     */
+    static isGitHubHost(hostname: string): boolean;
+}
+//# sourceMappingURL=GitHubClient.d.ts.map

package/dist/client/GitHubClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubClient.d.ts","sourceRoot":"","sources":["../../src/client/GitHubClient.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAC9B;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,MAAM,GAAE,kBAAuB;IAU3C,IAAI,WAAW,IAAI,OAAO,CAOzB;IAED;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAMtB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5B,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAWxC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM;IAK1D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAcrE;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAa9F;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,UAAU,CAAC,EAAE,OAAO,CAAA;KACrB,GACA,OAAO,CAAC,aAAa,CAAC;IAuBzB;;OAEG;IACG,kBAAkB,CACtB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,WAAW,SAA6B,GACvC,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBtE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,SAAe,GAAG,gBAAgB;IA2BjF;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAQtE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAU/C"}

package/dist/client/GitHubClient.js

@@ -0,0 +1,170 @@
+import { maskSecrets, safeFetch, extractErrorMessage } from '@ticatec/omniflow-artifact';
+export class GitHubClient {
+    baseUrl;
+    token;
+    timeoutMs;
+    constructor(config = {}) {
+        let base = (config.baseUrl || 'https://api.github.com').trim().replace(/\/+$/, '');
+        if (!/^https?:\/\//i.test(base)) {
+            base = `https://${base}`;
+        }
+        this.baseUrl = base;
+        this.token = config.token;
+        this.timeoutMs = config.timeoutMs ?? 30000;
+    }
+    get isGitHubCom() {
+        try {
+            const parsed = new URL(this.baseUrl);
+            return parsed.hostname === 'github.com' || parsed.hostname === 'api.github.com';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Return sensitive credential strings of length >= 3 for scrubbing.
+     */
+    getSecrets() {
+        return [this.token].filter((s) => typeof s === 'string' && s.length >= 3);
+    }
+    maskSecrets(input) {
+        return maskSecrets(input, this.getSecrets());
+    }
+    async extractErrorMessage(response) {
+        return extractErrorMessage(response, this.getSecrets());
+    }
+    getAuthHeaders() {
+        const headers = {
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28'
+        };
+        if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        return headers;
+    }
+    getRepoApiUrl(owner, repo, subpath = '') {
+        const cleanSubpath = subpath ? (subpath.startsWith('/') ? subpath : `/${subpath}`) : '';
+        return `${this.baseUrl}/repos/${owner}/${repo}${cleanSubpath}`;
+    }
+    async request(url, init = {}) {
+        const headers = {
+            ...this.getAuthHeaders(),
+            ...(init.headers || {})
+        };
+        return safeFetch(url, {
+            ...init,
+            headers,
+            timeoutMs: this.timeoutMs,
+            secrets: this.getSecrets()
+        });
+    }
+    /**
+     * Get release by tag. Returns null if not found (404).
+     */
+    async getReleaseByTag(owner, repo, tag) {
+        const url = `${this.getRepoApiUrl(owner, repo)}/releases/tags/${encodeURIComponent(tag)}`;
+        const res = await this.request(url);
+        if (res.status === 404) {
+            return null;
+        }
+        if (!res.ok) {
+            const errText = await this.extractErrorMessage(res);
+            throw new Error(`Failed to query GitHub release for tag "${tag}" (${res.status}): ${errText}`);
+        }
+        return (await res.json());
+    }
+    /**
+     * Create a new GitHub Release.
+     */
+    async createRelease(owner, repo, params) {
+        const url = `${this.getRepoApiUrl(owner, repo)}/releases`;
+        const res = await this.request(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                tag_name: params.tagName,
+                name: params.name || params.tagName,
+                body: params.body || '',
+                draft: params.draft ?? false,
+                prerelease: params.prerelease ?? false
+            })
+        });
+        if (!res.ok) {
+            const err = await this.extractErrorMessage(res);
+            throw new Error(`Failed to create GitHub release "${params.tagName}" (${res.status}): ${err}`);
+        }
+        return (await res.json());
+    }
+    /**
+     * Upload binary asset to a release.
+     */
+    async uploadReleaseAsset(uploadUrlTemplate, fileName, data, contentType = 'application/octet-stream') {
+        // uploadUrlTemplate is like: https://uploads.github.com/repos/octocat/Hello-World/releases/1/assets{?name,label}
+        const cleanUrl = uploadUrlTemplate.replace(/\{.*?\}$/, '');
+        const targetUrl = `${cleanUrl}?name=${encodeURIComponent(fileName)}`;
+        const res = await this.request(targetUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': contentType,
+                'Content-Length': String(data.byteLength)
+            },
+            body: data
+        });
+        if (!res.ok) {
+            const err = await this.extractErrorMessage(res);
+            throw new Error(`Failed to upload asset "${fileName}" to GitHub release (${res.status}): ${err}`);
+        }
+        return (await res.json());
+    }
+    /**
+     * Parse GitHub repo URL or slug into host, owner, and repo.
+     */
+    static parseRepo(urlOrSlug, defaultHost = 'github.com') {
+        let clean = urlOrSlug.trim();
+        let host = defaultHost;
+        if (clean.includes('://')) {
+            const parsed = new URL(clean);
+            host = parsed.host;
+            clean = parsed.pathname;
+        }
+        else if (clean.includes('@') && clean.includes(':')) {
+            const parts = clean.split(':');
+            host = parts[0].replace(/.*@/, '');
+            clean = parts[1];
+        }
+        clean = clean.replace(/^\/+/, '').replace(/\.git$/, '');
+        const segments = clean.split('/').filter(Boolean);
+        if (segments.length < 2) {
+            throw new Error(`Invalid GitHub repository path: "${urlOrSlug}". Expected owner/repo format.`);
+        }
+        const owner = segments[0];
+        const repo = segments[1];
+        const fullName = `${owner}/${repo}`;
+        return { host, owner, repo, fullName };
+    }
+    /**
+     * Determine the API base URL from serverUrl and optional contextPath.
+     */
+    static resolveApiBase(serverUrl, contextPath) {
+        const url = new URL(serverUrl);
+        if (url.hostname === 'github.com' || url.hostname === 'www.github.com' || url.hostname === 'api.github.com') {
+            return 'https://api.github.com';
+        }
+        return `${serverUrl.replace(/\/+$/, '')}${contextPath || ''}/api/v3`;
+    }
+    /**
+     * Determine whether a hostname is a genuine GitHub host (avoiding suffix/substring spoofing).
+     */
+    static isGitHubHost(hostname) {
+        const host = hostname.toLowerCase().trim();
+        return (host === 'github.com' ||
+            host.endsWith('.github.com') ||
+            host === 'api.github.com' ||
+            host === 'ghcr.io' ||
+            host.endsWith('.ghcr.io'));
+    }
+}
+//# sourceMappingURL=GitHubClient.js.map

package/dist/client/GitHubClient.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import type { PluginContext } from '@ticatec/omniflow-core';
+import type { ArtifactPublisherRegistry } from '@ticatec/omniflow-artifact';
+import { GitHubContainerPublisher } from './artifacts/GitHubContainerPublisher.js';
+import { GitHubNpmPublisher } from './artifacts/GitHubNpmPublisher.js';
+import { GitHubMavenPublisher } from './artifacts/GitHubMavenPublisher.js';
+import { GitHubReleasePublisher } from './artifacts/GitHubReleasePublisher.js';
+export * from './client/GitHubClient.js';
+export * from './artifacts/GitHubContainerPublisher.js';
+export * from './artifacts/GitHubNpmPublisher.js';
+export * from './artifacts/GitHubMavenPublisher.js';
+export * from './artifacts/GitHubReleasePublisher.js';
+export interface RegisterGitHubOptions {
+    artifactRegistry?: ArtifactPublisherRegistry;
+}
+/**
+ * Standard OmniFlow Plugin SPI entry point.
+ */
+export declare function register(ctx: PluginContext): void;
+export default register;
+/**
+ * Register all GitHub artifact publishers into the artifact registry.
+ */
+export declare function registerGitHub(options?: RegisterGitHubOptions): {
+    containerPublisher: GitHubContainerPublisher;
+    npmPublisher: GitHubNpmPublisher;
+    mavenPublisher: GitHubMavenPublisher;
+    releasePublisher: GitHubReleasePublisher;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAE9E,cAAc,0BAA0B,CAAA;AACxC,cAAc,yCAAyC,CAAA;AACvD,cAAc,mCAAmC,CAAA;AACjD,cAAc,qCAAqC,CAAA;AACnD,cAAc,uCAAuC,CAAA;AAErD,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,yBAAyB,CAAA;CAC7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAEjD;AAED,eAAe,QAAQ,CAAA;AAEvB;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG;IACnE,kBAAkB,EAAE,wBAAwB,CAAA;IAC5C,YAAY,EAAE,kBAAkB,CAAA;IAChC,cAAc,EAAE,oBAAoB,CAAA;IACpC,gBAAgB,EAAE,sBAAsB,CAAA;CACzC,CAmBA"}

package/dist/index.js

@@ -0,0 +1,38 @@
+import { GitHubContainerPublisher } from './artifacts/GitHubContainerPublisher.js';
+import { GitHubNpmPublisher } from './artifacts/GitHubNpmPublisher.js';
+import { GitHubMavenPublisher } from './artifacts/GitHubMavenPublisher.js';
+import { GitHubReleasePublisher } from './artifacts/GitHubReleasePublisher.js';
+export * from './client/GitHubClient.js';
+export * from './artifacts/GitHubContainerPublisher.js';
+export * from './artifacts/GitHubNpmPublisher.js';
+export * from './artifacts/GitHubMavenPublisher.js';
+export * from './artifacts/GitHubReleasePublisher.js';
+/**
+ * Standard OmniFlow Plugin SPI entry point.
+ */
+export function register(ctx) {
+    registerGitHub({ artifactRegistry: ctx.artifactRegistry });
+}
+export default register;
+/**
+ * Register all GitHub artifact publishers into the artifact registry.
+ */
+export function registerGitHub(options = {}) {
+    const containerPublisher = new GitHubContainerPublisher();
+    const npmPublisher = new GitHubNpmPublisher();
+    const mavenPublisher = new GitHubMavenPublisher();
+    const releasePublisher = new GitHubReleasePublisher();
+    if (options.artifactRegistry) {
+        options.artifactRegistry.register(containerPublisher);
+        options.artifactRegistry.register(npmPublisher);
+        options.artifactRegistry.register(mavenPublisher);
+        options.artifactRegistry.register(releasePublisher);
+    }
+    return {
+        containerPublisher,
+        npmPublisher,
+        mavenPublisher,
+        releasePublisher
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAA;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAE9E,cAAc,0BAA0B,CAAA;AACxC,cAAc,yCAAyC,CAAA;AACvD,cAAc,mCAAmC,CAAA;AACjD,cAAc,qCAAqC,CAAA;AACnD,cAAc,uCAAuC,CAAA;AAMrD;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAkB;IACzC,cAAc,CAAC,EAAE,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAA;AAC5D,CAAC;AAED,eAAe,QAAQ,CAAA;AAEvB;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAMhE,MAAM,kBAAkB,GAAG,IAAI,wBAAwB,EAAE,CAAA;IACzD,MAAM,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAA;IAC7C,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAA;IACjD,MAAM,gBAAgB,GAAG,IAAI,sBAAsB,EAAE,CAAA;IAErD,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;QACrD,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;QAC/C,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;QACjD,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACrD,CAAC;IAED,OAAO;QACL,kBAAkB;QAClB,YAAY;QACZ,cAAc;QACd,gBAAgB;KACjB,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@ticatec/omniflow-github",
+  "version": "1.0.0",
+  "description": "All-in-one GitHub artifact provider for OmniFlow: GitHub Container Registry (ghcr.io), NPM, Maven, and Releases generic packages",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@ticatec/omniflow-artifact": "^1.0.0",
+    "@ticatec/omniflow-core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.4.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.2",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "README_CN.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "typecheck": "tsc --noEmit",
+    "publish:npm": "pnpm publish --access public --no-git-checks"
+  }
+}

package/src/artifacts/GitHubContainerPublisher.ts

@@ -0,0 +1,54 @@
+import { BaseDockerPublisher } from '@ticatec/omniflow-artifact'
+import type { RegistryConfig } from '@ticatec/omniflow-artifact'
+import { GitHubClient } from '../client/GitHubClient.js'
+
+/**
+ * GitHub Container Registry (GHCR) Publisher.
+ *
+ * Supports ghcr.io and GitHub Enterprise Container Registries.
+ */
+export class GitHubContainerPublisher extends BaseDockerPublisher {
+  readonly id = 'github-container'
+  readonly name = 'GitHub Container Registry'
+  readonly platform = 'github'
+  override readonly priority = 20
+
+  override detect(registry: RegistryConfig): boolean {
+    if (registry.type !== 'docker' && registry.type !== 'container') {
+      return false
+    }
+
+    const regName = (registry.name || '').toLowerCase()
+    if (regName === 'github' || regName === 'ghcr' || regName.startsWith('github-') || regName.startsWith('ghcr-')) {
+      return true
+    }
+
+    const server = (registry.server || '').toLowerCase()
+    try {
+      const parsed = new URL(server.includes('://') ? server : `https://${server}`)
+      const host = parsed.hostname.toLowerCase()
+      return host === 'ghcr.io' || host.endsWith('.ghcr.io') || GitHubClient.isGitHubHost(host)
+    } catch {
+      return false
+    }
+  }
+
+  override buildRepositoryUrl(registry: RegistryConfig, imageName: string): string {
+    let host = this.normalizeServerHost(registry.server)
+    if (!host || host === 'github' || host === 'ghcr') {
+      host = 'ghcr.io'
+    }
+
+    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}`
+  }
+}