@mdbase-dev/connect-protocol 0.1.0-beta.32 → 0.1.0-beta.34

package/dist/application-authorization.d.ts

@@ -3,9 +3,10 @@ import type { CollectionOperation } from "./operations.js";
 import type { ConnectContractRequirements } from "./compatibility.js";
 export type ApplicationAuthorizationFlow = "authorization_code" | "device_code";
 export interface ApplicationAuthorizationBinding {
-    protocol_version: 3;
+    protocol_version: 4;
     authorization_id: string;
     application_id: string;
+    application_declaration_id: string;
     application_manifest_digest: string;
     application_installation_id: string;
     installation_signing_public_key: string;

package/dist/application-authorization.js

@@ -1,5 +1,5 @@
 const INSTALLATION_ID_DOMAIN = new TextEncoder().encode("mdbase-connect application installation id v2\0");
-const AUTHORIZATION_PROOF_DOMAIN = new TextEncoder().encode("mdbase-connect application authorization proof v3\0");
+const AUTHORIZATION_PROOF_DOMAIN = new TextEncoder().encode("mdbase-connect application authorization proof v4\0");
 export async function applicationInstallationIdFromPublicKey(signingPublicKey) {
     const signing = publicKey(signingPublicKey);
     const digest = new Uint8Array(await crypto.subtle.digest("SHA-256", concat([INSTALLATION_ID_DOMAIN, field(signing)])));
@@ -26,8 +26,9 @@ export function authorizationSigningMessage(binding) {
     const nonce = canonicalBase64(binding.authorization_nonce);
     const challenge = canonicalBase64(binding.code_challenge);
     const contracts = binding.contracts;
-    if (binding.protocol_version !== 3
+    if (binding.protocol_version !== 4
         || nonce.byteLength !== 32
+        || !/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)+$/u.test(binding.application_declaration_id)
         || !/^[0-9a-f]{64}$/u.test(binding.application_manifest_digest)
         || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?Z$/u.test(binding.issued_at)
         || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?Z$/u.test(binding.expires_at)
@@ -55,6 +56,7 @@ export function authorizationSigningMessage(binding) {
         u32(binding.protocol_version),
         field(uuidBytes(binding.application_id)),
         field(uuidBytes(binding.authorization_id)),
+        field(new TextEncoder().encode(binding.application_declaration_id)),
         field(hexBytes(binding.application_manifest_digest)),
         field(uuidBytes(binding.application_installation_id)),
         ...keys.map(field),

package/dist/capabilities.d.ts

@@ -26,6 +26,7 @@ export declare const APPLICATION_CAPABILITY_DEFINITIONS: {
     readonly "definitions.update": readonly ["update_type"];
     readonly "definitions.type-pack.inspect": readonly ["assess_type_pack"];
     readonly "definitions.type-pack.apply": readonly ["assess_type_pack", "apply_type_pack"];
+    readonly "collection.setup.apply": readonly ["assess_collection_setup", "apply_collection_setup"];
     readonly "timers.list": readonly ["list_timers"];
     readonly "timers.put": readonly ["put_timer"];
     readonly "timers.cancel": readonly ["cancel_timer"];

package/dist/capabilities.js

@@ -25,6 +25,7 @@ export const APPLICATION_CAPABILITY_DEFINITIONS = {
     "definitions.update": ["update_type"],
     "definitions.type-pack.inspect": ["assess_type_pack"],
     "definitions.type-pack.apply": ["assess_type_pack", "apply_type_pack"],
+    "collection.setup.apply": ["assess_collection_setup", "apply_collection_setup"],
     "timers.list": ["list_timers"],
     "timers.put": ["put_timer"],
     "timers.cancel": ["cancel_timer"],

package/dist/collection-setup.d.ts

@@ -0,0 +1,83 @@
+import type { ContractSetupChoice, TypePackAssessment, TypePackProvision, TypePackReceipt } from "./type-packs.js";
+export type ConfigurationContributionValue = string | number | boolean | null;
+export interface ConfigurationRequirement {
+    id: string;
+    path: string;
+    predicate: "contains";
+    value: ConfigurationContributionValue;
+}
+export interface ConfigurationProvision {
+    requirement: string;
+    operation: "set_add";
+    path: string;
+    value: ConfigurationContributionValue;
+}
+export interface ApplicationCollectionSetupRequirements {
+    configuration: ConfigurationRequirement[];
+}
+export interface ApplicationCollectionSetupProvisions {
+    configuration: ConfigurationProvision[];
+    type_packs: TypePackProvision[];
+}
+export interface AssessCollectionSetupInput {
+    /** Stable application declaration id, not the server's database id. */
+    application_id: string;
+    /** Exact canonical digest of the complete registered application declaration. */
+    declaration_digest: string;
+    requirements: ApplicationCollectionSetupRequirements;
+    provisions: ApplicationCollectionSetupProvisions;
+    /** Collection-owner choices for user-owned contract implementations. */
+    contract_setups?: ContractSetupChoice[];
+}
+export interface ApplyCollectionSetupInput extends AssessCollectionSetupInput {
+    expected_assessment_digest: string;
+    expected_collection_revision: string;
+    expected_provision_digest: string;
+    allow_type_pack_downgrades?: string[];
+}
+export interface ConfigurationSetupConflict {
+    code: "configuration_path_conflict" | "configuration_type_conflict";
+    path: string;
+    expected: "mapping" | "sequence";
+    observed: "null" | "boolean" | "number" | "string" | "sequence" | "mapping" | "tagged";
+    message: string;
+}
+export interface ConfigurationSetupAssessment {
+    requirement: string;
+    path: string;
+    value: ConfigurationContributionValue;
+    action: "current" | "add" | "conflict";
+    conflict?: ConfigurationSetupConflict;
+}
+export interface CollectionSetupAssessment {
+    status: "current" | "provision" | "conflict";
+    applicable: boolean;
+    application_id: string;
+    declaration_digest: string;
+    provision_digest: string;
+    collection_revision: string;
+    final_collection_revision: string;
+    configuration: ConfigurationSetupAssessment[];
+    type_packs: TypePackAssessment[];
+    final_resource_revisions: Record<string, string>;
+    assessment_digest: string;
+}
+export interface ConfigurationContributionReceipt {
+    requirement: string;
+    path: string;
+    value: ConfigurationContributionValue;
+}
+export interface CollectionSetupReceipt {
+    application_id: string;
+    declaration_digest: string;
+    provision_digest: string;
+    assessment_digest: string;
+    collection_revision: string;
+    configuration: ConfigurationContributionReceipt[];
+    type_packs: TypePackReceipt[];
+    cleanup_deferred: boolean;
+}
+export interface CollectionSetupApplyResult {
+    assessment: CollectionSetupAssessment;
+    receipt: CollectionSetupReceipt;
+}

package/dist/collection-setup.js

@@ -0,0 +1 @@
+export {};

package/dist/compatibility.d.ts

@@ -1,7 +1,7 @@
 import type { ApplicationFileRequirement } from "./files.js";
 import { type CollectionOperation } from "./operations.js";
 export declare const OPERATION_TRANSPORT_PROTOCOL_VERSION: 2;
-export declare const AUTHORIZATION_BINDING_PROTOCOL_VERSION: 3;
+export declare const AUTHORIZATION_BINDING_PROTOCOL_VERSION: 4;
 export declare const SEMANTIC_CAPABILITY_CONTRACT_VERSION: 1;
 export declare const DURABLE_MUTATION_CONTRACT_VERSION: 1;
 export interface ConnectContractRequirements {

package/dist/compatibility.js

@@ -1,6 +1,6 @@
 import { isMutatingOperation } from "./operations.js";
 export const OPERATION_TRANSPORT_PROTOCOL_VERSION = 2;
-export const AUTHORIZATION_BINDING_PROTOCOL_VERSION = 3;
+export const AUTHORIZATION_BINDING_PROTOCOL_VERSION = 4;
 export const SEMANTIC_CAPABILITY_CONTRACT_VERSION = 1;
 export const DURABLE_MUTATION_CONTRACT_VERSION = 1;
 export const CONNECT_CONTRACT_SUPPORT = {

package/dist/files.d.ts

@@ -152,6 +152,8 @@ export interface FileTransferStatus {
     state: FileTransferState;
     received: number[];
     received_bytes: number;
+    /** Object-store receipts for the currently durable multipart parts. */
+    uploaded_parts: UploadedFilePart[];
 }
 export interface PrepareFileUploadPartRequest {
     protocol_version: 1;

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import type { ApplicationFileRequirement, CollectionFileDescriptor, FileCapabili
 import type { CollectionOperation } from "./operations.js";
 import type { ApplicationCapabilityRequirements } from "./capabilities.js";
 import type { ContractRequirement, ContractSetupChoice, TypePackProvision } from "./type-packs.js";
+import type { ConfigurationProvision, ConfigurationRequirement } from "./collection-setup.js";
 import type { ApplicationAuthorizationProof } from "./application-authorization.js";
 export * from "./connect-problems.generated.js";
 export * from "./files.js";
@@ -12,6 +13,7 @@ export * from "./compatibility.js";
 export * from "./capabilities.js";
 export * from "./application-authorization.js";
 export * from "./type-packs.js";
+export * from "./collection-setup.js";
 export declare const CONTROL_PROTOCOL_VERSION: 1;
 export { AUTHORIZATION_BINDING_PROTOCOL_VERSION as APPLICATION_AUTHORIZATION_PROTOCOL_VERSION } from "./compatibility.js";
 export declare const LOOPBACK_PROTOCOL_VERSION: 1;
@@ -21,11 +23,11 @@ export declare const GRANT_ENCRYPTION_PROTOCOL_VERSION: 1;
 export declare const SYNC_PROTOCOL_VERSION: 1;
 export declare const CONTRACT_SETUP_CAPABILITY: "contract-setup-v1";
 export declare const FILE_RELAY_CAPABILITY: "file-relay-v1";
-export declare const RELAY_REQUIRED_CAPABILITIES: readonly ["application-authorization-v3", "authorization-activation", "encrypted-relay", "policy-ack"];
-export declare const MINIMUM_CONNECTOR_VERSION: "0.1.0-beta.32";
+export declare const RELAY_REQUIRED_CAPABILITIES: readonly ["application-authorization-v4", "authorization-activation", "encrypted-relay", "policy-ack"];
+export declare const MINIMUM_CONNECTOR_VERSION: "0.1.0-beta.33";
 export declare const HOSTED_PROVIDER_REQUIRED_CAPABILITIES: readonly ["durable-mutation-journal-v1", "durable-file-lifecycle-v1"];
 export declare const HOSTED_PROVIDER_CAPABILITIES: readonly ["durable-mutation-journal-v1", "durable-file-lifecycle-v1", "mutation-replay-after-credential-retirement-v1"];
-export declare const RELAY_CAPABILITIES: readonly ["application-authorization-v3", "authorization-activation", "encrypted-relay", "policy-ack", "contract-setup-v1", "file-relay-v1"];
+export declare const RELAY_CAPABILITIES: readonly ["application-authorization-v4", "authorization-activation", "encrypted-relay", "policy-ack", "contract-setup-v1", "file-relay-v1"];
 export declare const AUTHORITY_PROOF_VERSION: 1;
 export declare const AUTHORITY_PROOF_ALGORITHM: "P256-SHA256";
 export declare const AUTHORITY_PROOF_DOMAIN: "mdbase-authority-request-proof-v1";
@@ -153,6 +155,8 @@ export interface NotificationWebhook {
 }
 export interface ApplicationRequirements {
     contracts: ContractRequirement[];
+    /** Collection extension values required before the application is ready. */
+    configuration?: ConfigurationRequirement[];
     /** Versioned semantic intent compiled by Connect into exact operations. */
     capabilities?: ApplicationCapabilityRequirements;
     /** Access boundary requested after compatibility and provisioning checks. */
@@ -164,6 +168,8 @@ export interface ApplicationRequirements {
 }
 export interface ApplicationProvisions {
     type_packs: TypePackProvision[];
+    /** Narrow semantic changes that may satisfy configuration requirements. */
+    configuration?: ConfigurationProvision[];
 }
 export interface GrantScope {
     /**
@@ -550,6 +556,8 @@ export interface AuthorizationActivationResponse {
     contracts: CollectionContractDescriptor[];
     /** Exact setup plan applied by the authority. */
     contract_setups: ContractSetupChoice[];
+    setup_assessment?: unknown;
+    provision_receipt?: unknown;
     error?: {
         code: string;
         message: string;

package/dist/index.js

@@ -6,6 +6,7 @@ export * from "./compatibility.js";
 export * from "./capabilities.js";
 export * from "./application-authorization.js";
 export * from "./type-packs.js";
+export * from "./collection-setup.js";
 export const CONTROL_PROTOCOL_VERSION = 1;
 export { AUTHORIZATION_BINDING_PROTOCOL_VERSION as APPLICATION_AUTHORIZATION_PROTOCOL_VERSION } from "./compatibility.js";
 export const LOOPBACK_PROTOCOL_VERSION = 1;
@@ -16,12 +17,12 @@ export const SYNC_PROTOCOL_VERSION = 1;
 export const CONTRACT_SETUP_CAPABILITY = "contract-setup-v1";
 export const FILE_RELAY_CAPABILITY = "file-relay-v1";
 export const RELAY_REQUIRED_CAPABILITIES = [
-    "application-authorization-v3",
+    "application-authorization-v4",
     "authorization-activation",
     "encrypted-relay",
     "policy-ack"
 ];
-export const MINIMUM_CONNECTOR_VERSION = "0.1.0-beta.32";
+export const MINIMUM_CONNECTOR_VERSION = "0.1.0-beta.33";
 export const HOSTED_PROVIDER_REQUIRED_CAPABILITIES = [
     "durable-mutation-journal-v1",
     "durable-file-lifecycle-v1"

package/dist/manifest.js

@@ -40,7 +40,8 @@ export function validateAppManifest(value, options = {}) {
     const issues = [
         ...validateManifestOrigins(value, options.allowLocal === true),
         ...validateCapabilityRequirements(value),
-        ...validateProvisionRequirements(value)
+        ...validateProvisionRequirements(value),
+        ...validateConfigurationSetup(value)
     ];
     return issues.length === 0 ? { valid: true, issues: [] } : invalid(issues);
 }
@@ -52,8 +53,16 @@ export function parseAppManifest(value, options = {}) {
     const manifest = structuredClone(value);
     return {
         ...manifest,
-        requirements: manifest.requirements ?? { contracts: [] },
-        provisions: manifest.provisions ?? { type_packs: [] },
+        requirements: {
+            contracts: [],
+            configuration: [],
+            ...manifest.requirements
+        },
+        provisions: {
+            type_packs: [],
+            configuration: [],
+            ...manifest.provisions
+        },
         notifications: manifest.notifications ?? { criteria: [] }
     };
 }
@@ -253,6 +262,95 @@ function validateProvisionRequirements(value) {
     }
     return issues;
 }
+function validateConfigurationSetup(value) {
+    const manifest = asObject(value);
+    const requirements = asObject(manifest.requirements);
+    const provisions = asObject(manifest.provisions);
+    const requiredValues = Array.isArray(requirements.configuration)
+        ? requirements.configuration
+        : [];
+    const provisionValues = Array.isArray(provisions.configuration)
+        ? provisions.configuration
+        : [];
+    const issues = [];
+    const required = new Map();
+    for (const [index, candidate] of requiredValues.entries()) {
+        const requirement = asObject(candidate);
+        const id = String(requirement.id);
+        const path = String(requirement.path);
+        const pathError = configurationPointerError(path);
+        if (pathError) {
+            issues.push(issue(`/requirements/configuration/${index}/path`, "configurationPointer", pathError));
+        }
+        if (required.has(id)) {
+            issues.push(issue(`/requirements/configuration/${index}/id`, "uniqueRequirement", `duplicates configuration requirement ${id}`));
+        }
+        else {
+            required.set(id, { path, value: requirement.value, index });
+        }
+    }
+    const linked = new Set();
+    const contributionKeys = new Set();
+    for (const [index, candidate] of provisionValues.entries()) {
+        const provision = asObject(candidate);
+        const requirementId = String(provision.requirement);
+        const path = String(provision.path);
+        const pathError = configurationPointerError(path);
+        if (pathError) {
+            issues.push(issue(`/provisions/configuration/${index}/path`, "configurationPointer", pathError));
+        }
+        const requirement = required.get(requirementId);
+        if (!requirement) {
+            issues.push(issue(`/provisions/configuration/${index}/requirement`, "configurationRequirement", `references unknown configuration requirement ${requirementId}`));
+            continue;
+        }
+        if (linked.has(requirementId)) {
+            issues.push(issue(`/provisions/configuration/${index}/requirement`, "uniqueProvision", `configuration requirement ${requirementId} may have exactly one provision`));
+        }
+        linked.add(requirementId);
+        if (path !== requirement.path) {
+            issues.push(issue(`/provisions/configuration/${index}/path`, "configurationRequirement", `must equal /requirements/configuration/${requirement.index}/path`));
+        }
+        if (JSON.stringify(provision.value) !== JSON.stringify(requirement.value)) {
+            issues.push(issue(`/provisions/configuration/${index}/value`, "configurationRequirement", `must equal /requirements/configuration/${requirement.index}/value`));
+        }
+        const contributionKey = `${path}\0${JSON.stringify(provision.value)}`;
+        if (contributionKeys.has(contributionKey)) {
+            issues.push(issue(`/provisions/configuration/${index}`, "uniqueContribution", "duplicates another configuration path and value contribution"));
+        }
+        contributionKeys.add(contributionKey);
+    }
+    for (const [id, requirement] of required) {
+        if (!linked.has(id)) {
+            issues.push(issue(`/requirements/configuration/${requirement.index}`, "configurationProvision", `requires one provision linked by id ${id}`));
+        }
+    }
+    return issues;
+}
+function configurationPointerError(path) {
+    if (!path.startsWith("/") || new TextEncoder().encode(path).byteLength > 1024) {
+        return "must be a bounded RFC 6901 JSON pointer";
+    }
+    const encoded = path.slice(1).split("/");
+    if (encoded.length < 2 || encoded.length > 16) {
+        return "must address a value below an x-* extension namespace";
+    }
+    const segments = [];
+    for (const value of encoded) {
+        if (/~(?:[^01]|$)/u.test(value))
+            return "contains an invalid RFC 6901 escape";
+        const segment = value.replaceAll("~1", "/").replaceAll("~0", "~");
+        if (segment.length === 0
+            || segment === "-"
+            || /^\d+$/u.test(segment)
+            || [...segment].some((character) => /\p{Cc}/u.test(character)))
+            return "contains a disallowed object-key segment";
+        segments.push(segment);
+    }
+    return /^x-[a-z0-9][a-z0-9-]*$/u.test(segments[0])
+        ? undefined
+        : "must be inside a top-level x-* extension namespace";
+}
 function validateCapabilityRequirements(value) {
     const manifest = asObject(value);
     const requirements = asObject(manifest.requirements);
@@ -285,8 +383,23 @@ function validateCapabilityRequirements(value) {
     }
     if (Array.isArray(provisions.type_packs)
         && provisions.type_packs.length > 0
-        && !required.includes("definitions.type-pack.apply")) {
-        issues.push(issue("/requirements/capabilities/required", "typePackCapability", "must require definitions.type-pack.apply when bundled type packs are declared"));
+        && !required.includes("collection.setup.apply")) {
+        issues.push(issue("/requirements/capabilities/required", "collectionSetupCapability", "must require collection.setup.apply when bundled type packs are declared"));
+    }
+    const hasConfigurationProvisions = Array.isArray(provisions.configuration)
+        && provisions.configuration.length > 0;
+    const hasSetupProvisions = hasConfigurationProvisions
+        || (Array.isArray(provisions.type_packs) && provisions.type_packs.length > 0);
+    if (hasConfigurationProvisions && !required.includes("collection.setup.apply")) {
+        issues.push(issue("/requirements/capabilities/required", "collectionSetupCapability", "must require collection.setup.apply when configuration provisions are declared"));
+    }
+    if (declared.has("collection.setup.apply")) {
+        if (requirements.access !== "full_collection") {
+            issues.push(issue("/requirements/access", "collectionSetupAccess", "must be full_collection for collection.setup.apply"));
+        }
+        if (!hasSetupProvisions) {
+            issues.push(issue("/provisions", "collectionSetupProvision", "must declare a configuration provision or type pack for collection.setup.apply"));
+        }
     }
     if (declared.has("notifications.background-delivery")
         && !Array.isArray(asObject(manifest.notifications).criteria)) {

package/dist/operations.d.ts

@@ -1,10 +1,10 @@
 export declare const OPERATION_CATALOG_VERSION: 1;
-export declare const COLLECTION_OPERATIONS: readonly ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync"];
+export declare const COLLECTION_OPERATIONS: readonly ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "assess_collection_setup", "apply_collection_setup", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync"];
 export type CollectionOperation = typeof COLLECTION_OPERATIONS[number];
 export declare const FILE_CONTROL_MESSAGE_TYPES: readonly ["list_files", "open_file_upload", "open_file_download", "move_file", "delete_file", "get_file_transfer_status", "commit_file_upload", "abort_file_transfer"];
 export type FileControlMessageType = typeof FILE_CONTROL_MESSAGE_TYPES[number];
 export type EncryptedOperation = CollectionOperation | "file_control";
-export declare const MUTATING_OPERATION_IDENTIFIERS: readonly ["create_view_source", "update_view_source", "delete_view_source", "create", "update", "delete", "rename", "create_type", "update_type", "apply_type_pack", "put_timer", "cancel_timer", "reconcile_timers", "sync:mutate", "file_control:open_file_upload", "file_control:move_file", "file_control:delete_file", "file_control:commit_file_upload", "file_control:abort_file_transfer"];
+export declare const MUTATING_OPERATION_IDENTIFIERS: readonly ["create_view_source", "update_view_source", "delete_view_source", "create", "update", "delete", "rename", "create_type", "update_type", "apply_type_pack", "apply_collection_setup", "put_timer", "cancel_timer", "reconcile_timers", "sync:mutate", "file_control:open_file_upload", "file_control:move_file", "file_control:delete_file", "file_control:commit_file_upload", "file_control:abort_file_transfer"];
 export type MutationOperationIdentifier = typeof MUTATING_OPERATION_IDENTIFIERS[number];
 export declare function isCollectionOperation(value: string): value is CollectionOperation;
 export declare function areCollectionOperations(values: readonly string[]): values is readonly CollectionOperation[];

package/dist/operations.js

@@ -21,6 +21,8 @@ export const COLLECTION_OPERATIONS = [
     "update_type",
     "assess_type_pack",
     "apply_type_pack",
+    "assess_collection_setup",
+    "apply_collection_setup",
     "list_timers",
     "put_timer",
     "cancel_timer",
@@ -58,6 +60,8 @@ const COLLECTION_MUTATION_RULES = {
     "update_type": "always",
     "assess_type_pack": "never",
     "apply_type_pack": "always",
+    "assess_collection_setup": "never",
+    "apply_collection_setup": "always",
     "list_timers": "never",
     "put_timer": "always",
     "cancel_timer": "always",
@@ -85,6 +89,8 @@ const COLLECTION_INPUT_SCHEMA_VERSIONS = {
     "update_type": 1,
     "assess_type_pack": 1,
     "apply_type_pack": 1,
+    "assess_collection_setup": 1,
+    "apply_collection_setup": 1,
     "list_timers": 1,
     "put_timer": 1,
     "cancel_timer": 1,
@@ -119,6 +125,7 @@ export const MUTATING_OPERATION_IDENTIFIERS = [
     "create_type",
     "update_type",
     "apply_type_pack",
+    "apply_collection_setup",
     "put_timer",
     "cancel_timer",
     "reconcile_timers",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mdbase-dev/connect-protocol",
-  "version": "0.1.0-beta.32",
+  "version": "0.1.0-beta.34",
   "private": false,
   "type": "module",
   "license": "MIT",

package/schemas/catalog.json

@@ -7,6 +7,7 @@
     "connect_protocol": "./connect-protocol.v1.schema.json",
     "connect_problem": "./connect-problem.v1.schema.json",
     "connect_problem_catalog": "./connect-problems.v1.catalog.json",
+    "mdbase_query_v0_3": "./mdbase-query.v0.3.schema.json",
     "encrypted_relay": "./encrypted-relay.v2.schema.json",
     "files": "./files.v1.schema.json",
     "notification_webhook": "./notification-webhook.v1.schema.json",

package/schemas/connect-protocol.v1.schema.json

@@ -22,7 +22,7 @@
       "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
     },
     "operation": {
-      "enum": ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync"]
+      "enum": ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "assess_collection_setup", "apply_collection_setup", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync"]
     },
     "connectContractRequirements": {
       "type": "object",
@@ -289,11 +289,12 @@
     "applicationAuthorizationBinding": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["protocol_version", "authorization_id", "application_id", "application_manifest_digest", "application_installation_id", "installation_signing_public_key", "grant_agreement_public_key", "grant_signing_public_key", "flow", "authorization_nonce", "issued_at", "expires_at", "code_challenge", "contracts", "requested_operations"],
+      "required": ["protocol_version", "authorization_id", "application_id", "application_declaration_id", "application_manifest_digest", "application_installation_id", "installation_signing_public_key", "grant_agreement_public_key", "grant_signing_public_key", "flow", "authorization_nonce", "issued_at", "expires_at", "code_challenge", "contracts", "requested_operations"],
       "properties": {
-        "protocol_version": { "const": 3 },
+        "protocol_version": { "const": 4 },
         "authorization_id": { "$ref": "#/$defs/uuid" },
         "application_id": { "$ref": "#/$defs/uuid" },
+        "application_declaration_id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)+$" },
         "application_manifest_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
         "application_installation_id": { "$ref": "#/$defs/uuid" },
         "installation_signing_public_key": { "$ref": "#/$defs/p256PublicKey" },
@@ -352,6 +353,11 @@
           "maxItems": 20,
           "items": { "$ref": "#/$defs/contractRequirement" }
         },
+        "configuration": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/configurationRequirement" }
+        },
         "access": { "enum": ["contract", "full_collection"] },
         "collection_kind": { "const": "hosted" },
         "files": {
@@ -426,9 +432,46 @@
           "type": "array",
           "maxItems": 100,
           "items": { "$ref": "#/$defs/typePackProvision" }
+        },
+        "configuration": {
+          "type": "array",
+          "maxItems": 100,
+          "items": { "$ref": "#/$defs/configurationProvision" }
         }
       }
     },
+    "configurationRequirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "predicate", "value"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+        "path": { "type": "string", "pattern": "^/x-[^/]+(?:/.*)?$", "maxLength": 1024 },
+        "predicate": { "const": "contains" },
+        "value": { "oneOf": [
+          { "type": "string" },
+          { "type": "number" },
+          { "type": "boolean" },
+          { "type": "null" }
+        ] }
+      }
+    },
+    "configurationProvision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requirement", "operation", "path", "value"],
+      "properties": {
+        "requirement": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+        "operation": { "const": "set_add" },
+        "path": { "type": "string", "pattern": "^/x-[^/]+(?:/.*)?$", "maxLength": 1024 },
+        "value": { "oneOf": [
+          { "type": "string" },
+          { "type": "number" },
+          { "type": "boolean" },
+          { "type": "null" }
+        ] }
+      }
+    },
     "authorizationOfferRequest": {
       "type": "object",
       "additionalProperties": false,
@@ -461,12 +504,14 @@
     "authorizationActivationRequest": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["type", "protocol_version", "request_id", "authorization_id", "collection_id", "requirements", "provisions", "contract_setups", "grant"],
+      "required": ["type", "protocol_version", "request_id", "authorization_id", "application_declaration_id", "application_manifest_digest", "collection_id", "requirements", "provisions", "contract_setups", "grant"],
       "properties": {
         "type": { "const": "authorization_activation_request" },
         "protocol_version": { "const": 1 },
         "request_id": { "$ref": "#/$defs/uuid" },
         "authorization_id": { "$ref": "#/$defs/uuid" },
+        "application_declaration_id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)+$" },
+        "application_manifest_digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
         "collection_id": { "$ref": "#/$defs/uuid" },
         "requirements": { "$ref": "#/$defs/applicationRequirements" },
         "provisions": { "$ref": "#/$defs/applicationProvisions" },
@@ -497,6 +542,8 @@
           "maxItems": 20,
           "items": { "$ref": "#/$defs/contractSetupChoice" }
         },
+        "setup_assessment": true,
+        "provision_receipt": true,
         "error": {
           "type": "object",
           "additionalProperties": false,

package/schemas/encrypted-relay.v1.schema.json

@@ -14,7 +14,7 @@
       "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
     },
     "operation": {
-      "enum": ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "file_control"]
+      "enum": ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "assess_collection_setup", "apply_collection_setup", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "file_control"]
     },
     "envelope": {
       "type": "object",

package/schemas/encrypted-relay.v2.schema.json

@@ -14,7 +14,7 @@
       "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
     },
     "operation": {
-      "enum": ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync", "file_control"]
+      "enum": ["describe", "changes", "read", "query", "list_views", "execute_view", "read_view_source", "create_view_source", "update_view_source", "delete_view_source", "validate", "create", "update", "delete", "rename", "read_type", "create_type", "update_type", "assess_type_pack", "apply_type_pack", "assess_collection_setup", "apply_collection_setup", "list_timers", "put_timer", "cancel_timer", "reconcile_timers", "sync", "file_control"]
     },
     "envelope": {
       "type": "object",

package/schemas/files.v1.schema.json

@@ -323,7 +323,7 @@
     "transferStatus": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["protocol_version", "type", "transfer_id", "state", "received", "received_bytes"],
+      "required": ["protocol_version", "type", "transfer_id", "state", "received", "received_bytes", "uploaded_parts"],
       "properties": {
         "protocol_version": { "const": 1 },
         "type": { "const": "file_transfer_status" },
@@ -334,7 +334,12 @@
           "uniqueItems": true,
           "items": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
         },
-        "received_bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }
+        "received_bytes": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 },
+        "uploaded_parts": {
+          "type": "array",
+          "maxItems": 10000,
+          "items": { "$ref": "#/$defs/uploadedPart" }
+        }
       }
     },
     "prepareUploadPartRequest": {

package/schemas/mdbase-app.schema.json

@@ -39,6 +39,11 @@
       "additionalProperties": false,
       "required": ["type_packs"],
       "properties": {
+        "configuration": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/configurationProvision" }
+        },
         "type_packs": {
           "type": "array",
           "maxItems": 20,
@@ -118,6 +123,11 @@
           "description": "Require a durable provider-backed collection with direct sync support."
         },
         "files": { "$ref": "#/$defs/fileRequirement" },
+        "configuration": {
+          "type": "array",
+          "maxItems": 50,
+          "items": { "$ref": "#/$defs/configurationRequirement" }
+        },
         "contracts": {
           "type": "array",
           "maxItems": 20,
@@ -146,6 +156,46 @@
         }
       }
     },
+    "configurationValue": {
+      "anyOf": [
+        { "type": "string" },
+        { "type": "number" },
+        { "type": "boolean" },
+        { "type": "null" }
+      ]
+    },
+    "configurationRequirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "predicate", "value"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        },
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "predicate": { "const": "contains" },
+        "value": { "$ref": "#/$defs/configurationValue" }
+      }
+    },
+    "configurationProvision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requirement", "operation", "path", "value"],
+      "properties": {
+        "requirement": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        },
+        "operation": { "const": "set_add" },
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "value": { "$ref": "#/$defs/configurationValue" }
+      }
+    },
     "applicationCapability": {
       "enum": [
         "collection.inspect",
@@ -169,6 +219,7 @@
         "definitions.update",
         "definitions.type-pack.inspect",
         "definitions.type-pack.apply",
+        "collection.setup.apply",
         "timers.list",
         "timers.put",
         "timers.cancel",

package/schemas/mdbase-query.v0.3.schema.json

@@ -0,0 +1,171 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mdbase.dev/schemas/v0.3/query.schema.json",
+  "title": "mdbase v0.3 query object",
+  "type": "object",
+  "properties": {
+    "types": { "$ref": "#/$defs/typeList" },
+    "context": { "$ref": "#/$defs/queryContext" },
+    "projections": { "$ref": "#/$defs/projectionSet" },
+    "where": { "$ref": "#/$defs/expression" },
+    "select": { "$ref": "#/$defs/select" },
+    "order_by": { "$ref": "#/$defs/orderBy" },
+    "group_by": { "$ref": "#/$defs/groupBy" },
+    "summary_functions": { "$ref": "#/$defs/summaryFunctionSet" },
+    "summaries": { "$ref": "#/$defs/summaries" },
+    "limit": { "type": "integer", "minimum": 0 },
+    "offset": { "type": "integer", "minimum": 0 },
+    "include_body": { "type": "boolean", "default": false },
+    "frontmatter_mode": {
+      "enum": ["effective", "persisted", "both"],
+      "default": "effective"
+    }
+  },
+  "patternProperties": {
+    "^x-[A-Za-z][A-Za-z0-9._:-]{0,127}$": { "$ref": "#/$defs/extension" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "pattern": "^[A-Za-z][A-Za-z0-9._:-]*$"
+    },
+    "typeName": {
+      "type": "string",
+      "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,127}$"
+    },
+    "fieldName": {
+      "type": "string",
+      "pattern": "^[A-Za-z_][A-Za-z0-9_:-]*$"
+    },
+    "expression": {
+      "type": "string",
+      "minLength": 1
+    },
+    "extension": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "typeList": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/typeName" }
+    },
+    "queryContext": {
+      "type": "object",
+      "required": ["this"],
+      "properties": {
+        "this": {
+          "type": "object",
+          "required": ["path"],
+          "properties": {
+            "path": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "projectionSet": {
+      "type": "object",
+      "propertyNames": { "$ref": "#/$defs/fieldName" },
+      "additionalProperties": { "$ref": "#/$defs/projection" }
+    },
+    "projection": {
+      "type": "object",
+      "required": ["expr"],
+      "properties": {
+        "expr": { "$ref": "#/$defs/expression" },
+        "description": { "type": "string" }
+      },
+      "patternProperties": {
+        "^x-[A-Za-z][A-Za-z0-9._:-]{0,127}$": { "$ref": "#/$defs/extension" }
+      },
+      "additionalProperties": false
+    },
+    "select": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "oneOf": [
+          { "type": "string", "minLength": 1 },
+          { "$ref": "#/$defs/selectExpression" }
+        ]
+      }
+    },
+    "selectExpression": {
+      "type": "object",
+      "required": ["name", "expr"],
+      "properties": {
+        "name": { "$ref": "#/$defs/fieldName" },
+        "expr": { "$ref": "#/$defs/expression" },
+        "label": { "type": "string" },
+        "description": { "type": "string" }
+      },
+      "patternProperties": {
+        "^x-[A-Za-z][A-Za-z0-9._:-]{0,127}$": { "$ref": "#/$defs/extension" }
+      },
+      "additionalProperties": false
+    },
+    "orderBy": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["field"],
+        "properties": {
+          "field": { "type": "string", "minLength": 1 },
+          "direction": { "enum": ["asc", "desc"], "default": "asc" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "groupBy": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["field"],
+        "properties": {
+          "field": { "type": "string", "minLength": 1 },
+          "direction": { "enum": ["asc", "desc"], "default": "asc" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "summaryFunctionSet": {
+      "type": "object",
+      "propertyNames": { "$ref": "#/$defs/fieldName" },
+      "additionalProperties": { "$ref": "#/$defs/summaryFunction" }
+    },
+    "summaryFunction": {
+      "type": "object",
+      "required": ["expr"],
+      "properties": {
+        "expr": { "$ref": "#/$defs/expression" },
+        "description": { "type": "string" }
+      },
+      "patternProperties": {
+        "^x-[A-Za-z][A-Za-z0-9._:-]{0,127}$": { "$ref": "#/$defs/extension" }
+      },
+      "additionalProperties": false
+    },
+    "summaries": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/summary" }
+    },
+    "summary": {
+      "type": "object",
+      "required": ["field", "function"],
+      "properties": {
+        "field": { "type": "string", "minLength": 1 },
+        "function": { "$ref": "#/$defs/identifier" },
+        "name": { "$ref": "#/$defs/fieldName" },
+        "label": { "type": "string" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/operation-catalog.v1.json

@@ -21,6 +21,8 @@
     { "id": "update_type", "input_schema_version": 1, "mutation": "always" },
     { "id": "assess_type_pack", "input_schema_version": 1, "mutation": "never" },
     { "id": "apply_type_pack", "input_schema_version": 1, "mutation": "always" },
+    { "id": "assess_collection_setup", "input_schema_version": 1, "mutation": "never" },
+    { "id": "apply_collection_setup", "input_schema_version": 1, "mutation": "always" },
     { "id": "list_timers", "input_schema_version": 1, "mutation": "never" },
     { "id": "put_timer", "input_schema_version": 1, "mutation": "always" },
     { "id": "cancel_timer", "input_schema_version": 1, "mutation": "always" },