@air/api-rest 0.1.3 → 0.3.0

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   CustomFields: () => CustomFields,
   Imports: () => Imports,
   InternalServerError: () => import_api_core2.InternalServerError,
+  Libraries: () => Libraries,
   NotFoundError: () => import_api_core2.NotFoundError,
   PagePromise: () => import_api_core2.PagePromise,
   PermissionError: () => import_api_core2.PermissionError,
@@ -50,7 +51,11 @@ __export(index_exports, {
   Tags: () => Tags,
   TimeoutError: () => import_api_core2.TimeoutError,
   Uploads: () => Uploads,
-  VERSION: () => import_api_core2.VERSION
+  VERSION: () => import_api_core2.VERSION,
+  Workspaces: () => Workspaces,
+  buildAuthorizationUrl: () => import_api_core2.buildAuthorizationUrl,
+  exchangeAuthorizationCode: () => import_api_core2.exchangeAuthorizationCode,
+  generatePKCEChallenge: () => import_api_core2.generatePKCEChallenge
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -168,7 +173,9 @@ var Boards = class {
       limit: params.limit,
       cursor: params.cursor,
       name: params.name,
-      parentBoardId: params.parentBoardId
+      parentBoardId: params.parentBoardId,
+      libraryId: params.libraryId,
+      inGeneralLibrary: params.inGeneralLibrary
     };
     if (params.customField) {
       query.customField = params.customField;
@@ -334,6 +341,50 @@ var Imports = class {
   }
 };
 
+// src/resources/libraries.ts
+var Libraries = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params = {}) {
+    const query = {
+      limit: params.limit,
+      cursor: params.cursor,
+      search: params.search
+    };
+    return this.client.requestCursorPage(
+      { method: "GET", path: "/libraries", query },
+      query
+    );
+  }
+  async get(libraryId) {
+    return this.client.request({
+      method: "GET",
+      path: `/libraries/${libraryId}`
+    });
+  }
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/libraries",
+      body: params
+    });
+  }
+  async update(libraryId, params) {
+    return this.client.request({
+      method: "PATCH",
+      path: `/libraries/${libraryId}`,
+      body: params
+    });
+  }
+  async delete(libraryId) {
+    return this.client.request({
+      method: "DELETE",
+      path: `/libraries/${libraryId}`
+    });
+  }
+};
+
 // src/resources/roles.ts
 var Roles = class {
   constructor(client) {
@@ -620,24 +671,42 @@ function guessMime(ext) {
   return mimeMap[ext.toLowerCase()] ?? "application/octet-stream";
 }
 
+// src/resources/workspaces.ts
+var Workspaces = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    const response = await this.client.request({
+      method: "GET",
+      path: "/workspaces"
+    });
+    return response.data;
+  }
+};
+
 // src/api.ts
 var AirApi = class extends import_api_core.AirBase {
   assets;
   boards;
+  libraries;
   tags;
   customFields;
   roles;
   imports;
   uploads;
+  workspaces;
   constructor(options = {}) {
     super(options);
     this.assets = new Assets(this);
     this.boards = new Boards(this);
+    this.libraries = new Libraries(this);
     this.tags = new Tags(this);
     this.customFields = new CustomFields(this);
     this.roles = new Roles(this);
     this.imports = new Imports(this);
     this.uploads = new Uploads(this);
+    this.workspaces = new Workspaces(this);
   }
 };
 
@@ -657,6 +726,7 @@ var import_api_core2 = require("@air/api-core");
   CustomFields,
   Imports,
   InternalServerError,
+  Libraries,
   NotFoundError,
   PagePromise,
   PermissionError,
@@ -665,5 +735,9 @@ var import_api_core2 = require("@air/api-core");
   Tags,
   TimeoutError,
   Uploads,
-  VERSION
+  VERSION,
+  Workspaces,
+  buildAuthorizationUrl,
+  exchangeAuthorizationCode,
+  generatePKCEChallenge
 });

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { CursorPageParams, AirBase, PagePromise, AirBaseOptions } from '@air/api-core';
-export { APIError, AirBase, AirBaseOptions, AuthenticationError, BadRequestError, ConnectionError, CursorPage, CursorPageParams, CursorPageResponse, InternalServerError, NotFoundError, PagePromise, PermissionError, RateLimitError, RequestOptions, TimeoutError, VERSION } from '@air/api-core';
+export { APIError, AirBase, AirBaseOptions, AuthenticationError, BadRequestError, BuildAuthorizationUrlOptions, ConnectionError, CursorPage, CursorPageParams, CursorPageResponse, ExchangeAuthorizationCodeOptions, InternalServerError, NotFoundError, OAuthAccessToken, OAuthClientAuthMethod, PKCEChallenge, PagePromise, PermissionError, RateLimitError, RequestOptions, TimeoutError, VERSION, buildAuthorizationUrl, exchangeAuthorizationCode, generatePKCEChallenge } from '@air/api-core';
 
 interface Tag {
     id: string;
@@ -102,6 +102,17 @@ interface BoardListParams extends CursorPageParams {
     name?: string;
     parentBoardId?: string;
     customField?: string | string[];
+    /**
+     * Only return boards in this library. Mutually exclusive with
+     * `inGeneralLibrary` — passing both results in a `400` (BadRequestError).
+     */
+    libraryId?: string;
+    /**
+     * Only return boards in the General library (boards not in any real library).
+     * Mutually exclusive with `libraryId` — passing both results in a `400`
+     * (BadRequestError).
+     */
+    inGeneralLibrary?: boolean;
 }
 interface BoardCreateParams {
     title: string;
@@ -264,6 +275,41 @@ declare class Imports {
     getStatus(importId: string): Promise<ImportStatusResponse>;
 }
 
+interface Library {
+    id: string;
+    title: string;
+    accessibility: "public" | "private";
+    visibility: "workspaceMembers" | "libraryMembers";
+    createdAt: string;
+    updatedAt: string;
+    description?: string;
+}
+interface LibraryListParams extends CursorPageParams {
+    search?: string;
+}
+interface LibraryCreateParams {
+    title: string;
+    description?: string;
+    accessibility?: "public" | "private";
+    visibility?: "workspaceMembers" | "libraryMembers";
+}
+interface LibraryUpdateParams {
+    title?: string;
+    description?: string | null;
+    accessibility?: "public" | "private";
+    visibility?: "workspaceMembers" | "libraryMembers";
+}
+
+declare class Libraries {
+    private client;
+    constructor(client: AirBase);
+    list(params?: LibraryListParams): PagePromise<Library>;
+    get(libraryId: string): Promise<Library>;
+    create(params: LibraryCreateParams): Promise<Library>;
+    update(libraryId: string, params: LibraryUpdateParams): Promise<void>;
+    delete(libraryId: string): Promise<void>;
+}
+
 interface Role {
     id: string;
     name: string;
@@ -401,17 +447,33 @@ declare class Uploads {
     private _uploadLargeFile;
 }
 
+interface Workspace {
+    id: string;
+    name: string;
+}
+interface WorkspaceListResponse {
+    data: Workspace[];
+}
+
+declare class Workspaces {
+    private client;
+    constructor(client: AirBase);
+    list(): Promise<Workspace[]>;
+}
+
 interface AirApiOptions extends AirBaseOptions {
 }
 declare class AirApi extends AirBase {
     readonly assets: Assets;
     readonly boards: Boards;
+    readonly libraries: Libraries;
     readonly tags: Tags;
     readonly customFields: CustomFields;
     readonly roles: Roles;
     readonly imports: Imports;
     readonly uploads: Uploads;
+    readonly workspaces: Workspaces;
     constructor(options?: AirApiOptions);
 }
 
-export { type AddBoardAssetsParams, type AddGuestParams, type AddVersionTagParams, AirApi, type AirApiOptions, type Asset, type AssetBoardListParams, type AssetCustomFieldValue, type AssetListParams, type AssetVersion, type AssetVersionDownloadUrl, type AssetVersionListResponse, type AssetVersionUpdateParams, type AssetVersionUrls, Assets, type Board, type BoardCreateParams, type BoardListParams, type BoardUpdateParams, Boards, type CompleteMultipartParams, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldType, type CustomFieldUpdateParams, type CustomFieldValue, type CustomFieldValueCreateParams, type CustomFieldValueUpdateParams, CustomFields, type FileMeta, type FileSource, type GetPartUploadUrlParams, type GetPartUploadUrlResponse, type Guest, type GuestListParams, type GuestListResponse, type ImportCreateParams, type ImportCreateResponse, type ImportStatus, type ImportStatusResponse, Imports, type LargeUploadResponse, type Role, type RoleListParams, type RoleListResponse, Roles, type SetBoardCustomFieldParams, type SetCustomFieldParams, type SmallUploadResponse, type SmartTag, type Tag, type TagCreateParams, type TagListParams, type TagUpdateParams, Tags, type UpdateGuestParams, type UploadCreateParams, type UploadCreateResponse, type UploadFileOptions, type UploadFileParams, type UploadFileResponse, Uploads };
+export { type AddBoardAssetsParams, type AddGuestParams, type AddVersionTagParams, AirApi, type AirApiOptions, type Asset, type AssetBoardListParams, type AssetCustomFieldValue, type AssetListParams, type AssetVersion, type AssetVersionDownloadUrl, type AssetVersionListResponse, type AssetVersionUpdateParams, type AssetVersionUrls, Assets, type Board, type BoardCreateParams, type BoardListParams, type BoardUpdateParams, Boards, type CompleteMultipartParams, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldType, type CustomFieldUpdateParams, type CustomFieldValue, type CustomFieldValueCreateParams, type CustomFieldValueUpdateParams, CustomFields, type FileMeta, type FileSource, type GetPartUploadUrlParams, type GetPartUploadUrlResponse, type Guest, type GuestListParams, type GuestListResponse, type ImportCreateParams, type ImportCreateResponse, type ImportStatus, type ImportStatusResponse, Imports, type LargeUploadResponse, Libraries, type Library, type LibraryCreateParams, type LibraryListParams, type LibraryUpdateParams, type Role, type RoleListParams, type RoleListResponse, Roles, type SetBoardCustomFieldParams, type SetCustomFieldParams, type SmallUploadResponse, type SmartTag, type Tag, type TagCreateParams, type TagListParams, type TagUpdateParams, Tags, type UpdateGuestParams, type UploadCreateParams, type UploadCreateResponse, type UploadFileOptions, type UploadFileParams, type UploadFileResponse, Uploads, type Workspace, type WorkspaceListResponse, Workspaces };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { CursorPageParams, AirBase, PagePromise, AirBaseOptions } from '@air/api-core';
-export { APIError, AirBase, AirBaseOptions, AuthenticationError, BadRequestError, ConnectionError, CursorPage, CursorPageParams, CursorPageResponse, InternalServerError, NotFoundError, PagePromise, PermissionError, RateLimitError, RequestOptions, TimeoutError, VERSION } from '@air/api-core';
+export { APIError, AirBase, AirBaseOptions, AuthenticationError, BadRequestError, BuildAuthorizationUrlOptions, ConnectionError, CursorPage, CursorPageParams, CursorPageResponse, ExchangeAuthorizationCodeOptions, InternalServerError, NotFoundError, OAuthAccessToken, OAuthClientAuthMethod, PKCEChallenge, PagePromise, PermissionError, RateLimitError, RequestOptions, TimeoutError, VERSION, buildAuthorizationUrl, exchangeAuthorizationCode, generatePKCEChallenge } from '@air/api-core';
 
 interface Tag {
     id: string;
@@ -102,6 +102,17 @@ interface BoardListParams extends CursorPageParams {
     name?: string;
     parentBoardId?: string;
     customField?: string | string[];
+    /**
+     * Only return boards in this library. Mutually exclusive with
+     * `inGeneralLibrary` — passing both results in a `400` (BadRequestError).
+     */
+    libraryId?: string;
+    /**
+     * Only return boards in the General library (boards not in any real library).
+     * Mutually exclusive with `libraryId` — passing both results in a `400`
+     * (BadRequestError).
+     */
+    inGeneralLibrary?: boolean;
 }
 interface BoardCreateParams {
     title: string;
@@ -264,6 +275,41 @@ declare class Imports {
     getStatus(importId: string): Promise<ImportStatusResponse>;
 }
 
+interface Library {
+    id: string;
+    title: string;
+    accessibility: "public" | "private";
+    visibility: "workspaceMembers" | "libraryMembers";
+    createdAt: string;
+    updatedAt: string;
+    description?: string;
+}
+interface LibraryListParams extends CursorPageParams {
+    search?: string;
+}
+interface LibraryCreateParams {
+    title: string;
+    description?: string;
+    accessibility?: "public" | "private";
+    visibility?: "workspaceMembers" | "libraryMembers";
+}
+interface LibraryUpdateParams {
+    title?: string;
+    description?: string | null;
+    accessibility?: "public" | "private";
+    visibility?: "workspaceMembers" | "libraryMembers";
+}
+
+declare class Libraries {
+    private client;
+    constructor(client: AirBase);
+    list(params?: LibraryListParams): PagePromise<Library>;
+    get(libraryId: string): Promise<Library>;
+    create(params: LibraryCreateParams): Promise<Library>;
+    update(libraryId: string, params: LibraryUpdateParams): Promise<void>;
+    delete(libraryId: string): Promise<void>;
+}
+
 interface Role {
     id: string;
     name: string;
@@ -401,17 +447,33 @@ declare class Uploads {
     private _uploadLargeFile;
 }
 
+interface Workspace {
+    id: string;
+    name: string;
+}
+interface WorkspaceListResponse {
+    data: Workspace[];
+}
+
+declare class Workspaces {
+    private client;
+    constructor(client: AirBase);
+    list(): Promise<Workspace[]>;
+}
+
 interface AirApiOptions extends AirBaseOptions {
 }
 declare class AirApi extends AirBase {
     readonly assets: Assets;
     readonly boards: Boards;
+    readonly libraries: Libraries;
     readonly tags: Tags;
     readonly customFields: CustomFields;
     readonly roles: Roles;
     readonly imports: Imports;
     readonly uploads: Uploads;
+    readonly workspaces: Workspaces;
     constructor(options?: AirApiOptions);
 }
 
-export { type AddBoardAssetsParams, type AddGuestParams, type AddVersionTagParams, AirApi, type AirApiOptions, type Asset, type AssetBoardListParams, type AssetCustomFieldValue, type AssetListParams, type AssetVersion, type AssetVersionDownloadUrl, type AssetVersionListResponse, type AssetVersionUpdateParams, type AssetVersionUrls, Assets, type Board, type BoardCreateParams, type BoardListParams, type BoardUpdateParams, Boards, type CompleteMultipartParams, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldType, type CustomFieldUpdateParams, type CustomFieldValue, type CustomFieldValueCreateParams, type CustomFieldValueUpdateParams, CustomFields, type FileMeta, type FileSource, type GetPartUploadUrlParams, type GetPartUploadUrlResponse, type Guest, type GuestListParams, type GuestListResponse, type ImportCreateParams, type ImportCreateResponse, type ImportStatus, type ImportStatusResponse, Imports, type LargeUploadResponse, type Role, type RoleListParams, type RoleListResponse, Roles, type SetBoardCustomFieldParams, type SetCustomFieldParams, type SmallUploadResponse, type SmartTag, type Tag, type TagCreateParams, type TagListParams, type TagUpdateParams, Tags, type UpdateGuestParams, type UploadCreateParams, type UploadCreateResponse, type UploadFileOptions, type UploadFileParams, type UploadFileResponse, Uploads };
+export { type AddBoardAssetsParams, type AddGuestParams, type AddVersionTagParams, AirApi, type AirApiOptions, type Asset, type AssetBoardListParams, type AssetCustomFieldValue, type AssetListParams, type AssetVersion, type AssetVersionDownloadUrl, type AssetVersionListResponse, type AssetVersionUpdateParams, type AssetVersionUrls, Assets, type Board, type BoardCreateParams, type BoardListParams, type BoardUpdateParams, Boards, type CompleteMultipartParams, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldType, type CustomFieldUpdateParams, type CustomFieldValue, type CustomFieldValueCreateParams, type CustomFieldValueUpdateParams, CustomFields, type FileMeta, type FileSource, type GetPartUploadUrlParams, type GetPartUploadUrlResponse, type Guest, type GuestListParams, type GuestListResponse, type ImportCreateParams, type ImportCreateResponse, type ImportStatus, type ImportStatusResponse, Imports, type LargeUploadResponse, Libraries, type Library, type LibraryCreateParams, type LibraryListParams, type LibraryUpdateParams, type Role, type RoleListParams, type RoleListResponse, Roles, type SetBoardCustomFieldParams, type SetCustomFieldParams, type SmallUploadResponse, type SmartTag, type Tag, type TagCreateParams, type TagListParams, type TagUpdateParams, Tags, type UpdateGuestParams, type UploadCreateParams, type UploadCreateResponse, type UploadFileOptions, type UploadFileParams, type UploadFileResponse, Uploads, type Workspace, type WorkspaceListResponse, Workspaces };

package/dist/index.js

@@ -112,7 +112,9 @@ var Boards = class {
       limit: params.limit,
       cursor: params.cursor,
       name: params.name,
-      parentBoardId: params.parentBoardId
+      parentBoardId: params.parentBoardId,
+      libraryId: params.libraryId,
+      inGeneralLibrary: params.inGeneralLibrary
     };
     if (params.customField) {
       query.customField = params.customField;
@@ -278,6 +280,50 @@ var Imports = class {
   }
 };
 
+// src/resources/libraries.ts
+var Libraries = class {
+  constructor(client) {
+    this.client = client;
+  }
+  list(params = {}) {
+    const query = {
+      limit: params.limit,
+      cursor: params.cursor,
+      search: params.search
+    };
+    return this.client.requestCursorPage(
+      { method: "GET", path: "/libraries", query },
+      query
+    );
+  }
+  async get(libraryId) {
+    return this.client.request({
+      method: "GET",
+      path: `/libraries/${libraryId}`
+    });
+  }
+  async create(params) {
+    return this.client.request({
+      method: "POST",
+      path: "/libraries",
+      body: params
+    });
+  }
+  async update(libraryId, params) {
+    return this.client.request({
+      method: "PATCH",
+      path: `/libraries/${libraryId}`,
+      body: params
+    });
+  }
+  async delete(libraryId) {
+    return this.client.request({
+      method: "DELETE",
+      path: `/libraries/${libraryId}`
+    });
+  }
+};
+
 // src/resources/roles.ts
 var Roles = class {
   constructor(client) {
@@ -564,24 +610,42 @@ function guessMime(ext) {
   return mimeMap[ext.toLowerCase()] ?? "application/octet-stream";
 }
 
+// src/resources/workspaces.ts
+var Workspaces = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    const response = await this.client.request({
+      method: "GET",
+      path: "/workspaces"
+    });
+    return response.data;
+  }
+};
+
 // src/api.ts
 var AirApi = class extends AirBase {
   assets;
   boards;
+  libraries;
   tags;
   customFields;
   roles;
   imports;
   uploads;
+  workspaces;
   constructor(options = {}) {
     super(options);
     this.assets = new Assets(this);
     this.boards = new Boards(this);
+    this.libraries = new Libraries(this);
     this.tags = new Tags(this);
     this.customFields = new CustomFields(this);
     this.roles = new Roles(this);
     this.imports = new Imports(this);
     this.uploads = new Uploads(this);
+    this.workspaces = new Workspaces(this);
   }
 };
 
@@ -599,7 +663,10 @@ import {
   TimeoutError,
   CursorPage,
   PagePromise,
-  VERSION
+  VERSION,
+  buildAuthorizationUrl,
+  exchangeAuthorizationCode,
+  generatePKCEChallenge
 } from "@air/api-core";
 export {
   APIError,
@@ -614,6 +681,7 @@ export {
   CustomFields,
   Imports,
   InternalServerError,
+  Libraries,
   NotFoundError,
   PagePromise,
   PermissionError,
@@ -622,5 +690,9 @@ export {
   Tags,
   TimeoutError,
   Uploads,
-  VERSION
+  VERSION,
+  Workspaces,
+  buildAuthorizationUrl,
+  exchangeAuthorizationCode,
+  generatePKCEChallenge
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@air/api-rest",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "type": "module",
   "description": "Typed REST client for Air API",
   "main": "./dist/index.cjs",
@@ -26,10 +26,10 @@
     "build": "tsup",
     "test": "vitest run",
     "typecheck": "tsc -b",
-    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+    "clean": "rm -rf dist .tsc-out tsconfig.tsbuildinfo"
   },
   "dependencies": {
-    "@air/api-core": "0.1.2"
+    "@air/api-core": "0.3.0"
   },
   "engines": {
     "node": ">=18"