@mdbase-dev/connect 0.1.0-beta.123 → 0.1.0-beta.125

package/dist/browser/mdbase-connect.min.js.sha384

@@ -1 +1 @@
-sha384-oeF346B54GbocYns1w4tBu6zmyDtayo5iL/ujiP4qtf4pk1NsES2mMQj/0lIYmBb
+sha384-JJDoYra3MuCFJxyktOaw/6TQwPZCx8ZC2YcJhJxOZqXF8xU67X+tyXiEm5KKZwcf

package/dist/change-events.js

@@ -1,5 +1,5 @@
 import { CHANGE_EVENT_KINDS } from "@mdbase-dev/connect-protocol";
-import { clientFileDescriptor } from "./file-descriptor.js";
+import { clientFileDescriptor, validFileDescriptor } from "./file-descriptor.js";
 const RECORD_FIELDS = Object.entries({
     path: string, from: string, to: string, revision: string, previous_revision: string,
     types: strings, previous_types: strings, changed_fields: strings, body_changed: boolean,
@@ -43,7 +43,7 @@ export function normalizeCollectionChange(raw) {
         }
     }
     if (kind === "file.put") {
-        return clientFileDescriptorIsValid(p.file)
+        return validFileDescriptor(p.file)
             ? { ...base, kind, file: clientFileDescriptor(p.file) }
             : unknown("invalid_payload");
     }
@@ -93,10 +93,3 @@ function object(value) { return value !== null && typeof value === "object" && !
 function validFields(value, fields) {
     return fields.every(([key, valid]) => value[key] == null || valid(value[key]));
 }
-function clientFileDescriptorIsValid(value) {
-    return object(value) && string(value.file_id) && string(value.path) && string(value.revision)
-        && string(value.content_digest) && value.content_digest.startsWith("sha256:")
-        && typeof value.size === "number" && Number.isSafeInteger(value.size) && value.size >= 0
-        && ["image", "audio", "video", "pdf", "other"].includes(value.media_class)
-        && string(value.modified_at) && (value.media_type == null || string(value.media_type));
-}

package/dist/collection-client.d.ts

@@ -1,6 +1,6 @@
 import type { CollectionOperation, CollectionTypeDocument, JsonObject } from "@mdbase-dev/connect-protocol";
 import { type CollectionChangesProblemCode, type CollectionDescriptionProblemCode, type CollectionMutationProblemCode, type CollectionQueryProblemCode, type CollectionReadProblemCode, type CollectionTypeProblemCode, type ConnectOutcome } from "./outcomes.js";
-import type { ChangesInput, DescribeOptions, CollectionChange, CollectionChangesPage, CollectionDescription, CollectionSetupApplyResult, CollectionSetupAssessment, AssessCollectionSetupInput, AssessTypePackInput, ApplyCollectionSetupInput, ApplyTypePackInput, CreateInput, CreateTypeInput, CreateViewSourceInput, DeleteInput, DeletePreflightResult, DeleteResult, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, MdbaseCollectionTransport, MdbaseDesiredTimer, MdbaseTimer, MdbaseTimerList, MdbaseTimerReconciliation, ConnectRequestOptions, QueryAllOptions, QueryInput, QueryPage, QueryPagesOptions, QueryResult, ReadInput, ReadManyOptions, ReadManyResult, ReadTypeInput, ReadViewSourceInput, RenameInput, RenamePreflightResult, RenameResult, RecordDocument, SavedViewExecution, SavedViewPage, SavedViewPagesOptions, SavedViewList, SavedViewSourceDocument, TypePackApplyResult, TypePackAssessment, UpdateInput, UpdateTypeInput, UpdateViewSourceInput, WatchOptions } from "./operation-types.js";
+import type { ChangesInput, DescribeOptions, CollectionChange, CollectionChangesPage, CollectionDescription, CollectionSetupApplyResult, CollectionSetupAssessment, AssessCollectionSetupInput, AssessTypePackInput, ApplyCollectionSetupInput, ApplyTypePackInput, CreateInput, CreateTypeInput, CreateViewSourceInput, DeleteInput, DeletePreflightResult, DeleteResult, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, MdbaseCollectionTransport, MdbaseDesiredTimer, MdbaseTimer, MdbaseTimerList, MdbaseTimerReconciliation, ConnectRequestOptions, QueryAllOptions, QueryInput, QueryMetadataInput, QueryMetadataRecord, QueryMetadataResult, QueryMetadataPage, QueryPage, QueryPagesOptions, QueryResult, ReadInput, ReadManyOptions, ReadManyResult, ReadTypeInput, ReadViewSourceInput, RenameInput, RenamePreflightResult, RenameResult, RecordDocument, SavedViewExecution, SavedViewPage, SavedViewPagesOptions, SavedViewList, SavedViewSourceDocument, TypePackApplyResult, TypePackAssessment, UpdateInput, UpdateTypeInput, UpdateViewSourceInput, WatchOptions } from "./operation-types.js";
 /**
  * Typed collection operations independent of OAuth, HTTP, or storage.
  *
@@ -10,18 +10,23 @@ import type { ChangesInput, DescribeOptions, CollectionChange, CollectionChanges
 export declare class MdbaseCollectionClient<Frontmatter extends JsonObject = JsonObject> {
     private readonly transport;
     private readonly requestTimeoutMs;
+    private readonly supportsAuthorityFeature?;
     private readonly descriptions;
     private lastSchemaCursor;
     /** Local cache generation, not an authority revision or cross-connection identity. */
     get schemaGeneration(): number;
-    constructor(transport: MdbaseCollectionTransport, requestTimeoutMs?: number | null);
+    constructor(transport: MdbaseCollectionTransport, requestTimeoutMs?: number | null, supportsAuthorityFeature?: ((id: string, options?: ConnectRequestOptions) => Promise<ConnectOutcome<boolean>>) | undefined);
     operation<Result>(operation: CollectionOperation, input: unknown, options?: ConnectRequestOptions): Promise<ConnectOutcome<Result>>;
     describe(options?: DescribeOptions): Promise<ConnectOutcome<CollectionDescription, CollectionDescriptionProblemCode>>;
     changes(input?: ChangesInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<CollectionChangesPage, CollectionChangesProblemCode>>;
     read(input: ReadInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<RecordDocument<Frontmatter>, CollectionReadProblemCode>>;
     readMany(paths: readonly string[], options?: ReadManyOptions): Promise<ConnectOutcome<ReadManyResult<Frontmatter>, CollectionQueryProblemCode>>;
+    query(input: QueryMetadataInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<QueryMetadataResult, CollectionQueryProblemCode>>;
     query(input?: QueryInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<QueryResult<Frontmatter>, CollectionQueryProblemCode>>;
+    query(input: QueryInput | QueryMetadataInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<QueryResult<Frontmatter> | QueryMetadataResult, CollectionQueryProblemCode>>;
+    queryPages(input: QueryMetadataInput, options?: QueryPagesOptions<JsonObject, QueryMetadataRecord>): AsyncGenerator<ConnectOutcome<QueryMetadataPage, CollectionQueryProblemCode>>;
     queryPages(input?: QueryInput, options?: QueryPagesOptions<Frontmatter>): AsyncGenerator<ConnectOutcome<QueryPage<Frontmatter>, CollectionQueryProblemCode>>;
+    queryAll(input: QueryMetadataInput, options?: QueryAllOptions<JsonObject, QueryMetadataRecord>): Promise<ConnectOutcome<QueryMetadataResult, CollectionQueryProblemCode>>;
     queryAll(input?: QueryInput, options?: QueryAllOptions<Frontmatter>): Promise<ConnectOutcome<QueryResult<Frontmatter>, CollectionQueryProblemCode>>;
     listViews(options?: ConnectRequestOptions): Promise<ConnectOutcome<SavedViewList, CollectionReadProblemCode>>;
     executeView(input: ExecuteViewInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<SavedViewExecution<Frontmatter>, CollectionReadProblemCode>>;

package/dist/collection-client.js

@@ -2,11 +2,12 @@ import { abortableDelay } from "./async.js";
 import { invalidatesDescription, normalizeChangesPage } from "./change-events.js";
 import { CollectionDescriptionCache } from "./description-cache.js";
 import { coordinatedQueryPages } from "./query-pagination.js";
-import { queryReadMany } from "./read-many.js";
+import { readMany as readManyRecords } from "./read-many.js";
+import { wireDataContractIdentity, wireQueryInput, wireQueryRecord, wireQueryResult } from "./query-wire.js";
 import { coordinatedSavedViewPages } from "./saved-view-pagination.js";
 import { MdbaseConnectError, connectError, connectProblem, operationProblem } from "./errors.js";
 import { COLLECTION_CHANGES_PROBLEM_CODES, COLLECTION_MUTATION_PROBLEM_CODES, COLLECTION_QUERY_PROBLEM_CODES, COLLECTION_READ_PROBLEM_CODES, COLLECTION_TYPE_PROBLEM_CODES, ALL_CONNECT_PROBLEM_CODES, captureConnectOutcome, connectFailure, connectSuccess } from "./outcomes.js";
-import { createRequestBudget, DEFAULT_REQUEST_TIMEOUT_MS, requestAbortReason } from "./request-budget.js";
+import { createRequestBudget, DEFAULT_REQUEST_TIMEOUT_MS, requestAbortReason, requestOptionsWithinBudget, withRequestBudget } from "./request-budget.js";
 import { watchRetryPolicy } from "./watch-policy.js";
 /**
  * Typed collection operations independent of OAuth, HTTP, or storage.
@@ -17,13 +18,15 @@ import { watchRetryPolicy } from "./watch-policy.js";
 export class MdbaseCollectionClient {
     transport;
     requestTimeoutMs;
+    supportsAuthorityFeature;
     descriptions;
     lastSchemaCursor = -1;
     /** Local cache generation, not an authority revision or cross-connection identity. */
     get schemaGeneration() { return this.descriptions.schemaGeneration; }
-    constructor(transport, requestTimeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
+    constructor(transport, requestTimeoutMs = DEFAULT_REQUEST_TIMEOUT_MS, supportsAuthorityFeature) {
         this.transport = transport;
         this.requestTimeoutMs = requestTimeoutMs;
+        this.supportsAuthorityFeature = supportsAuthorityFeature;
         this.descriptions = new CollectionDescriptionCache(transport, requestTimeoutMs);
     }
     operation(operation, input, options) {
@@ -49,27 +52,35 @@ export class MdbaseCollectionClient {
         return mapOutcome(outcome, wireRecordDocument);
     }
     readMany(paths, options = {}) {
-        return queryReadMany((input, requestOptions) => this.queryAll(input, requestOptions), paths, options, this.requestTimeoutMs);
+        return readManyRecords((input, requestOptions) => this.queryAll(input, requestOptions), (selected, includeBody, requestOptions) => this.envelopeOperation("read", { paths: selected, include_body: includeBody, include_document: false }, COLLECTION_READ_PROBLEM_CODES, requestOptions), this.supportsAuthorityFeature, paths, options, this.requestTimeoutMs);
     }
     async query(input = {}, options) {
-        const outcome = await this.envelopeOperation("query", wireQueryInput(input), COLLECTION_QUERY_PROBLEM_CODES, options);
-        return mapOutcome(outcome, ({ results, meta }) => ({
-            results: results.map(wireQueryRecord),
-            ...(meta ? {
-                meta: {
-                    ...(typeof meta.total_count === "number" ? { totalCount: meta.total_count } : {}),
-                    ...(meta.total_count_outcome === undefined
-                        ? {}
-                        : { totalCountOutcome: meta.total_count_outcome }),
-                    hasMore: meta.has_more,
-                    ...(meta.cursor ? { cursor: meta.cursor } : {}),
-                    ...(meta.snapshot ? { snapshot: meta.snapshot } : {})
-                }
-            } : {})
-        }));
+        if (input.output !== undefined && input.output !== "metadata") {
+            return connectFailure(connectProblem("invalid_request", "Unknown query output mode."));
+        }
+        if (input.output !== "metadata") {
+            const outcome = await this.envelopeOperation("query", wireQueryInput(input), COLLECTION_QUERY_PROBLEM_CODES, options);
+            return mapOutcome(outcome, value => wireQueryResult(value, undefined));
+        }
+        const captured = await captureConnectOutcome(() => withRequestBudget(options, this.requestTimeoutMs, async (budget) => {
+            const requestOptions = requestOptionsWithinBudget({ ...options, timeoutMs: null }, budget);
+            if (input.includeBody)
+                throw connectError("invalid_request", "Metadata queries cannot include a body.");
+            const support = await this.supportsAuthorityFeature?.("query-metadata-v1", requestOptions);
+            if (support && !support.ok)
+                throw new MdbaseConnectError(support.problem);
+            if (!support?.value)
+                throw connectError("unsupported_operation", "This authority does not support metadata queries. Use an ordinary query on legacy authorities.");
+            const outcome = await this.envelopeOperation("query", wireQueryInput(input), COLLECTION_QUERY_PROBLEM_CODES, requestOptions);
+            return mapOutcome(outcome, value => wireQueryResult(value, input.output));
+        }), COLLECTION_QUERY_PROBLEM_CODES);
+        return captured.ok ? captured.value : captured;
     }
     async *queryPages(input = {}, options = {}) {
-        yield* coordinatedQueryPages((pageInput, pageOptions) => this.query(pageInput, pageOptions), (cursor) => this.releaseQueryCursor(cursor), input, options);
+        yield* coordinatedQueryPages((pageInput, pageOptions) => this.query(pageInput, pageOptions), (cursor) => this.releaseQueryCursor(cursor, input.output), input, 
+        // The overload ties callback row types to input.output; the wire parser
+        // rejects mode mismatch before pagination can deliver a page.
+        options);
     }
     async queryAll(input = {}, options = {}) {
         const budget = createRequestBudget(options, this.requestTimeoutMs);
@@ -77,15 +88,18 @@ export class MdbaseCollectionClient {
         let finalPage;
         const diagnostics = [];
         try {
-            for await (const outcome of this.queryPages(input, {
+            const pageOptions = {
                 firstPageSize: options.firstPageSize,
                 pageSize: options.pageSize,
                 maxResults: options.maxResults,
                 signal: budget.signal,
                 pageTimeoutMs: null,
-                coordination: options.coordination,
-                onProgress: options.onProgress
-            })) {
+                coordination: options.coordination
+            };
+            const pages = input.output === "metadata"
+                ? this.queryPages(input, { ...pageOptions, onProgress: options.onProgress })
+                : this.queryPages(input, { ...pageOptions, onProgress: options.onProgress });
+            for await (const outcome of pages) {
                 if (!outcome.ok)
                     return outcome;
                 const page = outcome.value;
@@ -95,17 +109,19 @@ export class MdbaseCollectionClient {
             }
             if (budget.signal.aborted)
                 throw requestAbortReason(budget.signal);
-            return connectSuccess({
-                results,
-                ...(finalPage ? { meta: {
-                        ...(finalPage.meta?.totalCount === undefined
-                            ? (!finalPage.meta?.hasMore ? { totalCount: results.length } : {})
-                            : { totalCount: finalPage.meta.totalCount }),
-                        ...(finalPage.meta?.hasMore && finalPage.meta.totalCountOutcome ? { totalCountOutcome: finalPage.meta.totalCountOutcome } : {}),
-                        hasMore: finalPage.meta?.hasMore ?? false,
-                        ...(finalPage.snapshot ? { snapshot: finalPage.snapshot } : {})
-                    } } : {})
-            }, diagnostics);
+            const meta = finalPage ? {
+                ...(finalPage.meta?.totalCount === undefined
+                    ? (!finalPage.meta?.hasMore ? { totalCount: results.length } : {})
+                    : { totalCount: finalPage.meta.totalCount }),
+                ...(finalPage.meta?.hasMore && finalPage.meta.totalCountOutcome ? { totalCountOutcome: finalPage.meta.totalCountOutcome } : {}),
+                hasMore: finalPage.meta?.hasMore ?? false,
+                ...(finalPage.snapshot ? { snapshot: finalPage.snapshot } : {})
+            } : undefined;
+            // Every page is parsed in the requested mode, never converted from full
+            // rows to revision-required metadata (or from partial rows to documents).
+            return input.output === "metadata"
+                ? connectSuccess({ output: "metadata", results: results, ...(meta ? { meta } : {}) }, diagnostics)
+                : connectSuccess({ results: results, ...(meta ? { meta } : {}) }, diagnostics);
         }
         catch (error) {
             if (error instanceof MdbaseConnectError) {
@@ -305,9 +321,19 @@ export class MdbaseCollectionClient {
     rawOperation(operation, input, allowedCodes, options) {
         return captureConnectOutcome(() => this.transport.operation(operation, input, options), allowedCodes);
     }
-    async releaseQueryCursor(cursor) {
+    async releaseQueryCursor(cursor, output) {
         try {
-            await this.envelopeOperation("query", { release_cursor: cursor }, COLLECTION_QUERY_PROBLEM_CODES, { timeoutMs: 2_000, coordination: { coalesce: false } });
+            await withRequestBudget({ timeoutMs: 2_000 }, null, async (budget) => {
+                const options = requestOptionsWithinBudget({ signal: budget.signal, timeoutMs: null, coordination: { coalesce: false } }, budget);
+                if (output) {
+                    // A supplied/stale cursor can reach cleanup even when the page was
+                    // rejected before dispatch. Never send metadata release to an old route.
+                    const support = await this.supportsAuthorityFeature?.("query-metadata-v1", options);
+                    if (!support?.ok || !support.value)
+                        return;
+                }
+                await this.envelopeOperation("query", { release_cursor: cursor, ...(output ? { output } : {}) }, COLLECTION_QUERY_PROBLEM_CODES, options);
+            });
         }
         catch {
             // Lease expiry is bounded by the authority; cleanup never masks query results.
@@ -328,7 +354,16 @@ export class MdbaseCollectionClient {
     }
 }
 function mapOutcome(outcome, map) {
-    return outcome.ok ? connectSuccess(map(outcome.value), outcome.diagnostics) : outcome;
+    if (!outcome.ok)
+        return outcome;
+    try {
+        return connectSuccess(map(outcome.value), outcome.diagnostics);
+    }
+    catch (error) {
+        if (error instanceof MdbaseConnectError)
+            return connectFailure(error.problem);
+        throw error;
+    }
 }
 function wireReadInput(input) {
     return {
@@ -337,47 +372,6 @@ function wireReadInput(input) {
         ...(input.includeDocument === undefined ? {} : { include_document: input.includeDocument })
     };
 }
-function wireQueryInput(input) {
-    return {
-        ...(input.types ? { types: input.types } : {}),
-        ...(input.timezone ? { timezone: input.timezone } : {}),
-        ...(input.context ? { context: input.context } : {}),
-        ...(input.projections ? {
-            projections: Object.fromEntries(Object.entries(input.projections).map(([name, projection]) => [
-                name,
-                { expr: projection.expression, ...(projection.description ? { description: projection.description } : {}) }
-            ]))
-        } : {}),
-        ...(input.where ? { where: input.where } : {}),
-        ...(input.select ? {
-            select: input.select.map((selection) => typeof selection === "string"
-                ? selection
-                : {
-                    name: selection.name,
-                    expr: selection.expression,
-                    ...(selection.label ? { label: selection.label } : {}),
-                    ...(selection.description ? { description: selection.description } : {})
-                })
-        } : {}),
-        ...(input.orderBy ? { order_by: input.orderBy } : {}),
-        ...(input.groupBy ? { group_by: input.groupBy } : {}),
-        ...(input.summaryFunctions ? {
-            summary_functions: Object.fromEntries(Object.entries(input.summaryFunctions).map(([name, projection]) => [
-                name,
-                { expr: projection.expression, ...(projection.description ? { description: projection.description } : {}) }
-            ]))
-        } : {}),
-        ...(input.summaries ? { summaries: input.summaries } : {}),
-        ...(input.limit === undefined ? {} : { limit: input.limit }),
-        ...(input.offset === undefined ? {} : { offset: input.offset }),
-        ...(input.pagination ? { pagination: input.pagination } : {}),
-        ...(input.cursor ? { cursor: input.cursor } : {}),
-        ...(input.snapshot ? { snapshot: input.snapshot } : {}),
-        ...(input.includeBody === undefined ? {} : { include_body: input.includeBody }),
-        ...(input.frontmatterMode ? { frontmatter_mode: input.frontmatterMode } : {}),
-        ...(input.contract ? { contract: input.contract } : {})
-    };
-}
 function wireCreateInput(input) {
     return {
         ...(input.path ? { path: input.path } : {}),
@@ -525,23 +519,6 @@ function wireContractSetupChoice(choice) {
             ...(choice.binding ? { binding: choice.binding } : {})
         };
 }
-function wireDataContractIdentity(value) {
-    return {
-        id: value.id,
-        version: value.version,
-        digest: value.digest,
-        type: value.type,
-        implementationDigest: value.implementation_digest
-    };
-}
-function wireQueryRecord(value) {
-    const { effective_frontmatter, contract, ...record } = value;
-    return {
-        ...record,
-        ...(effective_frontmatter === undefined ? {} : { effectiveFrontmatter: effective_frontmatter }),
-        ...(contract ? { contract: wireDataContractIdentity(contract) } : {})
-    };
-}
 function wireRecordDocument(value) {
     const { effective_frontmatter, contract, ...record } = value;
     return {
@@ -580,6 +557,7 @@ function wireTypePackResource(value) {
         ...(value.current_digest ? { currentDigest: value.current_digest } : {}),
         ...(value.installed_digest ? { installedDigest: value.installed_digest } : {}),
         ...(value.adopted_from_digest ? { adoptedFromDigest: value.adopted_from_digest } : {}),
+        ...(value.upgrade_baseline ? { upgradeBaseline: value.upgrade_baseline } : {}),
         ...(value.reason ? { reason: value.reason } : {})
     };
 }
@@ -595,7 +573,8 @@ function wireTypePackReceipt(value) {
             kind: resource.kind,
             mode: resource.mode,
             digest: resource.digest,
-            ...(resource.adopted_from_digest ? { adoptedFromDigest: resource.adopted_from_digest } : {})
+            ...(resource.adopted_from_digest ? { adoptedFromDigest: resource.adopted_from_digest } : {}),
+            ...(resource.origin_digest ? { originDigest: resource.origin_digest } : {})
         }))
     };
 }

package/dist/connection.d.ts

@@ -9,7 +9,7 @@ import { MdbaseFileClient } from "./files.js";
 import { MdbaseRecords } from "./records.js";
 import { type Application } from "./internal-types.js";
 import type { MdbaseNativeNotificationRegistration, MdbaseNativeNotificationRegistrationOptions, MdbaseNotificationRegistration, MdbaseNotificationRegistrationOptions } from "./notifications.js";
-import type { ChangesInput, CollectionChangesPage, DescribeOptions, CollectionDescription, CollectionSetupApplyResult, CollectionSetupAssessment, ApplyCollectionSetupInput, ApplyTypePackInput, AssessCollectionSetupInput, AssessTypePackInput, CreateInput, CreateTypeInput, CreateViewSourceInput, DeleteInput, DeletePreflightResult, DeleteProgressOptions, DeleteResult, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, MdbaseDesiredTimer, MdbaseTimer, MdbaseTimerList, MdbaseTimerReconciliation, ConnectRequestOptions, PendingMutation, QueryAllOptions, QueryInput, QueryPage, QueryPagesOptions, QueryResult, ReadInput, ReadTypeInput, ReadViewSourceInput, RenameInput, RenamePreflightResult, RenameProgressOptions, RenameResult, RecordDocument, SavedViewExecution, SavedViewPage, SavedViewPagesOptions, SavedViewList, SavedViewSourceDocument, TypePackApplyResult, TypePackAssessment, UpdateInput, UpdateTypeInput, UpdateViewSourceInput, MdbaseWatchSubscription, WatchInput } from "./operation-types.js";
+import type { ChangesInput, CollectionChangesPage, DescribeOptions, CollectionDescription, CollectionSetupApplyResult, CollectionSetupAssessment, ApplyCollectionSetupInput, ApplyTypePackInput, AssessCollectionSetupInput, AssessTypePackInput, CreateInput, CreateTypeInput, CreateViewSourceInput, DeleteInput, DeletePreflightResult, DeleteProgressOptions, DeleteResult, DeleteViewSourceInput, DeleteViewSourceResult, ExecuteViewInput, MdbaseDesiredTimer, MdbaseTimer, MdbaseTimerList, MdbaseTimerReconciliation, ConnectRequestOptions, PendingMutation, QueryAllOptions, QueryInput, QueryMetadataInput, QueryMetadataRecord, QueryMetadataResult, QueryMetadataPage, QueryPage, QueryPagesOptions, QueryResult, ReadInput, ReadTypeInput, ReadViewSourceInput, RenameInput, RenamePreflightResult, RenameProgressOptions, RenameResult, RecordDocument, SavedViewExecution, SavedViewPage, SavedViewPagesOptions, SavedViewList, SavedViewSourceDocument, TypePackApplyResult, TypePackAssessment, UpdateInput, UpdateTypeInput, UpdateViewSourceInput, MdbaseWatchSubscription, WatchInput } from "./operation-types.js";
 import { type AuthorizationProblemCode, type CollectionChangesProblemCode, type CollectionDescriptionProblemCode, type CollectionMutationProblemCode, type CollectionQueryProblemCode, type CollectionReadProblemCode, type CollectionTypeProblemCode, type ConnectOutcome, type DirectAccessProblemCode, type NotificationProblemCode, type RegistrationProblemCode } from "./outcomes.js";
 import type { MdbaseDeviceAuthorization } from "./connection-types.js";
 import { type ResolvedConnectTimeouts } from "./request-budget.js";
@@ -76,6 +76,7 @@ export declare class MdbaseConnection<Frontmatter extends JsonObject = JsonObjec
     private readonly collectionClient;
     private readonly notifications;
     private readonly transport;
+    private readonly authorityFeatures;
     readonly files: MdbaseFileClient;
     /** Editable record sessions shared by every view of this connection. */
     readonly records: MdbaseRecords<Frontmatter>;
@@ -89,6 +90,9 @@ export declare class MdbaseConnection<Frontmatter extends JsonObject = JsonObjec
     get fileCapability(): FileCapability | null;
     get directAccess(): DirectAccessStatus;
     get route(): MdbaseConnectionRoute;
+    /** Implementation support for this connection lifetime; not an authorization check. */
+    supportsAuthorityFeature(id: string, options?: ConnectRequestOptions): Promise<ConnectOutcome<boolean>>;
+    get authorityCapabilities(): readonly string[];
     register(options?: ConnectRequestOptions): Promise<ConnectOutcome<Application, RegistrationProblemCode>>;
     info(): MdbaseConnectionInfo | null;
     authorizationCapabilities(requiredOperations?: CollectionOperation[]): MdbaseAuthorizationCapabilities;
@@ -129,8 +133,11 @@ export declare class MdbaseConnection<Frontmatter extends JsonObject = JsonObjec
     describe(options?: DescribeOptions): Promise<ConnectOutcome<CollectionDescription, CollectionDescriptionProblemCode>>;
     changes(input?: ChangesInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<CollectionChangesPage, CollectionChangesProblemCode>>;
     read(input: ReadInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<RecordDocument<Frontmatter>, CollectionReadProblemCode>>;
+    query(input: QueryMetadataInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<QueryMetadataResult, CollectionQueryProblemCode>>;
     query(input?: QueryInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<QueryResult<Frontmatter>, CollectionQueryProblemCode>>;
+    queryPages(input: QueryMetadataInput, options?: QueryPagesOptions<JsonObject, QueryMetadataRecord>): AsyncGenerator<ConnectOutcome<QueryMetadataPage, CollectionQueryProblemCode>>;
     queryPages(input?: QueryInput, options?: QueryPagesOptions<Frontmatter>): AsyncGenerator<ConnectOutcome<QueryPage<Frontmatter>, CollectionQueryProblemCode>>;
+    queryAll(input: QueryMetadataInput, options?: QueryAllOptions<JsonObject, QueryMetadataRecord>): Promise<ConnectOutcome<QueryMetadataResult, CollectionQueryProblemCode>>;
     queryAll(input?: QueryInput, options?: QueryAllOptions<Frontmatter>): Promise<ConnectOutcome<QueryResult<Frontmatter>, CollectionQueryProblemCode>>;
     listViews(options?: ConnectRequestOptions): Promise<ConnectOutcome<SavedViewList, CollectionReadProblemCode>>;
     executeView(input: ExecuteViewInput, options?: ConnectRequestOptions): Promise<ConnectOutcome<SavedViewExecution<Frontmatter>, CollectionReadProblemCode>>;

package/dist/connection.js

@@ -2,9 +2,13 @@ import { MdbasePeopleClient, requestPeople } from "./people-client.js";
 import { capabilityOperationsForContractVersion } from "@mdbase-dev/connect-protocol";
 import { retainedCapabilities, semanticContractVersion, validateAuthorizationSelection } from "./application-contract.js";
 import { MdbaseCollectionClient } from "./collection-client.js";
+import { AuthorityFeatures, authorityCapabilities } from "./authority-features.js";
+import { filePage } from "./file-metadata.js";
+import { wireCollectionDescription } from "./query-wire.js";
+import { CollectionWatchSubscription } from "./watch-policy.js";
 import { ConnectionNotifications } from "./connection-notifications.js";
 import { ConnectionTransport } from "./connection-transport.js";
-import { MdbaseConnectError, connectProblem, operationProblem } from "./errors.js";
+import { MdbaseConnectError, connectError, connectProblem, operationProblem } from "./errors.js";
 import { MdbaseFileClient } from "./files.js";
 import { MdbaseRecords } from "./records.js";
 import { DEFAULT_OPERATIONS } from "./internal-types.js";
@@ -18,6 +22,7 @@ export class MdbaseConnection {
     collectionClient;
     notifications;
     transport;
+    authorityFeatures;
     files;
     /** Editable record sessions shared by every view of this connection. */
     records;
@@ -36,8 +41,34 @@ export class MdbaseConnection {
             collectionId,
             internals,
             timeouts: internals.timeouts,
-            onChange: () => this.emitConnection()
+            onChange: () => {
+                this.authorityFeatures.refreshLifetime();
+                this.emitConnection();
+            }
         });
+        this.authorityFeatures = new AuthorityFeatures({
+            lifetime: () => {
+                const token = this.transport.currentToken();
+                return JSON.stringify([token?.savedAt, token?.grantId, token?.keyHandle,
+                    token?.authority?.operationsUrl, token?.authority?.filesUrl, token?.authority?.replicaId,
+                    token?.authority?.proofPublicKey, token?.clientId, token?.applicationOrigin,
+                    token?.encryption, token?.scope, token?.operations, token?.fileCapability, this.transport.route]);
+            },
+            operations: () => this.operations,
+            fileCapability: () => this.fileCapability,
+            // Catalog TTL/in-flight loads are not evidence for a new authority route.
+            // B1 owns this authenticated baseline's sharing, deadline and lifetime.
+            describe: async (options) => {
+                const value = wireCollectionDescription(await this.transport.performOperation("describe", {}, options));
+                if (value.collectionId.toLowerCase() !== this.collectionId.toLowerCase())
+                    throw connectError("invalid_operation_response", "The authority described a different collection.");
+                return connectSuccess(value);
+            },
+            filesPage: async (folder, signal) => {
+                const page = await filePage((method, path, input, signal) => this.transport.files.control(method, path, input, signal), new URLSearchParams({ protocol_version: "1", limit: "1", ...(folder ? { folder } : {}) }), signal);
+                return authorityCapabilities(page.authority_capabilities);
+            }
+        }, internals.timeouts.requestMs);
         this.people = new MdbasePeopleClient({
             request: (resource, options) => requestPeople(resource, options ?? {}, {
                 serverUrl: internals.serverUrl, collectionId, requestMs: internals.timeouts.requestMs,
@@ -51,11 +82,11 @@ export class MdbaseConnection {
             downloadChunk: (session, chunkIndex, signal) => this.transport.files.downloadChunk(session, chunkIndex, signal)
         }, {
             downloadPart: (session, partIndex, expectedLength, signal) => this.transport.files.downloadHostedPart(session, partIndex, expectedLength, signal)
-        }, internals.timeouts);
+        }, internals.timeouts, (id, options) => this.supportsAuthorityFeature(id, options));
         this.records = new MdbaseRecords(this, (path) => this.transport.pendingUpdate(path));
         this.collectionClient = new MdbaseCollectionClient(new CollectionRequestCoordinator({
             operation: (operation, input, requestOptions) => this.transport.performOperation(operation, input, requestOptions)
-        }, internals.timeouts.requestMs), internals.timeouts.requestMs);
+        }, internals.timeouts.requestMs), internals.timeouts.requestMs, (id, options) => this.supportsAuthorityFeature(id, options));
         this.readMany = this.collectionClient.readMany.bind(this.collectionClient);
         this.notifications = new ConnectionNotifications({
             serverUrl: internals.serverUrl,
@@ -85,6 +116,11 @@ export class MdbaseConnection {
     get route() {
         return this.transport.route;
     }
+    /** Implementation support for this connection lifetime; not an authorization check. */
+    supportsAuthorityFeature(id, options) {
+        return this.authorityFeatures.supports(id, options);
+    }
+    get authorityCapabilities() { return this.authorityFeatures.capabilities; }
     register(options) {
         return captureConnectOutcome(() => this.internals.register(options), REGISTRATION_PROBLEM_CODES);
     }
@@ -168,6 +204,7 @@ export class MdbaseConnection {
         return () => this.connectionListeners.delete(listener);
     }
     notifyStorageChanged() {
+        this.authorityFeatures.invalidate();
         this.transport.notifyStorageChanged();
     }
     checkDirectAccess(options) {
@@ -257,7 +294,13 @@ export class MdbaseConnection {
         this.transport.notifyStorageChanged();
     }
     get schemaGeneration() { return this.collectionClient.schemaGeneration; }
-    describe(options) { return this.collectionClient.describe(options); }
+    async describe(options) {
+        const outcome = await this.collectionClient.describe(options);
+        if (outcome.ok && outcome.value.collectionId.toLowerCase() !== this.collectionId.toLowerCase()) {
+            return connectFailure(connectProblem("invalid_operation_response", "The authority described a different collection."));
+        }
+        return outcome;
+    }
     changes(input = {}, options) {
         return this.collectionClient.changes(input, options);
     }
@@ -268,10 +311,14 @@ export class MdbaseConnection {
         return this.collectionClient.query(input, options);
     }
     queryPages(input = {}, options = {}) {
-        return this.collectionClient.queryPages(input, options);
+        return input.output === "metadata"
+            ? this.collectionClient.queryPages(input, options)
+            : this.collectionClient.queryPages(input, options);
     }
     queryAll(input = {}, options = {}) {
-        return this.collectionClient.queryAll(input, options);
+        return input.output === "metadata"
+            ? this.collectionClient.queryAll(input, options)
+            : this.collectionClient.queryAll(input, options);
     }
     listViews(options) {
         return this.collectionClient.listViews(options);
@@ -493,7 +540,7 @@ export class MdbaseConnection {
             if (initial.value.reset) {
                 throw new MdbaseConnectError(connectProblem("change_cursor_reset", "The collection change cursor expired. Refresh collection state before subscribing again."));
             }
-            return new CollectionWatchSubscription(this.collectionClient, initial.value.cursor, input, input.cursor === undefined ? [] : initial.value.events, this.internals.timeouts.watchStartMs);
+            return new CollectionWatchSubscription(options => this.collectionClient.watch(options), initial.value.cursor, input, input.cursor === undefined ? [] : initial.value.events, this.internals.timeouts.watchStartMs);
         }), COLLECTION_CHANGES_PROBLEM_CODES);
     }
     emitConnection() {
@@ -502,114 +549,6 @@ export class MdbaseConnection {
             listener(connection);
     }
 }
-class CollectionWatchSubscription {
-    client;
-    input;
-    watchStartTimeoutMs;
-    changes = new Set();
-    statuses = new Set();
-    problems = new Set();
-    controller = new AbortController();
-    removeLifetimeAbort;
-    currentStatus;
-    currentProblem = null;
-    pendingChanges;
-    constructor(client, cursor, input, pendingChanges, watchStartTimeoutMs) {
-        this.client = client;
-        this.input = input;
-        this.watchStartTimeoutMs = watchStartTimeoutMs;
-        this.pendingChanges = [...pendingChanges];
-        this.currentStatus = { state: "connected", cursor, recovered: false };
-        const lifetimeSignal = input.lifetimeSignal;
-        if (lifetimeSignal?.aborted)
-            this.close();
-        else if (lifetimeSignal) {
-            const close = () => this.close();
-            lifetimeSignal.addEventListener("abort", close, { once: true });
-            this.removeLifetimeAbort = () => lifetimeSignal.removeEventListener("abort", close);
-        }
-        if (!this.controller.signal.aborted)
-            void this.run(cursor);
-    }
-    get status() {
-        return this.currentStatus;
-    }
-    get problem() {
-        return this.currentProblem;
-    }
-    subscribe(listener, onStatus, onProblem) {
-        this.changes.add(listener);
-        if (onStatus) {
-            this.statuses.add(onStatus);
-            onStatus(this.currentStatus);
-        }
-        if (onProblem) {
-            this.problems.add(onProblem);
-            if (this.currentProblem)
-                onProblem(this.currentProblem);
-        }
-        for (const change of this.pendingChanges)
-            listener(change);
-        this.pendingChanges = [];
-        return () => {
-            this.changes.delete(listener);
-            if (onStatus)
-                this.statuses.delete(onStatus);
-            if (onProblem)
-                this.problems.delete(onProblem);
-        };
-    }
-    close() {
-        if (this.controller.signal.aborted)
-            return;
-        this.controller.abort();
-        this.removeLifetimeAbort?.();
-        this.removeLifetimeAbort = undefined;
-        const cursor = "cursor" in this.currentStatus ? this.currentStatus.cursor : undefined;
-        this.publishStatus({ state: "closed", ...(cursor === undefined ? {} : { cursor }) });
-    }
-    async run(cursor) {
-        let firstStatus = true;
-        const iterator = this.client.watch({
-            cursor,
-            pollIntervalMs: this.input.pollIntervalMs,
-            retry: this.input.retry,
-            signal: this.controller.signal,
-            timeoutMs: this.watchStartTimeoutMs,
-            onStatus: (status) => {
-                if (firstStatus && status.state === "connecting") {
-                    firstStatus = false;
-                    return;
-                }
-                firstStatus = false;
-                this.publishStatus(status);
-            }
-        });
-        try {
-            for await (const outcome of iterator) {
-                if (this.controller.signal.aborted)
-                    return;
-                if (!outcome.ok) {
-                    this.currentProblem = outcome.problem;
-                    for (const listener of this.problems)
-                        listener(outcome.problem);
-                    return;
-                }
-                for (const listener of this.changes)
-                    listener(outcome.value);
-            }
-        }
-        finally {
-            if (!this.controller.signal.aborted)
-                this.close();
-        }
-    }
-    publishStatus(status) {
-        this.currentStatus = status;
-        for (const listener of this.statuses)
-            listener(status);
-    }
-}
 function syncRequestOptions(options, defaultTimeoutMs) {
     return {
         ...options,