@atelier201/cli 0.0.0-stage → 0.4.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 (89) hide show
  1. package/AGENTS.md +378 -0
  2. package/README.md +145 -2
  3. package/dist/api-types.generated.js +8 -0
  4. package/dist/api-types.generated.js.map +1 -0
  5. package/dist/commands/api.js +111 -0
  6. package/dist/commands/api.js.map +1 -0
  7. package/dist/commands/auth.js +284 -0
  8. package/dist/commands/auth.js.map +1 -0
  9. package/dist/commands/builds.js +169 -0
  10. package/dist/commands/builds.js.map +1 -0
  11. package/dist/commands/changesets.js +91 -0
  12. package/dist/commands/changesets.js.map +1 -0
  13. package/dist/commands/common.js +89 -0
  14. package/dist/commands/common.js.map +1 -0
  15. package/dist/commands/completion.js +120 -0
  16. package/dist/commands/completion.js.map +1 -0
  17. package/dist/commands/content.js +281 -0
  18. package/dist/commands/content.js.map +1 -0
  19. package/dist/commands/doctor.js +141 -0
  20. package/dist/commands/doctor.js.map +1 -0
  21. package/dist/commands/domains.js +109 -0
  22. package/dist/commands/domains.js.map +1 -0
  23. package/dist/commands/feedback.js +39 -0
  24. package/dist/commands/feedback.js.map +1 -0
  25. package/dist/commands/files.js +286 -0
  26. package/dist/commands/files.js.map +1 -0
  27. package/dist/commands/help-json.js +127 -0
  28. package/dist/commands/help-json.js.map +1 -0
  29. package/dist/commands/history.js +83 -0
  30. package/dist/commands/history.js.map +1 -0
  31. package/dist/commands/mcp.js +129 -0
  32. package/dist/commands/mcp.js.map +1 -0
  33. package/dist/commands/media.js +273 -0
  34. package/dist/commands/media.js.map +1 -0
  35. package/dist/commands/pages.js +33 -0
  36. package/dist/commands/pages.js.map +1 -0
  37. package/dist/commands/previews.js +73 -0
  38. package/dist/commands/previews.js.map +1 -0
  39. package/dist/commands/publish.js +228 -0
  40. package/dist/commands/publish.js.map +1 -0
  41. package/dist/commands/read.js +85 -0
  42. package/dist/commands/read.js.map +1 -0
  43. package/dist/commands/site-guest.js +159 -0
  44. package/dist/commands/site-guest.js.map +1 -0
  45. package/dist/commands/site.js +204 -0
  46. package/dist/commands/site.js.map +1 -0
  47. package/dist/commands/sites.js +168 -0
  48. package/dist/commands/sites.js.map +1 -0
  49. package/dist/commands/skills.js +45 -0
  50. package/dist/commands/skills.js.map +1 -0
  51. package/dist/commands/workspace.js +89 -0
  52. package/dist/commands/workspace.js.map +1 -0
  53. package/dist/credentials.js +151 -0
  54. package/dist/credentials.js.map +1 -0
  55. package/dist/errors.js +166 -0
  56. package/dist/errors.js.map +1 -0
  57. package/dist/exit-codes.js +83 -0
  58. package/dist/exit-codes.js.map +1 -0
  59. package/dist/http.js +275 -0
  60. package/dist/http.js.map +1 -0
  61. package/dist/index.js +184 -0
  62. package/dist/index.js.map +1 -0
  63. package/dist/keychain.js +185 -0
  64. package/dist/keychain.js.map +1 -0
  65. package/dist/oauth/browser.js +33 -0
  66. package/dist/oauth/browser.js.map +1 -0
  67. package/dist/oauth/pkce.js +118 -0
  68. package/dist/oauth/pkce.js.map +1 -0
  69. package/dist/oauth/server.js +276 -0
  70. package/dist/oauth/server.js.map +1 -0
  71. package/dist/output.js +161 -0
  72. package/dist/output.js.map +1 -0
  73. package/dist/project.js +178 -0
  74. package/dist/project.js.map +1 -0
  75. package/dist/refresh-lock.js +84 -0
  76. package/dist/refresh-lock.js.map +1 -0
  77. package/dist/run.js +197 -0
  78. package/dist/run.js.map +1 -0
  79. package/dist/session.js +147 -0
  80. package/dist/session.js.map +1 -0
  81. package/dist/site-link.js +145 -0
  82. package/dist/site-link.js.map +1 -0
  83. package/dist/site-sync.js +191 -0
  84. package/dist/site-sync.js.map +1 -0
  85. package/dist/tar.js +228 -0
  86. package/dist/tar.js.map +1 -0
  87. package/dist/version.js +34 -0
  88. package/dist/version.js.map +1 -0
  89. package/package.json +47 -3
@@ -0,0 +1,89 @@
1
+ /**
2
+ * `atelier201 workspace …`: a terminal on a site, in the cloud.
3
+ *
4
+ * `run` sends one shell command to a working copy of the draft in the site's
5
+ * own container (offline, as an unprivileged user): rg, grep, sed -i, node.
6
+ * A build of the project is refused: `commit` saves the change as ONE history
7
+ * entry through the same checks as every change and starts the real build.
8
+ * An agent with its own machine can also work on local files and push them with
9
+ * `atelier201 files commit`; this is for the ones that cannot, and for trying a
10
+ * build in seconds without one.
11
+ */
12
+ import { run, unwrap } from "../run.js";
13
+ import { addSite, shortRevision, siteOf, sitePath, wholeNumber } from "./common.js";
14
+ export function registerWorkspace(program) {
15
+ const workspace = program
16
+ .command("workspace")
17
+ .description("A shell on a working copy of a site's draft, in its own container: run commands, see the diff, commit. Costs no credits");
18
+ addSite(workspace
19
+ .command("run <command...>")
20
+ .description("Run a bash command in the project's root (quote it: atelier201 workspace run 'rg -n hero src'). No network; files it changes stay uncommitted until 'workspace commit'. At a terminal the output is printed as is; piped, you get JSON with exit_code and uncommitted")
21
+ .option("--timeout <seconds>", "Stop the command after this many seconds (1-300, default 60)")).action(async (words, options, command) => {
22
+ await run(command, async (session) => {
23
+ const { siteId } = siteOf(options);
24
+ const response = await session.client.request("POST", sitePath(siteId, "/workspace:run"), {
25
+ body: {
26
+ command: words.join(" "),
27
+ ...(options.timeout === undefined ? {} : { timeout_ms: wholeNumber(options.timeout, "--timeout", 1, 300) * 1000 }),
28
+ },
29
+ });
30
+ const result = unwrap(response.body);
31
+ if (session.printer.resolution.mode !== "table") {
32
+ session.printer.data(result);
33
+ return;
34
+ }
35
+ if (result.note)
36
+ session.printer.note(result.note);
37
+ process.stdout.write(result.output.endsWith("\n") || !result.output ? result.output : `${result.output}\n`);
38
+ if (result.timed_out)
39
+ session.printer.note("The command was stopped at its timeout.");
40
+ if (result.exit_code !== 0)
41
+ session.printer.note(`exit ${result.exit_code}`);
42
+ if (result.uncommitted.length)
43
+ session.printer.note(`${result.uncommitted.length} uncommitted change(s): 'atelier201 workspace diff' to see them, 'atelier201 workspace commit "<summary>"' to save them.`);
44
+ });
45
+ });
46
+ addSite(workspace.command("diff").description("The workspace's uncommitted changes, with their diff. Costs no credits; changes nothing")).action(async (options, command) => {
47
+ await run(command, async (session) => {
48
+ const { siteId } = siteOf(options);
49
+ const response = await session.client.request("GET", sitePath(siteId, "/workspace"));
50
+ const result = unwrap(response.body);
51
+ if (session.printer.resolution.mode !== "table") {
52
+ session.printer.data(result);
53
+ return;
54
+ }
55
+ if (result.note)
56
+ session.printer.note(result.note);
57
+ process.stdout.write(result.files.length ? result.diff : "Nothing uncommitted.\n");
58
+ });
59
+ });
60
+ addSite(workspace
61
+ .command("commit <summary>")
62
+ .description("Save every uncommitted change of the workspace as ONE history entry, through the commit guard (no secrets, no .env, no server code). Costs no credits; visitors see nothing until you publish")).action(async (summary, options, command) => {
63
+ await run(command, async (session) => {
64
+ const { siteId } = siteOf(options);
65
+ const response = await session.client.request("POST", sitePath(siteId, "/workspace:commit"), { body: { summary } });
66
+ const result = unwrap(response.body);
67
+ session.printer.data(result, {
68
+ rows: result.changes,
69
+ fields: [
70
+ { label: "Revision", value: shortRevision(result.revision) },
71
+ { label: "Changed", value: result.changed ? "yes" : "nothing to commit" },
72
+ ],
73
+ columns: [
74
+ { header: "ACTION", value: (row) => row.action },
75
+ { header: "PATH", value: (row) => row.path },
76
+ ],
77
+ summary: result.changed ? "Next: 'atelier201 builds start' to see it in the preview." : undefined,
78
+ });
79
+ });
80
+ });
81
+ addSite(workspace.command("discard").description("Throw away the workspace's uncommitted changes. Costs no credits")).action(async (options, command) => {
82
+ await run(command, async (session) => {
83
+ const { siteId } = siteOf(options);
84
+ const response = await session.client.request("POST", sitePath(siteId, "/workspace:discard"));
85
+ session.printer.data(unwrap(response.body), { fields: [{ label: "Discarded", value: "yes" }] });
86
+ });
87
+ });
88
+ }
89
+ //# sourceMappingURL=workspace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/commands/workspace.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,151 @@
1
+ /**
2
+ * Credential storage and resolution.
3
+ *
4
+ * Precedence, and the reason for it:
5
+ *
6
+ * 1. `ATELIER201_API_KEY` — always wins, because CI must be able to override a
7
+ * stale login without touching the machine's state.
8
+ * 2. OS keychain — the default store for an interactive login.
9
+ * 3. `~/.config/atelier201/config.json` (mode 0600) — the fallback when there is
10
+ * no keychain (headless Linux, containers).
11
+ *
12
+ * Only one record is stored per profile. It is either an API key or an OAuth
13
+ * grant; the CLI never juggles both for one profile, because "which one am I
14
+ * actually using" is exactly the question a credential store should not raise.
15
+ */
16
+ import { promises as fs } from "node:fs";
17
+ import os from "node:os";
18
+ import path from "node:path";
19
+ import { detectKeychain } from "./keychain.js";
20
+ export const DEFAULT_PROFILE = "default";
21
+ // ── Paths ─────────────────────────────────────────────────────────────────────
22
+ export function configDir(env = process.env) {
23
+ const xdg = env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
24
+ return path.join(xdg, "atelier201");
25
+ }
26
+ export function configPath(env = process.env) {
27
+ return path.join(configDir(env), "config.json");
28
+ }
29
+ export function resolveProfile(explicit, env = process.env) {
30
+ return explicit || env.ATELIER201_PROFILE || DEFAULT_PROFILE;
31
+ }
32
+ export function createFileStore(env = process.env) {
33
+ const file = configPath(env);
34
+ return {
35
+ async read() {
36
+ try {
37
+ const raw = await fs.readFile(file, "utf8");
38
+ const parsed = JSON.parse(raw);
39
+ return parsed && typeof parsed === "object" ? parsed : {};
40
+ }
41
+ catch {
42
+ return {};
43
+ }
44
+ },
45
+ async write(config) {
46
+ await fs.mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
47
+ await fs.writeFile(file, `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
48
+ // `writeFile` honours the mode only when creating the file, so an existing
49
+ // file that predates this rule is tightened explicitly.
50
+ await fs.chmod(file, 0o600).catch(() => undefined);
51
+ },
52
+ };
53
+ }
54
+ async function resolveDeps(deps) {
55
+ const env = deps.env ?? process.env;
56
+ const keychain = deps.keychain !== undefined ? deps.keychain : await detectKeychain();
57
+ const fileStore = deps.fileStore ?? createFileStore(env);
58
+ return { env, keychain, fileStore };
59
+ }
60
+ export async function loadCredential(profile, deps = {}) {
61
+ const { env, keychain, fileStore } = await resolveDeps(deps);
62
+ const fromEnv = env.ATELIER201_API_KEY?.trim();
63
+ if (fromEnv) {
64
+ return { record: { kind: "api_key", api_key: fromEnv }, source: "env", profile };
65
+ }
66
+ if (keychain) {
67
+ try {
68
+ const raw = await keychain.get(profile);
69
+ const record = parseRecord(raw);
70
+ if (record)
71
+ return { record, source: "keychain", profile };
72
+ }
73
+ catch {
74
+ // A broken or locked keychain must not block the file fallback.
75
+ }
76
+ }
77
+ const config = await fileStore.read();
78
+ const record = config.profiles?.[profile];
79
+ if (record && isRecord(record))
80
+ return { record, source: "file", profile };
81
+ return null;
82
+ }
83
+ export async function saveCredential(profile, record, deps = {}) {
84
+ const { keychain, fileStore } = await resolveDeps(deps);
85
+ if (keychain) {
86
+ try {
87
+ await keychain.set(profile, JSON.stringify(record));
88
+ // Remove any stale plaintext copy so the two stores cannot disagree.
89
+ const config = await fileStore.read();
90
+ if (config.profiles?.[profile]) {
91
+ delete config.profiles[profile];
92
+ await fileStore.write(config);
93
+ }
94
+ return "keychain";
95
+ }
96
+ catch {
97
+ // Fall through to the file store.
98
+ }
99
+ }
100
+ const config = await fileStore.read();
101
+ config.profiles = { ...(config.profiles ?? {}), [profile]: record };
102
+ await fileStore.write(config);
103
+ return "file";
104
+ }
105
+ export async function clearCredential(profile, deps = {}) {
106
+ const { keychain, fileStore } = await resolveDeps(deps);
107
+ if (keychain) {
108
+ try {
109
+ await keychain.remove(profile);
110
+ }
111
+ catch {
112
+ // Nothing to clean up.
113
+ }
114
+ }
115
+ const config = await fileStore.read();
116
+ if (config.profiles?.[profile]) {
117
+ delete config.profiles[profile];
118
+ await fileStore.write(config);
119
+ }
120
+ }
121
+ // ── Shape guards ──────────────────────────────────────────────────────────────
122
+ export function isRecord(value) {
123
+ if (typeof value !== "object" || value === null)
124
+ return false;
125
+ const candidate = value;
126
+ if (candidate.kind === "api_key")
127
+ return typeof candidate.api_key === "string";
128
+ if (candidate.kind === "oauth")
129
+ return typeof candidate.access_token === "string";
130
+ return false;
131
+ }
132
+ function parseRecord(raw) {
133
+ if (!raw)
134
+ return null;
135
+ try {
136
+ const parsed = JSON.parse(raw);
137
+ return isRecord(parsed) ? parsed : null;
138
+ }
139
+ catch {
140
+ // A bare string in the keychain is a key stored by an older version.
141
+ return raw.startsWith("atelier201_") ? { kind: "api_key", api_key: raw } : null;
142
+ }
143
+ }
144
+ /** Everything after the last underscore is the secret; the rest is safe to show. */
145
+ export function maskApiKey(key) {
146
+ const parts = key.split("_");
147
+ if (parts.length < 4)
148
+ return `${key.slice(0, 8)}…`;
149
+ return `${parts.slice(0, 3).join("_")}…`;
150
+ }
151
+ //# sourceMappingURL=credentials.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"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"}
package/dist/errors.js ADDED
@@ -0,0 +1,166 @@
1
+ /**
2
+ * One error shape everywhere.
3
+ *
4
+ * The API already emits a single envelope for every failure. The CLI reuses it
5
+ * verbatim for API failures *and* synthesises the same envelope for its own
6
+ * local failures (missing credential, unreadable file, bad flag), so an agent
7
+ * parses one shape whether the request left the machine or not.
8
+ */
9
+ import { EXIT, exitCodeForApiError } from "./exit-codes.js";
10
+ export const DOCS_BASE_URL = "https://atelier201.com/docs/api/errors";
11
+ /** Anything the CLI throws deliberately. */
12
+ export class CliError extends Error {
13
+ exitCode;
14
+ code;
15
+ type;
16
+ param;
17
+ hint;
18
+ constructor(message, options = {}) {
19
+ super(message);
20
+ this.name = "CliError";
21
+ this.exitCode = options.exitCode ?? EXIT.USAGE;
22
+ this.code = options.code ?? "invalid_request";
23
+ this.type = options.type ?? "invalid_request_error";
24
+ this.param = options.param;
25
+ this.hint = options.hint;
26
+ }
27
+ toEnvelope() {
28
+ const message = this.hint
29
+ ? `${/[.!?]$/.test(this.message) ? this.message : `${this.message}.`} ${this.hint}`
30
+ : this.message;
31
+ return {
32
+ error: {
33
+ type: this.type,
34
+ code: this.code,
35
+ message,
36
+ ...(this.param ? { param: this.param } : {}),
37
+ docs_url: `${DOCS_BASE_URL}#${this.code}`,
38
+ },
39
+ request_id: null,
40
+ };
41
+ }
42
+ }
43
+ /** A non-2xx response. Carries the server's envelope untouched. */
44
+ export class ApiRequestError extends Error {
45
+ status;
46
+ code;
47
+ type;
48
+ param;
49
+ requestId;
50
+ retryAfterSeconds;
51
+ envelope;
52
+ constructor(status, envelope, options = {}) {
53
+ super(envelope.error.message);
54
+ this.name = "ApiRequestError";
55
+ this.status = status;
56
+ this.code = envelope.error.code;
57
+ this.type = envelope.error.type;
58
+ this.param = envelope.error.param;
59
+ this.requestId = envelope.request_id;
60
+ this.retryAfterSeconds = options.retryAfterSeconds;
61
+ this.envelope = envelope;
62
+ }
63
+ get exitCode() {
64
+ return exitCodeForApiError(this.status, this.code);
65
+ }
66
+ toEnvelope() {
67
+ return this.envelope;
68
+ }
69
+ }
70
+ /** DNS failure, refused connection, TLS problem, timeout. */
71
+ export class NetworkError extends Error {
72
+ exitCode = EXIT.API_ERROR;
73
+ cause;
74
+ constructor(message, cause) {
75
+ super(message);
76
+ this.name = "NetworkError";
77
+ this.cause = cause;
78
+ }
79
+ toEnvelope() {
80
+ return {
81
+ error: {
82
+ type: "api_error",
83
+ code: "service_unavailable",
84
+ message: this.message,
85
+ docs_url: `${DOCS_BASE_URL}#service_unavailable`,
86
+ },
87
+ request_id: null,
88
+ };
89
+ }
90
+ }
91
+ function carriesEnvelope(value) {
92
+ return (typeof value === "object" &&
93
+ value !== null &&
94
+ typeof value.toEnvelope === "function");
95
+ }
96
+ /**
97
+ * Turns anything thrown into the envelope plus an exit code. An unexpected
98
+ * exception becomes a generic `internal_error` rather than leaking a stack
99
+ * trace into an agent's parser.
100
+ */
101
+ export function toErrorReport(error) {
102
+ if (carriesEnvelope(error)) {
103
+ return { envelope: error.toEnvelope(), exitCode: error.exitCode };
104
+ }
105
+ const message = error instanceof Error ? error.message : String(error);
106
+ return {
107
+ envelope: {
108
+ error: {
109
+ type: "api_error",
110
+ code: "internal_error",
111
+ message: message || "The command failed for an unknown reason.",
112
+ docs_url: `${DOCS_BASE_URL}#internal_error`,
113
+ },
114
+ request_id: null,
115
+ },
116
+ exitCode: EXIT.API_ERROR,
117
+ };
118
+ }
119
+ // ── Frequently used local failures ────────────────────────────────────────────
120
+ export function notAuthenticated() {
121
+ return new CliError("Not authenticated.", {
122
+ exitCode: EXIT.AUTH,
123
+ code: "authentication_required",
124
+ type: "authentication_error",
125
+ hint: "Run 'atelier201 auth login --key <key>', or set ATELIER201_API_KEY.",
126
+ });
127
+ }
128
+ export function usageError(message, param) {
129
+ return new CliError(message, { exitCode: EXIT.USAGE, code: "invalid_parameter", param });
130
+ }
131
+ export function forceRequired(command) {
132
+ return new CliError("This command is destructive and cannot ask for confirmation here (stdin is not a terminal).", {
133
+ exitCode: EXIT.USAGE,
134
+ code: "invalid_request",
135
+ hint: `Re-run it with --force: atelier201 ${command} --force.`,
136
+ });
137
+ }
138
+ /**
139
+ * For a command that changes what visitors of a site see (publish, rollback,
140
+ * unpublish). Its own wording: nothing is charged and nothing is deleted, but
141
+ * the change is on the internet within about a minute.
142
+ */
143
+ export function visibleYesRequired(command) {
144
+ return new CliError("This command changes what visitors of the site see and cannot ask for confirmation here (stdin is not a terminal).", {
145
+ exitCode: EXIT.USAGE,
146
+ code: "invalid_request",
147
+ hint: `Re-run it with --yes once you have checked the change: atelier201 ${command} --yes`,
148
+ });
149
+ }
150
+ /** For a command that spends the workspace's credits (an AI image or video). */
151
+ export function spendYesRequired(command) {
152
+ return new CliError("This command spends credits and cannot ask for confirmation here (stdin is not a terminal).", {
153
+ exitCode: EXIT.USAGE,
154
+ code: "invalid_request",
155
+ hint: `Check the price with --estimate, then re-run it with --yes: atelier201 ${command} --yes`,
156
+ });
157
+ }
158
+ /** A destructive command that is confirmed by typing the resource's name. */
159
+ export function confirmationRequired(command, name) {
160
+ return new CliError("This command deletes the site for good and cannot ask for confirmation here (stdin is not a terminal).", {
161
+ exitCode: EXIT.USAGE,
162
+ code: "invalid_request",
163
+ hint: `Re-run it with the site's slug to confirm: atelier201 ${command} --confirm ${name}`,
164
+ });
165
+ }
166
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Deterministic exit codes.
3
+ *
4
+ * More granular than a plain ok/fail so a script can branch on "retry" versus
5
+ * "fix the input" without parsing text. The mapping is derived from the API's
6
+ * own error `code` first and the HTTP status second, because the code is the
7
+ * stable contract and the status is a consequence of it.
8
+ */
9
+ export const EXIT = {
10
+ /** Success. */
11
+ OK: 0,
12
+ /** API or server error — ours, or a transport failure. Retrying may help. */
13
+ API_ERROR: 1,
14
+ /** Bad usage: wrong flags, missing arguments, invalid input. Fix the command. */
15
+ USAGE: 2,
16
+ /** Authentication or permission failure. Re-authenticate or widen the scopes. */
17
+ AUTH: 3,
18
+ /** The resource does not exist (or belongs to another workspace). */
19
+ NOT_FOUND: 4,
20
+ /** Rate limited. Wait for `Retry-After` and try again. */
21
+ RATE_LIMITED: 5,
22
+ /** State conflict: the resource is not in a state that allows this. */
23
+ CONFLICT: 6,
24
+ };
25
+ /**
26
+ * Error code → exit code. Mirrors `API_ERROR_CODES` in
27
+ * `src/lib/api/errors.ts`; a code missing here falls back to the status map,
28
+ * so a newly added server code degrades gracefully instead of exiting 0.
29
+ */
30
+ const CODE_EXITS = {
31
+ // authentication_error
32
+ authentication_required: EXIT.AUTH,
33
+ invalid_api_key: EXIT.AUTH,
34
+ api_key_expired: EXIT.AUTH,
35
+ api_key_revoked: EXIT.AUTH,
36
+ // permission_error
37
+ insufficient_scope: EXIT.AUTH,
38
+ feature_not_available: EXIT.AUTH,
39
+ admin_required: EXIT.AUTH,
40
+ // invalid_request_error
41
+ invalid_request: EXIT.USAGE,
42
+ unknown_field: EXIT.USAGE,
43
+ invalid_parameter: EXIT.USAGE,
44
+ invalid_cursor: EXIT.USAGE,
45
+ request_too_large: EXIT.USAGE,
46
+ request_too_large_for_plan: EXIT.USAGE,
47
+ // Money, on its own code. A script that runs out of credits needs to stop and
48
+ // tell a human, not retry — which is exactly what it would do if this shared
49
+ // an exit code with a transient failure.
50
+ insufficient_credits: EXIT.USAGE,
51
+ // not_found_error
52
+ resource_not_found: EXIT.NOT_FOUND,
53
+ result_expired: EXIT.NOT_FOUND,
54
+ // conflict_error
55
+ conflict: EXIT.CONFLICT,
56
+ result_not_ready: EXIT.CONFLICT,
57
+ idempotency_key_reused: EXIT.CONFLICT,
58
+ // rate_limit_error
59
+ rate_limited: EXIT.RATE_LIMITED,
60
+ // api_error
61
+ internal_error: EXIT.API_ERROR,
62
+ service_unavailable: EXIT.API_ERROR,
63
+ };
64
+ /** Status → exit code, used when the body carried no recognised `code`. */
65
+ export function exitCodeForStatus(status) {
66
+ if (status === 401 || status === 403)
67
+ return EXIT.AUTH;
68
+ if (status === 404)
69
+ return EXIT.NOT_FOUND;
70
+ if (status === 409)
71
+ return EXIT.CONFLICT;
72
+ if (status === 429)
73
+ return EXIT.RATE_LIMITED;
74
+ if (status >= 400 && status < 500)
75
+ return EXIT.USAGE;
76
+ return EXIT.API_ERROR;
77
+ }
78
+ export function exitCodeForApiError(status, code) {
79
+ if (code && code in CODE_EXITS)
80
+ return CODE_EXITS[code];
81
+ return exitCodeForStatus(status);
82
+ }
83
+ //# sourceMappingURL=exit-codes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,eAAe;IACf,EAAE,EAAE,CAAC;IACL,6EAA6E;IAC7E,SAAS,EAAE,CAAC;IACZ,iFAAiF;IACjF,KAAK,EAAE,CAAC;IACR,iFAAiF;IACjF,IAAI,EAAE,CAAC;IACP,qEAAqE;IACrE,SAAS,EAAE,CAAC;IACZ,0DAA0D;IAC1D,YAAY,EAAE,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,CAAC;CACH,CAAC;AAIX;;;;GAIG;AACH,MAAM,UAAU,GAA6B;IAC3C,uBAAuB;IACvB,uBAAuB,EAAE,IAAI,CAAC,IAAI;IAClC,eAAe,EAAE,IAAI,CAAC,IAAI;IAC1B,eAAe,EAAE,IAAI,CAAC,IAAI;IAC1B,eAAe,EAAE,IAAI,CAAC,IAAI;IAC1B,mBAAmB;IACnB,kBAAkB,EAAE,IAAI,CAAC,IAAI;IAC7B,qBAAqB,EAAE,IAAI,CAAC,IAAI;IAChC,cAAc,EAAE,IAAI,CAAC,IAAI;IACzB,wBAAwB;IACxB,eAAe,EAAE,IAAI,CAAC,KAAK;IAC3B,aAAa,EAAE,IAAI,CAAC,KAAK;IACzB,iBAAiB,EAAE,IAAI,CAAC,KAAK;IAC7B,cAAc,EAAE,IAAI,CAAC,KAAK;IAC1B,iBAAiB,EAAE,IAAI,CAAC,KAAK;IAC7B,0BAA0B,EAAE,IAAI,CAAC,KAAK;IACtC,8EAA8E;IAC9E,6EAA6E;IAC7E,yCAAyC;IACzC,oBAAoB,EAAE,IAAI,CAAC,KAAK;IAChC,kBAAkB;IAClB,kBAAkB,EAAE,IAAI,CAAC,SAAS;IAClC,cAAc,EAAE,IAAI,CAAC,SAAS;IAC9B,iBAAiB;IACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,gBAAgB,EAAE,IAAI,CAAC,QAAQ;IAC/B,sBAAsB,EAAE,IAAI,CAAC,QAAQ;IACrC,mBAAmB;IACnB,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,YAAY;IACZ,cAAc,EAAE,IAAI,CAAC,SAAS;IAC9B,mBAAmB,EAAE,IAAI,CAAC,SAAS;CACpC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACvD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzC,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7C,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,IAAoB;IACtE,IAAI,IAAI,IAAI,IAAI,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}