@geekmidas/manifest 10.0.0-alpha.155 → 10.0.0-alpha.157

package/dist/index.cjs

@@ -1389,6 +1389,59 @@ function drawSecret(pick, format = {}) {
 	return chars.join("");
 }
 //#endregion
+//#region src/websocket.ts
+/**
+* The `apigateway://` string a `WebSocketApi`'s publisher reads on AWS.
+*
+* Here because two packages meet on it: `@geekmidas/cloud` composes it from
+* the API Gateway WebSocket API and the connection table it provisioned, and
+* `@geekmidas/constructs` parses it to reach them. One codec, so the two
+* cannot disagree about a parameter's name.
+*
+* On a server stage the same key is a `redis://` string — whichever replica
+* holds the socket delivers. On AWS the gateway holds every socket: a send is
+* a call to its management API, and a broadcast reads the ids it would fan out
+* to from the table.
+*/
+const API_GATEWAY_WEBSOCKET_SCHEME = "apigateway:";
+/**
+* `apigateway://<region>?endpoint=<management url>&table=<name>[&tableEndpoint=<url>]`
+*/
+function apiGatewayWebSocketUrl(target) {
+	const query = new URLSearchParams({
+		endpoint: target.endpoint,
+		table: target.table,
+		...target.tableEndpoint ? { tableEndpoint: target.tableEndpoint } : {}
+	});
+	return `${API_GATEWAY_WEBSOCKET_SCHEME}//${target.region}?${query}`;
+}
+/** An `apigateway://` string missing what a publisher needs to reach a socket. */
+var InvalidApiGatewayWebSocketUrl = class extends Error {
+	missing;
+	constructor(missing) {
+		super(`An apigateway:// WebSocket publisher string needs its ${missing}. gkm composes it as <ID>_PUBLISHER_CONNECTION_STRING on an AWS stage — read it from there rather than writing one by hand.`);
+		this.missing = missing;
+		this.name = "InvalidApiGatewayWebSocketUrl";
+	}
+};
+/** What an `apigateway://` string names. */
+function parseApiGatewayWebSocketUrl(value) {
+	const url = new URL(value);
+	if (url.protocol !== "apigateway:" || !url.hostname) throw new InvalidApiGatewayWebSocketUrl("region");
+	const endpoint = url.searchParams.get("endpoint");
+	if (!endpoint) throw new InvalidApiGatewayWebSocketUrl("endpoint");
+	const table = url.searchParams.get("table");
+	if (!table) throw new InvalidApiGatewayWebSocketUrl("table");
+	const tableEndpoint = url.searchParams.get("tableEndpoint");
+	return {
+		region: url.hostname,
+		endpoint,
+		table,
+		...tableEndpoint ? { tableEndpoint } : {}
+	};
+}
+//#endregion
+exports.API_GATEWAY_WEBSOCKET_SCHEME = API_GATEWAY_WEBSOCKET_SCHEME;
 exports.CLIENT_IP_HEADER = CLIENT_IP_HEADER;
 exports.DATABASE_FOLDERS = DATABASE_FOLDERS;
 exports.DEFAULT_DERIVED_DAYS = DEFAULT_DERIVED_DAYS;
@@ -1401,6 +1454,7 @@ exports.EDGE_TOKEN_KEY = EDGE_TOKEN_KEY;
 exports.INBOX_EVENT = INBOX_EVENT;
 exports.INBOX_MESSAGES_PREFIX = INBOX_MESSAGES_PREFIX;
 exports.IllegalDerivation = IllegalDerivation;
+exports.InvalidApiGatewayWebSocketUrl = InvalidApiGatewayWebSocketUrl;
 exports.InvalidConstructId = InvalidConstructId;
 exports.KMS_SCHEME = KMS_SCHEME;
 exports.MIGRATIONS_ROOT = MIGRATIONS_ROOT;
@@ -1412,6 +1466,7 @@ exports.SECRET_SYMBOLS = SECRET_SYMBOLS;
 exports.TELEMETRY_KEYS = TELEMETRY_KEYS;
 exports.UnknownParent = UnknownParent;
 exports.WILDCARD_SUBDOMAIN = WILDCARD_SUBDOMAIN;
+exports.apiGatewayWebSocketUrl = apiGatewayWebSocketUrl;
 exports.assertDerivations = assertDerivations;
 exports.bucketExpiry = bucketExpiry;
 exports.cacheTable = cacheTable;
@@ -1433,6 +1488,7 @@ exports.kmsUrl = kmsUrl;
 exports.migrationFolder = migrationFolder;
 exports.migrationTargets = migrationTargets;
 exports.mobileOrigins = mobileOrigins;
+exports.parseApiGatewayWebSocketUrl = parseApiGatewayWebSocketUrl;
 exports.provideKey = provideKey;
 exports.providedKeyFor = providedKeyFor;
 exports.provisionOrder = provisionOrder;