@mdbase-dev/connect 0.1.0-beta.95 → 0.1.0-beta.97

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

@@ -1 +1 @@
-sha384-pt5qe5l2IuGgDjsId1oPNVT/zCR+0TLeEJNt6xKdZQSxAACXxaCqoxbZd37EriJh
+sha384-qa5e6QDDjQFkjqKf4HstaDjyvJmQnvu4PkubKmMs2QIDou3qqMn+uYWQG2Z0ImA2

package/dist/connect-authorization-helpers.d.ts

@@ -1,3 +1,4 @@
 import { MdbaseConnectError } from "./errors.js";
+export declare function assertFreshV2AuthorizationSupport(serverUrl: string, signal?: AbortSignal): Promise<void>;
 export declare function declarationIdFromFamilyIdentity(familyIdentity: string): string;
 export declare function authorizationAbort(signal: AbortSignal, message: string, cause?: unknown): MdbaseConnectError;

package/dist/connect-authorization-helpers.js

@@ -1,4 +1,16 @@
+import { APPLICATION_AUTHORIZATION_V2_ISSUANCE_CAPABILITY } from "@mdbase-dev/connect-protocol";
 import { MdbaseConnectError, connectError } from "./errors.js";
+export async function assertFreshV2AuthorizationSupport(serverUrl, signal) {
+    const response = await fetch(`${serverUrl}/health`, { signal, cache: "no-store" });
+    const health = await response.json().catch(() => null);
+    if (!response.ok || !Array.isArray(health?.capabilities)
+        || !health.capabilities.every((value) => typeof value === "string")
+        || !health.capabilities.includes(APPLICATION_AUTHORIZATION_V2_ISSUANCE_CAPABILITY)) {
+        throw connectError("capability_contract_incompatible", "This server does not support new version-2 application authorizations.", {
+            details: { contract: "fresh_application_authorization", required: [2], supported: [], peer: "server" }
+        });
+    }
+}
 export function declarationIdFromFamilyIdentity(familyIdentity) {
     const prefix = "bundle:";
     if (!familyIdentity.startsWith(prefix) || familyIdentity.length === prefix.length) {

package/dist/connect.js

@@ -6,7 +6,7 @@ import { randomBase64Url } from "./base64.js";
 import { ApplicationIdentityStoreError, IndexedDbApplicationIdentityStore, MemoryApplicationIdentityStore, applicationIdentity, applicationInstallationId, signApplicationAuthorization } from "./application-identity.js";
 import { MdbaseConnection } from "./connection.js";
 import { addConnectionId, connectionIds, removeConnectionId } from "./connection-index.js";
-import { authorizationAbort, declarationIdFromFamilyIdentity } from "./connect-authorization-helpers.js";
+import { assertFreshV2AuthorizationSupport, authorizationAbort, declarationIdFromFamilyIdentity } from "./connect-authorization-helpers.js";
 import { IndexedDbGrantKeyStore, MemoryGrantKeyStore } from "./crypto.js";
 import { MdbaseConnectError, connectError, serverConnectError } from "./errors.js";
 import { prepareAuthorizationWindow, publishPopupAuthorizationCompletion, waitForPopupAuthorization } from "./popup-authorization.js";
@@ -162,6 +162,9 @@ export class MdbaseConnectInternals {
         });
         try {
             validateAuthorizationSelection(application.requirements, options);
+            if (application.requirements.capabilities?.contract_version === 2) {
+                await assertFreshV2AuthorizationSupport(this.serverUrl, options.signal);
+            }
         }
         catch (error) {
             popup?.close();

package/dist/operation-types.d.ts

@@ -187,7 +187,9 @@ export interface QueryResult<Record extends JsonObject = JsonObject> {
     };
 }
 export interface QueryPagesOptions<Record extends JsonObject = JsonObject> {
+    /** Initial page size. Cursor authorities pin this size for the query lifetime. */
     firstPageSize?: number;
+    /** Also sets the initial size unless firstPageSize is explicit; authorities may cap it. */
     pageSize?: number;
     signal?: AbortSignal;
     /** Independent budget for each page requested by this caller-driven iterator. */
@@ -196,7 +198,9 @@ export interface QueryPagesOptions<Record extends JsonObject = JsonObject> {
     onProgress?: (page: QueryPage<Record>) => void;
 }
 export interface QueryAllOptions<Record extends JsonObject = JsonObject> extends ConnectRequestOptions {
+    /** Initial page size. Cursor authorities pin this size for the query lifetime. */
     firstPageSize?: number;
+    /** Also sets the initial size unless firstPageSize is explicit; authorities may cap it. */
     pageSize?: number;
     onProgress?: (page: QueryPage<Record>) => void;
 }

package/dist/query-pagination.js

@@ -3,7 +3,7 @@ import { connectFailure, connectSuccess } from "./outcomes.js";
 export async function* coordinatedQueryPages(query, releaseQueryCursor, input = {}, options = {}) {
     const { offset: requestedOffset, limit: requestedLimit, cursor: requestedCursor, pagination: requestedPagination, snapshot: requestedSnapshot, ...criteria } = input;
     let offset = nonNegativeInteger(requestedOffset, 0);
-    const firstPageSize = positiveInteger(options.firstPageSize ?? requestedLimit, 200);
+    const firstPageSize = positiveInteger(options.firstPageSize ?? options.pageSize ?? requestedLimit, 200);
     const pageSize = positiveInteger(options.pageSize ?? requestedLimit, 1_000);
     let cursor = requestedCursor;
     let cursorMode = requestedCursor !== undefined;
@@ -25,7 +25,8 @@ export async function* coordinatedQueryPages(query, releaseQueryCursor, input =
                 && requestedSnapshot === undefined;
             let queried = await query({
                 ...criteria,
-                limit: pageNumber === 0 ? firstPageSize : pageSize,
+                // Continuations use the page size pinned when the cursor was opened.
+                ...(!cursorMode ? { limit: pageNumber === 0 ? firstPageSize : pageSize } : {}),
                 ...(cursorMode
                     ? (pageCursor ? { cursor: pageCursor } : { pagination: "cursor" })
                     : {
@@ -100,7 +101,9 @@ export async function* coordinatedQueryPages(query, releaseQueryCursor, input =
     }
     finally {
         if (cursorMode && cursorToRelease) {
-            await releaseQueryCursor(cursorToRelease);
+            // Cleanup has its own bounded request. It must not delay delivery of
+            // completed pages or consume the caller's data deadline.
+            void releaseQueryCursor(cursorToRelease).catch(() => undefined);
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mdbase-dev/connect",
-  "version": "0.1.0-beta.95",
+  "version": "0.1.0-beta.97",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@mdbase-dev/connect-protocol": "0.1.0-beta.95"
+    "@mdbase-dev/connect-protocol": "0.1.0-beta.97"
   },
   "devDependencies": {
     "esbuild": "^0.28.1",