@doist/todoist-api-typescript 7.9.1 → 7.10.0

package/dist/esm/transport/fetch-with-retry.js

@@ -1,203 +0,0 @@
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-import { isNetworkError } from '../types/http.js';
-import { getDefaultDispatcher } from './http-dispatcher.js';
-/**
- * Default retry configuration matching the original axios-retry behavior
- */
-const DEFAULT_RETRY_CONFIG = {
-    retries: 3,
-    retryCondition: isNetworkError,
-    retryDelay: (retryNumber) => {
-        // First retry: immediate (0ms delay)
-        // Subsequent retries: 500ms delay
-        return retryNumber === 1 ? 0 : 500;
-    },
-};
-const TIMEOUT_ERROR_NAME = 'TimeoutError';
-function createTimeoutError(timeoutMs) {
-    const error = new Error(`Request timeout after ${timeoutMs}ms`);
-    error.name = TIMEOUT_ERROR_NAME;
-    return error;
-}
-/**
- * Converts Headers object to a plain object
- */
-function headersToObject(headers) {
-    const result = {};
-    headers.forEach((value, key) => {
-        result[key] = value;
-    });
-    return result;
-}
-/**
- * Creates an AbortSignal that aborts after timeoutMs. Returns the signal and a
- * clear function to cancel the timeout early.
- */
-function createTimeoutSignal(timeoutMs, existingSignal) {
-    const controller = new AbortController();
-    // Timeout logic
-    const timeoutId = setTimeout(() => {
-        controller.abort(createTimeoutError(timeoutMs));
-    }, timeoutMs);
-    let abortHandler;
-    function clear() {
-        clearTimeout(timeoutId);
-        if (existingSignal && abortHandler) {
-            existingSignal.removeEventListener('abort', abortHandler);
-        }
-    }
-    // If there's an existing signal, forward its abort
-    if (existingSignal) {
-        if (existingSignal.aborted) {
-            clearTimeout(timeoutId);
-            controller.abort(existingSignal.reason);
-        }
-        else {
-            abortHandler = () => {
-                clearTimeout(timeoutId);
-                controller.abort(existingSignal.reason);
-            };
-            existingSignal.addEventListener('abort', abortHandler, { once: true });
-        }
-    }
-    // Clean up timeout when request completes
-    controller.signal.addEventListener('abort', () => {
-        clearTimeout(timeoutId);
-    });
-    return { signal: controller.signal, clear };
-}
-/**
- * Converts native fetch Response to CustomFetchResponse for consistency
- */
-function convertResponseToCustomFetch(response) {
-    // Clone the response so we can read it multiple times (if clone method exists)
-    const clonedResponse = response.clone ? response.clone() : response;
-    return {
-        ok: response.ok,
-        status: response.status,
-        statusText: response.statusText,
-        headers: headersToObject(response.headers),
-        text: () => clonedResponse.text(),
-        json: () => response.json(),
-    };
-}
-/**
- * Performs a fetch request with retry logic and timeout support
- */
-export async function fetchWithRetry(args) {
-    const { url, options = {}, retryConfig = {}, customFetch } = args;
-    const config = Object.assign(Object.assign({}, DEFAULT_RETRY_CONFIG), retryConfig);
-    const { timeout, signal: userSignal } = options, fetchOptions = __rest(options, ["timeout", "signal"]);
-    let lastError;
-    for (let attempt = 0; attempt <= config.retries; attempt++) {
-        // Timeout clear function for this attempt (hoisted for catch scope)
-        let clearTimeoutFn;
-        try {
-            // Set up timeout and signal handling
-            let requestSignal = userSignal || undefined;
-            if (timeout && timeout > 0) {
-                const timeoutResult = createTimeoutSignal(timeout, requestSignal);
-                requestSignal = timeoutResult.signal;
-                clearTimeoutFn = timeoutResult.clear;
-            }
-            // Use custom fetch or native fetch
-            let fetchResponse;
-            if (customFetch) {
-                fetchResponse = await customFetch(url, Object.assign(Object.assign({}, fetchOptions), { signal: requestSignal, timeout }));
-            }
-            else {
-                const dispatcher = await getDefaultDispatcher();
-                const nativeFetchOptions = Object.assign(Object.assign({}, fetchOptions), { signal: requestSignal });
-                if (dispatcher !== undefined) {
-                    // @ts-expect-error - dispatcher is a valid option for Node.js fetch but not in the TS types
-                    nativeFetchOptions.dispatcher = dispatcher;
-                }
-                const nativeResponse = await fetch(url, nativeFetchOptions);
-                fetchResponse = convertResponseToCustomFetch(nativeResponse);
-            }
-            // Check if the response is successful
-            if (!fetchResponse.ok) {
-                const errorMessage = `HTTP ${fetchResponse.status}: ${fetchResponse.statusText}`;
-                const error = new Error(errorMessage);
-                error.status = fetchResponse.status;
-                error.statusText = fetchResponse.statusText;
-                error.response = {
-                    data: undefined, // Will be set below if we can parse the response
-                    status: fetchResponse.status,
-                    statusText: fetchResponse.statusText,
-                    headers: fetchResponse.headers,
-                };
-                // Try to get response body for error details
-                try {
-                    const responseText = await fetchResponse.text();
-                    let responseData;
-                    try {
-                        responseData = responseText ? JSON.parse(responseText) : undefined;
-                    }
-                    catch (_a) {
-                        responseData = responseText;
-                    }
-                    error.data = responseData;
-                    error.response.data = responseData;
-                }
-                catch (_b) {
-                    // If we can't read the response body, that's OK
-                }
-                throw error;
-            }
-            // Parse response
-            const responseText = await fetchResponse.text();
-            let data;
-            try {
-                data = responseText ? JSON.parse(responseText) : undefined;
-            }
-            catch (_c) {
-                // If JSON parsing fails, return the raw text
-                data = responseText;
-            }
-            // Success – clear pending timeout (if any) so Node can exit promptly
-            if (clearTimeoutFn) {
-                clearTimeoutFn();
-            }
-            return {
-                data,
-                status: fetchResponse.status,
-                statusText: fetchResponse.statusText,
-                headers: fetchResponse.headers,
-            };
-        }
-        catch (error) {
-            if (clearTimeoutFn) {
-                clearTimeoutFn();
-            }
-            lastError = error;
-            // Check if this error should trigger a retry
-            const shouldRetry = attempt < config.retries && config.retryCondition(lastError);
-            if (!shouldRetry) {
-                // Add network error flag for network errors
-                if (isNetworkError(lastError)) {
-                    const networkError = lastError;
-                    networkError.isNetworkError = true;
-                }
-                throw lastError;
-            }
-            // Wait before retrying
-            const delay = config.retryDelay(attempt + 1);
-            if (delay > 0) {
-                await new Promise((resolve) => setTimeout(resolve, delay));
-            }
-        }
-    }
-    // This should never be reached, but just in case
-    throw lastError || new Error('Request failed after retries');
-}

package/dist/esm/transport/http-client.js

@@ -1,128 +0,0 @@
-import { v4 as uuidv4 } from 'uuid';
-import { API_BASE_URI } from '../consts/endpoints.js';
-import { TodoistRequestError } from '../types/errors.js';
-import { isHttpError, isNetworkError } from '../types/http.js';
-import { camelCaseKeys, snakeCaseKeys } from '../utils/case-conversion.js';
-import { fetchWithRetry } from './fetch-with-retry.js';
-export function paramsSerializer(params) {
-    const qs = new URLSearchParams();
-    Object.keys(params).forEach((key) => {
-        const value = params[key];
-        if (value !== null && value !== undefined) {
-            if (Array.isArray(value)) {
-                qs.append(key, JSON.stringify(value));
-            }
-            else if (typeof value === 'string' ||
-                typeof value === 'number' ||
-                typeof value === 'boolean') {
-                qs.append(key, String(value));
-            }
-            else {
-                qs.append(key, JSON.stringify(value));
-            }
-        }
-    });
-    return qs.toString();
-}
-const defaultHeaders = {
-    'Content-Type': 'application/json',
-};
-function getAuthHeader(apiKey) {
-    return `Bearer ${apiKey}`;
-}
-function getRetryDelay(retryCount) {
-    return retryCount === 1 ? 0 : 500;
-}
-function getTodoistRequestError(args) {
-    const { error, originalStack } = args;
-    const requestError = new TodoistRequestError(error.message);
-    requestError.stack = originalStack ? originalStack.stack : error.stack;
-    if (isHttpError(error)) {
-        requestError.httpStatusCode = error.status;
-        requestError.responseData = error.data;
-    }
-    return requestError;
-}
-function getRequestConfiguration(args) {
-    const { baseURL, apiToken, requestId, customHeaders } = args;
-    const authHeader = apiToken ? { Authorization: getAuthHeader(apiToken) } : undefined;
-    const requestIdHeader = requestId ? { 'X-Request-Id': requestId } : undefined;
-    const headers = Object.assign(Object.assign(Object.assign(Object.assign({}, defaultHeaders), authHeader), requestIdHeader), customHeaders);
-    return { baseURL, headers };
-}
-function getHttpClientConfig(args) {
-    const { baseURL, apiToken, requestId, customHeaders } = args;
-    const configuration = getRequestConfiguration({ baseURL, apiToken, requestId, customHeaders });
-    return Object.assign(Object.assign({}, configuration), { timeout: 30000, retry: {
-            retries: 3,
-            retryCondition: isNetworkError,
-            retryDelay: getRetryDelay,
-        } });
-}
-export function isSuccess(response) {
-    return response.status >= 200 && response.status < 300;
-}
-export async function request(args) {
-    const { httpMethod, baseUri, relativePath, apiToken, payload, requestId: initialRequestId, hasSyncCommands, customHeaders, customFetch, } = args;
-    // Capture original stack for better error reporting
-    const originalStack = new Error();
-    try {
-        let requestId = initialRequestId;
-        // Sync api don't allow a request id in the CORS
-        if (httpMethod === 'POST' && !requestId && !baseUri.includes(API_BASE_URI)) {
-            requestId = uuidv4();
-        }
-        const config = getHttpClientConfig({ baseURL: baseUri, apiToken, requestId, customHeaders });
-        const url = `${baseUri}${relativePath}`;
-        const fetchOptions = {
-            method: httpMethod,
-            headers: config.headers,
-            timeout: config.timeout,
-        };
-        let finalUrl = url;
-        switch (httpMethod) {
-            case 'GET':
-                // For GET requests, add query parameters to URL
-                if (payload) {
-                    // Convert payload from camelCase to snake_case
-                    const convertedPayload = snakeCaseKeys(payload);
-                    const queryString = paramsSerializer(convertedPayload);
-                    if (queryString) {
-                        const separator = url.includes('?') ? '&' : '?';
-                        finalUrl = `${url}${separator}${queryString}`;
-                    }
-                }
-                break;
-            case 'POST':
-            case 'PUT':
-            case 'DELETE': {
-                // Convert payload from camelCase to snake_case
-                // Note: While DELETE with body is uncommon, the Todoist API uses it for some endpoints
-                if (payload) {
-                    const convertedPayload = snakeCaseKeys(payload);
-                    const body = hasSyncCommands
-                        ? JSON.stringify(convertedPayload)
-                        : JSON.stringify(convertedPayload);
-                    fetchOptions.body = body;
-                }
-                break;
-            }
-        }
-        // Make the request
-        const response = await fetchWithRetry({
-            url: finalUrl,
-            options: fetchOptions,
-            retryConfig: config.retry,
-            customFetch,
-        });
-        // Convert snake_case response to camelCase
-        const convertedData = camelCaseKeys(response.data);
-        return Object.assign(Object.assign({}, response), { data: convertedData });
-    }
-    catch (error) {
-        if (!(error instanceof Error)) {
-            throw new Error('An unknown error occurred during the request');
-        }
-        throw getTodoistRequestError({ error, originalStack });
-    }
-}

package/dist/esm/transport/http-dispatcher.js

@@ -1,35 +0,0 @@
-// Use effectively-disabled keep-alive so short-lived CLI processes do not stay
-// open waiting on idle sockets. Undici requires positive values, so we use 1ms.
-const KEEP_ALIVE_OPTIONS = {
-    keepAliveTimeout: 1,
-    keepAliveMaxTimeout: 1,
-};
-let defaultDispatcherPromise;
-export function getDefaultDispatcher() {
-    if (!isNodeEnvironment()) {
-        return Promise.resolve(undefined);
-    }
-    if (!defaultDispatcherPromise) {
-        defaultDispatcherPromise = createDefaultDispatcher().catch((error) => {
-            defaultDispatcherPromise = undefined;
-            throw error;
-        });
-    }
-    return defaultDispatcherPromise;
-}
-export async function resetDefaultDispatcherForTests() {
-    if (!defaultDispatcherPromise) {
-        return;
-    }
-    const dispatcherPromise = defaultDispatcherPromise;
-    defaultDispatcherPromise = undefined;
-    await dispatcherPromise.then((dispatcher) => dispatcher.close(), () => undefined);
-}
-async function createDefaultDispatcher() {
-    const { EnvHttpProxyAgent } = await import('undici');
-    return new EnvHttpProxyAgent(KEEP_ALIVE_OPTIONS);
-}
-function isNodeEnvironment() {
-    var _a;
-    return typeof process !== 'undefined' && Boolean((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node);
-}

package/dist/esm/types/activity/index.js

@@ -1,2 +0,0 @@
-export * from './types.js';
-export * from './requests.js';

package/dist/esm/types/activity/requests.js

@@ -1 +0,0 @@
-export {};

package/dist/esm/types/activity/types.js

@@ -1,25 +0,0 @@
-import { z } from 'zod';
-/**
- * Flexible object containing event-specific data.
- * Uses z.record to accept any properties for forward compatibility.
- */
-export const ActivityEventExtraDataSchema = z.record(z.string(), z.any()).nullable();
-/**
- * Activity log event schema. Accepts unknown fields for forward compatibility.
- */
-export const ActivityEventSchema = z
-    .object({
-    objectType: z.string(),
-    objectId: z.string(),
-    eventType: z.string(),
-    eventDate: z.string(),
-    id: z
-        .union([z.string(), z.number()])
-        .transform((val) => { var _a; return (_a = val === null || val === void 0 ? void 0 : val.toString()) !== null && _a !== void 0 ? _a : null; })
-        .nullable(),
-    parentProjectId: z.string().nullable(),
-    parentItemId: z.string().nullable(),
-    initiatorId: z.string().nullable(),
-    extraData: ActivityEventExtraDataSchema,
-})
-    .catchall(z.any());

package/dist/esm/types/backups/index.js

@@ -1,2 +0,0 @@
-export * from './types.js';
-export * from './requests.js';

package/dist/esm/types/backups/requests.js

@@ -1 +0,0 @@
-export {};

package/dist/esm/types/backups/types.js

@@ -1,5 +0,0 @@
-import { z } from 'zod';
-export const BackupSchema = z.object({
-    version: z.string(),
-    url: z.string(),
-});

package/dist/esm/types/comments/index.js

@@ -1,2 +0,0 @@
-export * from './types.js';
-export * from './requests.js';

package/dist/esm/types/comments/requests.js

@@ -1 +0,0 @@
-export {};

package/dist/esm/types/comments/types.js

@@ -1,57 +0,0 @@
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-import { z } from 'zod';
-/** Available file attachment upload states. */
-export const UPLOAD_STATES = ['pending', 'completed'];
-export const AttachmentSchema = z
-    .object({
-    resourceType: z.string(),
-})
-    .extend({
-    fileName: z.string().nullable().optional(),
-    fileSize: z.number().int().nullable().optional(),
-    fileType: z.string().nullable().optional(),
-    fileUrl: z.string().nullable().optional(),
-    fileDuration: z.number().int().nullable().optional(),
-    uploadState: z.enum(UPLOAD_STATES).nullable().optional(),
-    image: z.string().nullable().optional(),
-    imageWidth: z.number().int().nullable().optional(),
-    imageHeight: z.number().int().nullable().optional(),
-    url: z.string().nullable().optional(),
-    title: z.string().nullable().optional(),
-});
-export const RawCommentSchema = z
-    .object({
-    id: z.string(),
-    itemId: z.string().optional(),
-    projectId: z.string().optional(),
-    content: z.string(),
-    postedAt: z.string(),
-    fileAttachment: AttachmentSchema.nullable(),
-    postedUid: z.string(),
-    uidsToNotify: z.array(z.string()).nullable(),
-    reactions: z.record(z.string(), z.array(z.string())).nullable(),
-    isDeleted: z.boolean(),
-})
-    .refine((data) => {
-    // At least one of itemId or projectId must be present
-    return ((data.itemId !== undefined && data.projectId === undefined) ||
-        (data.itemId === undefined && data.projectId !== undefined));
-}, {
-    message: 'Exactly one of itemId or projectId must be provided',
-});
-export const CommentSchema = RawCommentSchema.transform((data) => {
-    const { itemId } = data, rest = __rest(data, ["itemId"]);
-    return Object.assign(Object.assign({}, rest), { 
-        // Map itemId to taskId for backwards compatibility
-        taskId: itemId });
-});

package/dist/esm/types/common.js

@@ -1,7 +0,0 @@
-import { z } from 'zod';
-/**
- * Zod schema that accepts both string and number values and coerces to string.
- * The REST API returns numeric IDs while the Sync API returns string IDs.
- */
-const StringOrNumberSchema = z.union([z.string(), z.number()]).transform((val) => String(val));
-export { StringOrNumberSchema };

package/dist/esm/types/emails/index.js

@@ -1 +0,0 @@
-export * from './requests.js';

package/dist/esm/types/emails/requests.js

@@ -1,2 +0,0 @@
-/** Object types that support email forwarding. */
-export const EMAIL_OBJECT_TYPES = ['project', 'project_comments', 'task'];

package/dist/esm/types/errors.js

@@ -1,24 +0,0 @@
-import { CustomError } from 'ts-custom-error';
-const authenticationErrorCodes = [401, 403];
-export class TodoistRequestError extends CustomError {
-    constructor(message, httpStatusCode, responseData) {
-        super(message);
-        this.message = message;
-        this.httpStatusCode = httpStatusCode;
-        this.responseData = responseData;
-        this.isAuthenticationError = () => {
-            if (!this.httpStatusCode) {
-                return false;
-            }
-            return authenticationErrorCodes.includes(this.httpStatusCode);
-        };
-        Object.defineProperty(this, 'name', { value: 'TodoistRequestError' });
-    }
-}
-export class TodoistArgumentError extends CustomError {
-    constructor(message) {
-        super(message);
-        this.message = message;
-        Object.defineProperty(this, 'name', { value: 'TodoistArgumentError' });
-    }
-}

package/dist/esm/types/folders/index.js

@@ -1 +0,0 @@
-export * from './requests.js';

package/dist/esm/types/folders/requests.js

@@ -1 +0,0 @@
-export {};

package/dist/esm/types/http.js

@@ -1,20 +0,0 @@
-/**
- * Type guard to check if an error is a network error
- */
-export function isNetworkError(error) {
-    // Network errors in fetch are typically TypeError with specific messages.
-    // Timeout errors are created by fetch-with-retry with the TimeoutError name.
-    return ((error instanceof TypeError &&
-        (error.message.includes('fetch') ||
-            error.message.includes('network') ||
-            error.message.includes('Failed to fetch') ||
-            error.message.includes('NetworkError'))) ||
-        error.name === 'TimeoutError' ||
-        error.isNetworkError === true);
-}
-/**
- * Type guard to check if an error is an HTTP error
- */
-export function isHttpError(error) {
-    return 'status' in error && typeof error.status === 'number';
-}

package/dist/esm/types/id-mappings/index.js

@@ -1,2 +0,0 @@
-export * from './types.js';
-export * from './requests.js';

package/dist/esm/types/id-mappings/requests.js

@@ -1,17 +0,0 @@
-/** Object types that support ID mappings. */
-export const ID_MAPPING_OBJECT_TYPES = [
-    'sections',
-    'tasks',
-    'comments',
-    'reminders',
-    'location_reminders',
-    'projects',
-];
-/** Object types that support moved ID lookups. */
-export const MOVED_ID_OBJECT_TYPES = [
-    'sections',
-    'tasks',
-    'comments',
-    'reminders',
-    'location_reminders',
-];

package/dist/esm/types/id-mappings/types.js

@@ -1,9 +0,0 @@
-import { z } from 'zod';
-export const IdMappingSchema = z.object({
-    oldId: z.string().nullable(),
-    newId: z.string().nullable(),
-});
-export const MovedIdSchema = z.object({
-    oldId: z.string(),
-    newId: z.string(),
-});

package/dist/esm/types/index.js

@@ -1,20 +0,0 @@
-export * from './tasks/index.js';
-export * from './projects/index.js';
-export * from './sections/index.js';
-export * from './labels/index.js';
-export * from './comments/index.js';
-export * from './reminders/index.js';
-export * from './users/index.js';
-export * from './productivity/index.js';
-export * from './activity/index.js';
-export * from './workspaces/index.js';
-export * from './folders/index.js';
-export * from './insights/index.js';
-export * from './backups/index.js';
-export * from './id-mappings/index.js';
-export * from './emails/index.js';
-export * from './uploads/index.js';
-export * from './templates/index.js';
-export * from './errors.js';
-export * from './http.js';
-export * from './sync/index.js';

package/dist/esm/types/insights/index.js

@@ -1,2 +0,0 @@
-export * from './types.js';
-export * from './requests.js';

package/dist/esm/types/insights/requests.js

@@ -1 +0,0 @@
-export {};