feat: Reorganize Column typings into the FavroApi namespace. BREAKING

src/lib/BravoClient.ts

@@ -18,7 +18,6 @@ import { BravoOrganization } from '$entities/BravoOrganization';
 import { BravoWidget } from '$entities/BravoWidget.js';
 import type { FavroApi } from '$favro';
 import { BravoColumn } from './entities/BravoColumn.js';
-import type { DataFavroColumn } from '$/types/FavroColumnTypes.js';
 import type { ArrayMatchFunction, RequiredBy } from '$/types/Utility.js';
 import type {
   DataFavroCard,
@@ -452,7 +451,7 @@ export class BravoClient extends FavroClient {
         `columns`,
         { method: 'get', query: { widgetCommonId } },
         BravoColumn,
-      )) as BravoResponseEntities<DataFavroColumn, BravoColumn>;
+      )) as BravoResponseEntities<FavroApi.Column.Data, BravoColumn>;
       const columns = await res.getAllEntities();
       this.cache.setColumns(widgetCommonId, columns);
     }

src/lib/entities/BravoColumn.ts

@@ -1,11 +1,11 @@
 import { BravoEntity } from '$lib/BravoEntity.js';
-import type { DataFavroColumn } from '$/types/FavroColumnTypes.js';
+import type { FavroApi } from '$favro';
 
 /**
  * A Favro Column is one of the available values for the default
  * "Status" field on a board (the same one used for KanBan view).
  */
-export class BravoColumn extends BravoEntity<DataFavroColumn> {
+export class BravoColumn extends BravoEntity<FavroApi.Column.Data> {
   /** The unique identifier for this column on its parent Widget.*/
   get columnId() {
     return this._data.columnId;

src/types/FavroApi.ts

@@ -221,4 +221,32 @@ export namespace FavroApi {
       Pick<Data, 'name' | 'type' | 'color' | 'ownerRole' | 'editRole'>
     >;
   }
+
+  /**
+   * Favro API Data models for Columns
+   */
+  export namespace Column {
+    /**
+     * The data model for Columns returned from the Favro API.
+     * {@link https://favro.com/developer/#column-object}
+     */
+    export interface Data {
+      /** The id of the column. */
+      columnId: string;
+      /** The id of the organization that this column exists in. */
+      organizationId: string;
+      /** The common id of the widget that this column exists on. */
+      widgetCommonId: string;
+      /** The name of the column. */
+      name: string;
+      /** The position of the column on the widget. */
+      position: number;
+      /** Total number of cards on the column. */
+      cardCount: number;
+      /** Summary time spent of cards on the column in milisecond. */
+      timeSum: number;
+      /** Summary estimation of cards on the column. */
+      estimationSum: number;
+    }
+  }
 }