@enrichlayer/el-linear 1.9.0 → 1.10.0

package/dist/queries/project-milestones-types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Typed response shapes for the queries in `./project-milestones.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ *
+ * The selection sets vary across queries — some include `description`
+ * + `createdAt`, others only the lookup-relevant fields. Modelled as
+ * a base `MilestoneBaseRef` with extension shapes per query so each
+ * consumer reads only what was actually selected.
+ */
+import type { IssueNode } from "./issues-types.js";
+export interface MilestoneProjectRef {
+    id: string;
+    name: string;
+}
+/**
+ * Mirrors the milestone selection set in `LIST_PROJECT_MILESTONES_QUERY`
+ * — full milestone fields without the project-back-reference.
+ */
+export interface MilestoneListNode {
+    id: string;
+    name: string;
+    description: string | null;
+    targetDate: string | null;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Mirrors the milestone selection set in `GET_PROJECT_MILESTONE_BY_ID_QUERY`
+ * — list shape + project + issues connection.
+ */
+export interface MilestoneDetailNode extends MilestoneListNode {
+    project: MilestoneProjectRef;
+    issues: {
+        nodes: IssueNode[];
+    };
+}
+/**
+ * Mirrors the milestone selection set in `FIND_PROJECT_MILESTONE_BY_NAME_*`
+ * — minimal lookup shape with project back-reference.
+ */
+export interface MilestoneLookupNode {
+    id: string;
+    name: string;
+    targetDate: string | null;
+    sortOrder: number;
+    project: MilestoneProjectRef;
+}
+/**
+ * Mirrors the milestone selection set on the create / update mutations —
+ * list shape + project (no issues connection).
+ */
+export interface MutatedMilestoneNode extends MilestoneListNode {
+    project: MilestoneProjectRef;
+}
+export interface ListProjectMilestonesResponse {
+    project: {
+        id: string;
+        name: string;
+        projectMilestones: {
+            nodes: MilestoneListNode[];
+        };
+    } | null;
+}
+export interface GetProjectMilestoneByIdResponse {
+    projectMilestone: MilestoneDetailNode | null;
+}
+export interface FindProjectMilestoneScopedResponse {
+    project: {
+        projectMilestones: {
+            nodes: MilestoneLookupNode[];
+        };
+    } | null;
+}
+export interface FindProjectMilestoneGlobalResponse {
+    projectMilestones: {
+        nodes: MilestoneLookupNode[];
+    };
+}
+export interface CreateProjectMilestoneResponse {
+    projectMilestoneCreate: {
+        success: boolean;
+        projectMilestone: MutatedMilestoneNode | null;
+    };
+}
+export interface UpdateProjectMilestoneResponse {
+    projectMilestoneUpdate: {
+        success: boolean;
+        projectMilestone: MutatedMilestoneNode | null;
+    };
+}

package/dist/queries/project-milestones-types.js

@@ -0,0 +1,10 @@
+/**
+ * Typed response shapes for the queries in `./project-milestones.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ *
+ * The selection sets vary across queries — some include `description`
+ * + `createdAt`, others only the lookup-relevant fields. Modelled as
+ * a base `MilestoneBaseRef` with extension shapes per query so each
+ * consumer reads only what was actually selected.
+ */
+export {};

package/dist/queries/projects-types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Typed response shapes for the queries in `./projects.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ */
+export interface ProjectTeamRef {
+    id: string;
+    key: string;
+    name: string;
+}
+export interface ProjectBaseNode {
+    id: string;
+    name: string;
+    teams: {
+        nodes: ProjectTeamRef[];
+    };
+}
+/**
+ * Mirrors the project selection set used by `SEARCH_PROJECTS_BY_NAME_QUERY`
+ * and `CREATE_PROJECT_MUTATION` — base fields + state.
+ */
+export interface ProjectWithStateNode extends ProjectBaseNode {
+    state: string;
+}
+export interface ProjectIssueRef {
+    id: string;
+    identifier: string;
+    title: string;
+}
+export interface ProjectWithIssuesNode extends ProjectBaseNode {
+    issues: {
+        nodes: ProjectIssueRef[];
+    };
+}
+export interface ProjectByIdResponse {
+    project: ProjectBaseNode | null;
+}
+export interface GetProjectResponse {
+    projects: {
+        nodes: ProjectBaseNode[];
+    };
+}
+export interface GetProjectTeamIssuesResponse {
+    project: ProjectWithIssuesNode | null;
+}
+export interface SearchProjectsByNameResponse {
+    projects: {
+        nodes: ProjectWithStateNode[];
+    };
+}
+export interface CreateProjectResponse {
+    projectCreate: {
+        success: boolean;
+        project: ProjectWithStateNode | null;
+    };
+}
+export interface UpdateProjectResponse {
+    projectUpdate: {
+        success: boolean;
+        project: ProjectBaseNode | null;
+    };
+}
+export interface ProjectArchiveEntity {
+    id: string;
+}
+export interface ProjectArchivePayload {
+    success: boolean;
+    lastSyncId: number;
+    entity: ProjectArchiveEntity | null;
+}
+export interface ArchiveProjectResponse {
+    projectArchive: ProjectArchivePayload;
+}
+export interface DeleteProjectResponse {
+    projectDelete: ProjectArchivePayload;
+}

package/dist/queries/projects-types.js

@@ -0,0 +1,5 @@
+/**
+ * Typed response shapes for the queries in `./projects.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ */
+export {};

package/dist/queries/projects.d.ts

@@ -5,3 +5,5 @@ export declare const GET_PROJECT_TEAM_ISSUES_QUERY = "\n  query GetProjectTeamIs
 export declare const SEARCH_PROJECTS_BY_NAME_QUERY = "\n  query SearchProjectsByName($name: String!) {\n    projects(filter: { name: { containsIgnoreCase: $name } }, first: 10) {\n      nodes {\n        id\n        name\n        state\n        teams {\n          nodes { id key name }\n        }\n      }\n    }\n  }\n";
 export declare const CREATE_PROJECT_MUTATION = "\n  mutation CreateProject($input: ProjectCreateInput!) {\n    projectCreate(input: $input) {\n      success\n      project {\n        id\n        name\n        state\n        teams {\n          nodes { id key name }\n        }\n      }\n    }\n  }\n";
 export declare const UPDATE_PROJECT_MUTATION = "\n  mutation UpdateProject($id: String!, $input: ProjectUpdateInput!) {\n    projectUpdate(id: $id, input: $input) {\n      success\n      project {\n        id\n        name\n        teams {\n          nodes {\n            id\n            key\n            name\n          }\n        }\n      }\n    }\n  }\n";
+export declare const ARCHIVE_PROJECT_MUTATION = "\n  mutation ArchiveProject($id: String!) {\n    projectArchive(id: $id) {\n      success\n      lastSyncId\n      entity {\n        id\n      }\n    }\n  }\n";
+export declare const DELETE_PROJECT_MUTATION = "\n  mutation DeleteProject($id: String!) {\n    projectDelete(id: $id) {\n      success\n      lastSyncId\n      entity {\n        id\n      }\n    }\n  }\n";

package/dist/queries/projects.js

@@ -102,3 +102,25 @@ export const UPDATE_PROJECT_MUTATION = `
     }
   }
 `;
+export const ARCHIVE_PROJECT_MUTATION = `
+  mutation ArchiveProject($id: String!) {
+    projectArchive(id: $id) {
+      success
+      lastSyncId
+      entity {
+        id
+      }
+    }
+  }
+`;
+export const DELETE_PROJECT_MUTATION = `
+  mutation DeleteProject($id: String!) {
+    projectDelete(id: $id) {
+      success
+      lastSyncId
+      entity {
+        id
+      }
+    }
+  }
+`;

package/dist/queries/releases-types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Typed response shapes for the queries in `./releases.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ */
+export interface ReleaseStageRef {
+    id: string;
+    name: string;
+    type: string;
+    color: string | null;
+}
+export interface ReleasePipelineRef {
+    id: string;
+    name: string;
+}
+export interface ReleaseDocumentRef {
+    id: string;
+    title: string;
+    slugId: string;
+}
+/** Mirrors the release selection set used by `GET_RELEASES_QUERY`. */
+export interface ReleaseListNode {
+    id: string;
+    name: string;
+    description: string | null;
+    version: string | null;
+    url: string | null;
+    startDate: string | null;
+    targetDate: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    canceledAt: string | null;
+    stage: ReleaseStageRef | null;
+    pipeline: ReleasePipelineRef | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Mirrors `GET_RELEASE_BY_ID_QUERY` — adds `documents`. */
+export interface ReleaseDetailNode extends ReleaseListNode {
+    documents: {
+        nodes: ReleaseDocumentRef[];
+    };
+}
+/**
+ * Mirrors the release selection set on `CREATE_RELEASE_MUTATION` —
+ * a subset of `ReleaseListNode` (no startDate/targetDate/lifecycle
+ * timestamps; no documents).
+ */
+export interface CreatedReleaseNode {
+    id: string;
+    name: string;
+    description: string | null;
+    version: string | null;
+    url: string | null;
+    stage: ReleaseStageRef | null;
+    pipeline: ReleasePipelineRef | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ReleasePipelineNode {
+    id: string;
+    name: string;
+    stages: {
+        nodes: ReleaseStageRef[];
+    };
+}
+export interface GetReleasesResponse {
+    releases: {
+        nodes: ReleaseListNode[];
+    };
+}
+export interface GetReleaseByIdResponse {
+    release: ReleaseDetailNode | null;
+}
+export interface CreateReleaseResponse {
+    releaseCreate: {
+        success: boolean;
+        release: CreatedReleaseNode | null;
+    };
+}
+export interface GetReleasePipelinesResponse {
+    releasePipelines: {
+        nodes: ReleasePipelineNode[];
+    };
+}

package/dist/queries/releases-types.js

@@ -0,0 +1,5 @@
+/**
+ * Typed response shapes for the queries in `./releases.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ */
+export {};

package/dist/queries/search-types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Typed response shapes for `SEMANTIC_SEARCH_QUERY` and the inline
+ * templates listing in `commands/search.ts`. See `./issues-types.ts`
+ * for the rationale (ALL-937).
+ */
+export interface SearchIssueRef {
+    id: string;
+    identifier: string;
+    title: string;
+    priority: number | null;
+    state: {
+        id: string;
+        name: string;
+    } | null;
+    team: {
+        id: string;
+        key: string;
+        name: string;
+    } | null;
+    assignee: {
+        id: string;
+        name: string;
+        url: string | null;
+    } | null;
+    project: {
+        id: string;
+        name: string;
+    } | null;
+}
+export interface SearchProjectRef {
+    id: string;
+    name: string;
+    state: string;
+}
+export interface SearchInitiativeRef {
+    id: string;
+    name: string;
+    status: string | null;
+}
+export interface SearchDocumentRef {
+    id: string;
+    title: string;
+    slugId: string | null;
+    project: {
+        id: string;
+        name: string;
+    } | null;
+}
+/**
+ * Mirrors a single semanticSearch result. The discriminator is `type`,
+ * but Linear returns *all* sub-objects nullable per row — only the one
+ * matching `type` is populated. Modelled as fully-optional sub-objects
+ * to match runtime reality.
+ */
+export interface SemanticSearchResult {
+    type: string;
+    issue: SearchIssueRef | null;
+    project: SearchProjectRef | null;
+    initiative: SearchInitiativeRef | null;
+    document: SearchDocumentRef | null;
+}
+export interface SemanticSearchResponse {
+    semanticSearch: {
+        results: SemanticSearchResult[];
+    } | null;
+}
+/**
+ * Mirrors the inline `TEMPLATES_QUERY` in `commands/search.ts` —
+ * a smaller selection set than the full templates query, dropping
+ * fields the search command doesn't display.
+ */
+export interface SearchTemplateNode {
+    id: string;
+    name: string;
+    type: string;
+    description: string | null;
+    team: {
+        key: string;
+    } | null;
+    creator: {
+        name: string;
+    } | null;
+}
+export interface SearchTemplatesResponse {
+    templates: SearchTemplateNode[];
+}

package/dist/queries/search-types.js

@@ -0,0 +1,6 @@
+/**
+ * Typed response shapes for `SEMANTIC_SEARCH_QUERY` and the inline
+ * templates listing in `commands/search.ts`. See `./issues-types.ts`
+ * for the rationale (ALL-937).
+ */
+export {};

package/dist/queries/templates-types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Typed response shapes for the queries in `./templates.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ *
+ * Note: `templates` is unusual — it returns the array directly rather
+ * than wrapped in `{ nodes: ... }`. The response type below mirrors
+ * what the API actually returns, not the connection convention.
+ */
+export interface TemplateTeamRef {
+    id: string;
+    key: string;
+    name: string;
+}
+export interface TemplateCreatorRef {
+    id: string;
+    name: string;
+}
+/**
+ * Mirrors the template selection set used by `TEMPLATES_LIST_QUERY` /
+ * `TEMPLATE_BY_ID_QUERY` / `TEMPLATE_CREATE_MUTATION` /
+ * `TEMPLATE_UPDATE_MUTATION`. (Some of those omit `creator` and
+ * `createdAt`; we model the union — consumers only read what their
+ * query selected.)
+ */
+export interface TemplateNode {
+    id: string;
+    name: string;
+    type: string;
+    description: string | null;
+    templateData: unknown;
+    createdAt: string;
+    updatedAt: string;
+    team: TemplateTeamRef | null;
+    creator: TemplateCreatorRef | null;
+}
+export interface TemplatesListResponse {
+    templates: TemplateNode[];
+}
+export interface GetTemplateResponse {
+    template: TemplateNode | null;
+}
+export interface CreateTemplateResponse {
+    templateCreate: {
+        success: boolean;
+        lastSyncId?: number;
+        template: TemplateNode | null;
+    };
+}
+export interface UpdateTemplateResponse {
+    templateUpdate: {
+        success: boolean;
+        lastSyncId?: number;
+        template: TemplateNode | null;
+    };
+}
+export interface DeleteTemplateResponse {
+    templateDelete: {
+        success: boolean;
+        lastSyncId?: number;
+    };
+}

package/dist/queries/templates-types.js

@@ -0,0 +1,9 @@
+/**
+ * Typed response shapes for the queries in `./templates.ts`.
+ * See `./issues-types.ts` for the rationale (ALL-937).
+ *
+ * Note: `templates` is unusual — it returns the array directly rather
+ * than wrapped in `{ nodes: ... }`. The response type below mirrors
+ * what the API actually returns, not the connection convention.
+ */
+export {};

package/dist/types/linear.d.ts

@@ -208,8 +208,14 @@ type GraphQLPrimitive = string | number | boolean | null | undefined;
 type GraphQLValue = GraphQLPrimitive | GraphQLResponseData | GraphQLResponseData[];
 /**
  * Recursive index type for raw GraphQL responses.
- * All nested property access requires narrowing via `as GraphQLResponseData`
- * or `as string` etc. — this prevents `any` from leaking into the type system.
+ *
+ * **Prefer per-query response types** (see `src/queries/*-types.ts`)
+ * over `GraphQLResponseData` for any new consumer. ALL-937 swept the
+ * old service/command consumers; this type is kept as the fallback
+ * for the few generic transports (e.g. `graphql-service.rawRequest`'s
+ * default generic). Don't reach for `as GraphQLResponseData` to skip
+ * a typed shape — the per-query types catch query/consumer drift at
+ * compile time. This type cannot.
  */
 export interface GraphQLResponseData {
     [key: string]: GraphQLValue;

package/dist/utils/auto-link-references.js

@@ -26,37 +26,44 @@ function mergeCandidates(...sources) {
     }
     return [...byId.values()];
 }
-function mergeRelationNodes(nodes, peerKey, normalizeType, out) {
-    for (const rel of nodes ?? []) {
-        const peer = rel[peerKey];
+function mergeOutgoingRelations(nodes, out) {
+    for (const rel of nodes) {
+        const peer = rel.relatedIssue;
         if (!peer) {
             continue;
         }
-        const id = peer.identifier;
-        const uuid = peer.id;
-        const type = normalizeType(rel.type);
-        if (id && !out.byIdentifier.has(id)) {
-            out.byIdentifier.set(id, type);
+        if (!out.byIdentifier.has(peer.identifier)) {
+            out.byIdentifier.set(peer.identifier, rel.type);
         }
-        if (uuid && !out.byUuid.has(uuid)) {
-            out.byUuid.set(uuid, type);
+        if (!out.byUuid.has(peer.id)) {
+            out.byUuid.set(peer.id, rel.type);
+        }
+    }
+}
+function mergeIncomingRelations(nodes, out) {
+    for (const rel of nodes) {
+        const peer = rel.issue;
+        if (!peer) {
+            continue;
+        }
+        // Normalize incoming "blocks" → "blockedBy" so the reported type reads naturally
+        const type = rel.type === "blocks" ? "blockedBy" : rel.type;
+        if (!out.byIdentifier.has(peer.identifier)) {
+            out.byIdentifier.set(peer.identifier, type);
+        }
+        if (!out.byUuid.has(peer.id)) {
+            out.byUuid.set(peer.id, type);
         }
     }
 }
 async function fetchExistingRelations(issueId, graphQLService) {
-    const result = await graphQLService.rawRequest(GET_ISSUE_RELATIONS_QUERY, {
-        id: issueId,
-    });
-    const issue = result.issue;
+    const result = await graphQLService.rawRequest(GET_ISSUE_RELATIONS_QUERY, { id: issueId });
     const out = { byIdentifier: new Map(), byUuid: new Map() };
-    if (!issue) {
+    if (!result.issue) {
         return out;
     }
-    const outgoing = issue.relations;
-    mergeRelationNodes(outgoing?.nodes, "relatedIssue", (raw) => raw, out);
-    const incoming = issue.inverseRelations;
-    // Normalize incoming "blocks" → "blockedBy" so the reported type reads naturally
-    mergeRelationNodes(incoming?.nodes, "issue", (raw) => (raw === "blocks" ? "blockedBy" : raw), out);
+    mergeOutgoingRelations(result.issue.relations.nodes, out);
+    mergeIncomingRelations(result.issue.inverseRelations.nodes, out);
     return out;
 }
 function describeError(err) {
@@ -70,11 +77,9 @@ async function createTypedRelation(ref, sourceId, resolvedId, graphQLService) {
             type: ref.type,
         },
     });
-    const create = result.issueRelationCreate;
-    const issueRelation = create?.issueRelation;
+    const issueRelation = result.issueRelationCreate.issueRelation;
     // The peer (the issue NOT identified by `sourceId`) is whichever side wasn't the source
-    const peerKey = ref.reverse ? "issue" : "relatedIssue";
-    const peer = issueRelation?.[peerKey];
+    const peer = ref.reverse ? issueRelation?.issue : issueRelation?.relatedIssue;
     return {
         identifier: peer?.identifier ?? ref.identifier,
         title: peer?.title ?? "",

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) {