easybill-mcp 1.0.2 → 1.2.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 (72) hide show
  1. package/README.md +123 -15
  2. package/dist/constants.d.ts +2 -1
  3. package/dist/constants.js +18 -1
  4. package/dist/constants.js.map +1 -1
  5. package/dist/hosted/accounts.d.ts +13 -0
  6. package/dist/hosted/accounts.js +70 -0
  7. package/dist/hosted/accounts.js.map +1 -0
  8. package/dist/hosted/config.d.ts +73 -0
  9. package/dist/hosted/config.js +200 -0
  10. package/dist/hosted/config.js.map +1 -0
  11. package/dist/hosted/http.d.ts +23 -0
  12. package/dist/hosted/http.js +524 -0
  13. package/dist/hosted/http.js.map +1 -0
  14. package/dist/hosted/pages.d.ts +22 -0
  15. package/dist/hosted/pages.js +130 -0
  16. package/dist/hosted/pages.js.map +1 -0
  17. package/dist/hosted/provider.d.ts +54 -0
  18. package/dist/hosted/provider.js +190 -0
  19. package/dist/hosted/provider.js.map +1 -0
  20. package/dist/hosted/store.d.ts +119 -0
  21. package/dist/hosted/store.js +254 -0
  22. package/dist/hosted/store.js.map +1 -0
  23. package/dist/hosted/upstream.d.ts +68 -0
  24. package/dist/hosted/upstream.js +280 -0
  25. package/dist/hosted/upstream.js.map +1 -0
  26. package/dist/index.d.ts +5 -1
  27. package/dist/index.js +19 -24
  28. package/dist/index.js.map +1 -1
  29. package/dist/instructions.d.ts +1 -1
  30. package/dist/instructions.js +16 -1
  31. package/dist/instructions.js.map +1 -1
  32. package/dist/server.d.ts +26 -0
  33. package/dist/server.js +47 -0
  34. package/dist/server.js.map +1 -0
  35. package/dist/services/client.d.ts +43 -4
  36. package/dist/services/client.js +35 -9
  37. package/dist/services/client.js.map +1 -1
  38. package/dist/services/format.d.ts +17 -4
  39. package/dist/services/format.js.map +1 -1
  40. package/dist/tools/catalog.d.ts +2 -2
  41. package/dist/tools/catalog.js.map +1 -1
  42. package/dist/tools/crud.d.ts +2 -2
  43. package/dist/tools/crud.js.map +1 -1
  44. package/dist/tools/customers.d.ts +2 -2
  45. package/dist/tools/customers.js +12 -4
  46. package/dist/tools/customers.js.map +1 -1
  47. package/dist/tools/documents.d.ts +2 -2
  48. package/dist/tools/documents.js +73 -43
  49. package/dist/tools/documents.js.map +1 -1
  50. package/dist/tools/files-io.d.ts +44 -0
  51. package/dist/tools/files-io.js +173 -0
  52. package/dist/tools/files-io.js.map +1 -0
  53. package/dist/tools/files.d.ts +2 -2
  54. package/dist/tools/files.js +9 -27
  55. package/dist/tools/files.js.map +1 -1
  56. package/dist/tools/finance.d.ts +2 -2
  57. package/dist/tools/finance.js.map +1 -1
  58. package/dist/tools/incoming.d.ts +11 -0
  59. package/dist/tools/incoming.js +222 -0
  60. package/dist/tools/incoming.js.map +1 -0
  61. package/dist/tools/meta.d.ts +2 -2
  62. package/dist/tools/meta.js +14 -6
  63. package/dist/tools/meta.js.map +1 -1
  64. package/dist/tools/registry.d.ts +40 -9
  65. package/dist/tools/registry.js +75 -12
  66. package/dist/tools/registry.js.map +1 -1
  67. package/dist/tools/search.d.ts +9 -8
  68. package/dist/tools/search.js +49 -17
  69. package/dist/tools/search.js.map +1 -1
  70. package/dist/tools/work.d.ts +2 -2
  71. package/dist/tools/work.js.map +1 -1
  72. package/package.json +5 -2
@@ -0,0 +1,254 @@
1
+ /**
2
+ * Persistent state for hosted mode, in SQLite (node:sqlite, no extra dependency).
3
+ *
4
+ * Vocabulary:
5
+ * - grant: one person's bundle of easybill connections. Every token this
6
+ * server issues to an MCP client points at a grant.
7
+ * - connection: a grant's OAuth tokens for one tenant (easybill account).
8
+ * - session: a short-lived visit to the connect page, either during the MCP
9
+ * client's OAuth authorization ("authorize") or from a link the
10
+ * model handed out ("manage").
11
+ *
12
+ * Secrets at rest: easybill tokens are AES-256-GCM encrypted; tokens this server
13
+ * issues are stored only as SHA-256 hashes.
14
+ */
15
+ import { createCipheriv, createDecipheriv, createHash, hkdfSync, randomBytes } from "node:crypto";
16
+ import { mkdirSync } from "node:fs";
17
+ import path from "node:path";
18
+ import { DatabaseSync } from "node:sqlite";
19
+ export const randomToken = (bytes = 32) => randomBytes(bytes).toString("base64url");
20
+ export const sha256 = (value) => createHash("sha256").update(value).digest("hex");
21
+ const nowSeconds = () => Math.floor(Date.now() / 1000);
22
+ const SCHEMA = `
23
+ CREATE TABLE IF NOT EXISTS meta (key TEXT PRIMARY KEY, value TEXT NOT NULL);
24
+ CREATE TABLE IF NOT EXISTS oauth_clients (client_id TEXT PRIMARY KEY, data TEXT NOT NULL, created_at INTEGER NOT NULL);
25
+ CREATE TABLE IF NOT EXISTS grants (id TEXT PRIMARY KEY, created_at INTEGER NOT NULL, last_used_at INTEGER NOT NULL);
26
+ CREATE TABLE IF NOT EXISTS sessions (
27
+ id TEXT PRIMARY KEY, kind TEXT NOT NULL, grant_id TEXT NOT NULL, client_id TEXT, redirect_uri TEXT,
28
+ code_challenge TEXT, state TEXT, resource TEXT, expires_at INTEGER NOT NULL);
29
+ CREATE TABLE IF NOT EXISTS upstream_states (
30
+ state TEXT PRIMARY KEY, session_id TEXT NOT NULL, tenant_id TEXT NOT NULL, code_verifier TEXT NOT NULL,
31
+ expires_at INTEGER NOT NULL);
32
+ CREATE TABLE IF NOT EXISTS connections (
33
+ grant_id TEXT NOT NULL, tenant_id TEXT NOT NULL, auth_kind TEXT NOT NULL DEFAULT 'oauth',
34
+ access_token TEXT NOT NULL, refresh_token TEXT NOT NULL,
35
+ access_expires_at INTEGER NOT NULL, refresh_expires_at INTEGER NOT NULL, login_label TEXT, claims TEXT NOT NULL,
36
+ connected_at INTEGER NOT NULL, broken_reason TEXT, PRIMARY KEY (grant_id, tenant_id));
37
+ CREATE TABLE IF NOT EXISTS auth_codes (
38
+ code_hash TEXT PRIMARY KEY, grant_id TEXT NOT NULL, client_id TEXT NOT NULL, code_challenge TEXT NOT NULL,
39
+ redirect_uri TEXT NOT NULL, resource TEXT, expires_at INTEGER NOT NULL);
40
+ CREATE TABLE IF NOT EXISTS tokens (
41
+ token_hash TEXT PRIMARY KEY, kind TEXT NOT NULL, grant_id TEXT NOT NULL, client_id TEXT NOT NULL,
42
+ resource TEXT, expires_at INTEGER NOT NULL);
43
+ CREATE INDEX IF NOT EXISTS tokens_grant ON tokens (grant_id);
44
+ `;
45
+ export class Store {
46
+ db;
47
+ key;
48
+ constructor(dbPath, secret) {
49
+ if (dbPath !== ":memory:")
50
+ mkdirSync(path.dirname(path.resolve(dbPath)), { recursive: true });
51
+ this.db = new DatabaseSync(dbPath);
52
+ this.db.exec("PRAGMA journal_mode = WAL; PRAGMA busy_timeout = 5000;");
53
+ this.db.exec(SCHEMA);
54
+ this.key = Buffer.from(hkdfSync("sha256", secret, "easybill-mcp", "token-encryption", 32));
55
+ }
56
+ close() {
57
+ this.db.close();
58
+ }
59
+ // --- encryption --------------------------------------------------------
60
+ encrypt(plain) {
61
+ const iv = randomBytes(12);
62
+ const cipher = createCipheriv("aes-256-gcm", this.key, iv);
63
+ const data = Buffer.concat([cipher.update(plain, "utf8"), cipher.final()]);
64
+ return Buffer.concat([iv, cipher.getAuthTag(), data]).toString("base64");
65
+ }
66
+ decrypt(stored) {
67
+ const raw = Buffer.from(stored, "base64");
68
+ const decipher = createDecipheriv("aes-256-gcm", this.key, raw.subarray(0, 12));
69
+ decipher.setAuthTag(raw.subarray(12, 28));
70
+ return Buffer.concat([decipher.update(raw.subarray(28)), decipher.final()]).toString("utf8");
71
+ }
72
+ // --- meta --------------------------------------------------------------
73
+ getMeta(key) {
74
+ const row = this.db.prepare("SELECT value FROM meta WHERE key = ?").get(key);
75
+ return row?.value;
76
+ }
77
+ setMeta(key, value) {
78
+ this.db.prepare("INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(key, value);
79
+ }
80
+ /** Secret metadata (the upstream client secret) goes through here. */
81
+ getSecretMeta(key) {
82
+ const value = this.getMeta(key);
83
+ return value === undefined ? undefined : this.decrypt(value);
84
+ }
85
+ setSecretMeta(key, value) {
86
+ this.setMeta(key, this.encrypt(value));
87
+ }
88
+ // --- OAuth clients (MCP clients that registered with us) ---------------
89
+ getClient(clientId) {
90
+ const row = this.db.prepare("SELECT data FROM oauth_clients WHERE client_id = ?").get(clientId);
91
+ return row ? JSON.parse(row.data) : undefined;
92
+ }
93
+ saveClient(client) {
94
+ this.db
95
+ .prepare("INSERT OR REPLACE INTO oauth_clients (client_id, data, created_at) VALUES (?, ?, ?)")
96
+ .run(client.client_id, JSON.stringify(client), nowSeconds());
97
+ }
98
+ // --- grants ------------------------------------------------------------
99
+ createGrant() {
100
+ const id = randomToken(18);
101
+ const now = nowSeconds();
102
+ this.db.prepare("INSERT INTO grants (id, created_at, last_used_at) VALUES (?, ?, ?)").run(id, now, now);
103
+ return id;
104
+ }
105
+ grantExists(id) {
106
+ return this.db.prepare("SELECT 1 FROM grants WHERE id = ?").get(id) !== undefined;
107
+ }
108
+ touchGrant(id) {
109
+ this.db.prepare("UPDATE grants SET last_used_at = ? WHERE id = ?").run(nowSeconds(), id);
110
+ }
111
+ // --- connect-page sessions --------------------------------------------
112
+ createSession(row, ttlSeconds) {
113
+ const id = randomToken();
114
+ this.db
115
+ .prepare("INSERT INTO sessions (id, kind, grant_id, client_id, redirect_uri, code_challenge, state, resource, expires_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)")
116
+ .run(id, row.kind, row.grant_id, row.client_id, row.redirect_uri, row.code_challenge, row.state, row.resource, nowSeconds() + ttlSeconds);
117
+ return id;
118
+ }
119
+ getSession(id) {
120
+ const row = this.db.prepare("SELECT * FROM sessions WHERE id = ?").get(id);
121
+ if (!row || row.expires_at < nowSeconds())
122
+ return undefined;
123
+ return row;
124
+ }
125
+ deleteSession(id) {
126
+ this.db.prepare("DELETE FROM sessions WHERE id = ?").run(id);
127
+ }
128
+ // --- upstream (easybill) authorization in flight ------------------------
129
+ createUpstreamState(sessionId, tenantId, codeVerifier) {
130
+ const state = randomToken();
131
+ this.db
132
+ .prepare("INSERT INTO upstream_states (state, session_id, tenant_id, code_verifier, expires_at) VALUES (?, ?, ?, ?, ?)")
133
+ .run(state, sessionId, tenantId, this.encrypt(codeVerifier), nowSeconds() + 900);
134
+ return state;
135
+ }
136
+ /** Single use: the row is deleted as it is read. */
137
+ takeUpstreamState(state) {
138
+ const row = this.db.prepare("SELECT * FROM upstream_states WHERE state = ?").get(state);
139
+ if (!row)
140
+ return undefined;
141
+ this.db.prepare("DELETE FROM upstream_states WHERE state = ?").run(state);
142
+ if (row.expires_at < nowSeconds())
143
+ return undefined;
144
+ return { sessionId: row.session_id, tenantId: row.tenant_id, codeVerifier: this.decrypt(row.code_verifier) };
145
+ }
146
+ // --- connections -------------------------------------------------------
147
+ saveConnection(row) {
148
+ this.db
149
+ .prepare(`INSERT INTO connections (grant_id, tenant_id, auth_kind, access_token, refresh_token, access_expires_at, refresh_expires_at, login_label, claims, connected_at, broken_reason)
150
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL)
151
+ ON CONFLICT(grant_id, tenant_id) DO UPDATE SET auth_kind = excluded.auth_kind, access_token = excluded.access_token, refresh_token = excluded.refresh_token,
152
+ access_expires_at = excluded.access_expires_at, refresh_expires_at = excluded.refresh_expires_at,
153
+ login_label = excluded.login_label, claims = excluded.claims, connected_at = excluded.connected_at, broken_reason = NULL`)
154
+ .run(row.grant_id, row.tenant_id, row.auth_kind, this.encrypt(row.access_token), this.encrypt(row.refresh_token), row.access_expires_at, row.refresh_expires_at, row.login_label, JSON.stringify(row.claims), row.connected_at);
155
+ }
156
+ updateConnectionTokens(grantId, tenantId, tokens) {
157
+ this.db
158
+ .prepare("UPDATE connections SET access_token = ?, refresh_token = ?, access_expires_at = ?, refresh_expires_at = ?, broken_reason = NULL WHERE grant_id = ? AND tenant_id = ?")
159
+ .run(this.encrypt(tokens.access_token), this.encrypt(tokens.refresh_token), tokens.access_expires_at, tokens.refresh_expires_at, grantId, tenantId);
160
+ }
161
+ markConnectionBroken(grantId, tenantId, reason) {
162
+ this.db
163
+ .prepare("UPDATE connections SET broken_reason = ? WHERE grant_id = ? AND tenant_id = ?")
164
+ .run(reason, grantId, tenantId);
165
+ }
166
+ getConnection(grantId, tenantId) {
167
+ const row = this.db.prepare("SELECT * FROM connections WHERE grant_id = ? AND tenant_id = ?").get(grantId, tenantId);
168
+ return row ? this.decodeConnection(row) : undefined;
169
+ }
170
+ listConnections(grantId) {
171
+ const rows = this.db.prepare("SELECT * FROM connections WHERE grant_id = ?").all(grantId);
172
+ return rows.map((row) => this.decodeConnection(row));
173
+ }
174
+ deleteConnection(grantId, tenantId) {
175
+ this.db.prepare("DELETE FROM connections WHERE grant_id = ? AND tenant_id = ?").run(grantId, tenantId);
176
+ }
177
+ decodeConnection(row) {
178
+ return {
179
+ grant_id: String(row.grant_id),
180
+ tenant_id: String(row.tenant_id),
181
+ auth_kind: row.auth_kind === "apikey" ? "apikey" : "oauth",
182
+ access_token: this.decrypt(String(row.access_token)),
183
+ refresh_token: this.decrypt(String(row.refresh_token)),
184
+ access_expires_at: Number(row.access_expires_at),
185
+ refresh_expires_at: Number(row.refresh_expires_at),
186
+ login_label: row.login_label === null ? null : String(row.login_label),
187
+ claims: JSON.parse(String(row.claims)),
188
+ connected_at: Number(row.connected_at),
189
+ broken_reason: row.broken_reason === null ? null : String(row.broken_reason),
190
+ };
191
+ }
192
+ // --- tenant fingerprints ----------------------------------------------
193
+ /**
194
+ * The easybill login IDs seen when a tenant was first connected. An API key
195
+ * carries no account identifier, so this is how we recognise "same company"
196
+ * later: login IDs are unique across easybill.
197
+ */
198
+ getTenantFingerprint(tenantId) {
199
+ const raw = this.getMeta(`tenant_fingerprint:${tenantId}`);
200
+ return raw ? JSON.parse(raw) : undefined;
201
+ }
202
+ setTenantFingerprint(tenantId, loginIds) {
203
+ this.setMeta(`tenant_fingerprint:${tenantId}`, JSON.stringify([...new Set(loginIds)].sort()));
204
+ }
205
+ /** All tenants' fingerprints, to refuse a key that belongs to a different tenant. */
206
+ listTenantFingerprints() {
207
+ const rows = this.db.prepare("SELECT key, value FROM meta WHERE key LIKE 'tenant_fingerprint:%'").all();
208
+ return new Map(rows.map((r) => [r.key.slice("tenant_fingerprint:".length), JSON.parse(r.value)]));
209
+ }
210
+ // --- authorization codes (issued to MCP clients) -----------------------
211
+ createCode(row) {
212
+ const code = randomToken();
213
+ this.db
214
+ .prepare("INSERT INTO auth_codes (code_hash, grant_id, client_id, code_challenge, redirect_uri, resource, expires_at) VALUES (?, ?, ?, ?, ?, ?, ?)")
215
+ .run(sha256(code), row.grant_id, row.client_id, row.code_challenge, row.redirect_uri, row.resource, nowSeconds() + 300);
216
+ return code;
217
+ }
218
+ getCode(code) {
219
+ const row = this.db.prepare("SELECT * FROM auth_codes WHERE code_hash = ?").get(sha256(code));
220
+ if (!row || row.expires_at < nowSeconds())
221
+ return undefined;
222
+ return row;
223
+ }
224
+ deleteCode(code) {
225
+ this.db.prepare("DELETE FROM auth_codes WHERE code_hash = ?").run(sha256(code));
226
+ }
227
+ // --- tokens (issued to MCP clients) ------------------------------------
228
+ createToken(row, ttlSeconds) {
229
+ const token = randomToken();
230
+ const expiresAt = nowSeconds() + ttlSeconds;
231
+ this.db
232
+ .prepare("INSERT INTO tokens (token_hash, kind, grant_id, client_id, resource, expires_at) VALUES (?, ?, ?, ?, ?, ?)")
233
+ .run(sha256(token), row.kind, row.grant_id, row.client_id, row.resource, expiresAt);
234
+ return { token, expiresAt };
235
+ }
236
+ getToken(token) {
237
+ const row = this.db.prepare("SELECT * FROM tokens WHERE token_hash = ?").get(sha256(token));
238
+ if (!row || row.expires_at < nowSeconds())
239
+ return undefined;
240
+ return row;
241
+ }
242
+ deleteToken(token) {
243
+ this.db.prepare("DELETE FROM tokens WHERE token_hash = ?").run(sha256(token));
244
+ }
245
+ // --- housekeeping ------------------------------------------------------
246
+ /** Drops expired rows. Cheap; run it periodically. */
247
+ purgeExpired() {
248
+ const now = nowSeconds();
249
+ for (const table of ["sessions", "upstream_states", "auth_codes", "tokens"]) {
250
+ this.db.prepare(`DELETE FROM ${table} WHERE expires_at < ?`).run(now);
251
+ }
252
+ }
253
+ }
254
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/hosted/store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * OAuth client towards easybill (the "upstream").
3
+ *
4
+ * easybill runs an OAuth 2.0 authorization server at api.easybill.de with
5
+ * dynamic client registration, PKCE (S256) and refresh tokens. Its access tokens
6
+ * are JWTs that the REST API accepts as `Authorization: Bearer …`.
7
+ * Documented at https://api.easybill.de/rest/v1/OAUTH2.md; endpoints are read
8
+ * from the issuer's /.well-known/oauth-authorization-server.
9
+ *
10
+ * Lifetimes per easybill's docs: access token 1 hour, refresh token 1 month.
11
+ */
12
+ import type { HostedConfig } from "./config.js";
13
+ import type { Store } from "./store.js";
14
+ export interface UpstreamTokens {
15
+ access_token: string;
16
+ refresh_token: string;
17
+ access_expires_at: number;
18
+ refresh_expires_at: number;
19
+ }
20
+ /** An error from easybill's OAuth endpoints. `permanent` means: the person has to reconnect. */
21
+ export declare class UpstreamOAuthError extends Error {
22
+ readonly code: string;
23
+ readonly permanent: boolean;
24
+ constructor(message: string, code: string, permanent: boolean);
25
+ }
26
+ /** The connection is gone for good; tool calls should tell the model to get a reconnect link. */
27
+ export declare class ReconnectRequiredError extends Error {
28
+ readonly tenantId: string;
29
+ constructor(tenantId: string, reason: string);
30
+ }
31
+ export declare function pkcePair(): {
32
+ verifier: string;
33
+ challenge: string;
34
+ };
35
+ /** Reads a JWT's claims without verifying it — only for tokens we just got from easybill over TLS. */
36
+ export declare function decodeJwtClaims(token: string): Record<string, unknown>;
37
+ export declare class EasybillOAuth {
38
+ private readonly config;
39
+ private readonly store;
40
+ readonly redirectUri: string;
41
+ private metadata?;
42
+ private clientId?;
43
+ private clientSecret?;
44
+ constructor(config: HostedConfig, store: Store);
45
+ /** Discovers easybill's endpoints and makes sure we have a client registration. */
46
+ init(): Promise<void>;
47
+ private get endpoints();
48
+ private ensureClient;
49
+ authorizationUrl(state: string, codeChallenge: string, scopes: string[]): string;
50
+ exchangeCode(code: string, codeVerifier: string): Promise<UpstreamTokens>;
51
+ refresh(refreshToken: string): Promise<UpstreamTokens>;
52
+ private tokenRequest;
53
+ }
54
+ /**
55
+ * Hands out a valid easybill access token per (grant, tenant), refreshing when
56
+ * it is about to expire. Concurrent callers share one refresh: easybill rotates
57
+ * refresh tokens, so two parallel refreshes would invalidate each other.
58
+ */
59
+ export declare class ConnectionTokens {
60
+ private readonly store;
61
+ /** Absent in API-key mode. */
62
+ private readonly oauth;
63
+ private readonly inflight;
64
+ constructor(store: Store,
65
+ /** Absent in API-key mode. */
66
+ oauth: EasybillOAuth | undefined);
67
+ accessToken(grantId: string, tenantId: string, forceRefresh?: boolean): Promise<string>;
68
+ }
@@ -0,0 +1,280 @@
1
+ /**
2
+ * OAuth client towards easybill (the "upstream").
3
+ *
4
+ * easybill runs an OAuth 2.0 authorization server at api.easybill.de with
5
+ * dynamic client registration, PKCE (S256) and refresh tokens. Its access tokens
6
+ * are JWTs that the REST API accepts as `Authorization: Bearer …`.
7
+ * Documented at https://api.easybill.de/rest/v1/OAUTH2.md; endpoints are read
8
+ * from the issuer's /.well-known/oauth-authorization-server.
9
+ *
10
+ * Lifetimes per easybill's docs: access token 1 hour, refresh token 1 month.
11
+ */
12
+ import { createHash, randomBytes } from "node:crypto";
13
+ import { SERVER_NAME, SERVER_VERSION, TIMEOUT_MS } from "../constants.js";
14
+ /** easybill documents a one-month refresh token lifetime; we cannot read it from the response. */
15
+ const UPSTREAM_REFRESH_TTL_SECONDS = 30 * 24 * 3600;
16
+ /** An error from easybill's OAuth endpoints. `permanent` means: the person has to reconnect. */
17
+ export class UpstreamOAuthError extends Error {
18
+ code;
19
+ permanent;
20
+ constructor(message, code, permanent) {
21
+ super(message);
22
+ this.code = code;
23
+ this.permanent = permanent;
24
+ this.name = "UpstreamOAuthError";
25
+ }
26
+ }
27
+ /** The connection is gone for good; tool calls should tell the model to get a reconnect link. */
28
+ export class ReconnectRequiredError extends Error {
29
+ tenantId;
30
+ constructor(tenantId, reason) {
31
+ super(`The connection to the easybill account '${tenantId}' is no longer valid (${reason}). ` +
32
+ `Call easybill_list_accounts and give the user the link to reconnect it.`);
33
+ this.tenantId = tenantId;
34
+ this.name = "ReconnectRequiredError";
35
+ }
36
+ }
37
+ export function pkcePair() {
38
+ const verifier = randomBytes(32).toString("base64url");
39
+ const challenge = createHash("sha256").update(verifier).digest("base64url");
40
+ return { verifier, challenge };
41
+ }
42
+ /** Reads a JWT's claims without verifying it — only for tokens we just got from easybill over TLS. */
43
+ export function decodeJwtClaims(token) {
44
+ const part = token.split(".")[1];
45
+ if (!part)
46
+ return {};
47
+ try {
48
+ const claims = JSON.parse(Buffer.from(part, "base64url").toString("utf8"));
49
+ return claims && typeof claims === "object" ? claims : {};
50
+ }
51
+ catch {
52
+ return {};
53
+ }
54
+ }
55
+ const userAgent = `${SERVER_NAME}/${SERVER_VERSION}`;
56
+ export class EasybillOAuth {
57
+ config;
58
+ store;
59
+ redirectUri;
60
+ metadata;
61
+ clientId;
62
+ clientSecret;
63
+ constructor(config, store) {
64
+ this.config = config;
65
+ this.store = store;
66
+ this.redirectUri = `${config.publicUrl.href.replace(/\/+$/, "")}/connect/callback`;
67
+ }
68
+ /** Discovers easybill's endpoints and makes sure we have a client registration. */
69
+ async init() {
70
+ const { issuer } = this.config.upstream;
71
+ const response = await fetch(`${issuer}/.well-known/oauth-authorization-server`, {
72
+ headers: { Accept: "application/json", "User-Agent": userAgent },
73
+ signal: AbortSignal.timeout(TIMEOUT_MS),
74
+ });
75
+ if (!response.ok) {
76
+ throw new Error(`easybill OAuth metadata at ${issuer} answered ${response.status}`);
77
+ }
78
+ const metadata = (await response.json());
79
+ if (!metadata.authorization_endpoint || !metadata.token_endpoint) {
80
+ throw new Error(`easybill OAuth metadata at ${issuer} lacks authorization/token endpoints`);
81
+ }
82
+ this.metadata = metadata;
83
+ await this.ensureClient();
84
+ }
85
+ get endpoints() {
86
+ if (!this.metadata)
87
+ throw new Error("EasybillOAuth.init() has not run");
88
+ return this.metadata;
89
+ }
90
+ async ensureClient() {
91
+ const { clientId, clientSecret } = this.config.upstream;
92
+ if (clientId) {
93
+ this.clientId = clientId;
94
+ if (clientSecret)
95
+ this.clientSecret = clientSecret;
96
+ return;
97
+ }
98
+ // Registered earlier for this redirect URI? Re-registering on every start
99
+ // would litter easybill with clients.
100
+ const metaKey = `upstream_client:${this.config.upstream.issuer}:${this.redirectUri}`;
101
+ const stored = this.store.getMeta(metaKey);
102
+ if (stored) {
103
+ this.clientId = stored;
104
+ const secret = this.store.getSecretMeta(`${metaKey}:secret`);
105
+ if (secret)
106
+ this.clientSecret = secret;
107
+ return;
108
+ }
109
+ const registration = this.endpoints.registration_endpoint;
110
+ if (!registration) {
111
+ throw new Error("easybill offers no dynamic client registration — set EASYBILL_OAUTH_CLIENT_ID (and _SECRET) instead");
112
+ }
113
+ const allScopes = [...new Set(this.config.tenants.flatMap((t) => t.scopes))].join(" ");
114
+ const register = async (authMethod) => fetch(registration, {
115
+ method: "POST",
116
+ headers: { "Content-Type": "application/json", Accept: "application/json", "User-Agent": userAgent },
117
+ body: JSON.stringify({
118
+ client_name: `easybill MCP (${this.config.publicUrl.host})`,
119
+ redirect_uris: [this.redirectUri],
120
+ grant_types: ["authorization_code", "refresh_token"],
121
+ response_types: ["code"],
122
+ token_endpoint_auth_method: authMethod,
123
+ scope: allScopes,
124
+ }),
125
+ signal: AbortSignal.timeout(TIMEOUT_MS),
126
+ });
127
+ // A confidential client is preferable; fall back to a public one if refused.
128
+ let response = await register("client_secret_post");
129
+ if (!response.ok)
130
+ response = await register("none");
131
+ const text = await response.text();
132
+ if (!response.ok) {
133
+ // easybill only allows dynamic registration for an allowlist of redirect
134
+ // URIs (claude.ai and similar); a self-hosted callback needs a client
135
+ // issued by easybill support.
136
+ throw new Error(`easybill refused to register an OAuth client for ${this.redirectUri} (${response.status}: ${text.slice(0, 300)}). ` +
137
+ `easybill only allows dynamic registration for known redirect URIs. Ask easybill support for an OAuth client ` +
138
+ `with this redirect URI and set EASYBILL_OAUTH_CLIENT_ID and EASYBILL_OAUTH_CLIENT_SECRET.`);
139
+ }
140
+ const body = JSON.parse(text);
141
+ if (!body.client_id)
142
+ throw new Error("easybill client registration returned no client_id");
143
+ this.clientId = body.client_id;
144
+ this.store.setMeta(metaKey, body.client_id);
145
+ if (body.client_secret) {
146
+ this.clientSecret = body.client_secret;
147
+ this.store.setSecretMeta(`${metaKey}:secret`, body.client_secret);
148
+ }
149
+ console.error(`Registered OAuth client ${body.client_id} with easybill (redirect ${this.redirectUri})`);
150
+ }
151
+ authorizationUrl(state, codeChallenge, scopes) {
152
+ const url = new URL(this.endpoints.authorization_endpoint);
153
+ url.searchParams.set("response_type", "code");
154
+ url.searchParams.set("client_id", this.clientId);
155
+ url.searchParams.set("redirect_uri", this.redirectUri);
156
+ url.searchParams.set("scope", scopes.join(" "));
157
+ url.searchParams.set("state", state);
158
+ url.searchParams.set("code_challenge", codeChallenge);
159
+ url.searchParams.set("code_challenge_method", "S256");
160
+ return url.href;
161
+ }
162
+ exchangeCode(code, codeVerifier) {
163
+ return this.tokenRequest({
164
+ grant_type: "authorization_code",
165
+ code,
166
+ redirect_uri: this.redirectUri,
167
+ code_verifier: codeVerifier,
168
+ });
169
+ }
170
+ refresh(refreshToken) {
171
+ return this.tokenRequest({ grant_type: "refresh_token", refresh_token: refreshToken });
172
+ }
173
+ async tokenRequest(params) {
174
+ const body = new URLSearchParams({ ...params, client_id: this.clientId });
175
+ if (this.clientSecret)
176
+ body.set("client_secret", this.clientSecret);
177
+ let response;
178
+ try {
179
+ response = await fetch(this.endpoints.token_endpoint, {
180
+ method: "POST",
181
+ headers: {
182
+ "Content-Type": "application/x-www-form-urlencoded",
183
+ Accept: "application/json",
184
+ "User-Agent": userAgent,
185
+ },
186
+ body: body.toString(),
187
+ signal: AbortSignal.timeout(TIMEOUT_MS),
188
+ });
189
+ }
190
+ catch (error) {
191
+ throw new UpstreamOAuthError(`easybill token endpoint unreachable: ${error instanceof Error ? error.message : String(error)}`, "network", false);
192
+ }
193
+ const text = await response.text();
194
+ let json = {};
195
+ try {
196
+ json = JSON.parse(text);
197
+ }
198
+ catch {
199
+ // handled below
200
+ }
201
+ if (!response.ok) {
202
+ const code = typeof json.error === "string" ? json.error : `http_${response.status}`;
203
+ const description = typeof json.error_description === "string" ? json.error_description : json.message ?? text.slice(0, 200);
204
+ // invalid_grant / invalid_request on a refresh: the refresh token is dead.
205
+ const permanent = response.status === 400 || response.status === 401;
206
+ throw new UpstreamOAuthError(`easybill refused the token request: ${code} ${description}`.trim(), code, permanent);
207
+ }
208
+ const accessToken = json.access_token;
209
+ const refreshToken = json.refresh_token ?? params.refresh_token;
210
+ if (typeof accessToken !== "string" || typeof refreshToken !== "string") {
211
+ throw new UpstreamOAuthError("easybill token response lacks access_token/refresh_token", "bad_response", false);
212
+ }
213
+ const now = Math.floor(Date.now() / 1000);
214
+ const expiresIn = typeof json.expires_in === "number" ? json.expires_in : 3600;
215
+ return {
216
+ access_token: accessToken,
217
+ refresh_token: refreshToken,
218
+ access_expires_at: now + expiresIn,
219
+ refresh_expires_at: now + UPSTREAM_REFRESH_TTL_SECONDS,
220
+ };
221
+ }
222
+ }
223
+ /**
224
+ * Hands out a valid easybill access token per (grant, tenant), refreshing when
225
+ * it is about to expire. Concurrent callers share one refresh: easybill rotates
226
+ * refresh tokens, so two parallel refreshes would invalidate each other.
227
+ */
228
+ export class ConnectionTokens {
229
+ store;
230
+ oauth;
231
+ inflight = new Map();
232
+ constructor(store,
233
+ /** Absent in API-key mode. */
234
+ oauth) {
235
+ this.store = store;
236
+ this.oauth = oauth;
237
+ }
238
+ async accessToken(grantId, tenantId, forceRefresh = false) {
239
+ const connection = this.store.getConnection(grantId, tenantId);
240
+ if (!connection)
241
+ throw new ReconnectRequiredError(tenantId, "not connected");
242
+ if (connection.broken_reason)
243
+ throw new ReconnectRequiredError(tenantId, connection.broken_reason);
244
+ // A personal API key does not expire on a schedule; a 401 means it was
245
+ // regenerated or the login removed, and only the person can fix that.
246
+ if (connection.auth_kind === "apikey") {
247
+ if (!forceRefresh)
248
+ return connection.access_token;
249
+ const reason = "easybill rejected the API key — it was probably regenerated or the login removed";
250
+ this.store.markConnectionBroken(grantId, tenantId, reason);
251
+ throw new ReconnectRequiredError(tenantId, reason);
252
+ }
253
+ const now = Math.floor(Date.now() / 1000);
254
+ if (!forceRefresh && connection.access_expires_at - 60 > now)
255
+ return connection.access_token;
256
+ const key = `${grantId}\u0000${tenantId}`;
257
+ const running = this.inflight.get(key);
258
+ if (running)
259
+ return running;
260
+ const refresh = (async () => {
261
+ try {
262
+ if (!this.oauth)
263
+ throw new ReconnectRequiredError(tenantId, "easybill OAuth is not configured on this server");
264
+ const tokens = await this.oauth.refresh(connection.refresh_token);
265
+ this.store.updateConnectionTokens(grantId, tenantId, tokens);
266
+ return tokens.access_token;
267
+ }
268
+ catch (error) {
269
+ if (error instanceof UpstreamOAuthError && error.permanent) {
270
+ this.store.markConnectionBroken(grantId, tenantId, "login expired or access revoked in easybill");
271
+ throw new ReconnectRequiredError(tenantId, "login expired or access revoked in easybill");
272
+ }
273
+ throw error;
274
+ }
275
+ })().finally(() => this.inflight.delete(key));
276
+ this.inflight.set(key, refresh);
277
+ return refresh;
278
+ }
279
+ }
280
+ //# sourceMappingURL=upstream.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upstream.js","sourceRoot":"","sources":["../../src/hosted/upstream.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -5,7 +5,11 @@
5
5
  * Exposes invoices and other documents, customers, contacts, the article
6
6
  * catalogue, payments, projects, time tracking, attachments and templates.
7
7
  *
8
- * Transport: stdio (local). Never log to stdout — it carries the MCP protocol.
8
+ * Transports:
9
+ * stdio (default, local) — one easybill account via EASYBILL_API_KEY.
10
+ * Never log to stdout — it carries the MCP protocol.
11
+ * --http (hosted) — Streamable HTTP + OAuth for remote connectors such as
12
+ * claude.ai; people connect their own easybill accounts. See src/hosted/.
9
13
  *
10
14
  * Environment:
11
15
  * EASYBILL_API_KEY (required)