@mintlify/cli 4.0.1813 → 4.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (274) hide show
  1. package/dist/assets/export-scripts/README.classic.md +15 -0
  2. package/dist/assets/export-scripts/README.md +14 -0
  3. package/dist/assets/export-scripts/serve.js +114 -0
  4. package/dist/assets/export-scripts/start-docs.bat +10 -0
  5. package/dist/assets/export-scripts/start-docs.sh +9 -0
  6. package/dist/assets/og/Inter-Bold.ttf +0 -0
  7. package/dist/assets/og/Inter-Medium.ttf +0 -0
  8. package/dist/assets/og/Inter-Regular.ttf +0 -0
  9. package/dist/assets/og/Inter-SemiBold.ttf +0 -0
  10. package/dist/assets/og/PaperMono-Regular.ttf +0 -0
  11. package/dist/assets/og/index_bg.wasm +0 -0
  12. package/dist/assets/openChrome.applescript +94 -0
  13. package/dist/assets/socket.io/socket.io.esm.min.js +7 -0
  14. package/dist/assets/socket.io/socket.io.esm.min.js.map +1 -0
  15. package/dist/assets/socket.io/socket.io.js +4907 -0
  16. package/dist/assets/socket.io/socket.io.js.map +1 -0
  17. package/dist/assets/socket.io/socket.io.min.js +7 -0
  18. package/dist/assets/socket.io/socket.io.min.js.map +1 -0
  19. package/dist/assets/socket.io/socket.io.msgpack.min.js +7 -0
  20. package/dist/assets/socket.io/socket.io.msgpack.min.js.map +1 -0
  21. package/dist/assets/xdg-open +1066 -0
  22. package/dist/assets/yargs-locales/be.json +46 -0
  23. package/dist/assets/yargs-locales/cs.json +51 -0
  24. package/dist/assets/yargs-locales/de.json +46 -0
  25. package/dist/assets/yargs-locales/en.json +55 -0
  26. package/dist/assets/yargs-locales/es.json +46 -0
  27. package/dist/assets/yargs-locales/fi.json +49 -0
  28. package/dist/assets/yargs-locales/fr.json +53 -0
  29. package/dist/assets/yargs-locales/hi.json +49 -0
  30. package/dist/assets/yargs-locales/hu.json +46 -0
  31. package/dist/assets/yargs-locales/id.json +50 -0
  32. package/dist/assets/yargs-locales/it.json +46 -0
  33. package/dist/assets/yargs-locales/ja.json +51 -0
  34. package/dist/assets/yargs-locales/ko.json +49 -0
  35. package/dist/assets/yargs-locales/nb.json +44 -0
  36. package/dist/assets/yargs-locales/nl.json +49 -0
  37. package/dist/assets/yargs-locales/nn.json +44 -0
  38. package/dist/assets/yargs-locales/pirate.json +13 -0
  39. package/dist/assets/yargs-locales/pl.json +49 -0
  40. package/dist/assets/yargs-locales/pt.json +45 -0
  41. package/dist/assets/yargs-locales/pt_BR.json +48 -0
  42. package/dist/assets/yargs-locales/ru.json +51 -0
  43. package/dist/assets/yargs-locales/th.json +46 -0
  44. package/dist/assets/yargs-locales/tr.json +48 -0
  45. package/dist/assets/yargs-locales/uk_UA.json +51 -0
  46. package/dist/assets/yargs-locales/uz.json +52 -0
  47. package/dist/assets/yargs-locales/zh_CN.json +48 -0
  48. package/dist/assets/yargs-locales/zh_TW.json +51 -0
  49. package/dist/converter-d8O3xkdU.js +102 -0
  50. package/dist/devtools-CGNZQKFV.js +24 -0
  51. package/dist/index.js +8 -0
  52. package/dist/rolldown-runtime-CEAe2Uac.js +7 -0
  53. package/dist/schemas-CBsmCNpK.js +372 -0
  54. package/dist/start.js +2310 -0
  55. package/package.json +38 -31
  56. package/.oxlintrc.json +0 -5
  57. package/.prettierignore +0 -2
  58. package/.turbo/turbo-build.log +0 -1
  59. package/CONTRIBUTING.md +0 -45
  60. package/__test__/agent-auth.test.ts +0 -114
  61. package/__test__/agent-claim.test.ts +0 -164
  62. package/__test__/agent-credentials.test.ts +0 -149
  63. package/__test__/agent-deployment.test.ts +0 -106
  64. package/__test__/agent-setup-config.test.ts +0 -324
  65. package/__test__/agent-setup.test.ts +0 -207
  66. package/__test__/agent.test.ts +0 -64
  67. package/__test__/analytics/client.test.ts +0 -180
  68. package/__test__/analytics/dates.test.ts +0 -12
  69. package/__test__/analytics/filters.test.ts +0 -116
  70. package/__test__/analytics/format.test.ts +0 -137
  71. package/__test__/authenticatedFetch.test.ts +0 -182
  72. package/__test__/brokenLinks.test.ts +0 -283
  73. package/__test__/checkPort.test.ts +0 -92
  74. package/__test__/deploy-github-actions.test.ts +0 -202
  75. package/__test__/deploy-github-setup.test.ts +0 -240
  76. package/__test__/deploy-instructions.test.ts +0 -155
  77. package/__test__/deploy.test.ts +0 -202
  78. package/__test__/feedback.test.ts +0 -34
  79. package/__test__/foreignSyntax.test.ts +0 -73
  80. package/__test__/format.test.ts +0 -72
  81. package/__test__/helpers.test.ts +0 -52
  82. package/__test__/init.test.ts +0 -119
  83. package/__test__/instructions.test.ts +0 -53
  84. package/__test__/keyring.test.ts +0 -82
  85. package/__test__/mdxAccessibility.test.ts +0 -81
  86. package/__test__/migrate.test.ts +0 -186
  87. package/__test__/openApiCheck.test.ts +0 -185
  88. package/__test__/pathValidation.test.ts +0 -25
  89. package/__test__/resolveFiles.test.ts +0 -70
  90. package/__test__/sessionId.test.ts +0 -46
  91. package/__test__/signup.test.ts +0 -36
  92. package/__test__/update.test.ts +0 -117
  93. package/__test__/utils.ts +0 -25
  94. package/__test__/validateCommand.test.ts +0 -647
  95. package/__test__/validateEngine.test.ts +0 -245
  96. package/__test__/validateRules.test.ts +0 -1275
  97. package/__test__/welcome.test.ts +0 -15
  98. package/__test__/workflows/client.test.ts +0 -126
  99. package/bin/accessibility.js +0 -111
  100. package/bin/accessibilityCheck.js +0 -82
  101. package/bin/addDomain.js +0 -130
  102. package/bin/agent-auth.js +0 -104
  103. package/bin/agent-claim.js +0 -97
  104. package/bin/agent-credentials.js +0 -124
  105. package/bin/agent-deployment.js +0 -96
  106. package/bin/agent-http.js +0 -45
  107. package/bin/agent-setup-config.js +0 -141
  108. package/bin/agent-setup.js +0 -146
  109. package/bin/agent.js +0 -42
  110. package/bin/analytics/client.js +0 -60
  111. package/bin/analytics/dates.js +0 -6
  112. package/bin/analytics/filters.js +0 -27
  113. package/bin/analytics/format.js +0 -13
  114. package/bin/analytics/index.js +0 -496
  115. package/bin/analytics/output.js +0 -75
  116. package/bin/analytics/types.js +0 -1
  117. package/bin/authenticatedFetch.js +0 -46
  118. package/bin/brokenLinks.js +0 -122
  119. package/bin/callbackServer.js +0 -65
  120. package/bin/cli.js +0 -813
  121. package/bin/comingSoon.js +0 -26
  122. package/bin/config.js +0 -78
  123. package/bin/constants.js +0 -16
  124. package/bin/deploy-base.js +0 -20
  125. package/bin/deploy-github-actions.js +0 -102
  126. package/bin/deploy-github-setup.js +0 -165
  127. package/bin/deploy-instructions.js +0 -71
  128. package/bin/deploy.js +0 -123
  129. package/bin/feedback.js +0 -36
  130. package/bin/format.js +0 -121
  131. package/bin/helpers.js +0 -238
  132. package/bin/idToken.js +0 -14
  133. package/bin/index.js +0 -102
  134. package/bin/init.js +0 -182
  135. package/bin/instructions.js +0 -101
  136. package/bin/keyring.js +0 -78
  137. package/bin/login.js +0 -123
  138. package/bin/logout.js +0 -18
  139. package/bin/mdxAccessibility.js +0 -113
  140. package/bin/mdxLinter.js +0 -55
  141. package/bin/middlewares/subdomainMiddleware.js +0 -28
  142. package/bin/middlewares/telemetryMiddleware.js +0 -61
  143. package/bin/migrate.js +0 -54
  144. package/bin/og.js +0 -145
  145. package/bin/openApiCheck.js +0 -99
  146. package/bin/resolveFiles.js +0 -114
  147. package/bin/score/client.js +0 -40
  148. package/bin/score/index.js +0 -211
  149. package/bin/score/types.js +0 -1
  150. package/bin/signup.js +0 -118
  151. package/bin/start.js +0 -36
  152. package/bin/status.js +0 -106
  153. package/bin/telemetry/client.js +0 -53
  154. package/bin/telemetry/distinctId.js +0 -68
  155. package/bin/telemetry/sessionId.js +0 -36
  156. package/bin/telemetry/track.js +0 -149
  157. package/bin/templates.js +0 -127
  158. package/bin/tokenRefresh.js +0 -50
  159. package/bin/tsconfig.build.tsbuildinfo +0 -1
  160. package/bin/update.js +0 -65
  161. package/bin/validate/command.js +0 -127
  162. package/bin/validate/engine.js +0 -154
  163. package/bin/validate/files.js +0 -163
  164. package/bin/validate/mdx.js +0 -238
  165. package/bin/validate/output.js +0 -44
  166. package/bin/validate/report.js +0 -11
  167. package/bin/validate/rules/build.js +0 -102
  168. package/bin/validate/rules/content/duplicateH1.js +0 -57
  169. package/bin/validate/rules/content/foreignSyntax.js +0 -120
  170. package/bin/validate/rules/content/katex.js +0 -34
  171. package/bin/validate/rules/content/missingSnippet.js +0 -34
  172. package/bin/validate/rules/content/undefinedVariable.js +0 -13
  173. package/bin/validate/rules/content/unknownComponent.js +0 -121
  174. package/bin/validate/rules/content/voidTags.js +0 -38
  175. package/bin/validate/rules/index.js +0 -21
  176. package/bin/validate/rules/openapi.js +0 -50
  177. package/bin/validate/rules/parseError.js +0 -7
  178. package/bin/validate/site.js +0 -57
  179. package/bin/validate/types.js +0 -1
  180. package/bin/vendor/converter.js +0 -30882
  181. package/bin/welcome.js +0 -108
  182. package/bin/workflows/client.js +0 -34
  183. package/bin/workflows/index.js +0 -269
  184. package/bin/workflows/types.js +0 -11
  185. package/scripts/bundle-converter.mjs +0 -26
  186. package/scripts/generate-logo.mjs +0 -79
  187. package/src/accessibility.ts +0 -180
  188. package/src/accessibilityCheck.tsx +0 -150
  189. package/src/addDomain.tsx +0 -206
  190. package/src/agent-auth.ts +0 -119
  191. package/src/agent-claim.ts +0 -124
  192. package/src/agent-credentials.ts +0 -104
  193. package/src/agent-deployment.ts +0 -116
  194. package/src/agent-http.ts +0 -34
  195. package/src/agent-setup-config.ts +0 -144
  196. package/src/agent-setup.ts +0 -165
  197. package/src/agent.ts +0 -56
  198. package/src/analytics/client.ts +0 -153
  199. package/src/analytics/dates.ts +0 -6
  200. package/src/analytics/filters.ts +0 -50
  201. package/src/analytics/format.ts +0 -13
  202. package/src/analytics/index.tsx +0 -599
  203. package/src/analytics/output.ts +0 -99
  204. package/src/analytics/types.ts +0 -145
  205. package/src/authenticatedFetch.ts +0 -42
  206. package/src/brokenLinks.tsx +0 -152
  207. package/src/callbackServer.ts +0 -64
  208. package/src/cli.tsx +0 -1105
  209. package/src/comingSoon.tsx +0 -29
  210. package/src/config.ts +0 -75
  211. package/src/constants.ts +0 -28
  212. package/src/deploy-base.ts +0 -18
  213. package/src/deploy-github-actions.ts +0 -139
  214. package/src/deploy-github-setup.ts +0 -189
  215. package/src/deploy-instructions.ts +0 -76
  216. package/src/deploy.ts +0 -165
  217. package/src/feedback.tsx +0 -31
  218. package/src/format.tsx +0 -82
  219. package/src/helpers.tsx +0 -279
  220. package/src/idToken.ts +0 -17
  221. package/src/index.ts +0 -109
  222. package/src/init.tsx +0 -237
  223. package/src/instructions.ts +0 -99
  224. package/src/keyring.ts +0 -65
  225. package/src/login.tsx +0 -166
  226. package/src/logout.tsx +0 -8
  227. package/src/mdxAccessibility.ts +0 -134
  228. package/src/mdxLinter.tsx +0 -88
  229. package/src/middlewares/subdomainMiddleware.ts +0 -20
  230. package/src/middlewares/telemetryMiddleware.ts +0 -55
  231. package/src/migrate.ts +0 -76
  232. package/src/og.tsx +0 -185
  233. package/src/openApiCheck.tsx +0 -125
  234. package/src/resolveFiles.ts +0 -101
  235. package/src/score/client.ts +0 -36
  236. package/src/score/index.tsx +0 -205
  237. package/src/score/types.ts +0 -15
  238. package/src/signup.tsx +0 -172
  239. package/src/start.ts +0 -27
  240. package/src/status.tsx +0 -129
  241. package/src/telemetry/client.ts +0 -46
  242. package/src/telemetry/distinctId.ts +0 -70
  243. package/src/telemetry/sessionId.ts +0 -40
  244. package/src/telemetry/track.ts +0 -163
  245. package/src/templates.tsx +0 -143
  246. package/src/tokenRefresh.ts +0 -53
  247. package/src/update.tsx +0 -89
  248. package/src/validate/command.tsx +0 -135
  249. package/src/validate/engine.ts +0 -210
  250. package/src/validate/files.ts +0 -249
  251. package/src/validate/mdx.ts +0 -290
  252. package/src/validate/output.tsx +0 -76
  253. package/src/validate/report.ts +0 -40
  254. package/src/validate/rules/build.ts +0 -146
  255. package/src/validate/rules/content/duplicateH1.ts +0 -78
  256. package/src/validate/rules/content/foreignSyntax.ts +0 -144
  257. package/src/validate/rules/content/katex.ts +0 -33
  258. package/src/validate/rules/content/missingSnippet.ts +0 -36
  259. package/src/validate/rules/content/undefinedVariable.ts +0 -20
  260. package/src/validate/rules/content/unknownComponent.ts +0 -130
  261. package/src/validate/rules/content/voidTags.ts +0 -43
  262. package/src/validate/rules/index.ts +0 -23
  263. package/src/validate/rules/openapi.ts +0 -59
  264. package/src/validate/rules/parseError.ts +0 -9
  265. package/src/validate/site.ts +0 -53
  266. package/src/validate/types.ts +0 -102
  267. package/src/vendor/converter.ts +0 -1
  268. package/src/welcome.ts +0 -154
  269. package/src/workflows/client.ts +0 -39
  270. package/src/workflows/index.tsx +0 -287
  271. package/src/workflows/types.ts +0 -73
  272. package/tsconfig.build.json +0 -4
  273. package/tsconfig.json +0 -10
  274. package/vitest.config.ts +0 -9
@@ -1,64 +0,0 @@
1
- import { detectAgent, isCI } from '../src/agent.js';
2
-
3
- const originalIsTTY = process.stdout.isTTY;
4
-
5
- afterEach(() => {
6
- process.stdout.isTTY = originalIsTTY;
7
- });
8
-
9
- describe('detectAgent', () => {
10
- it('returns undefined with no agent env', () => {
11
- expect(detectAgent({})).toBeUndefined();
12
- });
13
-
14
- it.each([
15
- [{ CLAUDECODE: '1' }, 'claude_code'],
16
- [{ TERM_PROGRAM: 'claude' }, 'claude_code'],
17
- [{ CLAUDECODE: '1', CLAUDE_CODE_IS_COWORK: '1' }, 'cowork'],
18
- [{ CODEX_THREAD_ID: 'abc' }, 'codex_cli'],
19
- [{ GEMINI_CLI: '1' }, 'gemini_cli'],
20
- [{ CURSOR_AGENT: '1' }, 'cursor-cli'],
21
- [{ OPENCODE: '1' }, 'open_code'],
22
- [{ PATH: '/usr/bin:/home/me/.pi/agent/bin' }, 'pi'],
23
- [{ EDITOR: '/opt/devin/bin/code' }, 'devin'],
24
- ])('detects %o as %s', (env, expected) => {
25
- expect(detectAgent(env)).toBe(expected);
26
- });
27
-
28
- it('prefers explicit AI_AGENT and AGENT', () => {
29
- expect(detectAgent({ AI_AGENT: 'Amp', CLAUDECODE: '1' })).toBe('amp');
30
- expect(detectAgent({ AGENT: 'goose' })).toBe('goose');
31
- });
32
-
33
- it('prefers CLI agents over IDE hosts', () => {
34
- process.stdout.isTTY = false;
35
- expect(detectAgent({ CLAUDECODE: '1', CURSOR_TRACE_ID: 'x' })).toBe('claude_code');
36
- expect(detectAgent({ CURSOR_TRACE_ID: 'x' })).toBe('cursor');
37
- });
38
-
39
- it('ignores IDE and config markers when a human is at a TTY', () => {
40
- process.stdout.isTTY = true;
41
- expect(
42
- detectAgent({
43
- CURSOR_TRACE_ID: 'x',
44
- REPL_ID: 'y',
45
- TERM_PROGRAM: 'kiro',
46
- GOOSE_PROVIDER: 'openai',
47
- COPILOT_MODEL: 'gpt',
48
- OPENCODE_CLIENT: 'desktop',
49
- })
50
- ).toBeUndefined();
51
- });
52
- });
53
-
54
- describe('isCI', () => {
55
- it.each([
56
- [{}, false],
57
- [{ CI: 'true' }, true],
58
- [{ CI: '1' }, true],
59
- [{ CI: 'false' }, false],
60
- [{ CI: '0' }, false],
61
- ])('%o -> %s', (env, expected) => {
62
- expect(isCI(env)).toBe(expected);
63
- });
64
- });
@@ -1,180 +0,0 @@
1
- import {
2
- getAssistantThread,
3
- getFeedback,
4
- getFeedbackByPage,
5
- getBuckets,
6
- getBucketThreads,
7
- getConversations,
8
- getKpi,
9
- getSearches,
10
- getViews,
11
- getVisitors,
12
- } from '../../src/analytics/client.js';
13
-
14
- vi.mock('../../src/keyring.js', () => ({
15
- getAccessToken: vi.fn().mockResolvedValue(null),
16
- getRefreshToken: vi.fn().mockResolvedValue(null),
17
- storeCredentials: vi.fn().mockResolvedValue(undefined),
18
- }));
19
-
20
- const mockFetch = vi.fn();
21
- global.fetch = mockFetch;
22
-
23
- beforeEach(() => {
24
- vi.stubEnv('MINTLIFY_SESSION_TOKEN', 'test-token');
25
- vi.stubEnv('MINTLIFY_API_URL', 'http://test-server:5000');
26
- mockFetch.mockReset();
27
- });
28
-
29
- afterEach(() => {
30
- vi.unstubAllEnvs();
31
- });
32
-
33
- function mockOk(data: unknown) {
34
- mockFetch.mockResolvedValueOnce({
35
- ok: true,
36
- status: 200,
37
- json: () => Promise.resolve(data),
38
- });
39
- }
40
-
41
- function mockError(status: number, body: string) {
42
- mockFetch.mockResolvedValueOnce({
43
- ok: false,
44
- status,
45
- statusText: 'Bad Request',
46
- text: () => Promise.resolve(body),
47
- });
48
- }
49
-
50
- function calledUrl(): string {
51
- const arg = mockFetch.mock.calls[0]![0];
52
- return typeof arg === 'string' ? arg : String(arg);
53
- }
54
-
55
- function calledUrlObj(): URL {
56
- return new URL(calledUrl());
57
- }
58
-
59
- describe('client auth', () => {
60
- it('throws when no session token is set', async () => {
61
- vi.stubEnv('MINTLIFY_SESSION_TOKEN', '');
62
- await expect(getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' })).rejects.toThrow(
63
- 'Not authenticated'
64
- );
65
- });
66
-
67
- it('sends session cookie header', async () => {
68
- mockOk({ feedback: [], nextCursor: null, hasMore: false });
69
- await getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'test');
70
- expect(mockFetch).toHaveBeenCalledWith(
71
- expect.any(String),
72
- expect.objectContaining({
73
- headers: expect.objectContaining({
74
- Authorization: 'Bearer test-token',
75
- }),
76
- })
77
- );
78
- });
79
- });
80
-
81
- describe('client request handling', () => {
82
- it('throws on API error', async () => {
83
- mockError(400, 'Invalid params');
84
- await expect(getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' })).rejects.toThrow(
85
- 'API error (400): Invalid params'
86
- );
87
- });
88
-
89
- it('passes subdomain as query param when provided', async () => {
90
- mockOk({ feedback: [], nextCursor: null, hasMore: false });
91
- await getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'my-docs');
92
- expect(calledUrlObj().searchParams.get('subdomain')).toBe('my-docs');
93
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/feedback');
94
- });
95
-
96
- it('omits subdomain param when not provided', async () => {
97
- mockOk({ feedback: [], nextCursor: null, hasMore: false });
98
- await getFeedback({ dateFrom: '2024-01-01', dateTo: '2024-01-31' });
99
- expect(calledUrlObj().searchParams.has('subdomain')).toBe(false);
100
- });
101
-
102
- it('sets query params and omits undefined values', async () => {
103
- mockOk({ feedback: [], nextCursor: null, hasMore: false });
104
- await getFeedback({
105
- dateFrom: '2024-01-01',
106
- dateTo: '2024-01-31',
107
- limit: 10,
108
- cursor: undefined,
109
- });
110
- expect(calledUrlObj().searchParams.get('dateFrom')).toBe('2024-01-01');
111
- expect(calledUrlObj().searchParams.get('limit')).toBe('10');
112
- expect(calledUrlObj().searchParams.has('cursor')).toBe(false);
113
- });
114
- });
115
-
116
- describe('endpoint paths', () => {
117
- it('getKpi', async () => {
118
- mockOk({ humanVisitors: 0 });
119
- await getKpi({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
120
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/kpi');
121
- expect(calledUrlObj().searchParams.get('subdomain')).toBe('docs');
122
- });
123
-
124
- it('getFeedbackByPage', async () => {
125
- mockOk({ feedback: [], hasMore: false });
126
- await getFeedbackByPage({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
127
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/feedback/by-page');
128
- });
129
-
130
- it('getConversations', async () => {
131
- mockOk({ conversations: [], nextCursor: null, hasMore: false });
132
- await getConversations({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
133
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/assistant');
134
- });
135
-
136
- it('getAssistantThread', async () => {
137
- mockOk({ threadId: 'thread-123', createdAt: '2024-01-01', messages: [] });
138
- await getAssistantThread('thread/123', 'docs');
139
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/assistant/threads/thread%2F123');
140
- expect(calledUrlObj().searchParams.get('subdomain')).toBe('docs');
141
- });
142
-
143
- it('getSearches', async () => {
144
- mockOk({ searches: [], totalSearches: 0, nextCursor: null });
145
- await getSearches({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
146
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/searches');
147
- });
148
-
149
- it('getViews', async () => {
150
- mockOk({ totals: {}, views: [], hasMore: false });
151
- await getViews({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
152
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/views');
153
- });
154
-
155
- it('getVisitors', async () => {
156
- mockOk({ totals: {}, visitors: [], hasMore: false });
157
- await getVisitors({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
158
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/visitors');
159
- });
160
-
161
- it('getBuckets', async () => {
162
- mockOk({ data: [], pagination: { total: 0 } });
163
- await getBuckets({ dateFrom: '2024-01-01', dateTo: '2024-01-31' }, 'docs');
164
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/conversations/buckets');
165
- expect(calledUrlObj().searchParams.get('subdomain')).toBe('docs');
166
- });
167
-
168
- it('getBucketThreads', async () => {
169
- mockOk({ data: [], pagination: { total: 0, hasMore: false, nextCursor: null } });
170
- await getBucketThreads(
171
- 'bucket-123',
172
- { dateFrom: '2024-01-01', limit: 25, cursor: 'next-thread' },
173
- 'docs'
174
- );
175
- expect(calledUrlObj().pathname).toBe('/api/cli/analytics/conversations/buckets/bucket-123');
176
- expect(calledUrlObj().searchParams.get('subdomain')).toBe('docs');
177
- expect(calledUrlObj().searchParams.get('limit')).toBe('25');
178
- expect(calledUrlObj().searchParams.get('cursor')).toBe('next-thread');
179
- });
180
- });
@@ -1,12 +0,0 @@
1
- import { formatLocalDate } from '../../src/analytics/dates.js';
2
-
3
- describe('formatLocalDate', () => {
4
- it('formats the local calendar date without converting to UTC', () => {
5
- const date = new Date(2024, 0, 2, 23, 30);
6
- expect(formatLocalDate(date)).toBe('2024-01-02');
7
- });
8
-
9
- it('pads single-digit months and days', () => {
10
- expect(formatLocalDate(new Date(2024, 8, 7))).toBe('2024-09-07');
11
- });
12
- });
@@ -1,116 +0,0 @@
1
- import {
2
- filterConversationResponse,
3
- filterFeedbackByPageResponse,
4
- filterFeedbackResponse,
5
- filterSearchResponse,
6
- } from '../../src/analytics/filters.js';
7
- import type {
8
- ConversationResponse,
9
- FeedbackByPageResponse,
10
- FeedbackResponse,
11
- SearchResponse,
12
- } from '../../src/analytics/types.js';
13
-
14
- describe('analytics response filters', () => {
15
- it('returns a search response whose JSON rows match query and page filters', () => {
16
- const data: SearchResponse = {
17
- searches: [
18
- {
19
- searchQuery: 'Deploy a site',
20
- hits: 5,
21
- ctr: 40,
22
- topClickedPage: '/deploy',
23
- lastSearchedAt: '2024-01-01T00:00:00Z',
24
- },
25
- {
26
- searchQuery: 'Deploy locally',
27
- hits: 3,
28
- ctr: 20,
29
- topClickedPage: '/development',
30
- lastSearchedAt: '2024-01-02T00:00:00Z',
31
- },
32
- {
33
- searchQuery: 'Authentication',
34
- hits: 2,
35
- ctr: 10,
36
- topClickedPage: '/auth',
37
- lastSearchedAt: '2024-01-03T00:00:00Z',
38
- },
39
- ],
40
- totalSearches: 10,
41
- nextCursor: null,
42
- };
43
-
44
- expect(filterSearchResponse(data, { query: 'deploy', page: '/deploy' }).searches).toEqual([
45
- data.searches[0],
46
- ]);
47
- });
48
-
49
- it('filters grouped feedback in the returned response', () => {
50
- const data: FeedbackByPageResponse = {
51
- feedback: [
52
- { path: '/guide', thumbsUp: 1, thumbsDown: 0, code: 0, total: 1 },
53
- { path: '/api', thumbsUp: 0, thumbsDown: 1, code: 0, total: 1 },
54
- ],
55
- hasMore: false,
56
- };
57
-
58
- expect(filterFeedbackByPageResponse(data, '/guide').feedback).toEqual([data.feedback[0]]);
59
- });
60
-
61
- it('filters individual feedback in the returned response', () => {
62
- const data: FeedbackResponse = {
63
- feedback: [
64
- {
65
- id: '1',
66
- path: '/guide',
67
- comment: null,
68
- createdAt: null,
69
- source: 'contextual',
70
- status: 'pending',
71
- },
72
- {
73
- id: '2',
74
- path: '/api',
75
- comment: null,
76
- createdAt: null,
77
- source: 'contextual',
78
- status: 'pending',
79
- },
80
- ],
81
- nextCursor: null,
82
- hasMore: false,
83
- };
84
-
85
- expect(filterFeedbackResponse(data, '/guide').feedback).toEqual([data.feedback[0]]);
86
- });
87
-
88
- it('filters conversations in the returned response', () => {
89
- const data: ConversationResponse = {
90
- conversations: [
91
- {
92
- id: '1',
93
- timestamp: '2024-01-01T00:00:00Z',
94
- query: 'Guide question',
95
- response: 'Answer',
96
- sources: [{ title: 'Guide', url: 'https://docs.example.com/guide' }],
97
- queryCategory: null,
98
- },
99
- {
100
- id: '2',
101
- timestamp: '2024-01-02T00:00:00Z',
102
- query: 'API question',
103
- response: 'Answer',
104
- sources: [{ title: 'API', url: 'https://docs.example.com/api' }],
105
- queryCategory: null,
106
- },
107
- ],
108
- nextCursor: null,
109
- hasMore: false,
110
- };
111
-
112
- expect(filterConversationResponse(data, '/guide').conversations).toEqual([
113
- data.conversations[0],
114
- ]);
115
- });
116
- });
@@ -1,137 +0,0 @@
1
- import { num, pct, truncate } from '../../src/analytics/format.js';
2
- import {
3
- formatBarChart,
4
- formatPlainTable,
5
- formatPrettyTable,
6
- resolveFormat,
7
- } from '../../src/analytics/output.js';
8
- import * as helpers from '../../src/helpers.js';
9
-
10
- afterEach(() => {
11
- vi.restoreAllMocks();
12
- });
13
-
14
- describe('num', () => {
15
- it('formats numbers with locale separators', () => {
16
- expect(num(0)).toBe('0');
17
- expect(num(1234)).toBe('1,234');
18
- expect(num(1000000)).toBe('1,000,000');
19
- });
20
- });
21
-
22
- describe('pct', () => {
23
- it('returns percentage string', () => {
24
- expect(pct(1, 4)).toBe('25.0%');
25
- expect(pct(1, 3)).toBe('33.3%');
26
- });
27
-
28
- it('returns dash when total is zero', () => {
29
- expect(pct(0, 0)).toBe('\u2014');
30
- });
31
- });
32
-
33
- describe('truncate', () => {
34
- it('returns short strings unchanged', () => {
35
- expect(truncate('hello', 10)).toBe('hello');
36
- });
37
-
38
- it('truncates long strings with ellipsis', () => {
39
- expect(truncate('hello world', 6)).toBe('hello\u2026');
40
- });
41
-
42
- it('returns string unchanged when exactly at max', () => {
43
- expect(truncate('hello', 5)).toBe('hello');
44
- });
45
- });
46
-
47
- describe('formatPrettyTable', () => {
48
- it('returns dim message for empty rows', () => {
49
- const result = formatPrettyTable(['A', 'B'], []);
50
- expect(result).toContain('No data found');
51
- });
52
-
53
- it('formats headers and rows with aligned columns', () => {
54
- const result = formatPrettyTable(
55
- ['Name', 'Count'],
56
- [
57
- ['foo', '10'],
58
- ['barbaz', '5'],
59
- ]
60
- );
61
- const lines = result.split('\n');
62
- expect(lines).toHaveLength(4);
63
- expect(lines[2]).toContain('foo');
64
- expect(lines[3]).toContain('barbaz');
65
- });
66
- });
67
-
68
- describe('formatPlainTable', () => {
69
- it('returns empty string for empty rows', () => {
70
- expect(formatPlainTable(['A', 'B'], [])).toBe('');
71
- });
72
-
73
- it('formats with tab separation and uppercase headers', () => {
74
- const result = formatPlainTable(
75
- ['Name', 'Count'],
76
- [
77
- ['foo', '10'],
78
- ['bar', '5'],
79
- ]
80
- );
81
- const lines = result.split('\n');
82
- expect(lines[0]).toContain('NAME');
83
- expect(lines[0]).toContain('\t');
84
- expect(lines[1]).toContain('foo');
85
- });
86
- });
87
-
88
- describe('resolveFormat', () => {
89
- it('returns json when AI mode is active', () => {
90
- vi.spyOn(helpers, 'isAI').mockReturnValue(true);
91
- expect(resolveFormat({})).toBe('json');
92
- });
93
-
94
- it('returns specified format', () => {
95
- vi.spyOn(helpers, 'isAI').mockReturnValue(true);
96
- expect(resolveFormat({ format: 'plain' })).toBe('plain');
97
- expect(resolveFormat({ format: 'json' })).toBe('json');
98
- expect(resolveFormat({ format: 'graph' })).toBe('graph');
99
- });
100
-
101
- it('defaults to plain', () => {
102
- vi.spyOn(helpers, 'isAI').mockReturnValue(false);
103
- expect(resolveFormat({})).toBe('plain');
104
- });
105
- });
106
-
107
- describe('formatBarChart', () => {
108
- it('returns dim message for empty items', () => {
109
- expect(formatBarChart([])).toContain('No data found');
110
- });
111
-
112
- it('renders bars with labels and values', () => {
113
- const result = formatBarChart([
114
- { label: 'Foo', value: 10 },
115
- { label: 'Bar', value: 5 },
116
- ]);
117
- const lines = result.split('\n');
118
- expect(lines).toHaveLength(2);
119
- expect(lines[0]).toContain('Foo');
120
- expect(lines[0]).toContain('10');
121
- expect(lines[0]).toContain('\u2588');
122
- expect(lines[1]).toContain('Bar');
123
- expect(lines[1]).toContain('5');
124
- });
125
-
126
- it('scales bars relative to max value', () => {
127
- const result = formatBarChart([
128
- { label: 'Big', value: 100 },
129
- { label: 'Small', value: 10 },
130
- ]);
131
- const bigBar = result.split('\n')[0]!;
132
- const smallBar = result.split('\n')[1]!;
133
- const bigBlocks = (bigBar.match(/\u2588/g) || []).length;
134
- const smallBlocks = (smallBar.match(/\u2588/g) || []).length;
135
- expect(bigBlocks).toBeGreaterThan(smallBlocks);
136
- });
137
- });
@@ -1,182 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
-
3
- import { authenticatedFetch } from '../src/authenticatedFetch.js';
4
-
5
- const mockGetAccessToken = vi.fn();
6
- const mockGetRefreshToken = vi.fn();
7
- const mockStoreCredentials = vi.fn();
8
-
9
- vi.mock('../src/keyring.js', () => ({
10
- getAccessToken: (...args: unknown[]) => mockGetAccessToken(...args),
11
- getRefreshToken: (...args: unknown[]) => mockGetRefreshToken(...args),
12
- storeCredentials: (...args: unknown[]) => mockStoreCredentials(...args),
13
- }));
14
-
15
- const mockFetch = vi.fn();
16
- global.fetch = mockFetch;
17
-
18
- function makeResponse(status: number, body: unknown = {}) {
19
- return {
20
- ok: status >= 200 && status < 300,
21
- status,
22
- statusText: status === 401 ? 'Unauthorized' : 'OK',
23
- json: () => Promise.resolve(body),
24
- text: () => Promise.resolve(JSON.stringify(body)),
25
- };
26
- }
27
-
28
- describe('authenticatedFetch', () => {
29
- beforeEach(() => {
30
- vi.clearAllMocks();
31
- mockFetch.mockReset();
32
- vi.stubEnv('MINTLIFY_SESSION_TOKEN', '');
33
- });
34
-
35
- afterEach(() => {
36
- vi.unstubAllEnvs();
37
- });
38
-
39
- it('sends access token from keyring', async () => {
40
- mockGetAccessToken.mockResolvedValue('access-123');
41
- mockFetch.mockResolvedValueOnce(makeResponse(200, { ok: true }));
42
-
43
- await authenticatedFetch('http://test/api');
44
-
45
- expect(mockFetch).toHaveBeenCalledWith('http://test/api', {
46
- headers: { Authorization: 'Bearer access-123' },
47
- });
48
- });
49
-
50
- it('falls back to MINTLIFY_SESSION_TOKEN env var', async () => {
51
- mockGetAccessToken.mockResolvedValue(null);
52
- vi.stubEnv('MINTLIFY_SESSION_TOKEN', 'env-token');
53
- mockFetch.mockResolvedValueOnce(makeResponse(200));
54
-
55
- await authenticatedFetch('http://test/api');
56
-
57
- expect(mockFetch).toHaveBeenCalledWith('http://test/api', {
58
- headers: { Authorization: 'Bearer env-token' },
59
- });
60
- });
61
-
62
- it('throws when no token is available', async () => {
63
- mockGetAccessToken.mockResolvedValue(null);
64
-
65
- await expect(authenticatedFetch('http://test/api')).rejects.toThrow('Not authenticated');
66
- });
67
-
68
- it('refreshes token on 401 and retries', async () => {
69
- mockGetAccessToken.mockResolvedValue('expired-token');
70
- mockGetRefreshToken.mockResolvedValue('refresh-123');
71
- mockStoreCredentials.mockResolvedValue(undefined);
72
-
73
- mockFetch
74
- .mockResolvedValueOnce(makeResponse(401))
75
- .mockResolvedValueOnce(
76
- makeResponse(200, {
77
- access_token: 'new-access',
78
- refresh_token: 'new-refresh',
79
- token_type: 'bearer',
80
- expires_in: 3600,
81
- })
82
- )
83
- .mockResolvedValueOnce(makeResponse(200, { ok: true }));
84
-
85
- const res = await authenticatedFetch('http://test/api');
86
-
87
- expect(res.status).toBe(200);
88
- expect(mockFetch).toHaveBeenCalledTimes(3);
89
- expect(mockFetch).toHaveBeenLastCalledWith('http://test/api', {
90
- headers: { Authorization: 'Bearer new-access' },
91
- });
92
- });
93
-
94
- it('falls back to env token when refresh fails', async () => {
95
- mockGetAccessToken.mockResolvedValue('expired-token');
96
- mockGetRefreshToken.mockResolvedValue('bad-refresh');
97
- vi.stubEnv('MINTLIFY_SESSION_TOKEN', 'env-token');
98
-
99
- mockFetch
100
- .mockResolvedValueOnce(makeResponse(401))
101
- .mockResolvedValueOnce(makeResponse(400, { error: 'invalid_grant' }))
102
- .mockResolvedValueOnce(makeResponse(200, { ok: true }));
103
-
104
- const res = await authenticatedFetch('http://test/api');
105
-
106
- expect(res.status).toBe(200);
107
- expect(mockFetch).toHaveBeenCalledTimes(3);
108
- expect(mockFetch).toHaveBeenLastCalledWith('http://test/api', {
109
- headers: { Authorization: 'Bearer env-token' },
110
- });
111
- });
112
-
113
- it('returns original 401 when refresh fails and no env token', async () => {
114
- mockGetAccessToken.mockResolvedValue('expired-token');
115
- mockGetRefreshToken.mockResolvedValue('bad-refresh');
116
-
117
- mockFetch
118
- .mockResolvedValueOnce(makeResponse(401))
119
- .mockResolvedValueOnce(makeResponse(400, { error: 'invalid_grant' }));
120
-
121
- const res = await authenticatedFetch('http://test/api');
122
-
123
- expect(res.status).toBe(401);
124
- expect(mockFetch).toHaveBeenCalledTimes(2);
125
- });
126
-
127
- it('falls back to env token when no refresh token exists', async () => {
128
- mockGetAccessToken.mockResolvedValue('expired-token');
129
- mockGetRefreshToken.mockResolvedValue(null);
130
- vi.stubEnv('MINTLIFY_SESSION_TOKEN', 'env-token');
131
-
132
- mockFetch
133
- .mockResolvedValueOnce(makeResponse(401))
134
- .mockResolvedValueOnce(makeResponse(200, { ok: true }));
135
-
136
- const res = await authenticatedFetch('http://test/api');
137
-
138
- expect(res.status).toBe(200);
139
- expect(mockFetch).toHaveBeenCalledTimes(2);
140
- expect(mockFetch).toHaveBeenLastCalledWith('http://test/api', {
141
- headers: { Authorization: 'Bearer env-token' },
142
- });
143
- });
144
-
145
- it('returns original 401 when no refresh token and no env token', async () => {
146
- mockGetAccessToken.mockResolvedValue('expired-token');
147
- mockGetRefreshToken.mockResolvedValue(null);
148
-
149
- mockFetch.mockResolvedValueOnce(makeResponse(401));
150
-
151
- const res = await authenticatedFetch('http://test/api');
152
-
153
- expect(res.status).toBe(401);
154
- expect(mockFetch).toHaveBeenCalledTimes(1);
155
- });
156
-
157
- it('does not attempt refresh when only env token is available', async () => {
158
- mockGetAccessToken.mockResolvedValue(null);
159
- vi.stubEnv('MINTLIFY_SESSION_TOKEN', 'env-token');
160
-
161
- mockFetch.mockResolvedValueOnce(makeResponse(401));
162
-
163
- const res = await authenticatedFetch('http://test/api');
164
-
165
- expect(res.status).toBe(401);
166
- expect(mockGetRefreshToken).not.toHaveBeenCalled();
167
- expect(mockFetch).toHaveBeenCalledTimes(1);
168
- });
169
-
170
- it('merges custom headers with auth header', async () => {
171
- mockGetAccessToken.mockResolvedValue('token-123');
172
- mockFetch.mockResolvedValueOnce(makeResponse(200));
173
-
174
- await authenticatedFetch('http://test/api', {
175
- headers: { Accept: 'application/json' },
176
- });
177
-
178
- expect(mockFetch).toHaveBeenCalledWith('http://test/api', {
179
- headers: { Accept: 'application/json', Authorization: 'Bearer token-123' },
180
- });
181
- });
182
- });