mailschema 0.2.2 → 0.3.0

package/dist/core.schema.json

@@ -0,0 +1,210 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mailschema.org/artifacts/map-0.3/schemas/core.schema.json",
+  "title": "MAP 0.3 description shape; semantic checks in Core are additionally required",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "@context",
+    "@type",
+    "@id",
+    "profile",
+    "type",
+    "issuedAt",
+    "expiresAt",
+    "inLanguage",
+    "service",
+    "recipient",
+    "subject",
+    "terms",
+    "details",
+    "operations",
+    "human"
+  ],
+  "properties": {
+    "@context": {
+      "const": "https://mailschema.org/contexts/map-0.3.jsonld"
+    },
+    "@type": {
+      "const": "MailAction"
+    },
+    "@id": {
+      "type": "string",
+      "minLength": 1,
+      "format": "uri",
+      "maxLength": 2048
+    },
+    "profile": {
+      "const": "https://mailschema.org/profiles/map/0.3"
+    },
+    "type": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "contractDigest"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "pattern": "^https://",
+          "maxLength": 2048
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "contractDigest": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^sha-256:[0-9a-f]{64}$"
+        }
+      }
+    },
+    "issuedAt": {
+      "type": "string",
+      "minLength": 1,
+      "format": "date-time",
+      "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\dZ$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "minLength": 1,
+      "format": "date-time",
+      "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\dZ$"
+    },
+    "inLanguage": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 255
+    },
+    "service": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "pattern": "^https://(?![0-9.]+(:[0-9]+)?$)[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)*(:[0-9]{1,5})?$",
+          "maxLength": 2048
+        },
+        "tenant": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "maxLength": 2048
+        }
+      }
+    },
+    "recipient": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 320
+    },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "title"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "maxLength": 2048
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2048
+        }
+      }
+    },
+    "terms": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "maxLength": 2048
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[ -~]+$",
+          "maxLength": 1024
+        }
+      }
+    },
+    "details": {
+      "type": "object"
+    },
+    "operations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z][a-z0-9-]{0,63}$"
+          },
+          "capability": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "url"
+            ],
+            "properties": {
+              "url": {
+                "type": "string",
+                "minLength": 1,
+                "format": "uri",
+                "pattern": "^https://[^/?#@]+([/?][^#]*)?$",
+                "maxLength": 4096
+              }
+            }
+          }
+        }
+      },
+      "minItems": 1,
+      "maxItems": 32
+    },
+    "human": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "url"
+      ],
+      "properties": {
+        "url": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "pattern": "^https://[^/?#@]+([/?][^#]*)?$",
+          "maxLength": 4096
+        }
+      }
+    }
+  }
+}

package/dist/implementation.schema.json

@@ -0,0 +1,173 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mailschema.org/artifacts/map-0.3/schemas/implementation.schema.json",
+  "title": "MAP implementation record",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "service",
+    "maintainer",
+    "type",
+    "operations",
+    "binding",
+    "status",
+    "documentation",
+    "evidence"
+  ],
+  "dependentRequired": {
+    "artifact": ["format"],
+    "format": ["artifact"]
+  },
+  "properties": {
+    "service": {
+      "type": "string",
+      "minLength": 1,
+      "format": "uri",
+      "pattern": "^https://"
+    },
+    "maintainer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "url"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "url": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "pattern": "^https://"
+        }
+      }
+    },
+    "type": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "contractDigest"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "pattern": "^https://"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "contractDigest": {
+          "type": "string",
+          "pattern": "^sha-256:[0-9a-f]{64}$"
+        }
+      }
+    },
+    "operations": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "binding": {
+      "type": "string",
+      "format": "uri",
+      "pattern": "^https://",
+      "description": "Identifier of the binding specification or documented service binding. It is not a request destination. Clients must explicitly support it."
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "url",
+        "digest",
+        "digestMode"
+      ],
+      "properties": {
+        "url": {
+          "type": "string",
+          "minLength": 1,
+          "format": "uri",
+          "pattern": "^https://"
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha-256:[0-9a-f]{64}$"
+        },
+        "digestMode": {
+          "enum": [
+            "canonical-json",
+            "bytes"
+          ],
+          "description": "canonical-json hashes the RFC 8785 representation; bytes hashes the exact downloaded artifact. Both use SHA-256."
+        }
+      }
+    },
+    "format": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "Draft",
+        "Experimental",
+        "Stable",
+        "Deprecated",
+        "Superseded"
+      ]
+    },
+    "documentation": {
+      "type": "string",
+      "minLength": 1,
+      "format": "uri",
+      "pattern": "^https://"
+    },
+    "evidence": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "kind",
+          "url",
+          "summary"
+        ],
+        "properties": {
+          "kind": {
+            "enum": [
+              "declaration",
+              "test-report"
+            ]
+          },
+          "url": {
+            "type": "string",
+            "minLength": 1,
+            "format": "uri",
+            "pattern": "^https://"
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "successor": {
+      "type": "string",
+      "minLength": 1,
+      "format": "uri",
+      "pattern": "^https://"
+    }
+  }
+}

package/dist/index.d.ts

@@ -1,10 +1,5 @@
+/**
+ * Mail Action Protocol 0.3 processing: parse and check descriptions, type contracts and
+ * implementation records, and compute the RFC 8785 digests that identify contracts.
+ */
 export * from './core/index.js';
-export { contributionErrors, assertContribution, assertTypeRecord, referenceErrors, } from './validation.js';
-export type { CatalogView } from './validation.js';
-export { typeStages } from './model.js';
-export type { Party, TypeDefinition, TypeRecord, Contribution, Implementation } from './model.js';
-export { getMapSchema, getMapContext, getContractFormatSchema, getFormsSchema } from './map.js';
-/** Return an independent copy of the contribution JSON Schema (Draft 2020-12). */
-export declare function getContributionSchema(): Record<string, unknown>;
-/** Return the schema for an expanded Registry record, including attribution and history. */
-export declare function getRecordSchema(): Record<string, unknown>;

package/dist/index.js

@@ -1,17 +1,5 @@
 /**
- * Mail Action Protocol 0.2 processing and core artifacts, and validation tools for MailSchema
- * Registry contributions.
+ * Mail Action Protocol 0.3 processing: parse and check descriptions, type contracts and
+ * implementation records, and compute the RFC 8785 digests that identify contracts.
  */
-import schema from './contribution.schema.json' with { type: 'json' };
 export * from './core/index.js';
-export { contributionErrors, assertContribution, assertTypeRecord, referenceErrors, } from './validation.js';
-export { typeStages } from './model.js';
-export { getMapSchema, getMapContext, getContractFormatSchema, getFormsSchema } from './map.js';
-/** Return an independent copy of the contribution JSON Schema (Draft 2020-12). */
-export function getContributionSchema() {
-    return structuredClone(schema);
-}
-/** Return the schema for an expanded Registry record, including attribution and history. */
-export function getRecordSchema() {
-    return { $schema: schema.$schema, $defs: structuredClone(schema.$defs), $ref: '#/$defs/record' };
-}

package/dist/profile.json

@@ -0,0 +1,27 @@
+{
+  "id": "https://mailschema.org/profiles/map/0.3",
+  "name": "Mail Action Protocol 0.3",
+  "status": "working-draft",
+  "description": "An action description carried in Structured Email. A trusted service binding maps each decision to the service's existing operations, and the service enforces permission and exact terms. Types are defined by digest-bound contracts.",
+  "context": "https://mailschema.org/contexts/map-0.3.jsonld",
+  "schema": "https://mailschema.org/artifacts/map-0.3/schemas/core.schema.json",
+  "contractFormat": "https://mailschema.org/artifacts/map-0.3/schemas/contract.schema.json",
+  "specification": "https://mailschema.org/specification/core",
+  "artifacts": {
+    "context": {
+      "url": "https://mailschema.org/contexts/map-0.3.jsonld",
+      "sha256": "a51490d1fe8af695c14ea508aad88fd0429d18564791b6b52f3ab07d5c51aab3"
+    },
+    "schema": {
+      "url": "https://mailschema.org/artifacts/map-0.3/schemas/core.schema.json",
+      "sha256": "0ad09a6955a47e7a2c1c1eec0747a3e0b15c08a79860e90ce4e65da11983aeb3"
+    },
+    "contractFormat": {
+      "url": "https://mailschema.org/artifacts/map-0.3/schemas/contract.schema.json",
+      "sha256": "86bf057529c4fd2c7f0a880825774afeed31e9f7ba1d99760858a585fe28d18d"
+    },
+    "conformance": {
+      "url": "https://github.com/mailschema/mailschema/blob/main/conformance/map-0.3/README.md"
+    }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mailschema",
-  "version": "0.2.2",
-  "description": "Mail Action Protocol 0.2 processing and core artifacts, and MailSchema Registry validation",
+  "version": "0.3.0",
+  "description": "Mail Action Protocol 0.3: parse and check descriptions, type contracts and implementation records",
   "type": "module",
   "license": "MIT",
   "author": "MailSchema contributors",
@@ -21,11 +21,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
-    "./contribution.schema.json": "./dist/contribution.schema.json",
-    "./map-0.2.schema.json": "./dist/map-0.2.schema.json",
-    "./map-0.2.jsonld": "./dist/map-0.2.jsonld",
-    "./type-contract-0.2.schema.json": "./dist/type-contract-0.2.schema.json",
-    "./forms-0.1.schema.json": "./dist/forms-0.1.schema.json",
+    "./profile.json": "./dist/profile.json",
+    "./context.jsonld": "./dist/context.jsonld",
+    "./core.schema.json": "./dist/core.schema.json",
+    "./contract.schema.json": "./dist/contract.schema.json",
+    "./implementation.schema.json": "./dist/implementation.schema.json",
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.ts",
@@ -52,10 +52,9 @@
   },
   "keywords": [
     "email",
-    "schema",
+    "mail-action-protocol",
     "json-schema",
-    "agents",
-    "registry"
+    "agents"
   ],
   "publishConfig": {
     "access": "public",