@geekmidas/manifest 10.0.0-alpha.139 → 10.0.0-alpha.140

package/dist/index.cjs

@@ -79,6 +79,7 @@ const PUBLIC = {
 	objects: [],
 	"file-server": ["url"],
 	email: ["inboxUrl"],
+	inbox: [],
 	database: [],
 	"database-reader": [],
 	"database-schema": [],
@@ -1119,6 +1120,65 @@ var NoUrlForStage = class extends Error {
 */
 const CLIENT_IP_HEADER = "x-gkm-client-ip";
 //#endregion
+//#region src/inbox.ts
+/** The event type a received message is announced as on its inbox's topic. */
+const INBOX_EVENT = "email.received";
+/**
+* Where an inbox's raw messages are kept in its bucket: SES's S3 action
+* writes `<prefix><message id>`, and `gkm dev` and the test mailbox write the
+* same layout.
+*/
+const INBOX_MESSAGES_PREFIX = "messages/";
+/**
+* The recipient `address` is to `inbox` on `domain`, or `undefined` when the
+* inbox does not receive at it.
+*
+* - The local part is a declared address, or one with a `+tag` after it.
+* - Without `subdomains`, the domain is the stage's domain itself; with it,
+*   exactly one label in front of the stage's domain — `acme.fixwell.example`
+*   — and never the bare domain, whose mail would belong to no tenant.
+*
+* Case-insensitive, as mail addresses are in practice.
+*/
+function inboxRecipient(address, inbox, domain) {
+	const normalized = address.trim().toLowerCase();
+	const at = normalized.lastIndexOf("@");
+	if (at <= 0) return void 0;
+	const localPart = normalized.slice(0, at);
+	const host = normalized.slice(at + 1);
+	const base = domain.toLowerCase();
+	let subdomain;
+	if (inbox.subdomains) {
+		if (!host.endsWith(`.${base}`)) return void 0;
+		subdomain = host.slice(0, -(base.length + 1));
+		if (!subdomain || subdomain.includes(".")) return void 0;
+	} else if (host !== base) return;
+	const plus = localPart.indexOf("+");
+	const local = plus === -1 ? localPart : localPart.slice(0, plus);
+	const tag = plus === -1 ? void 0 : localPart.slice(plus + 1);
+	if (!inbox.addresses.some((declared) => declared.toLowerCase() === local)) return;
+	return {
+		address: normalized,
+		local,
+		...tag ? { tag } : {},
+		...subdomain ? { subdomain } : {}
+	};
+}
+/**
+* The recipients a deployed receipt rule names for `inbox` on `domain`.
+*
+* Without `subdomains`, each address on the domain: SES matches an address
+* condition's `+label` variants too, so `requests@` takes `requests+t_8f3k@`.
+* With it, every subdomain (`.fixwell.example`): a condition cannot say
+* "`requests` on any subdomain", so the rule takes the subdomains' mail and
+* the decoder in front of the handler drops what {@link inboxRecipient} does
+* not match.
+*/
+function receiptRecipients(inbox, domain) {
+	const base = domain.toLowerCase();
+	return inbox.subdomains ? [`.${base}`] : inbox.addresses.map((address) => `${address.toLowerCase()}@${base}`);
+}
+//#endregion
 //#region src/migrations.ts
 /** Where every construct's folder lives, from the project root. */
 const MIGRATIONS_ROOT = "db";
@@ -1319,6 +1379,8 @@ exports.DEFAULT_POSTGRES_VERSION = DEFAULT_POSTGRES_VERSION;
 exports.DEFAULT_STAGE_URL = DEFAULT_STAGE_URL;
 exports.DERIVED_PREFIX = DERIVED_PREFIX;
 exports.DERIVES_FROM = DERIVES_FROM;
+exports.INBOX_EVENT = INBOX_EVENT;
+exports.INBOX_MESSAGES_PREFIX = INBOX_MESSAGES_PREFIX;
 exports.IllegalDerivation = IllegalDerivation;
 exports.InvalidConstructId = InvalidConstructId;
 exports.KMS_SCHEME = KMS_SCHEME;
@@ -1343,6 +1405,7 @@ exports.dependentsOf = dependentsOf;
 exports.drawSecret = drawSecret;
 exports.environmentCase = environmentCase;
 exports.externalApiUrl = externalApiUrl;
+exports.inboxRecipient = inboxRecipient;
 exports.isDerived = isDerived;
 exports.isWebOrigin = isWebOrigin;
 exports.isWildcardSite = isWildcardSite;
@@ -1355,6 +1418,7 @@ exports.provideKey = provideKey;
 exports.providedKeyFor = providedKeyFor;
 exports.provisionOrder = provisionOrder;
 exports.publicEnvFor = publicEnvFor;
+exports.receiptRecipients = receiptRecipients;
 exports.schemeBase = schemeBase;
 exports.scopedName = scopedName;
 exports.seedFolder = seedFolder;