@caelo-cms/shared 0.11.9 → 0.11.10
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/certs/aws-rds-global.pem +2888 -0
- package/certs/cloudsql-global.pem +1897 -0
- package/dist/body-cap.d.ts +35 -0
- package/dist/body-cap.d.ts.map +1 -0
- package/dist/body-cap.js +63 -0
- package/dist/body-cap.js.map +1 -0
- package/dist/client-address.d.ts +69 -0
- package/dist/client-address.d.ts.map +1 -0
- package/dist/client-address.js +99 -0
- package/dist/client-address.js.map +1 -0
- package/dist/context.d.ts +8 -0
- package/dist/context.d.ts.map +1 -1
- package/dist/database-tls.d.ts +64 -0
- package/dist/database-tls.d.ts.map +1 -0
- package/dist/database-tls.js +95 -0
- package/dist/database-tls.js.map +1 -0
- package/dist/database-url.d.ts +2 -15
- package/dist/database-url.d.ts.map +1 -1
- package/dist/database-url.js +14 -1
- package/dist/database-url.js.map +1 -1
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -1
- package/dist/interim-forwarded-host.d.ts +15 -0
- package/dist/interim-forwarded-host.d.ts.map +1 -0
- package/dist/interim-forwarded-host.js +16 -0
- package/dist/interim-forwarded-host.js.map +1 -0
- package/dist/json-security-headers.d.ts +23 -0
- package/dist/json-security-headers.d.ts.map +1 -0
- package/dist/json-security-headers.js +53 -0
- package/dist/json-security-headers.js.map +1 -0
- package/dist/pool-budget.d.ts +10 -0
- package/dist/pool-budget.d.ts.map +1 -1
- package/dist/pool-budget.js +15 -0
- package/dist/pool-budget.js.map +1 -1
- package/dist/redirect-emit-gcp.d.ts +16 -8
- package/dist/redirect-emit-gcp.d.ts.map +1 -1
- package/dist/redirect-emit-gcp.js +22 -11
- package/dist/redirect-emit-gcp.js.map +1 -1
- package/dist/release-manifest.d.ts +18 -2
- package/dist/release-manifest.d.ts.map +1 -1
- package/dist/release-manifest.js +32 -4
- package/dist/release-manifest.js.map +1 -1
- package/dist/session-cookie.d.ts +88 -0
- package/dist/session-cookie.d.ts.map +1 -0
- package/dist/session-cookie.js +151 -0
- package/dist/session-cookie.js.map +1 -0
- package/dist/staging-plugin-stub.d.ts +28 -0
- package/dist/staging-plugin-stub.d.ts.map +1 -0
- package/dist/staging-plugin-stub.js +34 -0
- package/dist/staging-plugin-stub.js.map +1 -0
- package/dist/version.d.ts +2 -2
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +1 -1
- package/dist/version.js.map +1 -1
- package/package.json +2 -1
- package/src/body-cap.test.ts +44 -0
- package/src/body-cap.ts +83 -0
- package/src/client-address.test.ts +90 -0
- package/src/client-address.ts +111 -0
- package/src/context.ts +8 -0
- package/src/database-tls.test.ts +83 -0
- package/src/database-tls.ts +99 -0
- package/src/database-url.test.ts +49 -11
- package/src/database-url.ts +21 -1
- package/src/index.ts +7 -0
- package/src/interim-forwarded-host.ts +16 -0
- package/src/json-security-headers.test.ts +31 -0
- package/src/json-security-headers.ts +53 -0
- package/src/pool-budget.test.ts +17 -3
- package/src/pool-budget.ts +19 -0
- package/src/redirect-emit-gcp.ts +24 -11
- package/src/redirect-emit.test.ts +6 -5
- package/src/release-manifest.ts +33 -4
- package/src/session-cookie.test.ts +96 -0
- package/src/session-cookie.ts +163 -0
- package/src/staging-plugin-stub.test.ts +23 -0
- package/src/staging-plugin-stub.ts +37 -0
- package/src/version.ts +1 -1
package/dist/index.js
CHANGED
|
@@ -4,10 +4,12 @@ export * from "./ai-tools.js";
|
|
|
4
4
|
export * from "./auth-forms.js";
|
|
5
5
|
export * from "./auto-update.js";
|
|
6
6
|
export * from "./base-css.js";
|
|
7
|
+
export * from "./body-cap.js";
|
|
7
8
|
export * from "./bug-intake.js";
|
|
8
9
|
export * from "./build-page.js";
|
|
9
10
|
export * from "./cap-failures.js";
|
|
10
11
|
export * from "./change-journal.js";
|
|
12
|
+
export * from "./client-address.js";
|
|
11
13
|
export * from "./cloud-shell-install.js";
|
|
12
14
|
export * from "./content.js";
|
|
13
15
|
export * from "./context.js";
|
|
@@ -15,6 +17,7 @@ export * from "./css-gradient-scan.js";
|
|
|
15
17
|
export * from "./css-scope-scan.js";
|
|
16
18
|
export * from "./css-var-aliases.js";
|
|
17
19
|
export * from "./css-var-scan.js";
|
|
20
|
+
export * from "./database-tls.js";
|
|
18
21
|
export * from "./database-url.js";
|
|
19
22
|
export * from "./design-draft-shell.js";
|
|
20
23
|
export * from "./document-language.js";
|
|
@@ -31,6 +34,8 @@ export * from "./google-oauth.js";
|
|
|
31
34
|
export * from "./id-safe-truncate.js";
|
|
32
35
|
export * from "./image-capabilities.js";
|
|
33
36
|
export * from "./interactions.js";
|
|
37
|
+
export * from "./interim-forwarded-host.js";
|
|
38
|
+
export * from "./json-security-headers.js";
|
|
34
39
|
export * from "./link-canonicalise.js";
|
|
35
40
|
export * from "./link-refs.js";
|
|
36
41
|
export * from "./lists/index.js";
|
|
@@ -64,11 +69,13 @@ export * from "./run-batched.js";
|
|
|
64
69
|
export * from "./safe-keys.js";
|
|
65
70
|
export * from "./screenshot-capture.js";
|
|
66
71
|
export * from "./seo.js";
|
|
72
|
+
export * from "./session-cookie.js";
|
|
67
73
|
export * from "./skills.js";
|
|
68
74
|
export * from "./snapshots.js";
|
|
69
75
|
export * from "./source-text-transport.js";
|
|
70
76
|
export * from "./stage-status.js";
|
|
71
77
|
export * from "./staging-gate.js";
|
|
78
|
+
export * from "./staging-plugin-stub.js";
|
|
72
79
|
export * from "./static-cache-policy.js";
|
|
73
80
|
export * from "./static-security-headers.js";
|
|
74
81
|
export * from "./strip-cdata.js";
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* FIXME(issue #1331): the header the MCP-Auth-Proxy's interim forwarder
|
|
3
|
+
* (apps/mcp-auth-proxy server.ts) sets to the host a client asked for, and
|
|
4
|
+
* the visitor gateway's staging gate (apps/api-gateway staging-proxy.ts)
|
|
5
|
+
* reads. One name for both ends of the contract.
|
|
6
|
+
*
|
|
7
|
+
* On gcp-firebase the Cloud Run service `gateway` became the MCP-Auth-Proxy
|
|
8
|
+
* (#1328, E13 a), while an existing staging domain mapping (#650) and the
|
|
9
|
+
* live release's Firebase `/api/**` rewrite still point at it. The proxy
|
|
10
|
+
* streams that traffic to the data gateway's run.app URL; Cloud Run routes
|
|
11
|
+
* by Host, so the original host travels in this header. Removed with the
|
|
12
|
+
* staging cutover (P3b-3).
|
|
13
|
+
*/
|
|
14
|
+
export declare const INTERIM_FORWARDED_HOST_HEADER = "x-caelo-forwarded-host";
|
|
15
|
+
//# sourceMappingURL=interim-forwarded-host.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interim-forwarded-host.d.ts","sourceRoot":"","sources":["../src/interim-forwarded-host.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,6BAA6B,2BAA2B,CAAC"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
// SPDX-License-Identifier: MPL-2.0
|
|
2
|
+
/**
|
|
3
|
+
* FIXME(issue #1331): the header the MCP-Auth-Proxy's interim forwarder
|
|
4
|
+
* (apps/mcp-auth-proxy server.ts) sets to the host a client asked for, and
|
|
5
|
+
* the visitor gateway's staging gate (apps/api-gateway staging-proxy.ts)
|
|
6
|
+
* reads. One name for both ends of the contract.
|
|
7
|
+
*
|
|
8
|
+
* On gcp-firebase the Cloud Run service `gateway` became the MCP-Auth-Proxy
|
|
9
|
+
* (#1328, E13 a), while an existing staging domain mapping (#650) and the
|
|
10
|
+
* live release's Firebase `/api/**` rewrite still point at it. The proxy
|
|
11
|
+
* streams that traffic to the data gateway's run.app URL; Cloud Run routes
|
|
12
|
+
* by Host, so the original host travels in this header. Removed with the
|
|
13
|
+
* staging cutover (P3b-3).
|
|
14
|
+
*/
|
|
15
|
+
export const INTERIM_FORWARDED_HOST_HEADER = "x-caelo-forwarded-host";
|
|
16
|
+
//# sourceMappingURL=interim-forwarded-host.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"interim-forwarded-host.js","sourceRoot":"","sources":["../src/interim-forwarded-host.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,wBAAwB,CAAC"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Security headers of a public service's JSON answers (#1326, #763 L2): the
|
|
3
|
+
* visitor gateway's and the MCP-Auth-Proxy's (#1328).
|
|
4
|
+
*
|
|
5
|
+
* A JSON answer is data, never a document: it must not be sniffed into
|
|
6
|
+
* HTML or script, framed, or handed to another origin's page. The headers
|
|
7
|
+
* say so to the browser on every JSON response, whichever route produced
|
|
8
|
+
* it. Pure Web APIs, so both services share the one definition.
|
|
9
|
+
*/
|
|
10
|
+
/** The headers every JSON response carries. */
|
|
11
|
+
export declare const JSON_SECURITY_HEADERS: Readonly<Record<string, string>>;
|
|
12
|
+
/** Whether `res` is a JSON answer (any `application/json` or `+json` type). */
|
|
13
|
+
export declare function isJsonResponse(res: Response): boolean;
|
|
14
|
+
/** Set the {@link JSON_SECURITY_HEADERS} on `headers`, keeping a value already set. */
|
|
15
|
+
export declare function addJsonSecurityHeaders(headers: Headers): void;
|
|
16
|
+
/**
|
|
17
|
+
* `res` with the JSON security headers when it is JSON, else `res` as it
|
|
18
|
+
* is. A response whose headers are immutable (one passed through from a
|
|
19
|
+
* `fetch`) is rebuilt around the same body stream, so a streamed answer
|
|
20
|
+
* stays streamed.
|
|
21
|
+
*/
|
|
22
|
+
export declare function withJsonSecurityHeaders(res: Response): Response;
|
|
23
|
+
//# sourceMappingURL=json-security-headers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"json-security-headers.d.ts","sourceRoot":"","sources":["../src/json-security-headers.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOlE,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAGrD;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAI7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAW/D"}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
// SPDX-License-Identifier: MPL-2.0
|
|
2
|
+
/**
|
|
3
|
+
* Security headers of a public service's JSON answers (#1326, #763 L2): the
|
|
4
|
+
* visitor gateway's and the MCP-Auth-Proxy's (#1328).
|
|
5
|
+
*
|
|
6
|
+
* A JSON answer is data, never a document: it must not be sniffed into
|
|
7
|
+
* HTML or script, framed, or handed to another origin's page. The headers
|
|
8
|
+
* say so to the browser on every JSON response, whichever route produced
|
|
9
|
+
* it. Pure Web APIs, so both services share the one definition.
|
|
10
|
+
*/
|
|
11
|
+
/** The headers every JSON response carries. */
|
|
12
|
+
export const JSON_SECURITY_HEADERS = {
|
|
13
|
+
"X-Content-Type-Options": "nosniff",
|
|
14
|
+
// Nothing in a JSON answer may load or run anything, nor be framed.
|
|
15
|
+
"Content-Security-Policy": "default-src 'none'; frame-ancestors 'none'",
|
|
16
|
+
"X-Frame-Options": "DENY",
|
|
17
|
+
"Referrer-Policy": "no-referrer",
|
|
18
|
+
"Cross-Origin-Resource-Policy": "same-origin",
|
|
19
|
+
};
|
|
20
|
+
/** Whether `res` is a JSON answer (any `application/json` or `+json` type). */
|
|
21
|
+
export function isJsonResponse(res) {
|
|
22
|
+
const type = (res.headers.get("content-type") ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
|
|
23
|
+
return type === "application/json" || type.endsWith("+json");
|
|
24
|
+
}
|
|
25
|
+
/** Set the {@link JSON_SECURITY_HEADERS} on `headers`, keeping a value already set. */
|
|
26
|
+
export function addJsonSecurityHeaders(headers) {
|
|
27
|
+
for (const [name, value] of Object.entries(JSON_SECURITY_HEADERS)) {
|
|
28
|
+
if (!headers.has(name))
|
|
29
|
+
headers.set(name, value);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* `res` with the JSON security headers when it is JSON, else `res` as it
|
|
34
|
+
* is. A response whose headers are immutable (one passed through from a
|
|
35
|
+
* `fetch`) is rebuilt around the same body stream, so a streamed answer
|
|
36
|
+
* stays streamed.
|
|
37
|
+
*/
|
|
38
|
+
export function withJsonSecurityHeaders(res) {
|
|
39
|
+
if (!isJsonResponse(res))
|
|
40
|
+
return res;
|
|
41
|
+
if (Object.keys(JSON_SECURITY_HEADERS).every((h) => res.headers.has(h)))
|
|
42
|
+
return res;
|
|
43
|
+
try {
|
|
44
|
+
addJsonSecurityHeaders(res.headers);
|
|
45
|
+
return res;
|
|
46
|
+
}
|
|
47
|
+
catch {
|
|
48
|
+
const headers = new Headers(res.headers);
|
|
49
|
+
addJsonSecurityHeaders(headers);
|
|
50
|
+
return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
//# sourceMappingURL=json-security-headers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"json-security-headers.js","sourceRoot":"","sources":["../src/json-security-headers.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;GAQG;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAqC;IACrE,wBAAwB,EAAE,SAAS;IACnC,oEAAoE;IACpE,yBAAyB,EAAE,4CAA4C;IACvE,iBAAiB,EAAE,MAAM;IACzB,iBAAiB,EAAE,aAAa;IAChC,8BAA8B,EAAE,aAAa;CAC9C,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,GAAa;IAC1C,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/F,OAAO,IAAI,KAAK,kBAAkB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAa;IACnD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACrC,IAAI,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC;IACpF,IAAI,CAAC;QACH,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC"}
|
package/dist/pool-budget.d.ts
CHANGED
|
@@ -66,6 +66,16 @@ export declare const LISTEN_CONNECTIONS_PER_ADMIN_INSTANCE = 1;
|
|
|
66
66
|
* gateway's pool, held for the instance's lifetime.
|
|
67
67
|
*/
|
|
68
68
|
export declare const LISTEN_CONNECTIONS_PER_GATEWAY_INSTANCE = 1;
|
|
69
|
+
/**
|
|
70
|
+
* #1338 — public_role's `CONNECTION LIMIT` (cms_admin migration 0500,
|
|
71
|
+
* bootstrap.sh; the role audit's `PUBLIC_ROLE_LIMITS` pins the same value):
|
|
72
|
+
* the gateway's share at ten instances, `10 × (GATEWAY_POOL_MAX +
|
|
73
|
+
* LISTEN_CONNECTIONS_PER_GATEWAY_INSTANCE)`. The database refuses the
|
|
74
|
+
* gateway's connections beyond it, so {@link computePoolBudget} refuses a
|
|
75
|
+
* scale-out that would need more instead of letting instances fail to
|
|
76
|
+
* connect under load.
|
|
77
|
+
*/
|
|
78
|
+
export declare const GATEWAY_ROLE_CONNECTION_LIMIT = 30;
|
|
69
79
|
/** What the budget is computed from: the server and the scale-out limits. */
|
|
70
80
|
export interface PoolBudgetInput {
|
|
71
81
|
/** The server's `max_connections`, as provisioning sets it. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pool-budget.d.ts","sourceRoot":"","sources":["../src/pool-budget.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iGAAiG;AACjG,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AAEjE,mFAAmF;AACnF,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,uCAAuC,IAAI,CAAC;AAEzD,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mFAAmF;IACnF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,mDAAmD;IACnD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4FAA4F;AAC5F,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,YAAY,GACZ,MAAM,GACN,WAAW,GACX,SAAS;AACX,wGAAwG;GACtG,QAAQ;AACV,iHAAiH;GAC/G,gBAAgB,GAChB,cAAc,CAAC;AAEnB,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,qFAAqF;IACrF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,
|
|
1
|
+
{"version":3,"file":"pool-budget.d.ts","sourceRoot":"","sources":["../src/pool-budget.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iGAAiG;AACjG,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AAEjE,mFAAmF;AACnF,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,uCAAuC,IAAI,CAAC;AAEzD;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mFAAmF;IACnF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,mDAAmD;IACnD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4FAA4F;AAC5F,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,YAAY,GACZ,MAAM,GACN,WAAW,GACX,SAAS;AACX,wGAAwG;GACtG,QAAQ;AACV,iHAAiH;GAC/G,gBAAgB,GAChB,cAAc,CAAC;AAEnB,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,qFAAqF;IACrF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAqDpE;AAED,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAQrD"}
|
package/dist/pool-budget.js
CHANGED
|
@@ -67,6 +67,16 @@ export const LISTEN_CONNECTIONS_PER_ADMIN_INSTANCE = 1;
|
|
|
67
67
|
* gateway's pool, held for the instance's lifetime.
|
|
68
68
|
*/
|
|
69
69
|
export const LISTEN_CONNECTIONS_PER_GATEWAY_INSTANCE = 1;
|
|
70
|
+
/**
|
|
71
|
+
* #1338 — public_role's `CONNECTION LIMIT` (cms_admin migration 0500,
|
|
72
|
+
* bootstrap.sh; the role audit's `PUBLIC_ROLE_LIMITS` pins the same value):
|
|
73
|
+
* the gateway's share at ten instances, `10 × (GATEWAY_POOL_MAX +
|
|
74
|
+
* LISTEN_CONNECTIONS_PER_GATEWAY_INSTANCE)`. The database refuses the
|
|
75
|
+
* gateway's connections beyond it, so {@link computePoolBudget} refuses a
|
|
76
|
+
* scale-out that would need more instead of letting instances fail to
|
|
77
|
+
* connect under load.
|
|
78
|
+
*/
|
|
79
|
+
export const GATEWAY_ROLE_CONNECTION_LIMIT = 30;
|
|
70
80
|
function positiveInteger(value, name, min) {
|
|
71
81
|
if (!Number.isInteger(value) || value < min) {
|
|
72
82
|
throw new Error(`pool budget: ${name} must be an integer >= ${min} (got ${value})`);
|
|
@@ -99,6 +109,11 @@ export function computePoolBudget(input) {
|
|
|
99
109
|
positiveInteger(input.maintenanceReserve, "maintenanceReserve", 0);
|
|
100
110
|
positiveInteger(input.migrationsReserve, "migrationsReserve", 0);
|
|
101
111
|
positiveInteger(input.jobsReserve, "jobsReserve", 0);
|
|
112
|
+
const gatewayConnections = input.gatewayMaxInstances * (GATEWAY_POOL_MAX + LISTEN_CONNECTIONS_PER_GATEWAY_INSTANCE);
|
|
113
|
+
if (gatewayConnections > GATEWAY_ROLE_CONNECTION_LIMIT) {
|
|
114
|
+
throw new Error(`pool budget: ${input.gatewayMaxInstances} gateway instances need ${gatewayConnections} connections, but the database lets the gateway's login (public_role) hold at most ${GATEWAY_ROLE_CONNECTION_LIMIT} (CONNECTION LIMIT, #1338). ` +
|
|
115
|
+
`Lower gatewayMaxInstances to at most ${Math.floor(GATEWAY_ROLE_CONNECTION_LIMIT / (GATEWAY_POOL_MAX + LISTEN_CONNECTIONS_PER_GATEWAY_INSTANCE))}.`);
|
|
116
|
+
}
|
|
102
117
|
const reserves = [
|
|
103
118
|
{ name: "maintenance", connections: input.maintenanceReserve },
|
|
104
119
|
{ name: "migrations", connections: input.migrationsReserve },
|
package/dist/pool-budget.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pool-budget.js","sourceRoot":"","sources":["../src/pool-budget.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iGAAiG;AACjG,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AAEjE,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"pool-budget.js","sourceRoot":"","sources":["../src/pool-budget.ts"],"names":[],"mappings":"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"}
|
|
@@ -84,16 +84,24 @@ export declare function withGcpRedirects(matcher: GcpPathMatcher, plan: Redirect
|
|
|
84
84
|
* @throws {GcpUrlMapBudgetError} when the plan does not fit.
|
|
85
85
|
*/
|
|
86
86
|
export declare function assertGcpRedirectBudget(plan: RedirectPlan, baseRules: readonly GcpPathRule[]): void;
|
|
87
|
+
/** The paths the `gcp` load balancer sends to the visitor gateway: its whole API. */
|
|
88
|
+
export declare const GCP_GATEWAY_PATHS: readonly string[];
|
|
89
|
+
/**
|
|
90
|
+
* #1328 — the paths the `gcp` load balancer sends to the MCP-Auth-Proxy, the
|
|
91
|
+
* remote-MCP broker's own service (#806 put it inside the gateway). The
|
|
92
|
+
* endpoints and the broker's OAuth routes under `/api/mcp/*` — the more
|
|
93
|
+
* specific prefix wins over `/api/*` in one path matcher — and the two
|
|
94
|
+
* `/.well-known/oauth-*` prefixes, the broker's discovery documents, which
|
|
95
|
+
* MCP clients look up at the host root (RFC 9728 protected-resource
|
|
96
|
+
* metadata, RFC 8414 authorization-server metadata); they must reach the
|
|
97
|
+
* proxy, not 404 in the bucket. No `openid-configuration` prefix: the broker
|
|
98
|
+
* is not an OpenID provider and serves no such document (#899), so the site
|
|
99
|
+
* keeps that path.
|
|
100
|
+
*/
|
|
101
|
+
export declare const GCP_MCP_AUTH_PROXY_PATHS: readonly string[];
|
|
87
102
|
/**
|
|
88
103
|
* The site's own routing in the `public` path matcher (stack + budget): the
|
|
89
|
-
* paths the load balancer sends to
|
|
90
|
-
* `/api/*` is the gateway's whole API, the remote-MCP broker included
|
|
91
|
-
* (#806). The two `/.well-known/oauth-*` prefixes are the broker's
|
|
92
|
-
* discovery documents, which MCP clients look up at the host root (RFC 9728
|
|
93
|
-
* protected-resource metadata, RFC 8414 authorization-server metadata) —
|
|
94
|
-
* they must reach the gateway, not 404 in the bucket. No
|
|
95
|
-
* `openid-configuration` prefix: the broker is not an OpenID provider and
|
|
96
|
-
* serves no such document (#899), so the site keeps that path.
|
|
104
|
+
* paths the load balancer sends to a service instead of the static bucket.
|
|
97
105
|
*/
|
|
98
106
|
export declare const GCP_PUBLIC_BASE_PATHS: readonly string[];
|
|
99
107
|
//# sourceMappingURL=redirect-emit-gcp.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"redirect-emit-gcp.d.ts","sourceRoot":"","sources":["../src/redirect-emit-gcp.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAmB,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAE5F,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAU/C,MAAM,MAAM,uBAAuB,GAC/B,2BAA2B,GAC3B,OAAO,GACP,WAAW,GACX,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,uBAAuB,CAAC;QACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACjC,CAAC;IACF,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,2EAA2E;AAC3E,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,aAAa,EAAE,MAAM;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAFnB,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM;CAO/B;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,EAAE,CAEtE;AAwBD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAc5F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,IAAI,CAEN;AAED
|
|
1
|
+
{"version":3,"file":"redirect-emit-gcp.d.ts","sourceRoot":"","sources":["../src/redirect-emit-gcp.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAmB,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAE5F,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAU/C,MAAM,MAAM,uBAAuB,GAC/B,2BAA2B,GAC3B,OAAO,GACP,WAAW,GACX,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,uBAAuB,CAAC;QACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACjC,CAAC;IACF,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,2EAA2E;AAC3E,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,aAAa,EAAE,MAAM;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM;gBAFnB,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM;CAO/B;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,EAAE,CAEtE;AAwBD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,cAAc,CAc5F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,IAAI,CAEN;AAED,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAe,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAIrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAGlD,CAAC"}
|
|
@@ -86,20 +86,31 @@ export function withGcpRedirects(matcher, plan) {
|
|
|
86
86
|
export function assertGcpRedirectBudget(plan, baseRules) {
|
|
87
87
|
withGcpRedirects({ name: "budget-check", pathRules: baseRules }, plan);
|
|
88
88
|
}
|
|
89
|
+
/** The paths the `gcp` load balancer sends to the visitor gateway: its whole API. */
|
|
90
|
+
export const GCP_GATEWAY_PATHS = ["/api/*"];
|
|
89
91
|
/**
|
|
90
|
-
*
|
|
91
|
-
*
|
|
92
|
-
*
|
|
93
|
-
*
|
|
94
|
-
*
|
|
95
|
-
*
|
|
96
|
-
*
|
|
97
|
-
* `openid-configuration` prefix: the broker
|
|
98
|
-
* serves no such document (#899), so the site
|
|
92
|
+
* #1328 — the paths the `gcp` load balancer sends to the MCP-Auth-Proxy, the
|
|
93
|
+
* remote-MCP broker's own service (#806 put it inside the gateway). The
|
|
94
|
+
* endpoints and the broker's OAuth routes under `/api/mcp/*` — the more
|
|
95
|
+
* specific prefix wins over `/api/*` in one path matcher — and the two
|
|
96
|
+
* `/.well-known/oauth-*` prefixes, the broker's discovery documents, which
|
|
97
|
+
* MCP clients look up at the host root (RFC 9728 protected-resource
|
|
98
|
+
* metadata, RFC 8414 authorization-server metadata); they must reach the
|
|
99
|
+
* proxy, not 404 in the bucket. No `openid-configuration` prefix: the broker
|
|
100
|
+
* is not an OpenID provider and serves no such document (#899), so the site
|
|
101
|
+
* keeps that path.
|
|
99
102
|
*/
|
|
100
|
-
export const
|
|
101
|
-
"/api/*",
|
|
103
|
+
export const GCP_MCP_AUTH_PROXY_PATHS = [
|
|
104
|
+
"/api/mcp/*",
|
|
102
105
|
"/.well-known/oauth-protected-resource/*",
|
|
103
106
|
"/.well-known/oauth-authorization-server/*",
|
|
104
107
|
];
|
|
108
|
+
/**
|
|
109
|
+
* The site's own routing in the `public` path matcher (stack + budget): the
|
|
110
|
+
* paths the load balancer sends to a service instead of the static bucket.
|
|
111
|
+
*/
|
|
112
|
+
export const GCP_PUBLIC_BASE_PATHS = [
|
|
113
|
+
...GCP_GATEWAY_PATHS,
|
|
114
|
+
...GCP_MCP_AUTH_PROXY_PATHS,
|
|
115
|
+
];
|
|
105
116
|
//# sourceMappingURL=redirect-emit-gcp.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"redirect-emit-gcp.js","sourceRoot":"","sources":["../src/redirect-emit-gcp.ts"],"names":[],"mappings":"AAAA,mCAAmC;AA+BnC,wEAAwE;AACxE,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,iEAAiE;AACjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,4DAA4D;AAC5D,MAAM,aAAa,GAAwD;IACzE,GAAG,EAAE,2BAA2B;IAChC,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,oBAAoB;CAC1B,CAAC;AA8BF,2EAA2E;AAC3E,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAElC;IACA;IACA;IAHX,YACW,aAAqB,EACrB,gBAAwB,EACxB,WAAmB;QAE5B,KAAK,CACH,wCAAwC,0BAA0B,uBAAuB,0BAA0B,wDAAwD,aAAa,qBAAqB,gBAAgB,cAAc,WAAW,2cAA2c,CAClsB,CAAC;QANO,kBAAa,GAAb,aAAa,CAAQ;QACrB,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,gBAAW,GAAX,WAAW,CAAQ;QAK5B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,CAAkB;IACpC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,4IAA4I,CAC9M,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,mCAAmC,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,QAAQ,iLAAiL,CAC/O,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;QACxB,WAAW,EAAE;YACX,YAAY,EAAE,CAAC,CAAC,QAAQ;YACxB,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;YACjD,kEAAkE;YAClE,UAAU,EAAE,KAAK;SAClB;KACF,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,OAAO,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB,EAAE,IAAkB;IAC1E,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,2MAA2M,CAC3Q,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,IAAI,UAAU,GAAG,0BAA0B,IAAI,SAAS,CAAC,MAAM,GAAG,0BAA0B,EAAE,CAAC;QAC7F,MAAM,IAAI,oBAAoB,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAkB,EAClB,SAAiC;IAEjC,gBAAgB,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;AACzE,CAAC;AAED
|
|
1
|
+
{"version":3,"file":"redirect-emit-gcp.js","sourceRoot":"","sources":["../src/redirect-emit-gcp.ts"],"names":[],"mappings":"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"}
|
|
@@ -14,9 +14,23 @@ import { z } from "zod";
|
|
|
14
14
|
/** Release channels. Pre-release versions name theirs (`0.11.0-rc.1` → `rc`). */
|
|
15
15
|
export declare const RELEASE_CHANNELS: readonly ["stable", "rc", "beta", "alpha"];
|
|
16
16
|
export type ReleaseChannel = (typeof RELEASE_CHANNELS)[number];
|
|
17
|
-
/**
|
|
18
|
-
|
|
17
|
+
/**
|
|
18
|
+
* The services a release ships images for. Every release cut from now on
|
|
19
|
+
* signs all of them (scripts/release-manifest.ts requires a digest each);
|
|
20
|
+
* `mcp-auth-proxy` (#1328) is the one manifests of older releases lack —
|
|
21
|
+
* see {@link OPTIONAL_RELEASE_IMAGES}.
|
|
22
|
+
*/
|
|
23
|
+
export declare const RELEASE_IMAGES: readonly ["admin", "gateway", "ops", "mcp-auth-proxy"];
|
|
19
24
|
export type ReleaseImage = (typeof RELEASE_IMAGES)[number];
|
|
25
|
+
/**
|
|
26
|
+
* Images a signed manifest may lack because they were added after
|
|
27
|
+
* releases that are still installable or rolled back to: the
|
|
28
|
+
* MCP-Auth-Proxy got its own image in #1328, so every manifest signed
|
|
29
|
+
* before it names none. Optional in the schema (manifestVersion stays 1;
|
|
30
|
+
* readers older than the key strip it as an unknown key), required by the
|
|
31
|
+
* release script for every new release.
|
|
32
|
+
*/
|
|
33
|
+
export declare const OPTIONAL_RELEASE_IMAGES: readonly ReleaseImage[];
|
|
20
34
|
/** A `sha256:<64 hex>` image / blob digest. */
|
|
21
35
|
export declare const IMAGE_DIGEST: RegExp;
|
|
22
36
|
/** The longest `ownerAction` a release may declare: one sentence. */
|
|
@@ -35,11 +49,13 @@ export declare const ReleaseManifestSchema: z.ZodObject<{
|
|
|
35
49
|
admin: z.ZodString;
|
|
36
50
|
gateway: z.ZodString;
|
|
37
51
|
ops: z.ZodString;
|
|
52
|
+
"mcp-auth-proxy": z.ZodOptional<z.ZodString>;
|
|
38
53
|
}, z.core.$strip>;
|
|
39
54
|
platformDigests: z.ZodOptional<z.ZodObject<{
|
|
40
55
|
admin: z.ZodString;
|
|
41
56
|
gateway: z.ZodString;
|
|
42
57
|
ops: z.ZodString;
|
|
58
|
+
"mcp-auth-proxy": z.ZodOptional<z.ZodString>;
|
|
43
59
|
}, z.core.$strip>>;
|
|
44
60
|
minFromVersion: z.ZodString;
|
|
45
61
|
infraContractVersion: z.ZodNumber;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"release-manifest.d.ts","sourceRoot":"","sources":["../src/release-manifest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,4CAA6C,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D
|
|
1
|
+
{"version":3,"file":"release-manifest.d.ts","sourceRoot":"","sources":["../src/release-manifest.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,4CAA6C,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,wDAAyD,CAAC;AACrF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,YAAY,EAAuB,CAAC;AAEnF,+CAA+C;AAC/C,eAAO,MAAM,YAAY,QAA0B,CAAC;AAOpD,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,iEAAiE;AACjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2DhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AACvE,yFAAyF;AACzF,eAAO,MAAM,2BAA2B,oDAAoD,CAAC;AAE7F,oEAAoE;AACpE,eAAO,MAAM,8BAA8B,8CAA8C,CAAC;AAC1F,eAAO,MAAM,2BAA2B,mDAAmD,CAAC;AAC5F,eAAO,MAAM,0BAA0B,kDAAkD,CAAC;AAE1F,wCAAwC;AACxC,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAErF,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEjE,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvE,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAiCD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAkEhC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GAEb;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuBjG"}
|
package/dist/release-manifest.js
CHANGED
|
@@ -14,8 +14,22 @@
|
|
|
14
14
|
import { z } from "zod";
|
|
15
15
|
/** Release channels. Pre-release versions name theirs (`0.11.0-rc.1` → `rc`). */
|
|
16
16
|
export const RELEASE_CHANNELS = ["stable", "rc", "beta", "alpha"];
|
|
17
|
-
/**
|
|
18
|
-
|
|
17
|
+
/**
|
|
18
|
+
* The services a release ships images for. Every release cut from now on
|
|
19
|
+
* signs all of them (scripts/release-manifest.ts requires a digest each);
|
|
20
|
+
* `mcp-auth-proxy` (#1328) is the one manifests of older releases lack —
|
|
21
|
+
* see {@link OPTIONAL_RELEASE_IMAGES}.
|
|
22
|
+
*/
|
|
23
|
+
export const RELEASE_IMAGES = ["admin", "gateway", "ops", "mcp-auth-proxy"];
|
|
24
|
+
/**
|
|
25
|
+
* Images a signed manifest may lack because they were added after
|
|
26
|
+
* releases that are still installable or rolled back to: the
|
|
27
|
+
* MCP-Auth-Proxy got its own image in #1328, so every manifest signed
|
|
28
|
+
* before it names none. Optional in the schema (manifestVersion stays 1;
|
|
29
|
+
* readers older than the key strip it as an unknown key), required by the
|
|
30
|
+
* release script for every new release.
|
|
31
|
+
*/
|
|
32
|
+
export const OPTIONAL_RELEASE_IMAGES = ["mcp-auth-proxy"];
|
|
19
33
|
/** A `sha256:<64 hex>` image / blob digest. */
|
|
20
34
|
export const IMAGE_DIGEST = /^sha256:[0-9a-f]{64}$/;
|
|
21
35
|
const SEMVER = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/;
|
|
@@ -28,7 +42,13 @@ export const ReleaseManifestSchema = z.object({
|
|
|
28
42
|
manifestVersion: z.literal(1),
|
|
29
43
|
version: z.string().regex(SEMVER, "expected a SemVer version without a leading v"),
|
|
30
44
|
channel: z.enum(RELEASE_CHANNELS),
|
|
31
|
-
digests: z.object({
|
|
45
|
+
digests: z.object({
|
|
46
|
+
admin: digest,
|
|
47
|
+
gateway: digest,
|
|
48
|
+
ops: digest,
|
|
49
|
+
/** Absent on releases before #1328 (see {@link OPTIONAL_RELEASE_IMAGES}). */
|
|
50
|
+
"mcp-auth-proxy": digest.optional(),
|
|
51
|
+
}),
|
|
32
52
|
/**
|
|
33
53
|
* #1025 — the linux/amd64 platform manifest inside each image index of
|
|
34
54
|
* `digests`. The release images are OCI indexes (buildx adds an
|
|
@@ -41,7 +61,15 @@ export const ReleaseManifestSchema = z.object({
|
|
|
41
61
|
* and older readers ignore it; readers then list the index itself
|
|
42
62
|
* (content-addressed, so it cannot be forged either).
|
|
43
63
|
*/
|
|
44
|
-
platformDigests: z
|
|
64
|
+
platformDigests: z
|
|
65
|
+
.object({
|
|
66
|
+
admin: digest,
|
|
67
|
+
gateway: digest,
|
|
68
|
+
ops: digest,
|
|
69
|
+
/** Absent on releases before #1328 (see {@link OPTIONAL_RELEASE_IMAGES}). */
|
|
70
|
+
"mcp-auth-proxy": digest.optional(),
|
|
71
|
+
})
|
|
72
|
+
.optional(),
|
|
45
73
|
minFromVersion: z.string().regex(SEMVER),
|
|
46
74
|
infraContractVersion: z.number().int().positive(),
|
|
47
75
|
migrations: z.object({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"release-manifest.js","sourceRoot":"","sources":["../src/release-manifest.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAG3E
|
|
1
|
+
{"version":3,"file":"release-manifest.js","sourceRoot":"","sources":["../src/release-manifest.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The one cookie the API gateway reads from a visitor's browser:
|
|
3
|
+
* `__session`, a container of named entries (#1343).
|
|
4
|
+
*
|
|
5
|
+
* ## Why one cookie, and why this name
|
|
6
|
+
*
|
|
7
|
+
* Firebase Hosting forwards exactly one cookie over a rewrite to Cloud Run,
|
|
8
|
+
* the one named `__session`, and strips every other
|
|
9
|
+
* (docs/dev/firebase-hosting-behaviour.md, section 1). On gcp-firebase a
|
|
10
|
+
* gateway cookie by any other name is set in the browser and never comes
|
|
11
|
+
* back. Every provider uses the same container (CLAUDE.md §11.B: one shape
|
|
12
|
+
* per tier), so no provider has a code path of its own and a site moved
|
|
13
|
+
* between providers keeps its visitors' state.
|
|
14
|
+
*
|
|
15
|
+
* ## Shape
|
|
16
|
+
*
|
|
17
|
+
* The cookie value is a URI-encoded `URLSearchParams` string, one parameter
|
|
18
|
+
* per entry: `<key>=<expiresAt>.<value>`. Known keys are in
|
|
19
|
+
* {@link SESSION_ENTRY}; each belongs to one owner, which writes, reads and
|
|
20
|
+
* verifies its own entry's value:
|
|
21
|
+
*
|
|
22
|
+
* - `vid` the visitor id (gateway, only with consent, #677)
|
|
23
|
+
* - `login` the visitor's login session (gateway, for the auth plugin)
|
|
24
|
+
* - `staging` reserved for the staging gate's session (E13 (a), #763)
|
|
25
|
+
*
|
|
26
|
+
* A component that updates one entry keeps every other entry it received,
|
|
27
|
+
* so entries of different owners never clash.
|
|
28
|
+
*
|
|
29
|
+
* ## What is and is not protected
|
|
30
|
+
*
|
|
31
|
+
* The container itself is not signed: `expiresAt` is metadata that sets the
|
|
32
|
+
* browser's Max-Age and lets the reader drop an entry that has run out.
|
|
33
|
+
* Changing it buys a client nothing it could not do anyway (keep or drop its
|
|
34
|
+
* own cookie). Every entry VALUE must carry its own integrity check, made
|
|
35
|
+
* and checked by its owner (the gateway HMAC-signs `vid` and `login` with
|
|
36
|
+
* its cookie secret and bounds their age itself).
|
|
37
|
+
*/
|
|
38
|
+
/** The cookie name, the only one Firebase Hosting passes through a rewrite. */
|
|
39
|
+
export declare const SESSION_COOKIE_NAME = "__session";
|
|
40
|
+
/** The entries the container holds, by owner. */
|
|
41
|
+
export declare const SESSION_ENTRY: {
|
|
42
|
+
/** The gateway's visitor id, set only with the visitor's consent (#677). */
|
|
43
|
+
readonly visitorId: "vid";
|
|
44
|
+
/** The gateway's signed visitor login session (auth plugin). */
|
|
45
|
+
readonly login: "login";
|
|
46
|
+
/** Reserved for the staging gate's session cookie (E13 (a), #763). */
|
|
47
|
+
readonly staging: "staging";
|
|
48
|
+
};
|
|
49
|
+
/** One entry: an owner-verified value and when it runs out. */
|
|
50
|
+
export interface SessionEntry {
|
|
51
|
+
readonly value: string;
|
|
52
|
+
/** Unix seconds. Not authenticated; see the module comment. */
|
|
53
|
+
readonly expiresAt: number;
|
|
54
|
+
}
|
|
55
|
+
/** Entries by key, as {@link readSessionCookie} returns them. */
|
|
56
|
+
export type SessionEntries = ReadonlyMap<string, SessionEntry>;
|
|
57
|
+
/**
|
|
58
|
+
* Parse the request's `__session` container.
|
|
59
|
+
*
|
|
60
|
+
* Visitor-controlled input: a malformed container, entry or value, a key
|
|
61
|
+
* not in {@link SESSION_ENTRY} and a repeated key are left out rather than
|
|
62
|
+
* failing the request, and an entry past its `expiresAt` is left out too.
|
|
63
|
+
* The caller still verifies each value it uses.
|
|
64
|
+
*
|
|
65
|
+
* @param cookieHeader the request's `Cookie` header.
|
|
66
|
+
* @param nowSeconds the current time, unix seconds.
|
|
67
|
+
*/
|
|
68
|
+
export declare function readSessionCookie(cookieHeader: string | null, nowSeconds: number): SessionEntries;
|
|
69
|
+
/**
|
|
70
|
+
* Serialise entries into a `__session` cookie value (URI-encoded).
|
|
71
|
+
*
|
|
72
|
+
* @throws on a key or value {@link readSessionCookie} would not read back:
|
|
73
|
+
* an owner writing one is a bug, not visitor input.
|
|
74
|
+
*/
|
|
75
|
+
export declare function sessionCookieValue(entries: SessionEntries): string;
|
|
76
|
+
/**
|
|
77
|
+
* The `Set-Cookie` header that stores `entries` as the `__session`
|
|
78
|
+
* container, or expires it when no entry is left.
|
|
79
|
+
*
|
|
80
|
+
* HttpOnly and SameSite=Lax always; Secure when `secure` (every deployed
|
|
81
|
+
* environment — plain-http local development cannot keep a Secure cookie).
|
|
82
|
+
* Max-Age follows the longest-lived entry.
|
|
83
|
+
*/
|
|
84
|
+
export declare function sessionSetCookieHeader(entries: SessionEntries, opts: {
|
|
85
|
+
readonly nowSeconds: number;
|
|
86
|
+
readonly secure: boolean;
|
|
87
|
+
}): string;
|
|
88
|
+
//# sourceMappingURL=session-cookie.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"session-cookie.d.ts","sourceRoot":"","sources":["../src/session-cookie.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,iDAAiD;AACjD,eAAO,MAAM,aAAa;IACxB,4EAA4E;;IAE5E,gEAAgE;;IAEhE,sEAAsE;;CAE9D,CAAC;AAEX,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAwB/D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAqBjG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAWlE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC9D,MAAM,CAaR"}
|