@doist/twist-cli 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# Twist CLI
+
+A command-line interface for Twist.
+
+## Installation
+
+> **Note**: This package is not yet published to npm. Once published, install with:
+>
+> ```bash
+> npm install -g @doist/twist-cli
+> ```
+
+### Local Setup (for now)
+
+```bash
+git clone https://github.com/Doist/twist-cli.git
+cd twist-cli
+npm install
+npm run build
+npm link
+```
+
+This makes the `tw` command available globally.
+
+## Setup
+
+Save your Twist API token:
+
+```bash
+tw login token "your-token"
+```
+
+Alternatively, set via environment variable:
+
+```bash
+export TWIST_API_TOKEN="your-token"
+```
+
+## Usage
+
+```bash
+tw workspaces                      # list all workspaces
+tw inbox                           # inbox threads
+tw inbox --unread                  # unread threads only
+tw thread view <thread-ref>        # view thread with comments
+tw thread reply <thread-ref>       # reply to a thread
+tw msg list                        # list conversations
+tw msg view <conversation-ref>     # view conversation messages
+tw search "keyword"                # search across workspace
+tw react thread <ref> 👍           # add reaction
+```
+
+References accept IDs (`123` or `id:123`), Twist URLs, or fuzzy names (for workspaces/users).
+
+Run `tw --help` or `tw <command> --help` for more options.
+
+### Machine-readable output
+
+All list/view commands support `--json` and `--ndjson` flags for scripting:
+
+```bash
+tw inbox --json                    # JSON array
+tw inbox --ndjson                  # newline-delimited JSON
+tw inbox --json --full             # include all fields
+```
+
+## Development
+
+```bash
+npm install
+npm run build       # compile
+npm run dev         # watch mode
+npm run type-check  # type check
+npm run format      # format code
+npm test            # run tests
+```

package/dist/__tests__/auth.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.test.d.ts.map

package/dist/__tests__/auth.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/auth.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/auth.test.js

@@ -0,0 +1,300 @@
+import { Command } from 'commander';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+// Mock the auth module
+vi.mock('../lib/auth.js', () => ({
+    saveApiToken: vi.fn(),
+    clearApiToken: vi.fn(),
+}));
+// Mock the api module
+vi.mock('../lib/api.js', () => ({
+    getSessionUser: vi.fn(),
+}));
+// Mock the config module
+vi.mock('../lib/config.js', () => ({
+    getConfigPath: vi.fn(() => '/home/user/.config/twist-cli/config.json'),
+}));
+// Mock OAuth modules
+vi.mock('../lib/oauth.js', () => ({
+    buildAuthorizationUrl: vi.fn(),
+    exchangeCodeForToken: vi.fn(),
+    registerDynamicClient: vi.fn(),
+}));
+vi.mock('../lib/oauth-server.js', () => ({
+    startCallbackServer: vi.fn(),
+}));
+vi.mock('../lib/pkce.js', () => ({
+    generateCodeVerifier: vi.fn(),
+    generateCodeChallenge: vi.fn(),
+    generateState: vi.fn(),
+}));
+// Mock open package
+vi.mock('open', () => ({
+    default: vi.fn(),
+}));
+// Mock chalk to avoid colors in tests
+vi.mock('chalk', () => ({
+    default: {
+        green: vi.fn((text) => text),
+        yellow: vi.fn((text) => text),
+        red: vi.fn((text) => text),
+        blue: vi.fn((text) => text),
+        dim: vi.fn((text) => text),
+    },
+}));
+import open from 'open';
+import { registerAuthCommand } from '../commands/auth.js';
+import { getSessionUser } from '../lib/api.js';
+import { clearApiToken, saveApiToken } from '../lib/auth.js';
+import { buildAuthorizationUrl, exchangeCodeForToken, registerDynamicClient } from '../lib/oauth.js';
+import { startCallbackServer } from '../lib/oauth-server.js';
+import { generateCodeChallenge, generateCodeVerifier, generateState } from '../lib/pkce.js';
+const mockSaveApiToken = vi.mocked(saveApiToken);
+const mockClearApiToken = vi.mocked(clearApiToken);
+const mockGetSessionUser = vi.mocked(getSessionUser);
+// OAuth mocks
+const mockGenerateCodeVerifier = vi.mocked(generateCodeVerifier);
+const mockGenerateCodeChallenge = vi.mocked(generateCodeChallenge);
+const mockGenerateState = vi.mocked(generateState);
+const mockBuildAuthorizationUrl = vi.mocked(buildAuthorizationUrl);
+const mockStartCallbackServer = vi.mocked(startCallbackServer);
+const mockExchangeCodeForToken = vi.mocked(exchangeCodeForToken);
+const mockRegisterDynamicClient = vi.mocked(registerDynamicClient);
+const mockOpen = vi.mocked(open);
+function createProgram() {
+    const program = new Command();
+    program.exitOverride();
+    registerAuthCommand(program);
+    return program;
+}
+describe('auth command', () => {
+    let consoleSpy;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // Mock console.log to capture output
+        consoleSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        consoleSpy.mockRestore();
+    });
+    describe('token subcommand', () => {
+        it('successfully saves a token', async () => {
+            const program = createProgram();
+            const token = 'some_token_123456789';
+            // Mock successful token save
+            mockSaveApiToken.mockResolvedValue(undefined);
+            await program.parseAsync(['node', 'tw', 'auth', 'token', token]);
+            // Verify token was saved
+            expect(mockSaveApiToken).toHaveBeenCalledWith(token);
+            // Verify success message
+            expect(consoleSpy).toHaveBeenCalledWith('✓', 'API token saved successfully!');
+            expect(consoleSpy).toHaveBeenCalledWith('Token saved to /home/user/.config/twist-cli/config.json');
+        });
+        it('handles saveApiToken errors', async () => {
+            const program = createProgram();
+            const token = 'some_token_123456789';
+            // Mock save failure
+            mockSaveApiToken.mockRejectedValue(new Error('Permission denied'));
+            await expect(program.parseAsync(['node', 'tw', 'auth', 'token', token])).rejects.toThrow('Permission denied');
+            expect(mockSaveApiToken).toHaveBeenCalledWith(token);
+        });
+        it('trims whitespace from token', async () => {
+            const program = createProgram();
+            const tokenWithWhitespace = '  some_token_123456789  ';
+            const expectedToken = 'some_token_123456789';
+            mockSaveApiToken.mockResolvedValue(undefined);
+            await program.parseAsync(['node', 'tw', 'auth', 'token', tokenWithWhitespace]);
+            expect(mockSaveApiToken).toHaveBeenCalledWith(expectedToken);
+        });
+    });
+    describe('status subcommand', () => {
+        it('shows authenticated status when logged in', async () => {
+            const program = createProgram();
+            const mockUser = {
+                id: 1,
+                name: 'Test User',
+                shortName: 'test',
+                bot: false,
+                timezone: 'UTC',
+                removed: false,
+                email: 'test@example.com',
+                lang: 'en',
+            };
+            mockGetSessionUser.mockResolvedValue(mockUser);
+            await program.parseAsync(['node', 'tw', 'auth', 'status']);
+            expect(mockGetSessionUser).toHaveBeenCalled();
+            expect(consoleSpy).toHaveBeenCalledWith('✓', 'Authenticated');
+            expect(consoleSpy).toHaveBeenCalledWith('  Email: test@example.com');
+            expect(consoleSpy).toHaveBeenCalledWith('  Name:  Test User');
+        });
+        it('shows not authenticated when no token', async () => {
+            const program = createProgram();
+            mockGetSessionUser.mockRejectedValue(new Error('No API token found'));
+            await program.parseAsync(['node', 'tw', 'auth', 'status']);
+            expect(consoleSpy).toHaveBeenCalledWith('Not authenticated');
+            expect(consoleSpy).toHaveBeenCalledWith('Run `tw auth login` for OAuth or `tw auth token <token>` for manual authentication');
+        });
+    });
+    describe('login subcommand', () => {
+        it('successfully completes OAuth flow with dynamic client registration', async () => {
+            const program = createProgram();
+            // Mock dynamic client registration
+            mockRegisterDynamicClient.mockResolvedValue({
+                client_id: 'twd_dynamic_client_id',
+                client_secret: 'dynamic_client_secret',
+            });
+            // Mock PKCE parameters
+            mockGenerateCodeVerifier.mockReturnValue('test_code_verifier');
+            mockGenerateCodeChallenge.mockReturnValue('test_code_challenge');
+            mockGenerateState.mockReturnValue('test_state');
+            // Mock authorization URL
+            mockBuildAuthorizationUrl.mockReturnValue('https://twist.com/oauth/authorize?...');
+            // Mock callback server that resolves immediately
+            const mockCleanup = vi.fn();
+            mockStartCallbackServer.mockImplementation(async (expectedState) => {
+                // Simulate the browser opening behavior by calling our mocks
+                mockBuildAuthorizationUrl('twd_dynamic_client_id', 'test_code_challenge', expectedState);
+                await mockOpen('https://twist.com/oauth/authorize?...');
+                return Promise.resolve({
+                    code: 'auth_code_123',
+                    cleanup: mockCleanup,
+                });
+            });
+            // Mock token exchange
+            mockExchangeCodeForToken.mockResolvedValue('access_token_123');
+            // Mock browser opening
+            mockOpen.mockResolvedValue({});
+            // Mock token saving
+            mockSaveApiToken.mockResolvedValue(undefined);
+            await program.parseAsync(['node', 'tw', 'auth', 'login']);
+            // Verify dynamic client registration
+            expect(mockRegisterDynamicClient).toHaveBeenCalled();
+            // Verify PKCE parameters were generated
+            expect(mockGenerateCodeVerifier).toHaveBeenCalled();
+            expect(mockGenerateCodeChallenge).toHaveBeenCalledWith('test_code_verifier');
+            expect(mockGenerateState).toHaveBeenCalled();
+            // Verify authorization URL was built with dynamic client ID
+            expect(mockBuildAuthorizationUrl).toHaveBeenCalledWith('twd_dynamic_client_id', 'test_code_challenge', 'test_state');
+            // Verify callback server was started
+            expect(mockStartCallbackServer).toHaveBeenCalledWith('test_state');
+            // Verify browser was opened
+            expect(mockOpen).toHaveBeenCalledWith('https://twist.com/oauth/authorize?...');
+            // Verify token exchange with client credentials
+            expect(mockExchangeCodeForToken).toHaveBeenCalledWith('auth_code_123', 'test_code_verifier', {
+                client_id: 'twd_dynamic_client_id',
+                client_secret: 'dynamic_client_secret',
+            });
+            // Verify token was saved
+            expect(mockSaveApiToken).toHaveBeenCalledWith('access_token_123');
+            // Verify cleanup was called
+            expect(mockCleanup).toHaveBeenCalled();
+            // Verify success messages
+            expect(consoleSpy).toHaveBeenCalledWith('Starting OAuth authentication...');
+            expect(consoleSpy).toHaveBeenCalledWith('✓', 'OAuth authentication successful!');
+        });
+        it('handles callback server errors', async () => {
+            const program = createProgram();
+            // Mock dynamic client registration
+            mockRegisterDynamicClient.mockResolvedValue({
+                client_id: 'twd_dynamic_client_id',
+                client_secret: 'dynamic_client_secret',
+            });
+            // Mock PKCE parameters
+            mockGenerateCodeVerifier.mockReturnValue('test_code_verifier');
+            mockGenerateCodeChallenge.mockReturnValue('test_code_challenge');
+            mockGenerateState.mockReturnValue('test_state');
+            // Mock callback server error
+            mockStartCallbackServer.mockRejectedValue(new Error('Port 8766 is already in use'));
+            await program.parseAsync(['node', 'tw', 'auth', 'login']);
+            expect(consoleSpy).toHaveBeenCalledWith('✗', 'OAuth authentication failed');
+            expect(consoleSpy).toHaveBeenCalledWith('Port 8766 is already in use');
+        });
+        it('handles token exchange errors', async () => {
+            const program = createProgram();
+            // Mock dynamic client registration
+            mockRegisterDynamicClient.mockResolvedValue({
+                client_id: 'twd_dynamic_client_id',
+                client_secret: 'dynamic_client_secret',
+            });
+            // Mock PKCE parameters
+            mockGenerateCodeVerifier.mockReturnValue('test_code_verifier');
+            mockGenerateCodeChallenge.mockReturnValue('test_code_challenge');
+            mockGenerateState.mockReturnValue('test_state');
+            // Mock successful callback
+            const mockCleanup = vi.fn();
+            mockStartCallbackServer.mockResolvedValue({
+                code: 'auth_code_123',
+                cleanup: mockCleanup,
+            });
+            // Mock token exchange error
+            mockExchangeCodeForToken.mockRejectedValue(new Error('Invalid authorization code'));
+            await program.parseAsync(['node', 'tw', 'auth', 'login']);
+            expect(mockCleanup).toHaveBeenCalled();
+            expect(consoleSpy).toHaveBeenCalledWith('✗', 'OAuth authentication failed');
+            expect(consoleSpy).toHaveBeenCalledWith('Invalid authorization code');
+        });
+        it('handles browser opening errors gracefully', async () => {
+            const program = createProgram();
+            // Mock dynamic client registration
+            mockRegisterDynamicClient.mockResolvedValue({
+                client_id: 'twd_dynamic_client_id',
+                client_secret: 'dynamic_client_secret',
+            });
+            // Mock PKCE parameters
+            mockGenerateCodeVerifier.mockReturnValue('test_code_verifier');
+            mockGenerateCodeChallenge.mockReturnValue('test_code_challenge');
+            mockGenerateState.mockReturnValue('test_state');
+            // Mock callback server
+            const mockCleanup = vi.fn();
+            mockStartCallbackServer.mockResolvedValue({
+                code: 'auth_code_123',
+                cleanup: mockCleanup,
+            });
+            // Mock browser opening error
+            mockOpen.mockRejectedValue(new Error('No browser available'));
+            // Mock successful token exchange (flow should still continue)
+            mockExchangeCodeForToken.mockResolvedValue('access_token_123');
+            mockSaveApiToken.mockResolvedValue(undefined);
+            await program.parseAsync(['node', 'tw', 'auth', 'login']);
+            // Should still complete successfully despite browser error
+            expect(consoleSpy).toHaveBeenCalledWith('✓', 'OAuth authentication successful!');
+        });
+        it('calls cleanup when OAuth server throws', async () => {
+            const program = createProgram();
+            // Mock dynamic client registration
+            mockRegisterDynamicClient.mockResolvedValue({
+                client_id: 'twd_dynamic_client_id',
+                client_secret: 'dynamic_client_secret',
+            });
+            // Mock PKCE parameters
+            mockGenerateCodeVerifier.mockReturnValue('test_code_verifier');
+            mockGenerateCodeChallenge.mockReturnValue('test_code_challenge');
+            mockGenerateState.mockReturnValue('test_state');
+            // Mock server that throws an error
+            mockStartCallbackServer.mockRejectedValue(new Error('Server failed to start'));
+            await program.parseAsync(['node', 'tw', 'auth', 'login']);
+            // Should handle the error gracefully
+            expect(consoleSpy).toHaveBeenCalledWith('✗', 'OAuth authentication failed');
+            expect(consoleSpy).toHaveBeenCalledWith('Server failed to start');
+        });
+    });
+    describe('login subcommand with unconfigured client ID', () => {
+        // Note: Testing the unconfigured client ID scenario is complex with the current mock setup
+        // In practice, users would need to configure their client ID before OAuth works
+        it('would show error when client ID is not configured', () => {
+            // This test documents the expected behavior when TWIST_CLIENT_ID === 'YOUR_CLIENT_ID'
+            // The actual implementation checks this condition and shows an error message
+            expect(true).toBe(true); // Placeholder for documentation purposes
+        });
+    });
+    describe('logout subcommand', () => {
+        it('clears the API token', async () => {
+            const program = createProgram();
+            mockClearApiToken.mockResolvedValue(undefined);
+            await program.parseAsync(['node', 'tw', 'auth', 'logout']);
+            expect(mockClearApiToken).toHaveBeenCalled();
+            expect(consoleSpy).toHaveBeenCalledWith('✓', 'Logged out');
+            expect(consoleSpy).toHaveBeenCalledWith('Token removed from /home/user/.config/twist-cli/config.json');
+        });
+    });
+});
+//# sourceMappingURL=auth.test.js.map

package/dist/__tests__/auth.test.js.map

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

package/dist/__tests__/lib/dates.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dates.test.d.ts.map

package/dist/__tests__/lib/dates.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/dates.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/dates.test.js

@@ -0,0 +1,58 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { formatRelativeDate, parseDate } from '../../lib/dates.js';
+describe('formatRelativeDate', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2024-06-15T12:00:00Z'));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('returns "just now" for times less than a minute ago', () => {
+        const date = new Date('2024-06-15T11:59:30Z');
+        expect(formatRelativeDate(date)).toBe('just now');
+    });
+    it('returns minutes ago for times less than an hour ago', () => {
+        expect(formatRelativeDate(new Date('2024-06-15T11:55:00Z'))).toBe('5 minutes ago');
+        expect(formatRelativeDate(new Date('2024-06-15T11:59:00Z'))).toBe('1 minute ago');
+        expect(formatRelativeDate(new Date('2024-06-15T11:30:00Z'))).toBe('30 minutes ago');
+    });
+    it('returns hours ago for times less than a day ago', () => {
+        expect(formatRelativeDate(new Date('2024-06-15T10:00:00Z'))).toBe('2 hours ago');
+        expect(formatRelativeDate(new Date('2024-06-15T11:00:00Z'))).toBe('1 hour ago');
+    });
+    it('returns "yesterday" for times 1-2 days ago', () => {
+        expect(formatRelativeDate(new Date('2024-06-14T12:00:00Z'))).toBe('yesterday');
+    });
+    it('returns days ago for times less than a week ago', () => {
+        expect(formatRelativeDate(new Date('2024-06-12T12:00:00Z'))).toBe('3 days ago');
+        expect(formatRelativeDate(new Date('2024-06-10T12:00:00Z'))).toBe('5 days ago');
+    });
+    it('returns absolute date for older times', () => {
+        const result = formatRelativeDate(new Date('2024-05-01T12:00:00Z'));
+        expect(result).toMatch(/May 1/);
+    });
+    it('includes year for dates from previous years', () => {
+        const result = formatRelativeDate(new Date('2023-01-15T12:00:00Z'));
+        expect(result).toMatch(/Jan 15, 2023/);
+    });
+    it('handles string dates', () => {
+        expect(formatRelativeDate('2024-06-15T11:59:00Z')).toBe('1 minute ago');
+    });
+});
+describe('parseDate', () => {
+    it('parses valid ISO dates', () => {
+        const result = parseDate('2024-06-15T12:00:00Z');
+        expect(result).toBeInstanceOf(Date);
+        expect(result?.toISOString()).toBe('2024-06-15T12:00:00.000Z');
+    });
+    it('parses date-only strings', () => {
+        const result = parseDate('2024-06-15');
+        expect(result).toBeInstanceOf(Date);
+    });
+    it('returns null for invalid dates', () => {
+        expect(parseDate('invalid')).toBeNull();
+        expect(parseDate('')).toBeNull();
+    });
+});
+//# sourceMappingURL=dates.test.js.map

package/dist/__tests__/lib/dates.test.js.map

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

package/dist/__tests__/lib/refs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=refs.test.d.ts.map

package/dist/__tests__/lib/refs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/refs.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lib/refs.test.js

@@ -0,0 +1,121 @@
+import { describe, expect, it } from 'vitest';
+import { extractId, isIdRef, parseRef, parseTwistUrl, resolveCommentId, resolveConversationId, resolveMessageId, resolveThreadId, } from '../../lib/refs.js';
+describe('isIdRef', () => {
+    it('returns true for id: prefixed strings', () => {
+        expect(isIdRef('id:123')).toBe(true);
+        expect(isIdRef('id:456789')).toBe(true);
+    });
+    it('returns false for non-id refs', () => {
+        expect(isIdRef('123')).toBe(false);
+        expect(isIdRef('workspace-name')).toBe(false);
+        expect(isIdRef('https://twist.com/a/123')).toBe(false);
+    });
+});
+describe('extractId', () => {
+    it('extracts ID from id: prefix', () => {
+        expect(extractId('id:123')).toBe(123);
+        expect(extractId('id:456789')).toBe(456789);
+    });
+    it('parses bare numbers', () => {
+        expect(extractId('123')).toBe(123);
+    });
+    it('throws on invalid input', () => {
+        expect(() => extractId('invalid')).toThrow('Invalid ID');
+        expect(() => extractId('id:abc')).toThrow('Invalid ID');
+    });
+});
+describe('parseTwistUrl', () => {
+    it('parses workspace URL', () => {
+        const result = parseTwistUrl('https://twist.com/a/12345');
+        expect(result).toEqual({ workspaceId: 12345 });
+    });
+    it('parses channel URL', () => {
+        const result = parseTwistUrl('https://twist.com/a/12345/ch/67890');
+        expect(result).toEqual({ workspaceId: 12345, channelId: 67890 });
+    });
+    it('parses thread URL', () => {
+        const result = parseTwistUrl('https://twist.com/a/12345/ch/67890/t/111');
+        expect(result).toEqual({ workspaceId: 12345, channelId: 67890, threadId: 111 });
+    });
+    it('parses thread with comment URL', () => {
+        const result = parseTwistUrl('https://twist.com/a/12345/ch/67890/t/111/c/222');
+        expect(result).toEqual({
+            workspaceId: 12345,
+            channelId: 67890,
+            threadId: 111,
+            commentId: 222,
+        });
+    });
+    it('parses conversation URL', () => {
+        const result = parseTwistUrl('https://twist.com/a/12345/msg/333');
+        expect(result).toEqual({ workspaceId: 12345, conversationId: 333 });
+    });
+    it('parses message URL', () => {
+        const result = parseTwistUrl('https://twist.com/a/12345/msg/333/m/444');
+        expect(result).toEqual({ workspaceId: 12345, conversationId: 333, messageId: 444 });
+    });
+    it('returns null for non-twist URLs', () => {
+        expect(parseTwistUrl('https://google.com')).toBeNull();
+        expect(parseTwistUrl('https://example.com/a/123')).toBeNull();
+    });
+    it('returns null for invalid URLs', () => {
+        expect(parseTwistUrl('not-a-url')).toBeNull();
+    });
+});
+describe('parseRef', () => {
+    it('parses id: refs', () => {
+        expect(parseRef('id:123')).toEqual({ type: 'id', id: 123 });
+    });
+    it('parses bare numbers', () => {
+        expect(parseRef('456')).toEqual({ type: 'id', id: 456 });
+    });
+    it('parses URLs', () => {
+        const result = parseRef('https://twist.com/a/12345/ch/67890/t/111');
+        expect(result).toEqual({
+            type: 'url',
+            parsed: { workspaceId: 12345, channelId: 67890, threadId: 111 },
+        });
+    });
+    it('parses names', () => {
+        expect(parseRef('My Workspace')).toEqual({ type: 'name', name: 'My Workspace' });
+    });
+});
+describe('resolveThreadId', () => {
+    it('resolves id: refs', () => {
+        expect(resolveThreadId('id:123')).toBe(123);
+    });
+    it('resolves bare numbers', () => {
+        expect(resolveThreadId('456')).toBe(456);
+    });
+    it('resolves thread URLs', () => {
+        expect(resolveThreadId('https://twist.com/a/12345/ch/67890/t/111')).toBe(111);
+    });
+    it('throws on invalid refs', () => {
+        expect(() => resolveThreadId('invalid-name')).toThrow('Invalid thread reference');
+    });
+});
+describe('resolveCommentId', () => {
+    it('resolves id: refs', () => {
+        expect(resolveCommentId('id:222')).toBe(222);
+    });
+    it('resolves comment URLs', () => {
+        expect(resolveCommentId('https://twist.com/a/12345/ch/67890/t/111/c/222')).toBe(222);
+    });
+});
+describe('resolveConversationId', () => {
+    it('resolves id: refs', () => {
+        expect(resolveConversationId('id:333')).toBe(333);
+    });
+    it('resolves conversation URLs', () => {
+        expect(resolveConversationId('https://twist.com/a/12345/msg/333')).toBe(333);
+    });
+});
+describe('resolveMessageId', () => {
+    it('resolves id: refs', () => {
+        expect(resolveMessageId('id:444')).toBe(444);
+    });
+    it('resolves message URLs', () => {
+        expect(resolveMessageId('https://twist.com/a/12345/msg/333/m/444')).toBe(444);
+    });
+});
+//# sourceMappingURL=refs.test.js.map

package/dist/__tests__/lib/refs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.test.js","sourceRoot":"","sources":["../../../src/__tests__/lib/refs.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EACH,SAAS,EACT,OAAO,EACP,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAClB,MAAM,mBAAmB,CAAA;AAE1B,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7C,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;QACxD,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,2BAA2B,CAAC,CAAA;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,oCAAoC,CAAC,CAAA;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;IACpE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACzB,MAAM,MAAM,GAAG,aAAa,CAAC,0CAA0C,CAAC,CAAA;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAA;IACnF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,aAAa,CAAC,gDAAgD,CAAC,CAAA;QAC9E,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,GAAG;SACjB,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,aAAa,CAAC,mCAAmC,CAAC,CAAA;QACjE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,yCAAyC,CAAC,CAAA;QACvE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;IACvF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;QACtD,MAAM,CAAC,aAAa,CAAC,2BAA2B,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAA;IACjD,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACvB,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IAC5D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACnB,MAAM,MAAM,GAAG,QAAQ,CAAC,0CAA0C,CAAC,CAAA;QACnE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE;SAClE,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;QACpB,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;IACpF,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,eAAe,CAAC,0CAA0C,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAA;IACrF,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,gBAAgB,CAAC,gDAAgD,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxF,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,qBAAqB,CAAC,mCAAmC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,gBAAgB,CAAC,yCAAyC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA"}

package/dist/__tests__/spinner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spinner.test.d.ts.map

package/dist/__tests__/spinner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/spinner.test.ts"],"names":[],"mappings":""}