npm - @fourier-labs/harbour-contracts - Versions diffs - 0.91.0 → 0.92.0 - Mend

@fourier-labs/harbour-contracts 0.91.0 → 0.92.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/contract-release.json +12 -10
package/dist/gen-ts/contract-release.d.ts +6 -6
package/dist/gen-ts/contract-release.js +6 -6
package/dist/gen-ts/deployment-app-registration.d.ts +20 -0
package/dist/gen-ts/index.d.ts +1 -0
package/dist/gen-ts/index.js +1 -0
package/dist/gen-ts/mail-arrival-event.d.ts +17 -0
package/dist/gen-ts/mail-arrival-event.js +3 -0
package/gen-ts/contract-release.ts +6 -6
package/gen-ts/deployment-app-registration.ts +20 -0
package/gen-ts/index.ts +1 -0
package/gen-ts/mail-arrival-event.ts +20 -0
package/package.json +1 -1
package/schema/deployment-app-registration.schema.json +199 -17
package/schema/mail-arrival-event.schema.json +75 -0

package/contract-release.json CHANGED Viewed

@@ -1,12 +1,12 @@
 {
   "schema": "harbour.contract-release/1.0",
-  "repositoryVersion": "0.91.0.0",
-  "publishVersion": "0.91.0",
-  "publishTag": "v0.91.0",
-  "schemasDigest": "sha256:b6ef945b91544184715900ca739d16f3ad8a40d5307a3b04d71cf7ac39c4fb39",
+  "repositoryVersion": "0.92.0.0",
+  "publishVersion": "0.92.0",
+  "publishTag": "v0.92.0",
+  "schemasDigest": "sha256:5b6aede1f569d02bf976d5331c9e8eb1e657b062be28fb89565ff50acd105c5a",
   "aiFixturesDigest": "sha256:edac31c92e146ca1c40130f2fb5649db82e24b8cd1ac758153b90612052fddb6",
-  "generatedGoDigest": "sha256:7dc23154d2d8cc3a50733c32bc005d71afa877ab327d89a3c3a7dc8dbec7dc5b",
-  "generatedTypeScriptDigest": "sha256:ae301b3932627690ffc23da6368dac812e5e33968dbe65fed52716c4896cbfcb",
+  "generatedGoDigest": "sha256:64d78d9952ac08558ad956eb4c923677a0691e6260743c0dbc367b57e59ea822",
+  "generatedTypeScriptDigest": "sha256:a99c149dbeb2b081bd460b95df4d44e29cc95e2fe2c737f4b012b7449c0c94d3",
   "generatedExclusions": {
     "gen-go/contract_release.go": "contains the generated aggregate digests (self-reference)",
     "gen-ts/contract-release.ts": "contains the generated aggregate digests (self-reference)"
@@ -42,7 +42,7 @@
     "schema/data-source.schema.json": "sha256:f32b2b4312bc06e023f4e1da60eed52ddfade59b74c1a1cc8e4b740a6f9c930b",
     "schema/deploy-request.schema.json": "sha256:c978406c273fa430db262888f0a8646b14e3057f64b0633780fcd6cfa646bc67",
     "schema/deploy-response.schema.json": "sha256:09064948abdbba7022738285d802ed44648a16ddc2a5b8c2eeb170ae19a66aeb",
-    "schema/deployment-app-registration.schema.json": "sha256:f1deb15a467065a20f540649aac3713e6c8afe68f03b43969ef103356b7baa13",
+    "schema/deployment-app-registration.schema.json": "sha256:4386dfd6f5ac2604214ab161cbb37146245baf7e70b63773c9702bd3270c3ca5",
     "schema/deployment-continuation.schema.json": "sha256:55b6945439f2c91cd851dfe4bc9484e67a64091b7763b2d8267354b4a8bfae8c",
     "schema/deployment-environment.schema.json": "sha256:35b26cae07da9ee375a842b5e87c4570c8eca06775e9fd6dd46eb9eb8aa0df6c",
     "schema/deployment-preview-retirement.schema.json": "sha256:ccf6b971b7853ca98530272f280fe62cd3aab5425b10b81ae6b717cc949e014f",
@@ -63,6 +63,7 @@
     "schema/kit-bundle-manifest.schema.json": "sha256:d8fc6ca9c30d791e785b021687e084e9171c0ea1a3a176d0f1582fcccf2c0e19",
     "schema/kit-lock.schema.json": "sha256:a48154d9471e49a893d928f7b0e1e0bc77708a4a7edce4fdf14073203e0e8987",
     "schema/kvs-routing-entry.schema.json": "sha256:b75f3a5dfa93a428b2764e03222b66b6ef2bed980f8bac8ffac54afdf3526bc5",
+    "schema/mail-arrival-event.schema.json": "sha256:b4fee8777a7e09ee223919330ca772e35b0e617ecfb3d5a197bfe0ee1effe4f5",
     "schema/promotion-request.schema.json": "sha256:00e96dfd8ddbdba88ea222941d43f3609ff6c815a79e34f6705cab458101c969",
     "schema/promotion-response.schema.json": "sha256:4129712d2e29d6ef21d93d4bd0bacfd60ada3f2ee0ade852824e64346b817634",
     "schema/resolved-app-serving.schema.json": "sha256:3b49268e189429310c2a5dcfd45e9d2187c80b6dbb9d329a0177e96e065c31c0",
@@ -116,7 +117,7 @@
     "gen-go/integration_execute_input_rules_test.go": "sha256:6db850bbdfc31f60ac7ce6ec5cade4f5260b1836e56b2727efbfeee56db7a706",
     "gen-go/integration_operations.go": "sha256:1ba7ea4e118a2c4c8dd735b460b18d8658fbd7fd74e601ae372aff2844322f35",
     "gen-go/schema_documents.go": "sha256:c19c0d540f602ee997a84b90e20702d9bc63ed7d27aec267e76c04655fc182e0",
-    "gen-go/types.go": "sha256:48c35f5c3652388be74d374c22178650065e4ac669addf8a89aa31923b134e33",
+    "gen-go/types.go": "sha256:ee3e0ff2fc983f2cd2110d6d5169599c4fdad1ec5d9fb676a541a9b2e68f3198",
     "gen-go/version_state.go": "sha256:4ef8abb126414c0025cf2c59bc9c79a74ef4a2ff89e8f316cbf05acc872371c1"
   },
   "generatedTypeScript": {
@@ -153,7 +154,7 @@
     "gen-ts/data-source.ts": "sha256:2566f0d5c72e44278869f55211cf3d433aeb3552e57ae0ace0ff0b85e769dde6",
     "gen-ts/deploy-request.ts": "sha256:913245577a95354849d3a8cb43fbaedbf895efe7b653c8502d25edfa22b7a864",
     "gen-ts/deploy-response.ts": "sha256:364d9f1acf32e491498237cdd3f402d5f8e102f208db7748034f4ec68c6a6137",
-    "gen-ts/deployment-app-registration.ts": "sha256:8c2d55983e33449ecfbaceaa41aac3e2905f1970f5514f0dbc3b611fad7beefb",
+    "gen-ts/deployment-app-registration.ts": "sha256:cb02a7e54a1733fb0865802215235c0f9d532229fffca2dc26677bee5e5e950e",
     "gen-ts/deployment-continuation.ts": "sha256:cc9f63af4d0da5086a79103789e4f043783b75b4ed11c6512f044439a551a79c",
     "gen-ts/deployment-environment.ts": "sha256:fc08cabe2e52ebb93cfe84d2019994260f71734c33d0e50e7c63e40ef5b17cef",
     "gen-ts/deployment-preview-retirement.ts": "sha256:309421d08daf0ade163b6457ed0e5410ec6573c40a59423a6cce14780d9c38db",
@@ -167,7 +168,7 @@
     "gen-ts/error-envelope.ts": "sha256:4457309be794f9d4fc0cf62530cc2d442c007bac9ae84aff66df099cc9e40310",
     "gen-ts/external-sign-in.ts": "sha256:393ef74d72e37d33e374e3226f34ab3e854fdb0c1129a367997cbb690bf253a6",
     "gen-ts/identity-context.ts": "sha256:4b8151a321e224229250d214ef3e17f2ac986bb54ff0aadbb4509481724f6883",
-    "gen-ts/index.ts": "sha256:8f0b03bc46f0f24489e6a3f7a3ddee23c86dacc8ab2058b3b131c3d9dd75ab29",
+    "gen-ts/index.ts": "sha256:258bdcaa0d8d26dd2bb996d3ddb0b4bf4533db83d1b7f0d35a2a2af85c728117",
     "gen-ts/integration-connect-result.ts": "sha256:4b10f169b6e1af364e9b418de21caa9fadbfb77b43cbff77d741cfae0b52180c",
     "gen-ts/integration-error-details.ts": "sha256:e73cb5942373ef88b2d8e03a1de56d5a69e71069ecd14e68396f7edba1f60780",
     "gen-ts/integration-execute-input-rules.ts": "sha256:40e59de0d0977071e6438ad2149dc0513395adf7201aad95ab3d61e25a6c4e1d",
@@ -178,6 +179,7 @@
     "gen-ts/kit-bundle-manifest.ts": "sha256:73f5271d2eb3b5ce91e28933c5ab6883615c72a3808aa386f860f58f6df8edf6",
     "gen-ts/kit-lock.ts": "sha256:06bddeaf1e2c449c9cc0dbbc696210355a9005349c604d4050eb22385fb4c22e",
     "gen-ts/kvs-routing-entry.ts": "sha256:d92e85ee9f257d77850d1d3aac9438e2055f38084ff84a48fcedae239d47d4ca",
+    "gen-ts/mail-arrival-event.ts": "sha256:deb342c7f930a2c7bf66a46e4c0973e3b9047cd9725e714ccaeab8c64a89d25f",
     "gen-ts/promotion-request.ts": "sha256:9db88cef67f777a16bac628039ec3f582acb9e8cfff6fb592b30d0a0e55abc68",
     "gen-ts/promotion-response.ts": "sha256:f1c9cafac96faeb02a443a31786f67714e818f38d90108e7af41958396524d6f",
     "gen-ts/resolved-app-serving.ts": "sha256:3264e85827be47bf391781cb13a1e58318d356f7bee8c2ff3e5b00a062253b23",

package/dist/gen-ts/contract-release.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
-export declare const ContractRepositoryVersion: "0.91.0.0";
-export declare const ContractPublishVersion: "0.91.0";
-export declare const ContractPublishTag: "v0.91.0";
-export declare const ContractSchemasDigest: "sha256:b6ef945b91544184715900ca739d16f3ad8a40d5307a3b04d71cf7ac39c4fb39";
+export declare const ContractRepositoryVersion: "0.92.0.0";
+export declare const ContractPublishVersion: "0.92.0";
+export declare const ContractPublishTag: "v0.92.0";
+export declare const ContractSchemasDigest: "sha256:5b6aede1f569d02bf976d5331c9e8eb1e657b062be28fb89565ff50acd105c5a";
 export declare const ContractAiFixturesDigest: "sha256:edac31c92e146ca1c40130f2fb5649db82e24b8cd1ac758153b90612052fddb6";
-export declare const ContractGeneratedGoDigest: "sha256:7dc23154d2d8cc3a50733c32bc005d71afa877ab327d89a3c3a7dc8dbec7dc5b";
-export declare const ContractGeneratedTypeScriptDigest: "sha256:ae301b3932627690ffc23da6368dac812e5e33968dbe65fed52716c4896cbfcb";
+export declare const ContractGeneratedGoDigest: "sha256:64d78d9952ac08558ad956eb4c923677a0691e6260743c0dbc367b57e59ea822";
+export declare const ContractGeneratedTypeScriptDigest: "sha256:a99c149dbeb2b081bd460b95df4d44e29cc95e2fe2c737f4b012b7449c0c94d3";

package/dist/gen-ts/contract-release.js CHANGED Viewed

@@ -1,9 +1,9 @@
 /* eslint-disable */
 // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
-export const ContractRepositoryVersion = "0.91.0.0";
-export const ContractPublishVersion = "0.91.0";
-export const ContractPublishTag = "v0.91.0";
-export const ContractSchemasDigest = "sha256:b6ef945b91544184715900ca739d16f3ad8a40d5307a3b04d71cf7ac39c4fb39";
+export const ContractRepositoryVersion = "0.92.0.0";
+export const ContractPublishVersion = "0.92.0";
+export const ContractPublishTag = "v0.92.0";
+export const ContractSchemasDigest = "sha256:5b6aede1f569d02bf976d5331c9e8eb1e657b062be28fb89565ff50acd105c5a";
 export const ContractAiFixturesDigest = "sha256:edac31c92e146ca1c40130f2fb5649db82e24b8cd1ac758153b90612052fddb6";
-export const ContractGeneratedGoDigest = "sha256:7dc23154d2d8cc3a50733c32bc005d71afa877ab327d89a3c3a7dc8dbec7dc5b";
-export const ContractGeneratedTypeScriptDigest = "sha256:ae301b3932627690ffc23da6368dac812e5e33968dbe65fed52716c4896cbfcb";
+export const ContractGeneratedGoDigest = "sha256:64d78d9952ac08558ad956eb4c923677a0691e6260743c0dbc367b57e59ea822";
+export const ContractGeneratedTypeScriptDigest = "sha256:a99c149dbeb2b081bd460b95df4d44e29cc95e2fe2c737f4b012b7449c0c94d3";

package/dist/gen-ts/deployment-app-registration.d.ts CHANGED Viewed

@@ -21,4 +21,24 @@ export type DeploymentAppRegistration = {
      * @maxItems 1
      */
     signInMethods?: ('phone' | 'email')[];
+    mailArrivalTarget?: {
+        functionArn: string;
+        versionId: string;
+        /**
+         * @minItems 1
+         * @maxItems 100
+         */
+        jobs: {
+            name: string;
+            trigger: {
+                type: 'email.arrived';
+                connection: string;
+                resource: 'inbox';
+                filter?: {
+                    from?: string;
+                    subjectContains?: string;
+                };
+            };
+        }[];
+    };
 };

package/dist/gen-ts/index.d.ts CHANGED Viewed

@@ -56,6 +56,7 @@ export * from './internal-configuration-request.js';
 export * from './kit-bundle-manifest.js';
 export * from './kit-lock.js';
 export * from './kvs-routing-entry.js';
+export * from './mail-arrival-event.js';
 export * from './promotion-request.js';
 export * from './promotion-response.js';
 export * from './resolved-app-serving.js';

package/dist/gen-ts/index.js CHANGED Viewed

@@ -58,6 +58,7 @@ export * from './internal-configuration-request.js';
 export * from './kit-bundle-manifest.js';
 export * from './kit-lock.js';
 export * from './kvs-routing-entry.js';
+export * from './mail-arrival-event.js';
 export * from './promotion-request.js';
 export * from './promotion-response.js';
 export * from './resolved-app-serving.js';

package/dist/gen-ts/mail-arrival-event.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * IAM-authorized invocation of a deployed app Event Function. The delivery ID is stable across notification retries; runtime deduplicates before running the declared job. No tokens or message bodies.
+ */
+export interface MailArrivalEvent {
+    mailArrival: {
+        deliveryId: string;
+        job: string;
+        owner: string;
+        input: {
+            provider: 'gmail' | 'outlook';
+            sourceId: string;
+            messageId: string;
+            threadId: string;
+            receivedAt: string;
+        };
+    };
+}

package/dist/gen-ts/mail-arrival-event.js ADDED Viewed

@@ -0,0 +1,3 @@
+/* eslint-disable */
+// Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
+export {};

package/gen-ts/contract-release.ts CHANGED Viewed

@@ -1,10 +1,10 @@
 /* eslint-disable */
 // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
-export const ContractRepositoryVersion = "0.91.0.0" as const;
-export const ContractPublishVersion = "0.91.0" as const;
-export const ContractPublishTag = "v0.91.0" as const;
-export const ContractSchemasDigest = "sha256:b6ef945b91544184715900ca739d16f3ad8a40d5307a3b04d71cf7ac39c4fb39" as const;
+export const ContractRepositoryVersion = "0.92.0.0" as const;
+export const ContractPublishVersion = "0.92.0" as const;
+export const ContractPublishTag = "v0.92.0" as const;
+export const ContractSchemasDigest = "sha256:5b6aede1f569d02bf976d5331c9e8eb1e657b062be28fb89565ff50acd105c5a" as const;
 export const ContractAiFixturesDigest = "sha256:edac31c92e146ca1c40130f2fb5649db82e24b8cd1ac758153b90612052fddb6" as const;
-export const ContractGeneratedGoDigest = "sha256:7dc23154d2d8cc3a50733c32bc005d71afa877ab327d89a3c3a7dc8dbec7dc5b" as const;
-export const ContractGeneratedTypeScriptDigest = "sha256:ae301b3932627690ffc23da6368dac812e5e33968dbe65fed52716c4896cbfcb" as const;
+export const ContractGeneratedGoDigest = "sha256:64d78d9952ac08558ad956eb4c923677a0691e6260743c0dbc367b57e59ea822" as const;
+export const ContractGeneratedTypeScriptDigest = "sha256:a99c149dbeb2b081bd460b95df4d44e29cc95e2fe2c737f4b012b7449c0c94d3" as const;

package/gen-ts/deployment-app-registration.ts CHANGED Viewed

@@ -24,4 +24,24 @@ export type DeploymentAppRegistration = {
    * @maxItems 1
    */
   signInMethods?: ('phone' | 'email')[];
+  mailArrivalTarget?: {
+    functionArn: string;
+    versionId: string;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    jobs: {
+      name: string;
+      trigger: {
+        type: 'email.arrived';
+        connection: string;
+        resource: 'inbox';
+        filter?: {
+          from?: string;
+          subjectContains?: string;
+        };
+      };
+    }[];
+  };
 };

package/gen-ts/index.ts CHANGED Viewed

@@ -59,6 +59,7 @@ export * from './internal-configuration-request.js';
 export * from './kit-bundle-manifest.js';
 export * from './kit-lock.js';
 export * from './kvs-routing-entry.js';
+export * from './mail-arrival-event.js';
 export * from './promotion-request.js';
 export * from './promotion-response.js';
 export * from './resolved-app-serving.js';

package/gen-ts/mail-arrival-event.ts ADDED Viewed

@@ -0,0 +1,20 @@
+/* eslint-disable */
+// Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
+/**
+ * IAM-authorized invocation of a deployed app Event Function. The delivery ID is stable across notification retries; runtime deduplicates before running the declared job. No tokens or message bodies.
+ */
+export interface MailArrivalEvent {
+  mailArrival: {
+    deliveryId: string;
+    job: string;
+    owner: string;
+    input: {
+      provider: 'gmail' | 'outlook';
+      sourceId: string;
+      messageId: string;
+      threadId: string;
+      receivedAt: string;
+    };
+  };
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@fourier-labs/harbour-contracts",
-  "version": "0.91.0",
+  "version": "0.92.0",
   "description": "Single source of truth for every data shape that crosses a boundary between Isomorph components.",
   "license": "UNLICENSED",
   "private": false,

package/schema/deployment-app-registration.schema.json CHANGED Viewed

@@ -5,23 +5,205 @@
   "description": "IAM/SigV4 POST /v1/internal/deployment/apps/{appId}/register (Internal API) or POST /v1/deployment/apps/register body. Governance derives tenant identity-provider configuration; no identity secrets are supplied. apiHostnames explicitly identifies API hosts among backendHostnames; runtime validates that subset. Omission preserves legacy .api. inference during the coordinated V2 auth migration.",
   "type": "object",
   "additionalProperties": false,
-  "required": ["tenantId", "appId", "origin"],
+  "required": [
+    "tenantId",
+    "appId",
+    "origin"
+  ],
   "properties": {
-    "tenantId": {"type": "string", "minLength": 1},
-    "appId": {"type": "string", "minLength": 1},
-    "origin": {"type": "string", "format": "uri"},
-    "publicHostname": {"type": "string", "format": "hostname"},
-    "backendHostnames": {"type": "array", "uniqueItems": true, "items": {"type": "string", "format": "hostname"}},
-    "apiHostnames": {"type": "array", "uniqueItems": true, "items": {"type": "string", "format": "hostname"}},
-    "pathPrefix": {"type": "string", "pattern": "^/"},
-    "environment": {"type": "string", "enum": ["preview", "production"]},
-    "allowedDomains": {"type": "array", "items": {"type": "string"}},
-    "allowedUsers": {"type": "array", "items": {"type": "string"}},
-    "allowedGroups": {"type": "array", "items": {"type": "string"}},
-    "enabled": {"type": "boolean"},
-    "workloadPrincipalArn": {"type": "string", "pattern": "^arn:aws:(iam|sts)::[0-9]+:"},
-    "signIn": {"type": "string", "enum": ["company", "external"]},
-    "signInMethods": {"type": "array", "items": {"type": "string", "enum": ["phone", "email"]}, "minItems": 1, "maxItems": 1}
+    "tenantId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "appId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "origin": {
+      "type": "string",
+      "format": "uri"
+    },
+    "publicHostname": {
+      "type": "string",
+      "format": "hostname"
+    },
+    "backendHostnames": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "format": "hostname"
+      }
+    },
+    "apiHostnames": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "format": "hostname"
+      }
+    },
+    "pathPrefix": {
+      "type": "string",
+      "pattern": "^/"
+    },
+    "environment": {
+      "type": "string",
+      "enum": [
+        "preview",
+        "production"
+      ]
+    },
+    "allowedDomains": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "allowedUsers": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "allowedGroups": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "enabled": {
+      "type": "boolean"
+    },
+    "workloadPrincipalArn": {
+      "type": "string",
+      "pattern": "^arn:aws:(iam|sts)::[0-9]+:"
+    },
+    "signIn": {
+      "type": "string",
+      "enum": [
+        "company",
+        "external"
+      ]
+    },
+    "signInMethods": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "phone",
+          "email"
+        ]
+      },
+      "minItems": 1,
+      "maxItems": 1
+    },
+    "mailArrivalTarget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "functionArn",
+        "versionId",
+        "jobs"
+      ],
+      "properties": {
+        "functionArn": {
+          "type": "string",
+          "pattern": "^arn:aws:lambda:[a-z0-9-]+:[0-9]{12}:function:[A-Za-z0-9-_]+$"
+        },
+        "versionId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "jobs": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 100,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "trigger"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+              },
+              "trigger": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "type",
+                  "connection",
+                  "resource"
+                ],
+                "properties": {
+                  "type": {
+                    "const": "email.arrived"
+                  },
+                  "connection": {
+                    "type": "string",
+                    "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+                  },
+                  "resource": {
+                    "const": "inbox"
+                  },
+                  "filter": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "from": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 320
+                      },
+                      "subjectContains": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 320
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
   },
-  "allOf": [{"if": {"properties": {"signIn": {"const": "external"}}, "required": ["signIn"]}, "then": {"required": ["signInMethods"]}}]
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "signIn": {
+            "const": "external"
+          }
+        },
+        "required": [
+          "signIn"
+        ]
+      },
+      "then": {
+        "required": [
+          "signInMethods"
+        ]
+      }
+    },
+    {
+      "if": {
+        "required": [
+          "mailArrivalTarget"
+        ]
+      },
+      "then": {
+        "required": [
+          "environment",
+          "workloadPrincipalArn"
+        ]
+      }
+    }
+  ]
 }

package/schema/mail-arrival-event.schema.json ADDED Viewed

@@ -0,0 +1,75 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://contracts.harbour.dev/mail-arrival-event.schema.json",
+  "title": "MailArrivalEvent",
+  "description": "IAM-authorized invocation of a deployed app Event Function. The delivery ID is stable across notification retries; runtime deduplicates before running the declared job. No tokens or message bodies.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "mailArrival"
+  ],
+  "properties": {
+    "mailArrival": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "deliveryId",
+        "job",
+        "owner",
+        "input"
+      ],
+      "properties": {
+        "deliveryId": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "job": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+        },
+        "owner": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 320
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "provider",
+            "sourceId",
+            "messageId",
+            "threadId",
+            "receivedAt"
+          ],
+          "properties": {
+            "provider": {
+              "enum": [
+                "gmail",
+                "outlook"
+              ]
+            },
+            "sourceId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            "messageId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2048
+            },
+            "threadId": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "receivedAt": {
+              "type": "string",
+              "format": "date-time"
+            }
+          }
+        }
+      }
+    }
+  }
+}