@doist/twist-cli 2.21.1 → 2.21.3

package/dist/lib/api.js

@@ -0,0 +1,229 @@
+import { TwistApi } from '@doist/twist-sdk';
+import { getApiToken } from './auth.js';
+import { getConfig, updateConfig } from './config.js';
+import { ensureWriteAllowed, isMutatingMethod } from './permissions.js';
+import { getProgressTracker } from './progress.js';
+import { withSpinner } from './spinner.js';
+// Mapping of API method paths to user-friendly spinner messages
+const API_SPINNER_MESSAGES = {
+    // User operations
+    'users.getSessionUser': { text: 'Checking authentication...', color: 'blue' },
+    'users.update': { text: 'Updating user...', color: 'yellow' },
+    // Workspace operations
+    'workspaces.getWorkspaces': { text: 'Loading workspaces...', color: 'blue' },
+    'workspaceUsers.getWorkspaceUsers': { text: 'Loading workspace users...', color: 'blue' },
+    'workspaceUsers.getUserById': { text: 'Loading user details...', color: 'blue' },
+    // Thread operations
+    'threads.getThread': { text: 'Loading thread...', color: 'blue' },
+    'threads.getUnread': { text: 'Loading unread threads...', color: 'blue' },
+    'threads.createThread': { text: 'Creating thread...', color: 'green' },
+    'threads.closeThread': { text: 'Closing thread...', color: 'yellow' },
+    'threads.reopenThread': { text: 'Reopening thread...', color: 'yellow' },
+    'threads.muteThread': { text: 'Muting thread...', color: 'yellow' },
+    'threads.unmuteThread': { text: 'Unmuting thread...', color: 'yellow' },
+    // Comment operations
+    'comments.getComment': { text: 'Loading comment...', color: 'blue' },
+    'comments.getComments': { text: 'Loading comments...', color: 'blue' },
+    'comments.createComment': { text: 'Creating comment...', color: 'green' },
+    'comments.updateComment': { text: 'Updating comment...', color: 'yellow' },
+    'comments.deleteComment': { text: 'Deleting comment...', color: 'yellow' },
+    // Channel operations
+    'channels.getChannel': { text: 'Loading channel...', color: 'blue' },
+    'channels.getChannels': { text: 'Loading channels...', color: 'blue' },
+    'channels.createChannel': { text: 'Creating channel...', color: 'green' },
+    'channels.updateChannel': { text: 'Updating channel...', color: 'yellow' },
+    'channels.deleteChannel': { text: 'Deleting channel...', color: 'yellow' },
+    // Conversation operations
+    'conversations.getConversations': { text: 'Loading conversations...', color: 'blue' },
+    'conversations.getConversation': { text: 'Loading conversation...', color: 'blue' },
+    'conversations.getUnread': { text: 'Loading unread conversations...', color: 'blue' },
+    'conversations.createConversation': { text: 'Creating conversation...', color: 'green' },
+    'conversations.archiveConversation': { text: 'Archiving conversation...', color: 'yellow' },
+    'conversations.unarchiveConversation': {
+        text: 'Unarchiving conversation...',
+        color: 'yellow',
+    },
+    'conversations.muteConversation': { text: 'Muting conversation...', color: 'yellow' },
+    'conversations.unmuteConversation': {
+        text: 'Unmuting conversation...',
+        color: 'yellow',
+    },
+    // Conversation message operations
+    'conversationMessages.getMessage': { text: 'Loading message...', color: 'blue' },
+    'conversationMessages.getMessages': { text: 'Loading messages...', color: 'blue' },
+    'conversationMessages.createMessage': { text: 'Sending message...', color: 'green' },
+    'conversationMessages.updateMessage': { text: 'Updating message...', color: 'yellow' },
+    'conversationMessages.deleteMessage': { text: 'Deleting message...', color: 'yellow' },
+    // Inbox operations
+    'inbox.getInbox': { text: 'Loading inbox...', color: 'blue' },
+    'inbox.archiveThread': { text: 'Archiving thread...', color: 'yellow' },
+    // Batch operations
+    batch: { text: 'Processing batch operations...', color: 'blue' },
+};
+function createSpinnerWrappedApi(api) {
+    return new Proxy(api, {
+        get(target, property, receiver) {
+            const value = Reflect.get(target, property, receiver);
+            // If this is a nested object (like workspaces, users, etc.), wrap it too
+            if (value &&
+                typeof value === 'object' &&
+                !Array.isArray(value) &&
+                typeof property === 'string') {
+                return createNestedSpinnerProxy(value, property);
+            }
+            return value;
+        },
+    });
+}
+function createNestedSpinnerProxy(obj, basePath) {
+    return new Proxy(obj, {
+        get(target, property, receiver) {
+            const originalMethod = Reflect.get(target, property, receiver);
+            if (typeof originalMethod !== 'function' || typeof property !== 'string') {
+                return originalMethod;
+            }
+            const fullPath = `${basePath}.${property}`;
+            const spinnerConfig = API_SPINNER_MESSAGES[fullPath];
+            const shouldCheckPermissions = isMutatingMethod(fullPath);
+            if (!spinnerConfig && !shouldCheckPermissions) {
+                return originalMethod;
+            }
+            return (...args) => {
+                const progressTracker = getProgressTracker();
+                // Extract cursor from args for paginated methods
+                let cursor = null;
+                if (args.length > 0 && typeof args[0] === 'object' && args[0] !== null) {
+                    const options = args[0];
+                    if ('cursor' in options && typeof options.cursor === 'string') {
+                        cursor = options.cursor;
+                    }
+                }
+                // Emit progress event for API call start
+                if (progressTracker.isEnabled()) {
+                    progressTracker.emitApiCall(property, cursor);
+                }
+                // For mutating methods, check permissions before calling the API
+                if (shouldCheckPermissions) {
+                    return ensureWriteAllowed().then(() => {
+                        const result = originalMethod.apply(target, args);
+                        return wrapResult(result, progressTracker, spinnerConfig);
+                    });
+                }
+                const result = originalMethod.apply(target, args);
+                return wrapResult(result, progressTracker, spinnerConfig);
+            };
+        },
+    });
+}
+function wrapResult(result, progressTracker, spinnerConfig) {
+    // If the method returns a non-thenable (e.g. batch request builder), return as-is
+    if (!result || typeof result.then !== 'function') {
+        return result;
+    }
+    const wrappedPromise = result
+        .then((response) => {
+        if (progressTracker.isEnabled()) {
+            analyzeAndEmitApiResponse(progressTracker, response);
+        }
+        return response;
+    })
+        .catch((error) => {
+        if (progressTracker.isEnabled()) {
+            progressTracker.emitError(error.name || 'API_ERROR', error.message);
+        }
+        throw error;
+    });
+    if (spinnerConfig) {
+        return withSpinner(spinnerConfig, () => wrappedPromise);
+    }
+    return wrappedPromise;
+}
+function analyzeAndEmitApiResponse(progressTracker, response) {
+    // For paginated responses, extract metadata
+    if (response && typeof response === 'object' && response !== null) {
+        const resp = response;
+        // Check if it's a paginated response with results array
+        if ('results' in resp && Array.isArray(resp.results)) {
+            progressTracker.emitApiResponse(resp.results.length, Boolean(resp.nextCursor), typeof resp.nextCursor === 'string' ? resp.nextCursor : null);
+            return;
+        }
+        // For array responses (legacy or simple lists)
+        if (Array.isArray(response)) {
+            progressTracker.emitApiResponse(response.length, false, null);
+            return;
+        }
+    }
+    // For other responses, emit minimal info
+    progressTracker.emitApiResponse(1, false, null);
+}
+let apiClient = null;
+export async function getTwistClient() {
+    if (!apiClient) {
+        const token = await getApiToken();
+        const rawApi = new TwistApi(token);
+        apiClient = createSpinnerWrappedApi(rawApi);
+    }
+    return apiClient;
+}
+let workspaceCache = null;
+let sessionUserCache = null;
+export async function fetchWorkspaces() {
+    if (workspaceCache) {
+        return workspaceCache;
+    }
+    const client = await getTwistClient();
+    workspaceCache = await client.workspaces.getWorkspaces();
+    return workspaceCache;
+}
+export function clearWorkspaceCache() {
+    workspaceCache = null;
+}
+export async function getCurrentWorkspaceId(flagValue) {
+    if (flagValue) {
+        return flagValue;
+    }
+    const config = await getConfig();
+    if (config.currentWorkspace) {
+        return config.currentWorkspace;
+    }
+    const sessionUser = await getSessionUser();
+    if (sessionUser.defaultWorkspace) {
+        await updateConfig({ currentWorkspace: sessionUser.defaultWorkspace });
+        return sessionUser.defaultWorkspace;
+    }
+    const workspaces = await fetchWorkspaces();
+    if (workspaces.length === 0) {
+        throw new Error('No workspaces found for this user');
+    }
+    const defaultWorkspace = workspaces[0];
+    await updateConfig({ currentWorkspace: defaultWorkspace.id });
+    return defaultWorkspace.id;
+}
+export async function getSessionUser() {
+    if (sessionUserCache) {
+        return sessionUserCache;
+    }
+    const client = await getTwistClient();
+    sessionUserCache = await client.users.getSessionUser();
+    return sessionUserCache;
+}
+export async function getWorkspaceUsers(workspaceId) {
+    const client = await getTwistClient();
+    return client.workspaceUsers.getWorkspaceUsers({ workspaceId });
+}
+export function clearUserCache() {
+    sessionUserCache = null;
+}
+/**
+ * Validates a batch response and returns the data, throwing on errors.
+ * Also handles the case where the SDK fails to validate the response schema
+ * (e.g. when the batch API wraps entities in a key like `{comment: {...}}`).
+ * In that case, the raw transformed data is returned — check for expected fields.
+ */
+export function assertBatchData(response, label) {
+    if (response.code >= 400 || response.data == null) {
+        throw new Error(`Failed to fetch ${label}.`);
+    }
+    return response.data;
+}
+//# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"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"}

package/dist/lib/auth.d.ts

@@ -0,0 +1,21 @@
+import { type AuthMode } from './config.js';
+export declare const TOKEN_ENV_VAR = "TWIST_API_TOKEN";
+export type TokenStorageLocation = 'secure-store' | 'config-file';
+export interface TokenStorageResult {
+    storage: TokenStorageLocation;
+    warning?: string;
+}
+export interface SaveApiTokenOptions {
+    authMode?: AuthMode;
+    authScope?: string;
+}
+export interface AuthMetadata {
+    authMode: AuthMode;
+    authScope?: string;
+    source: 'env' | 'config';
+}
+export declare function getApiToken(): Promise<string>;
+export declare function getAuthMetadata(): Promise<AuthMetadata>;
+export declare function saveApiToken(token: string, options?: SaveApiTokenOptions): Promise<TokenStorageResult>;
+export declare function clearApiToken(): Promise<TokenStorageResult>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAoD,MAAM,aAAa,CAAA;AAO7F,eAAO,MAAM,aAAa,oBAAoB,CAAA;AAC9C,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,aAAa,CAAA;AAEjE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAA;CAC3B;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAiEnD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAY7D;AAED,wBAAsB,YAAY,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAwC7B;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAyBjE"}

package/dist/lib/auth.js

@@ -0,0 +1,183 @@
+import { unlink } from 'node:fs/promises';
+import { getConfig, getConfigPath, setConfig } from './config.js';
+import { createSecureStore, SECURE_STORE_DESCRIPTION, SecureStoreUnavailableError, } from './secure-store.js';
+export const TOKEN_ENV_VAR = 'TWIST_API_TOKEN';
+export async function getApiToken() {
+    // Priority 1: Environment variable
+    const envToken = process.env[TOKEN_ENV_VAR];
+    if (envToken) {
+        return envToken;
+    }
+    const config = await getConfig();
+    const configToken = getConfigToken(config);
+    const secureStore = createSecureStore();
+    if (configToken) {
+        try {
+            await secureStore.setSecret(configToken);
+            const cleanupWarning = await cleanupAuthFallbackState(config, 'Token was migrated to secure storage,');
+            if (cleanupWarning) {
+                warn(cleanupWarning);
+            }
+        }
+        catch (error) {
+            if (!(error instanceof SecureStoreUnavailableError)) {
+                throw error;
+            }
+        }
+        return configToken;
+    }
+    if (config.pendingSecureStoreClear) {
+        try {
+            await secureStore.deleteSecret();
+            const cleanupWarning = await cleanupAuthFallbackState(config, 'Secure-store token was removed,');
+            if (cleanupWarning) {
+                warn(cleanupWarning);
+            }
+        }
+        catch (error) {
+            if (!(error instanceof SecureStoreUnavailableError)) {
+                throw error;
+            }
+        }
+        throw new Error(`No API token found. Set ${TOKEN_ENV_VAR} or run \`tw auth login\` or \`tw auth token <token>\`.`);
+    }
+    try {
+        const storedToken = await secureStore.getSecret();
+        if (storedToken?.trim()) {
+            return storedToken;
+        }
+    }
+    catch (error) {
+        if (!(error instanceof SecureStoreUnavailableError)) {
+            throw error;
+        }
+    }
+    throw new Error(`No API token found. Set ${TOKEN_ENV_VAR} or run \`tw auth login\` or \`tw auth token <token>\`.`);
+}
+export async function getAuthMetadata() {
+    const envToken = process.env[TOKEN_ENV_VAR];
+    if (envToken) {
+        return { authMode: 'unknown', source: 'env' };
+    }
+    const config = await getConfig();
+    return {
+        authMode: config.authMode ?? 'unknown',
+        authScope: config.authScope,
+        source: 'config',
+    };
+}
+export async function saveApiToken(token, options = {}) {
+    // Validate token (non-empty, reasonable length)
+    if (!token || token.trim().length < 10) {
+        throw new Error('Invalid token: Token must be at least 10 characters');
+    }
+    const trimmedToken = token.trim();
+    const secureStore = createSecureStore();
+    try {
+        await secureStore.setSecret(trimmedToken);
+        const existingConfig = await getConfig();
+        const warning = await cleanupAuthFallbackState(existingConfig, 'Token was stored securely,');
+        // Persist auth metadata to config — needed for ensureWriteAllowed() enforcement
+        try {
+            await saveAuthMetadata(options);
+        }
+        catch {
+            if (options.authMode && options.authMode !== 'unknown') {
+                warn(`Could not persist auth mode '${options.authMode}' to config. CLI-side write protection may not work in future sessions.`);
+            }
+        }
+        return warning ? { storage: 'secure-store', warning } : { storage: 'secure-store' };
+    }
+    catch (error) {
+        if (!(error instanceof SecureStoreUnavailableError)) {
+            throw error;
+        }
+    }
+    const config = await getConfig();
+    config.token = trimmedToken;
+    delete config.pendingSecureStoreClear;
+    config.authMode = options.authMode ?? 'unknown';
+    config.authScope = options.authScope;
+    await writeConfig(config);
+    return {
+        storage: 'config-file',
+        warning: buildFallbackWarning('token saved as plaintext in'),
+    };
+}
+export async function clearApiToken() {
+    const config = await getConfig();
+    const secureStore = createSecureStore();
+    // Clear auth metadata from the in-memory config object so all subsequent
+    // writes (cleanupAuthFallbackState, withPendingSecureStoreClear) persist
+    // the removal atomically alongside other state changes.
+    delete config.authMode;
+    delete config.authScope;
+    try {
+        await secureStore.deleteSecret();
+        const warning = await cleanupAuthFallbackState(config, 'Secure-store token was removed,');
+        return warning ? { storage: 'secure-store', warning } : { storage: 'secure-store' };
+    }
+    catch (error) {
+        if (!(error instanceof SecureStoreUnavailableError)) {
+            throw error;
+        }
+    }
+    await writeConfig(withPendingSecureStoreClear(config));
+    return {
+        storage: 'config-file',
+        warning: buildFallbackWarning('local auth state cleared in'),
+    };
+}
+async function saveAuthMetadata(options) {
+    const config = await getConfig();
+    config.authMode = options.authMode ?? 'unknown';
+    config.authScope = options.authScope;
+    await setConfig(config);
+}
+async function writeConfig(config) {
+    if (Object.keys(config).length === 0) {
+        try {
+            await unlink(getConfigPath());
+        }
+        catch (error) {
+            if (!isMissingFileError(error)) {
+                throw error;
+            }
+        }
+        return;
+    }
+    await setConfig(config);
+}
+async function cleanupAuthFallbackState(config, warningPrefix) {
+    try {
+        await writeConfig(withoutAuthFallbackState(config));
+        return undefined;
+    }
+    catch (error) {
+        return buildConfigCleanupWarning(warningPrefix, error);
+    }
+}
+function getConfigToken(config) {
+    return typeof config.token === 'string' && config.token.trim() ? config.token.trim() : null;
+}
+function withoutAuthFallbackState(config) {
+    const { token: _token, pendingSecureStoreClear: _pending, ...rest } = config;
+    return rest;
+}
+function withPendingSecureStoreClear(config) {
+    return { ...withoutAuthFallbackState(config), pendingSecureStoreClear: true };
+}
+function buildFallbackWarning(action) {
+    return `${SECURE_STORE_DESCRIPTION} unavailable; ${action} ${getConfigPath()}`;
+}
+function buildConfigCleanupWarning(prefix, error) {
+    const detail = error instanceof Error && error.message ? ` (${error.message})` : '';
+    return `${prefix} but could not remove legacy plaintext token from ${getConfigPath()}${detail}`;
+}
+function isMissingFileError(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+function warn(message) {
+    console.error(`Warning: ${message}`);
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"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"}

package/dist/lib/completion.d.ts

@@ -0,0 +1,31 @@
+import type { Command, Option } from 'commander';
+/**
+ * Set argChoices on an option without enabling Commander's built-in
+ * validation. The choices are surfaced for shell completions but the
+ * option still accepts any value at parse time.
+ */
+export declare function withUnvalidatedChoices(opt: Option, values: string[]): Option;
+export declare function withCaseInsensitiveChoices(opt: Option, values: string[]): Option;
+/**
+ * Parse COMP_LINE into words, stripping the binary name and the
+ * 'completion-server' token that tabtab injects.
+ *
+ * FIXME: This splits on whitespace and does not handle quoted arguments.
+ * This is acceptable for command/flag traversal. It can be improved once
+ * tabtab exposes shell-provided tokenized words.
+ */
+export declare function parseCompLine(compLine: string): string[];
+export interface CompletionItem {
+    name: string;
+    description?: string;
+}
+/**
+ * Get completions for the current command line context.
+ *
+ * @param program - The root Commander program with all commands registered
+ * @param words - The words on the command line (excluding the binary name)
+ * @param current - The current word being typed (may be empty string)
+ * @returns Array of completion items
+ */
+export declare function getCompletions(program: Command, words: string[], current: string): CompletionItem[];
+//# sourceMappingURL=completion.d.ts.map

package/dist/lib/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/lib/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEhD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAG5E;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAWhF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAIxD;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAoBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,GAChB,cAAc,EAAE,CAsGlB"}