gemiterm 2.0.0 → 2.1.1

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 (155) hide show
  1. package/README.md +32 -9
  2. package/package.json +13 -4
  3. package/src/cli/command-registry.ts +66 -62
  4. package/src/cli/commands/continue-command.ts +75 -1
  5. package/src/cli/commands/install-skills-command.ts +35 -0
  6. package/src/cli/commands/new-command.ts +62 -0
  7. package/src/cli/index.ts +19 -44
  8. package/src/cli/utils/long-arg-guard.ts +28 -0
  9. package/src/cli/utils/prompt-file.ts +26 -0
  10. package/src/infrastructure/cli-parser.ts +77 -0
  11. package/src/infrastructure/io.ts +9 -0
  12. package/src/services/skills-cli-driver.ts +58 -0
  13. package/src/services/skills-service.ts +52 -0
  14. package/.env +0 -2
  15. package/.github/workflows/manual-release.yml +0 -34
  16. package/.github/workflows/release.yml +0 -198
  17. package/.github/workflows/test.yml +0 -29
  18. package/.opencode/commands/opsx-apply.md +0 -152
  19. package/.opencode/commands/opsx-archive.md +0 -157
  20. package/.opencode/commands/opsx-explore.md +0 -169
  21. package/.opencode/commands/opsx-propose.md +0 -104
  22. package/.opencode/commands/opsx-sync.md +0 -140
  23. package/.opencode/commands/search-intelligently.md +0 -9
  24. package/.opencode/opencode.json +0 -20
  25. package/.opencode/skills/intellisearch/.version +0 -1
  26. package/.opencode/skills/intellisearch/SKILL.md +0 -84
  27. package/.opencode/skills/intellisearch/references/brave-search.md +0 -67
  28. package/.opencode/skills/intellisearch/references/ddg-search.md +0 -79
  29. package/.opencode/skills/intellisearch/references/deepwiki-tools.md +0 -246
  30. package/.opencode/skills/intellisearch/references/examples.md +0 -97
  31. package/.opencode/skills/intellisearch/references/gh-cli.md +0 -143
  32. package/.opencode/skills/intellisearch/references/google-search.md +0 -40
  33. package/.opencode/skills/intellisearch/references/search-workflow.md +0 -143
  34. package/.opencode/skills/intellisearch/references/workflow.md +0 -115
  35. package/.opencode/skills/openspec-apply-change/SKILL.md +0 -159
  36. package/.opencode/skills/openspec-archive-change/SKILL.md +0 -117
  37. package/.opencode/skills/openspec-explore/SKILL.md +0 -287
  38. package/.opencode/skills/openspec-propose/SKILL.md +0 -111
  39. package/.opencode/skills/openspec-sync-specs/SKILL.md +0 -147
  40. package/.serena/project.yml +0 -133
  41. package/AGENTS.md +0 -136
  42. package/CHANGELOG.md +0 -3
  43. package/bun.lock +0 -105
  44. package/docs/INSTALL.md +0 -185
  45. package/docs/PLAYWRIGHT_CLI_API.md +0 -306
  46. package/docs/python-release-for-reference.md +0 -175
  47. package/examples/sample_json_export.json +0 -32
  48. package/examples/sample_markdown_export.md +0 -221
  49. package/examples/usage_examples.sh +0 -222
  50. package/install.ps1 +0 -264
  51. package/install.sh +0 -275
  52. package/openspec/MAESTRO_MIGRATION.md +0 -180
  53. package/openspec/changes/archive/2026-06-08-command-spec-conformance/.openspec.yaml +0 -2
  54. package/openspec/changes/archive/2026-06-08-command-spec-conformance/design.md +0 -194
  55. package/openspec/changes/archive/2026-06-08-command-spec-conformance/proposal.md +0 -52
  56. package/openspec/changes/archive/2026-06-08-command-spec-conformance/specs/multi-profile-conversations/spec.md +0 -133
  57. package/openspec/changes/archive/2026-06-08-command-spec-conformance/tasks.md +0 -95
  58. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/.openspec.yaml +0 -2
  59. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/design.md +0 -28
  60. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/proposal.md +0 -22
  61. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/specs/interactive-prompt-loop/spec.md +0 -35
  62. package/openspec/changes/archive/2026-06-09-refactor-interactive-prompt-loop/tasks.md +0 -28
  63. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/.openspec.yaml +0 -2
  64. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/design.md +0 -323
  65. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/proposal.md +0 -122
  66. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/specs/no-capability-changes/spec.md +0 -29
  67. package/openspec/changes/archive/2026-06-09-replace-gemini-api-placeholder-with-gemini-reverse/tasks.md +0 -172
  68. package/openspec/changes/archive/2026-06-09-v2-install-migration/.openspec.yaml +0 -2
  69. package/openspec/changes/archive/2026-06-09-v2-install-migration/design.md +0 -241
  70. package/openspec/changes/archive/2026-06-09-v2-install-migration/proposal.md +0 -41
  71. package/openspec/changes/archive/2026-06-09-v2-install-migration/specs/v2-installer/spec.md +0 -205
  72. package/openspec/changes/archive/2026-06-09-v2-install-migration/tasks.md +0 -97
  73. package/openspec/changes/commander-cli-parser/.openspec.yaml +0 -2
  74. package/openspec/changes/commander-cli-parser/design.md +0 -107
  75. package/openspec/changes/commander-cli-parser/proposal.md +0 -31
  76. package/openspec/changes/commander-cli-parser/specs/cli/spec.md +0 -48
  77. package/openspec/changes/commander-cli-parser/tasks.md +0 -33
  78. package/openspec/changes/cross-platform-build-and-ci/.openspec.yaml +0 -2
  79. package/openspec/changes/cross-platform-build-and-ci/design.md +0 -213
  80. package/openspec/changes/cross-platform-build-and-ci/proposal.md +0 -50
  81. package/openspec/changes/cross-platform-build-and-ci/specs/path-and-file-mediation/spec.md +0 -335
  82. package/openspec/changes/cross-platform-build-and-ci/specs/release-pipeline/spec.md +0 -95
  83. package/openspec/changes/cross-platform-build-and-ci/tasks.md +0 -164
  84. package/openspec/config.yaml +0 -20
  85. package/openspec/specs/auth/spec.md +0 -394
  86. package/openspec/specs/cli/spec.md +0 -108
  87. package/openspec/specs/commands/spec.md +0 -409
  88. package/openspec/specs/configuration/spec.md +0 -130
  89. package/openspec/specs/conversations/spec.md +0 -139
  90. package/openspec/specs/domain-model/spec.md +0 -128
  91. package/openspec/specs/formatters/spec.md +0 -158
  92. package/openspec/specs/install-browser/spec.md +0 -146
  93. package/openspec/specs/interactive-prompt-loop/spec.md +0 -41
  94. package/openspec/specs/logger/spec.md +0 -71
  95. package/openspec/specs/mediator/spec.md +0 -72
  96. package/openspec/specs/multi-profile-conversations/spec.md +0 -145
  97. package/openspec/specs/path-utils/spec.md +0 -101
  98. package/openspec/specs/profiles/spec.md +0 -94
  99. package/openspec/specs/storage/spec.md +0 -198
  100. package/openspec/specs/testing/spec.md +0 -237
  101. package/openspec/specs/v2-installer/spec.md +0 -205
  102. package/openspec/specs/validators/spec.md +0 -65
  103. package/scripts/build.ts +0 -88
  104. package/scripts/clean-build.ps1 +0 -4
  105. package/scripts/clean-build.sh +0 -5
  106. package/scripts/install-browser.ps1 +0 -5
  107. package/scripts/install-browser.sh +0 -6
  108. package/scripts/lint-path-mediation.ps1 +0 -65
  109. package/scripts/lint-path-mediation.sh +0 -40
  110. package/tests/cli/auth-command.test.ts +0 -220
  111. package/tests/cli/command-registry.test.ts +0 -67
  112. package/tests/cli/continue-command.test.ts +0 -100
  113. package/tests/cli/delete-command.test.ts +0 -128
  114. package/tests/cli/export-all-command.test.ts +0 -375
  115. package/tests/cli/install-browser-command.test.ts +0 -48
  116. package/tests/cli/list-command.test.ts +0 -179
  117. package/tests/cli/new-command.test.ts +0 -139
  118. package/tests/cli/status-command.test.ts +0 -106
  119. package/tests/core/query-handlers.test.ts +0 -187
  120. package/tests/fixtures/auth-fixtures.ts +0 -98
  121. package/tests/fixtures/chat-fixtures.ts +0 -87
  122. package/tests/infrastructure/cli-table.test.ts +0 -107
  123. package/tests/infrastructure/formatters.test.ts +0 -202
  124. package/tests/infrastructure/io.test.ts +0 -197
  125. package/tests/infrastructure/logger.test.ts +0 -74
  126. package/tests/infrastructure/storage.test.ts +0 -335
  127. package/tests/infrastructure/validators.test.ts +0 -67
  128. package/tests/integration/commands/auth.test.ts +0 -186
  129. package/tests/integration/commands/continue.test.ts +0 -130
  130. package/tests/integration/commands/delete.test.ts +0 -140
  131. package/tests/integration/commands/export.test.ts +0 -266
  132. package/tests/integration/commands/fetch.test.ts +0 -238
  133. package/tests/integration/commands/list.test.ts +0 -281
  134. package/tests/integration/commands/profile.test.ts +0 -258
  135. package/tests/integration/commands/status.test.ts +0 -223
  136. package/tests/integration/installer-script-shape.test.ts +0 -67
  137. package/tests/parity/compare-outputs.ts +0 -359
  138. package/tests/parity/test-commands-parity.ps1 +0 -82
  139. package/tests/parity/test-commands-parity.sh +0 -61
  140. package/tests/services/auth-service.test.ts +0 -315
  141. package/tests/services/cookie-monitor.test.ts +0 -229
  142. package/tests/services/cookie-storage-service.test.ts +0 -230
  143. package/tests/services/gemini-client-wrapper.test.ts +0 -688
  144. package/tests/services/install-browser-service.test.ts +0 -83
  145. package/tests/services/playwright-cli-driver.test.ts +0 -468
  146. package/tests/services/profile-auth-manager.test.ts +0 -334
  147. package/tests/services/profile-service.test.ts +0 -224
  148. package/tests/setup.ts +0 -95
  149. package/tests/smoke/smoke.test.ts +0 -52
  150. package/tests/unit/config.test.ts +0 -159
  151. package/tests/unit/errors.test.ts +0 -119
  152. package/tests/unit/formatters.test.ts +0 -316
  153. package/tests/unit/mediator.test.ts +0 -152
  154. package/tests/unit/path-utils.test.ts +0 -289
  155. package/tsconfig.json +0 -16
@@ -1,83 +0,0 @@
1
- import { describe, test, expect, beforeEach, mock, spyOn } from "bun:test";
2
- import { InstallBrowserService, InstallBrowserError } from "../../src/services/install-browser-service.ts";
3
-
4
- describe("InstallBrowserService", () => {
5
- let service: InstallBrowserService;
6
-
7
- beforeEach(() => {
8
- service = new InstallBrowserService();
9
- });
10
-
11
- describe("findSystemBrowser", () => {
12
- test("returns BrowserCheckResult with found=true on Windows with Edge", () => {
13
- const originalPlatform = process.platform;
14
- Object.defineProperty(process, "platform", { value: "win32", configurable: true });
15
-
16
- const result = service.findSystemBrowser();
17
- expect(typeof result.found).toBe("boolean");
18
- expect(typeof result.browserName).toBe("string");
19
-
20
- Object.defineProperty(process, "platform", { value: originalPlatform, configurable: true });
21
- });
22
-
23
- test("returns BrowserCheckResult on linux", () => {
24
- const originalPlatform = process.platform;
25
- Object.defineProperty(process, "platform", { value: "linux", configurable: true });
26
-
27
- const result = service.findSystemBrowser();
28
- expect(typeof result.found).toBe("boolean");
29
- expect(typeof result.browserName).toBe("string");
30
-
31
- Object.defineProperty(process, "platform", { value: originalPlatform, configurable: true });
32
- });
33
-
34
- test("returns not found for unknown platform", () => {
35
- const originalPlatform = process.platform;
36
- Object.defineProperty(process, "platform", { value: "aix", configurable: true });
37
-
38
- const result = service.findSystemBrowser();
39
- expect(result.found).toBe(false);
40
- expect(result.browserName).toBe("none");
41
-
42
- Object.defineProperty(process, "platform", { value: originalPlatform, configurable: true });
43
- });
44
- });
45
-
46
- describe("install", () => {
47
- test("throws InstallBrowserError when install fails", async () => {
48
- const findSpy = spyOn(service, "findSystemBrowser").mockReturnValue({ found: false, browserName: "none" });
49
- const runInstallSpy = spyOn(service as any, "runInstall").mockImplementation(() => {
50
- throw new Error("spawn failed");
51
- });
52
-
53
- await expect(service.install()).rejects.toBeInstanceOf(InstallBrowserError);
54
- runInstallSpy.mockRestore();
55
- findSpy.mockRestore();
56
- });
57
-
58
- test("resolves successfully when install succeeds", async () => {
59
- const runInstallSpy = spyOn(service as any, "runInstall").mockResolvedValue("Chromium downloaded");
60
- const findSpy = spyOn(service, "findSystemBrowser").mockReturnValue({ found: false, browserName: "none" });
61
-
62
- await expect(service.install()).resolves.toBeUndefined();
63
- findSpy.mockRestore();
64
- runInstallSpy.mockRestore();
65
- });
66
- });
67
- });
68
-
69
- describe("InstallBrowserError", () => {
70
- test("has correct name and message", () => {
71
- const error = new InstallBrowserError("test error");
72
- expect(error.name).toBe("InstallBrowserError");
73
- expect(error.message).toBe("test error");
74
- expect(error.cause).toBeUndefined();
75
- });
76
-
77
- test("preserves cause", () => {
78
- const cause = new Error("original");
79
- const error = new InstallBrowserError("wrapper", cause);
80
- expect(error.cause).toBe(cause);
81
- expect(error.message).toBe("wrapper");
82
- });
83
- });
@@ -1,468 +0,0 @@
1
- import { describe, test, expect, beforeEach, mock } from "bun:test";
2
- import { writeFileSync } from "node:fs";
3
- import {
4
- PlaywrightCliDriver,
5
- PlaywrightCliError,
6
- type PlaywrightRunner,
7
- type PlaywrightRunnerResult,
8
- type PlaywrightStrategy,
9
- } from "../../src/services/playwright-cli-driver.ts";
10
-
11
- function createMockRunner(strategy: PlaywrightStrategy = "direct"): PlaywrightRunner & {
12
- _run: ReturnType<typeof mock>;
13
- _spawnDetached: ReturnType<typeof mock>;
14
- _results: PlaywrightRunnerResult[];
15
- } {
16
- const _run = mock(async (_args: string[]) => ({ exitCode: 0, stdout: "1.0.0", stderr: "" }));
17
- const _spawnDetached = mock((_args: string[]) => {});
18
- return {
19
- strategy,
20
- _run,
21
- _spawnDetached,
22
- _results: [],
23
- async run(args) {
24
- const result = await _run(args);
25
- return result;
26
- },
27
- spawnDetached(args) {
28
- _spawnDetached(args);
29
- },
30
- };
31
- }
32
-
33
- describe("PlaywrightCliDriver", () => {
34
- let driver: PlaywrightCliDriver;
35
-
36
- beforeEach(() => {
37
- driver = new PlaywrightCliDriver({ runner: createMockRunner() });
38
- });
39
-
40
- describe("withSession", () => {
41
- test("prepends -s flag to args", () => {
42
- const result = driver.withSession("my-session", ["eval", "() => 1"]);
43
- expect(result).toEqual(["-s=my-session", "eval", "() => 1"]);
44
- });
45
-
46
- test("works with empty args", () => {
47
- const result = driver.withSession("s1", []);
48
- expect(result).toEqual(["-s=s1"]);
49
- });
50
- });
51
-
52
- describe("runCli", () => {
53
- test("resolves with stdout on successful exit", async () => {
54
- const runner = createMockRunner();
55
- runner._run.mockResolvedValueOnce({ exitCode: 0, stdout: "v1.2.3", stderr: "" });
56
- const d = new PlaywrightCliDriver({ runner });
57
-
58
- const result = await d.runCli(["--version"]);
59
- expect(result).toBe("v1.2.3");
60
- expect(runner._run).toHaveBeenCalledWith(["--version"]);
61
- });
62
-
63
- test("rejects with PlaywrightCliError on non-zero exit", async () => {
64
- const runner = createMockRunner();
65
- runner._run.mockResolvedValueOnce({ exitCode: 1, stdout: "", stderr: "boom" });
66
- const d = new PlaywrightCliDriver({ runner });
67
-
68
- await expect(d.runCli(["nonexistent-command"])).rejects.toBeInstanceOf(
69
- PlaywrightCliError,
70
- );
71
- });
72
-
73
- test("PlaywrightCliError has correct properties", async () => {
74
- const runner = createMockRunner();
75
- runner._run.mockResolvedValueOnce({ exitCode: 2, stdout: "", stderr: "nope" });
76
- const d = new PlaywrightCliDriver({ runner });
77
-
78
- try {
79
- await d.runCli(["nonexistent-command"]);
80
- expect.unreachable("Should have thrown");
81
- } catch (err) {
82
- expect(err).toBeInstanceOf(PlaywrightCliError);
83
- const e = err as PlaywrightCliError;
84
- expect(e.name).toBe("PlaywrightCliError");
85
- expect(e.message).toContain("nonexistent-command");
86
- expect(e.message).toContain("nope");
87
- }
88
- });
89
- });
90
-
91
- describe("openHeaded", () => {
92
- test("constructs correct args without session", () => {
93
- const d = new PlaywrightCliDriver({
94
- runner: createMockRunner(),
95
- profileDirResolver: (name) => `/abs/path/to/${name}`,
96
- });
97
- const args = d.buildOpenHeadedArgs("https://gemini.google.com/app", "my-profile");
98
- expect(args).toContain("open");
99
- expect(args).toContain("https://gemini.google.com/app");
100
- expect(args).toContain("--browser=chromium");
101
- expect(args).toContain("--headed");
102
- expect(args).toContain("--persistent");
103
- expect(args).toContain("--profile=/abs/path/to/my-profile");
104
- expect(args).not.toContain(expect.stringContaining("-s="));
105
- });
106
-
107
- test("includes session flag when provided", () => {
108
- const args = driver.buildOpenHeadedArgs(
109
- "https://gemini.google.com/app",
110
- "my-profile",
111
- "my-session",
112
- );
113
- expect(args[0]).toBe("-s=my-session");
114
- });
115
-
116
- test("resolves profile to absolute path via injected resolver", () => {
117
- const resolver = mock((name: string) => `/custom/root/${name}`);
118
- const d = new PlaywrightCliDriver({ runner: createMockRunner(), profileDirResolver: resolver });
119
- const args = d.buildOpenHeadedArgs("https://gemini.google.com/app", "p1");
120
- expect(args).toContain("--profile=/custom/root/p1");
121
- expect(resolver).toHaveBeenCalledWith("p1");
122
- });
123
-
124
- test("openHeaded awaits runCli with URL as last arg", async () => {
125
- const runner = createMockRunner();
126
- const d = new PlaywrightCliDriver({ runner });
127
- await d.openHeaded("https://gemini.google.com/app", "p1", "s1");
128
- expect(runner._run).toHaveBeenCalledTimes(1);
129
- const args = runner._run.mock.calls[0]![0] as string[];
130
- expect(args[0]).toBe("-s=s1");
131
- expect(args).toContain("open");
132
- expect(args[args.length - 1]).toBe("https://gemini.google.com/app");
133
- });
134
-
135
- test("openHeaded throws PlaywrightCliError when open command fails", async () => {
136
- const runner = createMockRunner();
137
- runner._run.mockResolvedValueOnce({ exitCode: 1, stdout: "", stderr: "open failed" });
138
- const d = new PlaywrightCliDriver({ runner });
139
- await expect(d.openHeaded("https://gemini.google.com/app", "p1", "s1")).rejects.toBeInstanceOf(PlaywrightCliError);
140
- });
141
- });
142
-
143
- describe("evalJs", () => {
144
- test("passes expression with session and --raw flag", async () => {
145
- const runner = createMockRunner();
146
- runner._run.mockImplementationOnce(async (args) => {
147
- expect(args).toEqual(["-s=test-session", "eval", "() => document.title", "--raw"]);
148
- return { exitCode: 0, stdout: '"Gemini"', stderr: "" };
149
- });
150
- const d = new PlaywrightCliDriver({ runner });
151
-
152
- const result = await d.evalJs("test-session", "() => document.title");
153
- expect(result).toBe('"Gemini"');
154
- });
155
- });
156
-
157
- describe("cookieList", () => {
158
- test("parses valid JSON cookie output", async () => {
159
- const cookieData = JSON.stringify([
160
- {
161
- name: "__Secure-1PSID",
162
- value: "abc123",
163
- domain: ".google.com",
164
- path: "/",
165
- expires: 1893456000,
166
- httpOnly: true,
167
- secure: true,
168
- sameSite: "None",
169
- },
170
- {
171
- name: "__Secure-1PSIDTS",
172
- value: "xyz789",
173
- domain: ".google.com",
174
- path: "/",
175
- expires: 1893456000,
176
- httpOnly: true,
177
- secure: true,
178
- sameSite: "Lax",
179
- },
180
- ]);
181
-
182
- const runner = createMockRunner();
183
- runner._run.mockImplementationOnce(async (args) => {
184
- expect(args).toEqual(["-s=sess1", "cookie-list", "--json"]);
185
- return { exitCode: 0, stdout: cookieData, stderr: "" };
186
- });
187
- const d = new PlaywrightCliDriver({ runner });
188
-
189
- const cookies = await d.cookieList("sess1");
190
- expect(cookies).toHaveLength(2);
191
- expect(cookies[0].name).toBe("__Secure-1PSID");
192
- expect(cookies[0].value).toBe("abc123");
193
- expect(cookies[0].secure).toBe(true);
194
- expect(cookies[1].sameSite).toBe("Lax");
195
- });
196
-
197
- test("returns empty array for invalid JSON", async () => {
198
- const runner = createMockRunner();
199
- runner._run.mockResolvedValueOnce({ exitCode: 0, stdout: "not-json", stderr: "" });
200
- const d = new PlaywrightCliDriver({ runner });
201
-
202
- const cookies = await d.cookieList("sess1");
203
- expect(cookies).toEqual([]);
204
- });
205
-
206
- test("returns empty array for non-array JSON", async () => {
207
- const runner = createMockRunner();
208
- runner._run.mockResolvedValueOnce({ exitCode: 0, stdout: '{"error": "no cookies"}', stderr: "" });
209
- const d = new PlaywrightCliDriver({ runner });
210
-
211
- const cookies = await d.cookieList("sess1");
212
- expect(cookies).toEqual([]);
213
- });
214
-
215
- test("parses envelope { result: '<json-string>' } shape", async () => {
216
- const innerArray = [
217
- {
218
- name: "__Secure-1PSID",
219
- value: "abc123",
220
- domain: ".google.com",
221
- path: "/",
222
- expires: 1893456000,
223
- httpOnly: true,
224
- secure: true,
225
- sameSite: "None",
226
- },
227
- {
228
- name: "__Secure-1PSIDTS",
229
- value: "xyz789",
230
- domain: ".google.com",
231
- path: "/",
232
- expires: 1893456000,
233
- httpOnly: true,
234
- secure: true,
235
- sameSite: "Lax",
236
- },
237
- ];
238
- const envelope = JSON.stringify({ result: JSON.stringify(innerArray), raw: "{}" });
239
- const runner = createMockRunner();
240
- runner._run.mockResolvedValueOnce({ exitCode: 0, stdout: envelope, stderr: "" });
241
- const d = new PlaywrightCliDriver({ runner });
242
-
243
- const cookies = await d.cookieList("sess1");
244
- expect(cookies).toHaveLength(2);
245
- expect(cookies[0].name).toBe("__Secure-1PSID");
246
- expect(cookies[0].value).toBe("abc123");
247
- expect(cookies[0].secure).toBe(true);
248
- expect(cookies[1].sameSite).toBe("Lax");
249
- });
250
-
251
- test("returns empty array for envelope with 'No cookies found'", async () => {
252
- const envelope = JSON.stringify({ result: "No cookies found", raw: "No cookies found" });
253
- const runner = createMockRunner();
254
- runner._run.mockResolvedValueOnce({ exitCode: 0, stdout: envelope, stderr: "" });
255
- const d = new PlaywrightCliDriver({ runner });
256
-
257
- const cookies = await d.cookieList("sess1");
258
- expect(cookies).toEqual([]);
259
- });
260
-
261
- test("handles cookies missing fields with defaults", async () => {
262
- const runner = createMockRunner();
263
- runner._run.mockResolvedValueOnce({
264
- exitCode: 0,
265
- stdout: JSON.stringify([{ name: "test-cookie", value: "val" }]),
266
- stderr: "",
267
- });
268
- const d = new PlaywrightCliDriver({ runner });
269
-
270
- const cookies = await d.cookieList("sess1");
271
- expect(cookies).toHaveLength(1);
272
- expect(cookies[0].name).toBe("test-cookie");
273
- expect(cookies[0].domain).toBe("");
274
- expect(cookies[0].path).toBe("/");
275
- expect(cookies[0].expires).toBe(-1);
276
- expect(cookies[0].httpOnly).toBe(false);
277
- expect(cookies[0].secure).toBe(false);
278
- expect(cookies[0].sameSite).toBe("None");
279
- });
280
- });
281
-
282
- describe("stateSave", () => {
283
- test("passes correct args", async () => {
284
- const runner = createMockRunner();
285
- runner._run.mockImplementationOnce(async (args) => {
286
- expect(args).toEqual(["-s=sess1", "state-save", "/tmp/state.json"]);
287
- return { exitCode: 0, stdout: "", stderr: "" };
288
- });
289
- const d = new PlaywrightCliDriver({ runner });
290
-
291
- await d.stateSave("sess1", "/tmp/state.json");
292
- expect(runner._run).toHaveBeenCalledTimes(1);
293
- });
294
- });
295
-
296
- describe("stateLoad", () => {
297
- test("passes correct args", async () => {
298
- const runner = createMockRunner();
299
- runner._run.mockImplementationOnce(async (args) => {
300
- expect(args).toEqual(["-s=sess1", "state-load", "/tmp/state.json"]);
301
- return { exitCode: 0, stdout: "", stderr: "" };
302
- });
303
- const d = new PlaywrightCliDriver({ runner });
304
-
305
- await d.stateLoad("sess1", "/tmp/state.json");
306
- expect(runner._run).toHaveBeenCalledTimes(1);
307
- });
308
- });
309
-
310
- describe("cookieListFromState", () => {
311
- test("invokes state-save with session, parses JSON file, and returns cookies with expires", async () => {
312
- const storageState = {
313
- cookies: [
314
- {
315
- name: "__Secure-1PSID",
316
- value: "abc",
317
- domain: ".google.com",
318
- path: "/",
319
- expires: 1893456000,
320
- httpOnly: true,
321
- secure: true,
322
- sameSite: "None",
323
- },
324
- {
325
- name: "__Secure-1PSIDTS",
326
- value: "xyz",
327
- domain: ".google.com",
328
- path: "/",
329
- expires: 1893456000.5,
330
- httpOnly: true,
331
- secure: true,
332
- sameSite: "Lax",
333
- },
334
- ],
335
- origins: [],
336
- };
337
-
338
- let savedPath = "";
339
- const runner = createMockRunner();
340
- runner._run.mockImplementationOnce(async (args) => {
341
- const stateIdx = args.indexOf("state-save");
342
- savedPath = args[stateIdx + 1] ?? "";
343
- writeFileSync(savedPath, JSON.stringify(storageState), "utf-8");
344
- return { exitCode: 0, stdout: "", stderr: "" };
345
- });
346
- const d = new PlaywrightCliDriver({ runner });
347
-
348
- const cookies = await d.cookieListFromState("sess1");
349
-
350
- expect(runner._run).toHaveBeenCalledTimes(1);
351
- const calledArgs = runner._run.mock.calls[0]![0] as string[];
352
- expect(calledArgs[0]).toBe("-s=sess1");
353
- expect(calledArgs[1]).toBe("state-save");
354
- expect(typeof savedPath).toBe("string");
355
- expect(savedPath.length).toBeGreaterThan(0);
356
-
357
- expect(cookies).toHaveLength(2);
358
- expect(cookies[0]!.name).toBe("__Secure-1PSID");
359
- expect(cookies[0]!.expires).toBe(1893456000);
360
- expect(cookies[1]!.name).toBe("__Secure-1PSIDTS");
361
- expect(cookies[1]!.expires).toBe(1893456000.5);
362
- });
363
-
364
- test("returns empty array when storage state has no cookies", async () => {
365
- const runner = createMockRunner();
366
- runner._run.mockImplementationOnce(async (args) => {
367
- const stateIdx = args.indexOf("state-save");
368
- const savedPath = args[stateIdx + 1] ?? "";
369
- writeFileSync(savedPath, JSON.stringify({ cookies: [], origins: [] }), "utf-8");
370
- return { exitCode: 0, stdout: "", stderr: "" };
371
- });
372
- const d = new PlaywrightCliDriver({ runner });
373
-
374
- const cookies = await d.cookieListFromState("sess1");
375
- expect(cookies).toEqual([]);
376
- });
377
-
378
- test("cleans up the temp file even on read errors", async () => {
379
- let savedPath = "";
380
- const runner = createMockRunner();
381
- runner._run.mockImplementationOnce(async (args) => {
382
- savedPath = args[args.indexOf("state-save") + 1] ?? "";
383
- writeFileSync(savedPath, "{not valid json", "utf-8");
384
- return { exitCode: 0, stdout: "", stderr: "" };
385
- });
386
- const d = new PlaywrightCliDriver({ runner });
387
-
388
- await expect(d.cookieListFromState("sess1")).rejects.toThrow();
389
- let stillExists = true;
390
- try {
391
- const { existsSync } = await import("node:fs");
392
- stillExists = existsSync(savedPath);
393
- } catch {
394
- stillExists = false;
395
- }
396
- expect(stillExists).toBe(false);
397
- });
398
-
399
- test("propagates state-save failures", async () => {
400
- const runner = createMockRunner();
401
- runner._run.mockResolvedValueOnce({ exitCode: 1, stdout: "", stderr: "save failed" });
402
- const d = new PlaywrightCliDriver({ runner });
403
-
404
- await expect(d.cookieListFromState("sess1")).rejects.toBeInstanceOf(PlaywrightCliError);
405
- });
406
- });
407
-
408
- describe("closeSession", () => {
409
- test("passes correct args", async () => {
410
- const runner = createMockRunner();
411
- runner._run.mockImplementationOnce(async (args) => {
412
- expect(args).toEqual(["-s=sess1", "close"]);
413
- return { exitCode: 0, stdout: "", stderr: "" };
414
- });
415
- const d = new PlaywrightCliDriver({ runner });
416
-
417
- await d.closeSession("sess1");
418
- expect(runner._run).toHaveBeenCalledTimes(1);
419
- });
420
-
421
- test("swallows 'not found' errors (session already closed)", async () => {
422
- const runner = createMockRunner();
423
- runner._run.mockResolvedValueOnce({
424
- exitCode: 1,
425
- stdout: "",
426
- stderr: "session not found",
427
- });
428
- const d = new PlaywrightCliDriver({ runner });
429
-
430
- await expect(d.closeSession("sess1")).resolves.toBeUndefined();
431
- });
432
-
433
- test("propagates other PlaywrightCliError failures", async () => {
434
- const runner = createMockRunner();
435
- runner._run.mockResolvedValueOnce({
436
- exitCode: 1,
437
- stdout: "",
438
- stderr: "something else failed",
439
- });
440
- const d = new PlaywrightCliDriver({ runner });
441
-
442
- await expect(d.closeSession("sess1")).rejects.toBeInstanceOf(PlaywrightCliError);
443
- });
444
- });
445
-
446
- describe("closeAll", () => {
447
- test("passes correct args without session", async () => {
448
- const runner = createMockRunner();
449
- runner._run.mockImplementationOnce(async (args) => {
450
- expect(args).toEqual(["close-all"]);
451
- return { exitCode: 0, stdout: "", stderr: "" };
452
- });
453
- const d = new PlaywrightCliDriver({ runner });
454
-
455
- await d.closeAll();
456
- expect(runner._run).toHaveBeenCalledTimes(1);
457
- });
458
- });
459
-
460
- describe("strategy", () => {
461
- test("exposes the runner's strategy", () => {
462
- const d1 = new PlaywrightCliDriver({ runner: createMockRunner("direct") });
463
- expect(d1.strategy).toBe("direct");
464
- const d2 = new PlaywrightCliDriver({ runner: createMockRunner("bunx") });
465
- expect(d2.strategy).toBe("bunx");
466
- });
467
- });
468
- });