feat: add workspace-level API resources [INFRA-396] (#46)

Mirrors the workspace-level resources from INFRA-394 (Python SDK) into
the Node SDK. Adds 7 resource groups, all registered on PlaneClient
and exported from the package index.

New resources:
- WorkspaceTemplates — workspace work item, project, and page templates (list, create, update, del)
- WorkspaceWorkItemTypes — list, create, update + properties sub-resource (list, create, del)
- WorkspaceWorkItemProperties — list, create, update, del + options sub-resource (list, create, update)
- WorkspaceProjectLabels — list, create, update, del
- WorkspaceProjectStates — list, create, update, del
- WorkItemRelationDefinitions — list (?is_default, ?is_active), create, update, del
- Releases — list, create, update + tags, labels, itemLabels sub-resources

New models:
- WorkspaceTemplate.ts (WorkspaceWorkItemTemplate, WorkspaceProjectTemplate, WorkspacePageTemplate)
- WorkspaceProjectLabel.ts, WorkspaceProjectState.ts
- WorkItemRelationDefinition.ts
- Release.ts (Release, ReleaseTag, ReleaseLabel, AddReleaseItemLabel)
- WorkspaceWorkItemTypePropertyLink added to WorkItemType.ts

Unit tests added for all resources. README updated.

Co-authored-by: Plane AI <noreply@plane.so>

Author: mguptahub

README.md

@@ -76,6 +76,13 @@ const project = await client.projects.create("workspace-slug", {
 - **Teamspaces**: Teamspace management
 - **Milestones**: Milestone tracking and management
 - **Initiatives**: Initiative management
+- **WorkspaceTemplates**: Workspace-level work item, project, and page templates
+- **WorkspaceWorkItemTypes**: Workspace-level work item type management with property links
+- **WorkspaceWorkItemProperties**: Workspace-level custom property management with options
+- **WorkspaceProjectLabels**: Workspace-level project label management
+- **WorkspaceProjectStates**: Workspace-level project state management
+- **WorkItemRelationDefinitions**: Custom work item relation type definitions
+- **Releases**: Release management with tags, labels, and item label assignment
 - **AgentRuns**: AI agent run orchestration and activity tracking
 - **Workflows**: Project workflow management with state attachments and transitions
 - **ProjectTemplates**: Work item and page template management per project

src/api/Releases/ItemLabels.ts

@@ -0,0 +1,32 @@
+import { BaseResource } from "../BaseResource";
+import { Configuration } from "../../Configuration";
+import { AddReleaseItemLabel, ReleaseLabel } from "../../models/Release";
+
+/**
+ * ReleaseItemLabels sub-resource
+ * Manages labels assigned to a specific release
+ */
+export class ItemLabels extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(workspaceSlug: string, releaseId: string): Promise<ReleaseLabel[]> {
+    const data = await this.get<ReleaseLabel[] | { results: ReleaseLabel[] }>(
+      `/workspaces/${workspaceSlug}/releases/${releaseId}/labels/`
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, releaseId: string, data: AddReleaseItemLabel): Promise<ReleaseLabel[]> {
+    const result = await this.post<ReleaseLabel[] | { results: ReleaseLabel[] }>(
+      `/workspaces/${workspaceSlug}/releases/${releaseId}/labels/`,
+      data
+    );
+    return Array.isArray(result) ? result : result.results;
+  }
+
+  async del(workspaceSlug: string, releaseId: string, labelId: string): Promise<void> {
+    return this.httpDelete(`/workspaces/${workspaceSlug}/releases/${releaseId}/labels/${labelId}/`);
+  }
+}

src/api/Releases/Labels.ts

@@ -0,0 +1,24 @@
+import { BaseResource } from "../BaseResource";
+import { Configuration } from "../../Configuration";
+import { CreateReleaseLabel, ReleaseLabel } from "../../models/Release";
+
+/**
+ * ReleaseLabels sub-resource
+ * Manages release labels at the workspace level
+ */
+export class Labels extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(workspaceSlug: string): Promise<ReleaseLabel[]> {
+    const data = await this.get<ReleaseLabel[] | { results: ReleaseLabel[] }>(
+      `/workspaces/${workspaceSlug}/releases/labels/`
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateReleaseLabel): Promise<ReleaseLabel> {
+    return this.post<ReleaseLabel>(`/workspaces/${workspaceSlug}/releases/labels/`, data);
+  }
+}

src/api/Releases/Tags.ts

@@ -0,0 +1,24 @@
+import { BaseResource } from "../BaseResource";
+import { Configuration } from "../../Configuration";
+import { CreateReleaseTag, ReleaseTag } from "../../models/Release";
+
+/**
+ * ReleaseTags sub-resource
+ * Manages release tags at the workspace level
+ */
+export class Tags extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(workspaceSlug: string): Promise<ReleaseTag[]> {
+    const data = await this.get<ReleaseTag[] | { results: ReleaseTag[] }>(
+      `/workspaces/${workspaceSlug}/releases/tags/`
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateReleaseTag): Promise<ReleaseTag> {
+    return this.post<ReleaseTag>(`/workspaces/${workspaceSlug}/releases/tags/`, data);
+  }
+}

src/api/Releases/index.ts

@@ -0,0 +1,36 @@
+import { BaseResource } from "../BaseResource";
+import { Configuration } from "../../Configuration";
+import { CreateRelease, Release, UpdateRelease } from "../../models/Release";
+import { Tags } from "./Tags";
+import { Labels } from "./Labels";
+import { ItemLabels } from "./ItemLabels";
+
+/**
+ * Releases API resource
+ * Manages releases at the workspace level with tags, labels, and item-label sub-resources
+ */
+export class Releases extends BaseResource {
+  public tags: Tags;
+  public labels: Labels;
+  public itemLabels: ItemLabels;
+
+  constructor(config: Configuration) {
+    super(config);
+    this.tags = new Tags(config);
+    this.labels = new Labels(config);
+    this.itemLabels = new ItemLabels(config);
+  }
+
+  async list(workspaceSlug: string): Promise<Release[]> {
+    const data = await this.get<Release[] | { results: Release[] }>(`/workspaces/${workspaceSlug}/releases/`);
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateRelease): Promise<Release> {
+    return this.post<Release>(`/workspaces/${workspaceSlug}/releases/`, data);
+  }
+
+  async update(workspaceSlug: string, releaseId: string, data: UpdateRelease): Promise<Release> {
+    return this.patch<Release>(`/workspaces/${workspaceSlug}/releases/${releaseId}/`, data);
+  }
+}

src/api/WorkItemRelationDefinitions.ts

@@ -0,0 +1,52 @@
+import { BaseResource } from "./BaseResource";
+import { Configuration } from "../Configuration";
+import {
+  CreateWorkItemRelationDefinition,
+  ListWorkItemRelationDefinitionsParams,
+  UpdateWorkItemRelationDefinition,
+  WorkItemRelationDefinition,
+} from "../models/WorkItemRelationDefinition";
+
+/**
+ * WorkItemRelationDefinitions API resource
+ * Manages work item relation definitions at the workspace level
+ */
+export class WorkItemRelationDefinitions extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(
+    workspaceSlug: string,
+    params?: ListWorkItemRelationDefinitionsParams
+  ): Promise<WorkItemRelationDefinition[]> {
+    const query: Record<string, string> = {};
+    if (params?.is_default !== undefined) query["is_default"] = String(params.is_default);
+    if (params?.is_active !== undefined) query["is_active"] = String(params.is_active);
+
+    const data = await this.get<WorkItemRelationDefinition[] | { results: WorkItemRelationDefinition[] }>(
+      `/workspaces/${workspaceSlug}/work-item-relation-definitions/`,
+      Object.keys(query).length ? query : undefined
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateWorkItemRelationDefinition): Promise<WorkItemRelationDefinition> {
+    return this.post<WorkItemRelationDefinition>(`/workspaces/${workspaceSlug}/work-item-relation-definitions/`, data);
+  }
+
+  async update(
+    workspaceSlug: string,
+    definitionId: string,
+    data: UpdateWorkItemRelationDefinition
+  ): Promise<WorkItemRelationDefinition> {
+    return this.patch<WorkItemRelationDefinition>(
+      `/workspaces/${workspaceSlug}/work-item-relation-definitions/${definitionId}/`,
+      data
+    );
+  }
+
+  async del(workspaceSlug: string, definitionId: string): Promise<void> {
+    return this.httpDelete(`/workspaces/${workspaceSlug}/work-item-relation-definitions/${definitionId}/`);
+  }
+}

src/api/WorkspaceProjectLabels.ts

@@ -0,0 +1,40 @@
+import { BaseResource } from "./BaseResource";
+import { Configuration } from "../Configuration";
+import {
+  CreateWorkspaceProjectLabel,
+  UpdateWorkspaceProjectLabel,
+  WorkspaceProjectLabel,
+} from "../models/WorkspaceProjectLabel";
+
+/**
+ * WorkspaceProjectLabels API resource
+ * Manages project labels at the workspace level
+ */
+export class WorkspaceProjectLabels extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(workspaceSlug: string): Promise<WorkspaceProjectLabel[]> {
+    const data = await this.get<WorkspaceProjectLabel[] | { results: WorkspaceProjectLabel[] }>(
+      `/workspaces/${workspaceSlug}/project-labels/`
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateWorkspaceProjectLabel): Promise<WorkspaceProjectLabel> {
+    return this.post<WorkspaceProjectLabel>(`/workspaces/${workspaceSlug}/project-labels/`, data);
+  }
+
+  async update(
+    workspaceSlug: string,
+    labelId: string,
+    data: UpdateWorkspaceProjectLabel
+  ): Promise<WorkspaceProjectLabel> {
+    return this.patch<WorkspaceProjectLabel>(`/workspaces/${workspaceSlug}/project-labels/${labelId}/`, data);
+  }
+
+  async del(workspaceSlug: string, labelId: string): Promise<void> {
+    return this.httpDelete(`/workspaces/${workspaceSlug}/project-labels/${labelId}/`);
+  }
+}

src/api/WorkspaceProjectStates.ts

@@ -0,0 +1,40 @@
+import { BaseResource } from "./BaseResource";
+import { Configuration } from "../Configuration";
+import {
+  CreateWorkspaceProjectState,
+  UpdateWorkspaceProjectState,
+  WorkspaceProjectState,
+} from "../models/WorkspaceProjectState";
+
+/**
+ * WorkspaceProjectStates API resource
+ * Manages project states at the workspace level
+ */
+export class WorkspaceProjectStates extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(workspaceSlug: string): Promise<WorkspaceProjectState[]> {
+    const data = await this.get<WorkspaceProjectState[] | { results: WorkspaceProjectState[] }>(
+      `/workspaces/${workspaceSlug}/project-states/`
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateWorkspaceProjectState): Promise<WorkspaceProjectState> {
+    return this.post<WorkspaceProjectState>(`/workspaces/${workspaceSlug}/project-states/`, data);
+  }
+
+  async update(
+    workspaceSlug: string,
+    stateId: string,
+    data: UpdateWorkspaceProjectState
+  ): Promise<WorkspaceProjectState> {
+    return this.patch<WorkspaceProjectState>(`/workspaces/${workspaceSlug}/project-states/${stateId}/`, data);
+  }
+
+  async del(workspaceSlug: string, stateId: string): Promise<void> {
+    return this.httpDelete(`/workspaces/${workspaceSlug}/project-states/${stateId}/`);
+  }
+}

src/api/WorkspaceTemplates/Pages.ts

@@ -0,0 +1,40 @@
+import { BaseResource } from "../BaseResource";
+import { Configuration } from "../../Configuration";
+import {
+  CreateWorkspacePageTemplate,
+  UpdateWorkspacePageTemplate,
+  WorkspacePageTemplate,
+} from "../../models/WorkspaceTemplate";
+
+/**
+ * WorkspacePageTemplates sub-resource
+ * Manages page templates at the workspace level
+ */
+export class Pages extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(workspaceSlug: string): Promise<WorkspacePageTemplate[]> {
+    const data = await this.get<WorkspacePageTemplate[] | { results: WorkspacePageTemplate[] }>(
+      `/workspaces/${workspaceSlug}/pages/templates/`
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateWorkspacePageTemplate): Promise<WorkspacePageTemplate> {
+    return this.post<WorkspacePageTemplate>(`/workspaces/${workspaceSlug}/pages/templates/`, data);
+  }
+
+  async update(
+    workspaceSlug: string,
+    templateId: string,
+    data: UpdateWorkspacePageTemplate
+  ): Promise<WorkspacePageTemplate> {
+    return this.patch<WorkspacePageTemplate>(`/workspaces/${workspaceSlug}/pages/templates/${templateId}/`, data);
+  }
+
+  async del(workspaceSlug: string, templateId: string): Promise<void> {
+    return this.httpDelete(`/workspaces/${workspaceSlug}/pages/templates/${templateId}/`);
+  }
+}

src/api/WorkspaceTemplates/Projects.ts

@@ -0,0 +1,40 @@
+import { BaseResource } from "../BaseResource";
+import { Configuration } from "../../Configuration";
+import {
+  CreateWorkspaceProjectTemplate,
+  UpdateWorkspaceProjectTemplate,
+  WorkspaceProjectTemplate,
+} from "../../models/WorkspaceTemplate";
+
+/**
+ * WorkspaceProjectTemplates sub-resource
+ * Manages project templates at the workspace level
+ */
+export class Projects extends BaseResource {
+  constructor(config: Configuration) {
+    super(config);
+  }
+
+  async list(workspaceSlug: string): Promise<WorkspaceProjectTemplate[]> {
+    const data = await this.get<WorkspaceProjectTemplate[] | { results: WorkspaceProjectTemplate[] }>(
+      `/workspaces/${workspaceSlug}/projects/templates/`
+    );
+    return Array.isArray(data) ? data : data.results;
+  }
+
+  async create(workspaceSlug: string, data: CreateWorkspaceProjectTemplate): Promise<WorkspaceProjectTemplate> {
+    return this.post<WorkspaceProjectTemplate>(`/workspaces/${workspaceSlug}/projects/templates/`, data);
+  }
+
+  async update(
+    workspaceSlug: string,
+    templateId: string,
+    data: UpdateWorkspaceProjectTemplate
+  ): Promise<WorkspaceProjectTemplate> {
+    return this.patch<WorkspaceProjectTemplate>(`/workspaces/${workspaceSlug}/projects/templates/${templateId}/`, data);
+  }
+
+  async del(workspaceSlug: string, templateId: string): Promise<void> {
+    return this.httpDelete(`/workspaces/${workspaceSlug}/projects/templates/${templateId}/`);
+  }
+}