@doist/comms-sdk 2.0.2 → 3.0.1

package/dist/cjs/clients/workspaces-client.js

@@ -1,174 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkspacesClient = exports.ChannelListSchema = void 0;
-const zod_1 = require("zod");
-const endpoints_1 = require("../consts/endpoints");
-const http_client_1 = require("../transport/http-client");
-const entities_1 = require("../types/entities");
-const base_client_1 = require("./base-client");
-exports.ChannelListSchema = zod_1.z.array(entities_1.ChannelSchema);
-/**
- * Client for `/api/v1/workspaces/`. Workspace IDs are integers. The backend
- * currently rejects any `color` other than `1` on add/update.
- */
-class WorkspacesClient extends base_client_1.BaseClient {
-    constructor() {
-        super(...arguments);
-        this.linkBaseUrl = this.getLinkBaseUrl();
-        // Reuse the shared singleton when no custom base is configured.
-        this.channelListSchema = this.linkBaseUrl
-            ? zod_1.z.array((0, entities_1.createChannelSchema)(this.linkBaseUrl))
-            : exports.ChannelListSchema;
-    }
-    /**
-     * Gets all the user's workspaces.
-     *
-     * @returns An array of all workspaces the user belongs to.
-     *
-     * @example
-     * ```typescript
-     * const workspaces = await api.workspaces.getWorkspaces()
-     * workspaces.forEach(ws => console.log(ws.name))
-     * ```
-     */
-    getWorkspaces() {
-        return (0, http_client_1.request)({
-            httpMethod: 'GET',
-            baseUri: this.getBaseUri(),
-            relativePath: `${endpoints_1.ENDPOINT_WORKSPACES}/get`,
-            apiToken: this.apiToken,
-            payload: undefined,
-            customFetch: this.customFetch,
-        }).then((response) => response.data.map((workspace) => entities_1.WorkspaceSchema.parse(workspace)));
-    }
-    /**
-     * Gets a single workspace object by id.
-     *
-     * @param id - The workspace ID.
-     * @returns The workspace object.
-     *
-     * @example
-     * ```typescript
-     * const workspace = await api.workspaces.getWorkspace(123)
-     * console.log(workspace.name)
-     * ```
-     */
-    getWorkspace(id) {
-        return (0, http_client_1.request)({
-            httpMethod: 'GET',
-            baseUri: this.getBaseUri(),
-            relativePath: `${endpoints_1.ENDPOINT_WORKSPACES}/getone`,
-            apiToken: this.apiToken,
-            payload: { id },
-            customFetch: this.customFetch,
-        }).then((response) => entities_1.WorkspaceSchema.parse(response.data));
-    }
-    /**
-     * Gets the user's default workspace.
-     *
-     * @returns The default workspace object.
-     *
-     * @example
-     * ```typescript
-     * const workspace = await api.workspaces.getDefaultWorkspace()
-     * console.log(workspace.name)
-     * ```
-     */
-    getDefaultWorkspace() {
-        return (0, http_client_1.request)({
-            httpMethod: 'GET',
-            baseUri: this.getBaseUri(),
-            relativePath: `${endpoints_1.ENDPOINT_WORKSPACES}/get_default`,
-            apiToken: this.apiToken,
-            payload: undefined,
-            customFetch: this.customFetch,
-        }).then((response) => entities_1.WorkspaceSchema.parse(response.data));
-    }
-    /**
-     * Creates a new workspace.
-     *
-     * @param name - The name of the new workspace.
-     * @returns The created workspace object.
-     *
-     * @example
-     * ```typescript
-     * const workspace = await api.workspaces.createWorkspace('My Team')
-     * console.log('Created:', workspace.name)
-     * ```
-     */
-    createWorkspace(name) {
-        return (0, http_client_1.request)({
-            httpMethod: 'POST',
-            baseUri: this.getBaseUri(),
-            relativePath: `${endpoints_1.ENDPOINT_WORKSPACES}/add`,
-            apiToken: this.apiToken,
-            payload: { name },
-            customFetch: this.customFetch,
-        }).then((response) => entities_1.WorkspaceSchema.parse(response.data));
-    }
-    /**
-     * Updates an existing workspace.
-     *
-     * @param id - The workspace ID.
-     * @param name - The new name for the workspace.
-     * @returns The updated workspace object.
-     *
-     * @example
-     * ```typescript
-     * const workspace = await api.workspaces.updateWorkspace(123, 'New Team Name')
-     * ```
-     */
-    updateWorkspace(id, name) {
-        return (0, http_client_1.request)({
-            httpMethod: 'POST',
-            baseUri: this.getBaseUri(),
-            relativePath: `${endpoints_1.ENDPOINT_WORKSPACES}/update`,
-            apiToken: this.apiToken,
-            payload: { id, name },
-            customFetch: this.customFetch,
-        }).then((response) => entities_1.WorkspaceSchema.parse(response.data));
-    }
-    /**
-     * Removes a workspace and all its data (not recoverable).
-     *
-     * @param id - The workspace ID.
-     *
-     * @example
-     * ```typescript
-     * await api.workspaces.removeWorkspace(123)
-     * ```
-     */
-    removeWorkspace(id) {
-        return (0, http_client_1.request)({
-            httpMethod: 'POST',
-            baseUri: this.getBaseUri(),
-            relativePath: `${endpoints_1.ENDPOINT_WORKSPACES}/remove`,
-            apiToken: this.apiToken,
-            payload: { id },
-            customFetch: this.customFetch,
-        }).then(() => undefined);
-    }
-    /**
-     * Gets the public channels of a workspace.
-     *
-     * @param id - The workspace ID.
-     * @returns An array of public channel objects.
-     *
-     * @example
-     * ```typescript
-     * const channels = await api.workspaces.getPublicChannels(123)
-     * channels.forEach(ch => console.log(ch.name))
-     * ```
-     */
-    getPublicChannels(id) {
-        return (0, http_client_1.request)({
-            httpMethod: 'GET',
-            baseUri: this.getBaseUri(),
-            relativePath: `${endpoints_1.ENDPOINT_WORKSPACES}/get_public_channels`,
-            apiToken: this.apiToken,
-            payload: { id },
-            customFetch: this.customFetch,
-        }).then((response) => this.channelListSchema.parse(response.data));
-    }
-}
-exports.WorkspacesClient = WorkspacesClient;

package/dist/cjs/comms-api.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommsApi = void 0;
-const attachments_client_1 = require("./clients/attachments-client");
-const channels_client_1 = require("./clients/channels-client");
-const comments_client_1 = require("./clients/comments-client");
-const conversation_messages_client_1 = require("./clients/conversation-messages-client");
-const conversations_client_1 = require("./clients/conversations-client");
-const groups_client_1 = require("./clients/groups-client");
-const hooks_client_1 = require("./clients/hooks-client");
-const inbox_client_1 = require("./clients/inbox-client");
-const reactions_client_1 = require("./clients/reactions-client");
-const search_client_1 = require("./clients/search-client");
-const threads_client_1 = require("./clients/threads-client");
-const users_client_1 = require("./clients/users-client");
-const workspace_users_client_1 = require("./clients/workspace-users-client");
-const workspaces_client_1 = require("./clients/workspaces-client");
-const http_dispatcher_1 = require("./transport/http-dispatcher");
-/**
- * The main API client for interacting with the Comms REST API.
- *
- * @example
- * ```typescript
- * import { CommsApi } from '@doist/comms-sdk'
- *
- * const api = new CommsApi('your-api-token')
- * const user = await api.users.getSessionUser()
- * ```
- */
-class CommsApi {
-    /**
-     * Creates a new Comms API client.
-     *
-     * @param authToken - Your Comms API token.
-     * @param options - Optional configuration options.
-     */
-    constructor(authToken, options) {
-        const clientConfig = {
-            apiToken: authToken,
-            baseUrl: options?.baseUrl,
-            version: options?.version,
-            customFetch: options?.customFetch,
-        };
-        this.users = new users_client_1.UsersClient(clientConfig);
-        this.workspaces = new workspaces_client_1.WorkspacesClient(clientConfig);
-        this.workspaceUsers = new workspace_users_client_1.WorkspaceUsersClient(clientConfig);
-        this.channels = new channels_client_1.ChannelsClient(clientConfig);
-        this.threads = new threads_client_1.ThreadsClient(clientConfig);
-        this.groups = new groups_client_1.GroupsClient(clientConfig);
-        this.conversations = new conversations_client_1.ConversationsClient(clientConfig);
-        this.comments = new comments_client_1.CommentsClient(clientConfig);
-        this.conversationMessages = new conversation_messages_client_1.ConversationMessagesClient(clientConfig);
-        this.inbox = new inbox_client_1.InboxClient(clientConfig);
-        this.reactions = new reactions_client_1.ReactionsClient(clientConfig);
-        this.search = new search_client_1.SearchClient(clientConfig);
-        this.attachments = new attachments_client_1.AttachmentsClient(clientConfig);
-        this.hooks = new hooks_client_1.HooksClient(clientConfig);
-    }
-    /**
-     * Drains the SDK's process-global connection pool. CLIs and scripts
-     * should `await api.close()` before exit so Node's event loop empties
-     * immediately instead of waiting ~4s on keep-alive. Affects every
-     * `CommsApi` and OAuth helper in the same process — it's a
-     * process-shutdown gesture, not an instance teardown. Browser-safe.
-     */
-    async close() {
-        await (0, http_dispatcher_1.closeDefaultDispatcher)();
-    }
-}
-exports.CommsApi = CommsApi;

package/dist/cjs/consts/endpoints.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENDPOINT_HOOKS = exports.ENDPOINT_ATTACHMENTS = exports.ENDPOINT_CONVERSATION_MESSAGES = exports.ENDPOINT_SEARCH = exports.ENDPOINT_REACTIONS = exports.ENDPOINT_INBOX = exports.ENDPOINT_NOTIFICATIONS = exports.ENDPOINT_COMMENTS = exports.ENDPOINT_CONVERSATIONS = exports.ENDPOINT_GROUPS = exports.ENDPOINT_THREADS = exports.ENDPOINT_CHANNELS = exports.ENDPOINT_WORKSPACES = exports.ENDPOINT_USERS = void 0;
-exports.getCommsBaseUri = getCommsBaseUri;
-const api_version_1 = require("../types/api-version");
-const BASE_URI = 'https://comms.todoist.com';
-/**
- * Gets the base URI for Comms API requests.
- *
- * Preserves any path component on `domainBase` so callers can route through
- * a proxy (e.g. `https://proxy.example.com/comms` → `.../comms/api/v1/`).
- *
- * @param version - API version. Defaults to 'v1'.
- * @param domainBase - Custom domain base URL. Defaults to Comms' API domain.
- * @returns Complete base URI with trailing slash (e.g., 'https://comms.todoist.com/api/v1/')
- */
-function getCommsBaseUri(version = api_version_1.DEFAULT_API_VERSION, domainBase = BASE_URI) {
-    const base = domainBase.endsWith('/') ? domainBase : `${domainBase}/`;
-    return new URL(`api/${version}/`, base).toString();
-}
-exports.ENDPOINT_USERS = 'users';
-exports.ENDPOINT_WORKSPACES = 'workspaces';
-exports.ENDPOINT_CHANNELS = 'channels';
-exports.ENDPOINT_THREADS = 'threads';
-exports.ENDPOINT_GROUPS = 'groups';
-exports.ENDPOINT_CONVERSATIONS = 'conversations';
-exports.ENDPOINT_COMMENTS = 'comments';
-exports.ENDPOINT_NOTIFICATIONS = 'notifications';
-exports.ENDPOINT_INBOX = 'inbox';
-exports.ENDPOINT_REACTIONS = 'reactions';
-exports.ENDPOINT_SEARCH = 'search';
-exports.ENDPOINT_CONVERSATION_MESSAGES = 'conversation_messages';
-exports.ENDPOINT_ATTACHMENTS = 'attachments';
-exports.ENDPOINT_HOOKS = 'hooks';

package/dist/cjs/index.js

@@ -1,53 +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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.closeDefaultDispatcher = exports.CommsApi = exports.WorkspacesClient = exports.WorkspaceUsersClient = exports.UsersClient = exports.ThreadsClient = exports.SearchClient = exports.ReactionsClient = exports.InboxClient = exports.HooksClient = exports.GroupsClient = exports.ConversationsClient = exports.ConversationMessagesClient = exports.CommentsClient = exports.ChannelsClient = exports.AttachmentsClient = void 0;
-__exportStar(require("./authentication"), exports);
-__exportStar(require("./migration"), exports);
-var attachments_client_1 = require("./clients/attachments-client");
-Object.defineProperty(exports, "AttachmentsClient", { enumerable: true, get: function () { return attachments_client_1.AttachmentsClient; } });
-var channels_client_1 = require("./clients/channels-client");
-Object.defineProperty(exports, "ChannelsClient", { enumerable: true, get: function () { return channels_client_1.ChannelsClient; } });
-var comments_client_1 = require("./clients/comments-client");
-Object.defineProperty(exports, "CommentsClient", { enumerable: true, get: function () { return comments_client_1.CommentsClient; } });
-var conversation_messages_client_1 = require("./clients/conversation-messages-client");
-Object.defineProperty(exports, "ConversationMessagesClient", { enumerable: true, get: function () { return conversation_messages_client_1.ConversationMessagesClient; } });
-var conversations_client_1 = require("./clients/conversations-client");
-Object.defineProperty(exports, "ConversationsClient", { enumerable: true, get: function () { return conversations_client_1.ConversationsClient; } });
-var groups_client_1 = require("./clients/groups-client");
-Object.defineProperty(exports, "GroupsClient", { enumerable: true, get: function () { return groups_client_1.GroupsClient; } });
-var hooks_client_1 = require("./clients/hooks-client");
-Object.defineProperty(exports, "HooksClient", { enumerable: true, get: function () { return hooks_client_1.HooksClient; } });
-var inbox_client_1 = require("./clients/inbox-client");
-Object.defineProperty(exports, "InboxClient", { enumerable: true, get: function () { return inbox_client_1.InboxClient; } });
-var reactions_client_1 = require("./clients/reactions-client");
-Object.defineProperty(exports, "ReactionsClient", { enumerable: true, get: function () { return reactions_client_1.ReactionsClient; } });
-var search_client_1 = require("./clients/search-client");
-Object.defineProperty(exports, "SearchClient", { enumerable: true, get: function () { return search_client_1.SearchClient; } });
-var threads_client_1 = require("./clients/threads-client");
-Object.defineProperty(exports, "ThreadsClient", { enumerable: true, get: function () { return threads_client_1.ThreadsClient; } });
-var users_client_1 = require("./clients/users-client");
-Object.defineProperty(exports, "UsersClient", { enumerable: true, get: function () { return users_client_1.UsersClient; } });
-var workspace_users_client_1 = require("./clients/workspace-users-client");
-Object.defineProperty(exports, "WorkspaceUsersClient", { enumerable: true, get: function () { return workspace_users_client_1.WorkspaceUsersClient; } });
-var workspaces_client_1 = require("./clients/workspaces-client");
-Object.defineProperty(exports, "WorkspacesClient", { enumerable: true, get: function () { return workspaces_client_1.WorkspacesClient; } });
-var comms_api_1 = require("./comms-api");
-Object.defineProperty(exports, "CommsApi", { enumerable: true, get: function () { return comms_api_1.CommsApi; } });
-var http_dispatcher_1 = require("./transport/http-dispatcher");
-Object.defineProperty(exports, "closeDefaultDispatcher", { enumerable: true, get: function () { return http_dispatcher_1.closeDefaultDispatcher; } });
-__exportStar(require("./types/index"), exports);
-__exportStar(require("./utils/index"), exports);

package/dist/cjs/migration.js

@@ -1,96 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchNewCommsUrl = fetchNewCommsUrl;
-exports.fetchNewCommsUrls = fetchNewCommsUrls;
-const http_client_1 = require("./transport/http-client");
-const errors_1 = require("./types/errors");
-/**
- * Default origin of the Twist migration backend.
- *
- * The `fetch_new_url` endpoint lives on Twist (`twist.com`) and authenticates
- * with a **Twist** token, not a Comms one. This is why the migration helpers are
- * standalone functions rather than methods on {@link CommsApi} (which is
- * constructed with a Comms token).
- */
-const DEFAULT_TWIST_BASE_URL = 'https://twist.com';
-function getTwistMigrationUrl(baseUrl) {
-    const base = baseUrl ?? DEFAULT_TWIST_BASE_URL;
-    const trimmed = base.endsWith('/') ? base.slice(0, -1) : base;
-    return `${trimmed}/api/comms_migration/fetch_new_url`;
-}
-/**
- * Translates a Twist URL to its equivalent Comms URL using Twist's
- * `comms_migration/fetch_new_url` endpoint.
- *
- * Authenticates with a **Twist** token (external to the Comms SDK), so this is a
- * standalone helper rather than a method on {@link CommsApi}.
- *
- * @example
- * ```typescript
- * const newUrl = await fetchNewCommsUrl({
- *   oldUrl: 'https://twist.com/a/123/ch/456/t/789',
- *   twistToken: process.env.TWIST_AUTH_TOKEN,
- * })
- * ```
- *
- * @returns The equivalent Comms URL.
- * @throws {@link CommsRequestError} If the request fails. URLs that cannot be
- * migrated surface as a thrown error too: `400` with `responseData.error.code`
- * of `'invalid_url'`, or `404` with `'not_imported'`.
- */
-async function fetchNewCommsUrl(args, options) {
-    const response = await (0, http_client_1.request)({
-        httpMethod: 'POST',
-        baseUri: getTwistMigrationUrl(options?.baseUrl),
-        relativePath: '',
-        apiToken: args.twistToken,
-        payload: { oldUrl: args.oldUrl },
-        customFetch: options?.customFetch,
-    });
-    const newUrl = response.data?.newUrl;
-    if (!newUrl) {
-        throw new errors_1.CommsRequestError('Migration response did not contain a new URL.', response.status, response.data);
-    }
-    return newUrl;
-}
-/**
- * Translates multiple Twist URLs to their equivalent Comms URLs.
- *
- * URLs are processed **sequentially** to stay friendly to the rate-sensitive
- * migration endpoint. A failure on one URL does not abort the run: each result
- * carries either a `newUrl` (success) or a `CommsRequestError` (failure), in the
- * same order as the input.
- *
- * @example
- * ```typescript
- * const results = await fetchNewCommsUrls({
- *   oldUrls: ['https://twist.com/a/1/ch/2/t/3', 'https://twist.com/bad'],
- *   twistToken: process.env.TWIST_AUTH_TOKEN,
- * })
- * for (const result of results) {
- *   if (result.newUrl) console.log(`${result.oldUrl} -> ${result.newUrl}`)
- *   else console.warn(`${result.oldUrl} failed`, result.error)
- * }
- * ```
- *
- * @returns One {@link MigrationResult} per input URL, in input order.
- * @throws Re-throws any error that is not a {@link CommsRequestError}.
- */
-async function fetchNewCommsUrls(args, options) {
-    const results = [];
-    for (const oldUrl of args.oldUrls) {
-        try {
-            const newUrl = await fetchNewCommsUrl({ oldUrl, twistToken: args.twistToken }, options);
-            results.push({ oldUrl, newUrl });
-        }
-        catch (error) {
-            if (error instanceof errors_1.CommsRequestError) {
-                results.push({ oldUrl, error });
-            }
-            else {
-                throw error;
-            }
-        }
-    }
-    return results;
-}

package/dist/cjs/package.json

@@ -1 +0,0 @@
-{"type":"commonjs"}

package/dist/cjs/testUtils/msw-handlers.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpResponse = exports.http = void 0;
-exports.createSuccessResponse = createSuccessResponse;
-exports.createErrorResponse = createErrorResponse;
-exports.apiUrl = apiUrl;
-exports.createGetHandler = createGetHandler;
-exports.createPostHandler = createPostHandler;
-const msw_1 = require("msw");
-Object.defineProperty(exports, "HttpResponse", { enumerable: true, get: function () { return msw_1.HttpResponse; } });
-Object.defineProperty(exports, "http", { enumerable: true, get: function () { return msw_1.http; } });
-const BASE_URL = 'https://comms.todoist.com';
-/**
- * Creates a successful API response with the given data
- */
-function createSuccessResponse(data) {
-    return msw_1.HttpResponse.json(data, { status: 200 });
-}
-/**
- * Creates an error API response
- */
-function createErrorResponse(errorCode, errorMessage, status = 400) {
-    return msw_1.HttpResponse.json({
-        error_code: errorCode,
-        error_string: errorMessage,
-    }, { status });
-}
-/**
- * Helper to create API endpoint URL
- */
-function apiUrl(path) {
-    // Remove leading slash if present
-    const cleanPath = path.startsWith('/') ? path.slice(1) : path;
-    return `${BASE_URL}/${cleanPath}`;
-}
-/**
- * Creates a handler for a GET endpoint
- */
-function createGetHandler(endpoint, responseData) {
-    return msw_1.http.get(apiUrl(endpoint), () => {
-        return createSuccessResponse(responseData);
-    });
-}
-/**
- * Creates a handler for a POST endpoint
- */
-function createPostHandler(endpoint, responseData) {
-    return msw_1.http.post(apiUrl(endpoint), () => {
-        return createSuccessResponse(responseData);
-    });
-}

package/dist/cjs/testUtils/msw-setup.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.server = void 0;
-const node_1 = require("msw/node");
-const vitest_1 = require("vitest");
-// In production the transport uses undici's own `fetch` (paired with the
-// dispatcher) so the request client and dispatcher stay on one undici version.
-// MSW intercepts the *global* `fetch`, not that separate undici instance, so
-// force the transport onto the global `fetch` for every test in the suite;
-// MSW then intercepts requests as usual. The real undici transport is covered
-// directly by `http-dispatcher.test.ts` and `fetch-with-retry.test.ts`, which
-// opt out of this seam.
-vitest_1.vi.mock('../transport/http-dispatcher', async (importOriginal) => {
-    const actual = await importOriginal();
-    return {
-        ...actual,
-        getDefaultTransport: vitest_1.vi.fn(async () => undefined),
-    };
-});
-// Create MSW server instance
-exports.server = (0, node_1.setupServer)();
-// Start server before all tests
-(0, vitest_1.beforeAll)(() => {
-    // Only warn on unhandled requests instead of error, since transport/http-client.test.ts
-    // uses direct fetch mocking which bypasses MSW
-    exports.server.listen({ onUnhandledRequest: 'warn' });
-});
-// Reset handlers after each test
-(0, vitest_1.afterEach)(() => {
-    exports.server.resetHandlers();
-});
-// Clean up after all tests
-(0, vitest_1.afterAll)(() => {
-    exports.server.close();
-});

package/dist/cjs/testUtils/obsidian-fetch-adapter.js

@@ -1,53 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createObsidianFetchAdapter = createObsidianFetchAdapter;
-/**
- * Creates a CustomFetch adapter for Obsidian's requestUrl API.
- *
- * This adapter bridges the gap between Obsidian's requestUrl interface and the
- * standard fetch-like interface expected by the Comms API SDK.
- *
- * Key differences handled by this adapter:
- * - Obsidian returns response data as properties (response.json, response.text)
- *   while the SDK expects methods (response.json(), response.text())
- * - Obsidian's requestUrl bypasses CORS restrictions that would block standard fetch
- * - Obsidian throws on HTTP errors by default; we set throw: false to handle manually
- * - Obsidian doesn't provide statusText; we default to empty string
- *
- * @example
- * ```typescript
- * import { requestUrl } from 'obsidian'
- * import { createObsidianFetchAdapter } from './obsidian-fetch-adapter'
- *
- * const api = new CommsApi('your-token', {
- *   customFetch: createObsidianFetchAdapter(requestUrl)
- * })
- * ```
- *
- * @param requestUrl - The Obsidian requestUrl function
- * @returns A CustomFetch function compatible with the Comms API SDK
- */
-function createObsidianFetchAdapter(requestUrl) {
-    return async (url, options) => {
-        // Build the request parameters in Obsidian's format
-        const requestParams = {
-            url,
-            method: options?.method || 'GET',
-            headers: options?.headers,
-            body: options?.body,
-            throw: false, // Don't throw on HTTP errors; let the SDK handle status codes
-        };
-        // Make the request using Obsidian's requestUrl
-        const response = await requestUrl(requestParams);
-        // Transform Obsidian's response format to match CustomFetchResponse interface
-        return {
-            ok: response.status >= 200 && response.status < 300,
-            status: response.status,
-            statusText: '', // Obsidian doesn't provide statusText
-            headers: response.headers,
-            // Wrap Obsidian's direct properties as methods returning promises
-            text: () => Promise.resolve(response.text),
-            json: () => Promise.resolve(response.json),
-        };
-    };
-}