@automate.ax/integration-contracts 0.55.0

package/dist/linear/schemas.js

@@ -0,0 +1,760 @@
+import { z } from "zod";
+const LINEAR_DATE_TIME_SCHEMA = z.union([
+    z.date(),
+    z.iso.datetime({ offset: true }).transform((value) => new Date(value)),
+]);
+const LINEAR_JSON_OBJECT_SCHEMA = z.record(z.string(), z.json());
+const LINEAR_WEBHOOK_USER_SCHEMA = z
+    .looseObject({
+    /** User avatar URL, when available. */
+    avatarUrl: z.string().nullable().optional(),
+    /** Workspace email address. */
+    email: z.string(),
+    /** Stable Linear user ID. */
+    id: z.string(),
+    /** User-facing name. */
+    name: z.string(),
+    /** Linear profile URL. */
+    url: z.string(),
+})
+    .catchall(z.json());
+const LINEAR_WEBHOOK_TEAM_SCHEMA = z
+    .looseObject({
+    /** Stable Linear team ID. */
+    id: z.string(),
+    /** Short issue identifier prefix. */
+    key: z.string(),
+    /** Team name. */
+    name: z.string(),
+})
+    .catchall(z.json());
+const LINEAR_WEBHOOK_PROJECT_REFERENCE_SCHEMA = z
+    .looseObject({
+    /** Stable Linear project ID. */
+    id: z.string(),
+    /** Project name. */
+    name: z.string(),
+    /** Linear project URL. */
+    url: z.string(),
+})
+    .catchall(z.json());
+const LINEAR_WEBHOOK_ISSUE_REFERENCE_SCHEMA = z
+    .looseObject({
+    /** Stable Linear issue ID. */
+    id: z.string(),
+    /** Human-readable identifier such as `ENG-123`. */
+    identifier: z.string(),
+    /** Team that owns the issue. */
+    team: LINEAR_WEBHOOK_TEAM_SCHEMA,
+    /** Stable ID of the team that owns the issue. */
+    teamId: z.string(),
+    /** Issue title. */
+    title: z.string(),
+    /** Linear issue URL. */
+    url: z.string(),
+})
+    .catchall(z.json());
+const LINEAR_WEBHOOK_EVENT_SCHEMA = z
+    .looseObject({
+    /** Provider action that caused the webhook. */
+    action: z.enum(["create", "update", "remove"]),
+    /** Linear identity responsible for the change, when available. */
+    actor: z
+        .looseObject({
+        email: z.string().optional(),
+        id: z.string().optional(),
+        name: z.string().optional(),
+        type: z.string().optional(),
+        url: z.string().optional(),
+    })
+        .catchall(z.json())
+        .nullable()
+        .optional(),
+    /** When the underlying change occurred. */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** Provider-native changed resource fields. */
+    data: LINEAR_JSON_OBJECT_SCHEMA,
+    /** Stable Linear workspace ID. */
+    organizationId: z.string(),
+    /** Previous values for fields included in an update. */
+    updatedFrom: LINEAR_JSON_OBJECT_SCHEMA.optional(),
+    /** Linear URL for the changed resource, when available. */
+    url: z.string().optional(),
+    /** Stable ID of the OAuth app webhook delivering this event. */
+    webhookId: z.string(),
+    /** Unix timestamp in milliseconds when Linear sent the webhook. */
+    webhookTimestamp: z.number().int().nonnegative(),
+})
+    .catchall(z.json());
+const LINEAR_ISSUE_WEBHOOK_DATA_SCHEMA = z
+    .looseObject({
+    /** When the issue was archived. */
+    archivedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** User assigned to the issue. */
+    assignee: LINEAR_WEBHOOK_USER_SCHEMA.nullable().optional(),
+    /** Stable ID of the assigned user. */
+    assigneeId: z.string().nullable().optional(),
+    /** When the issue was canceled. */
+    canceledAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** When the issue was completed. */
+    completedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** When the issue was created. */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** User who created the issue. */
+    creator: LINEAR_WEBHOOK_USER_SCHEMA.nullable().optional(),
+    /** Stable ID of the issue creator. */
+    creatorId: z.string().nullable().optional(),
+    /** Markdown issue description. */
+    description: z.string().nullable().optional(),
+    /** Issue due date. */
+    dueDate: z.iso.date().nullable().optional(),
+    /** Issue estimate on the team's configured scale. */
+    estimate: z.number().nullable().optional(),
+    /** Stable Linear issue ID. */
+    id: z.string(),
+    /** Human-readable identifier such as `ENG-123`. */
+    identifier: z.string(),
+    /** IDs of labels currently applied to the issue. */
+    labelIds: z.string().array(),
+    /** Labels currently applied to the issue. */
+    labels: z
+        .looseObject({
+        color: z.string(),
+        id: z.string(),
+        name: z.string(),
+        parentId: z.string().nullable().optional(),
+    })
+        .catchall(z.json())
+        .array(),
+    /** Numeric portion of the issue identifier. */
+    number: z.number(),
+    /** Stable parent issue ID when this is a sub-issue. */
+    parentId: z.string().nullable().optional(),
+    /** Numeric priority from zero to four. */
+    priority: z.number(),
+    /** Human-readable issue priority. */
+    priorityLabel: z.string(),
+    /** Project containing the issue. */
+    project: LINEAR_WEBHOOK_PROJECT_REFERENCE_SCHEMA.nullable().optional(),
+    /** Stable ID of the project containing the issue. */
+    projectId: z.string().nullable().optional(),
+    /** When work began. */
+    startedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** Current workflow state. */
+    state: z
+        .looseObject({
+        color: z.string(),
+        id: z.string(),
+        name: z.string(),
+        type: z.string(),
+    })
+        .catchall(z.json()),
+    /** Stable ID of the current workflow state. */
+    stateId: z.string(),
+    /** IDs of users subscribed to the issue. */
+    subscriberIds: z.string().array(),
+    /** Team that owns the issue. */
+    team: LINEAR_WEBHOOK_TEAM_SCHEMA.nullable().optional(),
+    /** Stable ID of the team that owns the issue. */
+    teamId: z.string(),
+    /** Issue title. */
+    title: z.string(),
+    /** Whether the issue is in Linear's recently deleted view. */
+    trashed: z.boolean().nullable().optional(),
+    /** When the issue was last updated. */
+    updatedAt: z.iso.datetime({ offset: true }),
+    /** Linear issue URL. */
+    url: z.string(),
+})
+    .catchall(z.json());
+const LINEAR_COMMENT_WEBHOOK_DATA_SCHEMA = z
+    .looseObject({
+    /** When the comment was archived. */
+    archivedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** Markdown comment body. */
+    body: z.string(),
+    /** When the comment was created. */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** When the body was last edited. */
+    editedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** Stable Linear comment ID. */
+    id: z.string(),
+    /** Issue containing the comment. */
+    issue: LINEAR_WEBHOOK_ISSUE_REFERENCE_SCHEMA.nullable().optional(),
+    /** Stable ID of the issue containing the comment. */
+    issueId: z.string().nullable().optional(),
+    /** Stable parent comment ID when this is a threaded reply. */
+    parentId: z.string().nullable().optional(),
+    /** Text selected by an inline comment. */
+    quotedText: z.string().nullable().optional(),
+    /** When the comment thread was resolved. */
+    resolvedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** When the comment was last updated. */
+    updatedAt: z.iso.datetime({ offset: true }),
+    /** User who authored the comment. */
+    user: LINEAR_WEBHOOK_USER_SCHEMA.nullable().optional(),
+    /** Stable ID of the comment author. */
+    userId: z.string().nullable().optional(),
+})
+    .catchall(z.json());
+const LINEAR_PROJECT_WEBHOOK_DATA_SCHEMA = z
+    .looseObject({
+    /** When the project was archived. */
+    archivedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** When the project was canceled. */
+    canceledAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** Project display color. */
+    color: z.string(),
+    /** When the project was completed. */
+    completedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** Long-form Markdown project content. */
+    content: z.string().nullable().optional(),
+    /** When the project was created. */
+    createdAt: z.iso.datetime({ offset: true }),
+    /** Stable ID of the user who created the project. */
+    creatorId: z.string().nullable().optional(),
+    /** Short project summary. */
+    description: z.string(),
+    /** Current project health. */
+    health: z.string().nullable().optional(),
+    /** Emoji or provider-supported project icon value. */
+    icon: z.string().nullable().optional(),
+    /** Stable Linear project ID. */
+    id: z.string(),
+    /** Human-readable project identifier. */
+    identifier: z.string().nullable().optional(),
+    /** Workspace user leading the project. */
+    lead: LINEAR_WEBHOOK_USER_SCHEMA.nullable().optional(),
+    /** Stable ID of the project lead. */
+    leadId: z.string().nullable().optional(),
+    /** IDs of project members. */
+    memberIds: z.string().array(),
+    /** Project name. */
+    name: z.string(),
+    /** Numeric project priority. */
+    priority: z.number(),
+    /** URL-safe project slug. */
+    slugId: z.string(),
+    /** Planned project start date. */
+    startDate: z.iso.date().nullable().optional(),
+    /** When work actually started. */
+    startedAt: z.iso.datetime({ offset: true }).nullable().optional(),
+    /** Configured workspace project status. */
+    status: z
+        .looseObject({
+        color: z.string(),
+        id: z.string(),
+        name: z.string(),
+        type: z.string(),
+    })
+        .catchall(z.json())
+        .nullable()
+        .optional(),
+    /** Stable ID of the configured project status. */
+    statusId: z.string(),
+    /** Planned project target date. */
+    targetDate: z.iso.date().nullable().optional(),
+    /** IDs of teams associated with the project. */
+    teamIds: z.string().array(),
+    /** Whether the project is in Linear's recently deleted view. */
+    trashed: z.boolean().nullable().optional(),
+    /** When the project was last updated. */
+    updatedAt: z.iso.datetime({ offset: true }),
+    /** Linear project URL. */
+    url: z.string(),
+})
+    .catchall(z.json());
+const LINEAR_ISSUE_WEBHOOK_EVENT_SCHEMA = LINEAR_WEBHOOK_EVENT_SCHEMA.extend({
+    data: LINEAR_ISSUE_WEBHOOK_DATA_SCHEMA,
+    type: z.literal("Issue"),
+});
+const LINEAR_COMMENT_WEBHOOK_EVENT_SCHEMA = LINEAR_WEBHOOK_EVENT_SCHEMA.extend({
+    data: LINEAR_COMMENT_WEBHOOK_DATA_SCHEMA,
+    type: z.literal("Comment"),
+});
+const LINEAR_PROJECT_WEBHOOK_EVENT_SCHEMA = LINEAR_WEBHOOK_EVENT_SCHEMA.extend({
+    data: LINEAR_PROJECT_WEBHOOK_DATA_SCHEMA,
+    type: z.literal("Project"),
+});
+export const LINEAR_ISSUE_EVENT_SCHEMA = LINEAR_ISSUE_WEBHOOK_DATA_SCHEMA.extend({
+    /** Original provider webhook envelope. */
+    event: LINEAR_ISSUE_WEBHOOK_EVENT_SCHEMA,
+});
+export const LINEAR_COMMENT_EVENT_SCHEMA = LINEAR_COMMENT_WEBHOOK_DATA_SCHEMA.extend({
+    /** Original provider webhook envelope. */
+    event: LINEAR_COMMENT_WEBHOOK_EVENT_SCHEMA,
+});
+export const LINEAR_PROJECT_EVENT_SCHEMA = LINEAR_PROJECT_WEBHOOK_DATA_SCHEMA.extend({
+    /** Original provider webhook envelope. */
+    event: LINEAR_PROJECT_WEBHOOK_EVENT_SCHEMA,
+});
+export const LINEAR_ISSUE_CREATED_EVENT_SCHEMA = LINEAR_ISSUE_EVENT_SCHEMA.extend({
+    event: LINEAR_ISSUE_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("create"),
+    }),
+});
+export const LINEAR_ISSUE_UPDATED_EVENT_SCHEMA = LINEAR_ISSUE_EVENT_SCHEMA.extend({
+    event: LINEAR_ISSUE_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("update"),
+    }),
+});
+export const LINEAR_ISSUE_REMOVED_EVENT_SCHEMA = LINEAR_ISSUE_EVENT_SCHEMA.extend({
+    event: LINEAR_ISSUE_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("remove"),
+    }),
+});
+export const LINEAR_COMMENT_CREATED_EVENT_SCHEMA = LINEAR_COMMENT_EVENT_SCHEMA.extend({
+    event: LINEAR_COMMENT_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("create"),
+    }),
+});
+export const LINEAR_COMMENT_UPDATED_EVENT_SCHEMA = LINEAR_COMMENT_EVENT_SCHEMA.extend({
+    event: LINEAR_COMMENT_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("update"),
+    }),
+});
+export const LINEAR_COMMENT_REMOVED_EVENT_SCHEMA = LINEAR_COMMENT_EVENT_SCHEMA.extend({
+    event: LINEAR_COMMENT_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("remove"),
+    }),
+});
+export const LINEAR_PROJECT_CREATED_EVENT_SCHEMA = LINEAR_PROJECT_EVENT_SCHEMA.extend({
+    event: LINEAR_PROJECT_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("create"),
+    }),
+});
+export const LINEAR_PROJECT_UPDATED_EVENT_SCHEMA = LINEAR_PROJECT_EVENT_SCHEMA.extend({
+    event: LINEAR_PROJECT_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("update"),
+    }),
+});
+export const LINEAR_PROJECT_REMOVED_EVENT_SCHEMA = LINEAR_PROJECT_EVENT_SCHEMA.extend({
+    event: LINEAR_PROJECT_WEBHOOK_EVENT_SCHEMA.extend({
+        action: z.literal("remove"),
+    }),
+});
+export const LINEAR_PAGE_INPUT_SCHEMA = z.object({
+    /** Cursor returned by the previous page. */
+    after: z.string().min(1).optional(),
+    /** Whether archived resources should be included. */
+    includeArchived: z.boolean().optional(),
+    /** Maximum resources in this page. */
+    limit: z.number().int().min(1).max(50).prefault(50),
+});
+export const LINEAR_PAGE_INFO_SCHEMA = z.object({
+    /** Cursor for the next page, when more results are available. */
+    endCursor: z.string().nullable(),
+    /** Whether a later page exists. */
+    hasNextPage: z.boolean(),
+    /** Whether an earlier page exists. */
+    hasPreviousPage: z.boolean(),
+    /** Cursor for the first item in this page. */
+    startCursor: z.string().nullable(),
+});
+export const LINEAR_USER_REFERENCE_SCHEMA = z.object({
+    /** Whether the user can currently access the workspace. */
+    active: z.boolean(),
+    /** User avatar URL. */
+    avatarUrl: z.string().nullable(),
+    /** User-facing display name. */
+    displayName: z.string(),
+    /** Workspace email address. */
+    email: z.string(),
+    /** Stable Linear user ID. */
+    id: z.string(),
+    /** Full user name. */
+    name: z.string(),
+});
+export const LINEAR_ORGANIZATION_SCHEMA = z.object({
+    /** When the workspace was archived, if applicable. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** When the workspace was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Number of issues created in the workspace. */
+    createdIssueCount: z.number().int().nonnegative(),
+    /** Stable Linear workspace ID. */
+    id: z.string(),
+    /** Workspace logo URL. */
+    logoUrl: z.string().nullable(),
+    /** Workspace name. */
+    name: z.string(),
+    /** Whether roadmap features are enabled. */
+    roadmapEnabled: z.boolean(),
+    /** When the workspace was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+    /** URL key used in Linear workspace URLs. */
+    urlKey: z.string(),
+    /** Number of workspace users. */
+    userCount: z.number().int().nonnegative(),
+});
+export const LINEAR_USER_SCHEMA = LINEAR_USER_REFERENCE_SCHEMA.extend({
+    /** Whether this user is a workspace administrator. */
+    admin: z.boolean(),
+    /** When the user was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Whether this identity belongs to a Linear app. */
+    app: z.boolean(),
+    /** When the user joined the workspace. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Whether this user has guest access. */
+    guest: z.boolean(),
+    /** Whether this is the authenticated user. */
+    isMe: z.boolean(),
+    /** Whether this user owns the workspace. */
+    owner: z.boolean(),
+    /** IANA time zone configured for the user. */
+    timezone: z.string().nullable(),
+    /** When the user was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Linear profile URL. */
+    url: z.string(),
+});
+export const LINEAR_TEAM_REFERENCE_SCHEMA = z.object({
+    /** Team name shown in Linear. */
+    displayName: z.string(),
+    /** Stable Linear team ID. */
+    id: z.string(),
+    /** Short issue identifier prefix. */
+    key: z.string(),
+    /** Full team name. */
+    name: z.string(),
+});
+export const LINEAR_TEAM_SCHEMA = LINEAR_TEAM_REFERENCE_SCHEMA.extend({
+    /** When the team was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Team display color. */
+    color: z.string().nullable(),
+    /** When the team was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Whether cycles are enabled. */
+    cyclesEnabled: z.boolean(),
+    /** Default estimate assigned to new issues. */
+    defaultIssueEstimate: z.number(),
+    /** Team description. */
+    description: z.string().nullable(),
+    /** Team icon value. */
+    icon: z.string().nullable(),
+    /** Issue estimate scale used by the team. */
+    issueEstimationType: z.string(),
+    /** Whether membership is restricted. */
+    private: z.boolean(),
+    /** IANA time zone configured for the team. */
+    timezone: z.string(),
+    /** Whether new issues may enter triage. */
+    triageEnabled: z.boolean(),
+    /** When the team was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+});
+export const LINEAR_WORKFLOW_STATE_SCHEMA = z.object({
+    /** When the state was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** State display color. */
+    color: z.string(),
+    /** When the state was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** State description. */
+    description: z.string().nullable(),
+    /** Stable workflow state ID. */
+    id: z.string(),
+    /** Human-readable state name. */
+    name: z.string(),
+    /** Relative ordering within the workflow. */
+    position: z.number(),
+    /** Team that owns the workflow. */
+    team: LINEAR_TEAM_REFERENCE_SCHEMA,
+    /** State category such as `backlog`, `started`, or `completed`. */
+    type: z.string(),
+    /** When the state was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+});
+export const LINEAR_ISSUE_LABEL_SCHEMA = z.object({
+    /** When the label was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Label display color. */
+    color: z.string(),
+    /** When the label was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Label description. */
+    description: z.string().nullable(),
+    /** Stable issue label ID. */
+    id: z.string(),
+    /** Whether this label groups child labels. */
+    isGroup: z.boolean(),
+    /** Human-readable label name. */
+    name: z.string(),
+    /** Parent label, when nested. */
+    parent: z.object({ id: z.string(), name: z.string() }).nullable(),
+    /** Owning team, or `null` for workspace labels. */
+    team: LINEAR_TEAM_REFERENCE_SCHEMA.nullable(),
+    /** When the label was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+});
+export const LINEAR_PROJECT_REFERENCE_SCHEMA = z.object({
+    /** Stable Linear project ID. */
+    id: z.string(),
+    /** Project name. */
+    name: z.string(),
+    /** URL-safe project slug. */
+    slugId: z.string(),
+    /** Linear project URL. */
+    url: z.string(),
+});
+export const LINEAR_ISSUE_REFERENCE_SCHEMA = z.object({
+    /** Stable Linear issue ID. */
+    id: z.string(),
+    /** Human-readable identifier such as `ENG-123`. */
+    identifier: z.string(),
+    /** Issue title. */
+    title: z.string(),
+    /** Linear issue URL. */
+    url: z.string(),
+});
+export const LINEAR_PROJECT_STATUS_SCHEMA = z.object({
+    /** Project status display color. */
+    color: z.string(),
+    /** Status description. */
+    description: z.string().nullable(),
+    /** Stable project status ID. */
+    id: z.string(),
+    /** Human-readable status name. */
+    name: z.string(),
+    /** Project status category. */
+    type: z.string(),
+});
+export const LINEAR_PROJECT_SCHEMA = z.object({
+    /** When the project was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** When the project was canceled, or `null` otherwise. */
+    canceledAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Project display color. */
+    color: z.string(),
+    /** When the project was completed, or `null` otherwise. */
+    completedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Long-form Markdown project content. */
+    content: z.string().nullable(),
+    /** When the project was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** User who created the project. */
+    creator: LINEAR_USER_REFERENCE_SCHEMA.nullable(),
+    /** Short project summary. */
+    description: z.string(),
+    /** Emoji or provider-supported project icon value. */
+    icon: z.string().nullable(),
+    /** Stable Linear project ID. */
+    id: z.string(),
+    /** Human-readable project identifier, when assigned. */
+    identifier: z.string().nullable(),
+    /** Workspace user leading the project. */
+    lead: LINEAR_USER_REFERENCE_SCHEMA.nullable(),
+    /** Project members included in the response. */
+    members: LINEAR_USER_REFERENCE_SCHEMA.array(),
+    /** Project name. */
+    name: z.string(),
+    /** Numeric project priority. */
+    priority: z.number().int(),
+    /** Human-readable project priority. */
+    priorityLabel: z.string(),
+    /** Completion ratio from zero to one. */
+    progress: z.number(),
+    /** Number of attached project resources. */
+    resourceCount: z.number().int().nonnegative(),
+    /** Total estimated project scope. */
+    scope: z.number(),
+    /** URL-safe project slug. */
+    slugId: z.string(),
+    /** Planned project start date. */
+    startDate: z.iso.date().nullable(),
+    /** When work actually started. */
+    startedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Provider-native project lifecycle state. */
+    state: z.string(),
+    /** Configured workspace project status. */
+    status: LINEAR_PROJECT_STATUS_SCHEMA,
+    /** Planned project target date. */
+    targetDate: z.iso.date().nullable(),
+    /** Teams included in the project response. */
+    teams: LINEAR_TEAM_REFERENCE_SCHEMA.array(),
+    /** When the project was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Linear project URL. */
+    url: z.string(),
+});
+export const LINEAR_ISSUE_SCHEMA = z.object({
+    /** When the issue was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** User assigned to the issue. */
+    assignee: LINEAR_USER_REFERENCE_SCHEMA.nullable(),
+    /** Suggested source-control branch name. */
+    branchName: z.string(),
+    /** When the issue was canceled, or `null` otherwise. */
+    canceledAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** When the issue was completed, or `null` otherwise. */
+    completedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** When the issue was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** User who created the issue. */
+    creator: LINEAR_USER_REFERENCE_SCHEMA.nullable(),
+    /** Markdown issue description. */
+    description: z.string().nullable(),
+    /** Issue due date. */
+    dueDate: z.iso.date().nullable(),
+    /** Issue estimate on the team's configured scale. */
+    estimate: z.number().nullable(),
+    /** Stable Linear issue ID. */
+    id: z.string(),
+    /** Human-readable issue identifier such as `ENG-123`. */
+    identifier: z.string(),
+    /** Labels currently applied to the issue. */
+    labels: z
+        .object({
+        /** Label display color. */
+        color: z.string(),
+        /** Stable issue label ID. */
+        id: z.string(),
+        /** Human-readable label name. */
+        name: z.string(),
+    })
+        .array(),
+    /** Numeric portion of the issue identifier. */
+    number: z.number(),
+    /** Parent issue when this is a sub-issue. */
+    parent: LINEAR_ISSUE_REFERENCE_SCHEMA.nullable(),
+    /** Numeric priority from zero to four. */
+    priority: z.number(),
+    /** Human-readable issue priority. */
+    priorityLabel: z.string(),
+    /** Project containing the issue. */
+    project: LINEAR_PROJECT_REFERENCE_SCHEMA.nullable(),
+    /** When work began, or `null` if not started. */
+    startedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Current workflow state. */
+    state: z.object({
+        /** Workflow state display color. */
+        color: z.string(),
+        /** Stable workflow state ID. */
+        id: z.string(),
+        /** Human-readable workflow state name. */
+        name: z.string(),
+        /** State category such as `started` or `completed`. */
+        type: z.string(),
+    }),
+    /** Team that owns the issue. */
+    team: LINEAR_TEAM_REFERENCE_SCHEMA,
+    /** Issue title. */
+    title: z.string(),
+    /** Whether the issue is in Linear's recently deleted view. */
+    trashed: z.boolean().nullable(),
+    /** When the issue was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Linear issue URL. */
+    url: z.string(),
+});
+export const LINEAR_COMMENT_SCHEMA = z.object({
+    /** When the comment was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Markdown comment body. */
+    body: z.string(),
+    /** When the comment was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** When the body was last edited. */
+    editedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** Stable Linear comment ID. */
+    id: z.string(),
+    /** Parent issue ID when this is an issue comment. */
+    issueId: z.string().nullable(),
+    /** Parent comment ID when this is a threaded reply. */
+    parentId: z.string().nullable(),
+    /** When the comment thread was resolved. */
+    resolvedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** When the comment was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Linear comment URL. */
+    url: z.string(),
+    /** Workspace user who authored the comment. */
+    user: LINEAR_USER_REFERENCE_SCHEMA.nullable(),
+});
+export const LINEAR_ATTACHMENT_SCHEMA = z.object({
+    /** When the attachment was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** When the attachment was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Workspace user who created the attachment. */
+    creator: LINEAR_USER_REFERENCE_SCHEMA.nullable(),
+    /** Whether Linear groups attachments from this source. */
+    groupBySource: z.boolean(),
+    /** Stable Linear attachment ID. */
+    id: z.string(),
+    /** Issue containing the attachment. */
+    issue: LINEAR_ISSUE_REFERENCE_SCHEMA,
+    /** Integration-defined attachment metadata. */
+    metadata: LINEAR_JSON_OBJECT_SCHEMA,
+    /** Provider-defined source classification. */
+    sourceType: z.string().nullable(),
+    /** Secondary attachment status or detail. */
+    subtitle: z.string().nullable(),
+    /** Attachment title. */
+    title: z.string(),
+    /** When the attachment was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Unique external attachment URL. */
+    url: z.string(),
+});
+export const LINEAR_ISSUE_RELATION_SCHEMA = z.object({
+    /** When the relation was archived, or `null` while active. */
+    archivedAt: LINEAR_DATE_TIME_SCHEMA.nullable(),
+    /** When the relation was created. */
+    createdAt: LINEAR_DATE_TIME_SCHEMA,
+    /** Stable Linear relation ID. */
+    id: z.string(),
+    /** Issue on the source side of the relation. */
+    issue: LINEAR_ISSUE_REFERENCE_SCHEMA,
+    /** Issue on the target side of the relation. */
+    relatedIssue: LINEAR_ISSUE_REFERENCE_SCHEMA,
+    /** Relation type such as `blocks`, `duplicate`, or `related`. */
+    type: z.string(),
+    /** When the relation was last updated. */
+    updatedAt: LINEAR_DATE_TIME_SCHEMA,
+});
+export const LINEAR_PROVIDER_PROJECT_SCHEMA = LINEAR_PROJECT_SCHEMA.omit({
+    members: true,
+    teams: true,
+}).extend({
+    members: linearConnectionSchema(LINEAR_USER_REFERENCE_SCHEMA),
+    teams: linearConnectionSchema(LINEAR_TEAM_REFERENCE_SCHEMA),
+});
+export const LINEAR_PROVIDER_ISSUE_SCHEMA = LINEAR_ISSUE_SCHEMA.omit({
+    labels: true,
+}).extend({
+    labels: linearConnectionSchema(z.object({ color: z.string(), id: z.string(), name: z.string() })),
+});
+/**
+ * Normalizes Linear's nested project connections into direct arrays.
+ *
+ * @param project - Provider-native project response.
+ */
+export function toLinearProject(project) {
+    return {
+        ...project,
+        members: project.members.nodes,
+        teams: project.teams.nodes,
+    };
+}
+/**
+ * Normalizes Linear's nested label connection into a direct array.
+ *
+ * @param issue - Provider-native issue response.
+ */
+export function toLinearIssue(issue) {
+    return { ...issue, labels: issue.labels.nodes };
+}
+/**
+ * Creates a schema for one provider-native Linear connection.
+ *
+ * @param itemSchema - Schema for one connection node.
+ */
+export function linearConnectionSchema(itemSchema) {
+    return z.object({
+        nodes: itemSchema.array(),
+        pageInfo: LINEAR_PAGE_INFO_SCHEMA.optional(),
+    });
+}