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

package/dist/index.d.ts

@@ -1,17 +1,25 @@
-export * from "./authorization-types.js";
-export * from "./application-session.js";
-export * from "./connect-options.js";
-export * from "./mdbase-connect.js";
-export * from "./connection.js";
-export * from "./connection-types.js";
-export * from "./capabilities.js";
-export * from "./errors.js";
-export * from "./files.js";
-export * from "./notifications.js";
-export * from "./outcomes.js";
-export * from "./operation-types.js";
-export * from "./external-store.js";
-export { type RequestBudget } from "./request-budget.js";
-export * from "./selection.js";
+export type { MdbaseDeviceAuthorization } from "./authorization-types.js";
+export { MdbaseApplicationSession, MdbaseMemoryVerificationStore } from "./application-session.js";
+export type { MdbaseApplicationSessionOptions, MdbaseApplicationVerificationStore, MdbaseDefinitionUpdate, MdbaseCollectionSetupUpdate, MdbaseApplicationSessionSnapshot } from "./application-session.js";
+export type { MdbaseConnectOptions, MdbaseConnectTimeouts, MdbaseFrontmatter } from "./connect-options.js";
+export { MdbaseConnect } from "./mdbase-connect.js";
+export { MdbaseConnection } from "./connection.js";
+export type { MdbaseAuthorizationTarget, MdbaseAuthorizeOptions, MdbaseConnectionAuthorizeOptions, MdbaseConnectEnvironment, MdbaseAuthorizationResult, MdbaseAuthorizationOutcome } from "./connection.js";
+export type { MdbaseConnectionRoute, DirectAccessStatus, MdbaseConnectionInfo, MdbaseAuthorizationCapabilities, MdbaseSyncTransport, MdbaseSyncConnection } from "./connection-types.js";
+export { effectiveCapabilities } from "./capabilities.js";
+export type { MdbaseCapabilityState, MdbaseCapabilityEvidence, MdbaseEffectiveCapability, MdbaseEffectiveCapabilities } from "./capabilities.js";
+export { MdbaseConnectError, isRetryableConnectError } from "./errors.js";
+export type { ConnectErrorContext } from "./errors.js";
+export { MdbaseFileClient } from "./files.js";
+export type { MdbaseFileSource, CollectionFileDescriptor, MdbaseFileDeleteReceipt, MdbaseFileStreamSource, MdbaseFileProgress, MdbaseFileListOptions, MdbaseFileUploadOptions, MdbaseFileStreamUploadOptions, MdbaseFileDownloadOptions, MdbaseFileMoveOptions, MdbaseFileDeleteOptions } from "./files.js";
+export { parseMdbasePushPayload, parseMdbaseNativeNotificationData, showMdbasePushNotification } from "./notifications.js";
+export type { MdbaseNotificationRegistrationOptions, MdbaseNotificationRegistration, MdbaseNativeNotificationRegistrationOptions, MdbaseNativeNotificationRegistration, MdbaseNativeNotificationData, MdbasePushPayload } from "./notifications.js";
+export type { ConnectSuccess, ConnectFailure, ConnectOutcome, CommonOperationProblemCode, RegistrationProblemCode, AuthorizationProblemCode, NotificationProblemCode, DirectAccessProblemCode, SessionProblemCode, CollectionSetupProblemCode, CollectionDescriptionProblemCode, CollectionReadProblemCode, CollectionQueryProblemCode, CollectionMutationProblemCode, CollectionChangesProblemCode, CollectionTypeProblemCode } from "./outcomes.js";
+export type { MdbaseDesiredTimer, MdbaseTimer, MdbaseTimerList, MdbaseTimerReconciliation, ReadInput, DataContractSelector, CollectionFileMetadata, DataContractViewIdentity, QueryRecord, RecordDocument, QueryInput, QueryProjection, QuerySelectionExpression, QueryOrder, QuerySummary, QueryResult, QueryPagesOptions, QueryAllOptions, QueryPage, ConnectRequestOptions, MutationEstimate, MutationProgressState, MutationProgress, MutationProgressOptions, RenameProgressOptions, DeleteProgressOptions, PendingMutationSummary, PendingMutation, CreateInput, UpdateInput, DeleteInput, DeleteResult, DeletePreflightResult, RenameInput, RenameResult, RenamePreflightResult, ReadTypeInput, CreateTypeInput, UpdateTypeInput, ReadViewSourceInput, CreateViewSourceInput, UpdateViewSourceInput, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, SavedViewPresentation, SavedViewSource, SavedViewProperty, SavedNamedView, SavedViewDocument, SavedViewList, SavedViewSourceDocument, SavedViewExecution, ContractSetupChoice, TypePackResourceDiff, TypePackReceipt, TypePackAssessment, TypePackApplyResult, ConfigurationContributionValue, ConfigurationRequirement, ConfigurationProvision, ApplicationCollectionSetupRequirements, ApplicationCollectionSetupProvisions, ConfigurationSetupConflict, ConfigurationSetupAssessment, CollectionSetupAssessment, CollectionSetupReceipt, CollectionSetupApplyResult, AssessTypePackInput, ApplyTypePackInput, AssessCollectionSetupInput, ApplyCollectionSetupInput, ChangesInput, WatchOptions, WatchRetryOptions, WatchStatus, WatchInput, MdbaseWatchSubscription, CollectionChange, CollectionChangesPage, CollectionDescription, CollectionContractDescriptor, CollectionContractImplementationDescriptor, CollectionTypeDescriptor } from "./operation-types.js";
+export { externalStore } from "./external-store.js";
+export type { MdbaseExternalStore } from "./external-store.js";
+export { MdbaseBrowserSelection, MdbaseMemorySelection } from "./selection.js";
+export type { MdbaseSelectionHistory, MdbaseApplicationSelection, MdbaseBrowserSelectionOptions } from "./selection.js";
 export type { MdbaseUnavailableReason } from "./session.js";
-export type { ApplicationProvisions, ApplicationCapabilityId, ApplicationCapabilityRequirements, ApplicationRequirements, ApplicationNotifications, ApplicationAuthorizationBinding, ApplicationAuthorizationProof, CollectionChange, CollectionChangesPage, CollectionContractDescriptor, CollectionDescription, CollectionFileMetadata, FileAction, CollectionOperation as MdbaseOperation, CollectionTypeDescriptor, CollectionTypeDocument, ConnectOperationOutcome, ConnectProblem, ConnectProblemCategory, ConnectProblemCode, ConnectProblemDetailsByCode, ConnectRecoveryAction, ContractRequirement, DataContractViewIdentity, GrantScope, JsonObject, MdbaseAppManifest, NotificationCriterion, MdbaseDiagnostic, MdbaseOperationEnvelope, KnownConnectProblem, RecordDocument, QueryRecord, SavedNamedView, SavedViewDocument, SavedViewExecution, SavedViewList, SavedViewPresentation, SavedViewProperty, SavedViewSource, SavedViewSourceDocument, ReadViewSourceInput, CreateViewSourceInput, UpdateViewSourceInput, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, TypePackManifest, TypePackManifestResource, TypePackApplyResult, TypePackAssessment, TypePackReceipt, AssessTypePackInput, ApplyTypePackInput, TypePackProvision, TypePackResourceDiff, TypePackSourceResource, UnknownConnectProblem } from "@mdbase-dev/connect-protocol";
+export { MDBASE_RECORD_CREATED_CONTRACT, MDBASE_TIMER_FIRED_CONTRACT, operationsForApplicationCapabilities } from "@mdbase-dev/connect-protocol";
+export type { ApplicationProvisions, ApplicationCapabilityId, ApplicationCapabilityRequirements, ApplicationRequirements, ApplicationNotifications, ApplicationAuthorizationBinding, ApplicationAuthorizationProof, FileAction, FileCapability, CollectionOperation as MdbaseOperation, CollectionTypeDocument, ConnectOperationOutcome, ConnectProblem, ConnectProblemCategory, ConnectProblemCode, ConnectProblemDetailsByCode, ConnectRecoveryAction, ContractRequirement, GrantScope, JsonObject, MdbaseAppManifest, NotificationCriterion, MdbaseDiagnostic, MdbaseOperationEnvelope, KnownConnectProblem, TypePackManifest, TypePackManifestResource, TypePackProvision, TypePackSourceResource, UnknownConnectProblem } from "@mdbase-dev/connect-protocol";

package/dist/index.js

@@ -1,14 +1,10 @@
-export * from "./authorization-types.js";
-export * from "./application-session.js";
-export * from "./connect-options.js";
-export * from "./mdbase-connect.js";
-export * from "./connection.js";
-export * from "./connection-types.js";
-export * from "./capabilities.js";
-export * from "./errors.js";
-export * from "./files.js";
-export * from "./notifications.js";
-export * from "./outcomes.js";
-export * from "./operation-types.js";
-export * from "./external-store.js";
-export * from "./selection.js";
+export { MdbaseApplicationSession, MdbaseMemoryVerificationStore } from "./application-session.js";
+export { MdbaseConnect } from "./mdbase-connect.js";
+export { MdbaseConnection } from "./connection.js";
+export { effectiveCapabilities } from "./capabilities.js";
+export { MdbaseConnectError, isRetryableConnectError } from "./errors.js";
+export { MdbaseFileClient } from "./files.js";
+export { parseMdbasePushPayload, parseMdbaseNativeNotificationData, showMdbasePushNotification } from "./notifications.js";
+export { externalStore } from "./external-store.js";
+export { MdbaseBrowserSelection, MdbaseMemorySelection } from "./selection.js";
+export { MDBASE_RECORD_CREATED_CONTRACT, MDBASE_TIMER_FIRED_CONTRACT, operationsForApplicationCapabilities } from "@mdbase-dev/connect-protocol";

package/dist/internal-types.d.ts

@@ -2,6 +2,7 @@ import type { ApplicationNotifications, ApplicationRequirements, CollectionOpera
 import { encryptRelayRequest } from "./crypto.js";
 export interface Application {
     id: string;
+    family_identity: string;
     manifest_digest: string;
     name: string;
     distribution?: "web" | "portable";

package/dist/operation-helpers.js

@@ -66,21 +66,21 @@ export function isCancellation(error, signal) {
         || (error instanceof MdbaseConnectError && error.code === "operation_cancelled");
 }
 export function assertRenamePreview(input, preview) {
-    if (preview.dry_run !== true || preview.would_rename !== true
+    if (preview.dryRun !== true || preview.wouldRename !== true
         || preview.from !== input.from || preview.to !== input.to) {
         throw connectError("invalid_preflight", "The rename preview does not match this mutation. Run the preview again.");
     }
 }
 export function assertDeletePreview(input, preview) {
-    if (preview.dry_run !== true || preview.would_delete !== true || preview.path !== input.path) {
+    if (preview.dryRun !== true || preview.wouldDelete !== true || preview.path !== input.path) {
         throw connectError("invalid_preflight", "The delete preview does not match this mutation. Run the preview again.");
     }
 }
 export function renameEstimate(input, preview) {
-    if (input.update_refs === false) {
+    if (input.updateRefs === false) {
         return { affectedRecords: 0, totalUnits: 1, warnings: 0 };
     }
-    const references = preview.references_affected ?? [];
+    const references = preview.referencesAffected ?? [];
     return {
         affectedRecords: new Set(references.map((reference) => reference.path)).size,
         totalUnits: 1 + references.length,
@@ -89,7 +89,7 @@ export function renameEstimate(input, preview) {
 }
 export function deleteEstimate(preview) {
     return {
-        affectedRecords: new Set((preview.broken_links ?? []).map((reference) => reference.path)).size,
+        affectedRecords: new Set((preview.brokenLinks ?? []).map((reference) => reference.path)).size,
         totalUnits: 1,
         warnings: 0
     };

package/dist/operation-types.d.ts

@@ -1,33 +1,33 @@
-import type { CollectionChange, CollectionOperation, ConnectProblem, JsonObject, MutationOperationIdentifier, QueryRecord, RecordDocument } from "@mdbase-dev/connect-protocol";
+import type { CollectionOperation, ConnectProblem, ContractRequirement, JsonObject, MutationOperationIdentifier, TypePackProvision } from "@mdbase-dev/connect-protocol";
 export interface MdbaseDesiredTimer {
     /** Stable within the timer namespace. */
     id: string;
     /** RFC 3339 instant at which the authority should fire the timer. */
-    fire_at: string;
+    fireAt: string;
     /** Private application data retained by the collection authority. */
     data?: unknown;
 }
 export interface MdbaseTimer extends MdbaseDesiredTimer {
-    criterion_id: string;
+    criterionId: string;
     generation: number;
     status: "scheduled" | "firing" | "fired" | "cancelled";
-    created_at: string;
-    updated_at: string;
-    fired_at: string | null;
+    createdAt: string;
+    updatedAt: string;
+    firedAt: string | null;
 }
 export interface MdbaseTimerList {
     namespace: string;
     timers: MdbaseTimer[];
 }
 export interface MdbaseTimerReconciliation extends MdbaseTimerList {
-    cancelled_ids: string[];
+    cancelledIds: string[];
 }
 export interface ReadInput {
     path: string;
     /** Select an exact approved contract view when more than one is possible. */
     contract?: DataContractSelector;
     /** Include the exact UTF-8 Markdown source; requires full-collection access. */
-    include_document?: boolean;
+    includeDocument?: boolean;
 }
 export interface DataContractSelector {
     id: string;
@@ -35,39 +35,153 @@ export interface DataContractSelector {
     /** Required when several approved types implement the selected contract. */
     type?: string;
 }
+export interface CollectionFileMetadata extends JsonObject {
+    name: string;
+    folder: string;
+    size: number;
+    mtime: string;
+    tags?: string[];
+    links?: unknown[];
+    embeds?: unknown[];
+}
+export interface DataContractViewIdentity {
+    id: string;
+    version: string;
+    digest: string;
+    type: string;
+    implementationDigest: string;
+}
+export interface QueryRecord<Frontmatter extends JsonObject = JsonObject> {
+    path: string;
+    frontmatter?: Frontmatter;
+    effectiveFrontmatter?: Frontmatter;
+    body?: string;
+    types: string[];
+    file: Partial<CollectionFileMetadata> & {
+        path?: string;
+    };
+    contract?: DataContractViewIdentity;
+}
+export interface RecordDocument<Frontmatter extends JsonObject = JsonObject> {
+    path: string;
+    revision: string;
+    types: string[];
+    frontmatter: Frontmatter;
+    effectiveFrontmatter: Frontmatter;
+    body?: string;
+    document?: string;
+    file: Partial<CollectionFileMetadata> & {
+        path?: string;
+    };
+    contract?: DataContractViewIdentity;
+}
+export interface CollectionTypeDescriptor {
+    name: string;
+    version?: number;
+    description?: string;
+    revision?: string;
+    path?: string;
+    definition?: JsonObject;
+    schema: JsonObject;
+    collection?: JsonObject;
+    lifecycle?: JsonObject;
+    extensions: Record<string, unknown>;
+}
+export interface CollectionContractImplementationDescriptor {
+    typeName: string;
+    typeVersion: number;
+    typePath?: string;
+    digest: string;
+    fields: Record<string, string>;
+    binding?: JsonObject;
+}
+export interface CollectionContractDescriptor {
+    contractType: "record";
+    id: string;
+    version: string;
+    digest: string;
+    schema: JsonObject;
+    bindingSchema?: JsonObject;
+    implementations: CollectionContractImplementationDescriptor[];
+}
+export interface CollectionDescription {
+    protocolVersion: 1;
+    collectionId: string;
+    displayName: string;
+    specVersion: string;
+    operations: CollectionOperation[];
+    changeCursor: number;
+    types: CollectionTypeDescriptor[];
+    contracts: CollectionContractDescriptor[];
+    configuration?: JsonObject;
+}
+export interface QueryProjection {
+    expression: string;
+    description?: string;
+}
+export interface QuerySelectionExpression {
+    name: string;
+    expression: string;
+    label?: string;
+    description?: string;
+}
+export interface QueryOrder {
+    field: string;
+    direction?: "asc" | "desc";
+}
+export interface QuerySummary {
+    field: string;
+    function: string;
+    name?: string;
+    label?: string;
+}
+/** Application-facing form of the canonical mdbase v0.3 query schema. */
 export interface QueryInput {
     /**
      * Contract-scoped queries accept only `types`, pagination,
-     * `frontmatter_mode`, and `contract`; filter normalized fields in the app.
+     * `frontmatterMode`, and `contract`; filter normalized fields in the app.
      */
     types?: string[];
-    where?: unknown;
-    order_by?: unknown;
+    context?: {
+        this: {
+            path: string;
+        };
+    };
+    projections?: Record<string, QueryProjection>;
+    where?: string;
+    select?: Array<string | QuerySelectionExpression>;
+    orderBy?: QueryOrder[];
+    groupBy?: QueryOrder[];
+    summaryFunctions?: Record<string, QueryProjection>;
+    summaries?: QuerySummary[];
     limit?: number;
     offset?: number;
     /** Opaque token returned by the first metadata page for consistent, fast pagination. */
     snapshot?: string;
-    include_body?: boolean;
-    frontmatter_mode?: "effective" | "persisted" | "both";
+    includeBody?: boolean;
+    frontmatterMode?: "effective" | "persisted" | "both";
     /** Narrow a contract-scoped query to one exact contract/provider view. */
     contract?: DataContractSelector;
-    [key: string]: unknown;
 }
 export interface QueryResult<Record extends JsonObject = JsonObject> {
-    results: Array<QueryRecord<Record> & JsonObject>;
+    results: Array<QueryRecord<Record>>;
     meta?: {
-        total_count: number;
-        has_more: boolean;
+        totalCount: number;
+        hasMore: boolean;
         snapshot?: string;
-        [key: string]: unknown;
     };
-    [key: string]: unknown;
 }
 export interface QueryPagesOptions<Record extends JsonObject = JsonObject> {
     firstPageSize?: number;
     pageSize?: number;
     signal?: AbortSignal;
-    timeoutMs?: number | null;
+    /** Independent budget for each page requested by this caller-driven iterator. */
+    pageTimeoutMs?: number | null;
+    onProgress?: (page: QueryPage<Record>) => void;
+}
+export interface QueryAllOptions<Record extends JsonObject = JsonObject> extends ConnectRequestOptions {
+    firstPageSize?: number;
+    pageSize?: number;
     onProgress?: (page: QueryPage<Record>) => void;
 }
 export interface QueryPage<Record extends JsonObject = JsonObject> {
@@ -129,16 +243,16 @@ export interface CreateInput<Frontmatter extends JsonObject = JsonObject> {
     frontmatter?: Partial<Frontmatter> & JsonObject;
     /** Requires full-collection access; contract creates are frontmatter-only. */
     body?: string;
-    if_revision?: string;
+    ifRevision?: string;
     /** Include the resulting exact Markdown source in `result.document`. */
-    include_document?: boolean;
+    includeDocument?: boolean;
 }
 interface UpdateInputBase {
     path: string;
     contract?: DataContractSelector;
-    if_revision?: string;
+    ifRevision?: string;
     /** Include the resulting exact Markdown source; requires full-collection access. */
-    include_document?: boolean;
+    includeDocument?: boolean;
 }
 export type UpdateInput<Frontmatter extends JsonObject = JsonObject> = UpdateInputBase & ({
     patch: Partial<Frontmatter> & JsonObject;
@@ -147,7 +261,7 @@ export type UpdateInput<Frontmatter extends JsonObject = JsonObject> = UpdateInp
 } | {
     /**
      * Replace the complete Markdown source. This is mutually exclusive with
-     * `patch` and `body`, and implies `include_document`.
+     * `patch` and `body`, and implies `includeDocument`.
      */
     document: string;
     patch?: never;
@@ -156,22 +270,22 @@ export type UpdateInput<Frontmatter extends JsonObject = JsonObject> = UpdateInp
 export interface DeleteInput {
     path: string;
     contract?: DataContractSelector;
-    check_backlinks?: boolean;
-    if_revision?: string;
+    checkBacklinks?: boolean;
+    ifRevision?: string;
 }
 export interface DeleteResult {
     path: string;
     deleted: boolean;
-    broken_links?: Array<{
+    brokenLinks?: Array<{
         path: string;
     }>;
 }
 export interface DeletePreflightResult {
     path: string;
     deleted: false;
-    dry_run: true;
-    would_delete: true;
-    broken_links?: Array<{
+    dryRun: true;
+    wouldDelete: true;
+    brokenLinks?: Array<{
         path: string;
     }>;
 }
@@ -179,22 +293,22 @@ export interface RenameInput {
     from: string;
     to: string;
     contract?: DataContractSelector;
-    update_refs?: boolean;
-    if_revision?: string;
+    updateRefs?: boolean;
+    ifRevision?: string;
     /** Include the resulting exact Markdown source in `result.document`. */
-    include_document?: boolean;
+    includeDocument?: boolean;
 }
 export interface RenameResult extends RecordDocument {
     from: string;
     to: string;
-    references_updated?: JsonObject[];
+    referencesUpdated?: JsonObject[];
 }
 export interface RenamePreflightResult {
     from: string;
     to: string;
-    dry_run: true;
-    would_rename: true;
-    references_affected?: Array<{
+    dryRun: true;
+    wouldRename: true;
+    referencesAffected?: Array<{
         path: string;
         field?: string;
         location?: string;
@@ -214,7 +328,246 @@ export interface CreateTypeInput {
 }
 export interface UpdateTypeInput extends ReadTypeInput {
     document: string;
-    if_revision: string;
+    ifRevision: string;
+}
+export interface ReadViewSourceInput {
+    path: string;
+}
+export interface CreateViewSourceInput {
+    document: string;
+    path?: string;
+    format?: string;
+    name?: string;
+}
+export interface UpdateViewSourceInput {
+    path: string;
+    document: string;
+    ifRevision?: string;
+}
+export interface DeleteViewSourceInput {
+    path: string;
+    ifRevision?: string;
+}
+export interface DeleteViewSourceResult {
+    path: string;
+    deleted: boolean;
+}
+export interface ExecuteViewInput {
+    path: string;
+    view: string;
+    context?: {
+        path: string;
+    } | null;
+    limit?: number;
+    offset?: number;
+    render?: boolean;
+}
+export interface SavedViewPresentation extends JsonObject {
+    type: string;
+    fallback?: string;
+    mappings?: Record<string, string>;
+    options?: JsonObject;
+}
+export interface SavedViewSource {
+    path: string;
+    format: string;
+    revision: string;
+    writable: boolean;
+}
+export interface SavedViewProperty {
+    key: string;
+    label?: string;
+    description?: string;
+    format?: string;
+    hidden?: boolean;
+}
+export interface SavedNamedView {
+    id: string;
+    name: string;
+    properties: SavedViewProperty[];
+    presentation?: SavedViewPresentation;
+}
+export interface SavedViewDocument {
+    id: string;
+    name: string;
+    source: SavedViewSource;
+    views: SavedNamedView[];
+}
+export interface SavedViewList {
+    views: SavedViewDocument[];
+    meta: {
+        totalCount: number;
+    };
+}
+export interface SavedViewSourceDocument {
+    path: string;
+    format: string;
+    revision: string;
+    document: string;
+}
+export interface SavedViewRecord<Frontmatter extends JsonObject = JsonObject> extends Omit<QueryRecord<Frontmatter>, "effectiveFrontmatter"> {
+    effectiveFrontmatter: Frontmatter;
+    values?: JsonObject;
+}
+export interface SavedViewExecution<Frontmatter extends JsonObject = JsonObject> {
+    results: Array<SavedViewRecord<Frontmatter>>;
+    meta: {
+        totalCount: number;
+        hasMore: boolean;
+        view: {
+            path: string;
+            id: string;
+        };
+        context?: {
+            path: string;
+        };
+        groups?: Array<{
+            values: JsonObject;
+            count: number;
+            summaries: JsonObject;
+        }>;
+    };
+}
+export type ContractSetupChoice = {
+    contract: ContractRequirement;
+    mode: "starter";
+} | {
+    contract: ContractRequirement;
+    mode: "existing";
+    typeName: string;
+    typeRevision: string;
+    fields: Record<string, string>;
+    binding?: Record<string, unknown>;
+};
+export interface TypePackResourceDiff {
+    source: string;
+    target: string;
+    kind: "contract" | "type" | "schema";
+    mode: "managed" | "seed";
+    action: "create" | "update" | "delete" | "adopt" | "unchanged" | "preserve" | "conflict";
+    digest: string;
+    currentDigest?: string;
+    installedDigest?: string;
+    adoptedFromDigest?: string;
+    reason?: string;
+}
+export interface TypePackReceipt {
+    id: string;
+    version: string;
+    digest: string;
+    installedBy: string;
+    resources: Array<Omit<TypePackResourceDiff, "action" | "currentDigest" | "installedDigest" | "reason">>;
+}
+export interface TypePackAssessment {
+    status: "current" | "install" | "upgrade" | "downgrade" | "reconfigure" | "conflict";
+    applicable: boolean;
+    assessmentDigest: string;
+    current?: TypePackReceipt;
+    desired: TypePackReceipt;
+    resources: TypePackResourceDiff[];
+    lock: {
+        target: "mdbase.lock.yaml";
+        action: "create" | "update" | "unchanged";
+        digest: string;
+    };
+    contractSetups: {
+        choices: ContractSetupChoice[];
+        resources: TypePackResourceDiff[];
+    };
+}
+export interface TypePackApplyResult extends TypePackAssessment {
+    receipt: TypePackReceipt;
+    cleanupDeferred: boolean;
+}
+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[];
+    typePacks: TypePackProvision[];
+}
+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;
+    applicationId: string;
+    declarationDigest: string;
+    provisionDigest: string;
+    collectionRevision: string;
+    finalCollectionRevision: string;
+    configuration: ConfigurationSetupAssessment[];
+    typePacks: TypePackAssessment[];
+    finalResourceRevisions: Record<string, string>;
+    assessmentDigest: string;
+}
+export interface CollectionSetupReceipt {
+    applicationId: string;
+    declarationDigest: string;
+    provisionDigest: string;
+    assessmentDigest: string;
+    collectionRevision: string;
+    configuration: Array<{
+        requirement: string;
+        path: string;
+        value: ConfigurationContributionValue;
+    }>;
+    typePacks: TypePackReceipt[];
+    cleanupDeferred: boolean;
+}
+export interface CollectionSetupApplyResult {
+    assessment: CollectionSetupAssessment;
+    receipt: CollectionSetupReceipt;
+}
+export interface AssessTypePackInput {
+    provision: TypePackProvision;
+    installedBy: string;
+    adoptResources?: Record<string, string>;
+    preserveSeedTargets?: string[];
+    targetOverrides?: Record<string, string>;
+    contractSetups?: ContractSetupChoice[];
+}
+export interface ApplyTypePackInput extends AssessTypePackInput {
+    expectedAssessmentDigest: string;
+    allowDowngrade?: boolean;
+}
+export interface AssessCollectionSetupInput {
+    applicationId: string;
+    declarationDigest: string;
+    requirements: ApplicationCollectionSetupRequirements;
+    provisions: ApplicationCollectionSetupProvisions;
+    contractSetups?: ContractSetupChoice[];
+}
+export interface ApplyCollectionSetupInput extends AssessCollectionSetupInput {
+    expectedAssessmentDigest: string;
+    expectedCollectionRevision: string;
+    expectedProvisionDigest: string;
+    allowTypePackDowngrades?: string[];
 }
 export interface ChangesInput {
     after?: number;
@@ -271,6 +624,18 @@ export interface MdbaseWatchSubscription {
     subscribe(listener: (change: CollectionChange) => void, onStatus?: (status: WatchStatus) => void, onProblem?: (problem: ConnectProblem) => void): () => void;
     close(): void;
 }
+export interface CollectionChange {
+    cursor: number;
+    type: string;
+    occurredAt: string;
+    payload: JsonObject;
+}
+export interface CollectionChangesPage {
+    events: CollectionChange[];
+    cursor: number;
+    hasMore: boolean;
+    reset: boolean;
+}
 /** Provider-neutral operation transport used by the typed collection client. */
 export interface MdbaseCollectionTransport {
     operation<Result>(operation: CollectionOperation, input: unknown, options?: ConnectRequestOptions): Promise<Result>;