@enrichlayer/el-linear 1.9.0 → 1.15.0

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

@@ -1,6 +1,21 @@
-import type { GraphQLResponseData, LinearIssue } from "../types/linear.js";
+import type { IssueArchiveEntity, IssueNode, IssueWithCommentsNode } from "../queries/issues-types.js";
+import type { LinearIssue, LinearPriority } from "../types/linear.js";
 import type { GraphQLService } from "./graphql-service.js";
 import type { LinearService } from "./linear-service.js";
+/**
+ * Project filter for `SearchIssueArgs`. Discriminated on `kind` so the
+ * "filter by project" and "filter to issues with no project" cases are
+ * mutually exclusive at the type level — the old `projectId?: string;
+ * noProject?: boolean` pair allowed `{ projectId: "x", noProject: true }`
+ * to compile but had to be detangled at runtime (`noProject` won by
+ * convention). The discriminant is the contract.
+ */
+export type SearchIssueProject = {
+    kind: "id";
+    id: string;
+} | {
+    kind: "none";
+};
 /**
  * Arguments accepted by `GraphQLIssuesService.searchIssues`. Two
  * modes:
@@ -14,52 +29,80 @@ export interface SearchIssueArgs {
     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;
+    /**
+     * Project filter. `{ kind: "id", id }` filters to a specific project
+     * (name or UUID accepted); `{ kind: "none" }` matches issues with no
+     * project. Undefined leaves the filter off.
+     */
+    project?: SearchIssueProject;
     /** Assignee name, email, alias, or UUID. */
     assigneeId?: string;
+    /** Agent user name, email, alias, or UUID delegated to the issue. */
+    delegateId?: 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[];
+    priority?: LinearPriority[];
     /** 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).
+ * Fields shared by `CreateIssueArgs` and `UpdateIssueArgs`. Both mutations
+ * accept the same scalar/foreign-key fields — only their lifecycle
+ * fields differ. `Create` adds `teamInput`/`subscriberIds`/`templateId`
+ * (initial-state-only); `Update` adds the required `id` and widens
+ * `cycleId` to `| null` (Linear's API uses `null` to detach from a
+ * cycle on update).
+ *
+ * Pre-fix this lived as two parallel 13-field interfaces. A field added
+ * to one would silently diverge from the other; the shared base now
+ * forces a deliberate per-side decision.
  */
-export interface UpdateIssueArgs {
-    /** Issue identifier (e.g. `DEV-3592`) or UUID. Required. */
-    id: string;
+interface IssueMutationFields {
     title?: string;
+    /** Team key, name, or UUID. Required on create unless `templateId` is set. */
+    teamId?: string;
     description?: string;
     /** Assignee name, email, alias, or UUID. */
     assigneeId?: string;
-    priority?: number;
+    /** Agent user name, email, alias, or UUID delegated to work on the issue. */
+    delegateId?: string | null;
+    /** Linear priority: 0 (none), 1 (urgent), 2 (high), 3 (medium), 4 (low). */
+    priority?: LinearPriority;
+    /** Project name or UUID. */
     projectId?: string;
+    /** Status name or UUID — resolved per team. */
     statusId?: string;
-    /**
-     * Hint for the team-aware label resolver when the issue is being
-     * moved between teams.
-     */
-    teamId?: 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;
-    cycleId?: string | null;
+    /** Due date, ISO 8601. */
     dueDate?: string;
+    /** Story-points / estimate. */
     estimate?: number;
 }
+/**
+ * Arguments accepted by `GraphQLIssuesService.updateIssue`. Same field
+ * shapes as `CreateIssueArgs` (UUID-or-name where applicable), but with
+ * `id` required (the issue to update) and the create-only initial-state
+ * fields (`teamInput` / `subscriberIds` / `templateId`) omitted.
+ */
+export interface UpdateIssueArgs extends IssueMutationFields {
+    /** Issue identifier (e.g. `DEV-3592`) or UUID. Required. */
+    id: string;
+    /**
+     * On update, `null` detaches the issue from its current cycle.
+     * (`undefined` leaves it unchanged; a UUID/number/name moves it.)
+     */
+    cycleId?: string | null;
+}
 /**
  * Arguments accepted by `GraphQLIssuesService.createIssue`. Most fields
  * may be passed as a Linear UUID OR a name/identifier — the service
@@ -72,48 +115,62 @@ export interface UpdateIssueArgs {
  * `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;
+export interface CreateIssueArgs extends IssueMutationFields {
     /** 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. */
+    /** Cycle number, name, or UUID — resolved per team. (No `null` on create.) */
     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 interface StartIssueResult {
+    issue: LinearIssue;
+    previousState?: {
+        id: string;
+        name: string;
+        type: string;
+    };
+    started: boolean;
+    targetState?: {
+        id: string;
+        name: string;
+    };
+}
 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>;
+    startIssue(issueId: string): Promise<StartIssueResult>;
     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: CreateIssueArgs): Promise<LinearIssue>;
+    /**
+     * Folds the `@include`-gated `projectsByName` / `projectsById` aliases
+     * from a create batch response into the single `projects` field the
+     * field-resolution helpers expect. At most one project alias is ever
+     * present, since a `--project` input is either a name or a UUID.
+     */
+    private foldCreateBatchResult;
+    /**
+     * Folds the `@include`-gated `projectsByName` / `projectsById` aliases
+     * from an update batch response into the single `projects` field the
+     * field-resolution helpers expect. See `foldCreateBatchResult`.
+     */
+    private foldUpdateBatchResult;
     private resolveCreateFields;
     private executeCreateMutation;
     searchIssues(args: SearchIssueArgs): Promise<LinearIssue[]>;
@@ -139,14 +196,23 @@ export declare class GraphQLIssuesService {
     private applySearchFilters;
     private buildSearchFilter;
     private resolveAssigneeId;
+    private resolveDelegateId;
     private resolveUpdateContext;
     private resolveCycleIdForUpdate;
     private resolveStatusIdForUpdate;
+    /**
+     * Pre-resolve URL/slug-id project inputs to UUIDs before the batch
+     * resolver runs. Plain names and UUIDs pass through unchanged; only
+     * URL/slug-id forms incur a separate slug→UUID round-trip (the batch
+     * query's `name eqIgnoreCase` filter can't match a URL string).
+     */
+    private withNormalizedProjectId;
     private buildCreateResolveVariables;
     private resolveParentId;
-    transformIssueData(issue: GraphQLResponseData): LinearIssue;
+    transformIssueData(issue: IssueNode | IssueWithCommentsNode): LinearIssue;
     private transformIssueCoreFields;
     private transformIssueRelations;
     private transformIssueHierarchy;
     private transformIssueComments;
 }
+export {};