@enrichlayer/el-linear 1.7.0 → 1.10.0

package/dist/utils/graphql-attachments-service.js

@@ -4,9 +4,9 @@ function transformAttachment(att) {
     return {
         id: att.id,
         url: att.url,
-        title: att.title || undefined,
-        createdAt: att.createdAt || undefined,
-        updatedAt: att.updatedAt || undefined,
+        title: att.title ?? undefined,
+        createdAt: att.createdAt ?? undefined,
+        updatedAt: att.updatedAt ?? undefined,
     };
 }
 class GraphQLAttachmentsService {
@@ -17,15 +17,14 @@ class GraphQLAttachmentsService {
     async createAttachment(input) {
         const result = await this.graphqlService.rawRequest(CREATE_ATTACHMENT_MUTATION, { input });
         const attachmentCreate = result.attachmentCreate;
-        if (!attachmentCreate.success) {
+        if (!attachmentCreate.success || !attachmentCreate.attachment) {
             throw new Error(`Failed to create attachment on issue ${input.issueId} for URL "${input.url}"`);
         }
         return transformAttachment(attachmentCreate.attachment);
     }
     async deleteAttachment(id) {
         const result = await this.graphqlService.rawRequest(DELETE_ATTACHMENT_MUTATION, { id });
-        const attachmentDelete = result.attachmentDelete;
-        if (!attachmentDelete.success) {
+        if (!result.attachmentDelete.success) {
             throw new Error(`Failed to delete attachment: ${id}`);
         }
         return true;
@@ -35,9 +34,7 @@ class GraphQLAttachmentsService {
         if (!result.issue) {
             throw new Error(`Issue not found: ${issueId}`);
         }
-        const issue = result.issue;
-        const attachments = issue.attachments;
-        return attachments.nodes.map(transformAttachment);
+        return result.issue.attachments.nodes.map(transformAttachment);
     }
 }
 export async function createGraphQLAttachmentsService(options) {

package/dist/utils/graphql-documents-service.js

@@ -1,32 +1,29 @@
 import { CREATE_DOCUMENT_MUTATION, DELETE_DOCUMENT_MUTATION, GET_DOCUMENT_QUERY, LIST_DOCUMENTS_QUERY, UPDATE_DOCUMENT_MUTATION, } from "../queries/documents.js";
 import { createGraphQLService, } from "./graphql-service.js";
 function transformDocument(doc) {
-    const creator = doc.creator;
-    const project = doc.project;
-    const issue = doc.issue;
     return {
         id: doc.id,
         title: doc.title,
-        content: doc.content || undefined,
-        color: doc.color || undefined,
-        icon: doc.icon || undefined,
-        slugId: doc.slugId || undefined,
-        url: doc.url || undefined,
-        creator: creator
-            ? { id: creator.id, name: creator.name }
+        content: doc.content ?? undefined,
+        color: doc.color ?? undefined,
+        icon: doc.icon ?? undefined,
+        slugId: doc.slugId ?? undefined,
+        url: doc.url ?? undefined,
+        creator: doc.creator
+            ? { id: doc.creator.id, name: doc.creator.name }
             : undefined,
-        project: project
-            ? { id: project.id, name: project.name }
+        project: doc.project
+            ? { id: doc.project.id, name: doc.project.name }
             : undefined,
-        issue: issue
+        issue: doc.issue
             ? {
-                id: issue.id,
-                identifier: issue.identifier,
-                title: issue.title,
+                id: doc.issue.id,
+                identifier: doc.issue.identifier,
+                title: doc.issue.title,
             }
             : undefined,
-        createdAt: doc.createdAt || undefined,
-        updatedAt: doc.updatedAt || undefined,
+        createdAt: doc.createdAt ?? undefined,
+        updatedAt: doc.updatedAt ?? undefined,
     };
 }
 class GraphQLDocumentsService {
@@ -37,7 +34,7 @@ class GraphQLDocumentsService {
     async createDocument(input) {
         const result = await this.graphqlService.rawRequest(CREATE_DOCUMENT_MUTATION, { input });
         const createData = result.documentCreate;
-        if (!createData.success) {
+        if (!createData.success || !createData.document) {
             throw new Error(`Failed to create document "${input.title}"${input.projectId ? ` in project ${input.projectId}` : ""}${input.teamId ? ` for team ${input.teamId}` : ""}`);
         }
         return transformDocument(createData.document);
@@ -45,15 +42,13 @@ class GraphQLDocumentsService {
     async updateDocument(id, input) {
         const result = await this.graphqlService.rawRequest(UPDATE_DOCUMENT_MUTATION, { id, input });
         const updateData = result.documentUpdate;
-        if (!updateData.success) {
+        if (!updateData.success || !updateData.document) {
             throw new Error(`Failed to update document: ${id}`);
         }
         return transformDocument(updateData.document);
     }
     async getDocument(id) {
-        const result = await this.graphqlService.rawRequest(GET_DOCUMENT_QUERY, {
-            id,
-        });
+        const result = await this.graphqlService.rawRequest(GET_DOCUMENT_QUERY, { id });
         if (!result.document) {
             throw new Error(`Document not found: ${id}`);
         }
@@ -71,8 +66,7 @@ class GraphQLDocumentsService {
     }
     async deleteDocument(id) {
         const result = await this.graphqlService.rawRequest(DELETE_DOCUMENT_MUTATION, { id });
-        const deleteData = result.documentDelete;
-        if (!deleteData.success) {
+        if (!result.documentDelete.success) {
             throw new Error(`Failed to delete document: ${id}`);
         }
         return true;

package/dist/utils/graphql-issues-service.d.ts

@@ -1,19 +1,132 @@
-import type { GraphQLResponseData, LinearIssue } from "../types/linear.js";
+import type { IssueArchiveEntity, IssueNode, IssueWithCommentsNode } from "../queries/issues-types.js";
+import type { LinearIssue } from "../types/linear.js";
 import type { GraphQLService } from "./graphql-service.js";
 import type { LinearService } from "./linear-service.js";
+/**
+ * Arguments accepted by `GraphQLIssuesService.searchIssues`. Two
+ * modes:
+ *   - When `query` is set, runs Linear's full-text search and
+ *     post-filters the results with the structured filters below.
+ *   - When `query` is unset, runs a structured filter directly.
+ */
+export interface SearchIssueArgs {
+    /** Free-text search term. When set, `searchIssues` uses Linear's
+     * native full-text search. */
+    query?: string;
+    /** Team key, name, or UUID. */
+    teamId?: string;
+    /** Project name or UUID. */
+    projectId?: string;
+    /** Set true to match only issues with NO project. Mutually
+     * exclusive with `projectId`. */
+    noProject?: boolean;
+    /** Assignee name, email, alias, or UUID. */
+    assigneeId?: string;
+    /** Issue states to include (e.g. `["Todo", "In Progress"]`). */
+    status?: string[];
+    /** Label names to require (intersection). */
+    labelNames?: string[];
+    /** Priority values (0-4) to include. */
+    priority?: number[];
+    /** Result cap; defaults to 10 when not set. */
+    limit?: number;
+    /** Linear orderBy enum (`createdAt` / `updatedAt`). */
+    orderBy?: string;
+}
+/**
+ * Arguments accepted by `GraphQLIssuesService.updateIssue`. Same
+ * field shapes as `CreateIssueArgs` (UUID-or-name where applicable),
+ * but with `id` required (the issue to update) and `subscriberIds` /
+ * `templateId` omitted (not valid on update).
+ */
+export interface UpdateIssueArgs {
+    /** Issue identifier (e.g. `DEV-3592`) or UUID. Required. */
+    id: string;
+    title?: string;
+    description?: string;
+    /** Assignee name, email, alias, or UUID. */
+    assigneeId?: string;
+    priority?: number;
+    projectId?: string;
+    statusId?: string;
+    /**
+     * Hint for the team-aware label resolver when the issue is being
+     * moved between teams.
+     */
+    teamId?: string;
+    labelIds?: string[];
+    parentId?: string;
+    milestoneId?: string;
+    cycleId?: string | null;
+    dueDate?: string;
+    estimate?: number;
+}
+/**
+ * Arguments accepted by `GraphQLIssuesService.createIssue`. Most fields
+ * may be passed as a Linear UUID OR a name/identifier — the service
+ * resolves names to UUIDs against the workspace before issuing the
+ * mutation. The few fields that must already be UUIDs are noted on
+ * the property docstring.
+ *
+ * Pre-fix this was `Record<string, unknown>` and every command-side
+ * caller built up a free-form object. A typo in `assigeeId` vs
+ * `assigneeId` compiled cleanly and silently dropped the field. With
+ * the typed shape, `tsc` catches the typo.
+ */
+export interface CreateIssueArgs {
+    title?: string;
+    /** Team key, name, or UUID. Required unless `templateId` is set. */
+    teamId?: string;
+    /** Original team token (key or name) — used in label resolution error messages. */
+    teamInput?: string;
+    description?: string;
+    /** Assignee name, email, alias, or UUID. */
+    assigneeId?: string;
+    /** Linear priority: 0 (none), 1 (urgent), 2 (high), 3 (medium), 4 (low). */
+    priority?: number;
+    /** Project name or UUID. */
+    projectId?: string;
+    /** Status name or UUID — resolved per team. */
+    statusId?: string;
+    /** Label names or UUIDs — auto-created on the team if missing. */
+    labelIds?: string[];
+    /** Parent issue identifier or UUID. */
+    parentId?: string;
+    /** Project milestone name or UUID — resolved within the project. */
+    milestoneId?: string;
+    /** Cycle number, name, or UUID — resolved per team. */
+    cycleId?: string;
+    /** Subscriber names, emails, aliases, or UUIDs. */
+    subscriberIds?: string[];
+    /** Due date, ISO 8601. */
+    dueDate?: string;
+    /** Story-points / estimate. */
+    estimate?: number;
+    /** Linear server-side template UUID for `--from-template`. */
+    templateId?: string;
+}
+export interface IssueArchiveOperationResult {
+    id: string;
+    entity?: IssueArchiveEntity;
+    lastSyncId: number;
+}
 export declare class GraphQLIssuesService {
     private readonly graphQLService;
     private readonly linearService;
     constructor(graphQLService: GraphQLService, linearService: LinearService);
     getIssues(limit?: number): Promise<LinearIssue[]>;
     getIssueById(issueId: string): Promise<LinearIssue>;
-    updateIssue(args: Record<string, unknown>, labelMode?: string): Promise<LinearIssue>;
+    updateIssue(args: UpdateIssueArgs, labelMode?: string): Promise<LinearIssue>;
+    archiveIssue(issueId: string): Promise<IssueArchiveOperationResult>;
+    deleteIssue(issueId: string, options?: {
+        permanentlyDelete?: boolean;
+    }): Promise<IssueArchiveOperationResult>;
     private extractMilestoneNodes;
     private executeUpdateMutation;
-    createIssue(args: Record<string, unknown>): Promise<LinearIssue>;
+    createIssue(args: CreateIssueArgs): Promise<LinearIssue>;
     private resolveCreateFields;
     private executeCreateMutation;
-    searchIssues(args: Record<string, unknown>): Promise<LinearIssue[]>;
+    searchIssues(args: SearchIssueArgs): Promise<LinearIssue[]>;
     private resolveTeamId;
     private resolveProjectId;
     /**
@@ -41,7 +154,7 @@ export declare class GraphQLIssuesService {
     private resolveStatusIdForUpdate;
     private buildCreateResolveVariables;
     private resolveParentId;
-    transformIssueData(issue: GraphQLResponseData): LinearIssue;
+    transformIssueData(issue: IssueNode | IssueWithCommentsNode): LinearIssue;
     private transformIssueCoreFields;
     private transformIssueRelations;
     private transformIssueHierarchy;