@friggframework/core 2.0.0--canary.690.08cd07e.0 → 2.0.0--canary.693.d8859c2.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/CLAUDE.md +0 -28
- package/README.md +0 -105
- package/application/commands/integration-commands.js +10 -20
- package/application/commands/scheduler-commands.js +7 -11
- package/application/commands/user-commands.js +5 -17
- package/application/index.js +2 -6
- package/core/Worker.js +7 -31
- package/core/create-handler.js +0 -9
- package/credential/repositories/credential-repository-documentdb.js +0 -34
- package/credential/repositories/credential-repository-interface.js +0 -15
- package/credential/repositories/credential-repository-mongo.js +0 -23
- package/credential/repositories/credential-repository-postgres.js +0 -28
- package/database/config.js +24 -48
- package/database/documentdb-utils.js +0 -2
- package/database/encryption/encryption-schema-registry.js +12 -93
- package/database/prisma.js +2 -4
- package/errors/index.js +4 -0
- package/errors/mapping-already-exists-error.js +14 -0
- package/generated/prisma-mongodb/edge.js +38 -33
- package/generated/prisma-mongodb/index-browser.js +35 -30
- package/generated/prisma-mongodb/index.d.ts +1880 -3191
- package/generated/prisma-mongodb/index.js +38 -33
- package/generated/prisma-mongodb/package.json +1 -1
- package/generated/prisma-mongodb/schema.prisma +50 -86
- package/generated/prisma-mongodb/wasm.js +38 -33
- package/generated/prisma-postgresql/edge.js +38 -33
- package/generated/prisma-postgresql/index-browser.js +35 -30
- package/generated/prisma-postgresql/index.d.ts +2050 -3390
- package/generated/prisma-postgresql/index.js +38 -33
- package/generated/prisma-postgresql/package.json +1 -1
- package/generated/prisma-postgresql/schema.prisma +48 -81
- package/generated/prisma-postgresql/wasm.js +38 -33
- package/handlers/WEBHOOKS.md +29 -0
- package/handlers/app-definition-loader.js +19 -128
- package/handlers/app-handler-helpers.js +3 -25
- package/handlers/backend-utils.js +25 -31
- package/handlers/middleware/admin-auth.js +1 -14
- package/handlers/routers/auth.js +10 -46
- package/handlers/routers/health.js +4 -13
- package/handlers/routers/integration-defined-routers.js +92 -144
- package/handlers/routers/integration-webhook-routers.js +64 -102
- package/handlers/workers/integration-defined-workers.js +2 -5
- package/index.js +3 -65
- package/infrastructure/scheduler/index.js +6 -19
- package/infrastructure/scheduler/scheduler-service-factory.js +7 -55
- package/integrations/data-defined/README.md +169 -0
- package/integrations/data-defined/canonical.js +11 -0
- package/integrations/data-defined/capabilities/acmeerp.capabilities.json +608 -0
- package/integrations/data-defined/capabilities/asana.capabilities.json +265 -0
- package/integrations/data-defined/capabilities/calendly.capabilities.json +385 -0
- package/integrations/data-defined/capabilities/docusign.capabilities.json +314 -0
- package/integrations/data-defined/capabilities/fathom.capabilities.json +228 -0
- package/integrations/data-defined/capabilities/github.capabilities.json +563 -0
- package/integrations/data-defined/capabilities/hubspot.capabilities.json +715 -0
- package/integrations/data-defined/capabilities/jira.capabilities.json +376 -0
- package/integrations/data-defined/capabilities/klaviyo.capabilities.json +475 -0
- package/integrations/data-defined/capabilities/linear.capabilities.json +324 -0
- package/integrations/data-defined/capabilities/netsuite.capabilities.json +491 -0
- package/integrations/data-defined/capabilities/notion.capabilities.json +208 -0
- package/integrations/data-defined/capabilities/phone.capabilities.json +470 -0
- package/integrations/data-defined/capabilities/pipedrive.capabilities.json +388 -0
- package/integrations/data-defined/capabilities/quickbooks.capabilities.json +615 -0
- package/integrations/data-defined/capabilities/salesforce.capabilities.json +507 -0
- package/integrations/data-defined/capabilities/shopify.capabilities.json +1082 -0
- package/integrations/data-defined/capabilities/slack.capabilities.json +363 -0
- package/integrations/data-defined/capabilities/stripe.capabilities.json +580 -0
- package/integrations/data-defined/capabilities/webflow.capabilities.json +196 -0
- package/integrations/data-defined/capabilities/zendesk.capabilities.json +409 -0
- package/integrations/data-defined/compile.js +77 -0
- package/integrations/data-defined/config-form.js +110 -0
- package/integrations/data-defined/data-defined-integration.js +366 -0
- package/integrations/data-defined/examples/acme-erp-quickbooks.definition.json +467 -0
- package/integrations/data-defined/examples/asana-slack.definition.json +220 -0
- package/integrations/data-defined/examples/calendly-salesforce.definition.json +459 -0
- package/integrations/data-defined/examples/docusign-salesforce.definition.json +305 -0
- package/integrations/data-defined/examples/fathom-hubspot-notion.definition.json +575 -0
- package/integrations/data-defined/examples/github-linear.definition.json +316 -0
- package/integrations/data-defined/examples/hubspot-slack.definition.json +409 -0
- package/integrations/data-defined/examples/klaviyo-hubspot.definition.json +339 -0
- package/integrations/data-defined/examples/phone-hubspot.definition.json +637 -0
- package/integrations/data-defined/examples/pipedrive-hubspot.definition.json +136 -0
- package/integrations/data-defined/examples/pipedrive-phone.definition.json +340 -0
- package/integrations/data-defined/examples/records/phone-hubspot.definition-version.json +652 -0
- package/integrations/data-defined/examples/records/phone-hubspot.integration.json +86 -0
- package/integrations/data-defined/examples/records/phone-hubspot.mappings.json +39 -0
- package/integrations/data-defined/examples/records/phone-hubspot.workflow-run.json +62 -0
- package/integrations/data-defined/examples/shopify-klaviyo.definition.json +488 -0
- package/integrations/data-defined/examples/shopify-netsuite.definition.json +622 -0
- package/integrations/data-defined/examples/stripe-quickbooks.definition.json +476 -0
- package/integrations/data-defined/examples/webflow-hubspot-slack.definition.json +262 -0
- package/integrations/data-defined/examples/zendesk-jira.definition.json +604 -0
- package/integrations/data-defined/expressions.js +225 -0
- package/integrations/data-defined/index.js +39 -0
- package/integrations/data-defined/interpreter.js +89 -0
- package/integrations/data-defined/manifests.js +125 -0
- package/integrations/data-defined/repositories/definition-version-repository.js +67 -0
- package/integrations/data-defined/repositories/workflow-run-repository.js +59 -0
- package/integrations/data-defined/router.js +97 -0
- package/integrations/data-defined/runtime.js +208 -0
- package/integrations/data-defined/schema/capability-manifest.v0.1.schema.json +377 -0
- package/integrations/data-defined/schema/installation.v0.1.schema.json +83 -0
- package/integrations/data-defined/schema/integration-definition.v0.1.schema.json +848 -0
- package/integrations/data-defined/schema/records.md +98 -0
- package/integrations/data-defined/schema-check.js +58 -0
- package/integrations/data-defined/scripts/validate.js +66 -0
- package/integrations/data-defined/steps.js +89 -0
- package/integrations/data-defined/transforms.js +91 -0
- package/integrations/data-defined/use-cases/definition-use-cases.js +187 -0
- package/integrations/data-defined/validate.js +370 -0
- package/integrations/data-defined/versioning.js +161 -0
- package/integrations/data-defined/webhooks.js +119 -0
- package/integrations/index.js +0 -1
- package/integrations/integration-base.js +29 -0
- package/integrations/integration-router.js +101 -131
- package/integrations/repositories/integration-mapping-repository-documentdb.js +50 -0
- package/integrations/repositories/integration-mapping-repository-interface.js +15 -0
- package/integrations/repositories/integration-mapping-repository-mongo.js +29 -0
- package/integrations/repositories/integration-mapping-repository-postgres.js +30 -0
- package/integrations/repositories/integration-mapping-repository.js +29 -0
- package/integrations/repositories/integration-repository-documentdb.js +3 -35
- package/integrations/repositories/integration-repository-interface.js +1 -17
- package/integrations/repositories/integration-repository-mongo.js +77 -60
- package/integrations/repositories/integration-repository-postgres.js +76 -62
- package/integrations/repositories/process-repository-mongo.js +1 -1
- package/integrations/tests/doubles/test-integration-repository.js +1 -12
- package/integrations/use-cases/create-integration.js +20 -55
- package/integrations/use-cases/get-integrations-for-user.js +40 -80
- package/integrations/use-cases/index.js +1 -7
- package/integrations/utils/map-integration-dto.js +14 -43
- package/modules/index.js +0 -14
- package/modules/module-factory.js +0 -12
- package/modules/module.js +2 -53
- package/modules/repositories/module-repository-documentdb.js +6 -51
- package/modules/repositories/module-repository-interface.js +2 -19
- package/modules/repositories/module-repository-mongo.js +74 -67
- package/modules/repositories/module-repository-postgres.js +74 -66
- package/modules/repositories/module-repository.js +1 -2
- package/modules/requester/requester.js +5 -35
- package/modules/use-cases/get-entities-for-user.js +13 -26
- package/modules/use-cases/get-entity-options-by-id.js +4 -10
- package/modules/use-cases/get-entity-options-by-type.js +1 -1
- package/modules/use-cases/get-module-instance-from-type.js +1 -1
- package/modules/use-cases/get-module.js +4 -10
- package/modules/use-cases/process-authorization-callback.js +19 -53
- package/modules/use-cases/refresh-entity-options.js +4 -10
- package/modules/use-cases/test-module-auth.js +4 -10
- package/package.json +6 -6
- package/prisma-mongodb/schema.prisma +50 -86
- package/prisma-postgresql/migrations/20261018000000_add_data_defined_integrations/migration.sql +66 -0
- package/prisma-postgresql/schema.prisma +48 -81
- package/queues/index.js +0 -25
- package/types/index.d.ts +0 -2
- package/user/repositories/user-repository-documentdb.js +2 -27
- package/user/repositories/user-repository-interface.js +0 -18
- package/user/repositories/user-repository-mongo.js +0 -24
- package/user/repositories/user-repository-postgres.js +0 -18
- package/user/use-cases/authenticate-user.js +1 -7
- package/user/use-cases/get-user-from-adopter-jwt.js +124 -95
- package/user/use-cases/get-user-from-x-frigg-headers.js +80 -83
- package/user/user.js +1 -64
- package/credential/use-cases/credential-operations-for-user.js +0 -202
- package/credential/use-cases/reauthorize-credential-for-user.js +0 -73
- package/database/organization-where.js +0 -18
- package/database/unique-violation.js +0 -25
- package/extensions/bootstrap-runner.js +0 -43
- package/extensions/extension-loader.js +0 -187
- package/extensions/index.js +0 -41
- package/extensions/initialize-app.js +0 -123
- package/extensions/route-mounter.js +0 -103
- package/extensions/schema-composer.js +0 -188
- package/infrastructure/scheduler/netlify-scheduler-adapter.js +0 -216
- package/infrastructure/scheduler/scheduled-job-repository.js +0 -118
- package/integrations/repositories/integration-not-found.js +0 -14
- package/integrations/schedule-config.js +0 -80
- package/integrations/use-cases/dispatch-ongoing-syncs.js +0 -100
- package/integrations/use-cases/integration-operations-for-user.js +0 -256
- package/integrations/use-cases/resolve-integration-ownership.js +0 -177
- package/management-api/create-management-api-router.js +0 -49
- package/management-api/error-response.js +0 -116
- package/management-api/management-api-config.js +0 -151
- package/management-api/meta-router.js +0 -76
- package/management-api/openapi/build-openapi.js +0 -144
- package/management-api/openapi/components.js +0 -415
- package/management-api/openapi/v1-operations.js +0 -83
- package/management-api/openapi/v2-operations.js +0 -264
- package/management-api/route-registry.js +0 -411
- package/management-api/test-support/http-client.js +0 -39
- package/management-api/use-cases/get-management-api-meta.js +0 -57
- package/management-api/v1-deprecation.js +0 -120
- package/management-api/v2/create-v2-router.js +0 -85
- package/management-api/v2/dependencies.js +0 -281
- package/management-api/v2/dto.js +0 -143
- package/management-api/v2/handlers/authorization.js +0 -94
- package/management-api/v2/handlers/credentials.js +0 -33
- package/management-api/v2/handlers/entities.js +0 -77
- package/management-api/v2/handlers/integrations.js +0 -128
- package/management-api/v2/handlers/proxy.js +0 -34
- package/management-api/v2/request.js +0 -85
- package/management-api/v2/test-support/fake-dependencies.js +0 -103
- package/modules/domain/authorization-session.js +0 -144
- package/modules/entity-scope.js +0 -15
- package/modules/entity-type-registry.js +0 -311
- package/modules/proxy/proxy-bases.js +0 -169
- package/modules/proxy/proxy-errors.js +0 -31
- package/modules/proxy/proxy-path.js +0 -183
- package/modules/proxy/proxy-policy.js +0 -277
- package/modules/repositories/authorization-session-repository-documentdb.js +0 -112
- package/modules/repositories/authorization-session-repository-factory.js +0 -31
- package/modules/repositories/authorization-session-repository-interface.js +0 -47
- package/modules/repositories/authorization-session-repository-prisma.js +0 -87
- package/modules/repositories/entity-not-found.js +0 -18
- package/modules/requester/proxy-request.js +0 -245
- package/modules/scope-config.js +0 -192
- package/modules/scope-policy.js +0 -112
- package/modules/scope-resolution.js +0 -288
- package/modules/scope-visibility.js +0 -247
- package/modules/tests/doubles/in-memory-authorization-session-repository.js +0 -45
- package/modules/tests/doubles/ownership-matching.js +0 -18
- package/modules/use-cases/authorize-entity-for-user.js +0 -61
- package/modules/use-cases/create-entity-from-credential.js +0 -113
- package/modules/use-cases/entity-operations-for-user.js +0 -162
- package/modules/use-cases/entity-types.js +0 -139
- package/modules/use-cases/execute-entity-proxy-request.js +0 -331
- package/modules/use-cases/get-authorization-requirements.js +0 -100
- package/modules/use-cases/get-entity-module-for-user.js +0 -113
- package/modules/use-cases/manage-access.js +0 -21
- package/modules/use-cases/multi-step-authorization.js +0 -329
- package/prisma-postgresql/migrations/20261003000000_add_authorization_session/migration.sql +0 -28
- package/prisma-postgresql/migrations/20261015000000_add_organization_membership/migration.sql +0 -26
- package/prisma-postgresql/migrations/20261016000000_add_entity_integration_organization/migration.sql +0 -25
- package/prisma-postgresql/migrations/20261017000000_add_scheduled_job/migration.sql +0 -28
- package/providers/index.js +0 -23
- package/providers/resolve-provider.js +0 -93
- package/providers/runtime-detection.js +0 -124
- package/queues/providers/index.js +0 -11
- package/queues/providers/netlify-background-provider.js +0 -150
- package/queues/providers/qstash-queue-provider.js +0 -219
- package/queues/providers/sqs-queue-provider.js +0 -70
- package/queues/queue-client-interface.js +0 -55
- package/queues/queue-message-auth.js +0 -193
- package/queues/queue-provider-factory.js +0 -101
- package/queues/queue-provider.js +0 -65
- package/queues/sqs-queue-client.js +0 -81
- package/types/modules/index.d.ts +0 -214
- package/types/user/index.d.ts +0 -134
- package/user/adopter-jwt-config.js +0 -177
- package/user/adopter-jwt-errors.js +0 -59
- package/user/adopter-token-verifier.js +0 -122
- package/user/app-user-helpers.js +0 -97
- package/user/create-user-authentication.js +0 -64
- package/user/membership.js +0 -51
- package/user/repositories/organization-membership-record.js +0 -19
- package/user/repositories/organization-membership-repository-documentdb.js +0 -106
- package/user/repositories/organization-membership-repository-factory.js +0 -42
- package/user/repositories/organization-membership-repository-interface.js +0 -57
- package/user/repositories/organization-membership-repository-mongo.js +0 -13
- package/user/repositories/organization-membership-repository-postgres.js +0 -29
- package/user/repositories/organization-membership-repository-prisma.js +0 -81
- package/user/tests/doubles/adopter-jwt-fixtures.js +0 -220
- package/user/use-cases/ensure-organization-membership.js +0 -92
- package/user/use-cases/find-individual-users-by-organization.js +0 -54
|
@@ -1,169 +0,0 @@
|
|
|
1
|
-
const { ProxyConfigError } = require('./proxy-errors');
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* Named base URLs for the entity proxy (ADR-052, amendment 2026-10-18).
|
|
5
|
-
*
|
|
6
|
-
* A module declares where its API lives. One host is `proxy.baseUrl`, which
|
|
7
|
-
* means `{ default: baseUrl }`. A module whose API spans several hosts (Google:
|
|
8
|
-
* Drive, Docs, Sheets, Analytics Data, Ads) declares `proxy.baseUrls`, a map of
|
|
9
|
-
* name to URL. A caller picks a base by NAME in the proxy request's `base`
|
|
10
|
-
* field; it never supplies a URL or a host, so the host still comes only from
|
|
11
|
-
* the module.
|
|
12
|
-
*/
|
|
13
|
-
|
|
14
|
-
const DEFAULT_BASE = 'default';
|
|
15
|
-
const BASE_NAME = /^[a-z][a-z0-9-]*$/;
|
|
16
|
-
|
|
17
|
-
const isPlainObject = (value) =>
|
|
18
|
-
value !== null && typeof value === 'object' && !Array.isArray(value);
|
|
19
|
-
|
|
20
|
-
const describeRule = (rule) =>
|
|
21
|
-
`${rule && typeof rule.method === 'string' ? rule.method : '?'} ${
|
|
22
|
-
rule && typeof rule.path === 'string' ? rule.path : '?'
|
|
23
|
-
}`;
|
|
24
|
-
|
|
25
|
-
function isValidBaseName(name) {
|
|
26
|
-
return typeof name === 'string' && name.length <= 64 && BASE_NAME.test(name);
|
|
27
|
-
}
|
|
28
|
-
|
|
29
|
-
function assertBaseUrl(moduleName, name, value) {
|
|
30
|
-
const where = `Module ${moduleName} proxy.baseUrls.${name}`;
|
|
31
|
-
if (typeof value !== 'string') {
|
|
32
|
-
throw new ProxyConfigError(`${where} must be an absolute https URL string (functions are not accepted)`);
|
|
33
|
-
}
|
|
34
|
-
let url;
|
|
35
|
-
try {
|
|
36
|
-
url = new URL(value);
|
|
37
|
-
} catch {
|
|
38
|
-
throw new ProxyConfigError(`${where} is not a valid absolute URL`);
|
|
39
|
-
}
|
|
40
|
-
if (url.protocol !== 'https:') {
|
|
41
|
-
throw new ProxyConfigError(`${where} must use https`);
|
|
42
|
-
}
|
|
43
|
-
if (url.username || url.password || url.search || url.hash) {
|
|
44
|
-
throw new ProxyConfigError(
|
|
45
|
-
`${where} must not carry credentials, a query or a fragment`
|
|
46
|
-
);
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
/**
|
|
51
|
-
* The bases a module declares, validated.
|
|
52
|
-
*
|
|
53
|
-
* @param {object} definition - a module definition
|
|
54
|
-
* @returns {{ names: string[], values: Map<string, string|Function|undefined>, declared: boolean }}
|
|
55
|
-
* `declared` is false when the module names no base of its own; it then has
|
|
56
|
-
* the single base `default`, resolved from the requester at call time.
|
|
57
|
-
* @throws {ProxyConfigError}
|
|
58
|
-
*/
|
|
59
|
-
function resolveModuleBases(definition) {
|
|
60
|
-
const moduleName = definition?.moduleName ?? '(unnamed)';
|
|
61
|
-
const proxy = definition?.proxy;
|
|
62
|
-
const hasBaseUrl = proxy?.baseUrl !== undefined;
|
|
63
|
-
const hasBaseUrls = proxy?.baseUrls !== undefined;
|
|
64
|
-
|
|
65
|
-
if (hasBaseUrl && hasBaseUrls) {
|
|
66
|
-
throw new ProxyConfigError(
|
|
67
|
-
`Module ${moduleName} declares both proxy.baseUrl and proxy.baseUrls; use one ` +
|
|
68
|
-
'(baseUrl means { default: baseUrl })'
|
|
69
|
-
);
|
|
70
|
-
}
|
|
71
|
-
if (hasBaseUrls) {
|
|
72
|
-
if (!isPlainObject(proxy.baseUrls) || Object.keys(proxy.baseUrls).length === 0) {
|
|
73
|
-
throw new ProxyConfigError(
|
|
74
|
-
`Module ${moduleName} proxy.baseUrls must be a non-empty object of name to URL`
|
|
75
|
-
);
|
|
76
|
-
}
|
|
77
|
-
const values = new Map();
|
|
78
|
-
for (const [name, value] of Object.entries(proxy.baseUrls)) {
|
|
79
|
-
if (!isValidBaseName(name)) {
|
|
80
|
-
throw new ProxyConfigError(
|
|
81
|
-
`Module ${moduleName} proxy.baseUrls has the invalid name ${JSON.stringify(
|
|
82
|
-
name
|
|
83
|
-
)}; names match ${BASE_NAME}`
|
|
84
|
-
);
|
|
85
|
-
}
|
|
86
|
-
assertBaseUrl(moduleName, name, value);
|
|
87
|
-
values.set(name, value);
|
|
88
|
-
}
|
|
89
|
-
return { names: [...values.keys()], values, declared: true };
|
|
90
|
-
}
|
|
91
|
-
return {
|
|
92
|
-
names: [DEFAULT_BASE],
|
|
93
|
-
values: new Map([[DEFAULT_BASE, proxy?.baseUrl]]),
|
|
94
|
-
declared: hasBaseUrl,
|
|
95
|
-
};
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
/** The base a rule applies to; a rule without `base` applies to `default`. */
|
|
99
|
-
const ruleBase = (rule) => (rule && rule.base !== undefined ? rule.base : DEFAULT_BASE);
|
|
100
|
-
|
|
101
|
-
/**
|
|
102
|
-
* Load-time check of every allow rule that names a base: the app's
|
|
103
|
-
* `managementApi.proxy.modules.<module>.allow` and each module's own
|
|
104
|
-
* `proxy.allow`. A rule for a base the module does not declare could never
|
|
105
|
-
* match, which reads as "allowed" and is not, so it stops the app.
|
|
106
|
-
*
|
|
107
|
-
* @param {Array<object>} moduleDefinitions
|
|
108
|
-
* @param {{ modules?: Object }} [proxyConfig] - resolved managementApi.proxy
|
|
109
|
-
* @throws {ProxyConfigError}
|
|
110
|
-
*/
|
|
111
|
-
function assertProxyConfig(moduleDefinitions, proxyConfig = {}) {
|
|
112
|
-
const namesByModule = new Map();
|
|
113
|
-
for (const definition of moduleDefinitions || []) {
|
|
114
|
-
if (!definition?.moduleName) continue;
|
|
115
|
-
const { names } = resolveModuleBases(definition);
|
|
116
|
-
namesByModule.set(definition.moduleName, names);
|
|
117
|
-
const own = definition.proxy?.allow;
|
|
118
|
-
if (Array.isArray(own)) {
|
|
119
|
-
assertRulesUseDeclaredBases(
|
|
120
|
-
definition.moduleName,
|
|
121
|
-
names,
|
|
122
|
-
own,
|
|
123
|
-
`Module ${definition.moduleName} proxy.allow`
|
|
124
|
-
);
|
|
125
|
-
}
|
|
126
|
-
}
|
|
127
|
-
for (const [moduleName, override] of Object.entries(proxyConfig.modules || {})) {
|
|
128
|
-
const names = namesByModule.get(moduleName);
|
|
129
|
-
// An override for a module that is not registered is not new: it never applied.
|
|
130
|
-
if (!names || !Array.isArray(override?.allow)) continue;
|
|
131
|
-
assertRulesUseDeclaredBases(
|
|
132
|
-
moduleName,
|
|
133
|
-
names,
|
|
134
|
-
override.allow,
|
|
135
|
-
`managementApi.proxy.modules.${moduleName}.allow`
|
|
136
|
-
);
|
|
137
|
-
}
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
function assertRulesUseDeclaredBases(moduleName, names, rules, where) {
|
|
141
|
-
for (const rule of rules) {
|
|
142
|
-
if (!isPlainObject(rule) || rule.base === undefined) continue;
|
|
143
|
-
if (!isValidBaseName(rule.base) || !names.includes(rule.base)) {
|
|
144
|
-
throw new ProxyConfigError(
|
|
145
|
-
`${where}: the rule ${describeRule(rule)} names the base ${JSON.stringify(
|
|
146
|
-
rule.base
|
|
147
|
-
)}, which module ${moduleName} does not declare (declared: ${names.join(', ')})`
|
|
148
|
-
);
|
|
149
|
-
}
|
|
150
|
-
}
|
|
151
|
-
// A rule with no base means `default`; the module must have one.
|
|
152
|
-
if (!names.includes(DEFAULT_BASE)) {
|
|
153
|
-
const bare = rules.find((rule) => isPlainObject(rule) && rule.base === undefined);
|
|
154
|
-
if (bare) {
|
|
155
|
-
throw new ProxyConfigError(
|
|
156
|
-
`${where}: the rule ${describeRule(bare)} names no base, so it applies to ` +
|
|
157
|
-
`"default", which module ${moduleName} does not declare (declared: ${names.join(', ')})`
|
|
158
|
-
);
|
|
159
|
-
}
|
|
160
|
-
}
|
|
161
|
-
}
|
|
162
|
-
|
|
163
|
-
module.exports = {
|
|
164
|
-
DEFAULT_BASE,
|
|
165
|
-
isValidBaseName,
|
|
166
|
-
resolveModuleBases,
|
|
167
|
-
ruleBase,
|
|
168
|
-
assertProxyConfig,
|
|
169
|
-
};
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* A proxied call was refused or failed in a way the Management API maps to a
|
|
3
|
-
* documented status (ADR-052 §10). `code` is the public error code; nothing
|
|
4
|
-
* here carries the upstream URL, headers or credential material.
|
|
5
|
-
*/
|
|
6
|
-
class ProxyRequestError extends Error {
|
|
7
|
-
/**
|
|
8
|
-
* @param {string} code - e.g. INVALID_PROXY_REQUEST, PROXY_NOT_ALLOWED, TIMEOUT
|
|
9
|
-
* @param {string} message - safe to show the caller
|
|
10
|
-
* @param {Object} [details] - safe structured details
|
|
11
|
-
*/
|
|
12
|
-
constructor(code, message, details) {
|
|
13
|
-
super(message);
|
|
14
|
-
this.name = 'ProxyRequestError';
|
|
15
|
-
this.code = code;
|
|
16
|
-
this.details = details;
|
|
17
|
-
}
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
/**
|
|
21
|
-
* A module definition or the app's proxy settings are wrong. Thrown at load,
|
|
22
|
-
* so the app stops starting instead of failing on the first proxied call.
|
|
23
|
-
*/
|
|
24
|
-
class ProxyConfigError extends Error {
|
|
25
|
-
constructor(message) {
|
|
26
|
-
super(message);
|
|
27
|
-
this.name = 'ProxyConfigError';
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
module.exports = { ProxyRequestError, ProxyConfigError };
|
|
@@ -1,183 +0,0 @@
|
|
|
1
|
-
const { ProxyRequestError } = require('./proxy-errors');
|
|
2
|
-
const { DEFAULT_BASE, ruleBase } = require('./proxy-bases');
|
|
3
|
-
|
|
4
|
-
/**
|
|
5
|
-
* Path rules for the entity proxy (ADR-052 §4). The caller supplies a path
|
|
6
|
-
* relative to the module's base URL and nothing else: the host, scheme and
|
|
7
|
-
* port always come from the module.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
const invalid = (reason) =>
|
|
11
|
-
new ProxyRequestError('INVALID_PROXY_REQUEST', `Invalid proxy path: ${reason}`, {
|
|
12
|
-
field: 'path',
|
|
13
|
-
});
|
|
14
|
-
|
|
15
|
-
// Control characters (C0, DEL, C1), any whitespace, and invisible format
|
|
16
|
-
// characters such as zero-width spaces and byte-order marks.
|
|
17
|
-
const FORBIDDEN_CHARS = /[\x00-\x20\x7f-\x9f]|\s|\p{Cf}/u;
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
* Validates and normalises a caller-supplied path.
|
|
21
|
-
*
|
|
22
|
-
* - must start with a single `/`; `//` (anywhere), `\`, `?`, `#`, control
|
|
23
|
-
* and whitespace characters are rejected;
|
|
24
|
-
* - encoded separators (`%2f`, `%5c`) are rejected, then the path is
|
|
25
|
-
* percent-decoded exactly once; a `%` left after decoding (double
|
|
26
|
-
* encoding) is rejected, as is any decoded control or whitespace
|
|
27
|
-
* character other than a space (`%20`);
|
|
28
|
-
* - `.` and `..` segments are rejected rather than resolved.
|
|
29
|
-
*
|
|
30
|
-
* @param {unknown} path
|
|
31
|
-
* @returns {string} the decoded path, e.g. `/crm/v3/objects/contacts`
|
|
32
|
-
* @throws {ProxyRequestError} INVALID_PROXY_REQUEST
|
|
33
|
-
*/
|
|
34
|
-
function normalizeProxyPath(path) {
|
|
35
|
-
if (typeof path !== 'string' || path.length === 0) {
|
|
36
|
-
throw invalid('path must be a non-empty string');
|
|
37
|
-
}
|
|
38
|
-
if (path.length > 2048) throw invalid('path is too long');
|
|
39
|
-
if (!path.startsWith('/')) throw invalid('path must start with /');
|
|
40
|
-
if (path.startsWith('//') || path.includes('//')) {
|
|
41
|
-
throw invalid('empty path segments (//) are not allowed');
|
|
42
|
-
}
|
|
43
|
-
if (path.includes('\\')) throw invalid('backslashes are not allowed');
|
|
44
|
-
if (path.includes('?') || path.includes('#')) {
|
|
45
|
-
throw invalid('send the query string in `query`, not in the path');
|
|
46
|
-
}
|
|
47
|
-
if (FORBIDDEN_CHARS.test(path)) {
|
|
48
|
-
throw invalid('control and whitespace characters are not allowed');
|
|
49
|
-
}
|
|
50
|
-
if (/%(2f|5c)/i.test(path)) {
|
|
51
|
-
throw invalid('encoded path separators are not allowed');
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
let decoded;
|
|
55
|
-
try {
|
|
56
|
-
decoded = decodeURIComponent(path);
|
|
57
|
-
} catch {
|
|
58
|
-
throw invalid('malformed percent-encoding');
|
|
59
|
-
}
|
|
60
|
-
if (
|
|
61
|
-
decoded.includes('%') ||
|
|
62
|
-
decoded.includes('\\') ||
|
|
63
|
-
decoded.includes('?') ||
|
|
64
|
-
decoded.includes('#') ||
|
|
65
|
-
decoded.includes('//') ||
|
|
66
|
-
// An encoded space (%20) is a legitimate path character; every other
|
|
67
|
-
// control or whitespace character stays forbidden.
|
|
68
|
-
FORBIDDEN_CHARS.test(decoded.replaceAll(' ', ''))
|
|
69
|
-
) {
|
|
70
|
-
throw invalid('encoded characters decode to something not allowed');
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
const segments = decoded.split('/').slice(1);
|
|
74
|
-
if (segments.some((segment) => segment === '.' || segment === '..')) {
|
|
75
|
-
throw invalid('dot segments (. and ..) are not allowed');
|
|
76
|
-
}
|
|
77
|
-
return decoded;
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
/**
|
|
81
|
-
* Joins a module base URL and a normalised path, then proves the result
|
|
82
|
-
* cannot leave the module's API: https only, same origin as the base URL,
|
|
83
|
-
* and under the base URL's path.
|
|
84
|
-
*
|
|
85
|
-
* @param {string} baseUrl - from the module, never from the request
|
|
86
|
-
* @param {string} normalizedPath - from normalizeProxyPath()
|
|
87
|
-
* @returns {{ url: string, basePath: string, origin: string }} `url` is not
|
|
88
|
-
* percent-encoded; the Requester encodes it once.
|
|
89
|
-
* @throws {ProxyRequestError} PROXY_NOT_CONFIGURED or INVALID_PROXY_REQUEST
|
|
90
|
-
*/
|
|
91
|
-
function joinProxyUrl(baseUrl, normalizedPath) {
|
|
92
|
-
let base;
|
|
93
|
-
try {
|
|
94
|
-
base = new URL(baseUrl);
|
|
95
|
-
} catch {
|
|
96
|
-
throw new ProxyRequestError(
|
|
97
|
-
'PROXY_NOT_CONFIGURED',
|
|
98
|
-
'The module has no valid base URL to proxy to'
|
|
99
|
-
);
|
|
100
|
-
}
|
|
101
|
-
if (base.protocol !== 'https:') {
|
|
102
|
-
throw new ProxyRequestError(
|
|
103
|
-
'PROXY_NOT_CONFIGURED',
|
|
104
|
-
'The module base URL must use https to be proxied'
|
|
105
|
-
);
|
|
106
|
-
}
|
|
107
|
-
if (base.username || base.password || base.search || base.hash) {
|
|
108
|
-
throw new ProxyRequestError(
|
|
109
|
-
'PROXY_NOT_CONFIGURED',
|
|
110
|
-
'The module base URL must not carry credentials, a query or a fragment'
|
|
111
|
-
);
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
const basePath = base.pathname.replace(/\/+$/, '');
|
|
115
|
-
const url = `${base.origin}${basePath}${normalizedPath}`;
|
|
116
|
-
|
|
117
|
-
let joined;
|
|
118
|
-
try {
|
|
119
|
-
joined = new URL(url);
|
|
120
|
-
} catch {
|
|
121
|
-
throw invalid('the joined URL is not valid');
|
|
122
|
-
}
|
|
123
|
-
const joinedPath = decodeURIComponent(joined.pathname);
|
|
124
|
-
if (
|
|
125
|
-
joined.protocol !== 'https:' ||
|
|
126
|
-
joined.origin !== base.origin ||
|
|
127
|
-
joined.username ||
|
|
128
|
-
joined.password ||
|
|
129
|
-
!(joinedPath === basePath || joinedPath.startsWith(`${basePath}/`))
|
|
130
|
-
) {
|
|
131
|
-
throw invalid('the path leaves the module API');
|
|
132
|
-
}
|
|
133
|
-
return { url, basePath, origin: base.origin };
|
|
134
|
-
}
|
|
135
|
-
|
|
136
|
-
/**
|
|
137
|
-
* Finds the allow-list rule that permits `method` on `path` of `base`.
|
|
138
|
-
*
|
|
139
|
-
* Patterns use `:param` for exactly one segment and a trailing `/**` for a
|
|
140
|
-
* subtree (the prefix itself included). `method: '*'` matches any method.
|
|
141
|
-
*
|
|
142
|
-
* @param {Array<{method: string, path: string}>} rules
|
|
143
|
-
* @param {string} method - upper case
|
|
144
|
-
* @param {string} path - normalised path
|
|
145
|
-
* @param {string} [base='default'] - the named base the request targets; a
|
|
146
|
-
* rule applies to its own `base` only (no `base` means `default`)
|
|
147
|
-
* @returns {{method: string, path: string, base?: string}|null}
|
|
148
|
-
*/
|
|
149
|
-
function matchAllowRule(rules, method, path, base = DEFAULT_BASE) {
|
|
150
|
-
const requestSegments = path.split('/').slice(1);
|
|
151
|
-
for (const rule of rules || []) {
|
|
152
|
-
if (!rule || typeof rule.path !== 'string' || typeof rule.method !== 'string') {
|
|
153
|
-
continue;
|
|
154
|
-
}
|
|
155
|
-
if (ruleBase(rule) !== base) continue;
|
|
156
|
-
const ruleMethod = rule.method.toUpperCase();
|
|
157
|
-
if (ruleMethod !== '*' && ruleMethod !== method) continue;
|
|
158
|
-
if (patternMatches(rule.path, requestSegments)) return rule;
|
|
159
|
-
}
|
|
160
|
-
return null;
|
|
161
|
-
}
|
|
162
|
-
|
|
163
|
-
function patternMatches(pattern, requestSegments) {
|
|
164
|
-
if (!pattern.startsWith('/')) return false;
|
|
165
|
-
let patternSegments = pattern.split('/').slice(1);
|
|
166
|
-
let subtree = false;
|
|
167
|
-
if (patternSegments[patternSegments.length - 1] === '**') {
|
|
168
|
-
subtree = true;
|
|
169
|
-
patternSegments = patternSegments.slice(0, -1);
|
|
170
|
-
}
|
|
171
|
-
if (subtree) {
|
|
172
|
-
if (requestSegments.length < patternSegments.length) return false;
|
|
173
|
-
} else if (requestSegments.length !== patternSegments.length) {
|
|
174
|
-
return false;
|
|
175
|
-
}
|
|
176
|
-
return patternSegments.every((segment, index) => {
|
|
177
|
-
const actual = requestSegments[index];
|
|
178
|
-
if (segment.startsWith(':')) return actual !== undefined && actual !== '';
|
|
179
|
-
return segment === actual;
|
|
180
|
-
});
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
module.exports = { normalizeProxyPath, joinProxyUrl, matchAllowRule };
|
|
@@ -1,277 +0,0 @@
|
|
|
1
|
-
const { ProxyRequestError } = require('./proxy-errors');
|
|
2
|
-
const { isValidBaseName } = require('./proxy-bases');
|
|
3
|
-
|
|
4
|
-
/**
|
|
5
|
-
* What the entity proxy accepts and returns (ADR-052 §5-§7). Pure functions:
|
|
6
|
-
* no I/O, so every rule is unit-tested on its own.
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
const PROXY_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
|
|
10
|
-
const METHODS_WITH_BODY = new Set(['POST', 'PUT', 'PATCH', 'DELETE']);
|
|
11
|
-
|
|
12
|
-
/** Request headers a caller may always send (lower case). */
|
|
13
|
-
const ALLOWED_REQUEST_HEADERS = [
|
|
14
|
-
'accept',
|
|
15
|
-
'content-type',
|
|
16
|
-
'accept-language',
|
|
17
|
-
'if-match',
|
|
18
|
-
'if-none-match',
|
|
19
|
-
];
|
|
20
|
-
|
|
21
|
-
/** Request headers that are refused outright, even if a module lists them. */
|
|
22
|
-
const REJECTED_REQUEST_HEADERS = [
|
|
23
|
-
'authorization',
|
|
24
|
-
'proxy-authorization',
|
|
25
|
-
'cookie',
|
|
26
|
-
'host',
|
|
27
|
-
'forwarded',
|
|
28
|
-
'x-real-ip',
|
|
29
|
-
'x-api-key',
|
|
30
|
-
];
|
|
31
|
-
const REJECTED_REQUEST_HEADER_PREFIXES = ['x-forwarded-'];
|
|
32
|
-
|
|
33
|
-
/** Response headers never passed back (credentials and hop-by-hop). */
|
|
34
|
-
const REMOVED_RESPONSE_HEADERS = [
|
|
35
|
-
'authorization',
|
|
36
|
-
'proxy-authorization',
|
|
37
|
-
'proxy-authenticate',
|
|
38
|
-
'set-cookie',
|
|
39
|
-
'set-cookie2',
|
|
40
|
-
'www-authenticate',
|
|
41
|
-
'x-api-key',
|
|
42
|
-
'connection',
|
|
43
|
-
'keep-alive',
|
|
44
|
-
'te',
|
|
45
|
-
'trailer',
|
|
46
|
-
'transfer-encoding',
|
|
47
|
-
'upgrade',
|
|
48
|
-
// The body is re-encoded as JSON, so these no longer describe it.
|
|
49
|
-
'content-length',
|
|
50
|
-
'content-encoding',
|
|
51
|
-
];
|
|
52
|
-
|
|
53
|
-
const invalid = (message, details) =>
|
|
54
|
-
new ProxyRequestError('INVALID_PROXY_REQUEST', message, details);
|
|
55
|
-
|
|
56
|
-
/**
|
|
57
|
-
* A query key ending in `[]` is sent as one `key=value` pair per array
|
|
58
|
-
* element; the requester applies the same rule (see
|
|
59
|
-
* `_rawRequest` in requester.js).
|
|
60
|
-
*/
|
|
61
|
-
const isRepeatedQueryKey = (key) => key.endsWith('[]');
|
|
62
|
-
|
|
63
|
-
const isPlainObject = (value) =>
|
|
64
|
-
value !== null && typeof value === 'object' && !Array.isArray(value);
|
|
65
|
-
|
|
66
|
-
/**
|
|
67
|
-
* Validates the request body of POST /api/v2/entities/:id/proxy and returns
|
|
68
|
-
* it with the method upper-cased and the body serialised.
|
|
69
|
-
*
|
|
70
|
-
* @param {unknown} request
|
|
71
|
-
* @param {{ maxRequestBytes: number }} limits
|
|
72
|
-
* @returns {{ method: string, path: string, base?: string, query?: Object, headers: Object, body?: string, requestBytes: number, bodyIsJson: boolean }}
|
|
73
|
-
*/
|
|
74
|
-
function validateProxyRequest(request, { maxRequestBytes }) {
|
|
75
|
-
if (!isPlainObject(request)) throw invalid('The proxy request must be a JSON object');
|
|
76
|
-
const method = typeof request.method === 'string' ? request.method.toUpperCase() : '';
|
|
77
|
-
if (!PROXY_METHODS.includes(method)) {
|
|
78
|
-
throw invalid(`method must be one of ${PROXY_METHODS.join(', ')}`, { field: 'method' });
|
|
79
|
-
}
|
|
80
|
-
if (typeof request.path !== 'string') {
|
|
81
|
-
throw invalid('path is required', { field: 'path' });
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
// `base` is a name, never a URL or host; anything else is refused before
|
|
85
|
-
// a module is looked up. Omitted means `default` (the caller applies it).
|
|
86
|
-
let base;
|
|
87
|
-
if (request.base !== undefined && request.base !== null) {
|
|
88
|
-
if (typeof request.base !== 'string' || !isValidBaseName(request.base)) {
|
|
89
|
-
throw invalid(
|
|
90
|
-
'base must be the name of one of the module\'s base URLs (lower case letters, digits and -), not a URL or host',
|
|
91
|
-
{ field: 'base' }
|
|
92
|
-
);
|
|
93
|
-
}
|
|
94
|
-
base = request.base;
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
let query;
|
|
98
|
-
if (request.query !== undefined && request.query !== null) {
|
|
99
|
-
if (!isPlainObject(request.query)) throw invalid('query must be an object', { field: 'query' });
|
|
100
|
-
query = {};
|
|
101
|
-
for (const [key, value] of Object.entries(request.query)) {
|
|
102
|
-
const scalar = ['string', 'number', 'boolean'].includes(typeof value);
|
|
103
|
-
const list = Array.isArray(value) && value.every((v) => typeof v === 'string');
|
|
104
|
-
if (!scalar && !list) {
|
|
105
|
-
throw invalid(`query.${key} must be a string, number, boolean or array of strings`, {
|
|
106
|
-
field: `query.${key}`,
|
|
107
|
-
});
|
|
108
|
-
}
|
|
109
|
-
// A key ending in `[]` (`fields[]`) is sent once per value, as
|
|
110
|
-
// Airtable and Fathom expect; every other array goes comma-separated.
|
|
111
|
-
if (list) {
|
|
112
|
-
query[key] = isRepeatedQueryKey(key) ? [...value] : value.join(',');
|
|
113
|
-
} else {
|
|
114
|
-
query[key] = value;
|
|
115
|
-
}
|
|
116
|
-
}
|
|
117
|
-
}
|
|
118
|
-
|
|
119
|
-
const headers = {};
|
|
120
|
-
if (request.headers !== undefined && request.headers !== null) {
|
|
121
|
-
if (!isPlainObject(request.headers)) throw invalid('headers must be an object', { field: 'headers' });
|
|
122
|
-
for (const [name, value] of Object.entries(request.headers)) {
|
|
123
|
-
if (typeof value !== 'string') {
|
|
124
|
-
throw invalid(`header ${name} must be a string`, { field: `headers.${name}` });
|
|
125
|
-
}
|
|
126
|
-
headers[name.toLowerCase()] = value;
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
let body;
|
|
131
|
-
let bodyIsJson = false;
|
|
132
|
-
if (request.body !== undefined && request.body !== null) {
|
|
133
|
-
if (!METHODS_WITH_BODY.has(method)) {
|
|
134
|
-
throw invalid(`${method} requests cannot have a body`, { field: 'body' });
|
|
135
|
-
}
|
|
136
|
-
if (typeof request.body === 'string') {
|
|
137
|
-
body = request.body;
|
|
138
|
-
} else {
|
|
139
|
-
body = JSON.stringify(request.body);
|
|
140
|
-
bodyIsJson = true;
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
const requestBytes = body === undefined ? 0 : Buffer.byteLength(body);
|
|
144
|
-
if (requestBytes > maxRequestBytes) {
|
|
145
|
-
throw new ProxyRequestError(
|
|
146
|
-
'PAYLOAD_TOO_LARGE',
|
|
147
|
-
`The proxied request body is larger than ${maxRequestBytes} bytes`
|
|
148
|
-
);
|
|
149
|
-
}
|
|
150
|
-
return { method, path: request.path, ...(base !== undefined && { base }), query, headers, body, bodyIsJson, requestBytes };
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
const isWildcardRule = (rule) => rule?.method === '*' || rule?.path === '/**';
|
|
154
|
-
|
|
155
|
-
// A rule's `base` is checked against the module's declared bases at load, by
|
|
156
|
-
// assertProxyConfig (proxy-bases.js); here only its shape is.
|
|
157
|
-
const isValidRule = (rule) =>
|
|
158
|
-
isPlainObject(rule) &&
|
|
159
|
-
typeof rule.method === 'string' &&
|
|
160
|
-
typeof rule.path === 'string' &&
|
|
161
|
-
rule.path.startsWith('/') &&
|
|
162
|
-
(rule.base === undefined || isValidBaseName(rule.base));
|
|
163
|
-
|
|
164
|
-
/**
|
|
165
|
-
* The allow-list in force for a module: the app definition's list for it when
|
|
166
|
-
* one is given (`managementApi.proxy.modules[name].allow`), otherwise the
|
|
167
|
-
* module's own `proxy.allow`. A module cannot grant itself a wildcard; only
|
|
168
|
-
* the app definition can. No list means nothing may be proxied.
|
|
169
|
-
*
|
|
170
|
-
* @returns {{ rules: Array<{method: string, path: string}>, source: 'app'|'module'|'none', ignored: number }}
|
|
171
|
-
*/
|
|
172
|
-
function resolveAllowRules(definition, moduleOverrides = {}) {
|
|
173
|
-
const override = moduleOverrides?.[definition.moduleName]?.allow;
|
|
174
|
-
if (Array.isArray(override)) {
|
|
175
|
-
return { rules: override.filter(isValidRule), source: 'app', ignored: 0 };
|
|
176
|
-
}
|
|
177
|
-
const declared = Array.isArray(definition.proxy?.allow) ? definition.proxy.allow : [];
|
|
178
|
-
const rules = declared.filter((rule) => isValidRule(rule) && !isWildcardRule(rule));
|
|
179
|
-
return {
|
|
180
|
-
rules,
|
|
181
|
-
source: rules.length ? 'module' : 'none',
|
|
182
|
-
ignored: declared.length - rules.length,
|
|
183
|
-
};
|
|
184
|
-
}
|
|
185
|
-
|
|
186
|
-
/**
|
|
187
|
-
* Keeps only the request headers the caller may set. A header from the
|
|
188
|
-
* rejected list (credentials, Host, forwarding headers, or one the module's
|
|
189
|
-
* own auth sets) fails the request instead of being dropped quietly.
|
|
190
|
-
*
|
|
191
|
-
* @param {Object} headers - lower-cased names
|
|
192
|
-
* @param {Object} options
|
|
193
|
-
* @param {string[]} [options.moduleHeaders] - from the module's `proxy.headers`
|
|
194
|
-
* @param {string[]} [options.authHeaderNames] - headers the module's auth sets
|
|
195
|
-
*/
|
|
196
|
-
function filterRequestHeaders(headers, { moduleHeaders = [], authHeaderNames = [] } = {}) {
|
|
197
|
-
const rejected = new Set([
|
|
198
|
-
...REJECTED_REQUEST_HEADERS,
|
|
199
|
-
...authHeaderNames.filter(Boolean).map((name) => String(name).toLowerCase()),
|
|
200
|
-
]);
|
|
201
|
-
const allowed = new Set([
|
|
202
|
-
...ALLOWED_REQUEST_HEADERS,
|
|
203
|
-
...moduleHeaders.map((name) => String(name).toLowerCase()),
|
|
204
|
-
]);
|
|
205
|
-
const kept = {};
|
|
206
|
-
for (const [name, value] of Object.entries(headers)) {
|
|
207
|
-
if (
|
|
208
|
-
rejected.has(name) ||
|
|
209
|
-
REJECTED_REQUEST_HEADER_PREFIXES.some((prefix) => name.startsWith(prefix))
|
|
210
|
-
) {
|
|
211
|
-
throw invalid(`The ${name} header cannot be sent through the proxy`, {
|
|
212
|
-
field: `headers.${name}`,
|
|
213
|
-
});
|
|
214
|
-
}
|
|
215
|
-
if (allowed.has(name)) kept[name] = value;
|
|
216
|
-
}
|
|
217
|
-
return kept;
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
/**
|
|
221
|
-
* Removes credential and hop-by-hop headers from an upstream response, and
|
|
222
|
-
* the Location of a redirect the proxy refused to follow.
|
|
223
|
-
*/
|
|
224
|
-
function filterResponseHeaders(headers, { redirectBlocked = false, authHeaderNames = [] } = {}) {
|
|
225
|
-
const removed = new Set([
|
|
226
|
-
...REMOVED_RESPONSE_HEADERS,
|
|
227
|
-
...authHeaderNames.filter(Boolean).map((name) => String(name).toLowerCase()),
|
|
228
|
-
]);
|
|
229
|
-
if (redirectBlocked) removed.add('location');
|
|
230
|
-
const kept = {};
|
|
231
|
-
for (const [name, value] of Object.entries(headers || {})) {
|
|
232
|
-
if (!removed.has(name.toLowerCase())) kept[name.toLowerCase()] = value;
|
|
233
|
-
}
|
|
234
|
-
return kept;
|
|
235
|
-
}
|
|
236
|
-
|
|
237
|
-
const JSON_TYPE = /^application\/([a-z0-9.+-]*\+)?json\b/i;
|
|
238
|
-
const TEXT_TYPE = /^(text\/|application\/(xml|x-www-form-urlencoded|javascript|graphql)\b|[a-z]+\/[a-z0-9.+-]*\+xml\b)/i;
|
|
239
|
-
|
|
240
|
-
/**
|
|
241
|
-
* Turns the upstream body into the `data` of the proxy response: parsed JSON,
|
|
242
|
-
* text, or (only if the module allows binary) base64.
|
|
243
|
-
*
|
|
244
|
-
* @returns {{ data: unknown, encoding?: 'base64' }}
|
|
245
|
-
*/
|
|
246
|
-
function decodeResponseBody(body, contentType, { binary = false } = {}) {
|
|
247
|
-
if (!body || body.length === 0) return { data: null };
|
|
248
|
-
if (JSON_TYPE.test(contentType)) {
|
|
249
|
-
const text = body.toString('utf8');
|
|
250
|
-
try {
|
|
251
|
-
return { data: JSON.parse(text) };
|
|
252
|
-
} catch {
|
|
253
|
-
return { data: text };
|
|
254
|
-
}
|
|
255
|
-
}
|
|
256
|
-
if (!contentType || TEXT_TYPE.test(contentType)) {
|
|
257
|
-
return { data: body.toString('utf8') };
|
|
258
|
-
}
|
|
259
|
-
if (binary) return { data: body.toString('base64'), encoding: 'base64' };
|
|
260
|
-
throw new ProxyRequestError(
|
|
261
|
-
'UNSUPPORTED_MEDIA_TYPE',
|
|
262
|
-
'The upstream response is binary and this module does not allow binary proxying',
|
|
263
|
-
{ contentType: contentType.split(';')[0] }
|
|
264
|
-
);
|
|
265
|
-
}
|
|
266
|
-
|
|
267
|
-
module.exports = {
|
|
268
|
-
PROXY_METHODS,
|
|
269
|
-
ALLOWED_REQUEST_HEADERS,
|
|
270
|
-
REJECTED_REQUEST_HEADERS,
|
|
271
|
-
REMOVED_RESPONSE_HEADERS,
|
|
272
|
-
validateProxyRequest,
|
|
273
|
-
resolveAllowRules,
|
|
274
|
-
filterRequestHeaders,
|
|
275
|
-
filterResponseHeaders,
|
|
276
|
-
decodeResponseBody,
|
|
277
|
-
};
|