@dereekb/trello 13.11.14 → 13.11.16

package/index.cjs.js

@@ -298,8 +298,9 @@ function _ts_generator$3(thisArg, body) {
 /**
  * Creates a logTrelloServerErrorFunction that logs the error to console.
  *
- * @param trelloApiNamePrefix Prefix to use when logging.
- * @returns A function that logs Trello server errors to the console.
+ * @param trelloApiNamePrefix - Prefix to use when logging.
+ * @returns Logs Trello server errors to the console.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function logTrelloServerErrorFunction(trelloApiNamePrefix) {
     return function(error) {
@@ -323,7 +324,7 @@ var logTrelloErrorToConsole = logTrelloServerErrorFunction('Trello');
 /**
  * Parses a FetchResponseError into a typed Trello API error.
  *
- * @param responseError The fetch response error to parse.
+ * @param responseError - The fetch response error to parse.
  * @returns A typed Trello error, or undefined if the response could not be parsed.
  */ function parseTrelloApiError(responseError) {
     return _async_to_generator$3(function() {
@@ -373,9 +374,10 @@ var logTrelloErrorToConsole = logTrelloServerErrorFunction('Trello');
 /**
  * Wraps a ConfiguredFetch to translate FetchResponseError into typed Trello errors.
  *
- * @param fetch The fetch to wrap.
- * @param logError Optional logger.
+ * @param fetch - The fetch to wrap.
+ * @param logError - Optional logger.
  * @returns A ConfiguredFetch that throws typed Trello errors for known error responses.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function handleTrelloErrorFetch(fetch$1) {
     var logError = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : logTrelloErrorToConsole;
@@ -442,8 +444,9 @@ var logTrelloErrorToConsole = logTrelloServerErrorFunction('Trello');
  *
  * Backs off after 429 responses and respects the documented per-token rate limit.
  *
- * @param config Optional configuration for rate limiting behavior.
+ * @param config - Optional configuration for rate limiting behavior.
  * @returns A configured rate-limited fetch handler.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function trelloRateLimitedFetchHandler(config) {
     var _ref, _ref1;
@@ -462,10 +465,7 @@ var logTrelloErrorToConsole = logTrelloServerErrorFunction('Trello');
         updateWithResponse: function updateWithResponse(response) {
             // Trello does not document rate limit headers, but it does return 429 when exceeded.
             // Schedule a retry after the rate limiter cooldown when a 429 is observed.
-            if (response.status === 429) {
-                return true;
-            }
-            return false;
+            return response.status === 429;
         }
     });
 }
@@ -479,8 +479,9 @@ var logTrelloErrorToConsole = logTrelloServerErrorFunction('Trello');
  *
  * Auth uses Trello's `Authorization: OAuth oauth_consumer_key=..., oauth_token=...` header form so credentials never appear in URLs or logs.
  *
- * @param factoryConfig Factory-level configuration shared across created Trello instances.
+ * @param factoryConfig - Factory-level configuration shared across created Trello instances.
  * @returns A factory function that creates a configured Trello API instance.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function trelloFactory() {
     var factoryConfig = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
@@ -686,20 +687,20 @@ function _ts_generator$2(thisArg, body) {
     }
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-get.
  *
- * @param context The Trello API context.
- * @returns A function that retrieves a board by id.
+ * @param context - The Trello API context.
+ * @returns Retrieves a board by id.
  */ function getBoard(context) {
     return function(input) {
         return context.fetchJson("/boards/".concat(input.boardId), 'GET');
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-post
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-post.
  *
- * @param context The Trello API context.
- * @returns A function that creates a new board.
+ * @param context - The Trello API context.
+ * @returns Creates a new board.
  */ function createBoard(context) {
     return function(input) {
         var queryString = fetch.makeUrlSearchParams(input);
@@ -707,10 +708,10 @@ function _ts_generator$2(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-put
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-put.
  *
- * @param context The Trello API context.
- * @returns A function that updates an existing board.
+ * @param context - The Trello API context.
+ * @returns Updates an existing board.
  */ function updateBoard(context) {
     return function(input) {
         var boardId = input.boardId, body = _object_without_properties$3(input, [
@@ -720,10 +721,10 @@ function _ts_generator$2(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-delete
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-delete.
  *
- * @param context The Trello API context.
- * @returns A function that deletes a board.
+ * @param context - The Trello API context.
+ * @returns Deletes a board.
  */ function deleteBoard(context) {
     return function(input) {
         return _async_to_generator$2(function() {
@@ -745,10 +746,10 @@ function _ts_generator$2(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-lists-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-lists-get.
  *
- * @param context The Trello API context.
- * @returns A function that lists all lists on a board.
+ * @param context - The Trello API context.
+ * @returns Lists all lists on a board.
  */ function listBoardLists(context) {
     return function(input) {
         var boardId = input.boardId, query = _object_without_properties$3(input, [
@@ -759,10 +760,10 @@ function _ts_generator$2(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-cards-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-cards-get.
  *
- * @param context The Trello API context.
- * @returns A function that lists all cards on a board.
+ * @param context - The Trello API context.
+ * @returns Lists all cards on a board.
  */ function listBoardCards(context) {
     return function(input) {
         var boardId = input.boardId, query = _object_without_properties$3(input, [
@@ -773,10 +774,10 @@ function _ts_generator$2(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-labels-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-labels-get.
  *
- * @param context The Trello API context.
- * @returns A function that lists every label defined on a board.
+ * @param context - The Trello API context.
+ * @returns Lists every label defined on a board.
  */ function listBoardLabels(context) {
     return function(input) {
         var boardId = input.boardId, query = _object_without_properties$3(input, [
@@ -787,10 +788,10 @@ function _ts_generator$2(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-members-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-boards/#api-boards-id-members-get.
  *
- * @param context The Trello API context.
- * @returns A function that lists all members of a board.
+ * @param context - The Trello API context.
+ * @returns Lists all members of a board.
  */ function listBoardMembers(context) {
     return function(input) {
         return context.fetchJson("/boards/".concat(input.boardId, "/members"), 'GET');
@@ -834,20 +835,20 @@ function _object_without_properties_loose$2(source, excluded) {
     return target;
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-id-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-id-get.
  *
- * @param context The Trello API context.
- * @returns A function that retrieves a list by id.
+ * @param context - The Trello API context.
+ * @returns Retrieves a list by id.
  */ function getList(context) {
     return function(input) {
         return context.fetchJson("/lists/".concat(input.listId), 'GET');
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-post
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-post.
  *
- * @param context The Trello API context.
- * @returns A function that creates a new list on a board.
+ * @param context - The Trello API context.
+ * @returns Creates a new list on a board.
  */ function createList(context) {
     return function(input) {
         var queryString = fetch.makeUrlSearchParams(input);
@@ -855,10 +856,10 @@ function _object_without_properties_loose$2(source, excluded) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-id-put
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-id-put.
  *
- * @param context The Trello API context.
- * @returns A function that updates an existing list.
+ * @param context - The Trello API context.
+ * @returns Updates an existing list.
  */ function updateList(context) {
     return function(input) {
         var listId = input.listId, body = _object_without_properties$2(input, [
@@ -868,10 +869,10 @@ function _object_without_properties_loose$2(source, excluded) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-id-cards-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-lists/#api-lists-id-cards-get.
  *
- * @param context The Trello API context.
- * @returns A function that lists all cards on a list.
+ * @param context - The Trello API context.
+ * @returns Lists all cards on a list.
  */ function listCardsInList(context) {
     return function(input) {
         var listId = input.listId, query = _object_without_properties$2(input, [
@@ -1075,20 +1076,20 @@ function _ts_generator$1(thisArg, body) {
     }
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-get.
  *
- * @param context The Trello API context.
- * @returns A function that retrieves a card by id.
+ * @param context - The Trello API context.
+ * @returns Retrieves a card by id.
  */ function getCard(context) {
     return function(input) {
         return context.fetchJson("/cards/".concat(input.cardId), 'GET');
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-post
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-post.
  *
- * @param context The Trello API context.
- * @returns A function that creates a card on a list.
+ * @param context - The Trello API context.
+ * @returns Creates a card on a list.
  */ function createCard(context) {
     return function(input) {
         var idLabels = input.idLabels, idMembers = input.idMembers, rest = _object_without_properties$1(input, [
@@ -1107,10 +1108,10 @@ function _ts_generator$1(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-put
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-put.
  *
- * @param context The Trello API context.
- * @returns A function that updates an existing card.
+ * @param context - The Trello API context.
+ * @returns Updates an existing card.
  */ function updateCard(context) {
     return function(input) {
         var cardId = input.cardId, idLabels = input.idLabels, idMembers = input.idMembers, rest = _object_without_properties$1(input, [
@@ -1129,10 +1130,10 @@ function _ts_generator$1(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-delete
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-delete.
  *
- * @param context The Trello API context.
- * @returns A function that deletes a card.
+ * @param context - The Trello API context.
+ * @returns Deletes a card.
  */ function deleteCard(context) {
     return function(input) {
         return _async_to_generator$1(function() {
@@ -1154,13 +1155,13 @@ function _ts_generator$1(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-actions-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-actions-get.
  *
  * Comments are returned as actions with `type === 'commentCard'`; pass `filter: 'commentCard'` and the generic
  * type parameter `TrelloCommentCardActionData` to get a comment-typed result.
  *
- * @param context The Trello API context.
- * @returns A function that lists actions on a card.
+ * @param context - The Trello API context.
+ * @returns Lists actions on a card.
  */ function listCardActions(context) {
     return function(input) {
         var cardId = input.cardId, query = _object_without_properties$1(input, [
@@ -1171,10 +1172,10 @@ function _ts_generator$1(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-actions-comments-post
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-actions-comments-post.
  *
- * @param context The Trello API context.
- * @returns A function that adds a comment to a card.
+ * @param context - The Trello API context.
+ * @returns Adds a comment to a card.
  */ function addCommentToCard(context) {
     return function(input) {
         var queryString = fetch.makeUrlSearchParams({
@@ -1184,10 +1185,10 @@ function _ts_generator$1(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-idmembers-post
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-idmembers-post.
  *
- * @param context The Trello API context.
- * @returns A function that adds a member to a card.
+ * @param context - The Trello API context.
+ * @returns Adds a member to a card.
  */ function addMemberToCard(context) {
     return function(input) {
         var queryString = fetch.makeUrlSearchParams({
@@ -1197,10 +1198,10 @@ function _ts_generator$1(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-idlabels-post
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-cards/#api-cards-id-idlabels-post.
  *
- * @param context The Trello API context.
- * @returns A function that adds an existing label to a card.
+ * @param context - The Trello API context.
+ * @returns Adds an existing label to a card.
  */ function addLabelToCard(context) {
     return function(input) {
         var queryString = fetch.makeUrlSearchParams({
@@ -1211,10 +1212,10 @@ function _ts_generator$1(thisArg, body) {
 }
 
 /**
- * https://developer.atlassian.com/cloud/trello/rest/api-group-members/#api-members-id-get
+ * Https://developer.atlassian.com/cloud/trello/rest/api-group-members/#api-members-id-get.
  *
- * @param context The Trello API context.
- * @returns A function that retrieves a member by id (or `me`).
+ * @param context - The Trello API context.
+ * @returns Retrieves a member by id (or `me`).
  */ function getMember(context) {
     return function(input) {
         return context.fetchJson("/members/".concat(input.memberId), 'GET');
@@ -1223,8 +1224,8 @@ function _ts_generator$1(thisArg, body) {
 /**
  * Convenience wrapper around `getMember({ memberId: 'me' })`.
  *
- * @param context The Trello API context.
- * @returns A function that retrieves the authenticated user.
+ * @param context - The Trello API context.
+ * @returns Retrieves the authenticated user.
  */ function getMe(context) {
     return function() {
         return context.fetchJson("/members/me", 'GET');
@@ -1400,8 +1401,8 @@ function _ts_generator(thisArg, body) {
  *
  * https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#creating-a-webhook
  *
- * @param context The Trello API context.
- * @returns A function that registers a new webhook.
+ * @param context - The Trello API context.
+ * @returns Registers a new webhook.
  */ function createWebhook(context) {
     return function(input) {
         var queryString = fetch.makeUrlSearchParams(input);
@@ -1409,20 +1410,20 @@ function _ts_generator(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#retrieving-a-webhook
+ * Https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#retrieving-a-webhook.
  *
- * @param context The Trello API context.
- * @returns A function that retrieves a webhook by id.
+ * @param context - The Trello API context.
+ * @returns Retrieves a webhook by id.
  */ function getWebhook(context) {
     return function(input) {
         return context.fetchJson("/webhooks/".concat(input.webhookId), 'GET');
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#updating-a-webhook
+ * Https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#updating-a-webhook.
  *
- * @param context The Trello API context.
- * @returns A function that updates an existing webhook.
+ * @param context - The Trello API context.
+ * @returns Updates an existing webhook.
  */ function updateWebhook(context) {
     return function(input) {
         var webhookId = input.webhookId, body = _object_without_properties(input, [
@@ -1432,10 +1433,10 @@ function _ts_generator(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#deleting-a-webhook
+ * Https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/#deleting-a-webhook.
  *
- * @param context The Trello API context.
- * @returns A function that deletes a webhook.
+ * @param context - The Trello API context.
+ * @returns Deletes a webhook.
  */ function deleteWebhook(context) {
     return function(input) {
         return _async_to_generator(function() {
@@ -1457,10 +1458,10 @@ function _ts_generator(thisArg, body) {
     };
 }
 /**
- * https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/
+ * Https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/.
  *
- * @param context The Trello API context.
- * @returns A function that lists all webhooks registered for a token.
+ * @param context - The Trello API context.
+ * @returns Lists all webhooks registered for a token.
  */ function listWebhooksForToken(context) {
     return function(input) {
         var _ref;
@@ -1524,7 +1525,7 @@ function _object_spread_props(target, source) {
 /**
  * Default reader that pulls `id` off the item. Works for most Trello resource types.
  *
- * @param item The page item whose id to read.
+ * @param item - The page item whose id to read.
  * @returns The item's id.
  */ var defaultTrelloPageItemIdReader = function defaultTrelloPageItemIdReader(item) {
     return item.id;
@@ -1532,7 +1533,7 @@ function _object_spread_props(target, source) {
 /**
  * Reader that pulls the action id off a Trello action item.
  *
- * @param item The action page item whose id to read.
+ * @param item - The action page item whose id to read.
  * @returns The item's action id.
  */ var trelloActionIdReader = function trelloActionIdReader(item) {
     return item.id;
@@ -1540,16 +1541,18 @@ function _object_spread_props(target, source) {
 /**
  * Wraps a raw Trello collection fetch into a {@link TrelloPageResult}.
  *
- * @param input The page filter that was used.
- * @param data The raw page items.
- * @param idReader Function to read the id from the last item.
+ * @param input - The page filter that was used.
+ * @param data - The raw page items.
+ * @param idReader - Function to read the id from the last item.
  * @returns A page result with the data and a cursor for the next page.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function buildTrelloPageResult(input, data, idReader) {
     var _input_limit;
     var limit = (_input_limit = input.limit) !== null && _input_limit !== void 0 ? _input_limit : data.length;
     var hasMore = data.length === limit && data.length > 0;
-    var nextBefore = hasMore ? idReader(data[data.length - 1]) : undefined;
+    var lastItem = hasMore ? data.at(-1) : undefined;
+    var nextBefore = lastItem === undefined ? undefined : idReader(lastItem);
     return {
         data: data,
         limit: limit,
@@ -1559,9 +1562,10 @@ function _object_spread_props(target, source) {
 /**
  * Creates a FetchPageFactory using the input TrelloFetchPageFetchFunction.
  *
- * @param fetch Function that fetches a single page of results from the Trello API.
- * @param defaults Optional default pagination configuration.
+ * @param fetch - Function that fetches a single page of results from the Trello API.
+ * @param defaults - Optional default pagination configuration.
  * @returns A configured FetchPageFactory that handles Trello's cursor-based pagination using `before`.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function trelloFetchPageFactory(fetch$1, defaults) {
     return fetch.fetchPageFactory(_object_spread_props(_object_spread({}, defaults), {