@doist/todoist-sdk 14.2.0 → 15.0.0

package/dist/cjs/utils/multipart-upload.js

@@ -1,293 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
-var __asyncValues = (this && this.__asyncValues) || function (o) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var m = o[Symbol.asyncIterator], i;
-    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
-    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
-    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
-};
-var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var g = generator.apply(thisArg, _arguments || []), i, q = [];
-    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
-    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
-    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
-    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
-    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
-    function fulfill(value) { resume("next", value); }
-    function reject(value) { resume("throw", value); }
-    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadMultipartFile = uploadMultipartFile;
-const uuid_1 = require("uuid");
-const fetch_with_retry_1 = require("../transport/fetch-with-retry");
-const case_conversion_1 = require("./case-conversion");
-/**
- * Helper function to determine content-type from filename extension.
- * @param fileName - The filename to analyze
- * @returns The appropriate MIME type
- */
-function getContentTypeFromFileName(fileName) {
-    const extension = fileName.toLowerCase().split('.').pop();
-    switch (extension) {
-        case 'png':
-            return 'image/png';
-        case 'jpg':
-        case 'jpeg':
-            return 'image/jpeg';
-        case 'gif':
-            return 'image/gif';
-        case 'webp':
-            return 'image/webp';
-        case 'svg':
-            return 'image/svg+xml';
-        default:
-            return 'application/octet-stream';
-    }
-}
-/**
- * Escapes a value for use inside a quoted `Content-Disposition` parameter,
- * where a raw quote would end the value early and a raw CR or LF would end the
- * header. Note that a lone CR needs escaping too, not just CRLF pairs.
- *
- * This is the same escaping the platform's own `FormData` encoder applies, so
- * servers see exactly what they would from any browser or from undici.
- */
-function escapeDispositionValue(value) {
-    return value.replace(/"/g, '%22').replace(/\r/g, '%0D').replace(/\n/g, '%0A');
-}
-/**
- * Lays out a `multipart/form-data` payload around a single file part, as the
- * text that goes before and after the file content. Keeping the file content
- * out of it lets the same layout serve both a `Blob` body and a streamed one.
- */
-function layOutMultipart(args) {
-    const { fileName, fileContentType, additionalFields } = args;
-    const boundary = `----todoist-sdk-${(0, uuid_1.v4)()}`;
-    const head = `--${boundary}\r\n` +
-        `Content-Disposition: form-data; name="file"; filename="${escapeDispositionValue(fileName)}"\r\n` +
-        `Content-Type: ${fileContentType}\r\n\r\n`;
-    let tail = '\r\n';
-    for (const [key, value] of Object.entries(additionalFields)) {
-        if (value !== undefined && value !== null) {
-            tail +=
-                `--${boundary}\r\n` +
-                    `Content-Disposition: form-data; name="${escapeDispositionValue(key)}"\r\n\r\n` +
-                    `${value.toString()}\r\n`;
-        }
-    }
-    tail += `--${boundary}--\r\n`;
-    return { boundary, head, tail };
-}
-/**
- * Wraps a Node readable stream as a `multipart/form-data` request body.
- *
- * The result is a web `ReadableStream`, which both the runtime's `fetch` and
- * undici's own accept — unlike a Node stream or a `FormData`, either of which
- * only works with one particular client. The file is never buffered, so the
- * request is sent with `Transfer-Encoding: chunked`.
- */
-function streamMultipartBody(file, parts) {
-    const encoder = new TextEncoder();
-    function chunks() {
-        return __asyncGenerator(this, arguments, function* chunks_1() {
-            var _a, e_1, _b, _c;
-            yield yield __await(encoder.encode(parts.head));
-            try {
-                for (var _d = true, file_1 = __asyncValues(file), file_1_1; file_1_1 = yield __await(file_1.next()), _a = file_1_1.done, !_a; _d = true) {
-                    _c = file_1_1.value;
-                    _d = false;
-                    const chunk = _c;
-                    yield yield __await(typeof chunk === 'string' ? encoder.encode(chunk) : new Uint8Array(chunk));
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (!_d && !_a && (_b = file_1.return)) yield __await(_b.call(file_1));
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-            yield yield __await(encoder.encode(parts.tail));
-        });
-    }
-    const iterator = chunks();
-    // Driven by hand rather than with `ReadableStream.from`, which is absent
-    // from this project's DOM lib types and is still missing in some browsers,
-    // or `Readable.toWeb`, which would drag a Node-only import into a module
-    // that browsers also load.
-    return new ReadableStream({
-        async pull(controller) {
-            const { value, done } = await iterator.next();
-            if (done) {
-                controller.close();
-                return;
-            }
-            controller.enqueue(value);
-        },
-        async cancel(reason) {
-            var _a;
-            await ((_a = iterator.return) === null || _a === void 0 ? void 0 : _a.call(iterator, reason));
-        },
-    });
-}
-/**
- * Builds the request body for a multipart upload.
- *
- * Deliberately avoids `FormData`. A `FormData` body is only encoded by the
- * `fetch` that owns that `FormData` class — undici brands its own — so a body
- * built from the global `FormData` and sent through undici's `fetch`, or the
- * reverse, is stringified to the literal `"[object FormData]"` and the upload
- * silently carries no file. The `form-data` package fares worse: neither
- * `fetch` accepts it as a body at all. `Blob` and `ReadableStream` carry no
- * such brand and work with whichever `fetch` dispatches the request,
- * including a caller-supplied `customFetch`.
- */
-function buildMultipartBody(args) {
-    const { file, fileName, fileContentType, additionalFields } = args;
-    const parts = layOutMultipart({ fileName, fileContentType, additionalFields });
-    const contentType = `multipart/form-data; boundary=${parts.boundary}`;
-    if (file instanceof Blob) {
-        // A Blob keeps its length, so the request gets a Content-Length and
-        // stays replayable if it has to be retried. File-backed Blobs (from
-        // `fs.openAsBlob`) stay lazy here, so nothing is read into memory.
-        return { body: new Blob([parts.head, file, parts.tail]), contentType, isStreamed: false };
-    }
-    return { body: streamMultipartBody(file, parts), contentType, isStreamed: true };
-}
-/**
- * Uploads a file using multipart/form-data.
- *
- * This is a shared utility for uploading files to Todoist endpoints that require
- * multipart/form-data content type (e.g., file uploads, workspace logo uploads).
- *
- * Supports both browser (Blob/File) and Node.js (Buffer/ReadableStream/path) environments.
- *
- * @param baseUrl - The base API URL (e.g., https://api.todoist.com/api/v1/)
- * @param authToken - The authentication token
- * @param endpoint - The relative endpoint path (e.g., 'uploads', 'workspaces/logo')
- * @param file - The file content (Blob/File for browser, or Buffer/ReadableStream/path for Node)
- * @param fileName - Optional file name (required for Buffer/Stream, optional for paths and File objects)
- * @param additionalFields - Additional form fields to include (e.g., project_id, workspace_id)
- * @param requestId - Optional request ID for idempotency
- * @returns The response data from the server
- *
- * @example
- * ```typescript
- * // Upload from a file path
- * const result = await uploadMultipartFile(
- *   'https://api.todoist.com/api/v1/',
- *   'my-token',
- *   'uploads',
- *   '/path/to/file.pdf',
- *   undefined,
- *   { project_id: '12345' }
- * )
- *
- * // Upload from a Buffer
- * const buffer = Buffer.from('file content')
- * const result = await uploadMultipartFile(
- *   'https://api.todoist.com/api/v1/',
- *   'my-token',
- *   'uploads',
- *   buffer,
- *   'document.pdf',
- *   { project_id: '12345' }
- * )
- * ```
- */
-async function uploadMultipartFile(args) {
-    const { baseUrl, authToken, endpoint, file, fileName, additionalFields, requestId, customFetch, } = args;
-    // Build the full URL
-    const url = `${baseUrl}${endpoint}`;
-    let body;
-    const headers = {
-        Authorization: `Bearer ${authToken}`,
-    };
-    if (requestId) {
-        headers['X-Request-Id'] = requestId;
-    }
-    // Resolve the file to something every `fetch` accepts as a body part: a
-    // Blob where the size is known up front, or a Node stream that gets piped
-    // through untouched.
-    let filePart;
-    let resolvedFileName;
-    if (file instanceof Blob) {
-        filePart = file;
-        resolvedFileName = fileName || (file instanceof File ? file.name : undefined) || 'upload';
-    }
-    else if (typeof file === 'string') {
-        // File path: Node-only, so import lazily to keep browser bundles clean.
-        const [fsModule, pathModule] = await Promise.all([Promise.resolve().then(() => __importStar(require('fs'))), Promise.resolve().then(() => __importStar(require('path')))]);
-        resolvedFileName = fileName || pathModule.basename(file);
-        // `openAsBlob` reads the file lazily, so a large upload is not pulled
-        // into memory, and the resulting body still has a known length.
-        filePart = await fsModule.openAsBlob(file);
-    }
-    else if (Buffer.isBuffer(file)) {
-        if (!fileName) {
-            throw new Error('fileName is required when uploading from a Buffer');
-        }
-        resolvedFileName = fileName;
-        filePart = new Blob([
-            new Uint8Array(file.buffer, file.byteOffset, file.byteLength),
-        ]);
-    }
-    else {
-        if (!fileName) {
-            throw new Error('fileName is required when uploading from a stream');
-        }
-        resolvedFileName = fileName;
-        filePart = file;
-    }
-    const multipart = buildMultipartBody({
-        file: filePart,
-        fileName: resolvedFileName,
-        fileContentType: (filePart instanceof Blob ? filePart.type : undefined) ||
-            getContentTypeFromFileName(resolvedFileName),
-        additionalFields,
-    });
-    // The boundary is ours, so Content-Type has to be set explicitly — `fetch`
-    // only fills it in for a `FormData` body.
-    headers['Content-Type'] = multipart.contentType;
-    body = multipart.body;
-    // Make the request using fetch
-    const response = await (0, fetch_with_retry_1.fetchWithRetry)(Object.assign(Object.assign({ url, options: Object.assign({ method: 'POST', body,
-            headers, timeout: 30000 }, (multipart.isStreamed ? { duplex: 'half' } : {})) }, (multipart.isStreamed ? { retryConfig: { retries: 0 } } : {})), { customFetch }));
-    return (0, case_conversion_1.camelCaseKeys)(response.data);
-}

package/dist/cjs/utils/processing-helpers.js

@@ -1,18 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.customCamelCase = customCamelCase;
-const camelcase_1 = __importDefault(require("camelcase"));
-const emoji_regex_1 = __importDefault(require("emoji-regex"));
-function isEmojiKey(key) {
-    const regex = (0, emoji_regex_1.default)();
-    return regex.test(key);
-}
-function customCamelCase(input) {
-    // If the value is a solitary emoji string, return the key as-is
-    if (isEmojiKey(input))
-        return input;
-    return (0, camelcase_1.default)(input);
-}

package/dist/cjs/utils/project-helpers.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isWorkspaceProject = isWorkspaceProject;
-exports.isPersonalProject = isPersonalProject;
-/**
- * Type guard to check if a project is a workspace project.
- * @param project The project to check
- * @returns True if the project is a workspace project
- */
-function isWorkspaceProject(project) {
-    return 'workspaceId' in project;
-}
-/**
- * Type guard to check if a project is a personal project.
- * @param project The project to check
- * @returns True if the project is a personal project
- */
-function isPersonalProject(project) {
-    return !isWorkspaceProject(project);
-}

package/dist/cjs/utils/request-helpers.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generatePath = generatePath;
-exports.spreadIfDefined = spreadIfDefined;
-/**
- * Joins path segments using `/` separator.
- * @param segments A list of **valid** path segments.
- * @returns A joined path.
- */
-function generatePath(...segments) {
-    return segments.join('/');
-}
-/**
- * Returns `fn(value)` spread into an object if `value` is defined, otherwise an empty object.
- *
- * Used to conditionally include a property on a payload object without
- * resorting to mutation or ternary-built object literals.
- */
-function spreadIfDefined(value, fn) {
-    return value !== undefined ? fn(value) : {};
-}

package/dist/cjs/utils/sanitization.js

@@ -1,116 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSanitizedContent = getSanitizedContent;
-exports.getSanitizedTasks = getSanitizedTasks;
-const BOLD_FORMAT = /(^|[\s!?,;>:]+)(?:\*\*|__|!!)(.+?)(\*\*|__|!!)(?=$|[\s!?,;><:]+)/gi;
-const ITALIC_FORMAT = /(^|[\s!?,;>:]+)(?:\*|_|!)(.+?)(\*|_|!)(?=$|[\s!?,;><:]+)/gi;
-const BOLD_ITALIC_FORMAT = /(^|[\s!?,;>:]+)(?:\*\*\*|___|!!!)(.+?)(\*\*\*|___|!!!)(?=$|[\s!?,;><:]+)/gi;
-const CODE_BLOCK_FORMAT = /```([\s\S]*?)```/gi;
-const CODE_INLINE_FORMAT = /`([^`]+)`/gi;
-const TODOIST_LINK = /((?:(?:onenote:)?[\w-]+):\/\/[^\s]+)\s+[[(]([^)]+)[\])]/gi;
-const MARKDOWN_LINK = /\[(.+?)\]\((.+?)\)/gi;
-const GMAIL_LINK = /\[\[gmail=(.+?),\s*(.+?)\]\]/gi;
-const OUTLOOK_LINK = /\[\[outlook=(.+?),\s*(.+?)\]\]/gi;
-const THUNDERBIRD_LINK = /\[\[thunderbird\n(.+)\n(.+)\n\s*\]\]/gi;
-const FAKE_SECTION_PREFIX = '* ';
-const FAKE_SECTION_SUFFIX = ':';
-function removeStyleFormatting(input) {
-    if (!input.includes('!') && !input.includes('*') && !input.includes('_')) {
-        return input;
-    }
-    function removeMarkdown(_match, prefix, text) {
-        return `${prefix}${text}`;
-    }
-    input = input.replace(BOLD_ITALIC_FORMAT, removeMarkdown);
-    input = input.replace(BOLD_FORMAT, removeMarkdown);
-    input = input.replace(ITALIC_FORMAT, removeMarkdown);
-    return input;
-}
-function removeCodeFormatting(input) {
-    function removeMarkdown(_match, text) {
-        return text;
-    }
-    input = input.replace(CODE_BLOCK_FORMAT, removeMarkdown);
-    input = input.replace(CODE_INLINE_FORMAT, removeMarkdown);
-    return input;
-}
-function removeFakeSectionFormatting(input) {
-    if (input.startsWith(FAKE_SECTION_PREFIX)) {
-        input = input.slice(FAKE_SECTION_PREFIX.length);
-    }
-    if (input.endsWith(FAKE_SECTION_SUFFIX)) {
-        input = input.slice(0, input.length - FAKE_SECTION_SUFFIX.length);
-    }
-    return input;
-}
-function removeMarkdownLinks(input) {
-    if (!input.includes('[') || !input.includes(']')) {
-        return input;
-    }
-    function removeMarkdown(_match, text) {
-        return text;
-    }
-    return input.replace(MARKDOWN_LINK, removeMarkdown);
-}
-function removeTodoistLinks(input) {
-    if (!input.includes('(') || !input.includes(')')) {
-        return input;
-    }
-    function removeMarkdown(_match, _url, text) {
-        return text;
-    }
-    return input.replace(TODOIST_LINK, removeMarkdown);
-}
-function removeAppLinks(input) {
-    if (input.includes('gmail')) {
-        input = input.replace(GMAIL_LINK, (_match, _id, text) => text);
-    }
-    if (input.includes('outlook')) {
-        input = input.replace(OUTLOOK_LINK, (_match, _id, text) => text);
-    }
-    if (input.includes('thunderbird')) {
-        input = input.replace(THUNDERBIRD_LINK, (_match, text) => text);
-    }
-    return input;
-}
-/**
- * Sanitizes a string by removing Todoist's formatting syntax (e.g. bold, italic, code blocks, links).
- *
- * @example
- * // Removes bold/italic formatting
- * getSanitizedContent('Some **bold** and *italic*') // 'Some bold and italic'
- *
- * // Removes markdown links
- * getSanitizedContent('A [markdown](http://url.com) link') // 'A markdown link'
- *
- * // Removes app-specific links
- * getSanitizedContent('A [[gmail=id, link from gmail]]') // 'A link from gmail'
- *
- * @param input - The string to sanitize
- * @returns The sanitized string with all formatting removed
- */
-function getSanitizedContent(input) {
-    input = removeStyleFormatting(input);
-    input = removeCodeFormatting(input);
-    input = removeFakeSectionFormatting(input);
-    input = removeMarkdownLinks(input);
-    input = removeTodoistLinks(input);
-    input = removeAppLinks(input);
-    return input;
-}
-/**
- * Takes an array of tasks and returns a new array with sanitized content
- * added as 'sanitizedContent' property to each task.
- *
- * @see {@link getSanitizedContent}
- *
- * @example
- * const tasks = [{ content: '**Bold** task', ... }]
- * getSanitizedTasks(tasks) // [{ content: '**Bold** task', sanitizedContent: 'Bold task', ... }]
- *
- * @param tasks - Array of Task objects to sanitize
- * @returns Array of tasks with added sanitizedContent property
- */
-function getSanitizedTasks(tasks) {
-    return tasks.map((task) => (Object.assign(Object.assign({}, task), { sanitizedContent: getSanitizedContent(task.content) })));
-}

package/dist/cjs/utils/sync-helpers.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCommand = createCommand;
-const uuid_1 = require("uuid");
-/**
- * Creates a strongly-typed Sync API command with an auto-generated UUID.
- *
- * @param type - The command type (e.g. `'item_add'`, `'project_update'`).
- * @param args - The command arguments, constrained by the command type.
- * @param tempId - Optional temporary ID for referencing the created resource in subsequent commands.
- * @returns A fully formed `SyncCommand` ready to include in a sync request.
- *
- * @example
- * ```typescript
- * const cmd = createCommand('item_add', { content: 'Buy milk', priority: 2 })
- * // cmd.type === 'item_add'
- * // cmd.args is typed as TaskAddArgs
- * ```
- */
-function createCommand(type, args, tempId) {
-    return Object.assign({ type, uuid: (0, uuid_1.v4)(), args: args }, (tempId !== undefined ? { tempId } : {}));
-}