redmine-devrelay-client 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import type { RedmineConfig } from "./config.js";
+import { RedmineHttp } from "./http.js";
+import type { IssueInclude, ListProjectsResult, NormalizedIssueDetail, RedmineUser, SearchIssuesInput, SearchIssuesResult } from "./types.js";
+export declare class RedmineClient {
+    readonly http: RedmineHttp;
+    readonly config: RedmineConfig;
+    constructor(http: RedmineHttp, config: RedmineConfig);
+    static fromEnv(env?: NodeJS.ProcessEnv): RedmineClient;
+    getCurrentUser(): Promise<RedmineUser>;
+    listProjects(opts?: {
+        search?: string;
+        limit?: number;
+    }): Promise<ListProjectsResult>;
+    searchIssues(input?: SearchIssuesInput): Promise<SearchIssuesResult>;
+    getIssue(issueId: number, opts?: {
+        include?: IssueInclude[];
+    }): Promise<NormalizedIssueDetail>;
+}

package/dist/client.js

@@ -0,0 +1,73 @@
+import { loadConfig } from "./config.js";
+import { RedmineHttp } from "./http.js";
+import { getIssue, searchIssues } from "./issues.js";
+function normalizeUser(raw) {
+    const name = [raw.lastname, raw.firstname].filter(Boolean).join(" ").trim();
+    return {
+        id: raw.id,
+        login: raw.login,
+        name: name || raw.login,
+    };
+}
+function normalizeProject(raw) {
+    return {
+        id: raw.id,
+        identifier: raw.identifier,
+        name: raw.name,
+        description: raw.description ?? "",
+        isPublic: Boolean(raw.is_public),
+        parent: raw.parent ?? null,
+        status: raw.status ?? 1,
+    };
+}
+export class RedmineClient {
+    http;
+    config;
+    constructor(http, config) {
+        this.http = http;
+        this.config = config;
+    }
+    static fromEnv(env = process.env) {
+        const config = loadConfig(env);
+        return new RedmineClient(new RedmineHttp(config), config);
+    }
+    async getCurrentUser() {
+        const data = await this.http.getJson("/users/current.json");
+        return normalizeUser(data.user);
+    }
+    async listProjects(opts = {}) {
+        const wanted = Math.min(opts.limit ?? this.config.maxResultCount, this.config.maxResultCount);
+        const pageSize = Math.min(100, wanted);
+        const collected = [];
+        let offset = 0;
+        let totalCount = 0;
+        while (collected.length < wanted) {
+            const page = await this.http.getJson("/projects.json", { limit: pageSize, offset });
+            totalCount = page.total_count;
+            collected.push(...page.projects.map(normalizeProject));
+            offset += page.projects.length;
+            if (page.projects.length === 0 || offset >= totalCount)
+                break;
+        }
+        let projects = collected;
+        if (opts.search) {
+            const q = opts.search.toLowerCase();
+            projects = projects.filter((p) => p.name.toLowerCase().includes(q) ||
+                p.identifier.toLowerCase().includes(q));
+        }
+        projects = projects.slice(0, wanted);
+        return {
+            projects,
+            totalCount,
+            returnedCount: projects.length,
+            hasMore: offset < totalCount && projects.length >= wanted,
+        };
+    }
+    searchIssues(input = {}) {
+        return searchIssues(this.http, this.config, input);
+    }
+    getIssue(issueId, opts = {}) {
+        return getIssue(this.http, issueId, opts);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+export type RedmineConfig = {
+    baseUrl: string;
+    apiKey: string;
+    connectTimeoutMs: number;
+    requestTimeoutMs: number;
+    maxResultCount: number;
+    logLevel: string;
+    caCertPath?: string;
+    allowedHosts?: string[];
+    defaultProjectId?: number;
+    userAgent: string;
+};
+export declare function loadConfig(env?: NodeJS.ProcessEnv): RedmineConfig;

package/dist/config.js

@@ -0,0 +1,109 @@
+import { RedmineError } from "./errors.js";
+const FORBIDDEN_HOSTS = new Set(["169.254.169.254", "metadata.google.internal"]);
+/** Loopback / compose service names allowed for local Docker http. */
+const LOCAL_HTTP_HOSTS = new Set(["localhost", "127.0.0.1", "redmine"]);
+function isPrivateIpv4(host) {
+    const m = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+    if (!m)
+        return false;
+    const octets = m.slice(1).map(Number);
+    if (octets.some((n) => n > 255))
+        return false;
+    const [a, b] = octets;
+    if (a === 10)
+        return true;
+    if (a === 192 && b === 168)
+        return true;
+    if (a === 172 && b >= 16 && b <= 31)
+        return true;
+    return false;
+}
+function parseIntEnv(env, name, fallback) {
+    const raw = env[name];
+    if (raw === undefined || raw === "")
+        return fallback;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: `Invalid ${name}: ${raw}`,
+            check: [`Set ${name} to a positive number`],
+        });
+    }
+    return n;
+}
+export function loadConfig(env = process.env) {
+    const urlRaw = env.REDMINE_URL?.trim();
+    const apiKey = env.REDMINE_API_KEY?.trim();
+    if (!urlRaw || !apiKey) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: "REDMINE_URL and REDMINE_API_KEY are required",
+            check: ["Export REDMINE_URL", "Export REDMINE_API_KEY"],
+        });
+    }
+    let parsed;
+    try {
+        parsed = new URL(urlRaw);
+    }
+    catch {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: `Invalid REDMINE_URL: ${urlRaw}`,
+            check: ["Use an absolute URL like https://redmine.example.com"],
+        });
+    }
+    if (parsed.protocol === "file:" || parsed.protocol === "ftp:") {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: `Forbidden URL protocol: ${parsed.protocol}`,
+        });
+    }
+    const host = parsed.hostname.toLowerCase();
+    if (FORBIDDEN_HOSTS.has(host) || host.startsWith("169.254.")) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: "Forbidden link-local/metadata host",
+        });
+    }
+    const allowedHosts = env.REDMINE_ALLOWED_HOSTS
+        ?.split(",")
+        .map((h) => h.trim().toLowerCase())
+        .filter(Boolean);
+    if (allowedHosts?.length && !allowedHosts.includes(host)) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: `Host ${host} is not in REDMINE_ALLOWED_HOSTS`,
+            check: ["Add the Redmine hostname to REDMINE_ALLOWED_HOSTS"],
+        });
+    }
+    const isInsecureHttpAllowed = parsed.protocol === "http:" &&
+        !!allowedHosts?.includes(host) &&
+        (LOCAL_HTTP_HOSTS.has(host) || isPrivateIpv4(host));
+    if (parsed.protocol !== "https:" && !isInsecureHttpAllowed) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: "REDMINE_URL must use https (http only for allowlisted local/private hosts)",
+            check: [
+                "Use https://...",
+                "Or allowlist localhost/redmine/RFC1918 hosts for local Redmine",
+            ],
+        });
+    }
+    const baseUrl = urlRaw.replace(/\/$/, "");
+    return {
+        baseUrl,
+        apiKey,
+        connectTimeoutMs: parseIntEnv(env, "REDMINE_CONNECT_TIMEOUT_MS", 5000),
+        requestTimeoutMs: parseIntEnv(env, "REDMINE_REQUEST_TIMEOUT_MS", 15000),
+        maxResultCount: parseIntEnv(env, "REDMINE_MAX_RESULT_COUNT", 100),
+        logLevel: env.REDMINE_LOG_LEVEL ?? "info",
+        caCertPath: env.REDMINE_CA_CERT_PATH || undefined,
+        allowedHosts,
+        defaultProjectId: env.REDMINE_DEFAULT_PROJECT_ID
+            ? Number(env.REDMINE_DEFAULT_PROJECT_ID)
+            : undefined,
+        userAgent: "redmine-mcp/0.1.0",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export type RedmineErrorCode = "REDMINE_CONNECTION_ERROR" | "REDMINE_AUTHENTICATION_ERROR" | "REDMINE_PERMISSION_DENIED" | "REDMINE_ISSUE_NOT_FOUND" | "REDMINE_PROJECT_NOT_FOUND" | "REDMINE_VALIDATION_ERROR" | "REDMINE_TIMEOUT" | "REDMINE_TLS_ERROR" | "REDMINE_UNKNOWN_ERROR";
+export declare class RedmineError extends Error {
+    readonly code: RedmineErrorCode;
+    readonly httpStatus?: number;
+    readonly dataChanged: false;
+    readonly retrySafe: boolean;
+    readonly check: string[];
+    constructor(opts: {
+        code: RedmineErrorCode;
+        message: string;
+        httpStatus?: number;
+        retrySafe?: boolean;
+        check?: string[];
+    });
+}

package/dist/errors.js

@@ -0,0 +1,16 @@
+export class RedmineError extends Error {
+    code;
+    httpStatus;
+    dataChanged = false;
+    retrySafe;
+    check;
+    constructor(opts) {
+        super(opts.message);
+        this.name = "RedmineError";
+        this.code = opts.code;
+        this.httpStatus = opts.httpStatus;
+        this.retrySafe = opts.retrySafe ?? false;
+        this.check = opts.check ?? [];
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,UAAU,CAAU;IACpB,WAAW,GAAG,KAAc,CAAC;IAC7B,SAAS,CAAU;IACnB,KAAK,CAAW;IAEzB,YAAY,IAMX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,19 @@
+import type { RedmineConfig } from "./config.js";
+export type RedmineHttpOptions = {
+    retryBackoffMs?: number;
+};
+export declare class RedmineHttp {
+    private readonly config;
+    private readonly opts;
+    private readonly dispatcher?;
+    constructor(config: RedmineConfig, opts?: RedmineHttpOptions);
+    getJson<T>(path: string, query?: Record<string, string | number | undefined>): Promise<T>;
+    private buildUrl;
+    private request;
+    private mapStatus;
+    private mapNetworkError;
+    private isRetryableNetworkError;
+    private maskError;
+    private backoffMs;
+    private sleep;
+}

package/dist/http.js

@@ -0,0 +1,168 @@
+import { readFileSync } from "node:fs";
+import { Agent } from "undici";
+import { RedmineError } from "./errors.js";
+import { maskSecret } from "./mask.js";
+const RETRYABLE = new Set([429, 502, 503, 504]);
+const MAX_RETRIES = 2;
+export class RedmineHttp {
+    config;
+    opts;
+    dispatcher;
+    constructor(config, opts = {}) {
+        this.config = config;
+        this.opts = opts;
+        if (config.caCertPath) {
+            const ca = readFileSync(config.caCertPath);
+            this.dispatcher = new Agent({ connect: { ca } });
+        }
+    }
+    async getJson(path, query) {
+        const url = this.buildUrl(path, query);
+        let attempt = 0;
+        let lastError;
+        while (attempt <= MAX_RETRIES) {
+            try {
+                const response = await this.request(url);
+                if (RETRYABLE.has(response.status) && attempt < MAX_RETRIES) {
+                    await this.sleep(this.backoffMs(attempt));
+                    attempt += 1;
+                    continue;
+                }
+                if (!response.ok) {
+                    const bodyText = await response.text();
+                    this.mapStatus(response.status, bodyText);
+                }
+                return (await response.json());
+            }
+            catch (err) {
+                if (err instanceof RedmineError) {
+                    throw this.maskError(err);
+                }
+                lastError = err;
+                if (this.isRetryableNetworkError(err) && attempt < MAX_RETRIES) {
+                    await this.sleep(this.backoffMs(attempt));
+                    attempt += 1;
+                    continue;
+                }
+                throw this.mapNetworkError(err);
+            }
+        }
+        throw this.mapNetworkError(lastError);
+    }
+    buildUrl(path, query) {
+        const url = new URL(path, `${this.config.baseUrl}/`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value === undefined)
+                    continue;
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+    async request(url, body) {
+        const headers = {
+            Accept: "application/json",
+            "User-Agent": this.config.userAgent,
+            "X-Redmine-API-Key": this.config.apiKey,
+        };
+        if (body !== undefined) {
+            headers["Content-Type"] = "application/json";
+        }
+        const init = {
+            method: "GET",
+            headers,
+            signal: AbortSignal.timeout(this.config.requestTimeoutMs),
+        };
+        if (this.dispatcher) {
+            init.dispatcher = this.dispatcher;
+        }
+        return fetch(url, init);
+    }
+    mapStatus(status, bodyText) {
+        const maskedBody = maskSecret(bodyText, this.config.apiKey);
+        if (status === 401) {
+            throw new RedmineError({
+                code: "REDMINE_AUTHENTICATION_ERROR",
+                message: "Redmine authentication failed",
+                httpStatus: status,
+                check: ["Verify REDMINE_API_KEY"],
+                retrySafe: false,
+            });
+        }
+        if (status === 403) {
+            throw new RedmineError({
+                code: "REDMINE_PERMISSION_DENIED",
+                message: "Redmine permission denied",
+                httpStatus: status,
+                check: ["Confirm the user can access this resource in Redmine"],
+                retrySafe: false,
+            });
+        }
+        if (status === 404) {
+            throw new RedmineError({
+                code: "REDMINE_UNKNOWN_ERROR",
+                message: `Redmine resource not found: ${maskedBody || status}`,
+                httpStatus: status,
+                retrySafe: false,
+            });
+        }
+        throw new RedmineError({
+            code: "REDMINE_UNKNOWN_ERROR",
+            message: `Redmine HTTP ${status}: ${maskedBody || "request failed"}`,
+            httpStatus: status,
+            retrySafe: RETRYABLE.has(status),
+            check: ["Retry later if Redmine is temporarily unavailable"],
+        });
+    }
+    mapNetworkError(err) {
+        const message = maskSecret(err instanceof Error ? err.message : String(err), this.config.apiKey);
+        if (err instanceof Error &&
+            (err.name === "TimeoutError" || err.name === "AbortError")) {
+            return new RedmineError({
+                code: "REDMINE_TIMEOUT",
+                message: `Redmine request timed out: ${message}`,
+                retrySafe: true,
+                check: ["Increase REDMINE_REQUEST_TIMEOUT_MS", "Check Redmine health"],
+            });
+        }
+        if (/certificate|SSL|TLS|CERT/i.test(message)) {
+            return new RedmineError({
+                code: "REDMINE_TLS_ERROR",
+                message: `Redmine TLS error: ${message}`,
+                retrySafe: false,
+                check: ["Set REDMINE_CA_CERT_PATH to your company CA file"],
+            });
+        }
+        return new RedmineError({
+            code: "REDMINE_CONNECTION_ERROR",
+            message: `Cannot reach Redmine: ${message}`,
+            retrySafe: true,
+            check: ["Verify REDMINE_URL", "Check VPN / network connectivity"],
+        });
+    }
+    isRetryableNetworkError(err) {
+        if (!(err instanceof Error))
+            return false;
+        if (err.name === "TimeoutError" || err.name === "AbortError")
+            return false;
+        return true;
+    }
+    maskError(err) {
+        return new RedmineError({
+            code: err.code,
+            message: maskSecret(err.message, this.config.apiKey),
+            httpStatus: err.httpStatus,
+            retrySafe: err.retrySafe,
+            check: err.check,
+        });
+    }
+    backoffMs(attempt) {
+        const base = this.opts.retryBackoffMs ?? 200;
+        return base * 2 ** attempt;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { loadConfig, type RedmineConfig } from "./config.js";
+export { RedmineError, type RedmineErrorCode } from "./errors.js";
+export { maskSecret } from "./mask.js";
+export { RedmineHttp, type RedmineHttpOptions } from "./http.js";
+export { RedmineClient } from "./client.js";
+export { buildIssueQuery } from "./issues.js";
+export type * from "./types.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export { loadConfig } from "./config.js";
+export { RedmineError } from "./errors.js";
+export { maskSecret } from "./mask.js";
+export { RedmineHttp } from "./http.js";
+export { RedmineClient } from "./client.js";
+export { buildIssueQuery } from "./issues.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAA2B,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/issues.d.ts

@@ -0,0 +1,8 @@
+import type { RedmineConfig } from "./config.js";
+import type { RedmineHttp } from "./http.js";
+import type { IssueInclude, NormalizedIssueDetail, SearchIssuesInput, SearchIssuesResult } from "./types.js";
+export declare function buildIssueQuery(input: SearchIssuesInput): Record<string, string | number>;
+export declare function searchIssues(http: RedmineHttp, config: RedmineConfig, input?: SearchIssuesInput): Promise<SearchIssuesResult>;
+export declare function getIssue(http: RedmineHttp, issueId: number, opts?: {
+    include?: IssueInclude[];
+}): Promise<NormalizedIssueDetail>;

package/dist/issues.js

@@ -0,0 +1,153 @@
+import { RedmineError } from "./errors.js";
+export function buildIssueQuery(input) {
+    const query = {};
+    if (input.projectId !== undefined)
+        query.project_id = input.projectId;
+    if (input.issueId !== undefined)
+        query.issue_id = input.issueId;
+    if (input.assignedTo !== undefined) {
+        query.assigned_to_id = String(input.assignedTo);
+    }
+    if (input.status === undefined || input.status === "open") {
+        query.status_id = "open";
+    }
+    else if (input.status === "closed") {
+        query.status_id = "closed";
+    }
+    else if (input.status === "all") {
+        query.status_id = "*";
+    }
+    else {
+        query.status_id = input.status;
+    }
+    if (input.trackerId !== undefined)
+        query.tracker_id = input.trackerId;
+    if (input.priorityId !== undefined)
+        query.priority_id = input.priorityId;
+    if (input.subjectContains)
+        query.subject = `~${input.subjectContains}`;
+    if (input.parentIssueId !== undefined) {
+        query.parent_id = input.parentIssueId;
+    }
+    if (input.createdAfter)
+        query.created_on = `>=${input.createdAfter}`;
+    if (input.updatedAfter)
+        query.updated_on = `>=${input.updatedAfter}`;
+    if (input.customFields) {
+        for (const field of input.customFields) {
+            query[`cf_${field.id}`] = field.value;
+        }
+    }
+    if (input.sort?.length) {
+        query.sort = input.sort
+            .map((s) => `${s.field}:${s.direction}`)
+            .join(",");
+    }
+    return query;
+}
+function normalizeSummary(raw) {
+    return {
+        id: raw.id,
+        subject: raw.subject,
+        project: raw.project ?? null,
+        tracker: raw.tracker ?? null,
+        status: raw.status ?? null,
+        priority: raw.priority ?? null,
+        assignedTo: raw.assigned_to ?? null,
+        updatedOn: raw.updated_on ?? null,
+        createdOn: raw.created_on ?? null,
+    };
+}
+function normalizeDetail(raw) {
+    return {
+        ...normalizeSummary(raw),
+        description: raw.description ?? "",
+        author: raw.author ?? null,
+        startDate: raw.start_date ?? null,
+        dueDate: raw.due_date ?? null,
+        doneRatio: raw.done_ratio ?? null,
+        estimatedHours: raw.estimated_hours ?? null,
+        parent: raw.parent ?? null,
+        customFields: (raw.custom_fields ?? []).map((f) => ({
+            id: f.id,
+            name: f.name,
+            value: f.value,
+        })),
+        journals: raw.journals?.map((j) => ({
+            id: j.id,
+            user: j.user ?? null,
+            notes: j.notes ?? "",
+            createdOn: j.created_on,
+            privateNotes: Boolean(j.private_notes),
+        })),
+        attachments: raw.attachments?.map((a) => ({
+            id: a.id,
+            filename: a.filename,
+            filesize: a.filesize,
+            contentType: a.content_type,
+            createdOn: a.created_on,
+        })),
+        relations: raw.relations,
+        children: raw.children,
+        allowedStatuses: raw.allowed_statuses,
+    };
+}
+export async function searchIssues(http, config, input = {}) {
+    const wanted = Math.min(input.limit ?? config.maxResultCount, config.maxResultCount);
+    const baseQuery = buildIssueQuery(input);
+    const startOffset = input.offset ?? 0;
+    const collected = [];
+    let offset = startOffset;
+    let totalCount = 0;
+    while (collected.length < wanted) {
+        const pageLimit = Math.min(100, wanted - collected.length);
+        const page = await http.getJson("/issues.json", {
+            ...baseQuery,
+            limit: pageLimit,
+            offset,
+        });
+        totalCount = page.total_count;
+        collected.push(...page.issues.map(normalizeSummary));
+        offset += page.issues.length;
+        if (page.issues.length === 0 || offset >= totalCount)
+            break;
+    }
+    const issues = collected.slice(0, wanted);
+    return {
+        issues,
+        totalCount,
+        returnedCount: issues.length,
+        hasMore: startOffset + issues.length < totalCount,
+    };
+}
+export async function getIssue(http, issueId, opts = {}) {
+    if (!Number.isInteger(issueId) || issueId <= 0) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: "issueId must be a positive integer",
+        });
+    }
+    const query = {};
+    if (opts.include?.length) {
+        query.include = opts.include.join(",");
+    }
+    try {
+        const data = await http.getJson(`/issues/${issueId}.json`, query);
+        return normalizeDetail(data.issue);
+    }
+    catch (err) {
+        if (err instanceof RedmineError &&
+            err.httpStatus === 404 &&
+            err.code === "REDMINE_UNKNOWN_ERROR") {
+            throw new RedmineError({
+                code: "REDMINE_ISSUE_NOT_FOUND",
+                message: `Issue #${issueId} was not found`,
+                httpStatus: 404,
+                check: ["Confirm the issue id", "Confirm project access"],
+                retrySafe: false,
+            });
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=issues.js.map

package/dist/issues.js.map

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

package/dist/mask.d.ts

@@ -0,0 +1 @@
+export declare function maskSecret(text: string, secret: string): string;

package/dist/mask.js

@@ -0,0 +1,6 @@
+export function maskSecret(text, secret) {
+    if (!secret)
+        return text;
+    return text.split(secret).join("***");
+}
+//# sourceMappingURL=mask.js.map

package/dist/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.js","sourceRoot":"","sources":["../src/mask.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,120 @@
+export type RedmineUser = {
+    id: number;
+    login: string;
+    name: string;
+};
+export type RedmineProject = {
+    id: number;
+    identifier: string;
+    name: string;
+    description: string;
+    isPublic: boolean;
+    parent: {
+        id: number;
+        name: string;
+    } | null;
+    status: number;
+};
+export type ListProjectsResult = {
+    projects: RedmineProject[];
+    totalCount: number;
+    returnedCount: number;
+    hasMore: boolean;
+};
+export type IssueInclude = "journals" | "attachments" | "relations" | "children" | "allowed_statuses";
+export type NormalizedIssueSummary = {
+    id: number;
+    subject: string;
+    project: {
+        id: number;
+        name: string;
+    } | null;
+    tracker: {
+        id: number;
+        name: string;
+    } | null;
+    status: {
+        id: number;
+        name: string;
+    } | null;
+    priority: {
+        id: number;
+        name: string;
+    } | null;
+    assignedTo: {
+        id: number;
+        name: string;
+    } | null;
+    updatedOn: string | null;
+    createdOn: string | null;
+};
+export type NormalizedIssueDetail = NormalizedIssueSummary & {
+    description: string;
+    author: {
+        id: number;
+        name: string;
+    } | null;
+    startDate: string | null;
+    dueDate: string | null;
+    doneRatio: number | null;
+    estimatedHours: number | null;
+    parent: {
+        id: number;
+    } | null;
+    customFields: Array<{
+        id: number;
+        name: string;
+        value: unknown;
+    }>;
+    journals?: Array<{
+        id: number;
+        user: {
+            id: number;
+            name: string;
+        } | null;
+        notes: string;
+        createdOn: string;
+        privateNotes: boolean;
+    }>;
+    attachments?: Array<{
+        id: number;
+        filename: string;
+        filesize: number;
+        contentType: string;
+        createdOn: string;
+    }>;
+    relations?: unknown[];
+    children?: unknown[];
+    allowedStatuses?: Array<{
+        id: number;
+        name: string;
+    }>;
+};
+export type SearchIssuesInput = {
+    projectId?: number;
+    issueId?: number;
+    assignedTo?: string | number;
+    status?: "open" | "closed" | "all" | number;
+    trackerId?: number;
+    priorityId?: number;
+    subjectContains?: string;
+    createdAfter?: string;
+    updatedAfter?: string;
+    parentIssueId?: number;
+    customFields?: Array<{
+        id: number;
+        value: string;
+    }>;
+    sort?: Array<{
+        field: string;
+        direction: "asc" | "desc";
+    }>;
+    limit?: number;
+    offset?: number;
+};
+export type SearchIssuesResult = {
+    issues: NormalizedIssueSummary[];
+    totalCount: number;
+    returnedCount: number;
+    hasMore: boolean;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "redmine-devrelay-client",
+  "version": "0.1.0",
+  "description": "Redmine REST client used by redmine-devrelay MCP",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.10",
+    "typescript": "5.8.2",
+    "vitest": "3.0.9"
+  },
+  "dependencies": {
+    "undici": "7.8.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
+}