@dereekb/trello 13.11.17 → 13.12.0

package/index.cjs.js

@@ -797,6 +797,23 @@ function _ts_generator$3(thisArg, body) {
         return context.fetchJson("/boards/".concat(input.boardId, "/members"), 'GET');
     };
 }
+/**
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-actions-get.
+ *
+ * Returns the board action stream. Useful for list-movement audits via `filter: 'updateCard:idList'` paired with
+ * the {@link TrelloUpdateCardIdListActionData} payload type — answers "which cards moved into list X since time Y?".
+ *
+ * @param context - The Trello API context.
+ * @returns Lists actions on a board.
+ */ function listBoardActions(context) {
+    return function(input) {
+        var boardId = input.boardId, query = _object_without_properties$4(input, [
+            "boardId"
+        ]);
+        var queryString = fetch.makeUrlSearchParams(query);
+        return context.fetchJson("/boards/".concat(boardId, "/actions?").concat(queryString), 'GET');
+    };
+}
 
 function _object_without_properties$3(source, excluded) {
     if (source == null) return {};
@@ -1994,6 +2011,7 @@ exports.getMe = getMe;
 exports.getMember = getMember;
 exports.getWebhook = getWebhook;
 exports.handleTrelloErrorFetch = handleTrelloErrorFetch;
+exports.listBoardActions = listBoardActions;
 exports.listBoardCards = listBoardCards;
 exports.listBoardLabels = listBoardLabels;
 exports.listBoardLists = listBoardLists;

package/index.esm.js

@@ -795,6 +795,23 @@ function _ts_generator$3(thisArg, body) {
         return context.fetchJson("/boards/".concat(input.boardId, "/members"), 'GET');
     };
 }
+/**
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-actions-get.
+ *
+ * Returns the board action stream. Useful for list-movement audits via `filter: 'updateCard:idList'` paired with
+ * the {@link TrelloUpdateCardIdListActionData} payload type — answers "which cards moved into list X since time Y?".
+ *
+ * @param context - The Trello API context.
+ * @returns Lists actions on a board.
+ */ function listBoardActions(context) {
+    return function(input) {
+        var boardId = input.boardId, query = _object_without_properties$4(input, [
+            "boardId"
+        ]);
+        var queryString = makeUrlSearchParams(query);
+        return context.fetchJson("/boards/".concat(boardId, "/actions?").concat(queryString), 'GET');
+    };
+}
 
 function _object_without_properties$3(source, excluded) {
     if (source == null) return {};
@@ -1961,4 +1978,4 @@ function _object_spread_props(target, source) {
     }));
 }
 
-export { DEFAULT_TRELLO_API_RATE_LIMIT, DEFAULT_TRELLO_API_RATE_LIMIT_RESET_PERIOD, TRELLO_API_URL, TRELLO_MAX_PAGE_LIMIT, TrelloInvalidTokenError, TrelloServerError, TrelloServerFetchResponseError, TrelloTooManyRequestsError, addAttachmentToCard, addCommentToCard, addLabelToCard, addMemberToCard, buildTrelloPageResult, createBoard, createCard, createList, createWebhook, defaultTrelloPageItemIdReader, deleteAttachmentFromCard, deleteBoard, deleteCard, deleteWebhook, downloadCardAttachment, getBoard, getCard, getCardAttachment, getList, getMe, getMember, getWebhook, handleTrelloErrorFetch, listBoardCards, listBoardLabels, listBoardLists, listBoardMembers, listCardActions, listCardAttachments, listCardsInList, listWebhooksForToken, logTrelloErrorToConsole, logTrelloServerErrorFunction, parseTrelloApiError, trelloActionIdReader, trelloFactory, trelloFetchPageFactory, trelloRateLimitedFetchHandler, updateBoard, updateCard, updateList, updateWebhook };
+export { DEFAULT_TRELLO_API_RATE_LIMIT, DEFAULT_TRELLO_API_RATE_LIMIT_RESET_PERIOD, TRELLO_API_URL, TRELLO_MAX_PAGE_LIMIT, TrelloInvalidTokenError, TrelloServerError, TrelloServerFetchResponseError, TrelloTooManyRequestsError, addAttachmentToCard, addCommentToCard, addLabelToCard, addMemberToCard, buildTrelloPageResult, createBoard, createCard, createList, createWebhook, defaultTrelloPageItemIdReader, deleteAttachmentFromCard, deleteBoard, deleteCard, deleteWebhook, downloadCardAttachment, getBoard, getCard, getCardAttachment, getList, getMe, getMember, getWebhook, handleTrelloErrorFetch, listBoardActions, listBoardCards, listBoardLabels, listBoardLists, listBoardMembers, listCardActions, listCardAttachments, listCardsInList, listWebhooksForToken, logTrelloErrorToConsole, logTrelloServerErrorFunction, parseTrelloApiError, trelloActionIdReader, trelloFactory, trelloFetchPageFactory, trelloRateLimitedFetchHandler, updateBoard, updateCard, updateList, updateWebhook };

package/nestjs/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dereekb/trello/nestjs",
-  "version": "13.11.17",
+  "version": "13.12.0",
   "peerDependencies": {
-    "@dereekb/nestjs": "13.11.17",
-    "@dereekb/rxjs": "13.11.17",
-    "@dereekb/trello": "13.11.17",
-    "@dereekb/util": "13.11.17",
+    "@dereekb/nestjs": "13.12.0",
+    "@dereekb/rxjs": "13.12.0",
+    "@dereekb/trello": "13.12.0",
+    "@dereekb/util": "13.12.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/trello",
-  "version": "13.11.17",
+  "version": "13.12.0",
   "exports": {
     "./nestjs": {
       "module": "./nestjs/index.esm.js",
@@ -17,9 +17,9 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/nestjs": "13.11.17",
-    "@dereekb/rxjs": "13.11.17",
-    "@dereekb/util": "13.11.17",
+    "@dereekb/nestjs": "13.12.0",
+    "@dereekb/rxjs": "13.12.0",
+    "@dereekb/util": "13.12.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1",

package/src/lib/trello/trello.api.board.d.ts

@@ -2,7 +2,8 @@ import { type TrelloContext } from './trello.factory';
 import { type TrelloBoardId, type TrelloMemberId } from '../trello.type';
 import { type CreateBoardBody, type TrelloBoard, type UpdateBoardBody } from './trello.api.board.type';
 import { type TrelloList } from './trello.api.list.type';
-import { type TrelloCard, type TrelloLabel } from './trello.api.card.type';
+import { type TrelloAction, type TrelloCard, type TrelloLabel } from './trello.api.card.type';
+import { type TrelloActionType } from './trello.api.card';
 import { type TrelloMember } from './trello.api.member.type';
 export interface GetBoardInput {
     readonly boardId: TrelloBoardId;
@@ -101,3 +102,35 @@ export type ListBoardMembersFunction = (input: ListBoardMembersInput) => Promise
  * @returns Lists all members of a board.
  */
 export declare function listBoardMembers(context: TrelloContext): ListBoardMembersFunction;
+export interface ListBoardActionsInput {
+    readonly boardId: TrelloBoardId;
+    /**
+     * Comma-separated list of action types to include, or `all`. Examples: `'updateCard:idList'`, `'updateCard:idList,createCard'`.
+     *
+     * @see https://developer.atlassian.com/cloud/trello/guides/rest-api/action-types/
+     */
+    readonly filter?: TrelloActionType;
+    /**
+     * Maximum number of actions to return. Defaults to 50 server-side; max is 1000.
+     */
+    readonly limit?: number;
+    /**
+     * Cursor: return actions before this action id (older). Also accepts an ISO 8601 date string.
+     */
+    readonly before?: string;
+    /**
+     * Cursor: return actions since this action id (newer). Also accepts an ISO 8601 date string.
+     */
+    readonly since?: string;
+}
+export type ListBoardActionsFunction = <D = unknown>(input: ListBoardActionsInput) => Promise<ReadonlyArray<TrelloAction<D>>>;
+/**
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-actions-get.
+ *
+ * Returns the board action stream. Useful for list-movement audits via `filter: 'updateCard:idList'` paired with
+ * the {@link TrelloUpdateCardIdListActionData} payload type — answers "which cards moved into list X since time Y?".
+ *
+ * @param context - The Trello API context.
+ * @returns Lists actions on a board.
+ */
+export declare function listBoardActions(context: TrelloContext): ListBoardActionsFunction;

package/src/lib/trello/trello.api.card.type.d.ts

@@ -139,3 +139,33 @@ export interface TrelloCommentCardActionData {
     };
 }
 export type TrelloCommentCardAction = TrelloAction<TrelloCommentCardActionData>;
+/**
+ * Payload of an `updateCard:idList` action — emitted by Trello whenever a card moves between lists.
+ *
+ * Pair with `listBoardActions(...)<TrelloUpdateCardIdListActionData>({ filter: 'updateCard:idList', ... })`
+ * to audit list movements.
+ */
+export interface TrelloUpdateCardIdListActionData {
+    readonly card: {
+        readonly id: TrelloCardId;
+        readonly idShort?: number;
+        readonly name?: string;
+        readonly shortLink?: string;
+    };
+    readonly old?: {
+        readonly idList?: TrelloListId;
+    };
+    readonly listAfter?: {
+        readonly id: TrelloListId;
+        readonly name?: string;
+    };
+    readonly listBefore?: {
+        readonly id: TrelloListId;
+        readonly name?: string;
+    };
+    readonly board?: {
+        readonly id: TrelloBoardId;
+        readonly name?: string;
+    };
+}
+export type TrelloUpdateCardIdListAction = TrelloAction<TrelloUpdateCardIdListActionData>;