redmine-devrelay-client 0.7.5 → 0.9.0

package/dist/metadata.d.ts

@@ -1,5 +1,5 @@
 import type { RedmineHttp } from "./http.js";
-import type { IssueCategoryOption, IssuePriorityOption, IssueStatusOption, ProjectVersionOption, RedmineNamed } from "./types.js";
+import type { IssueCategoryOption, ListIssueCustomFieldsResult, IssuePriorityOption, IssueStatusOption, ProjectVersionOption, RedmineNamed } from "./types.js";
 /**
  * Match `name` against a list of id/name options: exact (case- and
  * space-insensitive) first, then substring. Same rules as matchMemberByName.
@@ -15,3 +15,13 @@ export declare function listIssuePriorities(http: RedmineHttp): Promise<IssuePri
 export declare function listProjectVersions(http: RedmineHttp, projectId: number): Promise<ProjectVersionOption[]>;
 /** 범주 (GET /projects/:id/issue_categories.json) */
 export declare function listIssueCategories(http: RedmineHttp, projectId: number): Promise<IssueCategoryOption[]>;
+/**
+ * 프로젝트에서 쓸 수 있는 일감 사용자 정의 필드 (id + 이름).
+ *
+ * 1. GET /projects/:id.json?include=issue_custom_fields — Redmine 4.2+.
+ *    키가 오면 그것이 답이다 (빈 배열이면 정말 없는 것).
+ * 2. GET /custom_fields.json — 관리자 키에서만. 401/403이면 건너뛴다.
+ * 3. 프로젝트 최근 이슈 100건의 custom_fields를 합친다. 어떤 버전·권한에서도
+ *    되지만, 값이 한 번도 안 붙은 필드는 빠질 수 있다 (source: "issues").
+ */
+export declare function listProjectIssueCustomFields(http: RedmineHttp, projectId: number): Promise<ListIssueCustomFieldsResult>;

package/dist/metadata.js

@@ -1,3 +1,4 @@
+import { RedmineError } from "./errors.js";
 function compact(s) {
     return s.toLowerCase().replace(/\s+/g, "");
 }
@@ -54,4 +55,57 @@ export async function listIssueCategories(http, projectId) {
         assignedTo: c.assigned_to ?? null,
     }));
 }
+function named(f) {
+    return { id: f.id, name: f.name };
+}
+function isAuthOrPermissionError(err) {
+    return (err instanceof RedmineError &&
+        (err.code === "REDMINE_PERMISSION_DENIED" ||
+            err.code === "REDMINE_AUTHENTICATION_ERROR"));
+}
+/**
+ * 프로젝트에서 쓸 수 있는 일감 사용자 정의 필드 (id + 이름).
+ *
+ * 1. GET /projects/:id.json?include=issue_custom_fields — Redmine 4.2+.
+ *    키가 오면 그것이 답이다 (빈 배열이면 정말 없는 것).
+ * 2. GET /custom_fields.json — 관리자 키에서만. 401/403이면 건너뛴다.
+ * 3. 프로젝트 최근 이슈 100건의 custom_fields를 합친다. 어떤 버전·권한에서도
+ *    되지만, 값이 한 번도 안 붙은 필드는 빠질 수 있다 (source: "issues").
+ */
+export async function listProjectIssueCustomFields(http, projectId) {
+    const project = await http.getJson(`/projects/${projectId}.json`, { include: "issue_custom_fields" });
+    const fromProject = project?.project?.issue_custom_fields;
+    if (Array.isArray(fromProject)) {
+        return { fields: fromProject.map(named), source: "project" };
+    }
+    try {
+        const admin = await http.getJson("/custom_fields.json");
+        const fields = (admin?.custom_fields ?? [])
+            .filter((f) => f.customized_type === "issue")
+            // projects가 없으면 판단할 수 없으니 넣어 둔다 (빠지는 것보다 낫다)
+            .filter((f) => f.is_for_all ||
+            !f.projects ||
+            f.projects.some((p) => p.id === projectId))
+            .map(named);
+        return { fields, source: "custom_fields" };
+    }
+    catch (err) {
+        if (!isAuthOrPermissionError(err))
+            throw err;
+    }
+    const sample = await http.getJson("/issues.json", {
+        project_id: projectId,
+        status_id: "*",
+        limit: 100,
+        sort: "updated_on:desc",
+    });
+    const seen = new Map();
+    for (const issue of sample?.issues ?? []) {
+        for (const f of issue.custom_fields ?? []) {
+            if (!seen.has(f.id))
+                seen.set(f.id, named(f));
+        }
+    }
+    return { fields: [...seen.values()], source: "issues" };
+}
 //# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,11 @@
+import type { RedmineConfig } from "./config.js";
+import type { RedmineHttp } from "./http.js";
+import type { SearchTextInput, SearchTextResult } from "./types.js";
+export declare const SEARCH_TEXT_TYPES: readonly ["issues", "news", "documents", "changesets", "wiki_pages", "messages", "projects"];
+export declare function buildSearchTextQuery(input: SearchTextInput): Record<string, string | number>;
+/**
+ * 전문 검색 (GET /search.json, Redmine 3.3+). 프로젝트를 주면
+ * /projects/:id/search.json 으로 범위를 좁힌다. 구버전 Redmine은 이 경로가 없어
+ * 로그인 페이지로 튕기며 401/404가 오는데, 그건 키 문제가 아니므로 안내를 바꿔 준다.
+ */
+export declare function searchText(http: RedmineHttp, config: RedmineConfig, input: SearchTextInput): Promise<SearchTextResult>;

package/dist/search.js

@@ -0,0 +1,89 @@
+import { RedmineError } from "./errors.js";
+export const SEARCH_TEXT_TYPES = [
+    "issues",
+    "news",
+    "documents",
+    "changesets",
+    "wiki_pages",
+    "messages",
+    "projects",
+];
+export function buildSearchTextQuery(input) {
+    const query = { q: input.query.trim() };
+    const types = input.types?.length ? input.types : ["issues"];
+    for (const t of types)
+        query[t] = 1;
+    if (input.titlesOnly)
+        query.titles_only = 1;
+    if (input.openIssuesOnly)
+        query.open_issues = 1;
+    if (input.allWords !== false)
+        query.all_words = 1;
+    if (input.includeAttachments)
+        query.attachments = 1;
+    return query;
+}
+function normalizeRow(raw) {
+    return {
+        id: raw.id,
+        title: raw.title ?? "",
+        type: raw.type ?? "",
+        url: raw.url ?? "",
+        description: raw.description ?? "",
+        datetime: raw.datetime ?? null,
+    };
+}
+/**
+ * 전문 검색 (GET /search.json, Redmine 3.3+). 프로젝트를 주면
+ * /projects/:id/search.json 으로 범위를 좁힌다. 구버전 Redmine은 이 경로가 없어
+ * 로그인 페이지로 튕기며 401/404가 오는데, 그건 키 문제가 아니므로 안내를 바꿔 준다.
+ */
+export async function searchText(http, config, input) {
+    const q = input.query.trim();
+    if (!q) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: "query must be non-empty",
+            check: ["Pass the words to search for"],
+        });
+    }
+    const limit = Math.min(input.limit ?? 25, config.maxResultCount, 100);
+    const offset = input.offset ?? 0;
+    const path = input.projectId !== undefined
+        ? `/projects/${input.projectId}/search.json`
+        : "/search.json";
+    let data;
+    try {
+        data = await http.getJson(path, {
+            ...buildSearchTextQuery(input),
+            limit,
+            offset,
+        });
+    }
+    catch (err) {
+        if (err instanceof RedmineError &&
+            (err.httpStatus === 401 || err.httpStatus === 404)) {
+            throw new RedmineError({
+                code: "REDMINE_UNKNOWN_ERROR",
+                message: "Full-text search is not available on this Redmine (the /search.json API needs Redmine 3.3+ and the search module)",
+                httpStatus: err.httpStatus,
+                retrySafe: false,
+                check: [
+                    "Use redmine_search_issues with subjectContains instead",
+                    "If other calls also fail, check REDMINE_API_KEY",
+                ],
+            });
+        }
+        throw err;
+    }
+    const rows = (data?.results ?? []).map(normalizeRow);
+    const totalCount = data?.total_count ?? rows.length;
+    return {
+        query: q,
+        results: rows,
+        totalCount,
+        returnedCount: rows.length,
+        hasMore: offset + rows.length < totalCount,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

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

package/dist/timeEntries.d.ts

@@ -0,0 +1,33 @@
+import type { RedmineConfig } from "./config.js";
+import type { RedmineHttp } from "./http.js";
+import type { CreateTimeEntryInput, CreateTimeEntryResult, ListTimeEntriesInput, ListTimeEntriesResult, TimeEntry, TimeEntryActivityOption } from "./types.js";
+type RawNamed = {
+    id: number;
+    name: string;
+};
+type RawTimeEntry = {
+    id: number;
+    project?: RawNamed | null;
+    issue?: {
+        id: number;
+    } | null;
+    user?: RawNamed | null;
+    activity?: RawNamed | null;
+    hours?: number | string | null;
+    comments?: string | null;
+    spent_on?: string | null;
+    created_on?: string | null;
+    updated_on?: string | null;
+};
+export declare function normalizeTimeEntry(raw: RawTimeEntry): TimeEntry;
+/**
+ * Redmine의 spent_on 필터 문법: 둘 다 있으면 `><from|to`, 하나면 `>=from` / `<=to`.
+ */
+export declare function buildTimeEntryQuery(input: ListTimeEntriesInput): Record<string, string | number>;
+/** 작업시간 목록 (GET /time_entries.json) — 최근 날짜부터, 페이지를 이어 받는다 */
+export declare function listTimeEntries(http: RedmineHttp, config: RedmineConfig, input?: ListTimeEntriesInput): Promise<ListTimeEntriesResult>;
+/** 작업시간 기록 (POST /time_entries.json) */
+export declare function createTimeEntry(http: RedmineHttp, input: CreateTimeEntryInput): Promise<CreateTimeEntryResult>;
+/** 작업 분류(활동) 목록 (GET /enumerations/time_entry_activities.json) */
+export declare function listTimeEntryActivities(http: RedmineHttp): Promise<TimeEntryActivityOption[]>;
+export {};

package/dist/timeEntries.js

@@ -0,0 +1,124 @@
+import { RedmineError } from "./errors.js";
+function toHours(value) {
+    const n = typeof value === "string" ? Number(value) : value ?? 0;
+    return Number.isFinite(n) ? n : 0;
+}
+export function normalizeTimeEntry(raw) {
+    return {
+        id: raw.id,
+        project: raw.project ?? null,
+        issue: raw.issue ?? null,
+        user: raw.user ?? null,
+        activity: raw.activity ?? null,
+        hours: toHours(raw.hours),
+        comments: raw.comments ?? "",
+        spentOn: raw.spent_on ?? "",
+        createdOn: raw.created_on ?? null,
+        updatedOn: raw.updated_on ?? null,
+    };
+}
+/**
+ * Redmine의 spent_on 필터 문법: 둘 다 있으면 `><from|to`, 하나면 `>=from` / `<=to`.
+ */
+export function buildTimeEntryQuery(input) {
+    const query = {};
+    if (input.issueId !== undefined)
+        query.issue_id = input.issueId;
+    if (input.projectId !== undefined)
+        query.project_id = input.projectId;
+    if (input.userId !== undefined)
+        query.user_id = String(input.userId);
+    if (input.activityId !== undefined)
+        query.activity_id = input.activityId;
+    if (input.spentFrom && input.spentTo) {
+        query.spent_on = `><${input.spentFrom}|${input.spentTo}`;
+    }
+    else if (input.spentFrom) {
+        query.spent_on = `>=${input.spentFrom}`;
+    }
+    else if (input.spentTo) {
+        query.spent_on = `<=${input.spentTo}`;
+    }
+    query.sort = "spent_on:desc";
+    return query;
+}
+/** 작업시간 목록 (GET /time_entries.json) — 최근 날짜부터, 페이지를 이어 받는다 */
+export async function listTimeEntries(http, config, input = {}) {
+    const wanted = Math.min(input.limit ?? config.maxResultCount, config.maxResultCount);
+    const baseQuery = buildTimeEntryQuery(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("/time_entries.json", { ...baseQuery, limit: pageLimit, offset });
+        totalCount = page.total_count;
+        const rows = page.time_entries ?? [];
+        collected.push(...rows.map(normalizeTimeEntry));
+        offset += rows.length;
+        if (rows.length === 0 || offset >= totalCount)
+            break;
+    }
+    const totalHours = collected.reduce((sum, e) => sum + e.hours, 0);
+    return {
+        entries: collected,
+        totalCount,
+        returnedCount: collected.length,
+        hasMore: startOffset + collected.length < totalCount,
+        // 부동소수 합계를 사람이 읽을 수 있게 소수 둘째 자리까지
+        totalHours: Math.round(totalHours * 100) / 100,
+    };
+}
+/** 작업시간 기록 (POST /time_entries.json) */
+export async function createTimeEntry(http, input) {
+    if (input.issueId === undefined && input.projectId === undefined) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: "A time entry needs issueId or projectId",
+            check: ["Pass the issue id (preferred) or a project id"],
+        });
+    }
+    if (!(input.hours > 0)) {
+        throw new RedmineError({
+            code: "REDMINE_VALIDATION_ERROR",
+            message: `hours must be positive (got ${input.hours})`,
+            check: ["Pass hours as a positive number, e.g. 1.5"],
+        });
+    }
+    const timeEntry = { hours: input.hours };
+    if (input.issueId !== undefined)
+        timeEntry.issue_id = input.issueId;
+    else
+        timeEntry.project_id = input.projectId;
+    if (input.spentOn !== undefined)
+        timeEntry.spent_on = input.spentOn;
+    if (input.activityId !== undefined)
+        timeEntry.activity_id = input.activityId;
+    if (input.comments !== undefined)
+        timeEntry.comments = input.comments;
+    const data = await http.postJson("/time_entries.json", { time_entry: timeEntry });
+    if (!data?.time_entry) {
+        throw new Error("Redmine createTimeEntry returned empty body");
+    }
+    const entry = normalizeTimeEntry(data.time_entry);
+    return {
+        id: entry.id,
+        hours: entry.hours,
+        spentOn: entry.spentOn,
+        issueId: entry.issue?.id ?? input.issueId ?? null,
+        projectId: entry.project?.id ?? input.projectId ?? null,
+        activity: entry.activity,
+        comments: entry.comments,
+    };
+}
+/** 작업 분류(활동) 목록 (GET /enumerations/time_entry_activities.json) */
+export async function listTimeEntryActivities(http) {
+    const data = await http.getJson("/enumerations/time_entry_activities.json");
+    return (data?.time_entry_activities ?? []).map((a) => ({
+        id: a.id,
+        name: a.name,
+        isDefault: Boolean(a.is_default),
+    }));
+}
+//# sourceMappingURL=timeEntries.js.map

package/dist/timeEntries.js.map

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

package/dist/types.d.ts

@@ -40,6 +40,87 @@ export type ProjectVersionOption = RedmineNamed & {
 export type IssueCategoryOption = RedmineNamed & {
     assignedTo: RedmineNamed | null;
 };
+/** 프로젝트에 켜진 일감 사용자 정의 필드 (id + 이름) */
+export type IssueCustomFieldOption = RedmineNamed;
+export type ListIssueCustomFieldsResult = {
+    fields: IssueCustomFieldOption[];
+    /**
+     * project      — GET /projects/:id.json?include=issue_custom_fields (Redmine 4.2+)
+     * custom_fields — GET /custom_fields.json (관리자 키)
+     * issues       — 프로젝트 최근 이슈에서 합친 것. 값이 한 번도 안 붙은 필드는 빠질 수 있음
+     */
+    source: "project" | "custom_fields" | "issues";
+};
+/**
+ * 쓰기용 사용자 정의 필드 값. 문자열, 다중 선택이면 문자열 배열,
+ * 빈 문자열이면 비움 (Redmine은 ""를 비우기로 해석).
+ */
+export type IssueCustomFieldValue = string | string[];
+export type IssueCustomFieldWrite = {
+    id: number;
+    value: IssueCustomFieldValue;
+};
+/** 작업 분류(활동) — time_entry_activities */
+export type TimeEntryActivityOption = RedmineNamed & {
+    isDefault: boolean;
+};
+/** 작업시간 한 건 (GET /time_entries.json 행) */
+export type TimeEntry = {
+    id: number;
+    project: RedmineNamed | null;
+    issue: {
+        id: number;
+    } | null;
+    user: RedmineNamed | null;
+    activity: RedmineNamed | null;
+    hours: number;
+    comments: string;
+    /** YYYY-MM-DD */
+    spentOn: string;
+    createdOn: string | null;
+    updatedOn: string | null;
+};
+export type ListTimeEntriesInput = {
+    issueId?: number;
+    projectId?: number;
+    /** "me" 또는 user id */
+    userId?: "me" | number;
+    /** YYYY-MM-DD (포함) */
+    spentFrom?: string;
+    /** YYYY-MM-DD (포함) */
+    spentTo?: string;
+    activityId?: number;
+    limit?: number;
+    offset?: number;
+};
+export type ListTimeEntriesResult = {
+    entries: TimeEntry[];
+    totalCount: number;
+    returnedCount: number;
+    hasMore: boolean;
+    /** 돌려준 행들의 hours 합 (전체 합이 아님 — hasMore면 더 있다) */
+    totalHours: number;
+};
+export type CreateTimeEntryInput = {
+    /** 둘 중 하나는 필수. 일감이 있으면 일감을 우선 */
+    issueId?: number;
+    projectId?: number;
+    hours: number;
+    /** YYYY-MM-DD, 생략하면 Redmine이 오늘로 */
+    spentOn?: string;
+    /** 활동 id. Redmine에 기본 활동이 없으면 필수 */
+    activityId?: number;
+    comments?: string;
+};
+export type CreateTimeEntryResult = {
+    id: number;
+    hours: number;
+    spentOn: string;
+    issueId: number | null;
+    projectId: number | null;
+    activity: RedmineNamed | null;
+    comments: string;
+};
 /** 이름 또는 id로 지정할 수 있는 필드 값 */
 export type NamedRef = number | string;
 export type IssueInclude = "journals" | "attachments" | "relations" | "children" | "allowed_statuses";
@@ -73,6 +154,13 @@ export type NormalizedIssueSummary = {
     updatedOn: string | null;
     createdOn: string | null;
 };
+/** journal 한 건의 필드 변경: property attr → name은 필드 (status_id, done_ratio, assigned_to_id …) */
+export type JournalDetail = {
+    property: string;
+    name: string;
+    oldValue: string | null;
+    newValue: string | null;
+};
 export type NormalizedIssueDetail = NormalizedIssueSummary & {
     description: string;
     author: {
@@ -102,6 +190,8 @@ export type NormalizedIssueDetail = NormalizedIssueSummary & {
         notes: string;
         createdOn: string;
         privateNotes: boolean;
+        /** 필드 변경 내역 (상태·진척도·담당자 …). Redmine의 journal details */
+        details: JournalDetail[];
     }>;
     attachments?: Array<{
         id: number;
@@ -120,18 +210,32 @@ export type NormalizedIssueDetail = NormalizedIssueSummary & {
 export type SearchIssuesInput = {
     projectId?: number;
     issueId?: number;
+    /** "me", user id — names are resolved by the MCP layer before reaching here */
     assignedTo?: string | number;
     status?: "open" | "closed" | "all" | number;
     trackerId?: number;
     priorityId?: number;
+    /** 대상 버전 id */
+    fixedVersionId?: number;
+    /** 범주 id */
+    categoryId?: number;
+    /** 작성자: "me" 또는 user id */
+    authorId?: "me" | number;
+    /** 일감관리자(watcher): "me" 또는 user id */
+    watcherId?: "me" | number;
     subjectContains?: string;
     createdAfter?: string;
+    createdBefore?: string;
     updatedAfter?: string;
-    parentIssueId?: number;
+    updatedBefore?: string;
+    /** 완료기한 범위 (포함) */
+    dueAfter?: string;
+    dueBefore?: string;
     customFields?: Array<{
         id: number;
         value: string;
     }>;
+    parentIssueId?: number;
     sort?: Array<{
         field: string;
         direction: "asc" | "desc";
@@ -139,6 +243,38 @@ export type SearchIssuesInput = {
     limit?: number;
     offset?: number;
 };
+export type SearchTextType = "issues" | "news" | "documents" | "changesets" | "wiki_pages" | "messages" | "projects";
+/** 전문 검색 (GET /search.json) */
+export type SearchTextInput = {
+    query: string;
+    /** 있으면 /projects/:id/search.json */
+    projectId?: number;
+    /** 기본 ["issues"] */
+    types?: SearchTextType[];
+    titlesOnly?: boolean;
+    openIssuesOnly?: boolean;
+    /** 기본 true — 모든 단어가 들어간 결과만 */
+    allWords?: boolean;
+    includeAttachments?: boolean;
+    limit?: number;
+    offset?: number;
+};
+export type SearchTextRow = {
+    id: number;
+    title: string;
+    /** "issue", "issue closed", "wiki-page", "news" … Redmine이 주는 그대로 */
+    type: string;
+    url: string;
+    description: string;
+    datetime: string | null;
+};
+export type SearchTextResult = {
+    query: string;
+    results: SearchTextRow[];
+    totalCount: number;
+    returnedCount: number;
+    hasMore: boolean;
+};
 export type AttachmentInput = {
     path: string;
     filename?: string;
@@ -163,6 +299,42 @@ export type IssueUploadToken = {
 };
 export declare const ATTACHMENT_MAX_FILES = 5;
 export declare const ATTACHMENT_MAX_BYTES: number;
+/** 내려받기 기본 상한 (요청으로 올릴 수 있는 최대는 HARD) */
+export declare const ATTACHMENT_DOWNLOAD_MAX_BYTES: number;
+export declare const ATTACHMENT_DOWNLOAD_HARD_MAX_BYTES: number;
+/** 텍스트 파일을 결과에 바로 실어 주는 상한 */
+export declare const ATTACHMENT_TEXT_INLINE_MAX_BYTES: number;
+/** GET /attachments/:id.json */
+export type AttachmentInfo = {
+    id: number;
+    filename: string;
+    filesize: number;
+    /** 구버전 Redmine은 안 준다 → 내려받을 때 응답 헤더로 채움 */
+    contentType: string | null;
+    description: string;
+    contentUrl: string;
+    author: RedmineNamed | null;
+    createdOn: string | null;
+};
+export type DownloadAttachmentInput = {
+    attachmentId: number;
+    /** 저장 폴더. 생략하면 OS 임시 폴더 아래 redmine-devrelay/attachments/<id>/ */
+    destDir?: string;
+    /** 기본 ATTACHMENT_DOWNLOAD_MAX_BYTES, 최대 ATTACHMENT_DOWNLOAD_HARD_MAX_BYTES */
+    maxBytes?: number;
+    /** 텍스트 파일이면 내용을 함께 돌려줄지 (기본 true) */
+    inlineText?: boolean;
+};
+export type DownloadAttachmentResult = {
+    attachment: AttachmentInfo;
+    /** 저장된 로컬 경로 */
+    path: string;
+    sizeBytes: number;
+    contentType: string | null;
+    /** 텍스트로 판단되면 UTF-8 본문 (ATTACHMENT_TEXT_INLINE_MAX_BYTES까지) */
+    text?: string;
+    textTruncated?: boolean;
+};
 /** Redmine relation_type values (연결된 일감 관계 종류) */
 export declare const ISSUE_RELATION_TYPES: readonly ["relates", "duplicates", "duplicated", "blocks", "blocked", "precedes", "follows", "copied_to", "copied_from"];
 export type IssueRelationType = (typeof ISSUE_RELATION_TYPES)[number];
@@ -222,6 +394,8 @@ export type CreateIssueInput = {
     fixedVersionId?: number;
     /** 범주 (category_id) */
     categoryId?: number;
+    /** 사용자 정의 필드 (custom_fields) — 프로젝트에 켜진 필드만 */
+    customFields?: IssueCustomFieldWrite[];
     /** "me", numeric user id (담당자) */
     assignedTo?: "me" | number;
     /** 일감관리자 — Redmine watcher_user_ids */
@@ -254,6 +428,8 @@ export type UpdateIssueInput = {
     fixedVersionId?: number | null;
     /** 범주 — number sets it, null clears it */
     categoryId?: number | null;
+    /** 사용자 정의 필드 — 넘긴 필드만 바뀜, value ""면 비움 */
+    customFields?: IssueCustomFieldWrite[];
     assignedTo?: "me" | number;
     /** replace-all when provided (including empty) */
     watcherUserIds?: number[];

package/dist/types.js

@@ -1,5 +1,10 @@
 export const ATTACHMENT_MAX_FILES = 5;
 export const ATTACHMENT_MAX_BYTES = 10 * 1024 * 1024;
+/** 내려받기 기본 상한 (요청으로 올릴 수 있는 최대는 HARD) */
+export const ATTACHMENT_DOWNLOAD_MAX_BYTES = 10 * 1024 * 1024;
+export const ATTACHMENT_DOWNLOAD_HARD_MAX_BYTES = 50 * 1024 * 1024;
+/** 텍스트 파일을 결과에 바로 실어 주는 상한 */
+export const ATTACHMENT_TEXT_INLINE_MAX_BYTES = 200 * 1024;
 /** Redmine relation_type values (연결된 일감 관계 종류) */
 export const ISSUE_RELATION_TYPES = [
     "relates",

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA8IA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,kDAAkD;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;IACT,WAAW;IACX,aAAa;CACL,CAAC;AAIX,mDAAmD;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,SAAS,CAAU,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwSA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,yCAAyC;AACzC,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9D,MAAM,CAAC,MAAM,kCAAkC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACnE,8BAA8B;AAC9B,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,GAAG,IAAI,CAAC;AAoC3D,kDAAkD;AAClD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;IACT,WAAW;IACX,aAAa;CACL,CAAC;AAIX,mDAAmD;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,SAAS,CAAU,CAAC"}

package/dist/writes.js

@@ -29,6 +29,12 @@ function applyOptionalIssueFields(issue, input, opts = {}) {
     if (input.categoryId !== undefined) {
         issue.category_id = input.categoryId === null ? "" : input.categoryId;
     }
+    if (input.customFields !== undefined && input.customFields.length > 0) {
+        issue.custom_fields = input.customFields.map((f) => ({
+            id: f.id,
+            value: f.value,
+        }));
+    }
     if (input.assignedTo !== undefined)
         issue.assigned_to_id = input.assignedTo;
     if (input.watcherUserIds !== undefined) {