@3ngram/server 0.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 (116) hide show
  1. package/LICENSE +202 -0
  2. package/dist/app.d.ts +72 -0
  3. package/dist/app.js +273 -0
  4. package/dist/app.js.map +1 -0
  5. package/dist/boot.d.ts +37 -0
  6. package/dist/boot.js +53 -0
  7. package/dist/boot.js.map +1 -0
  8. package/dist/composition/extension.d.ts +50 -0
  9. package/dist/composition/extension.js +16 -0
  10. package/dist/composition/extension.js.map +1 -0
  11. package/dist/index.d.ts +1 -0
  12. package/dist/index.js +10 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/links.d.ts +17 -0
  15. package/dist/links.js +46 -0
  16. package/dist/links.js.map +1 -0
  17. package/dist/mailer.d.ts +58 -0
  18. package/dist/mailer.js +187 -0
  19. package/dist/mailer.js.map +1 -0
  20. package/dist/mcp/errors.d.ts +14 -0
  21. package/dist/mcp/errors.js +175 -0
  22. package/dist/mcp/errors.js.map +1 -0
  23. package/dist/mcp/prompts.d.ts +29 -0
  24. package/dist/mcp/prompts.js +180 -0
  25. package/dist/mcp/prompts.js.map +1 -0
  26. package/dist/mcp/server.d.ts +14 -0
  27. package/dist/mcp/server.js +34 -0
  28. package/dist/mcp/server.js.map +1 -0
  29. package/dist/mcp/tools-admin.d.ts +8 -0
  30. package/dist/mcp/tools-admin.js +260 -0
  31. package/dist/mcp/tools-admin.js.map +1 -0
  32. package/dist/mcp/tools-orient.d.ts +6 -0
  33. package/dist/mcp/tools-orient.js +110 -0
  34. package/dist/mcp/tools-orient.js.map +1 -0
  35. package/dist/mcp/tools.d.ts +88 -0
  36. package/dist/mcp/tools.js +375 -0
  37. package/dist/mcp/tools.js.map +1 -0
  38. package/dist/middleware/api-key.d.ts +13 -0
  39. package/dist/middleware/api-key.js +83 -0
  40. package/dist/middleware/api-key.js.map +1 -0
  41. package/dist/middleware/api-or-session.d.ts +9 -0
  42. package/dist/middleware/api-or-session.js +22 -0
  43. package/dist/middleware/api-or-session.js.map +1 -0
  44. package/dist/middleware/authenticate.d.ts +21 -0
  45. package/dist/middleware/authenticate.js +51 -0
  46. package/dist/middleware/authenticate.js.map +1 -0
  47. package/dist/middleware/index.d.ts +1 -0
  48. package/dist/middleware/index.js +9 -0
  49. package/dist/middleware/index.js.map +1 -0
  50. package/dist/middleware/oauth-bearer.d.ts +8 -0
  51. package/dist/middleware/oauth-bearer.js +117 -0
  52. package/dist/middleware/oauth-bearer.js.map +1 -0
  53. package/dist/middleware/rate-limit.d.ts +58 -0
  54. package/dist/middleware/rate-limit.js +139 -0
  55. package/dist/middleware/rate-limit.js.map +1 -0
  56. package/dist/middleware/request-context.d.ts +7 -0
  57. package/dist/middleware/request-context.js +14 -0
  58. package/dist/middleware/request-context.js.map +1 -0
  59. package/dist/output-validation.d.ts +18 -0
  60. package/dist/output-validation.js +30 -0
  61. package/dist/output-validation.js.map +1 -0
  62. package/dist/redis.d.ts +9 -0
  63. package/dist/redis.js +37 -0
  64. package/dist/redis.js.map +1 -0
  65. package/dist/rest/cursor.d.ts +14 -0
  66. package/dist/rest/cursor.js +38 -0
  67. package/dist/rest/cursor.js.map +1 -0
  68. package/dist/rest/errors.d.ts +14 -0
  69. package/dist/rest/errors.js +119 -0
  70. package/dist/rest/errors.js.map +1 -0
  71. package/dist/rest/router.d.ts +33 -0
  72. package/dist/rest/router.js +846 -0
  73. package/dist/rest/router.js.map +1 -0
  74. package/dist/rest/scope.d.ts +14 -0
  75. package/dist/rest/scope.js +45 -0
  76. package/dist/rest/scope.js.map +1 -0
  77. package/dist/routes/api-keys.d.ts +2 -0
  78. package/dist/routes/api-keys.js +77 -0
  79. package/dist/routes/api-keys.js.map +1 -0
  80. package/dist/routes/auth.d.ts +20 -0
  81. package/dist/routes/auth.js +325 -0
  82. package/dist/routes/auth.js.map +1 -0
  83. package/dist/routes/capabilities.d.ts +10 -0
  84. package/dist/routes/capabilities.js +17 -0
  85. package/dist/routes/capabilities.js.map +1 -0
  86. package/dist/routes/health.d.ts +7 -0
  87. package/dist/routes/health.js +12 -0
  88. package/dist/routes/health.js.map +1 -0
  89. package/dist/routes/mcp.d.ts +27 -0
  90. package/dist/routes/mcp.js +81 -0
  91. package/dist/routes/mcp.js.map +1 -0
  92. package/dist/routes/oauth-authorize.d.ts +8 -0
  93. package/dist/routes/oauth-authorize.js +245 -0
  94. package/dist/routes/oauth-authorize.js.map +1 -0
  95. package/dist/routes/oauth-clients.d.ts +2 -0
  96. package/dist/routes/oauth-clients.js +59 -0
  97. package/dist/routes/oauth-clients.js.map +1 -0
  98. package/dist/routes/oauth-register.d.ts +8 -0
  99. package/dist/routes/oauth-register.js +59 -0
  100. package/dist/routes/oauth-register.js.map +1 -0
  101. package/dist/routes/oauth-token.d.ts +30 -0
  102. package/dist/routes/oauth-token.js +451 -0
  103. package/dist/routes/oauth-token.js.map +1 -0
  104. package/dist/routes/onboarding.d.ts +2 -0
  105. package/dist/routes/onboarding.js +47 -0
  106. package/dist/routes/onboarding.js.map +1 -0
  107. package/dist/routes/profile.d.ts +2 -0
  108. package/dist/routes/profile.js +35 -0
  109. package/dist/routes/profile.js.map +1 -0
  110. package/dist/routes/well-known.d.ts +2 -0
  111. package/dist/routes/well-known.js +77 -0
  112. package/dist/routes/well-known.js.map +1 -0
  113. package/dist/version.d.ts +1 -0
  114. package/dist/version.js +17 -0
  115. package/dist/version.js.map +1 -0
  116. package/package.json +67 -0
@@ -0,0 +1,77 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // OAuth resource-server discovery transport. Thin by contract:
3
+ // read the validated OAuth config, derive/serve metadata, no business
4
+ // logic. Three documents, all public (no auth — they are discovery surfaces):
5
+ //
6
+ // GET /.well-known/jwks.json
7
+ // The PUBLIC verification keys (RFC 7517). Derived from the env private key
8
+ // array via core's derivePublicJwks — private material (`d`/`p`/`q`/...) is
9
+ // NEVER serialized here (ADR-0009 impl req 2).
10
+ //
11
+ // GET /.well-known/oauth-protected-resource (bare)
12
+ // GET /.well-known/oauth-protected-resource/mcp (RFC 9728 path-suffixed)
13
+ // Protected-resource metadata (RFC 9728): advertises the resource id + its
14
+ // authorization server (the issuer). RFC 9728 derives the well-known path
15
+ // from the resource's own path, so the body served at each location must
16
+ // name the resource that location is the discovery surface for: the bare
17
+ // path is the discovery location for the ROOT resource (the issuer origin),
18
+ // the `/mcp`-suffixed path is the discovery location for the `/mcp`
19
+ // resource. A strict client discards a body whose `resource` does not match
20
+ // the location it probed, so the two surfaces advertise different ids.
21
+ //
22
+ // loadOAuthConfig() fails fast at boot when keys/issuer are missing or invalid,
23
+ // so these handlers can assume a well-formed config.
24
+ import { loadOAuthConfig } from '@3ngram/config';
25
+ import { derivePublicJwks, MEMORY_READ_SCOPE, MEMORY_WRITE_SCOPE } from '@3ngram/core/auth';
26
+ import { Router } from 'express';
27
+ export const wellKnownRouter = Router();
28
+ wellKnownRouter.get('/.well-known/jwks.json', (_req, res) => {
29
+ const config = loadOAuthConfig();
30
+ res.status(200).json(derivePublicJwks(config.keys));
31
+ });
32
+ /** RFC 9728 protected-resource metadata: resource id + its authorization server. */
33
+ function protectedResourceMetadata(resource) {
34
+ const config = loadOAuthConfig();
35
+ return {
36
+ resource,
37
+ authorization_servers: [config.issuer],
38
+ };
39
+ }
40
+ // Bare path = discovery location for the ROOT resource (the issuer origin, no
41
+ // trailing slash). The issuer is normalized with a trailing slash; the root
42
+ // resource id drops it so a strict client's location/resource match holds.
43
+ wellKnownRouter.get('/.well-known/oauth-protected-resource', (_req, res) => {
44
+ const config = loadOAuthConfig();
45
+ const rootResource = config.issuer.replace(/\/$/, '');
46
+ res.status(200).json(protectedResourceMetadata(rootResource));
47
+ });
48
+ // Path-suffixed form (RFC 9728): discovery location for the `/mcp` resource.
49
+ // Advertises the `/mcp` resource id so a strict client's location/resource
50
+ // match holds.
51
+ wellKnownRouter.get('/.well-known/oauth-protected-resource/mcp', (_req, res) => {
52
+ const config = loadOAuthConfig();
53
+ res.status(200).json(protectedResourceMetadata(config.resource));
54
+ });
55
+ // RFC 8414 authorization-server metadata.
56
+ // MIRRORS the SDK router's createOAuthMetadata shape (the SDK auth router is
57
+ // not mounted — its token handler's plaintext client auth cannot work against
58
+ // hashed-at-rest secrets, so the endpoints are served by our own thin routes).
59
+ // `issuer` is the loadOAuthConfig().issuer string VERBATIM — the exact value
60
+ // the RS discovery documents advertise as authorization_servers[0] and the
61
+ // exact `iss` minted into access tokens, so a strict client's issuer
62
+ // consistency check holds across all three surfaces.
63
+ wellKnownRouter.get('/.well-known/oauth-authorization-server', (_req, res) => {
64
+ const config = loadOAuthConfig();
65
+ res.status(200).json({
66
+ issuer: config.issuer,
67
+ authorization_endpoint: new URL('/oauth/authorize', config.issuer).href,
68
+ token_endpoint: new URL('/oauth/token', config.issuer).href,
69
+ registration_endpoint: new URL('/oauth/register', config.issuer).href,
70
+ response_types_supported: ['code'],
71
+ grant_types_supported: ['authorization_code', 'refresh_token'],
72
+ code_challenge_methods_supported: ['S256'],
73
+ token_endpoint_auth_methods_supported: ['client_secret_post', 'client_secret_basic', 'none'],
74
+ scopes_supported: [MEMORY_READ_SCOPE, MEMORY_WRITE_SCOPE],
75
+ });
76
+ });
77
+ //# sourceMappingURL=well-known.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"well-known.js","sourceRoot":"","sources":["../../src/routes/well-known.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export declare const SERVER_VERSION: string;
@@ -0,0 +1,17 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ // Single source of truth for the server version. Derived from
3
+ // apps/server/package.json at runtime so the MCP `initialize` result
4
+ // (mcp/server.ts) and `describe_environment` (mcp/tools-admin.ts) ALWAYS equal
5
+ // the published package version and cannot skew at a release (previously two
6
+ // hardcoded '0.0.0' literals that went stale the moment package.json bumped).
7
+ //
8
+ // Safe to read at runtime here: the build is plain `tsc` (no bundler), so
9
+ // package.json ships beside dist/ and resolves relative to this module's
10
+ // compiled location — dist/version.js -> ../package.json, and equally
11
+ // src/version.ts -> ../package.json under the test runner. A static
12
+ // `import ... with { type: 'json' }` is NOT used because package.json sits
13
+ // outside tsconfig `rootDir` ("src"), which would break the dist layout.
14
+ import { readFileSync } from 'node:fs';
15
+ const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
16
+ export const SERVER_VERSION = packageJson.version;
17
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,8DAA8D;AAC9D,qEAAqE;AACrE,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,yEAAyE;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAC3C,CAAA;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,CAAA"}
package/package.json ADDED
@@ -0,0 +1,67 @@
1
+ {
2
+ "name": "@3ngram/server",
3
+ "version": "0.7.0",
4
+ "description": "REST API + MCP server — the one v1 deployable (monorepo-layout.md).",
5
+ "license": "Apache-2.0",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/B3dmar/3ngram.git",
9
+ "directory": "apps/server"
10
+ },
11
+ "publishConfig": {
12
+ "access": "public"
13
+ },
14
+ "type": "module",
15
+ "comment:exports": "Side-effect-free seams ONLY. `./app` exposes createApp so a downstream composition root can compose the server; `./boot` exposes the shared fail-closed bootstrap() (initObservability -> loadEnv -> metered-op + OAuth key checks -> dynamic-import createApp + listen) so both entrypoints run the IDENTICAL boot and cannot drift. `./mailer` exposes the SMTP sender (loadSmtpConfig + nodemailer, degrade-to-noop) so one mail transport is reused for dunning instead of re-wiring nodemailer. Importing any of these has NO side effects -- transports/boot run only when their function is called. src/index.ts stays the sole side-effectful entry and is intentionally NOT exported.",
16
+ "exports": {
17
+ "./app": {
18
+ "types": "./dist/app.d.ts",
19
+ "default": "./dist/app.js"
20
+ },
21
+ "./boot": {
22
+ "types": "./dist/boot.d.ts",
23
+ "default": "./dist/boot.js"
24
+ },
25
+ "./middleware": {
26
+ "types": "./dist/middleware/index.d.ts",
27
+ "default": "./dist/middleware/index.js"
28
+ },
29
+ "./mailer": {
30
+ "types": "./dist/mailer.d.ts",
31
+ "default": "./dist/mailer.js"
32
+ }
33
+ },
34
+ "files": [
35
+ "dist"
36
+ ],
37
+ "dependencies": {
38
+ "@modelcontextprotocol/sdk": "1.29.0",
39
+ "express": "5.2.1",
40
+ "ioredis": "5.11.1",
41
+ "nodemailer": "9.0.0",
42
+ "rate-limiter-flexible": "11.2.0",
43
+ "zod": "4.4.3",
44
+ "@3ngram/config": "0.2.0",
45
+ "@3ngram/core": "0.4.0",
46
+ "@3ngram/llm": "0.2.0",
47
+ "@3ngram/schema": "0.4.0"
48
+ },
49
+ "devDependencies": {
50
+ "@types/express": "5.0.6",
51
+ "@types/node": "25.9.1",
52
+ "@types/nodemailer": "8.0.1",
53
+ "ioredis-mock": "8.13.1",
54
+ "tsx": "4.22.4",
55
+ "typescript": "6.0.3",
56
+ "vitest": "4.1.8"
57
+ },
58
+ "scripts": {
59
+ "build": "tsc -p tsconfig.json",
60
+ "check": "tsc -p tsconfig.json --noEmit",
61
+ "test": "vitest run --exclude '**/integration/**' --fileParallelism=false --testTimeout=15000 --hookTimeout=30000",
62
+ "test:integration": "vitest run test/integration --fileParallelism=false --testTimeout=30000",
63
+ "docs:generate": "tsx scripts/generate-openapi.ts && tsx scripts/generate-mcp-reference.ts && tsx ../../apps/cli/scripts/generate-cli-reference.ts && tsx ../../packages/sdk/scripts/generate-sdk-reference.ts",
64
+ "dev": "node --watch dist/index.js",
65
+ "start": "node dist/index.js"
66
+ }
67
+ }