@knpkv/atlassian-common 1.5.0 → 1.7.0

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 (40) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +31 -0
  3. package/dist/cli-auth/AtlassianCliAuth.d.ts +110 -0
  4. package/dist/cli-auth/AtlassianCliAuth.d.ts.map +1 -0
  5. package/dist/cli-auth/AtlassianCliAuth.js +298 -0
  6. package/dist/cli-auth/AtlassianCliAuth.js.map +1 -0
  7. package/dist/cli-auth/authCommand.d.ts +34 -0
  8. package/dist/cli-auth/authCommand.d.ts.map +1 -0
  9. package/dist/cli-auth/authCommand.js +127 -0
  10. package/dist/cli-auth/authCommand.js.map +1 -0
  11. package/dist/cli-auth/index.d.ts +14 -0
  12. package/dist/cli-auth/index.d.ts.map +1 -0
  13. package/dist/cli-auth/index.js +14 -0
  14. package/dist/cli-auth/index.js.map +1 -0
  15. package/dist/cli-auth/internal/NodeLayers.d.ts +5 -0
  16. package/dist/cli-auth/internal/NodeLayers.d.ts.map +1 -0
  17. package/dist/cli-auth/internal/NodeLayers.js +17 -0
  18. package/dist/cli-auth/internal/NodeLayers.js.map +1 -0
  19. package/dist/cli-auth/internal/oauthServer.d.ts +54 -0
  20. package/dist/cli-auth/internal/oauthServer.d.ts.map +1 -0
  21. package/dist/cli-auth/internal/oauthServer.js +94 -0
  22. package/dist/cli-auth/internal/oauthServer.js.map +1 -0
  23. package/dist/cli-auth/openBrowser.d.ts +16 -0
  24. package/dist/cli-auth/openBrowser.d.ts.map +1 -0
  25. package/dist/cli-auth/openBrowser.js +30 -0
  26. package/dist/cli-auth/openBrowser.js.map +1 -0
  27. package/package.json +5 -1
  28. package/src/cli-auth/AtlassianCliAuth.ts +539 -0
  29. package/src/cli-auth/authCommand.ts +227 -0
  30. package/src/cli-auth/index.ts +20 -0
  31. package/src/cli-auth/internal/NodeLayers.ts +25 -0
  32. package/src/cli-auth/internal/oauthServer.ts +168 -0
  33. package/src/cli-auth/openBrowser.ts +47 -0
  34. package/test/ApiUpdateWorkflows.test.ts +78 -0
  35. package/test/cliAuth.authCommand.test.ts +153 -0
  36. package/test/cliAuth.guardrails.test.ts +76 -0
  37. package/test/cliAuth.login.test.ts +319 -0
  38. package/test/cliAuth.oauthServer.test.ts +276 -0
  39. package/test/cliAuth.openBrowser.test.ts +70 -0
  40. package/test/cliAuth.refresh.test.ts +304 -0
@@ -0,0 +1,153 @@
1
+ /** @effect-diagnostics strictEffectProvide:skip-file */
2
+ /**
3
+ * The shared `auth` command group: its setup text lists exactly the scopes the service logs in
4
+ * with, a browser that never opens fails the command after the URL is printed, and the profile
5
+ * commands read the same store for every product.
6
+ */
7
+ import { NodeServices } from "@effect/platform-node"
8
+ import { describe, expect, it } from "@effect/vitest"
9
+ import { Command } from "effect/cli"
10
+ import * as Console from "effect/Console"
11
+ import * as Context from "effect/Context"
12
+ import * as Effect from "effect/Effect"
13
+ import * as Layer from "effect/Layer"
14
+ import * as PlatformError from "effect/PlatformError"
15
+ import { ChildProcessSpawner } from "effect/process"
16
+ import * as Sink from "effect/Sink"
17
+ import * as Stream from "effect/Stream"
18
+ import { type AuthCommandService, makeAuthCommand, scopeInstructions } from "../src/cli-auth/index.js"
19
+ import type { AuthProfile } from "../src/config/index.js"
20
+
21
+ class TestAuth extends Context.Service<TestAuth, AuthCommandService>()("test/TestAuth") {}
22
+
23
+ const SCOPES = [
24
+ "read:jira-work",
25
+ "write:jira-work",
26
+ "manage:jira-project",
27
+ "read:jira-user",
28
+ "read:me",
29
+ "offline_access"
30
+ ]
31
+
32
+ const descriptor = { commandName: "jira", productName: "Jira", scopes: SCOPES }
33
+
34
+ const profile: AuthProfile = {
35
+ id: "cloud-1:account-1",
36
+ name: "User 1 @ site-1",
37
+ token: {
38
+ access_token: "access-1",
39
+ refresh_token: "refresh-1",
40
+ expires_at: 0,
41
+ scope: "read:me",
42
+ cloud_id: "cloud-1",
43
+ site_url: "https://site-1.atlassian.net",
44
+ user: { account_id: "account-1", name: "User 1", email: "user-1@example.com" }
45
+ },
46
+ created_at: "2026-10-05T00:00:00.000Z",
47
+ updated_at: "2026-10-05T00:00:00.000Z"
48
+ }
49
+
50
+ const fakeAuth = (active: AuthProfile | null): AuthCommandService => ({
51
+ configure: () => Effect.void,
52
+ login: () => Effect.void,
53
+ logout: () => Effect.void,
54
+ getActiveProfile: () => Effect.succeed(active),
55
+ listProfiles: () => Effect.succeed(active === null ? [] : [active]),
56
+ switchProfile: () => Effect.succeed(null),
57
+ removeProfile: () => Effect.succeed(null)
58
+ })
59
+
60
+ // `opens` decides whether `open` exits 0; every other launcher is missing.
61
+ const launchers = (opens: boolean) =>
62
+ Layer.succeed(
63
+ ChildProcessSpawner.ChildProcessSpawner,
64
+ ChildProcessSpawner.make((command) =>
65
+ command._tag === "StandardCommand" && command.command === "open"
66
+ ? Effect.succeed(ChildProcessSpawner.makeHandle({
67
+ all: Stream.empty,
68
+ exitCode: Effect.succeed(ChildProcessSpawner.ExitCode(opens ? 0 : 1)),
69
+ getInputFd: () => Sink.drain,
70
+ getOutputFd: () => Stream.empty,
71
+ isRunning: Effect.succeed(false),
72
+ kill: () => Effect.void,
73
+ pid: ChildProcessSpawner.ProcessId(1),
74
+ reref: Effect.void,
75
+ stderr: Stream.empty,
76
+ stdin: Sink.drain,
77
+ stdout: Stream.empty,
78
+ unref: Effect.succeed(Effect.void)
79
+ }))
80
+ : Effect.fail(PlatformError.systemError({ _tag: "NotFound", module: "ChildProcess", method: "spawn" }))
81
+ )
82
+ )
83
+
84
+ const run = (
85
+ args: ReadonlyArray<string>,
86
+ options: { readonly active?: AuthProfile | null; readonly opens?: boolean }
87
+ ) =>
88
+ Effect.gen(function*() {
89
+ const lines: Array<string> = []
90
+ const capture: Console.Console = Object.assign(Object.create(console), {
91
+ log: (...parts: ReadonlyArray<unknown>) => lines.push(parts.join(" "))
92
+ })
93
+ const cli = Command.runWith(
94
+ Command.make("jira").pipe(
95
+ Command.withSubcommands([makeAuthCommand(TestAuth, descriptor, { apiSection: "Jira API" })])
96
+ ),
97
+ { version: "0.0.0-test" }
98
+ )
99
+ const exit = yield* cli(["auth", ...args]).pipe(
100
+ Effect.provideService(Console.Console, capture),
101
+ Effect.provide(Layer.mergeAll(
102
+ NodeServices.layer,
103
+ launchers(options.opens ?? true),
104
+ Layer.succeed(TestAuth, fakeAuth(options.active ?? null))
105
+ )),
106
+ Effect.exit
107
+ )
108
+ return { exit, output: lines.join("\n") }
109
+ })
110
+
111
+ describe("makeAuthCommand", () => {
112
+ it("lists every login scope except offline_access, read:me under User Identity", () => {
113
+ const text = scopeInstructions(descriptor, "Jira API")
114
+ for (const scope of SCOPES.filter((scope) => scope !== "offline_access")) expect(text).toContain(scope)
115
+ expect(text).not.toContain("offline_access")
116
+ expect(text.indexOf("User Identity API")).toBeLessThan(text.indexOf("read:me"))
117
+ expect(text.indexOf("Jira API")).toBeLessThan(text.indexOf("read:jira-work"))
118
+ })
119
+
120
+ it.effect("create prints the service's scopes and its own command name, then opens the console", () =>
121
+ Effect.gen(function*() {
122
+ const { exit, output } = yield* run(["create"], {})
123
+ expect(exit._tag).toBe("Success")
124
+ for (const scope of ["write:jira-work", "manage:jira-project"]) expect(output).toContain(scope)
125
+ expect(output).toContain("jira auth configure --client-id")
126
+ expect(output).toContain("Opening https://developer.atlassian.com/console/myapps/create-3lo-app/")
127
+ }))
128
+
129
+ it.effect("create and manage fail when no browser opens, after printing the URL", () =>
130
+ Effect.gen(function*() {
131
+ for (const subcommand of ["create", "manage"]) {
132
+ const { exit, output } = yield* run([subcommand], { opens: false })
133
+ expect(exit._tag, subcommand).toBe("Failure")
134
+ expect(output, subcommand).toContain("Opening https://developer.atlassian.com/console/myapps/")
135
+ }
136
+ }))
137
+
138
+ it.effect("status prints the active profile, or how to log in", () =>
139
+ Effect.gen(function*() {
140
+ const active = yield* run(["status"], { active: profile })
141
+ expect(active.output).toContain("Active profile: User 1 @ site-1")
142
+ expect(active.output).toContain("Account: User 1 (user-1@example.com)")
143
+ expect(active.output).toContain("Site: https://site-1.atlassian.net")
144
+ expect((yield* run(["status"], {})).output).toContain("Not logged in. Use 'jira auth login' to authenticate.")
145
+ }))
146
+
147
+ it.effect("profiles marks the active one; use and remove report an unknown selector", () =>
148
+ Effect.gen(function*() {
149
+ expect((yield* run(["profiles"], { active: profile })).output).toContain("* cloud-1:account-1")
150
+ expect((yield* run(["use", "nope"], {})).output).toContain("Profile not found: nope")
151
+ expect((yield* run(["remove", "nope"], {})).output).toContain("Profile not found: nope")
152
+ }))
153
+ })
@@ -0,0 +1,76 @@
1
+ /** @effect-diagnostics strictEffectProvide:skip-file */
2
+ import { NodeServices } from "@effect/platform-node"
3
+ import { describe, expect, it } from "@effect/vitest"
4
+ import * as Effect from "effect/Effect"
5
+ import * as FileSystem from "effect/FileSystem"
6
+ import * as Path from "effect/Path"
7
+ import { ChildProcess, ChildProcessSpawner } from "effect/process"
8
+ import * as Schema from "effect/Schema"
9
+ import * as Stream from "effect/Stream"
10
+ import confluenceIntegration from "../../confluence-to-markdown/vitest.config.integration.js"
11
+ import confluence from "../../confluence-to-markdown/vitest.config.js"
12
+ import jiraIntegration from "../../jira-cli/vitest.config.integration.js"
13
+ import jira from "../../jira-cli/vitest.config.js"
14
+ import clockify from "../../jira-clockify/vitest.config.js"
15
+
16
+ const configs = { jira, jiraIntegration, confluence, confluenceIntegration, clockify }
17
+ const Findings = Schema.fromJsonString(Schema.Array(Schema.Struct({ file: Schema.String })))
18
+
19
+ describe("CLI auth guardrails", () => {
20
+ for (const [name, config] of Object.entries(configs)) {
21
+ it(`${name} resolves CLI auth from source rather than stale build output`, () => {
22
+ expect(config.resolve?.alias).toHaveProperty(
23
+ "@knpkv/atlassian-common/cli-auth",
24
+ new URL("../src/cli-auth/index.ts", import.meta.url).pathname
25
+ )
26
+ })
27
+ }
28
+
29
+ it.effect("limits the reimplementation guard to the Jira and Confluence CLIs", () =>
30
+ Effect.gen(function*() {
31
+ const fs = yield* FileSystem.FileSystem
32
+ const path = yield* Path.Path
33
+ const spawner = yield* ChildProcessSpawner.ChildProcessSpawner
34
+ const root = yield* path.fromFileUrl(new URL("../../../", import.meta.url))
35
+ const fixture = yield* fs.makeTempDirectoryScoped({ prefix: "cli-auth-guard-" })
36
+ yield* fs.writeFileString(
37
+ path.join(fixture, "sgconfig.yml"),
38
+ "ruleDirs: []\nlanguageGlobs:\n tsx:\n - \"**/*.ts\"\n"
39
+ )
40
+ // The same callback-server name and endpoint namespace are legitimate in
41
+ // another integration. Only the two delegated CLI implementations are banned.
42
+ const source = [
43
+ "import * as Auth from \"@knpkv/atlassian-common/auth\"",
44
+ "import { refreshToken } from \"@knpkv/atlassian-common/auth\"",
45
+ "const authUrl = Auth.buildAuthUrl({ clientId: \"client\" })",
46
+ "function startCallbackServer(state: string) { return state }"
47
+ ].join("\n")
48
+ for (const name of ["jira-cli", "confluence-to-markdown", "other-oauth"]) {
49
+ const directory = path.join(fixture, "packages", name, "src")
50
+ yield* fs.makeDirectory(directory, { recursive: true })
51
+ yield* fs.writeFileString(path.join(directory, "auth.ts"), source)
52
+ }
53
+ const handle = yield* spawner.spawn(ChildProcess.make(
54
+ path.join(root, "node_modules", ".bin", "ast-grep"),
55
+ [
56
+ "scan",
57
+ "--rule",
58
+ path.join(root, "ast-grep", "rules", "packaging", "no-atlassian-cli-auth-reimplementation.yml"),
59
+ "--json=compact",
60
+ "packages"
61
+ ],
62
+ { cwd: fixture }
63
+ ))
64
+ const { exitCode, stderr, stdout } = yield* Effect.all({
65
+ exitCode: handle.exitCode,
66
+ stdout: Stream.decodeText(handle.stdout).pipe(Stream.mkString),
67
+ stderr: Stream.decodeText(handle.stderr).pipe(Stream.mkString)
68
+ }, { concurrency: "unbounded" })
69
+ expect(exitCode, `${fixture}: ${stdout} ${stderr}`).toBe(1)
70
+ const findings = yield* Schema.decodeUnknownEffect(Findings)(stdout)
71
+ expect(findings.map(({ file }) => file).sort()).toEqual([
72
+ ...Array<string>(3).fill("packages/confluence-to-markdown/src/auth.ts"),
73
+ ...Array<string>(3).fill("packages/jira-cli/src/auth.ts")
74
+ ])
75
+ }).pipe(Effect.scoped, Effect.provide(NodeServices.layer)))
76
+ })
@@ -0,0 +1,319 @@
1
+ /** @effect-diagnostics strictEffectProvide:skip-file */
2
+ /**
3
+ * Browser login through the shared Atlassian CLI auth.
4
+ *
5
+ * The login prints the authorization URL before it tries to open a browser, so
6
+ * a browser that will not open must not end the login: the user can still visit
7
+ * the URL. A callback server that cannot bind, on the other hand, must end it
8
+ * before any URL is advertised, and the server must stop whenever the login's
9
+ * scope closes.
10
+ */
11
+ import { NodeFileSystem, NodePath, NodeServices } from "@effect/platform-node"
12
+ import * as NodeHttpClient from "@effect/platform-node/NodeHttpClient"
13
+ import * as NodeHttpServer from "@effect/platform-node/NodeHttpServer"
14
+ import { describe, expect, it } from "@effect/vitest"
15
+ import { ConfigProvider } from "effect"
16
+ import * as Console from "effect/Console"
17
+ import * as Data from "effect/Data"
18
+ import * as Deferred from "effect/Deferred"
19
+ import * as Effect from "effect/Effect"
20
+ import * as Fiber from "effect/Fiber"
21
+ import * as FileSystem from "effect/FileSystem"
22
+ import { HttpClient, HttpClientRequest, HttpClientResponse, HttpServer, HttpServerError } from "effect/http"
23
+ import * as Layer from "effect/Layer"
24
+ import { ChildProcessSpawner } from "effect/process"
25
+ import * as Ref from "effect/Ref"
26
+ import type * as Schema from "effect/Schema"
27
+ import * as Sink from "effect/Sink"
28
+ import * as Stream from "effect/Stream"
29
+ import { TestClock } from "effect/testing"
30
+ import { createServer } from "node:http"
31
+ import { makeAtlassianCliAuth, makeHttpServerFactory } from "../src/cli-auth/index.js"
32
+ import { loadActiveProfileToken } from "../src/config/AuthProfiles.js"
33
+ import { HomeDirectoryLive } from "../src/config/ConfigPaths.js"
34
+ import { saveOAuthConfig } from "../src/config/TokenStorage.js"
35
+
36
+ const TOOL = "test-cli"
37
+
38
+ class TestAuthMissing extends Data.TaggedError("TestAuthMissing") {}
39
+
40
+ const authOptions = {
41
+ toolName: TOOL,
42
+ commandName: "test",
43
+ productName: "Test",
44
+ scopes: ["read:me", "offline_access"],
45
+ authMissing: () => new TestAuthMissing()
46
+ }
47
+
48
+ const storage = Layer.mergeAll(NodeFileSystem.layer, NodePath.layer, HomeDirectoryLive)
49
+
50
+ const withHome = <A, E, R>(effect: Effect.Effect<A, E, R>) =>
51
+ Effect.gen(function*() {
52
+ const fs = yield* FileSystem.FileSystem
53
+ const home = yield* fs.makeTempDirectoryScoped({ prefix: "atlassian-cli-login-" })
54
+ return yield* effect.pipe(
55
+ Effect.provide(ConfigProvider.layer(ConfigProvider.fromEnv({ env: { HOME: home } })))
56
+ )
57
+ }).pipe(Effect.scoped, Effect.provide(NodeFileSystem.layer))
58
+
59
+ const seedConfig = saveOAuthConfig(TOOL, { clientId: "client-1", clientSecret: "secret-1" }).pipe(
60
+ Effect.provide(storage)
61
+ )
62
+
63
+ const json = (request: HttpClientRequest.HttpClientRequest, body: Schema.Json) =>
64
+ HttpClientResponse.fromWeb(
65
+ request,
66
+ new Response(JSON.stringify(body), { status: 200, headers: { "content-type": "application/json" } })
67
+ )
68
+
69
+ // Atlassian's side of a successful login: token exchange, one site, the user.
70
+ interface FakeSite {
71
+ readonly id: string
72
+ readonly name: string
73
+ readonly url: string
74
+ }
75
+
76
+ const firstSite: FakeSite = { id: "cloud-1", name: "Site", url: "https://site.atlassian.net" }
77
+ const secondSite: FakeSite = { id: "cloud-2", name: "Other", url: "https://other.atlassian.net" }
78
+
79
+ const atlassianClientWith = (sites: ReadonlyArray<FakeSite>) =>
80
+ Layer.succeed(
81
+ HttpClient.HttpClient,
82
+ HttpClient.make((request) => {
83
+ if (request.url.endsWith("/oauth/token")) {
84
+ return Effect.succeed(json(request, {
85
+ access_token: "access-1",
86
+ refresh_token: "refresh-1",
87
+ expires_in: 3600,
88
+ scope: "read:me offline_access",
89
+ token_type: "Bearer"
90
+ }))
91
+ }
92
+ if (request.url.endsWith("/accessible-resources")) {
93
+ return Effect.succeed(json(request, sites.map((site) => ({ ...site, scopes: [] }))))
94
+ }
95
+ return Effect.succeed(json(request, { account_id: "acc-1", name: "Ada", email: "ada@example.com" }))
96
+ })
97
+ )
98
+
99
+ const atlassianClient = atlassianClientWith([firstSite])
100
+
101
+ // Every launcher runs and reports failure — merged after NodeServices so it
102
+ // replaces the real spawner rather than being replaced by it, the way `xdg-open` does on a host
103
+ // with no browser. The first launch hands its URL to the test.
104
+ const failingLaunchers = (launched: Deferred.Deferred<string>, attempts: Ref.Ref<ReadonlyArray<string>>) =>
105
+ Layer.succeed(
106
+ ChildProcessSpawner.ChildProcessSpawner,
107
+ ChildProcessSpawner.make((command) =>
108
+ Effect.gen(function*() {
109
+ if (command._tag === "StandardCommand") {
110
+ yield* Ref.update(attempts, (all) => [...all, command.command])
111
+ yield* Deferred.succeed(launched, command.args[command.args.length - 1] ?? "")
112
+ }
113
+ return ChildProcessSpawner.makeHandle({
114
+ all: Stream.empty,
115
+ exitCode: Effect.succeed(ChildProcessSpawner.ExitCode(1)),
116
+ getInputFd: () => Sink.drain,
117
+ getOutputFd: () => Stream.empty,
118
+ isRunning: Effect.succeed(false),
119
+ kill: () => Effect.void,
120
+ pid: ChildProcessSpawner.ProcessId(1),
121
+ reref: Effect.void,
122
+ stderr: Stream.empty,
123
+ stdin: Sink.drain,
124
+ stdout: Stream.empty,
125
+ unref: Effect.succeed(Effect.void)
126
+ })
127
+ })
128
+ )
129
+ )
130
+
131
+ // An ephemeral real server whose shutdown the test can observe.
132
+ const observedServerFactory = (stopped: Ref.Ref<boolean>) =>
133
+ makeHttpServerFactory(() =>
134
+ Layer.merge(
135
+ NodeHttpServer.layerServer(createServer, { port: 0 }),
136
+ Layer.effectDiscard(Effect.addFinalizer(() => Ref.set(stopped, true)))
137
+ )
138
+ )
139
+
140
+ const captureConsole = (lines: Array<string>): Console.Console =>
141
+ Object.assign(Object.create(console), {
142
+ log: (...args: ReadonlyArray<unknown>) => lines.push(args.join(" ")),
143
+ error: (...args: ReadonlyArray<unknown>) => lines.push(`stderr: ${args.join(" ")}`)
144
+ })
145
+
146
+ const deliverCallback = (authUrl: string) =>
147
+ Effect.gen(function*() {
148
+ const url = new URL(authUrl)
149
+ const redirect = url.searchParams.get("redirect_uri") ?? ""
150
+ const state = url.searchParams.get("state") ?? ""
151
+ const port = new URL(redirect).port
152
+ const client = yield* HttpClient.HttpClient
153
+ yield* client.execute(
154
+ HttpClientRequest.get(`http://127.0.0.1:${port}/callback`).pipe(
155
+ HttpClientRequest.setUrlParam("code", "code-1"),
156
+ HttpClientRequest.setUrlParam("state", state)
157
+ )
158
+ )
159
+ }).pipe(Effect.provide(NodeHttpClient.layerUndici))
160
+
161
+ describe("Atlassian CLI login", () => {
162
+ it.live("keeps waiting for the callback when no browser launcher succeeds", () =>
163
+ withHome(Effect.gen(function*() {
164
+ yield* seedConfig
165
+ const launched = yield* Deferred.make<string>()
166
+ const attempts = yield* Ref.make<ReadonlyArray<string>>([])
167
+ const lines: Array<string> = []
168
+ const stopped = yield* Ref.make(false)
169
+
170
+ const login = yield* makeAtlassianCliAuth(authOptions).pipe(
171
+ Effect.flatMap((auth) => auth.login()),
172
+ Effect.provide(Layer.mergeAll(
173
+ NodeServices.layer,
174
+ HomeDirectoryLive,
175
+ atlassianClient,
176
+ failingLaunchers(launched, attempts),
177
+ observedServerFactory(stopped)
178
+ )),
179
+ Effect.provideService(Console.Console, captureConsole(lines)),
180
+ Effect.forkChild({ startImmediately: true })
181
+ )
182
+
183
+ const authUrl = yield* Deferred.await(launched)
184
+ yield* deliverCallback(authUrl)
185
+ const result = yield* Fiber.join(login)
186
+
187
+ expect(result).toBeUndefined()
188
+ expect(yield* Ref.get(attempts)).toEqual(["open", "xdg-open", "rundll32.exe"])
189
+ const printed = lines
190
+ expect(printed.some((line) => line.includes(`visit: ${authUrl}`))).toBe(true)
191
+ expect(printed).toContain("stderr: Could not open a browser (rundll32.exe exited 1); visit the URL above.")
192
+ expect(printed).toContain("Logged in as Ada (ada@example.com)")
193
+ expect(yield* Ref.get(stopped)).toBe(true)
194
+ const stored = yield* loadActiveProfileToken(TOOL).pipe(Effect.provide(storage))
195
+ expect(stored?.cloud_id).toBe("cloud-1")
196
+ })))
197
+
198
+ it.effect("fails before advertising a URL when the callback server cannot bind", () =>
199
+ withHome(Effect.gen(function*() {
200
+ yield* seedConfig
201
+ const launched = yield* Deferred.make<string>()
202
+ const attempts = yield* Ref.make<ReadonlyArray<string>>([])
203
+ const lines: Array<string> = []
204
+ const refused = makeHttpServerFactory(() =>
205
+ Layer.effect(
206
+ HttpServer.HttpServer,
207
+ Effect.fail(new HttpServerError.ServeError({ cause: { code: "EACCES" } }))
208
+ )
209
+ )
210
+
211
+ const error = yield* makeAtlassianCliAuth(authOptions).pipe(
212
+ Effect.flatMap((auth) => auth.login()),
213
+ Effect.provide(
214
+ Layer.mergeAll(
215
+ NodeServices.layer,
216
+ HomeDirectoryLive,
217
+ atlassianClient,
218
+ failingLaunchers(launched, attempts),
219
+ refused
220
+ )
221
+ ),
222
+ Effect.provideService(Console.Console, captureConsole(lines)),
223
+ Effect.flip
224
+ )
225
+
226
+ expect(error._tag).toBe("OAuthError")
227
+ expect(yield* Ref.get(attempts)).toEqual([])
228
+ expect(lines).toEqual([])
229
+ })))
230
+
231
+ it.effect("stops the callback server when authorization times out", () =>
232
+ withHome(Effect.gen(function*() {
233
+ yield* seedConfig
234
+ const launched = yield* Deferred.make<string>()
235
+ const attempts = yield* Ref.make<ReadonlyArray<string>>([])
236
+ const lines: Array<string> = []
237
+ const stopped = yield* Ref.make(false)
238
+
239
+ const login = yield* makeAtlassianCliAuth(authOptions).pipe(
240
+ Effect.flatMap((auth) => auth.login()),
241
+ Effect.provide(Layer.mergeAll(
242
+ NodeServices.layer,
243
+ HomeDirectoryLive,
244
+ atlassianClient,
245
+ failingLaunchers(launched, attempts),
246
+ observedServerFactory(stopped)
247
+ )),
248
+ Effect.provideService(Console.Console, captureConsole(lines)),
249
+ Effect.flip,
250
+ Effect.forkChild({ startImmediately: true })
251
+ )
252
+
253
+ yield* Deferred.await(launched)
254
+ // The deadline is registered just after the launch; step the clock past it
255
+ // in increments so it fires wherever in that window it was set.
256
+ for (let minute = 0; minute < 10; minute++) {
257
+ yield* TestClock.adjust("1 minute")
258
+ yield* Effect.yieldNow
259
+ }
260
+ const error = yield* Fiber.join(login)
261
+
262
+ expect(error._tag).toBe("OAuthError")
263
+ expect(String(error.cause)).toBe("Authorization timed out")
264
+ expect(yield* Ref.get(stopped)).toBe(true)
265
+ })))
266
+ // With several sites, the login either lists them for the user to pick from
267
+ // or uses the one named by --site; an unknown --site fails and lists them.
268
+ const loginWithSites = (siteUrl: string | undefined) =>
269
+ Effect.gen(function*() {
270
+ yield* seedConfig
271
+ const launched = yield* Deferred.make<string>()
272
+ const attempts = yield* Ref.make<ReadonlyArray<string>>([])
273
+ const stopped = yield* Ref.make(false)
274
+ const lines: Array<string> = []
275
+ const login = yield* makeAtlassianCliAuth(authOptions).pipe(
276
+ Effect.flatMap((auth) => auth.login(siteUrl === undefined ? undefined : { siteUrl })),
277
+ Effect.provide(Layer.mergeAll(
278
+ NodeServices.layer,
279
+ HomeDirectoryLive,
280
+ atlassianClientWith([firstSite, secondSite]),
281
+ failingLaunchers(launched, attempts),
282
+ observedServerFactory(stopped)
283
+ )),
284
+ Effect.provideService(Console.Console, captureConsole(lines)),
285
+ Effect.result,
286
+ Effect.forkChild({ startImmediately: true })
287
+ )
288
+ yield* deliverCallback(yield* Deferred.await(launched))
289
+ const result = yield* Fiber.join(login)
290
+ const stored = yield* loadActiveProfileToken(TOOL).pipe(Effect.provide(storage))
291
+ return { result, stored }
292
+ })
293
+
294
+ it.live("lists the sites when several are available and none was chosen", () =>
295
+ withHome(Effect.gen(function*() {
296
+ const { result, stored } = yield* loginWithSites(undefined)
297
+ expect(result).toMatchObject({
298
+ success: [
299
+ { id: "cloud-1", name: "Site", url: "https://site.atlassian.net" },
300
+ { id: "cloud-2", name: "Other", url: "https://other.atlassian.net" }
301
+ ]
302
+ })
303
+ expect(stored).toBeNull()
304
+ })))
305
+
306
+ it.live("logs into the site chosen with --site", () =>
307
+ withHome(Effect.gen(function*() {
308
+ const { stored } = yield* loginWithSites("https://other.atlassian.net")
309
+ expect(stored?.cloud_id).toBe("cloud-2")
310
+ })))
311
+
312
+ it.live("fails and lists the sites when --site names none of them", () =>
313
+ withHome(Effect.gen(function*() {
314
+ const { result, stored } = yield* loginWithSites("https://missing.atlassian.net")
315
+ expect(result).toMatchObject({ failure: { _tag: "OAuthError", step: "authorize" } })
316
+ expect(String(result._tag === "Failure" ? result.failure.cause : "")).toContain("https://other.atlassian.net")
317
+ expect(stored).toBeNull()
318
+ })))
319
+ })