@parall/sdk 1.54.0 → 1.55.1

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 export * from './browser-viewer.js';
 export { ApiError, ParallClient } from './client.js';
 export * from './constants.js';
+export * from './subject.js';
+export * from './task-label-types.js';
 export * from './types.js';
 export { ParallWs } from './ws.js';

package/dist/project-task-client.d.ts

@@ -0,0 +1,101 @@
+import type { AddProjectMemberRequest, Approval, CreateProjectRequest, CreateTaskCommentRequest, CreateTaskRelationRequest, CreateTaskRequest, PaginatedResponse, Project, ProjectJoinRequest, ProjectLibraryEntry, ProjectMember, ProjectTaskSummaryResponse, Task, TaskActivity, TaskComment, TaskRelation, TaskRelationTargetType, TaskSubtaskSummaryResponse, TaskWatcher, ThreadWatcher, UpdateProjectMemberRequest, UpdateProjectRequest, UpdateTaskCommentRequest, UpdateTaskRequest } from './types.js';
+/** Project and task REST methods shared by every ParallClient instance. */
+export declare abstract class ProjectTaskClient {
+    protected abstract request<T>(method: string, path: string, body?: unknown, query?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    createTask(orgId: string, data: CreateTaskRequest): Promise<Task>;
+    getTasks(orgId: string, params?: {
+        q?: string;
+        status?: string;
+        priority?: string;
+        assignee_id?: string;
+        parent_id?: string;
+        project_id?: string;
+        /** Comma-separated label IDs; matching uses any-of semantics. */
+        label_ids?: string;
+        limit?: number;
+        cursor?: string;
+        sort?: string;
+        order?: string;
+        scope?: 'active' | 'archived' | 'all';
+    }): Promise<PaginatedResponse<Task>>;
+    getTaskSubtaskSummary(orgId: string, params?: {
+        assignee_id?: string;
+        project_id?: string;
+    }): Promise<TaskSubtaskSummaryResponse>;
+    getTask(orgId: string, taskId: string): Promise<Task>;
+    updateTask(orgId: string, taskId: string, data: UpdateTaskRequest): Promise<Task>;
+    deleteTask(orgId: string, taskId: string, opts?: {
+        force?: boolean;
+    }): Promise<void>;
+    archiveTask(orgId: string, taskId: string): Promise<void>;
+    restoreTask(orgId: string, taskId: string): Promise<void>;
+    watchTask(orgId: string, taskId: string): Promise<void>;
+    unwatchTask(orgId: string, taskId: string): Promise<void>;
+    getTaskWatchers(orgId: string, taskId: string): Promise<TaskWatcher[]>;
+    subscribeTaskMember(orgId: string, taskId: string, userId: string): Promise<void>;
+    unsubscribeTaskMember(orgId: string, taskId: string, userId: string): Promise<void>;
+    watchThread(threadRootId: string): Promise<void>;
+    unwatchThread(threadRootId: string): Promise<void>;
+    getThreadWatchers(threadRootId: string): Promise<ThreadWatcher[]>;
+    isWatchingThread(threadRootId: string): Promise<boolean>;
+    getSubtasks(orgId: string, taskId: string): Promise<Task[]>;
+    createTaskRelation(orgId: string, taskId: string, data: CreateTaskRelationRequest): Promise<TaskRelation>;
+    getTaskRelations(orgId: string, taskId: string): Promise<TaskRelation[]>;
+    listTaskRelationsByTarget(orgId: string, params: {
+        target_type: TaskRelationTargetType;
+        target_id: string;
+    }): Promise<TaskRelation[]>;
+    deleteTaskRelation(orgId: string, taskId: string, relationId: string): Promise<void>;
+    getTaskComments(orgId: string, taskId: string, params?: {
+        limit?: number;
+        cursor?: string;
+        order?: string;
+    }): Promise<PaginatedResponse<TaskComment>>;
+    getTaskComment(orgId: string, taskId: string, commentId: string): Promise<TaskComment>;
+    createTaskComment(orgId: string, taskId: string, data: CreateTaskCommentRequest): Promise<TaskComment>;
+    updateTaskComment(orgId: string, taskId: string, commentId: string, data: UpdateTaskCommentRequest): Promise<TaskComment>;
+    deleteTaskComment(orgId: string, taskId: string, commentId: string): Promise<void>;
+    getTaskActivities(orgId: string, taskId: string, params?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<PaginatedResponse<TaskActivity>>;
+    createProject(orgId: string, data: CreateProjectRequest): Promise<Project>;
+    getProjects(orgId: string): Promise<Project[]>;
+    getProjectTaskSummary(orgId: string): Promise<ProjectTaskSummaryResponse>;
+    getProject(orgId: string, projectId: string): Promise<Project>;
+    updateProject(orgId: string, projectId: string, data: UpdateProjectRequest): Promise<Project>;
+    deleteProject(orgId: string, projectId: string): Promise<void>;
+    /** Roster with display info; readable by anyone who can read the project. */
+    getProjectMembers(orgId: string, projectId: string): Promise<ProjectMember[]>;
+    /**
+     * User IDs who may read the project — the assignee-eligibility set. Every
+     * tier answers the roster expansion (direct, team-reached, org
+     * owners/admins); visibility only shapes admission, never reach.
+     */
+    getProjectReaders(orgId: string, projectId: string): Promise<string[]>;
+    /** The join library: every discoverable project (public + restricted, plus
+     * private for org owners/admins) with the caller's admission state. */
+    getProjectLibrary(orgId: string): Promise<ProjectLibraryEntry[]>;
+    /** Public-tier self-admission: writes the caller's own member row.
+     * Other tiers answer `404 PROJECT_NOT_FOUND`; a duplicate answers
+     * `409 MEMBER_EXISTS`. */
+    joinProject(orgId: string, projectId: string): Promise<ProjectMember>;
+    /** Restricted-tier admission petition. A pending duplicate answers
+     * `409 REQUEST_EXISTS`; membership answers `409 MEMBER_EXISTS`. */
+    createProjectJoinRequest(orgId: string, projectId: string): Promise<Approval>;
+    /** Pending petitions for one project — manager standing required. */
+    listProjectJoinRequests(orgId: string, projectId: string): Promise<ProjectJoinRequest[]>;
+    /** Withdraws the caller's own pending petition. */
+    cancelProjectJoinRequest(orgId: string, projectId: string): Promise<void>;
+    /**
+     * Adds one subject (user ID or team ID) to the roster. Manager-only,
+     * create-only: an existing row answers `409 MEMBER_EXISTS` — change roles
+     * through updateProjectMember instead.
+     */
+    addProjectMember(orgId: string, projectId: string, req: AddProjectMemberRequest): Promise<ProjectMember>;
+    /** Sets one roster entry's role. Demoting the last manager answers `400 LAST_MANAGER`. */
+    updateProjectMember(orgId: string, projectId: string, subject: string, req: UpdateProjectMemberRequest): Promise<ProjectMember>;
+    /** Removes one roster entry. Removing the last manager answers `400 LAST_MANAGER`. */
+    removeProjectMember(orgId: string, projectId: string, subject: string): Promise<void>;
+}
+//# sourceMappingURL=project-task-client.d.ts.map

package/dist/project-task-client.d.ts.map

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

package/dist/project-task-client.js

@@ -0,0 +1,173 @@
+import { ENDPOINTS } from './constants.js';
+/** Project and task REST methods shared by every ParallClient instance. */
+export class ProjectTaskClient {
+    async createTask(orgId, data) {
+        return this.request('POST', ENDPOINTS.TASKS(orgId), data);
+    }
+    async getTasks(orgId, params) {
+        return this.request('GET', ENDPOINTS.TASKS(orgId), undefined, params);
+    }
+    async getTaskSubtaskSummary(orgId, params) {
+        return this.request('GET', ENDPOINTS.TASK_SUBTASK_SUMMARY(orgId), undefined, params);
+    }
+    async getTask(orgId, taskId) {
+        return this.request('GET', ENDPOINTS.TASK(orgId, taskId));
+    }
+    async updateTask(orgId, taskId, data) {
+        return this.request('PATCH', ENDPOINTS.TASK(orgId, taskId), data);
+    }
+    async deleteTask(orgId, taskId, opts) {
+        return this.request('DELETE', ENDPOINTS.TASK(orgId, taskId), undefined, opts?.force ? { force: 'true' } : undefined);
+    }
+    async archiveTask(orgId, taskId) {
+        return this.request('POST', ENDPOINTS.TASK_ARCHIVE(orgId, taskId));
+    }
+    async restoreTask(orgId, taskId) {
+        return this.request('POST', ENDPOINTS.TASK_RESTORE(orgId, taskId));
+    }
+    async watchTask(orgId, taskId) {
+        return this.request('POST', ENDPOINTS.TASK_WATCH(orgId, taskId));
+    }
+    async unwatchTask(orgId, taskId) {
+        return this.request('DELETE', ENDPOINTS.TASK_WATCH(orgId, taskId));
+    }
+    async getTaskWatchers(orgId, taskId) {
+        const res = await this.request('GET', ENDPOINTS.TASK_WATCHERS(orgId, taskId));
+        return res.data;
+    }
+    async subscribeTaskMember(orgId, taskId, userId) {
+        return this.request('PUT', ENDPOINTS.TASK_SUBSCRIBER(orgId, taskId, userId));
+    }
+    async unsubscribeTaskMember(orgId, taskId, userId) {
+        return this.request('DELETE', ENDPOINTS.TASK_SUBSCRIBER(orgId, taskId, userId));
+    }
+    async watchThread(threadRootId) {
+        return this.request('POST', ENDPOINTS.MESSAGE_WATCH(threadRootId));
+    }
+    async unwatchThread(threadRootId) {
+        return this.request('DELETE', ENDPOINTS.MESSAGE_WATCH(threadRootId));
+    }
+    async getThreadWatchers(threadRootId) {
+        const res = await this.request('GET', ENDPOINTS.MESSAGE_WATCHERS(threadRootId));
+        return res.data;
+    }
+    async isWatchingThread(threadRootId) {
+        const res = await this.request('GET', ENDPOINTS.MESSAGE_WATCHING(threadRootId));
+        return res.watching;
+    }
+    async getSubtasks(orgId, taskId) {
+        const res = await this.request('GET', ENDPOINTS.TASK_SUBTASKS(orgId, taskId));
+        return res.data;
+    }
+    async createTaskRelation(orgId, taskId, data) {
+        return this.request('POST', ENDPOINTS.TASK_RELATIONS(orgId, taskId), data);
+    }
+    async getTaskRelations(orgId, taskId) {
+        const res = await this.request('GET', ENDPOINTS.TASK_RELATIONS(orgId, taskId));
+        return res.data;
+    }
+    async listTaskRelationsByTarget(orgId, params) {
+        const query = new URLSearchParams({
+            target_type: params.target_type,
+            target_id: params.target_id,
+        });
+        const res = await this.request('GET', `${ENDPOINTS.TASK_RELATIONS_BY_TARGET(orgId)}?${query.toString()}`);
+        return res.data;
+    }
+    async deleteTaskRelation(orgId, taskId, relationId) {
+        return this.request('DELETE', ENDPOINTS.TASK_RELATION(orgId, taskId, relationId));
+    }
+    async getTaskComments(orgId, taskId, params) {
+        return this.request('GET', ENDPOINTS.TASK_COMMENTS(orgId, taskId), undefined, params);
+    }
+    async getTaskComment(orgId, taskId, commentId) {
+        return this.request('GET', ENDPOINTS.TASK_COMMENT(orgId, taskId, commentId));
+    }
+    async createTaskComment(orgId, taskId, data) {
+        return this.request('POST', ENDPOINTS.TASK_COMMENTS(orgId, taskId), data);
+    }
+    async updateTaskComment(orgId, taskId, commentId, data) {
+        return this.request('PATCH', ENDPOINTS.TASK_COMMENT(orgId, taskId, commentId), data);
+    }
+    async deleteTaskComment(orgId, taskId, commentId) {
+        return this.request('DELETE', ENDPOINTS.TASK_COMMENT(orgId, taskId, commentId));
+    }
+    async getTaskActivities(orgId, taskId, params) {
+        return this.request('GET', ENDPOINTS.TASK_ACTIVITIES(orgId, taskId), undefined, params);
+    }
+    async createProject(orgId, data) {
+        return this.request('POST', ENDPOINTS.PROJECTS(orgId), data);
+    }
+    async getProjects(orgId) {
+        const res = await this.request('GET', ENDPOINTS.PROJECTS(orgId));
+        return res.data;
+    }
+    async getProjectTaskSummary(orgId) {
+        return this.request('GET', ENDPOINTS.PROJECT_TASK_SUMMARY(orgId));
+    }
+    async getProject(orgId, projectId) {
+        return this.request('GET', ENDPOINTS.PROJECT(orgId, projectId));
+    }
+    async updateProject(orgId, projectId, data) {
+        return this.request('PATCH', ENDPOINTS.PROJECT(orgId, projectId), data);
+    }
+    async deleteProject(orgId, projectId) {
+        return this.request('DELETE', ENDPOINTS.PROJECT(orgId, projectId));
+    }
+    /** Roster with display info; readable by anyone who can read the project. */
+    async getProjectMembers(orgId, projectId) {
+        const res = await this.request('GET', ENDPOINTS.PROJECT_MEMBERS(orgId, projectId));
+        return res.data;
+    }
+    /**
+     * User IDs who may read the project — the assignee-eligibility set. Every
+     * tier answers the roster expansion (direct, team-reached, org
+     * owners/admins); visibility only shapes admission, never reach.
+     */
+    async getProjectReaders(orgId, projectId) {
+        const res = await this.request('GET', ENDPOINTS.PROJECT_READERS(orgId, projectId));
+        return res.data;
+    }
+    /** The join library: every discoverable project (public + restricted, plus
+     * private for org owners/admins) with the caller's admission state. */
+    async getProjectLibrary(orgId) {
+        const res = await this.request('GET', ENDPOINTS.PROJECT_LIBRARY(orgId));
+        return res.data;
+    }
+    /** Public-tier self-admission: writes the caller's own member row.
+     * Other tiers answer `404 PROJECT_NOT_FOUND`; a duplicate answers
+     * `409 MEMBER_EXISTS`. */
+    async joinProject(orgId, projectId) {
+        return this.request('POST', ENDPOINTS.PROJECT_JOIN(orgId, projectId));
+    }
+    /** Restricted-tier admission petition. A pending duplicate answers
+     * `409 REQUEST_EXISTS`; membership answers `409 MEMBER_EXISTS`. */
+    async createProjectJoinRequest(orgId, projectId) {
+        return this.request('POST', ENDPOINTS.PROJECT_JOIN_REQUESTS(orgId, projectId));
+    }
+    /** Pending petitions for one project — manager standing required. */
+    async listProjectJoinRequests(orgId, projectId) {
+        const res = await this.request('GET', ENDPOINTS.PROJECT_JOIN_REQUESTS(orgId, projectId));
+        return res.data;
+    }
+    /** Withdraws the caller's own pending petition. */
+    async cancelProjectJoinRequest(orgId, projectId) {
+        return this.request('DELETE', ENDPOINTS.PROJECT_JOIN_REQUESTS(orgId, projectId));
+    }
+    /**
+     * Adds one subject (user ID or team ID) to the roster. Manager-only,
+     * create-only: an existing row answers `409 MEMBER_EXISTS` — change roles
+     * through updateProjectMember instead.
+     */
+    async addProjectMember(orgId, projectId, req) {
+        return this.request('POST', ENDPOINTS.PROJECT_MEMBERS(orgId, projectId), req);
+    }
+    /** Sets one roster entry's role. Demoting the last manager answers `400 LAST_MANAGER`. */
+    async updateProjectMember(orgId, projectId, subject, req) {
+        return this.request('PATCH', ENDPOINTS.PROJECT_MEMBER(orgId, projectId, subject), req);
+    }
+    /** Removes one roster entry. Removing the last manager answers `400 LAST_MANAGER`. */
+    async removeProjectMember(orgId, projectId, subject) {
+        return this.request('DELETE', ENDPOINTS.PROJECT_MEMBER(orgId, projectId, subject));
+    }
+}

package/dist/subject.d.ts

@@ -0,0 +1,22 @@
+/** Shared ACL subject token helpers for clients that edit permission rosters. */
+export type SubjectKind = 'wildcard' | 'user' | 'team';
+export interface ParsedSubject {
+    kind: SubjectKind;
+    /** Empty for wildcard, user ID for user, and the full team ID for team. */
+    value: string;
+}
+export declare function isTeamSubject(token: string): boolean;
+export declare function parseSubjectToken(token: string): ParsedSubject;
+/**
+ * Maximum distinct team references one ACL row may carry. Mirrors
+ * `subject.MaxTeamSubjectsPerWrite` on the server, which enforces it.
+ */
+export declare const MAX_TEAM_SUBJECTS_PER_WRITE = 200;
+/**
+ * Returns unique team IDs in first-seen order for batched write validation.
+ * An ID that names no team comes back from the server's existence check
+ * reported missing, so the write fails with a legible error instead of
+ * storing a token that matches nobody.
+ */
+export declare function teamIdsFromSubjects(subjects: readonly string[]): string[];
+//# sourceMappingURL=subject.d.ts.map

package/dist/subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../src/subject.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAW9D;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CASzE"}

package/dist/subject.js

@@ -0,0 +1,45 @@
+/** Shared ACL subject token helpers for clients that edit permission rosters. */
+/**
+ * Team subjects are stored as bare team IDs (`team_...`), mirroring the
+ * server's `pkg/subject`: the ID prefix is what makes a token a team
+ * reference, so no marker syntax exists and a rename never invalidates a
+ * stored reference.
+ */
+const TEAM_ID_PREFIX = 'team_';
+export function isTeamSubject(token) {
+    return token.startsWith(TEAM_ID_PREFIX);
+}
+export function parseSubjectToken(token) {
+    if (token === '*') {
+        return { kind: 'wildcard', value: '' };
+    }
+    if (!token) {
+        throw new Error('Subject token is empty');
+    }
+    if (isTeamSubject(token)) {
+        return { kind: 'team', value: token };
+    }
+    return { kind: 'user', value: token };
+}
+/**
+ * Maximum distinct team references one ACL row may carry. Mirrors
+ * `subject.MaxTeamSubjectsPerWrite` on the server, which enforces it.
+ */
+export const MAX_TEAM_SUBJECTS_PER_WRITE = 200;
+/**
+ * Returns unique team IDs in first-seen order for batched write validation.
+ * An ID that names no team comes back from the server's existence check
+ * reported missing, so the write fails with a legible error instead of
+ * storing a token that matches nobody.
+ */
+export function teamIdsFromSubjects(subjects) {
+    const seen = new Set();
+    const ids = [];
+    for (const token of subjects) {
+        if (!isTeamSubject(token) || seen.has(token))
+            continue;
+        seen.add(token);
+        ids.push(token);
+    }
+    return ids;
+}

package/dist/task-label-client.d.ts

@@ -0,0 +1,13 @@
+import { ProjectTaskClient } from './project-task-client.js';
+import type { AddTaskLabelsRequest, CreateLabelRequest, Label, UpdateLabelRequest } from './task-label-types.js';
+import type { Task } from './types.js';
+/** Organization label vocabulary and incremental Task attachment methods. */
+export declare abstract class TaskLabelClient extends ProjectTaskClient {
+    getLabels(orgId: string): Promise<Label[]>;
+    createLabel(orgId: string, data: CreateLabelRequest): Promise<Label>;
+    updateLabel(orgId: string, labelId: string, data: UpdateLabelRequest): Promise<Label>;
+    deleteLabel(orgId: string, labelId: string): Promise<void>;
+    addTaskLabels(orgId: string, taskId: string, data: AddTaskLabelsRequest): Promise<Task>;
+    removeTaskLabel(orgId: string, taskId: string, labelId: string): Promise<Task>;
+}
+//# sourceMappingURL=task-label-client.d.ts.map

package/dist/task-label-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-label-client.d.ts","sourceRoot":"","sources":["../src/task-label-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,EACL,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,6EAA6E;AAC7E,8BAAsB,eAAgB,SAAQ,iBAAiB;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAK1C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAIrF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrF"}

package/dist/task-label-client.js

@@ -0,0 +1,24 @@
+import { ENDPOINTS } from './constants.js';
+import { ProjectTaskClient } from './project-task-client.js';
+/** Organization label vocabulary and incremental Task attachment methods. */
+export class TaskLabelClient extends ProjectTaskClient {
+    async getLabels(orgId) {
+        const response = await this.request('GET', ENDPOINTS.LABELS(orgId));
+        return response.data;
+    }
+    async createLabel(orgId, data) {
+        return this.request('POST', ENDPOINTS.LABELS(orgId), data);
+    }
+    async updateLabel(orgId, labelId, data) {
+        return this.request('PATCH', ENDPOINTS.LABEL(orgId, labelId), data);
+    }
+    async deleteLabel(orgId, labelId) {
+        return this.request('DELETE', ENDPOINTS.LABEL(orgId, labelId));
+    }
+    async addTaskLabels(orgId, taskId, data) {
+        return this.request('POST', ENDPOINTS.TASK_LABELS(orgId, taskId), data);
+    }
+    async removeTaskLabel(orgId, taskId, labelId) {
+        return this.request('DELETE', ENDPOINTS.TASK_LABEL(orgId, taskId, labelId));
+    }
+}

package/dist/task-label-types.d.ts

@@ -0,0 +1,33 @@
+export type LabelColor = 'default' | 'red' | 'green' | 'yellow' | 'blue' | 'lilac' | 'orange' | 'magenta' | 'sand' | 'fuchsia' | 'cerulean' | 'teal' | 'lime';
+export interface Label {
+    id: string;
+    org_id: string;
+    name: string;
+    color: LabelColor;
+    /** Optional agent-readable guidance for when this label applies. */
+    description?: string | null;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateLabelRequest {
+    name: string;
+    color?: LabelColor;
+    description?: string;
+}
+export interface UpdateLabelRequest {
+    name?: string;
+    color?: LabelColor;
+    /** Explicit null clears the description. */
+    description?: string | null;
+}
+export interface AddTaskLabelsRequest {
+    label_ids: string[];
+}
+export type LabelCreatedData = Label;
+export type LabelUpdatedData = Label;
+export interface LabelDeletedData {
+    label_id: string;
+    org_id: string;
+}
+//# sourceMappingURL=task-label-types.d.ts.map

package/dist/task-label-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-label-types.d.ts","sourceRoot":"","sources":["../src/task-label-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC;AACrC,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/task-label-types.js

@@ -0,0 +1 @@
+export {};