@doist/comms-sdk 0.1.0-alpha.1

package/dist/esm/types/entities.js

@@ -0,0 +1,408 @@
+import { z } from 'zod';
+import { getFullCommsURL } from '../utils/url-helpers.js';
+import { USER_TYPES } from './enums.js';
+// EVERYONE / EVERYONE_IN_THREAD / GROUP_ID_MARKERS / GroupId / GroupIdMarker
+// are defined in `./enums` (re-exported through `./index`) to keep this
+// module from depending back on `./enums` for them. They're available
+// from the same public surface (`@doist/comms-sdk`) either way.
+// Reusable schema for system messages that can be either a string or an
+// object. Nullable — the backend returns `null` when there is no system
+// message.
+export const SystemMessageSchema = z.union([z.string(), z.unknown()]).nullable().optional();
+/**
+ * Shared `{ status: "ok" }` response shape. Pinned to the literal `'ok'`
+ * so a regression on the backend (e.g. a status code change) surfaces as
+ * a parse error here instead of being silently typed away. Most write
+ * endpoints that don't return an entity use this — archive / unarchive /
+ * mark-read / mark-all-read / mute / clear-unread / etc.
+ */
+export const StatusOkSchema = z.object({ status: z.literal('ok') });
+// Attachment entity from API. Mirrors the canonical backend shape produced
+// by `unify_attachments` / `validate_file_attachment_json`. Only
+// `attachmentId` and `urlType` are guaranteed; everything else depends on
+// the attachment kind (file vs image vs link preview vs unfurled GIF).
+// Loose: unknown keys from the backend pass through rather than being
+// stripped, so newly-added or off-spec fields stay accessible to callers.
+export const AttachmentSchema = z
+    .object({
+    attachmentId: z.string(),
+    urlType: z.string(),
+    title: z.string().nullable().optional(),
+    url: z.string().nullable().optional(),
+    fileName: z.string().nullable().optional(),
+    fileSize: z.number().int().nonnegative().nullable().optional(),
+    underlyingType: z.string().nullable().optional(),
+    description: z.string().nullable().optional(),
+    image: z.string().nullable().optional(),
+    imageWidth: z.number().int().nonnegative().nullable().optional(),
+    imageHeight: z.number().int().nonnegative().nullable().optional(),
+    duration: z.string().nullable().optional(),
+    uploadState: z.string().nullable().optional(),
+    video: z.string().nullable().optional(),
+    videoType: z.string().nullable().optional(),
+    videoAutoPlay: z.boolean().nullable().optional(),
+})
+    .loose();
+// Fields shared by `User` and `WorkspaceUser`. Profile fields
+// (`fullName`, `imageId`, avatar URLs) are sourced from Todoist-ID.
+export const BaseUserSchema = z.object({
+    id: z.number(),
+    fullName: z.string(),
+    shortName: z.string(),
+    firstName: z.string().nullable().optional(),
+    timezone: z.string(),
+    removed: z.boolean(),
+    imageId: z.string().nullable().optional(),
+    avatarUrls: z
+        .object({
+        s35: z.string(),
+        s60: z.string(),
+        s195: z.string(),
+        s640: z.string(),
+    })
+        .nullable()
+        .optional(),
+    restricted: z.boolean().nullable().optional(),
+    setupPending: z.boolean().nullable().optional(),
+});
+// User entity from API.
+export const UserSchema = BaseUserSchema.extend({
+    email: z.email(),
+    clientId: z.string().nullable().optional(),
+    cometChannel: z.string().nullable().optional(),
+    lang: z.string(),
+    cometServer: z.string().nullable().optional(),
+    token: z.string().nullable().optional(),
+    scheduledBanners: z.array(z.string()).nullable().optional(),
+});
+// Workspace entity from API. `default_conversation` is a base58 UUIDv7
+// string. `avatar_id` is kept (unlike the User rename to `image_id`,
+// which is a User-only change per Comms_API_changes.md PR #125).
+// `plan` is intentionally `z.string()` — see {@link WORKSPACE_PLANS}.
+export const WorkspaceSchema = z.object({
+    id: z.number(),
+    name: z.string(),
+    defaultConversation: z.string().nullable().optional(),
+    creator: z.number(),
+    created: z.date(),
+    avatarId: z.string().nullable().optional(),
+    avatarUrls: z
+        .object({
+        s35: z.string(),
+        s60: z.string(),
+        s195: z.string(),
+        s640: z.string(),
+    })
+        .nullable()
+        .optional(),
+    plan: z.string().nullable().optional(),
+});
+export const ChannelSchema = z
+    .object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    creator: z.number(),
+    userIds: z.array(z.number()).nullable().optional(),
+    color: z.number().nullable().optional(),
+    public: z.boolean(),
+    workspaceId: z.number(),
+    archived: z.boolean(),
+    created: z.date(),
+    useDefaultRecipients: z.boolean().nullable().optional(),
+    defaultGroups: z.array(z.string()).nullable().optional(),
+    defaultRecipients: z.array(z.number()).nullable().optional(),
+    isFavorited: z.boolean().nullable().optional(),
+    icon: z.number().nullable().optional(),
+    version: z.number(),
+    filters: z.record(z.string(), z.string()).nullable().optional(),
+})
+    .transform((data) => ({
+    ...data,
+    url: getFullCommsURL({ workspaceId: data.workspaceId, channelId: data.id }),
+}));
+// Thread entity from API. `pinned` (boolean) and `pinnedTs` (epoch ms or
+// null) are both surfaced — `pinned` is kept for Zapier/webhook clients.
+export const ThreadSchema = z
+    .object({
+    id: z.string(),
+    title: z.string(),
+    content: z.string(),
+    creator: z.number(),
+    creatorName: z.string().nullable().optional(),
+    channelId: z.string(),
+    workspaceId: z.number(),
+    actions: z.array(z.unknown()).nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
+    commentCount: z.number(),
+    closed: z.boolean().nullable().optional(),
+    directGroupMentions: z.array(z.string()).nullable().optional(),
+    directMentions: z.array(z.number()).nullable().optional(),
+    groups: z.array(z.string()).nullable().optional(),
+    lastEdited: z.date().nullable().optional(),
+    lastObjIndex: z.number().nullable().optional(),
+    lastUpdated: z.date(),
+    mutedUntil: z.date().nullable().optional(),
+    participants: z.array(z.number()).nullable().optional(),
+    // Backend wire shape only includes `pinned_ts` (epoch ms or null);
+    // derive `pinned` from `pinnedTs != null` if you need a bool.
+    pinned: z.boolean().optional(),
+    pinnedTs: z.number().int().nullable().optional(),
+    posted: z.date(),
+    reactions: z.record(z.string(), z.unknown()).nullable().optional(),
+    recipients: z.array(z.number()).nullable().optional(),
+    responders: z.array(z.number()).nullable().optional(),
+    snippet: z.string(),
+    snippetCreator: z.number(),
+    snippetMaskAvatarUrl: z.string().nullable().optional(),
+    snippetMaskPoster: z.string().nullable().optional(),
+    systemMessage: SystemMessageSchema,
+    toEmails: z.array(z.string()).nullable().optional(),
+    isArchived: z.boolean(),
+    isSaved: z.boolean().nullable().optional(),
+    inInbox: z.boolean().nullable().optional(),
+    lastComment: z
+        .object({
+        id: z.string(),
+        content: z.string(),
+        creator: z.number(),
+        creatorName: z.string(),
+        threadId: z.string(),
+        channelId: z.string(),
+        posted: z.date(),
+        systemMessage: SystemMessageSchema,
+        attachments: z.array(AttachmentSchema).nullable().optional(),
+        reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
+        actions: z.array(z.unknown()).nullable().optional(),
+        objIndex: z.number(),
+        lastEdited: z.date().nullable().optional(),
+        deleted: z.boolean(),
+        deletedBy: z.number().nullable().optional(),
+        directGroupMentions: z.array(z.string()).nullable().optional(),
+        directMentions: z.array(z.number()).nullable().optional(),
+        groups: z.array(z.string()).nullable().optional(),
+        recipients: z.array(z.number()).nullable().optional(),
+        toEmails: z.array(z.string()).nullable().optional(),
+        version: z.number(),
+        workspaceId: z.number(),
+    })
+        .nullable()
+        .optional(),
+})
+    .transform((data) => ({
+    ...data,
+    url: getFullCommsURL({
+        workspaceId: data.workspaceId,
+        channelId: data.channelId,
+        threadId: data.id,
+    }),
+}));
+// Group entity from API. The broadcast markers `EVERYONE` and
+// `EVERYONE_IN_THREAD` can appear in place of a real `id` in group-bearing
+// fields on threads/comments/channels.
+export const GroupSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().nullable().optional(),
+    workspaceId: z.number(),
+    userIds: z.array(z.number()),
+    version: z.number(),
+});
+// Conversation entity from API.
+export const ConversationSchema = z
+    .object({
+    id: z.string(),
+    workspaceId: z.number(),
+    userIds: z.array(z.number()),
+    messageCount: z.number().nullable().optional(),
+    lastObjIndex: z.number(),
+    snippet: z.string(),
+    snippetCreators: z.array(z.number()),
+    lastActive: z.date(),
+    mutedUntil: z.date().nullable().optional(),
+    archived: z.boolean(),
+    created: z.date(),
+    creator: z.number(),
+    title: z.string().nullable().optional(),
+    private: z.boolean().nullable().optional(),
+    lastMessage: z
+        .object({
+        // `id` may be string or number depending on the endpoint; coerced.
+        id: z.union([z.string(), z.number()]).transform(String),
+        content: z.string(),
+        creator: z.number(),
+        conversationId: z.string(),
+        posted: z.date(),
+        systemMessage: SystemMessageSchema,
+        attachments: z.array(AttachmentSchema).nullable().optional(),
+        reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
+        actions: z.array(z.unknown()).nullable().optional(),
+        objIndex: z.number().nullable().optional(),
+        lastEdited: z.date().nullable().optional(),
+        deleted: z.boolean().nullable().optional(),
+        directGroupMentions: z.array(z.string()).nullable().optional(),
+        directMentions: z.array(z.number()).nullable().optional(),
+        version: z.number().nullable().optional(),
+        workspaceId: z.number().nullable().optional(),
+    })
+        .nullable()
+        .optional(),
+})
+    .transform((data) => ({
+    ...data,
+    url: getFullCommsURL({ workspaceId: data.workspaceId, conversationId: data.id }),
+}));
+export const CommentSchema = z
+    .object({
+    id: z.string(),
+    content: z.string(),
+    creator: z.number(),
+    threadId: z.string(),
+    workspaceId: z.number(),
+    conversationId: z.string().nullable().optional(),
+    posted: z.date(),
+    lastEdited: z.date().nullable().optional(),
+    directMentions: z.array(z.number()).nullable().optional(),
+    directGroupMentions: z.array(z.string()).nullable().optional(),
+    systemMessage: SystemMessageSchema,
+    attachments: z.array(AttachmentSchema).nullable().optional(),
+    reactions: z.record(z.string(), z.unknown()).nullable().optional(),
+    objIndex: z.number().nullable().optional(),
+    creatorName: z.string().nullable().optional(),
+    channelId: z.string(),
+    recipients: z.array(z.number()).nullable().optional(),
+    groups: z.array(z.string()).nullable().optional(),
+    toEmails: z.array(z.string()).nullable().optional(),
+    deleted: z.boolean().nullable().optional(),
+    deletedBy: z.number().nullable().optional(),
+    version: z.number().nullable().optional(),
+    actions: z.array(z.unknown()).nullable().optional(),
+})
+    .transform((data) => ({
+    ...data,
+    url: getFullCommsURL({
+        workspaceId: data.workspaceId,
+        channelId: data.channelId,
+        threadId: data.threadId,
+        commentId: data.id,
+    }),
+}));
+export const WorkspaceUserSchema = BaseUserSchema.extend({
+    email: z.string().nullable().optional(),
+    userType: z.enum(USER_TYPES),
+    dateFormat: z.string().nullable().optional(),
+    theme: z.number().int().nullable().optional(),
+    timeFormat: z.string().nullable().optional(),
+    version: z.number(),
+});
+// ConversationMessage entity from API. `id` is widened to `string | number`
+// (coerced to a string post-parse) because the backend currently emits
+// either shape depending on the endpoint; the URL/reaction helpers accept
+// both.
+export const ConversationMessageSchema = z
+    .object({
+    id: z.union([z.string(), z.number()]).transform(String),
+    content: z.string(),
+    creator: z.number(),
+    conversationId: z.string(),
+    posted: z.date(),
+    systemMessage: SystemMessageSchema,
+    attachments: z.array(AttachmentSchema).nullable().optional(),
+    reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
+    actions: z.array(z.unknown()).nullable().optional(),
+    objIndex: z.number().nullable().optional(),
+    lastEdited: z.date().nullable().optional(),
+    isDeleted: z.boolean().nullable().optional(),
+    directGroupMentions: z.array(z.string()).nullable().optional(),
+    directMentions: z.array(z.number()).nullable().optional(),
+    version: z.number().nullable().optional(),
+    workspaceId: z.number(),
+})
+    .transform((data) => ({
+    ...data,
+    url: getFullCommsURL({
+        workspaceId: data.workspaceId,
+        conversationId: data.conversationId,
+        messageId: data.id,
+    }),
+}));
+// InboxThread entity from API - returns full Thread objects with additional inbox metadata.
+export const InboxThreadSchema = z
+    .object({
+    id: z.string(),
+    title: z.string(),
+    content: z.string(),
+    creator: z.number(),
+    creatorName: z.string().nullable().optional(),
+    channelId: z.string(),
+    workspaceId: z.number(),
+    actions: z.array(z.unknown()).nullable().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
+    commentCount: z.number(),
+    directGroupMentions: z.array(z.string()).nullable().optional(),
+    directMentions: z.array(z.number()).nullable().optional(),
+    groups: z.array(z.string()).nullable().optional(),
+    lastEdited: z.date().nullable().optional(),
+    lastObjIndex: z.number().nullable().optional(),
+    lastUpdated: z.date(),
+    mutedUntil: z.date().nullable().optional(),
+    participants: z.array(z.number()).nullable().optional(),
+    // Backend wire shape only includes `pinned_ts` (epoch ms or null);
+    // derive `pinned` from `pinnedTs != null` if you need a bool.
+    pinned: z.boolean().optional(),
+    pinnedTs: z.number().int().nullable().optional(),
+    posted: z.date(),
+    reactions: z.record(z.string(), z.array(z.number())).nullable().optional(),
+    recipients: z.array(z.number()).nullable().optional(),
+    snippet: z.string(),
+    snippetCreator: z.number(),
+    snippetMaskAvatarUrl: z.string().nullable().optional(),
+    snippetMaskPoster: z.string().nullable().optional(),
+    systemMessage: SystemMessageSchema,
+    isArchived: z.boolean(),
+    inInbox: z.boolean(),
+    isSaved: z.boolean().nullable().optional(),
+    closed: z.boolean(),
+    responders: z.array(z.number()).nullable().optional(),
+    lastComment: CommentSchema.nullable().optional(),
+    toEmails: z.array(z.string()).nullable().optional(),
+    version: z.number().nullable().optional(),
+})
+    .transform((data) => ({
+    ...data,
+    url: getFullCommsURL({
+        workspaceId: data.workspaceId,
+        channelId: data.channelId,
+        threadId: data.id,
+    }),
+}));
+// UnreadThread entity from API - simplified thread reference.
+export const UnreadThreadSchema = z.object({
+    threadId: z.string(),
+    channelId: z.string(),
+    objIndex: z.number(),
+    directMention: z.boolean(),
+});
+// UnreadConversation entity from API - simplified conversation reference.
+export const UnreadConversationSchema = z.object({
+    conversationId: z.string(),
+    objIndex: z.number(),
+    directMention: z.boolean(),
+});
+// SearchResult entity from API.
+export const SEARCH_RESULT_TYPES = ['thread', 'comment', 'message', 'conversation'];
+export const SearchResultSchema = z.object({
+    id: z.string(),
+    type: z.enum(SEARCH_RESULT_TYPES),
+    snippet: z.string(),
+    snippetCreatorId: z.number(),
+    snippetLastUpdated: z.date(),
+    threadId: z.string().nullable().optional(),
+    conversationId: z.string().nullable().optional(),
+    commentId: z.string().nullable().optional(),
+    channelId: z.string().nullable().optional(),
+    channelName: z.string().nullable().optional(),
+    channelColor: z.number().nullable().optional(),
+    title: z.string().nullable().optional(),
+    closed: z.boolean().nullable().optional(),
+});

package/dist/esm/types/enums.js

@@ -0,0 +1,34 @@
+/**
+ * Marker constants for the two "broadcast" group recipients. These appear
+ * in group-bearing fields (`Thread.groups`, `Comment.groups`,
+ * `Channel.defaultGroups`, `directGroupMentions`, etc.) in place of a
+ * real group ID and tell the backend to notify "everyone in the channel"
+ * or "everyone in the thread" respectively. Input and output are
+ * symmetric. Defined here (and not in `./entities`) so that `enums`
+ * stays leaf-level — `entities` imports from `enums`, never the reverse.
+ */
+export const EVERYONE = 'EVERYONE';
+export const EVERYONE_IN_THREAD = 'EVERYONE_IN_THREAD';
+/** Union of the two broadcast group markers. */
+export const GROUP_ID_MARKERS = [EVERYONE, EVERYONE_IN_THREAD];
+// User types for workspace users
+export const USER_TYPES = ['USER', 'GUEST', 'ADMIN'];
+// Workspace plans. The known values today are `'free'`, `'unlimited'`,
+// and `'business'`, but the backend can introduce new plan names without
+// coordinating a SDK release — so the schema accepts any string and the
+// const array stays as a hint for autocomplete only.
+export const WORKSPACE_PLANS = ['free', 'unlimited', 'business'];
+// Audiences that comment-creating endpoints can target alongside (or instead
+// of) individual `recipients` / custom `groups`.
+export const NOTIFY_AUDIENCES = ['channel', 'thread'];
+/**
+ * Internal mapping from {@link NotifyAudience} to the broadcast marker IDs
+ * (`EVERYONE` / `EVERYONE_IN_THREAD`) that comment- and thread-creation
+ * endpoints use on the wire. SDK consumers should use {@link NotifyAudience}
+ * via `notifyAudience` on the request args rather than passing these IDs
+ * directly.
+ */
+export const NOTIFY_AUDIENCE_GROUP_IDS = {
+    channel: EVERYONE,
+    thread: EVERYONE_IN_THREAD,
+};

package/dist/esm/types/errors.js

@@ -0,0 +1,8 @@
+import { CustomError } from 'ts-custom-error';
+export class CommsRequestError extends CustomError {
+    constructor(message, httpStatusCode, responseData) {
+        super(message);
+        this.httpStatusCode = httpStatusCode;
+        this.responseData = responseData;
+    }
+}

package/dist/esm/types/http.js

@@ -0,0 +1 @@
+export const HTTP_METHODS = ['POST', 'GET', 'PUT', 'PATCH', 'DELETE'];

package/dist/esm/types/index.js

@@ -0,0 +1,5 @@
+export * from './entities.js';
+export * from './enums.js';
+export * from './errors.js';
+export * from './http.js';
+export * from './requests.js';

package/dist/esm/types/requests.js

@@ -0,0 +1,114 @@
+import { z } from 'zod';
+import { AttachmentSchema } from './entities.js';
+import { NOTIFY_AUDIENCES } from './enums.js';
+/**
+ * Create-side requests require an `id` on the wire. The SDK clients accept
+ * `id` as optional and auto-generate one via
+ * {@link import('../utils/uuidv7').generateId} when the caller doesn't pass
+ * one — callers can still mint their own ID locally (e.g. for optimistic
+ * UI) and have it stick.
+ */
+export const CreateChannelArgsSchema = z.object({
+    workspaceId: z.number(),
+    name: z.string(),
+    id: z.string().optional(),
+    userIds: z.array(z.number()).nullable().optional(),
+    color: z.number().nullable().optional(),
+    public: z.boolean().nullable().optional(),
+    description: z.string().nullable().optional(),
+    defaultGroups: z.array(z.string()).nullable().optional(),
+    defaultRecipients: z.array(z.number()).nullable().optional(),
+    isFavorited: z.boolean().nullable().optional(),
+    icon: z.number().nullable().optional(),
+});
+export const UpdateChannelArgsSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    color: z.number().nullable().optional(),
+    public: z.boolean().nullable().optional(),
+    description: z.string().nullable().optional(),
+    defaultGroups: z.array(z.string()).nullable().optional(),
+    defaultRecipients: z.array(z.number()).nullable().optional(),
+    isFavorited: z.boolean().nullable().optional(),
+    icon: z.number().nullable().optional(),
+});
+export const CreateThreadArgsSchema = z.object({
+    channelId: z.string(),
+    content: z.string(),
+    title: z.string().nullable().optional(),
+    id: z.string().optional(),
+    recipients: z.array(z.number()).nullable().optional(),
+    groups: z.array(z.string()).nullable().optional(),
+});
+export const UpdateThreadArgsSchema = z.object({
+    id: z.string(),
+    title: z.string().nullable().optional(),
+    content: z.string().nullable().optional(),
+});
+export const CreateCommentArgsSchema = z.object({
+    threadId: z.string(),
+    content: z.string(),
+    id: z.string().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
+    actions: z.unknown().nullable().optional(),
+    recipients: z.array(z.number()).nullable().optional(),
+    groups: z.array(z.string()).nullable().optional(),
+    directMentions: z.array(z.number()).nullable().optional(),
+    directGroupMentions: z.array(z.string()).nullable().optional(),
+    notifyAudience: z.enum(NOTIFY_AUDIENCES).nullable().optional(),
+});
+export const UpdateCommentArgsSchema = z.object({
+    id: z.string(),
+    content: z.string(),
+});
+export const CreateConversationArgsSchema = z.object({
+    workspaceId: z.number(),
+    recipients: z.array(z.number()),
+    id: z.string().optional(),
+    title: z.string().nullable().optional(),
+});
+export const CreateMessageArgsSchema = z
+    .object({
+    conversationId: z.string().nullable().optional(),
+    threadId: z.string().nullable().optional(),
+    content: z.string(),
+    id: z.string().optional(),
+    attachments: z.array(AttachmentSchema).nullable().optional(),
+})
+    .refine((data) => {
+    return ((data.conversationId && !data.threadId) || (!data.conversationId && data.threadId));
+}, {
+    message: 'Exactly one of conversationId or threadId must be provided',
+});
+export const GetChannelsArgsSchema = z.object({
+    workspaceId: z.number(),
+    archived: z.boolean().nullable().optional(),
+});
+export const GetThreadsArgsSchema = z.object({
+    workspaceId: z.number(),
+    channelId: z.string().nullable().optional(),
+    archived: z.boolean().nullable().optional(),
+    newerThan: z.date().nullable().optional(),
+    olderThan: z.date().nullable().optional(),
+    limit: z.number().nullable().optional(),
+});
+export const GetCommentsArgsSchema = z.object({
+    threadId: z.string(),
+    from: z.date().nullable().optional(),
+    newerThan: z.date().nullable().optional(),
+    olderThan: z.date().nullable().optional(),
+    limit: z.number().nullable().optional(),
+});
+export const GetConversationsArgsSchema = z.object({
+    workspaceId: z.number(),
+    archived: z.boolean().nullable().optional(),
+});
+export const GetOrCreateConversationArgsSchema = z.object({
+    workspaceId: z.number(),
+    userIds: z.array(z.number()),
+    id: z.string().optional(),
+});
+// Inbox
+export const ARCHIVE_FILTER_VALUES = ['active', 'archived', 'all'];
+// Threads
+export const THREAD_ACTIONS = ['close', 'reopen'];

package/dist/esm/utils/case-conversion.js

@@ -0,0 +1,47 @@
+import camelcase from 'camelcase';
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isArray(value) {
+    return Array.isArray(value);
+}
+function toSnakeCase(str) {
+    return str
+        .replace(/([A-Z])/g, '_$1')
+        .toLowerCase()
+        .replace(/^_/, '');
+}
+/**
+ * @internal
+ */
+export function camelCaseKeys(obj) {
+    if (isArray(obj)) {
+        return obj.map(camelCaseKeys);
+    }
+    if (isObject(obj)) {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            const camelKey = camelcase(key);
+            result[camelKey] = camelCaseKeys(value);
+        }
+        return result;
+    }
+    return obj;
+}
+/**
+ * @internal
+ */
+export function snakeCaseKeys(obj) {
+    if (isArray(obj)) {
+        return obj.map(snakeCaseKeys);
+    }
+    if (isObject(obj)) {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            const snakeKey = toSnakeCase(key);
+            result[snakeKey] = snakeCaseKeys(value);
+        }
+        return result;
+    }
+    return obj;
+}

package/dist/esm/utils/index.js

@@ -0,0 +1,3 @@
+export * from './case-conversion.js';
+export * from './url-helpers.js';
+export * from './uuidv7.js';

package/dist/esm/utils/timestamp-conversion.js

@@ -0,0 +1,45 @@
+/**
+ * Converts a Unix timestamp (in seconds) to a Date object.
+ * @param timestamp - Unix timestamp in seconds
+ * @returns Date object
+ */
+export function timestampToDate(timestamp) {
+    return new Date(timestamp * 1000);
+}
+/**
+ * Recursively transforms all timestamp fields (ending in 'Ts') in an object to Date objects.
+ * Also renames the fields by removing the 'Ts' suffix.
+ * @param obj - The object to transform
+ * @returns The transformed object with Date fields
+ */
+export function transformTimestamps(obj) {
+    if (obj === null || obj === undefined) {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => transformTimestamps(item));
+    }
+    if (typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            // Check if the key ends with 'Ts' and the value is a number
+            if (key.endsWith('Ts') && typeof value === 'number') {
+                // Remove 'Ts' suffix and convert to Date
+                const newKey = key.slice(0, -2);
+                // If the base key already exists in the original object, use *Date suffix
+                // to avoid overwriting it (e.g. pinned + pinnedTs → pinned + pinnedDate)
+                const targetKey = newKey in obj ? `${newKey}Date` : newKey;
+                result[targetKey] = timestampToDate(value);
+            }
+            else if (typeof value === 'object' && value !== null) {
+                // Recursively transform nested objects
+                result[key] = transformTimestamps(value);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    return obj;
+}