quidproquo-webserver 0.1.25 → 0.1.26

package/lib/commonjs/actions/email/EmailActionType.d.ts

@@ -1,4 +1,6 @@
 export declare enum EmailActionType {
     SendEmail = "@quidproquo-webserver/Email/SendEmail",
-    SetDeliveryStatus = "@quidproquo-webserver/Email/SetDeliveryStatus"
+    SetDeliveryStatus = "@quidproquo-webserver/Email/SetDeliveryStatus",
+    Parse = "@quidproquo-webserver/Email/Parse",
+    ReceivingHosts = "@quidproquo-webserver/Email/ReceivingHosts"
 }

package/lib/commonjs/actions/email/EmailActionType.js

@@ -5,5 +5,7 @@ var EmailActionType;
 (function (EmailActionType) {
     EmailActionType["SendEmail"] = "@quidproquo-webserver/Email/SendEmail";
     EmailActionType["SetDeliveryStatus"] = "@quidproquo-webserver/Email/SetDeliveryStatus";
+    EmailActionType["Parse"] = "@quidproquo-webserver/Email/Parse";
+    EmailActionType["ReceivingHosts"] = "@quidproquo-webserver/Email/ReceivingHosts";
 })(EmailActionType || (exports.EmailActionType = EmailActionType = {}));
 //# sourceMappingURL=EmailActionType.js.map

package/lib/commonjs/actions/email/EmailActionType.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmailActionType.js","sourceRoot":"","sources":["../../../../src/actions/email/EmailActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,sEAAmD,CAAA;IACnD,sFAAmE,CAAA;AACrE,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B","sourcesContent":["export enum EmailActionType {\n  SendEmail = '@quidproquo-webserver/Email/SendEmail',\n  SetDeliveryStatus = '@quidproquo-webserver/Email/SetDeliveryStatus',\n}\n"]}
+{"version":3,"file":"EmailActionType.js","sourceRoot":"","sources":["../../../../src/actions/email/EmailActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,sEAAmD,CAAA;IACnD,sFAAmE,CAAA;IACnE,8DAA2C,CAAA;IAC3C,gFAA6D,CAAA;AAC/D,CAAC,EALW,eAAe,+BAAf,eAAe,QAK1B","sourcesContent":["export enum EmailActionType {\n  SendEmail = '@quidproquo-webserver/Email/SendEmail',\n  SetDeliveryStatus = '@quidproquo-webserver/Email/SetDeliveryStatus',\n  Parse = '@quidproquo-webserver/Email/Parse',\n  ReceivingHosts = '@quidproquo-webserver/Email/ReceivingHosts',\n}\n"]}

package/lib/commonjs/actions/email/EmailMessage.d.ts

@@ -0,0 +1,36 @@
+/** One mailbox in a parsed message header. */
+export type EmailMessageAddress = {
+    address: string;
+    name?: string;
+};
+/** A file the message carried, decoded. */
+export type EmailMessageAttachment = {
+    filename?: string;
+    mimeType: string;
+    base64Data: string;
+};
+/**
+ * The provider's verdicts on the message, from its Authentication-Results header. Each is the
+ * raw result token (`pass`, `fail`, `softfail`, `none`, ...) or absent when the provider gave
+ * none. `from` is what the sender claims; these are the only evidence for who actually sent it.
+ */
+export type EmailMessageAuthentication = {
+    spf?: string;
+    dkim?: string;
+    dmarc?: string;
+};
+/** A received message as askEmailParse returns it. */
+export type EmailMessage = {
+    recipients: string[];
+    from: EmailMessageAddress[];
+    to: EmailMessageAddress[];
+    cc: EmailMessageAddress[];
+    replyTo: EmailMessageAddress[];
+    subject: string;
+    text?: string;
+    html?: string;
+    messageId?: string;
+    date?: string;
+    attachments: EmailMessageAttachment[];
+    authentication: EmailMessageAuthentication;
+};

package/lib/commonjs/actions/email/EmailMessage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=EmailMessage.js.map

package/lib/commonjs/actions/email/EmailMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailMessage.js","sourceRoot":"","sources":["../../../../src/actions/email/EmailMessage.ts"],"names":[],"mappings":"","sourcesContent":["/** One mailbox in a parsed message header. */\nexport type EmailMessageAddress = {\n  address: string;\n  name?: string;\n};\n\n/** A file the message carried, decoded. */\nexport type EmailMessageAttachment = {\n  filename?: string;\n  mimeType: string;\n  base64Data: string;\n};\n\n/**\n * The provider's verdicts on the message, from its Authentication-Results header. Each is the\n * raw result token (`pass`, `fail`, `softfail`, `none`, ...) or absent when the provider gave\n * none. `from` is what the sender claims; these are the only evidence for who actually sent it.\n */\nexport type EmailMessageAuthentication = {\n  spf?: string;\n  dkim?: string;\n  dmarc?: string;\n};\n\n/** A received message as askEmailParse returns it. */\nexport type EmailMessage = {\n  // The addresses the provider delivered to (Delivered-To / X-Original-To), lower-cased.\n  // A per-inbox lookup keys on these: the `to` header can name addresses this app never saw.\n  recipients: string[];\n\n  from: EmailMessageAddress[];\n  to: EmailMessageAddress[];\n  cc: EmailMessageAddress[];\n  replyTo: EmailMessageAddress[];\n\n  subject: string;\n  text?: string;\n  html?: string;\n\n  messageId?: string;\n  date?: string;\n  attachments: EmailMessageAttachment[];\n\n  authentication: EmailMessageAuthentication;\n};\n"]}

package/lib/commonjs/actions/email/askEmailParse.d.ts

@@ -0,0 +1,9 @@
+import { EmailActionType } from './EmailActionType';
+import { EmailMessage } from './EmailMessage';
+/**
+ * Parse a raw MIME message (base64, as askFileReadBinaryContents returns an object a
+ * defineEmailReceiver wrote) into an EmailMessage. Pure on every platform.
+ */
+export declare const askEmailParse: import("quidproquo-core").ActionRequesterFunction<EmailActionType.Parse, [rawBase64: string], {
+    rawBase64: string;
+}, EmailMessage, "Invalid">;

package/lib/commonjs/actions/email/askEmailParse.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askEmailParse = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const EmailActionType_1 = require("./EmailActionType");
+/**
+ * Parse a raw MIME message (base64, as askFileReadBinaryContents returns an object a
+ * defineEmailReceiver wrote) into an EmailMessage. Pure on every platform.
+ */
+exports.askEmailParse = (0, quidproquo_core_1.createActionRequester)()({
+    actionType: EmailActionType_1.EmailActionType.Parse,
+    errorTypes: [
+        'Invalid', // the bytes are not a MIME message
+    ],
+    getPayload: (rawBase64) => ({ rawBase64 }),
+});
+//# sourceMappingURL=askEmailParse.js.map

package/lib/commonjs/actions/email/askEmailParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askEmailParse.js","sourceRoot":"","sources":["../../../../src/actions/email/askEmailParse.ts"],"names":[],"mappings":";;;AAAA,qDAAwD;AAExD,uDAAoD;AAGpD;;;GAGG;AACU,QAAA,aAAa,GAAG,IAAA,uCAAqB,GAAgB,CAAC;IACjE,UAAU,EAAE,iCAAe,CAAC,KAAK;IACjC,UAAU,EAAE;QACV,SAAS,EAAE,mCAAmC;KAC/C;IACD,UAAU,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;CACnD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from 'quidproquo-core';\n\nimport { EmailActionType } from './EmailActionType';\nimport { EmailMessage } from './EmailMessage';\n\n/**\n * Parse a raw MIME message (base64, as askFileReadBinaryContents returns an object a\n * defineEmailReceiver wrote) into an EmailMessage. Pure on every platform.\n */\nexport const askEmailParse = createActionRequester<EmailMessage>()({\n  actionType: EmailActionType.Parse,\n  errorTypes: [\n    'Invalid', // the bytes are not a MIME message\n  ],\n  getPayload: (rawBase64: string) => ({ rawBase64 }),\n});\n"]}

package/lib/commonjs/actions/email/askEmailReceivingHosts.d.ts

@@ -0,0 +1,7 @@
+import { EmailActionType } from './EmailActionType';
+/**
+ * The app's receiving hosts (defineEmailReceivingDomain resolved on every root, primary first),
+ * so a story can show a full address for a local part. Empty when the app declares no
+ * receiving domain.
+ */
+export declare const askEmailReceivingHosts: import("quidproquo-core").ActionRequesterFunction<EmailActionType.ReceivingHosts, [], {}, string[], never>;

package/lib/commonjs/actions/email/askEmailReceivingHosts.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askEmailReceivingHosts = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const EmailActionType_1 = require("./EmailActionType");
+/**
+ * The app's receiving hosts (defineEmailReceivingDomain resolved on every root, primary first),
+ * so a story can show a full address for a local part. Empty when the app declares no
+ * receiving domain.
+ */
+exports.askEmailReceivingHosts = (0, quidproquo_core_1.createActionRequester)()({
+    actionType: EmailActionType_1.EmailActionType.ReceivingHosts,
+    getPayload: () => ({}),
+});
+//# sourceMappingURL=askEmailReceivingHosts.js.map

package/lib/commonjs/actions/email/askEmailReceivingHosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askEmailReceivingHosts.js","sourceRoot":"","sources":["../../../../src/actions/email/askEmailReceivingHosts.ts"],"names":[],"mappings":";;;AAAA,qDAAwD;AAExD,uDAAoD;AAEpD;;;;GAIG;AACU,QAAA,sBAAsB,GAAG,IAAA,uCAAqB,GAAY,CAAC;IACtE,UAAU,EAAE,iCAAe,CAAC,cAAc;IAC1C,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;CACvB,CAAC,CAAC","sourcesContent":["import { createActionRequester } from 'quidproquo-core';\n\nimport { EmailActionType } from './EmailActionType';\n\n/**\n * The app's receiving hosts (defineEmailReceivingDomain resolved on every root, primary first),\n * so a story can show a full address for a local part. Empty when the app declares no\n * receiving domain.\n */\nexport const askEmailReceivingHosts = createActionRequester<string[]>()({\n  actionType: EmailActionType.ReceivingHosts,\n  getPayload: () => ({}),\n});\n"]}

package/lib/commonjs/actions/email/index.d.ts

@@ -1,4 +1,7 @@
+export * from './askEmailParse';
+export * from './askEmailReceivingHosts';
 export * from './askEmailSendEmail';
 export * from './askEmailSetDeliveryStatus';
 export * from './EmailActionType';
 export * from './EmailDeliveryStatus';
+export * from './EmailMessage';

package/lib/commonjs/actions/email/index.js

@@ -14,8 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./askEmailParse"), exports);
+__exportStar(require("./askEmailReceivingHosts"), exports);
 __exportStar(require("./askEmailSendEmail"), exports);
 __exportStar(require("./askEmailSetDeliveryStatus"), exports);
 __exportStar(require("./EmailActionType"), exports);
 __exportStar(require("./EmailDeliveryStatus"), exports);
+__exportStar(require("./EmailMessage"), exports);
 //# sourceMappingURL=index.js.map

package/lib/commonjs/actions/email/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/email/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,8DAA4C;AAC5C,oDAAkC;AAClC,wDAAsC","sourcesContent":["export * from './askEmailSendEmail';\nexport * from './askEmailSetDeliveryStatus';\nexport * from './EmailActionType';\nexport * from './EmailDeliveryStatus';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/email/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,2DAAyC;AACzC,sDAAoC;AACpC,8DAA4C;AAC5C,oDAAkC;AAClC,wDAAsC;AACtC,iDAA+B","sourcesContent":["export * from './askEmailParse';\nexport * from './askEmailReceivingHosts';\nexport * from './askEmailSendEmail';\nexport * from './askEmailSetDeliveryStatus';\nexport * from './EmailActionType';\nexport * from './EmailDeliveryStatus';\nexport * from './EmailMessage';\n"]}

package/lib/commonjs/config/QPQConfig.d.ts

@@ -3,6 +3,8 @@ export declare enum QPQWebServerConfigSettingType {
     DefaultRouteOptions = "@quidproquo-webserver/config/DefaultRouteOptions",
     Dns = "@quidproquo-webserver/config/Dns",
     EmailSender = "@quidproquo-webserver/config/EmailSender",
+    EmailReceivingDomain = "@quidproquo-webserver/config/EmailReceivingDomain",
+    EmailReceiver = "@quidproquo-webserver/config/EmailReceiver",
     Seo = "@quidproquo-webserver/config/Seo",
     SubdomainRedirect = "@quidproquo-webserver/config/SubdomainRedirect",
     WebEntry = "@quidproquo-webserver/config/WebEntry",

package/lib/commonjs/config/QPQConfig.js

@@ -7,6 +7,8 @@ var QPQWebServerConfigSettingType;
     QPQWebServerConfigSettingType["DefaultRouteOptions"] = "@quidproquo-webserver/config/DefaultRouteOptions";
     QPQWebServerConfigSettingType["Dns"] = "@quidproquo-webserver/config/Dns";
     QPQWebServerConfigSettingType["EmailSender"] = "@quidproquo-webserver/config/EmailSender";
+    QPQWebServerConfigSettingType["EmailReceivingDomain"] = "@quidproquo-webserver/config/EmailReceivingDomain";
+    QPQWebServerConfigSettingType["EmailReceiver"] = "@quidproquo-webserver/config/EmailReceiver";
     QPQWebServerConfigSettingType["Seo"] = "@quidproquo-webserver/config/Seo";
     QPQWebServerConfigSettingType["SubdomainRedirect"] = "@quidproquo-webserver/config/SubdomainRedirect";
     QPQWebServerConfigSettingType["WebEntry"] = "@quidproquo-webserver/config/WebEntry";

package/lib/commonjs/config/QPQConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"QPQConfig.js","sourceRoot":"","sources":["../../../src/config/QPQConfig.ts"],"names":[],"mappings":";;;AAAA,IAAY,6BAiBX;AAjBD,WAAY,6BAA6B;IACvC,6EAA4C,CAAA;IAC5C,yGAAwE,CAAA;IACxE,yEAAwC,CAAA;IACxC,yFAAwD,CAAA;IACxD,yEAAwC,CAAA;IACxC,qGAAoE,CAAA;IACpE,mFAAkD,CAAA;IAClD,yEAAwC,CAAA;IACxC,+EAA8C,CAAA;IAC9C,iGAAgE,CAAA;IAChE,qFAAoD,CAAA;IACpD,6EAA4C,CAAA;IAC5C,yFAAwD,CAAA;IACxD,yFAAwD,CAAA;IACxD,mHAAkF,CAAA;IAClF,uGAAsE,CAAA;AACxE,CAAC,EAjBW,6BAA6B,6CAA7B,6BAA6B,QAiBxC","sourcesContent":["export enum QPQWebServerConfigSettingType {\n  Route = '@quidproquo-webserver/config/Route',\n  DefaultRouteOptions = '@quidproquo-webserver/config/DefaultRouteOptions',\n  Dns = '@quidproquo-webserver/config/Dns',\n  EmailSender = '@quidproquo-webserver/config/EmailSender',\n  Seo = '@quidproquo-webserver/config/Seo',\n  SubdomainRedirect = '@quidproquo-webserver/config/SubdomainRedirect',\n  WebEntry = '@quidproquo-webserver/config/WebEntry',\n  Api = '@quidproquo-webserver/config/Api',\n  ApiKey = '@quidproquo-webserver/config/ApiKey',\n  ServiceFunction = '@quidproquo-webserver/config/ServiceFunction',\n  WebSocket = '@quidproquo-webserver/config/WebSocket',\n  Cache = '@quidproquo-webserver/config/Cache',\n  Certificate = '@quidproquo-webserver/config/Certificate',\n  DomainProxy = '@quidproquo-webserver/config/DomainProxy',\n  StorageDriveCorsSettings = '@quidproquo-webserver/config/StorageDriveCorsSettings',\n  FileUploadSettings = '@quidproquo-webserver/config/FileUploadSettings',\n}\n\n// TODO: move this somewhere better\nexport interface CacheSettings {\n  minTTLInSeconds: number;\n  maxTTLInSeconds: number;\n  defaultTTLInSeconds: number;\n  mustRevalidate: boolean;\n}\n"]}
+{"version":3,"file":"QPQConfig.js","sourceRoot":"","sources":["../../../src/config/QPQConfig.ts"],"names":[],"mappings":";;;AAAA,IAAY,6BAmBX;AAnBD,WAAY,6BAA6B;IACvC,6EAA4C,CAAA;IAC5C,yGAAwE,CAAA;IACxE,yEAAwC,CAAA;IACxC,yFAAwD,CAAA;IACxD,2GAA0E,CAAA;IAC1E,6FAA4D,CAAA;IAC5D,yEAAwC,CAAA;IACxC,qGAAoE,CAAA;IACpE,mFAAkD,CAAA;IAClD,yEAAwC,CAAA;IACxC,+EAA8C,CAAA;IAC9C,iGAAgE,CAAA;IAChE,qFAAoD,CAAA;IACpD,6EAA4C,CAAA;IAC5C,yFAAwD,CAAA;IACxD,yFAAwD,CAAA;IACxD,mHAAkF,CAAA;IAClF,uGAAsE,CAAA;AACxE,CAAC,EAnBW,6BAA6B,6CAA7B,6BAA6B,QAmBxC","sourcesContent":["export enum QPQWebServerConfigSettingType {\n  Route = '@quidproquo-webserver/config/Route',\n  DefaultRouteOptions = '@quidproquo-webserver/config/DefaultRouteOptions',\n  Dns = '@quidproquo-webserver/config/Dns',\n  EmailSender = '@quidproquo-webserver/config/EmailSender',\n  EmailReceivingDomain = '@quidproquo-webserver/config/EmailReceivingDomain',\n  EmailReceiver = '@quidproquo-webserver/config/EmailReceiver',\n  Seo = '@quidproquo-webserver/config/Seo',\n  SubdomainRedirect = '@quidproquo-webserver/config/SubdomainRedirect',\n  WebEntry = '@quidproquo-webserver/config/WebEntry',\n  Api = '@quidproquo-webserver/config/Api',\n  ApiKey = '@quidproquo-webserver/config/ApiKey',\n  ServiceFunction = '@quidproquo-webserver/config/ServiceFunction',\n  WebSocket = '@quidproquo-webserver/config/WebSocket',\n  Cache = '@quidproquo-webserver/config/Cache',\n  Certificate = '@quidproquo-webserver/config/Certificate',\n  DomainProxy = '@quidproquo-webserver/config/DomainProxy',\n  StorageDriveCorsSettings = '@quidproquo-webserver/config/StorageDriveCorsSettings',\n  FileUploadSettings = '@quidproquo-webserver/config/FileUploadSettings',\n}\n\n// TODO: move this somewhere better\nexport interface CacheSettings {\n  minTTLInSeconds: number;\n  maxTTLInSeconds: number;\n  defaultTTLInSeconds: number;\n  mustRevalidate: boolean;\n}\n"]}

package/lib/commonjs/config/settings/emailReceiver.d.ts

@@ -0,0 +1,23 @@
+import { QPQConfig, QPQConfigSetting, QpqFunctionRuntime } from 'quidproquo-core';
+export interface EmailReceiverQPQWebServerConfigSetting extends QPQConfigSetting {
+    name: string;
+    storageDriveName: string;
+    onEmailFunctionName: string;
+}
+export type EmailReceiverOptions = {
+    onEmail: QpqFunctionRuntime;
+};
+/** The drive a receiver's raw messages land in. Framework-owned: the api never names it. */
+export declare const emailReceiverStorageDriveName: (name: string) => string;
+/** The inline function a receiver's onEmail is registered as. */
+export declare const emailReceiverOnEmailFunctionName: (name: string) => string;
+/**
+ * Receive mail sent to any address at the app's receiving domain (defineEmailReceivingDomain).
+ * Every message runs `onEmail` with an EmailReceivedEvent carrying the parsed message: who it
+ * is from, who it was delivered to, subject, bodies, attachments and the provider's SPF/DKIM
+ * verdicts. The transport (a drive the
+ * provider writes raw messages into, a create handler that parses them) is the receiver's own.
+ * A throwing handler loses that message after the platform's retries; catch inside it to do
+ * otherwise. Deployed platforms only; the dev server does not receive mail.
+ */
+export declare const defineEmailReceiver: (name: string, options: EmailReceiverOptions) => QPQConfig;

package/lib/commonjs/config/settings/emailReceiver.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineEmailReceiver = exports.emailReceiverOnEmailFunctionName = exports.emailReceiverStorageDriveName = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const emailReceivingGlobals_1 = require("../../services/emailReceiving/constants/emailReceivingGlobals");
+const getServiceEntryQpqFunctionRuntime_1 = require("../../services/getServiceEntryQpqFunctionRuntime");
+const QPQConfig_1 = require("../QPQConfig");
+/** The drive a receiver's raw messages land in. Framework-owned: the api never names it. */
+const emailReceiverStorageDriveName = (name) => `email-${name}`;
+exports.emailReceiverStorageDriveName = emailReceiverStorageDriveName;
+/** The inline function a receiver's onEmail is registered as. */
+const emailReceiverOnEmailFunctionName = (name) => `qpq-email-receiver-${name}`;
+exports.emailReceiverOnEmailFunctionName = emailReceiverOnEmailFunctionName;
+// A handled message is deleted by the create handler seconds after it lands; the lifecycle
+// rule only sweeps up the ones a failing handler left behind.
+const UNHANDLED_RETENTION_DAYS = 1;
+/**
+ * Receive mail sent to any address at the app's receiving domain (defineEmailReceivingDomain).
+ * Every message runs `onEmail` with an EmailReceivedEvent carrying the parsed message: who it
+ * is from, who it was delivered to, subject, bodies, attachments and the provider's SPF/DKIM
+ * verdicts. The transport (a drive the
+ * provider writes raw messages into, a create handler that parses them) is the receiver's own.
+ * A throwing handler loses that message after the platform's retries; catch inside it to do
+ * otherwise. Deployed platforms only; the dev server does not receive mail.
+ */
+const defineEmailReceiver = (name, options) => {
+    const storageDriveName = (0, exports.emailReceiverStorageDriveName)(name);
+    const onEmailFunctionName = (0, exports.emailReceiverOnEmailFunctionName)(name);
+    const receiver = {
+        configSettingType: QPQConfig_1.QPQWebServerConfigSettingType.EmailReceiver,
+        uniqueKey: `emailReceiver-${name}`,
+        name,
+        storageDriveName,
+        onEmailFunctionName,
+    };
+    return [
+        receiver,
+        (0, quidproquo_core_1.defineInlineFunction)(options.onEmail, { functionName: onEmailFunctionName }),
+        (0, quidproquo_core_1.defineStorageDrive)(storageDriveName, {
+            lifecycleRules: [{ deleteAfterDays: UNHANDLED_RETENTION_DAYS }],
+            onEvent: {
+                create: Object.assign(Object.assign({}, (0, getServiceEntryQpqFunctionRuntime_1.getServiceEntryQpqFunctionRuntime)('emailReceiving', 'storageDrive', 'onCreate::onCreate')), { globals: { [emailReceivingGlobals_1.EMAIL_RECEIVER_ON_EMAIL_GLOBAL]: onEmailFunctionName } }),
+            },
+        }),
+    ];
+};
+exports.defineEmailReceiver = defineEmailReceiver;
+//# sourceMappingURL=emailReceiver.js.map

package/lib/commonjs/config/settings/emailReceiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailReceiver.js","sourceRoot":"","sources":["../../../../src/config/settings/emailReceiver.ts"],"names":[],"mappings":";;;AAAA,qDAA4H;AAE5H,yGAA+G;AAC/G,wGAAqG;AACrG,4CAA6D;AAc7D,4FAA4F;AACrF,MAAM,6BAA6B,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC;AAA1E,QAAA,6BAA6B,iCAA6C;AAEvF,iEAAiE;AAC1D,MAAM,gCAAgC,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,sBAAsB,IAAI,EAAE,CAAC;AAA1F,QAAA,gCAAgC,oCAA0D;AAEvG,2FAA2F;AAC3F,8DAA8D;AAC9D,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC;;;;;;;;GAQG;AACI,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAE,OAA6B,EAAa,EAAE;IAC5F,MAAM,gBAAgB,GAAG,IAAA,qCAA6B,EAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,mBAAmB,GAAG,IAAA,wCAAgC,EAAC,IAAI,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAA2C;QACvD,iBAAiB,EAAE,yCAA6B,CAAC,aAAa;QAC9D,SAAS,EAAE,iBAAiB,IAAI,EAAE;QAElC,IAAI;QACJ,gBAAgB;QAChB,mBAAmB;KACpB,CAAC;IAEF,OAAO;QACL,QAAQ;QAER,IAAA,sCAAoB,EAAC,OAAO,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;QAE5E,IAAA,oCAAkB,EAAC,gBAAgB,EAAE;YACnC,cAAc,EAAE,CAAC,EAAE,eAAe,EAAE,wBAAwB,EAAE,CAAC;YAC/D,OAAO,EAAE;gBACP,MAAM,kCACD,IAAA,qEAAiC,EAAC,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,CAAC,KAC5F,OAAO,EAAE,EAAE,CAAC,sDAA8B,CAAC,EAAE,mBAAmB,EAAE,GACnE;aACF;SACF,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AA5BW,QAAA,mBAAmB,uBA4B9B","sourcesContent":["import { defineInlineFunction, defineStorageDrive, QPQConfig, QPQConfigSetting, QpqFunctionRuntime } from 'quidproquo-core';\n\nimport { EMAIL_RECEIVER_ON_EMAIL_GLOBAL } from '../../services/emailReceiving/constants/emailReceivingGlobals';\nimport { getServiceEntryQpqFunctionRuntime } from '../../services/getServiceEntryQpqFunctionRuntime';\nimport { QPQWebServerConfigSettingType } from '../QPQConfig';\n\nexport interface EmailReceiverQPQWebServerConfigSetting extends QPQConfigSetting {\n  name: string;\n  // The drive raw messages land in, owned by the receiver; apps never name it.\n  storageDriveName: string;\n  onEmailFunctionName: string;\n}\n\nexport type EmailReceiverOptions = {\n  // Runs once per received message with an EmailReceivedEvent.\n  onEmail: QpqFunctionRuntime;\n};\n\n/** The drive a receiver's raw messages land in. Framework-owned: the api never names it. */\nexport const emailReceiverStorageDriveName = (name: string): string => `email-${name}`;\n\n/** The inline function a receiver's onEmail is registered as. */\nexport const emailReceiverOnEmailFunctionName = (name: string): string => `qpq-email-receiver-${name}`;\n\n// A handled message is deleted by the create handler seconds after it lands; the lifecycle\n// rule only sweeps up the ones a failing handler left behind.\nconst UNHANDLED_RETENTION_DAYS = 1;\n\n/**\n * Receive mail sent to any address at the app's receiving domain (defineEmailReceivingDomain).\n * Every message runs `onEmail` with an EmailReceivedEvent carrying the parsed message: who it\n * is from, who it was delivered to, subject, bodies, attachments and the provider's SPF/DKIM\n * verdicts. The transport (a drive the\n * provider writes raw messages into, a create handler that parses them) is the receiver's own.\n * A throwing handler loses that message after the platform's retries; catch inside it to do\n * otherwise. Deployed platforms only; the dev server does not receive mail.\n */\nexport const defineEmailReceiver = (name: string, options: EmailReceiverOptions): QPQConfig => {\n  const storageDriveName = emailReceiverStorageDriveName(name);\n  const onEmailFunctionName = emailReceiverOnEmailFunctionName(name);\n\n  const receiver: EmailReceiverQPQWebServerConfigSetting = {\n    configSettingType: QPQWebServerConfigSettingType.EmailReceiver,\n    uniqueKey: `emailReceiver-${name}`,\n\n    name,\n    storageDriveName,\n    onEmailFunctionName,\n  };\n\n  return [\n    receiver,\n\n    defineInlineFunction(options.onEmail, { functionName: onEmailFunctionName }),\n\n    defineStorageDrive(storageDriveName, {\n      lifecycleRules: [{ deleteAfterDays: UNHANDLED_RETENTION_DAYS }],\n      onEvent: {\n        create: {\n          ...getServiceEntryQpqFunctionRuntime('emailReceiving', 'storageDrive', 'onCreate::onCreate'),\n          globals: { [EMAIL_RECEIVER_ON_EMAIL_GLOBAL]: onEmailFunctionName },\n        },\n      },\n    }),\n  ];\n};\n"]}

package/lib/commonjs/config/settings/emailReceivingDomain.d.ts

@@ -0,0 +1,11 @@
+import { QPQConfigSetting } from 'quidproquo-core';
+export interface EmailReceivingDomainQPQWebServerConfigSetting extends QPQConfigSetting {
+    subdomain: string;
+}
+/**
+ * The app's receiving domain, one per root: `<subdomain>.<env>.<root>` resolved like every other
+ * host. Declared in the bootstrap config, whose stack verifies the domain with the mail provider
+ * and points its MX record at it, and again by every service that declares a defineEmailReceiver,
+ * which resolves its recipients from it (the same way defineDns is declared in both).
+ */
+export declare const defineEmailReceivingDomain: (subdomain?: string) => EmailReceivingDomainQPQWebServerConfigSetting;

package/lib/commonjs/config/settings/emailReceivingDomain.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineEmailReceivingDomain = void 0;
+const QPQConfig_1 = require("../QPQConfig");
+/**
+ * The app's receiving domain, one per root: `<subdomain>.<env>.<root>` resolved like every other
+ * host. Declared in the bootstrap config, whose stack verifies the domain with the mail provider
+ * and points its MX record at it, and again by every service that declares a defineEmailReceiver,
+ * which resolves its recipients from it (the same way defineDns is declared in both).
+ */
+const defineEmailReceivingDomain = (subdomain = 'inbox') => ({
+    configSettingType: QPQConfig_1.QPQWebServerConfigSettingType.EmailReceivingDomain,
+    uniqueKey: 'emailReceivingDomain',
+    subdomain,
+});
+exports.defineEmailReceivingDomain = defineEmailReceivingDomain;
+//# sourceMappingURL=emailReceivingDomain.js.map

package/lib/commonjs/config/settings/emailReceivingDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailReceivingDomain.js","sourceRoot":"","sources":["../../../../src/config/settings/emailReceivingDomain.ts"],"names":[],"mappings":";;;AAEA,4CAA6D;AAM7D;;;;;GAKG;AACI,MAAM,0BAA0B,GAAG,CAAC,YAAoB,OAAO,EAAiD,EAAE,CAAC,CAAC;IACzH,iBAAiB,EAAE,yCAA6B,CAAC,oBAAoB;IACrE,SAAS,EAAE,sBAAsB;IAEjC,SAAS;CACV,CAAC,CAAC;AALU,QAAA,0BAA0B,8BAKpC","sourcesContent":["import { QPQConfigSetting } from 'quidproquo-core';\n\nimport { QPQWebServerConfigSettingType } from '../QPQConfig';\n\nexport interface EmailReceivingDomainQPQWebServerConfigSetting extends QPQConfigSetting {\n  subdomain: string;\n}\n\n/**\n * The app's receiving domain, one per root: `<subdomain>.<env>.<root>` resolved like every other\n * host. Declared in the bootstrap config, whose stack verifies the domain with the mail provider\n * and points its MX record at it, and again by every service that declares a defineEmailReceiver,\n * which resolves its recipients from it (the same way defineDns is declared in both).\n */\nexport const defineEmailReceivingDomain = (subdomain: string = 'inbox'): EmailReceivingDomainQPQWebServerConfigSetting => ({\n  configSettingType: QPQWebServerConfigSettingType.EmailReceivingDomain,\n  uniqueKey: 'emailReceivingDomain',\n\n  subdomain,\n});\n"]}

package/lib/commonjs/config/settings/index.d.ts

@@ -6,6 +6,8 @@ export * from './defaultRouteOptions';
 export * from './defineAuthSystem';
 export * from './dns';
 export * from './domainProxy';
+export * from './emailReceiver';
+export * from './emailReceivingDomain';
 export * from './emailSender';
 export * from './fileUploadSettings';
 export * from './migration';

package/lib/commonjs/config/settings/index.js

@@ -22,6 +22,8 @@ __exportStar(require("./defaultRouteOptions"), exports);
 __exportStar(require("./defineAuthSystem"), exports);
 __exportStar(require("./dns"), exports);
 __exportStar(require("./domainProxy"), exports);
+__exportStar(require("./emailReceiver"), exports);
+__exportStar(require("./emailReceivingDomain"), exports);
 __exportStar(require("./emailSender"), exports);
 __exportStar(require("./fileUploadSettings"), exports);
 __exportStar(require("./migration"), exports);

package/lib/commonjs/config/settings/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/settings/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2CAAyB;AACzB,0CAAwB;AACxB,gDAA8B;AAC9B,wDAAsC;AACtC,qDAAmC;AACnC,wCAAsB;AACtB,gDAA8B;AAC9B,gDAA8B;AAC9B,uDAAqC;AACrC,8CAA4B;AAC5B,0CAAwB;AACxB,yCAAuB;AACvB,wCAAsB;AACtB,oDAAkC;AAClC,6DAA2C;AAC3C,sDAAoC;AACpC,6CAA2B;AAC3B,8CAA4B","sourcesContent":["export * from './api';\nexport * from './apiKey';\nexport * from './cache';\nexport * from './certificate';\nexport * from './defaultRouteOptions';\nexport * from './defineAuthSystem';\nexport * from './dns';\nexport * from './domainProxy';\nexport * from './emailSender';\nexport * from './fileUploadSettings';\nexport * from './migration';\nexport * from './route';\nexport * from './seed';\nexport * from './seo';\nexport * from './serviceFunction';\nexport * from './storageDriveCorsSettings';\nexport * from './subdomainRedirect';\nexport * from './webEntry';\nexport * from './websocket';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/config/settings/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2CAAyB;AACzB,0CAAwB;AACxB,gDAA8B;AAC9B,wDAAsC;AACtC,qDAAmC;AACnC,wCAAsB;AACtB,gDAA8B;AAC9B,kDAAgC;AAChC,yDAAuC;AACvC,gDAA8B;AAC9B,uDAAqC;AACrC,8CAA4B;AAC5B,0CAAwB;AACxB,yCAAuB;AACvB,wCAAsB;AACtB,oDAAkC;AAClC,6DAA2C;AAC3C,sDAAoC;AACpC,6CAA2B;AAC3B,8CAA4B","sourcesContent":["export * from './api';\nexport * from './apiKey';\nexport * from './cache';\nexport * from './certificate';\nexport * from './defaultRouteOptions';\nexport * from './defineAuthSystem';\nexport * from './dns';\nexport * from './domainProxy';\nexport * from './emailReceiver';\nexport * from './emailReceivingDomain';\nexport * from './emailSender';\nexport * from './fileUploadSettings';\nexport * from './migration';\nexport * from './route';\nexport * from './seed';\nexport * from './seo';\nexport * from './serviceFunction';\nexport * from './storageDriveCorsSettings';\nexport * from './subdomainRedirect';\nexport * from './webEntry';\nexport * from './websocket';\n"]}

package/lib/commonjs/services/emailReceiving/constants/emailReceivingGlobals.d.ts

@@ -0,0 +1 @@
+export declare const EMAIL_RECEIVER_ON_EMAIL_GLOBAL = "qpq-email-receiver-on-email";

package/lib/commonjs/services/emailReceiving/constants/emailReceivingGlobals.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_RECEIVER_ON_EMAIL_GLOBAL = void 0;
+// The runtime global the receiver's create handler reads: the inline function each
+// parsed message is handed to.
+exports.EMAIL_RECEIVER_ON_EMAIL_GLOBAL = 'qpq-email-receiver-on-email';
+//# sourceMappingURL=emailReceivingGlobals.js.map

package/lib/commonjs/services/emailReceiving/constants/emailReceivingGlobals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailReceivingGlobals.js","sourceRoot":"","sources":["../../../../../src/services/emailReceiving/constants/emailReceivingGlobals.ts"],"names":[],"mappings":";;;AAAA,mFAAmF;AACnF,+BAA+B;AAClB,QAAA,8BAA8B,GAAG,6BAA6B,CAAC","sourcesContent":["// The runtime global the receiver's create handler reads: the inline function each\n// parsed message is handed to.\nexport const EMAIL_RECEIVER_ON_EMAIL_GLOBAL = 'qpq-email-receiver-on-email';\n"]}

package/lib/commonjs/services/emailReceiving/constants/index.d.ts

@@ -0,0 +1 @@
+export * from './emailReceivingGlobals';

package/lib/commonjs/services/emailReceiving/constants/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./emailReceivingGlobals"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/services/emailReceiving/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/services/emailReceiving/constants/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC","sourcesContent":["export * from './emailReceivingGlobals';\n"]}

package/lib/commonjs/services/emailReceiving/entry/storageDrive/onCreate.d.ts

@@ -0,0 +1,3 @@
+import { AskResponse } from 'quidproquo-core';
+import { StorageDriveEvent, StorageDriveEventResponse } from '../../../../types/StorageDriveEvent';
+export declare function onCreate(event: StorageDriveEvent): AskResponse<StorageDriveEventResponse>;

package/lib/commonjs/services/emailReceiving/entry/storageDrive/onCreate.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onCreate = onCreate;
+const quidproquo_core_1 = require("quidproquo-core");
+const askEmailParse_1 = require("../../../../actions/email/askEmailParse");
+const emailReceivingGlobals_1 = require("../../constants/emailReceivingGlobals");
+// The receiver drive's create handler: each object the mail provider wrote is one message.
+// It is parsed here and handed to the receiver's onEmail, then deleted; a message whose
+// handler throws stays until the drive's lifecycle rule sweeps it.
+function* onCreate(event) {
+    const onEmailFunctionName = yield* (0, quidproquo_core_1.askConfigGetGlobal)(emailReceivingGlobals_1.EMAIL_RECEIVER_ON_EMAIL_GLOBAL);
+    for (const filepath of event.filePaths) {
+        const raw = yield* (0, quidproquo_core_1.askFileReadBinaryContents)(event.driveName, filepath);
+        const message = yield* (0, askEmailParse_1.askEmailParse)(raw.base64Data);
+        yield* (0, quidproquo_core_1.askInlineFunctionExecute)(onEmailFunctionName, { message });
+        yield* (0, quidproquo_core_1.askFileDelete)(event.driveName, [filepath]);
+    }
+}
+//# sourceMappingURL=onCreate.js.map

package/lib/commonjs/services/emailReceiving/entry/storageDrive/onCreate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onCreate.js","sourceRoot":"","sources":["../../../../../../src/services/emailReceiving/entry/storageDrive/onCreate.ts"],"names":[],"mappings":";;AAUA,4BAWC;AArBD,qDAAsI;AAEtI,2EAAwE;AAGxE,iFAAuF;AAEvF,2FAA2F;AAC3F,wFAAwF;AACxF,mEAAmE;AACnE,QAAe,CAAC,CAAC,QAAQ,CAAC,KAAwB;IAChD,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC,IAAA,oCAAkB,EAAS,sDAA8B,CAAC,CAAC;IAE9F,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,IAAA,2CAAyB,EAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,IAAA,6BAAa,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAErD,KAAK,CAAC,CAAC,IAAA,0CAAwB,EAAiD,mBAAmB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAElH,KAAK,CAAC,CAAC,IAAA,+BAAa,EAAC,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC","sourcesContent":["import { askConfigGetGlobal, askFileDelete, askFileReadBinaryContents, askInlineFunctionExecute, AskResponse } from 'quidproquo-core';\n\nimport { askEmailParse } from '../../../../actions/email/askEmailParse';\nimport { EmailReceivedEvent, EmailReceivedEventResponse } from '../../../../types/EmailReceivedEvent';\nimport { StorageDriveEvent, StorageDriveEventResponse } from '../../../../types/StorageDriveEvent';\nimport { EMAIL_RECEIVER_ON_EMAIL_GLOBAL } from '../../constants/emailReceivingGlobals';\n\n// The receiver drive's create handler: each object the mail provider wrote is one message.\n// It is parsed here and handed to the receiver's onEmail, then deleted; a message whose\n// handler throws stays until the drive's lifecycle rule sweeps it.\nexport function* onCreate(event: StorageDriveEvent): AskResponse<StorageDriveEventResponse> {\n  const onEmailFunctionName = yield* askConfigGetGlobal<string>(EMAIL_RECEIVER_ON_EMAIL_GLOBAL);\n\n  for (const filepath of event.filePaths) {\n    const raw = yield* askFileReadBinaryContents(event.driveName, filepath);\n    const message = yield* askEmailParse(raw.base64Data);\n\n    yield* askInlineFunctionExecute<EmailReceivedEventResponse, EmailReceivedEvent>(onEmailFunctionName, { message });\n\n    yield* askFileDelete(event.driveName, [filepath]);\n  }\n}\n"]}

package/lib/commonjs/services/emailReceiving/index.d.ts

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './entry/storageDrive/onCreate';

package/lib/commonjs/services/emailReceiving/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./entry/storageDrive/onCreate"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/services/emailReceiving/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/emailReceiving/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,gEAA8C","sourcesContent":["export * from './constants';\nexport * from './entry/storageDrive/onCreate';\n"]}

package/lib/commonjs/services/index.d.ts

@@ -1,4 +1,5 @@
 export * from './auth';
+export * from './emailReceiving';
 export * from './getServiceEntryQpqFunctionRuntime';
 export * from './migration';
 export * from './serviceImporter';

package/lib/commonjs/services/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./auth"), exports);
+__exportStar(require("./emailReceiving"), exports);
 __exportStar(require("./getServiceEntryQpqFunctionRuntime"), exports);
 __exportStar(require("./migration"), exports);
 __exportStar(require("./serviceImporter"), exports);

package/lib/commonjs/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,sEAAoD;AACpD,8CAA4B;AAC5B,oDAAkC","sourcesContent":["export * from './auth';\nexport * from './getServiceEntryQpqFunctionRuntime';\nexport * from './migration';\nexport * from './serviceImporter';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,mDAAiC;AACjC,sEAAoD;AACpD,8CAA4B;AAC5B,oDAAkC","sourcesContent":["export * from './auth';\nexport * from './emailReceiving';\nexport * from './getServiceEntryQpqFunctionRuntime';\nexport * from './migration';\nexport * from './serviceImporter';\n"]}

package/lib/commonjs/types/EmailReceivedEvent.d.ts

@@ -0,0 +1,6 @@
+import { EmailMessage } from '../actions/email/EmailMessage';
+/** What a defineEmailReceiver's onEmail receives, once per delivered message. */
+export type EmailReceivedEvent = {
+    message: EmailMessage;
+};
+export type EmailReceivedEventResponse = void;

package/lib/commonjs/types/EmailReceivedEvent.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=EmailReceivedEvent.js.map

package/lib/commonjs/types/EmailReceivedEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailReceivedEvent.js","sourceRoot":"","sources":["../../../src/types/EmailReceivedEvent.ts"],"names":[],"mappings":"","sourcesContent":["import { EmailMessage } from '../actions/email/EmailMessage';\n\n/** What a defineEmailReceiver's onEmail receives, once per delivered message. */\nexport type EmailReceivedEvent = {\n  message: EmailMessage;\n};\n\nexport type EmailReceivedEventResponse = void;\n"]}

package/lib/commonjs/types/StorageDriveEvent.d.ts

@@ -5,6 +5,7 @@ export declare enum StorageDriveEventType {
 export type StorageDriveEvent = {
     eventType: StorageDriveEventType;
     driveName: string;
+    scope?: string;
     filePaths: string[];
 };
 export type StorageDriveEventResponse = void;

package/lib/commonjs/types/StorageDriveEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageDriveEvent.js","sourceRoot":"","sources":["../../../src/types/StorageDriveEvent.ts"],"names":[],"mappings":";;;AAAA,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;AACnB,CAAC,EAHW,qBAAqB,qCAArB,qBAAqB,QAGhC","sourcesContent":["export enum StorageDriveEventType {\n  Create = 'Create',\n  Delete = 'Delete',\n}\n\nexport type StorageDriveEvent = {\n  eventType: StorageDriveEventType;\n  driveName: string;\n\n  filePaths: string[];\n};\n\nexport type StorageDriveEventResponse = void;\n"]}
+{"version":3,"file":"StorageDriveEvent.js","sourceRoot":"","sources":["../../../src/types/StorageDriveEvent.ts"],"names":[],"mappings":";;;AAAA,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,0CAAiB,CAAA;IACjB,0CAAiB,CAAA;AACnB,CAAC,EAHW,qBAAqB,qCAArB,qBAAqB,QAGhC","sourcesContent":["export enum StorageDriveEventType {\n  Create = 'Create',\n  Delete = 'Delete',\n}\n\nexport type StorageDriveEvent = {\n  eventType: StorageDriveEventType;\n  driveName: string;\n\n  // Set when the drive is scoped: the scope the object lives under, with\n  // filePaths made scope-relative. The handler runs with it as the ambient\n  // storage scope, so file and kvs calls inside it inherit the partition.\n  scope?: string;\n\n  filePaths: string[];\n};\n\nexport type StorageDriveEventResponse = void;\n"]}

package/lib/commonjs/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from './CloudflareDnsDeployEvent';
 export * from './constants';
+export * from './EmailReceivedEvent';
 export * from './EmailSendEvent';
 export * from './ExecuteServiceFunctionEvent';
 export * from './HTTPEvent';

package/lib/commonjs/types/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./CloudflareDnsDeployEvent"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./EmailReceivedEvent"), exports);
 __exportStar(require("./EmailSendEvent"), exports);
 __exportStar(require("./ExecuteServiceFunctionEvent"), exports);
 __exportStar(require("./HTTPEvent"), exports);

package/lib/commonjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,8CAA4B;AAC5B,mDAAiC;AACjC,gEAA8C;AAC9C,8CAA4B;AAC5B,oDAAkC;AAClC,6CAA2B;AAC3B,sDAAoC;AACpC,mDAAiC","sourcesContent":["export * from './CloudflareDnsDeployEvent';\nexport * from './constants';\nexport * from './EmailSendEvent';\nexport * from './ExecuteServiceFunctionEvent';\nexport * from './HTTPEvent';\nexport * from './OpenApiDocument';\nexport * from './SEOEvent';\nexport * from './StorageDriveEvent';\nexport * from './WebsocketEvent';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,8CAA4B;AAC5B,uDAAqC;AACrC,mDAAiC;AACjC,gEAA8C;AAC9C,8CAA4B;AAC5B,oDAAkC;AAClC,6CAA2B;AAC3B,sDAAoC;AACpC,mDAAiC","sourcesContent":["export * from './CloudflareDnsDeployEvent';\nexport * from './constants';\nexport * from './EmailReceivedEvent';\nexport * from './EmailSendEvent';\nexport * from './ExecuteServiceFunctionEvent';\nexport * from './HTTPEvent';\nexport * from './OpenApiDocument';\nexport * from './SEOEvent';\nexport * from './StorageDriveEvent';\nexport * from './WebsocketEvent';\n"]}

package/lib/commonjs/utils/qpqConfigAccessorsUtils.d.ts

@@ -1,5 +1,5 @@
 import { QPQConfig, QpqFunctionRuntime } from 'quidproquo-core';
-import { ApiKeyQPQWebServerConfigSetting, CacheQPQWebServerConfigSetting, CertificateQPQWebServerConfigSetting, DefaultRouteOptionsQPQWebServerConfigSetting, DomainProxyQPQWebServerConfigSetting, EmailSenderQPQWebServerConfigSetting, FileUploadSettings, RouteQPQWebServerConfigSetting, SeoQPQWebServerConfigSetting, ServiceFunctionQPQWebServerConfigSetting, SubdomainRedirectQPQWebServerConfigSetting, WebSocketQPQWebServerConfigSetting } from '../config';
+import { ApiKeyQPQWebServerConfigSetting, CacheQPQWebServerConfigSetting, CertificateQPQWebServerConfigSetting, DefaultRouteOptionsQPQWebServerConfigSetting, DomainProxyQPQWebServerConfigSetting, EmailReceiverQPQWebServerConfigSetting, EmailReceivingDomainQPQWebServerConfigSetting, EmailSenderQPQWebServerConfigSetting, FileUploadSettings, RouteQPQWebServerConfigSetting, SeoQPQWebServerConfigSetting, ServiceFunctionQPQWebServerConfigSetting, SubdomainRedirectQPQWebServerConfigSetting, WebSocketQPQWebServerConfigSetting } from '../config';
 import { ApiQPQWebServerConfigSetting, WebEntryQPQWebServerConfigSetting } from '../config';
 export declare const getAllRoutes: (qpqConfig: QPQConfig) => RouteQPQWebServerConfigSetting[];
 export declare const getAllRoutesForApi: (apiName: string, qpqConfig: QPQConfig) => RouteQPQWebServerConfigSetting[];
@@ -23,5 +23,10 @@ export declare const defaultFileUploadSettings: FileUploadSettings;
 export declare const getFileUploadSettings: (qpqConfig: QPQConfig) => FileUploadSettings;
 export declare const getDefaultRouteSettings: (qpqConfig: QPQConfig) => DefaultRouteOptionsQPQWebServerConfigSetting[];
 export declare const getEmailSenderSettings: (qpqConfig: QPQConfig) => EmailSenderQPQWebServerConfigSetting[];
+export declare const getEmailReceivingDomainConfig: (qpqConfig: QPQConfig) => EmailReceivingDomainQPQWebServerConfigSetting | undefined;
+export declare const getEmailReceiverConfigs: (qpqConfig: QPQConfig) => EmailReceiverQPQWebServerConfigSetting[];
+export declare const getEmailReceiverByName: (qpqConfig: QPQConfig, name: string) => EmailReceiverQPQWebServerConfigSetting | undefined;
+/** The receivers that write into a drive, which the mail provider must be allowed to write into. */
+export declare const getEmailReceiversForStorageDrive: (qpqConfig: QPQConfig, storageDriveName: string) => EmailReceiverQPQWebServerConfigSetting[];
 export declare const getWebsocketSettings: (qpqConfig: QPQConfig) => WebSocketQPQWebServerConfigSetting[];
 export declare const getOwnedWebsocketSettings: (qpqConfig: QPQConfig) => WebSocketQPQWebServerConfigSetting[];

package/lib/commonjs/utils/qpqConfigAccessorsUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOwnedWebsocketSettings = exports.getWebsocketSettings = exports.getEmailSenderSettings = exports.getDefaultRouteSettings = exports.getFileUploadSettings = exports.defaultFileUploadSettings = exports.isStorageDriveWebEntryOrigin = exports.getCacheConfigByName = exports.getAllOwnedCertifcateConfigs = exports.getAllOwnedCacheConfigs = exports.getDomainProxyConfigs = exports.getWebEntryConfigs = exports.getApiConfigs = exports.getSubdomainRedirects = exports.getWebsocketEntryByApiName = exports.getWebEntry = exports.getAllSrcEntries = exports.getAllWebsocketSrcEntries = exports.getOwnedServiceFunctions = exports.getAllServiceFunctions = exports.getAllSeo = exports.getAllApiKeyConfigs = exports.getAllRoutesForApi = exports.getAllRoutes = void 0;
+exports.getOwnedWebsocketSettings = exports.getWebsocketSettings = exports.getEmailReceiversForStorageDrive = exports.getEmailReceiverByName = exports.getEmailReceiverConfigs = exports.getEmailReceivingDomainConfig = exports.getEmailSenderSettings = exports.getDefaultRouteSettings = exports.getFileUploadSettings = exports.defaultFileUploadSettings = exports.isStorageDriveWebEntryOrigin = exports.getCacheConfigByName = exports.getAllOwnedCertifcateConfigs = exports.getAllOwnedCacheConfigs = exports.getDomainProxyConfigs = exports.getWebEntryConfigs = exports.getApiConfigs = exports.getSubdomainRedirects = exports.getWebsocketEntryByApiName = exports.getWebEntry = exports.getAllSrcEntries = exports.getAllWebsocketSrcEntries = exports.getOwnedServiceFunctions = exports.getAllServiceFunctions = exports.getAllSeo = exports.getAllApiKeyConfigs = exports.getAllRoutesForApi = exports.getAllRoutes = void 0;
 const quidproquo_core_1 = require("quidproquo-core");
 const config_1 = require("../config");
 const getAllRoutes = (qpqConfig) => {
@@ -135,6 +135,15 @@ const getEmailSenderSettings = (qpqConfig) => {
     return quidproquo_core_1.qpqCoreUtils.getConfigSettings(qpqConfig, config_1.QPQWebServerConfigSettingType.EmailSender) || [];
 };
 exports.getEmailSenderSettings = getEmailSenderSettings;
+const getEmailReceivingDomainConfig = (qpqConfig) => quidproquo_core_1.qpqCoreUtils.getConfigSetting(qpqConfig, config_1.QPQWebServerConfigSettingType.EmailReceivingDomain);
+exports.getEmailReceivingDomainConfig = getEmailReceivingDomainConfig;
+const getEmailReceiverConfigs = (qpqConfig) => quidproquo_core_1.qpqCoreUtils.getConfigSettings(qpqConfig, config_1.QPQWebServerConfigSettingType.EmailReceiver) || [];
+exports.getEmailReceiverConfigs = getEmailReceiverConfigs;
+const getEmailReceiverByName = (qpqConfig, name) => (0, exports.getEmailReceiverConfigs)(qpqConfig).find((receiver) => receiver.name === name);
+exports.getEmailReceiverByName = getEmailReceiverByName;
+/** The receivers that write into a drive, which the mail provider must be allowed to write into. */
+const getEmailReceiversForStorageDrive = (qpqConfig, storageDriveName) => (0, exports.getEmailReceiverConfigs)(qpqConfig).filter((receiver) => receiver.storageDriveName === storageDriveName);
+exports.getEmailReceiversForStorageDrive = getEmailReceiversForStorageDrive;
 const getWebsocketSettings = (qpqConfig) => {
     const websocketSettings = quidproquo_core_1.qpqCoreUtils.getConfigSettings(qpqConfig, config_1.QPQWebServerConfigSettingType.WebSocket) || [];
     return websocketSettings;