@dereekb/zoho 13.11.14 → 13.11.15

package/src/lib/crm/crm.notes.d.ts

@@ -1,4 +1,4 @@
-import { type ISO8601DateString, type UniqueModelWithId } from '@dereekb/util';
+import { type ISO8601DateString, type UniqueModelWithId, type Maybe } from '@dereekb/util';
 import { type ZohoCrmReferenceData, type ZohoCrmParentReferenceData, type ZohoCrmTypeId, type ZohoCrmModuleName, type ZohoCrmCreatedByData, type ZohoCrmModifiedByData, type ZohoCrmId } from './crm';
 /**
  * Unique identifier for a CRM note.
@@ -50,7 +50,7 @@ export interface ZohoCrmNoteData {
     readonly Note_Owner: ZohoCrmNoteOwnerData;
     readonly Created_By: ZohoCrmCreatedByData;
     readonly Modified_By: ZohoCrmModifiedByData;
-    readonly $size: ZohoCrmNoteFileSize | null;
+    readonly $size: Maybe<ZohoCrmNoteFileSize>;
     readonly $voice_note: boolean;
     readonly $status: ZohoCrmNoteStatus;
 }

package/src/lib/desk/desk.agent.d.ts

@@ -1,4 +1,4 @@
-import { type Maybe } from '@dereekb/util';
+import { type SuggestedString, type Maybe } from '@dereekb/util';
 import { type ZohoDeskAgentId } from './desk';
 /**
  * Agent status in Zoho Desk.
@@ -7,7 +7,7 @@ export type ZohoDeskAgentStatus = 'ACTIVE' | 'DISABLED';
 /**
  * Agent role permission type in Zoho Desk.
  */
-export type ZohoDeskAgentRolePermissionType = 'Light' | 'AgentPublic' | 'Custom' | 'AgentPersonal' | 'Admin' | (string & {});
+export type ZohoDeskAgentRolePermissionType = SuggestedString<'Light' | 'AgentPublic' | 'Custom' | 'AgentPersonal' | 'Admin'>;
 /**
  * Related entities that can be expanded when fetching agents.
  */

package/src/lib/desk/desk.api.activities.d.ts

@@ -26,8 +26,8 @@ export type ZohoDeskGetTicketActivitiesFunction = (input: ZohoDeskGetTicketActiv
  *
  * Retrieves a paginated list of activities (tasks, events, calls) associated with a ticket.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves activities for a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves activities for a ticket.
  */
 export declare function zohoDeskGetTicketActivities(context: ZohoDeskContext): ZohoDeskGetTicketActivitiesFunction;
 /**
@@ -37,8 +37,9 @@ export type ZohoDeskGetTicketActivitiesPageFactory = (input: ZohoDeskGetTicketAc
 /**
  * Creates a {@link ZohoDeskGetTicketActivitiesPageFactory} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Page factory for iterating over activity results
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Page factory for iterating over activity results.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskGetTicketActivitiesPageFactory(context: ZohoDeskContext): ZohoDeskGetTicketActivitiesPageFactory;

package/src/lib/desk/desk.api.agents.d.ts

@@ -26,8 +26,8 @@ export type ZohoDeskGetAgentsFunction = (input: ZohoDeskGetAgentsInput) => Promi
  * Retrieves a paginated list of agents, with optional filtering by department and status,
  * and inline expansion of related entities (role, profile, departments).
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves paginated agents
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves paginated agents.
  */
 export declare function zohoDeskGetAgents(context: ZohoDeskContext): ZohoDeskGetAgentsFunction;
 /**
@@ -44,8 +44,8 @@ export type ZohoDeskGetAgentByIdFunction = (input: ZohoDeskGetAgentByIdInput) =>
 /**
  * Creates a {@link ZohoDeskGetAgentByIdFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves a single agent
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves a single agent.
  */
 export declare function zohoDeskGetAgentById(context: ZohoDeskContext): ZohoDeskGetAgentByIdFunction;
 /**
@@ -61,8 +61,8 @@ export type ZohoDeskGetAgentsByIdsFunction = (input: ZohoDeskGetAgentsByIdsInput
 /**
  * Creates a {@link ZohoDeskGetAgentsByIdsFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves agents by IDs
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves agents by IDs.
  */
 export declare function zohoDeskGetAgentsByIds(context: ZohoDeskContext): ZohoDeskGetAgentsByIdsFunction;
 /**
@@ -74,8 +74,8 @@ export type ZohoDeskGetMyInfoFunction = () => Promise<ZohoDeskAgent>;
  *
  * Retrieves the profile of the agent associated with the current OAuth token.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves the current agent's info
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves the current agent's info.
  */
 export declare function zohoDeskGetMyInfo(context: ZohoDeskContext): ZohoDeskGetMyInfoFunction;
 /**
@@ -85,8 +85,9 @@ export type ZohoDeskGetAgentsPageFactory = (input: ZohoDeskGetAgentsInput, optio
 /**
  * Creates a {@link ZohoDeskGetAgentsPageFactory} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Page factory for iterating over agent results
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Page factory for iterating over agent results.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskGetAgentsPageFactory(context: ZohoDeskContext): ZohoDeskGetAgentsPageFactory;

package/src/lib/desk/desk.api.attachments.d.ts

@@ -23,8 +23,8 @@ export type ZohoDeskGetTicketAttachmentsFunction = (input: ZohoDeskGetTicketAtta
 /**
  * Creates a {@link ZohoDeskGetTicketAttachmentsFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves attachments for a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves attachments for a ticket.
  */
 export declare function zohoDeskGetTicketAttachments(context: ZohoDeskContext): ZohoDeskGetTicketAttachmentsFunction;
 /**
@@ -41,7 +41,7 @@ export type ZohoDeskDeleteTicketAttachmentFunction = (input: ZohoDeskDeleteTicke
 /**
  * Creates a {@link ZohoDeskDeleteTicketAttachmentFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that deletes a ticket attachment
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that deletes a ticket attachment.
  */
 export declare function zohoDeskDeleteTicketAttachment(context: ZohoDeskContext): ZohoDeskDeleteTicketAttachmentFunction;

package/src/lib/desk/desk.api.comments.d.ts

@@ -22,8 +22,8 @@ export type ZohoDeskGetTicketCommentsFunction = (input: ZohoDeskGetTicketComment
 /**
  * Creates a {@link ZohoDeskGetTicketCommentsFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves comments for a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves comments for a ticket.
  */
 export declare function zohoDeskGetTicketComments(context: ZohoDeskContext): ZohoDeskGetTicketCommentsFunction;
 /**
@@ -41,8 +41,8 @@ export type ZohoDeskGetTicketCommentByIdFunction = (input: ZohoDeskGetTicketComm
 /**
  * Creates a {@link ZohoDeskGetTicketCommentByIdFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves a single comment
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves a single comment.
  */
 export declare function zohoDeskGetTicketCommentById(context: ZohoDeskContext): ZohoDeskGetTicketCommentByIdFunction;
 /**
@@ -62,8 +62,8 @@ export type ZohoDeskCreateTicketCommentFunction = (input: ZohoDeskCreateTicketCo
 /**
  * Creates a {@link ZohoDeskCreateTicketCommentFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that creates a comment on a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that creates a comment on a ticket.
  */
 export declare function zohoDeskCreateTicketComment(context: ZohoDeskContext): ZohoDeskCreateTicketCommentFunction;
 /**
@@ -80,7 +80,7 @@ export type ZohoDeskDeleteTicketCommentFunction = (input: ZohoDeskDeleteTicketCo
 /**
  * Creates a {@link ZohoDeskDeleteTicketCommentFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that deletes a comment from a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that deletes a comment from a ticket.
  */
 export declare function zohoDeskDeleteTicketComment(context: ZohoDeskContext): ZohoDeskDeleteTicketCommentFunction;

package/src/lib/desk/desk.api.contacts.d.ts

@@ -27,8 +27,8 @@ export type ZohoDeskGetContactsFunction = (input: ZohoDeskGetContactsInput) => P
  * Retrieves a paginated list of contacts from Zoho Desk, with optional sorting,
  * inline expansion of related entities, and custom view filtering.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves paginated contacts
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves paginated contacts.
  */
 export declare function zohoDeskGetContacts(context: ZohoDeskContext): ZohoDeskGetContactsFunction;
 /**
@@ -45,8 +45,8 @@ export type ZohoDeskGetContactByIdFunction = (input: ZohoDeskGetContactByIdInput
 /**
  * Creates a {@link ZohoDeskGetContactByIdFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves a single contact
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves a single contact.
  */
 export declare function zohoDeskGetContactById(context: ZohoDeskContext): ZohoDeskGetContactByIdFunction;
 /**
@@ -64,8 +64,8 @@ export type ZohoDeskGetContactsByIdsFunction = (input: ZohoDeskGetContactsByIdsI
  *
  * Retrieves multiple contacts in a single request by providing their IDs.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves contacts by IDs
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves contacts by IDs.
  */
 export declare function zohoDeskGetContactsByIds(context: ZohoDeskContext): ZohoDeskGetContactsByIdsFunction;
 /**
@@ -75,8 +75,9 @@ export type ZohoDeskGetContactsPageFactory = (input: ZohoDeskGetContactsInput, o
 /**
  * Creates a {@link ZohoDeskGetContactsPageFactory} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Page factory for iterating over contact results
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Page factory for iterating over contact results.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskGetContactsPageFactory(context: ZohoDeskContext): ZohoDeskGetContactsPageFactory;

package/src/lib/desk/desk.api.departments.d.ts

@@ -24,8 +24,8 @@ export type ZohoDeskGetDepartmentsFunction = (input: ZohoDeskGetDepartmentsInput
  * Retrieves a paginated list of departments from Zoho Desk, with optional filtering
  * by chat status, search string, and enabled state.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves paginated departments
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves paginated departments.
  */
 export declare function zohoDeskGetDepartments(context: ZohoDeskContext): ZohoDeskGetDepartmentsFunction;
 /**
@@ -41,7 +41,7 @@ export type ZohoDeskGetDepartmentByIdFunction = (input: ZohoDeskGetDepartmentByI
 /**
  * Creates a {@link ZohoDeskGetDepartmentByIdFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves a single department
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves a single department.
  */
 export declare function zohoDeskGetDepartmentById(context: ZohoDeskContext): ZohoDeskGetDepartmentByIdFunction;

package/src/lib/desk/desk.api.followers.d.ts

@@ -15,8 +15,8 @@ export type ZohoDeskGetTicketFollowersFunction = (input: ZohoDeskGetTicketFollow
 /**
  * Creates a {@link ZohoDeskGetTicketFollowersFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves followers for a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves followers for a ticket.
  */
 export declare function zohoDeskGetTicketFollowers(context: ZohoDeskContext): ZohoDeskGetTicketFollowersFunction;
 /**
@@ -33,8 +33,8 @@ export type ZohoDeskAddTicketFollowersFunction = (input: ZohoDeskAddTicketFollow
 /**
  * Creates a {@link ZohoDeskAddTicketFollowersFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that adds followers to a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that adds followers to a ticket.
  */
 export declare function zohoDeskAddTicketFollowers(context: ZohoDeskContext): ZohoDeskAddTicketFollowersFunction;
 /**
@@ -51,7 +51,7 @@ export type ZohoDeskRemoveTicketFollowersFunction = (input: ZohoDeskRemoveTicket
 /**
  * Creates a {@link ZohoDeskRemoveTicketFollowersFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that removes followers from a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that removes followers from a ticket.
  */
 export declare function zohoDeskRemoveTicketFollowers(context: ZohoDeskContext): ZohoDeskRemoveTicketFollowersFunction;

package/src/lib/desk/desk.api.page.d.ts

@@ -7,7 +7,7 @@ export declare const ZOHO_DESK_MAX_PAGE_LIMIT = 50;
 /**
  * Default number of records per page for Zoho Desk list endpoints.
  */
-export declare const ZOHO_DESK_DEFAULT_PAGE_LIMIT = 25;
+export declare const DEFAULT_ZOHO_DESK_PAGE_LIMIT = 25;
 /**
  * Pagination parameters for Zoho Desk list endpoints.
  *
@@ -24,7 +24,7 @@ export interface ZohoDeskPageFilter {
     /**
      * Number of records to return per page.
      *
-     * Defaults to {@link ZOHO_DESK_DEFAULT_PAGE_LIMIT}. Maximum is {@link ZOHO_DESK_MAX_PAGE_LIMIT}.
+     * Defaults to {@link DEFAULT_ZOHO_DESK_PAGE_LIMIT}. Maximum is {@link ZOHO_DESK_MAX_PAGE_LIMIT}.
      */
     readonly limit?: number;
 }
@@ -53,9 +53,9 @@ export type ZohoDeskFetchPageFetchFunction<I extends ZohoDeskPageFilter, R exten
  * against the requested `limit`. If `data.length >= limit`, more records are assumed to exist.
  * The `from` offset is automatically advanced by `limit` for subsequent requests.
  *
- * @param fetch - The Zoho Desk fetch function to paginate over
- * @param defaults - Optional default configuration for the page factory
- * @returns A page factory that produces iterable page fetchers
+ * @param fetch - The Zoho Desk fetch function to paginate over.
+ * @param defaults - Optional default configuration for the page factory.
+ * @returns A page factory that produces iterable page fetchers.
  *
  * @example
  * ```typescript
@@ -68,6 +68,7 @@ export type ZohoDeskFetchPageFetchFunction<I extends ZohoDeskPageFilter, R exten
  *   const secondPage = await firstPage.fetchNext();
  * }
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskFetchPageFactory<I extends ZohoDeskPageFilter, R extends ZohoDeskPageResult<any>>(fetch: ZohoDeskFetchPageFetchFunction<I, R>, defaults?: Maybe<FetchPageFactoryConfigDefaults>): import("@dereekb/util/fetch").FetchPageFactory<I, R>;

package/src/lib/desk/desk.api.tags.d.ts

@@ -16,8 +16,8 @@ export type ZohoDeskGetTicketTagsFunction = (input: ZohoDeskGetTicketTagsInput)
 /**
  * Creates a {@link ZohoDeskGetTicketTagsFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves tags for a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves tags for a ticket.
  */
 export declare function zohoDeskGetTicketTags(context: ZohoDeskContext): ZohoDeskGetTicketTagsFunction;
 /**
@@ -36,8 +36,8 @@ export type ZohoDeskAssociateTicketTagsFunction = (input: ZohoDeskAssociateTicke
  *
  * Associates one or more tags with a ticket. If the tag does not exist, it will be created.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that associates tags with a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that associates tags with a ticket.
  */
 export declare function zohoDeskAssociateTicketTags(context: ZohoDeskContext): ZohoDeskAssociateTicketTagsFunction;
 /**
@@ -54,8 +54,8 @@ export type ZohoDeskDissociateTicketTagFunction = (input: ZohoDeskDissociateTick
 /**
  * Creates a {@link ZohoDeskDissociateTicketTagFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that removes a tag from a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that removes a tag from a ticket.
  */
 export declare function zohoDeskDissociateTicketTag(context: ZohoDeskContext): ZohoDeskDissociateTicketTagFunction;
 /**
@@ -72,8 +72,8 @@ export type ZohoDeskSearchTagsFunction = (input: ZohoDeskSearchTagsInput) => Pro
 /**
  * Creates a {@link ZohoDeskSearchTagsFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that searches for tags
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that searches for tags.
  */
 export declare function zohoDeskSearchTags(context: ZohoDeskContext): ZohoDeskSearchTagsFunction;
 /**
@@ -96,7 +96,7 @@ export type ZohoDeskGetAllTagsFunction = (input: ZohoDeskGetAllTagsInput) => Pro
 /**
  * Creates a {@link ZohoDeskGetAllTagsFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves all tags
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves all tags.
  */
 export declare function zohoDeskGetAllTags(context: ZohoDeskContext): ZohoDeskGetAllTagsFunction;

package/src/lib/desk/desk.api.threads.d.ts

@@ -24,8 +24,8 @@ export type ZohoDeskGetTicketThreadsFunction = (input: ZohoDeskGetTicketThreadsI
  *
  * Retrieves a paginated list of conversation threads (emails, replies, notes) for a ticket.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves threads for a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves threads for a ticket.
  */
 export declare function zohoDeskGetTicketThreads(context: ZohoDeskContext): ZohoDeskGetTicketThreadsFunction;
 /**
@@ -43,8 +43,8 @@ export type ZohoDeskGetTicketThreadByIdFunction = (input: ZohoDeskGetTicketThrea
 /**
  * Creates a {@link ZohoDeskGetTicketThreadByIdFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves a single thread
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves a single thread.
  */
 export declare function zohoDeskGetTicketThreadById(context: ZohoDeskContext): ZohoDeskGetTicketThreadByIdFunction;
 /**
@@ -54,8 +54,9 @@ export type ZohoDeskGetTicketThreadsPageFactory = (input: ZohoDeskGetTicketThrea
 /**
  * Creates a {@link ZohoDeskGetTicketThreadsPageFactory} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Page factory for iterating over thread results
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Page factory for iterating over thread results.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskGetTicketThreadsPageFactory(context: ZohoDeskContext): ZohoDeskGetTicketThreadsPageFactory;

package/src/lib/desk/desk.api.tickets.d.ts

@@ -7,9 +7,9 @@ import { type ZohoDeskPageFilter, type ZohoDeskPageResult } from './desk.api.pag
 /**
  * Constructs the standard FetchJsonInput used by Desk API calls, pairing the HTTP method with an optional body.
  *
- * @param method - HTTP method to use for the request
- * @param body - Optional request body to include
- * @returns Configured fetch input for the Zoho Desk API call
+ * @param method - HTTP method to use for the request.
+ * @param body - Optional request body to include.
+ * @returns Configured fetch input for the Zoho Desk API call.
  */
 export declare function zohoDeskApiFetchJsonInput(method: string, body?: Maybe<FetchJsonBody>): FetchJsonInput;
 /**
@@ -42,8 +42,8 @@ export type ZohoDeskGetTicketsFunction = (input: ZohoDeskGetTicketsInput) => Pro
  * Retrieves a paginated list of tickets from Zoho Desk, with optional filtering by
  * department, status, priority, channel, assignee, and view.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves paginated tickets
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves paginated tickets.
  */
 export declare function zohoDeskGetTickets(context: ZohoDeskContext): ZohoDeskGetTicketsFunction;
 /**
@@ -62,8 +62,8 @@ export type ZohoDeskGetTicketByIdFunction = (input: ZohoDeskGetTicketByIdInput)
  *
  * Retrieves a single ticket by its ID, with optional inline expansion of related entities.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves a single ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves a single ticket.
  */
 export declare function zohoDeskGetTicketById(context: ZohoDeskContext): ZohoDeskGetTicketByIdFunction;
 /**
@@ -119,8 +119,8 @@ export type ZohoDeskSearchTicketsFunction = (input: ZohoDeskSearchTicketsInput)
  * Searches for tickets matching the given filter criteria. Supports filtering by
  * many fields including subject, email, status, priority, date ranges, and custom fields.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that searches for tickets
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that searches for tickets.
  */
 export declare function zohoDeskSearchTickets(context: ZohoDeskContext): ZohoDeskSearchTicketsFunction;
 /**
@@ -140,8 +140,8 @@ export type ZohoDeskGetTicketsForContactFunction = (input: ZohoDeskGetTicketsFor
 /**
  * Creates a {@link ZohoDeskGetTicketsForContactFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves tickets for a contact
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves tickets for a contact.
  */
 export declare function zohoDeskGetTicketsForContact(context: ZohoDeskContext): ZohoDeskGetTicketsForContactFunction;
 /**
@@ -161,8 +161,8 @@ export type ZohoDeskGetTicketsForProductFunction = (input: ZohoDeskGetTicketsFor
 /**
  * Creates a {@link ZohoDeskGetTicketsForProductFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves tickets for a product
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves tickets for a product.
  */
 export declare function zohoDeskGetTicketsForProduct(context: ZohoDeskContext): ZohoDeskGetTicketsForProductFunction;
 /**
@@ -178,8 +178,8 @@ export type ZohoDeskGetTicketMetricsFunction = (input: ZohoDeskGetTicketMetricsI
 /**
  * Creates a {@link ZohoDeskGetTicketMetricsFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves ticket metrics
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves ticket metrics.
  */
 export declare function zohoDeskGetTicketMetrics(context: ZohoDeskContext): ZohoDeskGetTicketMetricsFunction;
 /**
@@ -196,8 +196,8 @@ export type ZohoDeskGetAgentsTicketsCountFunction = (input: ZohoDeskGetAgentsTic
 /**
  * Creates a {@link ZohoDeskGetAgentsTicketsCountFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves agent ticket counts
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves agent ticket counts.
  */
 export declare function zohoDeskGetAgentsTicketsCount(context: ZohoDeskContext): ZohoDeskGetAgentsTicketsCountFunction;
 /**
@@ -210,8 +210,9 @@ export type ZohoDeskGetTicketsPageFactory = (input: ZohoDeskGetTicketsInput, opt
  * Returns a page factory that automatically handles Zoho Desk's offset-based pagination,
  * making it easy to iterate through all tickets across multiple pages.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Page factory for iterating over ticket results
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Page factory for iterating over ticket results.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskGetTicketsPageFactory(context: ZohoDeskContext): ZohoDeskGetTicketsPageFactory;
@@ -222,8 +223,9 @@ export type ZohoDeskSearchTicketsPageFactory = (input: ZohoDeskSearchTicketsInpu
 /**
  * Creates a {@link ZohoDeskSearchTicketsPageFactory} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Page factory for iterating over search results
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Page factory for iterating over search results.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskSearchTicketsPageFactory(context: ZohoDeskContext): ZohoDeskSearchTicketsPageFactory;

package/src/lib/desk/desk.api.time.d.ts

@@ -16,8 +16,8 @@ export type ZohoDeskGetTicketTimerFunction = (input: ZohoDeskGetTicketTimerInput
 /**
  * Creates a {@link ZohoDeskGetTicketTimerFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves the ticket timer
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves the ticket timer.
  */
 export declare function zohoDeskGetTicketTimer(context: ZohoDeskContext): ZohoDeskGetTicketTimerFunction;
 /**
@@ -38,8 +38,8 @@ export type ZohoDeskPerformTicketTimerActionFunction = (input: ZohoDeskPerformTi
 /**
  * Creates a {@link ZohoDeskPerformTicketTimerActionFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that performs a timer action on a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that performs a timer action on a ticket.
  */
 export declare function zohoDeskPerformTicketTimerAction(context: ZohoDeskContext): ZohoDeskPerformTicketTimerActionFunction;
 /**
@@ -60,8 +60,8 @@ export type ZohoDeskGetTicketTimeEntriesFunction = (input: ZohoDeskGetTicketTime
 /**
  * Creates a {@link ZohoDeskGetTicketTimeEntriesFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves time entries for a ticket
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves time entries for a ticket.
  */
 export declare function zohoDeskGetTicketTimeEntries(context: ZohoDeskContext): ZohoDeskGetTicketTimeEntriesFunction;
 /**
@@ -78,8 +78,8 @@ export type ZohoDeskGetTicketTimeEntryByIdFunction = (input: ZohoDeskGetTicketTi
 /**
  * Creates a {@link ZohoDeskGetTicketTimeEntryByIdFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves a single time entry
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves a single time entry.
  */
 export declare function zohoDeskGetTicketTimeEntryById(context: ZohoDeskContext): ZohoDeskGetTicketTimeEntryByIdFunction;
 /**
@@ -103,7 +103,7 @@ export type ZohoDeskGetTicketTimeEntrySummationFunction = (input: ZohoDeskGetTic
 /**
  * Creates a {@link ZohoDeskGetTicketTimeEntrySummationFunction} bound to the given context.
  *
- * @param context - Authenticated Zoho Desk context
- * @returns Function that retrieves time entry summation
+ * @param context - Authenticated Zoho Desk context.
+ * @returns Function that retrieves time entry summation.
  */
 export declare function zohoDeskGetTicketTimeEntrySummation(context: ZohoDeskContext): ZohoDeskGetTicketTimeEntrySummationFunction;

package/src/lib/desk/desk.config.d.ts

@@ -28,8 +28,8 @@ export type ZohoDeskConfigApiUrlInput = ZohoDeskApiUrlKey | ZohoDeskApiUrl;
  * Resolves a Desk API URL input to its full base URL. The 'production' key maps to the
  * primary Zoho Desk endpoint; custom URLs pass through unchanged.
  *
- * @param input - A well-known environment key or a custom Desk API URL
- * @returns The resolved full Zoho Desk API base URL
+ * @param input - A well-known environment key or a custom Desk API URL.
+ * @returns The resolved full Zoho Desk API base URL.
  */
 export declare function zohoDeskConfigApiUrl(input: ZohoDeskConfigApiUrlInput): ZohoApiUrl;
 /**

package/src/lib/desk/desk.error.api.d.ts

@@ -8,17 +8,17 @@ export declare const logZohoDeskErrorToConsole: import("..").LogZohoServerErrorF
 /**
  * Parses a fetch response error into a typed Zoho Desk server error by extracting and interpreting the JSON error body.
  *
- * @param responseError - The fetch response error to parse
- * @returns The parsed Zoho server error, or undefined if the response could not be parsed
+ * @param responseError - The fetch response error to parse.
+ * @returns The parsed Zoho server error, or undefined if the response could not be parsed.
  */
 export declare function parseZohoDeskError(responseError: FetchResponseError): Promise<ParsedZohoServerError>;
 /**
  * Parses a Zoho Desk error response body into a typed error. Delegates to Desk-specific
  * error code handling before falling back to the generic Zoho error parser.
  *
- * @param errorResponseData - The raw error response data from the Zoho Desk API
- * @param responseError - The original fetch response error for context
- * @returns The parsed Zoho server error, or undefined if the error could not be classified
+ * @param errorResponseData - The raw error response data from the Zoho Desk API.
+ * @param responseError - The original fetch response error for context.
+ * @returns The parsed Zoho server error, or undefined if the error could not be classified.
  */
 export declare function parseZohoDeskServerErrorResponseData(errorResponseData: ZohoServerErrorResponseData | ZohoServerErrorResponseDataArrayRef, responseError: FetchResponseError): ParsedZohoServerError;
 /**

package/src/lib/desk/desk.factory.d.ts

@@ -41,8 +41,9 @@ export type ZohoDeskFactory = (config: ZohoDeskConfig) => ZohoDesk;
  * Unlike CRM/Recruit/Sign, the Desk API requires an `orgId` header on every request.
  * This is injected automatically from the config.
  *
- * @param factoryConfig - Configuration providing account credentials and optional overrides
- * @returns A factory function that creates authenticated Zoho Desk clients
+ * @param factoryConfig - Configuration providing account credentials and optional overrides.
+ * @returns A factory function that creates authenticated Zoho Desk clients.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zohoDeskFactory(factoryConfig: ZohoDeskFactoryConfig): ZohoDeskFactory;

package/src/lib/desk/desk.limit.d.ts

@@ -22,8 +22,8 @@ export declare const DEFAULT_ZOHO_DESK_API_RATE_LIMIT = 200;
  * Desk uses a credit-based system with `X-Rate-Limit-Remaining-v3` and `Retry-After` (in seconds)
  * rather than the `X-RATELIMIT-*` headers used by CRM/Recruit/Sign.
  *
- * @param headers - HTTP response headers from a Zoho Desk API call
- * @returns Parsed rate limit details, or null if the Desk rate limit headers are absent
+ * @param headers - HTTP response headers from a Zoho Desk API call.
+ * @returns Parsed rate limit details, or null if the Desk rate limit headers are absent.
  */
 export declare function zohoDeskRateLimitDetailsReader(headers: Headers): Maybe<ZohoRateLimitResponseDetails>;
 /**
@@ -33,7 +33,7 @@ export declare function zohoDeskRateLimitDetailsReader(headers: Headers): Maybe<
  * with the Desk-specific header reader. Unlike CRM, Desk does not provide a total limit header,
  * so the configured `maxRateLimit` (defaulting to {@link DEFAULT_ZOHO_DESK_API_RATE_LIMIT}) is used throughout.
  *
- * @param config - Optional configuration for rate limit, reset period, and 429 handling
+ * @param config - Optional configuration for rate limit, reset period, and 429 handling.
  * @returns A rate-limited fetch handler with the underlying rate limiter accessible via `_rateLimiter`
  */
 export declare function zohoDeskRateLimitedFetchHandler(config?: Maybe<ZohoRateLimitedFetchHandlerConfig>): ZohoRateLimitedFetchHandler;