@terreno/api 57.19.2 → 57.21.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.
- package/CHANGELOG.md +443 -0
- package/biome.jsonc +1 -0
- package/dist/accountSecurity/accessActions.d.ts +38 -0
- package/dist/accountSecurity/accessActions.js +157 -0
- package/dist/accountSecurity/accountSecurityApp.d.ts +219 -0
- package/dist/accountSecurity/accountSecurityApp.js +438 -0
- package/dist/accountSecurity/accountSecurityService.d.ts +200 -0
- package/dist/accountSecurity/accountSecurityService.js +481 -0
- package/dist/accountSecurity/credentialActions.d.ts +16 -0
- package/dist/accountSecurity/credentialActions.js +189 -0
- package/dist/accountSecurity/membershipActions.d.ts +15 -0
- package/dist/accountSecurity/membershipActions.js +81 -0
- package/dist/accountSecurity/orgSecurityRoutes.d.ts +50 -0
- package/dist/accountSecurity/orgSecurityRoutes.js +149 -0
- package/dist/accountSecurity/securityEventHooks.d.ts +44 -0
- package/dist/accountSecurity/securityEventHooks.js +223 -0
- package/dist/accountSecurity/securityEvents.d.ts +162 -0
- package/dist/accountSecurity/securityEvents.js +114 -0
- package/dist/accountSecurity/securityNotifications.d.ts +125 -0
- package/dist/accountSecurity/securityNotifications.js +333 -0
- package/dist/api.d.ts +3 -3
- package/dist/api.js +38 -6
- package/dist/audit/auditEventModel.d.ts +5 -3
- package/dist/audit/auditEventModel.js +8 -6
- package/dist/audit/processQueue.js +4 -2
- package/dist/audit/record.d.ts +2 -2
- package/dist/audit/record.js +3 -0
- package/dist/authRecovery.js +29 -1
- package/dist/betterAuth.d.ts +179 -10
- package/dist/betterAuthApp.d.ts +15 -0
- package/dist/betterAuthApp.js +23 -0
- package/dist/betterAuthChallengeHeaders.d.ts +37 -0
- package/dist/betterAuthChallengeHeaders.js +180 -0
- package/dist/betterAuthFeatures.d.ts +54 -0
- package/dist/betterAuthFeatures.js +239 -0
- package/dist/betterAuthMethods.d.ts +73 -0
- package/dist/betterAuthMethods.js +55 -0
- package/dist/betterAuthOAuthHandoff.d.ts +10 -2
- package/dist/betterAuthOAuthHandoff.js +222 -24
- package/dist/betterAuthSetPassword.d.ts +33 -0
- package/dist/betterAuthSetPassword.js +166 -0
- package/dist/betterAuthSetup.d.ts +57 -8
- package/dist/betterAuthSetup.js +327 -36
- package/dist/consentApp.d.ts +9 -4
- package/dist/consentApp.js +344 -28
- package/dist/consentStatus.d.ts +60 -0
- package/dist/consentStatus.js +111 -0
- package/dist/errors.d.ts +6 -0
- package/dist/errors.js +41 -2
- package/dist/expressServer.js +3 -2
- package/dist/frameworkModelNames.d.ts +4 -0
- package/dist/frameworkModelNames.js +4 -0
- package/dist/index.d.ts +18 -2
- package/dist/index.js +29 -3
- package/dist/mcp/adminTracking.d.ts +28 -0
- package/dist/mcp/adminTracking.js +80 -0
- package/dist/mcp/auth.d.ts +6 -0
- package/dist/mcp/auth.js +12 -2
- package/dist/mcp/oauth.js +151 -11
- package/dist/mcp/oauthMetadata.d.ts +2 -1
- package/dist/mcp/oauthMetadata.js +7 -4
- package/dist/mcp/server.d.ts +8 -0
- package/dist/mcp/server.js +48 -4
- package/dist/models/consentResponse.js +51 -0
- package/dist/models/mcpOAuthClient.js +78 -2
- package/dist/models/mcpOAuthToken.js +55 -4
- package/dist/models/mcpRequestLog.d.ts +2 -0
- package/dist/models/mcpRequestLog.js +73 -0
- package/dist/models/mcpServiceToken.js +4 -0
- package/dist/models/mcpToolSetting.d.ts +2 -0
- package/dist/models/mcpToolSetting.js +119 -0
- package/dist/models/versionConfig.d.ts +2 -0
- package/dist/orgs/membershipGuards.d.ts +7 -0
- package/dist/orgs/membershipGuards.js +32 -0
- package/dist/orgs/orgsApp.d.ts +19 -1
- package/dist/orgs/orgsApp.js +55 -24
- package/dist/rateLimit/policies.js +8 -0
- package/dist/rbac/access.js +2 -1
- package/dist/rbac/auditModel.d.ts +2 -1
- package/dist/rbac/resolve.d.ts +9 -1
- package/dist/rbac/resolve.js +21 -16
- package/dist/rbac/roleManager.d.ts +6 -0
- package/dist/rbac/roleManager.js +8 -7
- package/dist/rbac/roleModel.d.ts +1 -0
- package/dist/rbac/roleModel.js +45 -3
- package/dist/rbac/statements.d.ts +2 -2
- package/dist/rbac/statements.js +10 -1
- package/dist/rbac/types.d.ts +6 -0
- package/dist/rbac/userWriteGuards.js +2 -1
- package/dist/schemaMetadata.js +8 -1
- package/dist/seedRunner.js +7 -2
- package/dist/terrenoApp.d.ts +16 -0
- package/dist/terrenoApp.js +18 -0
- package/dist/tests/models.d.ts +22 -22
- package/dist/tests/models.js +15 -1
- package/dist/tests/testHelper.d.ts +6 -12
- package/dist/tests.d.ts +1 -0
- package/dist/tests.js +3 -1
- package/dist/types/consentResponse.d.ts +8 -0
- package/dist/types/mcpAdmin.d.ts +58 -0
- package/dist/types/mcpAdmin.js +2 -0
- package/dist/types/mcpOAuth.d.ts +37 -2
- package/dist/types/mcpServiceToken.d.ts +2 -0
- package/e2e/smoke.ts +193 -0
- package/package.json +10 -5
- package/src/__snapshots__/openApi.test.ts.snap +288 -0
- package/src/__snapshots__/openApiBuilder.test.ts.snap +96 -0
- package/src/accountSecurity/accessActions.test.ts +723 -0
- package/src/accountSecurity/accessActions.ts +173 -0
- package/src/accountSecurity/accountSecurity.test.ts +947 -0
- package/src/accountSecurity/accountSecurityApp.ts +720 -0
- package/src/accountSecurity/accountSecurityService.ts +826 -0
- package/src/accountSecurity/credentialActions.test.ts +867 -0
- package/src/accountSecurity/credentialActions.ts +260 -0
- package/src/accountSecurity/membershipActions.ts +89 -0
- package/src/accountSecurity/orgSecurityRoutes.test.ts +841 -0
- package/src/accountSecurity/orgSecurityRoutes.ts +232 -0
- package/src/accountSecurity/securityEventHooks.ts +294 -0
- package/src/accountSecurity/securityEvents.ts +165 -0
- package/src/accountSecurity/securityNotifications.test.ts +1323 -0
- package/src/accountSecurity/securityNotifications.ts +516 -0
- package/src/adminModelRouter.test.ts +8 -6
- package/src/api.arrayOperations.test.ts +102 -22
- package/src/api.hooks.test.ts +12 -11
- package/src/api.query.test.ts +2 -2
- package/src/api.test.ts +8 -7
- package/src/api.ts +41 -10
- package/src/audit/auditApp.test.ts +1 -1
- package/src/audit/auditEventModel.ts +10 -7
- package/src/audit/cloudTasksEnqueue.test.ts +19 -14
- package/src/audit/processQueue.ts +4 -2
- package/src/audit/record.test.ts +15 -0
- package/src/audit/record.ts +10 -2
- package/src/auth.test.ts +21 -7
- package/src/authRecovery.test.ts +33 -10
- package/src/authRecovery.ts +34 -1
- package/src/authRecoveryBetterAuth.test.ts +169 -0
- package/src/authVerification.test.ts +7 -7
- package/src/betterAuth.ts +194 -8
- package/src/betterAuthApp.ts +32 -0
- package/src/betterAuthChallengeHeaders.test.ts +476 -0
- package/src/betterAuthChallengeHeaders.ts +227 -0
- package/src/betterAuthFeatures.test.ts +490 -0
- package/src/betterAuthFeatures.ts +283 -0
- package/src/betterAuthLinking.test.ts +846 -0
- package/src/betterAuthMethods.test.ts +138 -0
- package/src/betterAuthMethods.ts +98 -0
- package/src/betterAuthOAuthHandoff.test.ts +482 -69
- package/src/betterAuthOAuthHandoff.ts +293 -33
- package/src/betterAuthOAuthProxy.test.ts +421 -0
- package/src/betterAuthPasswordReset.test.ts +190 -0
- package/src/betterAuthSetPassword.test.ts +378 -0
- package/src/betterAuthSetPassword.ts +213 -0
- package/src/betterAuthSetup.test.ts +115 -57
- package/src/betterAuthSetup.ts +457 -38
- package/src/collectionRegistry.test.ts +4 -4
- package/src/consentApp.test.ts +869 -2
- package/src/consentApp.ts +438 -36
- package/src/consentStatus.test.ts +226 -0
- package/src/consentStatus.ts +171 -0
- package/src/errors.test.ts +81 -0
- package/src/errors.ts +50 -1
- package/src/expressServer.test.ts +29 -0
- package/src/expressServer.ts +3 -2
- package/src/frameworkModelNames.test.ts +8 -0
- package/src/frameworkModelNames.ts +4 -0
- package/src/githubAuth.test.ts +11 -11
- package/src/index.ts +38 -0
- package/src/isolated/migrateCliConnect.isolated.ts +3 -2
- package/src/mcp/actionTools.test.ts +11 -5
- package/src/mcp/adminTracking.test.ts +272 -0
- package/src/mcp/adminTracking.ts +104 -0
- package/src/mcp/auth.ts +18 -2
- package/src/mcp/oauth.test.ts +463 -2
- package/src/mcp/oauth.ts +184 -13
- package/src/mcp/oauthMetadata.ts +5 -2
- package/src/mcp/server.ts +67 -4
- package/src/mcp/serviceTokens.test.ts +2 -1
- package/src/mcp/toolGenerator.test.ts +9 -5
- package/src/migrations/cli.test.ts +15 -14
- package/src/migrations/cli.ts +1 -1
- package/src/migrations/generate.test.ts +2 -2
- package/src/migrations/load.test.ts +1 -1
- package/src/migrations/lock.test.ts +8 -3
- package/src/migrations/runner.test.ts +16 -5
- package/src/migrations/schemaCatalog.test.ts +4 -1
- package/src/models/consentResponse.ts +53 -0
- package/src/models/mcpOAuthClient.ts +100 -3
- package/src/models/mcpOAuthToken.test.ts +42 -0
- package/src/models/mcpOAuthToken.ts +62 -5
- package/src/models/mcpRequestLog.ts +81 -0
- package/src/models/mcpServiceToken.test.ts +23 -0
- package/src/models/mcpServiceToken.ts +10 -0
- package/src/models/mcpToolSetting.test.ts +69 -0
- package/src/models/mcpToolSetting.ts +138 -0
- package/src/models/versionConfig.ts +2 -0
- package/src/notifications/notificationsApp.test.ts +5 -8
- package/src/notifiers/slackWebApi.test.ts +30 -8
- package/src/openApi.test.ts +4 -4
- package/src/openApiValidator.test.ts +3 -3
- package/src/orgs/membershipGuards.ts +39 -0
- package/src/orgs/orgPermissions.test.ts +2 -2
- package/src/orgs/orgPlugin.test.ts +4 -3
- package/src/orgs/orgRbac.test.ts +1 -1
- package/src/orgs/orgSecurityDefects.test.ts +3 -1
- package/src/orgs/organizationSettings.test.ts +1 -1
- package/src/orgs/orgsApp.test.ts +104 -3
- package/src/orgs/orgsApp.ts +69 -28
- package/src/permissions.test.ts +2 -2
- package/src/rateLimit/policies.test.ts +53 -0
- package/src/rateLimit/policies.ts +8 -0
- package/src/rateLimit/redisStore.ioredis.test.ts +3 -2
- package/src/rbac/access.ts +4 -1
- package/src/rbac/assertAllowed.test.ts +1 -1
- package/src/rbac/auditModel.ts +10 -2
- package/src/rbac/realtimeAccess.test.ts +3 -2
- package/src/rbac/resolve.test.ts +65 -0
- package/src/rbac/resolve.ts +37 -17
- package/src/rbac/roleManager.test.ts +64 -0
- package/src/rbac/roleManager.ts +15 -6
- package/src/rbac/roleModel.test.ts +174 -1
- package/src/rbac/roleModel.ts +66 -3
- package/src/rbac/routes.test.ts +58 -0
- package/src/rbac/statements.test.ts +4 -1
- package/src/rbac/statements.ts +11 -1
- package/src/rbac/types.ts +6 -1
- package/src/rbac/userWriteGuards.test.ts +56 -5
- package/src/rbac/userWriteGuards.ts +5 -2
- package/src/realtime/realtime.test.ts +35 -31
- package/src/schemaMetadata.test.ts +39 -0
- package/src/schemaMetadata.ts +11 -1
- package/src/scrubAdminFields.test.ts +1 -1
- package/src/seedRunner.test.ts +56 -0
- package/src/seedRunner.ts +7 -2
- package/src/sync/adminWindowMutation.test.ts +4 -3
- package/src/sync/executors.test.ts +1 -1
- package/src/sync/scripts/compactTombstones.test.ts +4 -3
- package/src/sync/sync.test.ts +1 -1
- package/src/sync/syncPhaseC.test.ts +14 -11
- package/src/sync/syncRoutes.test.ts +8 -8
- package/src/sync/syncSeqPlugin.test.ts +1 -2
- package/src/sync/syncSocket.test.ts +5 -4
- package/src/terrenoApp.mcpServiceTokens.test.ts +2 -2
- package/src/terrenoApp.migrations.test.ts +8 -7
- package/src/terrenoApp.ts +34 -0
- package/src/tests/accountSecurityTestApp.ts +290 -0
- package/src/tests/betterAuthStubs.ts +189 -0
- package/src/tests/bunSetup.ts +1 -1
- package/src/tests/mockOidcProvider.ts +105 -0
- package/src/tests/models.ts +23 -0
- package/src/tests/softwareAuthenticator.ts +183 -0
- package/src/tests/testEnv.ts +7 -0
- package/src/tests.ts +1 -0
- package/src/types/consentResponse.ts +8 -0
- package/src/types/mcpAdmin.ts +80 -0
- package/src/types/mcpOAuth.ts +44 -3
- package/src/types/mcpServiceToken.ts +5 -0
- package/src/webhooks/verifiers/hmac.test.ts +1 -1
- package/tsconfig.typecheck.json +14 -0
package/src/types/mcpOAuth.ts
CHANGED
|
@@ -1,22 +1,49 @@
|
|
|
1
1
|
import type mongoose from "mongoose";
|
|
2
2
|
import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
|
|
3
3
|
|
|
4
|
-
|
|
4
|
+
export type McpOAuthTokenEndpointAuthMethod = "none" | "client_secret_basic" | "client_secret_post";
|
|
5
|
+
|
|
6
|
+
/** Options for `McpOAuthClient.issueConfidential`. The secret is returned once. */
|
|
7
|
+
export interface McpOAuthConfidentialClientOptions {
|
|
8
|
+
clientId?: string;
|
|
9
|
+
clientName: string;
|
|
10
|
+
scope?: string;
|
|
11
|
+
tokenEndpointAuthMethod: Exclude<McpOAuthTokenEndpointAuthMethod, "none">;
|
|
12
|
+
userId: mongoose.Types.ObjectId | string;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* A public authorization-code client, or a confidential `client_credentials` client bound to a
|
|
17
|
+
* user. Public clients leave `tokenEndpointAuthMethod` unset.
|
|
18
|
+
*/
|
|
5
19
|
export interface McpOAuthClientDocument extends mongoose.Document {
|
|
6
20
|
_id: mongoose.Types.ObjectId;
|
|
7
21
|
clientId: string;
|
|
8
22
|
clientName?: string;
|
|
23
|
+
/** SHA-256 hash of the client secret. Set only for confidential clients. */
|
|
24
|
+
clientSecretHash?: string;
|
|
9
25
|
created: Date;
|
|
10
26
|
grantTypes: string[];
|
|
11
27
|
redirectUris: string[];
|
|
12
28
|
responseTypes: string[];
|
|
29
|
+
revokedAt?: Date;
|
|
13
30
|
scope?: string;
|
|
31
|
+
tokenEndpointAuthMethod?: McpOAuthTokenEndpointAuthMethod;
|
|
14
32
|
updated: Date;
|
|
33
|
+
/** User a `client_credentials` token acts as. */
|
|
34
|
+
userId?: mongoose.Types.ObjectId;
|
|
15
35
|
}
|
|
16
36
|
|
|
17
37
|
interface McpOAuthClientStatics
|
|
18
38
|
extends FindExactlyOnePlugin<McpOAuthClientDocument>,
|
|
19
|
-
FindOneOrNonePlugin<McpOAuthClientDocument> {
|
|
39
|
+
FindOneOrNonePlugin<McpOAuthClientDocument> {
|
|
40
|
+
issueConfidential: (
|
|
41
|
+
this: McpOAuthClientModel,
|
|
42
|
+
options: McpOAuthConfidentialClientOptions
|
|
43
|
+
) => Promise<{client: McpOAuthClientDocument; clientSecret: string}>;
|
|
44
|
+
/** Mark the client revoked and end every token it holds. */
|
|
45
|
+
revoke: (this: McpOAuthClientModel, clientId: string) => Promise<McpOAuthClientDocument | null>;
|
|
46
|
+
}
|
|
20
47
|
|
|
21
48
|
export interface McpOAuthClientModel
|
|
22
49
|
extends mongoose.Model<McpOAuthClientDocument>,
|
|
@@ -83,6 +110,11 @@ export interface McpOAuthTokenDocument extends mongoose.Document {
|
|
|
83
110
|
clientId: string;
|
|
84
111
|
created: Date;
|
|
85
112
|
familyId: string;
|
|
113
|
+
/**
|
|
114
|
+
* False for an access-only `client_credentials` token. The stored refresh hash is then of a
|
|
115
|
+
* discarded secret and must not be exchanged.
|
|
116
|
+
*/
|
|
117
|
+
hasRefreshToken?: boolean;
|
|
86
118
|
refreshExpiresAt: Date;
|
|
87
119
|
refreshTokenHash: string;
|
|
88
120
|
resource?: string;
|
|
@@ -98,6 +130,8 @@ export interface McpOAuthTokenIssueOptions {
|
|
|
98
130
|
accessTokenTtlSeconds: number;
|
|
99
131
|
clientId: string;
|
|
100
132
|
familyId?: string;
|
|
133
|
+
/** When false, issue an access token only and do not return a refresh token. Default true. */
|
|
134
|
+
includeRefreshToken?: boolean;
|
|
101
135
|
refreshTokenTtlSeconds: number;
|
|
102
136
|
resource?: string;
|
|
103
137
|
scope?: string;
|
|
@@ -115,9 +149,16 @@ interface McpOAuthTokenStatics
|
|
|
115
149
|
) => Promise<{
|
|
116
150
|
accessToken: string;
|
|
117
151
|
mcpOAuthToken: McpOAuthTokenDocument;
|
|
118
|
-
refreshToken
|
|
152
|
+
refreshToken?: string;
|
|
119
153
|
}>;
|
|
154
|
+
/** Revoke every family issued to this client. */
|
|
155
|
+
revokeClient: (this: McpOAuthTokenModel, clientId: string) => Promise<void>;
|
|
120
156
|
revokeFamily: (this: McpOAuthTokenModel, familyId: string) => Promise<void>;
|
|
157
|
+
/** Revoke every active token family the user holds. Returns how many families were revoked. */
|
|
158
|
+
revokeAllForUser: (
|
|
159
|
+
this: McpOAuthTokenModel,
|
|
160
|
+
userId: mongoose.Types.ObjectId | string
|
|
161
|
+
) => Promise<number>;
|
|
121
162
|
verifyAccessToken: (
|
|
122
163
|
this: McpOAuthTokenModel,
|
|
123
164
|
token: string
|
|
@@ -26,6 +26,11 @@ export interface McpServiceTokenStatics
|
|
|
26
26
|
this: McpServiceTokenModel,
|
|
27
27
|
user: {_id: {toString(): string}; tokenEpoch?: number}
|
|
28
28
|
) => Promise<void>;
|
|
29
|
+
/** Revoke every active service token the user holds. Returns how many were revoked. */
|
|
30
|
+
revokeAllForUser: (
|
|
31
|
+
this: McpServiceTokenModel,
|
|
32
|
+
userId: mongoose.Types.ObjectId | string
|
|
33
|
+
) => Promise<number>;
|
|
29
34
|
revokeForUser: (
|
|
30
35
|
this: McpServiceTokenModel,
|
|
31
36
|
user: {_id: {toString(): string}},
|
|
@@ -81,7 +81,7 @@ describe("hmacSignature", () => {
|
|
|
81
81
|
|
|
82
82
|
it("rejects a missing raw body", () => {
|
|
83
83
|
const verify = hmacSignature({header: "X-Webhook-Signature", secret: SECRET});
|
|
84
|
-
const req = {headers: {"x-webhook-signature": VALID_HEX}} as Request;
|
|
84
|
+
const req = {headers: {"x-webhook-signature": VALID_HEX}} as unknown as Request;
|
|
85
85
|
assert.isFalse(verify(req));
|
|
86
86
|
});
|
|
87
87
|
|