@aaronjmars/openroutercli 0.1.6 → 0.2.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.
@@ -1,11 +1,11 @@
1
- import { parseArgs, authFromValues } from '../args.js';
2
- import { api, APIError } from '../api.js';
3
- import { resolveAuth } from '../config.js';
4
- import { c, isJsonMode, outln, printJSON, printResult, table } from '../output.js';
1
+ import { parseArgs, authFromValues } from "../args.js";
2
+ import { api, APIError } from "../api.js";
3
+ import { resolveAuth } from "../config.js";
4
+ import { c, isJsonMode, outln, printJSON, printResult, table } from "../output.js";
5
5
 
6
6
  async function fetchKey(authOpts, requiresManagement = false) {
7
7
  try {
8
- return await api('GET', '/key', { auth: authOpts, requiresManagement });
8
+ return await api("GET", "/key", { auth: authOpts, requiresManagement });
9
9
  } catch (err) {
10
10
  if (err instanceof APIError) return { error: err.message };
11
11
  throw err;
@@ -15,41 +15,43 @@ async function fetchKey(authOpts, requiresManagement = false) {
15
15
  function renderKey(label, data) {
16
16
  outln(c.bold(label));
17
17
  if (!data) {
18
- outln(c.dim(' (not configured)'));
18
+ outln(c.dim(" (not configured)"));
19
19
  return;
20
20
  }
21
21
  if (data.error) {
22
- outln(' ' + c.red(data.error));
22
+ outln(" " + c.red(data.error));
23
23
  return;
24
24
  }
25
25
  const d = data.data || data;
26
- outln(` label: ${d.label ?? ''}`);
26
+ outln(` label: ${d.label ?? ""}`);
27
27
  outln(` is_management_key: ${d.is_management_key ?? false}`);
28
28
  outln(` is_free_tier: ${d.is_free_tier}`);
29
- outln(` limit: ${d.limit ?? 'unlimited'}`);
30
- outln(` limit_remaining: ${d.limit_remaining ?? '-'}`);
31
- outln(` limit_reset: ${d.limit_reset ?? '-'}`);
32
- outln(` usage (total): ${d.usage ?? '-'}`);
29
+ outln(` limit: ${d.limit ?? "unlimited"}`);
30
+ outln(` limit_remaining: ${d.limit_remaining ?? "-"}`);
31
+ outln(` limit_reset: ${d.limit_reset ?? "-"}`);
32
+ outln(` usage (total): ${d.usage ?? "-"}`);
33
33
  if (d.usage_daily != null) outln(` usage_daily: ${d.usage_daily}`);
34
34
  if (d.usage_weekly != null) outln(` usage_weekly: ${d.usage_weekly}`);
35
35
  if (d.usage_monthly != null) outln(` usage_monthly: ${d.usage_monthly}`);
36
36
  if (d.byok_usage != null) outln(` byok_usage: ${d.byok_usage}`);
37
- outln(` expires_at: ${d.expires_at ?? '-'}`);
37
+ outln(` expires_at: ${d.expires_at ?? "-"}`);
38
38
  if (d.rate_limit) {
39
- outln(` rate_limit: ${d.rate_limit.requests ?? '?'} req / ${d.rate_limit.interval ?? '?'}`);
39
+ outln(
40
+ ` rate_limit: ${d.rate_limit.requests ?? "?"} req / ${d.rate_limit.interval ?? "?"}`,
41
+ );
40
42
  }
41
43
  }
42
44
 
43
45
  export async function whoamiCommand(argv) {
44
46
  const { values } = parseArgs(argv, {
45
- management: { type: 'boolean' }
47
+ management: { type: "boolean" },
46
48
  });
47
49
  if (values.help) {
48
50
  process.stdout.write(
49
- 'Usage: openrouter whoami [--management]\n\n' +
50
- 'Show the API key(s) currently configured. By default shows both the user\n' +
51
- 'key and the management key (if set). With --management, shows only the\n' +
52
- 'management key.\n'
51
+ "Usage: openrouter whoami [--management]\n\n" +
52
+ "Show the API key(s) currently configured. By default shows both the user\n" +
53
+ "key and the management key (if set). With --management, shows only the\n" +
54
+ "management key.\n",
53
55
  );
54
56
  return 0;
55
57
  }
@@ -59,17 +61,17 @@ export async function whoamiCommand(argv) {
59
61
 
60
62
  // If --key is supplied, query just that key.
61
63
  if (authOpts.key) {
62
- const data = await api('GET', '/key', { auth: authOpts });
63
- printResult(data, () => renderKey('API key (--key override)', data));
64
+ const data = await api("GET", "/key", { auth: authOpts });
65
+ printResult(data, () => renderKey("API key (--key override)", data));
64
66
  return 0;
65
67
  }
66
68
 
67
69
  if (values.management) {
68
70
  const data = resolved.hasManagementKey
69
- ? await api('GET', '/key', { auth: authOpts, requiresManagement: true })
71
+ ? await api("GET", "/key", { auth: authOpts, requiresManagement: true })
70
72
  : null;
71
73
  if (isJsonMode()) printJSON({ management: data });
72
- else renderKey('Management key', data);
74
+ else renderKey("Management key", data);
73
75
  return 0;
74
76
  }
75
77
 
@@ -85,22 +87,22 @@ export async function whoamiCommand(argv) {
85
87
  printJSON({ user: userData, management: mgmtData });
86
88
  return code;
87
89
  }
88
- renderKey('User key', userData);
89
- outln('');
90
- renderKey('Management key', mgmtData);
90
+ renderKey("User key", userData);
91
+ outln("");
92
+ renderKey("Management key", mgmtData);
91
93
  return code;
92
94
  }
93
95
 
94
96
  export async function creditsCommand(argv) {
95
97
  const { values } = parseArgs(argv, {});
96
98
  if (values.help) {
97
- process.stdout.write('Usage: openrouter credits\n\nShow remaining credits.\n');
99
+ process.stdout.write("Usage: openrouter credits\n\nShow remaining credits.\n");
98
100
  return 0;
99
101
  }
100
- const data = await api('GET', '/credits', { auth: authFromValues(values) });
102
+ const data = await api("GET", "/credits", { auth: authFromValues(values) });
101
103
  printResult(data, () => {
102
104
  const d = data.data || data;
103
- outln(c.bold('Credits'));
105
+ outln(c.bold("Credits"));
104
106
  for (const [k, v] of Object.entries(d)) outln(` ${k}: ${v}`);
105
107
  });
106
108
  return 0;
@@ -108,37 +110,37 @@ export async function creditsCommand(argv) {
108
110
 
109
111
  export async function activityCommand(argv) {
110
112
  const { values } = parseArgs(argv, {
111
- date: { type: 'string' },
112
- 'api-key-hash': { type: 'string' },
113
- 'user-id': { type: 'string' }
113
+ date: { type: "string" },
114
+ "api-key-hash": { type: "string" },
115
+ "user-id": { type: "string" },
114
116
  });
115
117
  if (values.help) {
116
118
  process.stdout.write(
117
- `Usage: openrouter activity [options]\n\nGet usage activity grouped by endpoint.\n\nOptions:\n --date <YYYY-MM-DD> UTC date in last 30 days\n --api-key-hash <hash> Filter by API key SHA-256 hash\n --user-id <id> Filter by org member user ID\n`
119
+ `Usage: openrouter activity [options]\n\nGet usage activity grouped by endpoint.\n\nOptions:\n --date <YYYY-MM-DD> UTC date in last 30 days\n --api-key-hash <hash> Filter by API key SHA-256 hash\n --user-id <id> Filter by org member user ID\n`,
118
120
  );
119
121
  return 0;
120
122
  }
121
123
  const query = {};
122
124
  if (values.date) query.date = values.date;
123
- if (values['api-key-hash']) query.api_key_hash = values['api-key-hash'];
124
- if (values['user-id']) query.user_id = values['user-id'];
125
- const data = await api('GET', '/activity', {
125
+ if (values["api-key-hash"]) query.api_key_hash = values["api-key-hash"];
126
+ if (values["user-id"]) query.user_id = values["user-id"];
127
+ const data = await api("GET", "/activity", {
126
128
  auth: authFromValues(values),
127
129
  requiresManagement: true,
128
- query
130
+ query,
129
131
  });
130
132
  printResult(data, () => {
131
133
  const rows = data.data || [];
132
134
  if (!rows.length) {
133
- outln(c.dim('(no activity)'));
135
+ outln(c.dim("(no activity)"));
134
136
  return;
135
137
  }
136
138
  table(rows, [
137
- { label: 'date', value: (r) => r.date || r.day || '' },
138
- { label: 'model', value: (r) => r.model || r.model_permaslug || '' },
139
- { label: 'requests', value: (r) => r.requests ?? r.request_count ?? '' },
140
- { label: 'tokens', value: (r) => r.tokens ?? r.total_tokens ?? '' },
141
- { label: 'cost', value: (r) => r.usage ?? r.cost ?? '' }
139
+ { label: "date", value: (r) => r.date || r.day || "" },
140
+ { label: "model", value: (r) => r.model || r.model_permaslug || "" },
141
+ { label: "requests", value: (r) => r.requests ?? r.request_count ?? "" },
142
+ { label: "tokens", value: (r) => r.tokens ?? r.total_tokens ?? "" },
143
+ { label: "cost", value: (r) => r.usage ?? r.cost ?? "" },
142
144
  ]);
143
145
  });
144
146
  return 0;
@@ -0,0 +1,153 @@
1
+ import { parseArgs, authFromValues } from "../args.js";
2
+ import { api } from "../api.js";
3
+ import { outln, printResult, table } from "../output.js";
4
+
5
+ const HELP = `Usage: openrouter byok <subcommand> [options]
6
+
7
+ Manage BYOK (bring-your-own-key) provider integrations (requires a provisioning/management key).
8
+
9
+ Subcommands:
10
+ list List integrations
11
+ get <id> Get a single integration
12
+ create [options] Create an integration
13
+ update <id> [options] Update an integration
14
+ delete <id> Delete an integration
15
+
16
+ create options:
17
+ --provider <slug> Provider slug (required)
18
+ --api-key <key> Provider secret key (required)
19
+ --name <text>
20
+ --allowed-models <csv>
21
+ --allowed-hashes <csv>
22
+ --allowed-users <csv>
23
+ --disabled / --enabled
24
+ --fallback / --no-fallback
25
+
26
+ update options:
27
+ --provider <slug>
28
+ --api-key <key>
29
+ --name <text>
30
+ --allowed-models <csv>
31
+ --allowed-hashes <csv>
32
+ --allowed-users <csv>
33
+ --disabled / --enabled
34
+ --fallback / --no-fallback
35
+ `;
36
+
37
+ const WRITE_OPTIONS = {
38
+ provider: { type: "string" },
39
+ "api-key": { type: "string" },
40
+ name: { type: "string" },
41
+ "allowed-models": { type: "string" },
42
+ "allowed-hashes": { type: "string" },
43
+ "allowed-users": { type: "string" },
44
+ disabled: { type: "boolean" },
45
+ enabled: { type: "boolean" },
46
+ fallback: { type: "boolean" },
47
+ "no-fallback": { type: "boolean" },
48
+ };
49
+
50
+ function csvOption(value) {
51
+ return value.split(",").map((s) => s.trim());
52
+ }
53
+
54
+ export async function byokCommand(argv) {
55
+ const sub = argv[0];
56
+ const rest = argv.slice(1);
57
+ if (!sub || sub === "-h" || sub === "--help" || sub === "help") {
58
+ process.stdout.write(HELP);
59
+ return sub ? 0 : 1;
60
+ }
61
+
62
+ if (rest.includes("-h") || rest.includes("--help")) {
63
+ process.stdout.write(HELP);
64
+ return 0;
65
+ }
66
+
67
+ if (sub === "list") {
68
+ const { values } = parseArgs(rest, {});
69
+ const data = await api("GET", "/byok", {
70
+ auth: authFromValues(values),
71
+ requiresManagement: true,
72
+ });
73
+ printResult(data, () => {
74
+ const rows = data.data || [];
75
+ table(rows, [
76
+ { label: "id", value: (b) => b.id || "" },
77
+ { label: "provider", value: (b) => b.provider || "" },
78
+ { label: "name", value: (b) => b.name || "" },
79
+ { label: "disabled", value: (b) => (b.disabled ? "yes" : "") },
80
+ ]);
81
+ });
82
+ return 0;
83
+ }
84
+
85
+ if (sub === "get") {
86
+ const { values, positionals } = parseArgs(rest, {});
87
+ if (!positionals[0]) throw new Error("id required");
88
+ const data = await api("GET", `/byok/${encodeURIComponent(positionals[0])}`, {
89
+ auth: authFromValues(values),
90
+ requiresManagement: true,
91
+ });
92
+ printResult(data);
93
+ return 0;
94
+ }
95
+
96
+ if (sub === "create") {
97
+ const { values } = parseArgs(rest, WRITE_OPTIONS);
98
+ if (!values.provider) throw new Error("--provider required");
99
+ if (!values["api-key"]) throw new Error("--api-key required");
100
+ const body = { provider: values.provider, key: values["api-key"] };
101
+ if (values.name) body.name = values.name;
102
+ if (values["allowed-models"]) body.allowed_models = csvOption(values["allowed-models"]);
103
+ if (values["allowed-hashes"]) body.allowed_api_key_hashes = csvOption(values["allowed-hashes"]);
104
+ if (values["allowed-users"]) body.allowed_user_ids = csvOption(values["allowed-users"]);
105
+ if (values.disabled) body.disabled = true;
106
+ if (values.enabled) body.disabled = false;
107
+ if (values.fallback) body.is_fallback = true;
108
+ if (values["no-fallback"]) body.is_fallback = false;
109
+ const data = await api("POST", "/byok", {
110
+ auth: authFromValues(values),
111
+ requiresManagement: true,
112
+ body,
113
+ });
114
+ printResult(data);
115
+ return 0;
116
+ }
117
+
118
+ if (sub === "update") {
119
+ const { values, positionals } = parseArgs(rest, WRITE_OPTIONS);
120
+ if (!positionals[0]) throw new Error("id required");
121
+ const body = {};
122
+ if (values.provider) body.provider = values.provider;
123
+ if (values["api-key"]) body.key = values["api-key"];
124
+ if (values.name) body.name = values.name;
125
+ if (values["allowed-models"]) body.allowed_models = csvOption(values["allowed-models"]);
126
+ if (values["allowed-hashes"]) body.allowed_api_key_hashes = csvOption(values["allowed-hashes"]);
127
+ if (values["allowed-users"]) body.allowed_user_ids = csvOption(values["allowed-users"]);
128
+ if (values.disabled) body.disabled = true;
129
+ if (values.enabled) body.disabled = false;
130
+ if (values.fallback) body.is_fallback = true;
131
+ if (values["no-fallback"]) body.is_fallback = false;
132
+ const data = await api("PATCH", `/byok/${encodeURIComponent(positionals[0])}`, {
133
+ auth: authFromValues(values),
134
+ requiresManagement: true,
135
+ body,
136
+ });
137
+ printResult(data);
138
+ return 0;
139
+ }
140
+
141
+ if (sub === "delete") {
142
+ const { values, positionals } = parseArgs(rest, {});
143
+ if (!positionals[0]) throw new Error("id required");
144
+ const data = await api("DELETE", `/byok/${encodeURIComponent(positionals[0])}`, {
145
+ auth: authFromValues(values),
146
+ requiresManagement: true,
147
+ });
148
+ printResult(data, () => outln("deleted"));
149
+ return 0;
150
+ }
151
+
152
+ throw new Error(`Unknown byok subcommand: ${sub}`);
153
+ }