@interop/was-conformance-suite 0.1.0

package/dist/helpers.js

@@ -0,0 +1,195 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+import { ZcapClient } from '@interop/ezcap';
+import { WasClient } from '@interop/was-client';
+import { decodeSecretKeySeed } from '@digitalcredentials/bnid';
+import { Ed25519Signature2020 } from '@interop/ed25519-signature';
+import { Ed25519VerificationKey } from '@interop/ed25519-verification-key';
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Deterministic test-identity seeds. Publishing them is a feature: a server
+ * operator can pre-authorize these identities if needed.
+ */
+const secretKeySeeds = {
+    alice: 'z1Air2KcEdUpJnJ9m61WFRUFgtC3LHrmGCpwFAkZ7rbbohX',
+    aliceDelegatedApp: 'z1AeeM8yN1D3cM56LsPmr3fFKuyv7MC4tdRkeiujMkyRy2u',
+    bob: 'z1AmpBeBetWxKMBpAcHsztGogaUki1LXWANSzTd5CiYoikA',
+    bobDelegatedApp: 'z1AfgF2HQvQaaAhod3KEYUHwY5epGtP5QmbEMKtMFf8XcYk'
+};
+export function zcapClient({ signer }) {
+    return new ZcapClient({
+        SuiteClass: Ed25519Signature2020,
+        invocationSigner: signer,
+        delegationSigner: signer
+    });
+}
+/**
+ * Builds a high-level WAS client wrapping a ZcapClient for the given signer.
+ * The `serverUrl` is the base for both URL building and zcap invocationTargets.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string}
+ * @param options.signer {ISigner}
+ * @returns {WasClient}
+ */
+export function wasClient({ serverUrl, signer }) {
+    return new WasClient({ serverUrl, zcapClient: zcapClient({ signer }) });
+}
+export async function buildZcapClients({ serverUrl }) {
+    const aliceKeyPair = await Ed25519VerificationKey.generate({
+        seed: decodeSecretKeySeed({ secretKeySeed: secretKeySeeds.alice })
+    });
+    const aliceRootDid = `did:key:${aliceKeyPair.fingerprint()}`;
+    aliceKeyPair.id = `${aliceRootDid}#${aliceKeyPair.fingerprint()}`;
+    const aliceSigner = aliceKeyPair.signer();
+    const aliceDelegatedAppKeyPair = await Ed25519VerificationKey.generate({
+        seed: decodeSecretKeySeed({
+            secretKeySeed: secretKeySeeds.aliceDelegatedApp
+        })
+    });
+    const aliceDelegatedAppDid = `did:key:${aliceDelegatedAppKeyPair.fingerprint()}`;
+    aliceDelegatedAppKeyPair.id = `${aliceDelegatedAppDid}#${aliceDelegatedAppKeyPair.fingerprint()}`;
+    const bobKeyPair = await Ed25519VerificationKey.generate({
+        seed: decodeSecretKeySeed({ secretKeySeed: secretKeySeeds.bob })
+    });
+    const bobRootDid = `did:key:${bobKeyPair.fingerprint()}`;
+    bobKeyPair.id = `${bobRootDid}#${bobKeyPair.fingerprint()}`;
+    const bobSigner = bobKeyPair.signer();
+    return {
+        alice: {
+            did: aliceRootDid,
+            // Low-level ZcapClient -- kept for raw request()/delegate() calls.
+            rootClient: zcapClient({ signer: aliceSigner }),
+            // High-level WAS client wrapping the same signer.
+            was: wasClient({ serverUrl, signer: aliceSigner })
+        },
+        aliceDelegatedApp: {
+            did: aliceDelegatedAppDid,
+            signer: aliceDelegatedAppKeyPair.signer()
+        },
+        bob: {
+            did: bobRootDid,
+            rootClient: zcapClient({ signer: bobSigner }),
+            was: wasClient({ serverUrl, signer: bobSigner })
+        }
+    };
+}
+/**
+ * Creates a space on the server using an onboarding token (if configured) or
+ * the WAS client. Returns a normalized response object for consistent
+ * assertion.
+ *
+ * The ZCap path goes through `WasClient.request()` -- the client's signed
+ * escape hatch -- so the conformance harness exercises the client while still
+ * surfacing the raw status/headers/data the create-space assertions rely on.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string}
+ * @param options.onboardingToken {string|null}
+ * @param options.spaceDescription {object}
+ * @param options.rootClient {ZcapClient} ZCap client -- used when no onboarding
+ *   token is set
+ * @returns {Promise<{status: number, headers: Headers, data: any}>}
+ */
+export async function createSpace({ serverUrl, onboardingToken, spaceDescription, rootClient }) {
+    if (onboardingToken) {
+        const response = await fetch(new URL('/spaces/', serverUrl), {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${onboardingToken}`
+            },
+            body: JSON.stringify(spaceDescription)
+        });
+        const data = await response.json();
+        return { status: response.status, headers: response.headers, data };
+    }
+    const was = new WasClient({ serverUrl, zcapClient: rootClient });
+    const response = await was.request({
+        path: '/spaces/',
+        method: 'POST',
+        json: spaceDescription
+    });
+    return {
+        status: response.status,
+        headers: response.headers,
+        data: response.data
+    };
+}
+/**
+ * Provisions a Space for the high-level `WasClient` suites: with an onboarding
+ * token configured, creates it via the token path (a plain fetch with
+ * `Authorization: Bearer`, the same wire form `createSpace` above uses) and
+ * returns the client's lazy handle to the new id; otherwise delegates to the
+ * client's own signed `createSpace`. This is what lets the client suites run
+ * against a server that gates provisioning behind an onboarding token.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string}
+ * @param options.onboardingToken {string|null}
+ * @param options.was {WasClient} the suite's high-level client
+ * @param [options.name] {string} optional Space name
+ * @returns {Promise<Space>}
+ */
+export async function provisionSpace({ serverUrl, onboardingToken, was, name }) {
+    if (!onboardingToken) {
+        return was.createSpace({ name });
+    }
+    const id = uuidv4();
+    const response = await fetch(new URL('/spaces/', serverUrl), {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${onboardingToken}`
+        },
+        body: JSON.stringify({ id, name, controller: was.controllerDid })
+    });
+    if (response.status !== 201) {
+        throw new Error(`Onboarding-token Create Space failed with status ${response.status}`);
+    }
+    return was.space(id);
+}
+/**
+ * Strips a `createdBy` property from a Space/Collection description, if
+ * present, before an exact-shape comparison. The spec makes `createdBy`
+ * OPTIONAL ("a client MUST treat an absent `createdBy` as not recorded"), so a
+ * conforming external server may legitimately omit it -- and one that records
+ * it may report a creator this suite cannot predict. Either way the conformance
+ * suite must not assert on it.
+ *
+ * @param value {unknown}
+ * @returns {unknown}
+ */
+export function withoutCreatedBy(value) {
+    if (value && typeof value === 'object' && 'createdBy' in value) {
+        const { createdBy: _createdBy, ...rest } = value;
+        return rest;
+    }
+    return value;
+}
+/**
+ * Builds the per-run conformance context: the deterministic test identities
+ * plus the provisioning/utility helpers bound to the target server.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string}
+ * @param [options.onboardingToken] {string|null}
+ * @returns {Promise<ConformanceContext>}
+ */
+export async function createContext({ serverUrl, onboardingToken = null }) {
+    const actors = await buildZcapClients({ serverUrl });
+    return {
+        serverUrl,
+        onboardingToken,
+        actors,
+        createSpace: ({ spaceDescription, rootClient }) => createSpace({ serverUrl, onboardingToken, spaceDescription, rootClient }),
+        provisionSpace: ({ was, name }) => provisionSpace({ serverUrl, onboardingToken, was, name }),
+        wasClient: ({ signer }) => wasClient({ serverUrl, signer }),
+        zcapClient,
+        generateId: uuidv4,
+        withoutCreatedBy
+    };
+}
+export { uuidv4 as generateId };
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import type { RunEvent, RunReport, Suite } from './harness/types.js';
+export * from './harness/types.js';
+export { runSuites, DEFAULT_TEST_TIMEOUT_MS } from './harness/runner.js';
+export { default as assert } from './harness/assert.js';
+export { buildZcapClients, createContext, createSpace, generateId, provisionSpace, wasClient, withoutCreatedBy, zcapClient } from './helpers.js';
+export * from './suites/index.js';
+/**
+ * Runs the conformance suite (or a subset) against a WAS server.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string} base URL of the server under test
+ * @param [options.onboardingToken] {string|null} provisioning token, if the
+ *   server gates space creation
+ * @param [options.suites] {Suite[]} subset to run (default: full registry)
+ * @param [options.onEvent] {Function} live progress-event callback
+ * @param [options.testTimeoutMs] {number} per-test timeout
+ * @param [options.failFast] {boolean} stop on first non-optional failure
+ * @returns {Promise<RunReport>}
+ */
+export declare function runConformance({ serverUrl, onboardingToken, suites: selectedSuites, onEvent, testTimeoutMs, failFast }: {
+    serverUrl: string;
+    onboardingToken?: string | null;
+    suites?: Array<Suite<any>>;
+    onEvent?: (event: RunEvent) => void;
+    testTimeoutMs?: number;
+    failFast?: boolean;
+}): Promise<RunReport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAEpE,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,UAAU,EACX,MAAM,cAAc,CAAA;AACrB,cAAc,mBAAmB,CAAA;AAEjC;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,EACnC,SAAS,EACT,eAAsB,EACtB,MAAM,EAAE,cAAuB,EAC/B,OAAO,EACP,aAAa,EACb,QAAQ,EACT,EAAE;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,MAAM,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,OAAO,CAAC,SAAS,CAAC,CASrB"}

package/dist/index.js

@@ -0,0 +1,35 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+import { runSuites } from './harness/runner.js';
+import { createContext } from './helpers.js';
+import { suites } from './suites/index.js';
+export * from './harness/types.js';
+export { runSuites, DEFAULT_TEST_TIMEOUT_MS } from './harness/runner.js';
+export { default as assert } from './harness/assert.js';
+export { buildZcapClients, createContext, createSpace, generateId, provisionSpace, wasClient, withoutCreatedBy, zcapClient } from './helpers.js';
+export * from './suites/index.js';
+/**
+ * Runs the conformance suite (or a subset) against a WAS server.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string} base URL of the server under test
+ * @param [options.onboardingToken] {string|null} provisioning token, if the
+ *   server gates space creation
+ * @param [options.suites] {Suite[]} subset to run (default: full registry)
+ * @param [options.onEvent] {Function} live progress-event callback
+ * @param [options.testTimeoutMs] {number} per-test timeout
+ * @param [options.failFast] {boolean} stop on first non-optional failure
+ * @returns {Promise<RunReport>}
+ */
+export async function runConformance({ serverUrl, onboardingToken = null, suites: selectedSuites = suites, onEvent, testTimeoutMs, failFast }) {
+    const ctx = await createContext({ serverUrl, onboardingToken });
+    return runSuites({
+        suites: selectedSuites,
+        ctx,
+        onEvent,
+        testTimeoutMs,
+        failFast
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAG1C,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,UAAU,EACX,MAAM,cAAc,CAAA;AACrB,cAAc,mBAAmB,CAAA;AAEjC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EACnC,SAAS,EACT,eAAe,GAAG,IAAI,EACtB,MAAM,EAAE,cAAc,GAAG,MAAM,EAC/B,OAAO,EACP,aAAa,EACb,QAAQ,EAQT;IACC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAA;IAC/D,OAAO,SAAS,CAAC;QACf,MAAM,EAAE,cAAc;QACtB,GAAG;QACH,OAAO;QACP,aAAa;QACb,QAAQ;KACT,CAAC,CAAA;AACJ,CAAC"}

package/dist/suites/changes-query-api.d.ts

@@ -0,0 +1,9 @@
+import type { Suite } from '../harness/types.js';
+interface State {
+    alice: any;
+    collectionId: string;
+    queryUrl: () => string;
+}
+export declare const changesQueryApi: Suite<State>;
+export {};
+//# sourceMappingURL=changes-query-api.d.ts.map

package/dist/suites/changes-query-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes-query-api.d.ts","sourceRoot":"","sources":["../../src/suites/changes-query-api.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD,UAAU,KAAK;IACb,KAAK,EAAE,GAAG,CAAA;IACV,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,KAAK,CA8HxC,CAAA"}

package/dist/suites/changes-query-api.js

@@ -0,0 +1,115 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * WAS conformance tests -- Collection `changes` query profile (the replication
+ * change feed served at `POST /space/:s/:c/query`; spec "Collection-level
+ * reserved endpoints").
+ */
+import assert from '../harness/assert.js';
+export const changesQueryApi = {
+    id: 'changes-query-api',
+    name: 'Collection changes query profile',
+    setup: async (ctx) => {
+        const alice = { ...ctx.actors.alice };
+        const collectionId = 'feed';
+        /** Absolute URL for this Space's `feed` collection query endpoint. */
+        function queryUrl() {
+            return new URL(`/space/${alice.space1.id}/${collectionId}/query`, ctx.serverUrl).toString();
+        }
+        alice.space1 = { id: ctx.generateId() };
+        await ctx.createSpace({
+            spaceDescription: {
+                id: alice.space1.id,
+                name: "Alice's Space #1",
+                controller: alice.did
+            },
+            rootClient: alice.rootClient
+        });
+        await alice.rootClient.request({
+            url: new URL(`/space/${alice.space1.id}/`, ctx.serverUrl).toString(),
+            method: 'POST',
+            action: 'POST',
+            json: { id: collectionId, name: 'Feed' }
+        });
+        // Three JSON documents by id; the middle one is then soft-deleted.
+        for (const id of ['r1', 'r2', 'r3']) {
+            await alice.rootClient.request({
+                url: new URL(`/space/${alice.space1.id}/${collectionId}/${id}`, ctx.serverUrl).toString(),
+                method: 'PUT',
+                action: 'PUT',
+                json: { id }
+            });
+        }
+        await alice.rootClient.request({
+            url: new URL(`/space/${alice.space1.id}/${collectionId}/r2`, ctx.serverUrl).toString(),
+            method: 'DELETE'
+        });
+        return { alice, collectionId, queryUrl };
+    },
+    teardown: async (ctx, state) => {
+        const { alice } = state;
+        try {
+            await alice.rootClient.request({
+                url: new URL(`/space/${alice.space1.id}`, ctx.serverUrl).toString(),
+                method: 'DELETE'
+            });
+        }
+        catch {
+            /* best-effort cleanup */
+        }
+    },
+    tests: [
+        {
+            id: 'changes.live-docs-tombstone-checkpoint',
+            name: '[root] returns live documents and a tombstone, with a checkpoint',
+            run: async (ctx, state) => {
+                const { alice, queryUrl } = state;
+                const response = await alice.rootClient.request({
+                    url: queryUrl(),
+                    method: 'POST',
+                    action: 'POST',
+                    json: { profile: 'changes', limit: 100 }
+                });
+                assert.equal(response.status, 200);
+                assert.match(response.headers.get('content-type'), /application\/json/);
+                const byId = new Map(response.data.documents.map((doc) => [doc.id, doc]));
+                assert.deepEqual([...byId.keys()].sort(), ['r1', 'r2', 'r3']);
+                // Live documents carry their body under `data` and `_deleted: false`.
+                assert.equal(byId.get('r1')._deleted, false);
+                assert.deepEqual(byId.get('r1').data, { id: 'r1' });
+                // The deleted document is a tombstone: `_deleted: true`, no `data`.
+                const tombstone = byId.get('r2');
+                assert.equal(tombstone._deleted, true);
+                assert.equal(tombstone.data, undefined);
+                // The checkpoint is the last returned document's keyset position.
+                assert.ok(response.data.checkpoint);
+                assert.equal(typeof response.data.checkpoint.id, 'string');
+                assert.equal(typeof response.data.checkpoint.updatedAt, 'string');
+            }
+        },
+        {
+            id: 'changes.unknown-profile-501',
+            name: '[root] rejects an unknown query profile with 501',
+            run: async (ctx, state) => {
+                const { alice, queryUrl } = state;
+                let thrown;
+                try {
+                    await alice.rootClient.request({
+                        url: queryUrl(),
+                        method: 'POST',
+                        action: 'POST',
+                        json: { profile: 'no-such-profile' }
+                    });
+                }
+                catch (err) {
+                    thrown = err;
+                }
+                assert.ok(thrown, 'expected an unknown profile to be rejected');
+                assert.equal(thrown.response.status, 501);
+                assert.match(thrown.response.headers.get('content-type'), /application\/problem\+json/);
+            }
+        }
+    ]
+};
+//# sourceMappingURL=changes-query-api.js.map

package/dist/suites/changes-query-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes-query-api.js","sourceRoot":"","sources":["../../src/suites/changes-query-api.ts"],"names":[],"mappings":"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"}

package/dist/suites/client-backends.d.ts

@@ -0,0 +1,11 @@
+import type { Suite } from '../harness/types.js';
+import type { Space, BackendRegistration } from '@interop/was-client';
+interface State {
+    alice: any;
+    createdSpaces: Space[];
+    newSpace: (name: string) => Promise<Space>;
+    gdriveRegistration: (id: string) => BackendRegistration;
+}
+export declare const clientBackends: Suite<State>;
+export {};
+//# sourceMappingURL=client-backends.d.ts.map

package/dist/suites/client-backends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-backends.d.ts","sourceRoot":"","sources":["../../src/suites/client-backends.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAGhD,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAErE,UAAU,KAAK;IACb,KAAK,EAAE,GAAG,CAAA;IACV,aAAa,EAAE,KAAK,EAAE,CAAA;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;IAC1C,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,mBAAmB,CAAA;CACxD;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,KAAK,CA+MvC,CAAA"}

package/dist/suites/client-backends.js

@@ -0,0 +1,198 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * WAS conformance tests -- high-level WasClient: BYOS backend registration.
+ *
+ * Drives the published `@interop/was-client` backend-registration control plane
+ * (`space.registerBackend` / `updateBackend` / `deregisterBackend`, and
+ * selecting a registered backend on a Collection) against a live server, the
+ * write side of the spec's "Backends" section. The reference server registers no
+ * provider adapters, so a registered `external` backend is selectable but its
+ * data plane is inert -- the suite asserts that "registered but not operable"
+ * contract too.
+ */
+import assert from '../harness/assert.js';
+import { ConflictError, ValidationError } from '@interop/was-client';
+export const clientBackends = {
+    id: 'client-backends',
+    name: 'WasClient — BYOS backend registration',
+    setup: async (ctx) => {
+        // Shallow-clone the shared actor so per-suite scratch fields do not leak
+        // into other suites.
+        const alice = { ...ctx.actors.alice };
+        const createdSpaces = [];
+        // Creates a space via the high-level client and registers it for teardown.
+        const newSpace = async (name) => {
+            const space = await ctx.provisionSpace({ was: alice.was, name });
+            createdSpaces.push(space);
+            return space;
+        };
+        // A representative registration body. `connection` is deliberately
+        // secret-bearing (an OAuth authorization code) so the suite can assert the
+        // server never echoes it back on the sanitized read.
+        const gdriveRegistration = (id) => {
+            return {
+                id,
+                name: 'My Google Drive',
+                provider: 'google-drive',
+                storageMode: ['document', 'blob'],
+                connection: {
+                    kind: 'oauth2-google',
+                    authorizationCode: 'secret-auth-code',
+                    scope: 'https://www.googleapis.com/auth/drive.file',
+                    rootFolderName: 'WAS'
+                }
+            };
+        };
+        return { alice, createdSpaces, newSpace, gdriveRegistration };
+    },
+    teardown: async (ctx, state) => {
+        for (const space of state.createdSpaces) {
+            try {
+                await space.delete();
+            }
+            catch {
+                /* best-effort cleanup */
+            }
+        }
+    },
+    tests: [
+        {
+            id: 'backend.register-sanitized',
+            name: 'registers a backend and returns a sanitized (secret-free) descriptor',
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('Register Backend');
+                const descriptor = await space.registerBackend(gdriveRegistration('gdrive-personal'));
+                assert.equal(descriptor.id, 'gdrive-personal');
+                assert.equal(descriptor.name, 'My Google Drive');
+                assert.equal(descriptor.managedBy, 'external');
+                assert.equal(descriptor.provider, 'google-drive');
+                assert.deepStrictEqual(descriptor.storageMode, ['document', 'blob']);
+                // The connection is sanitized: public fields surface (and `status` starts at
+                // `registered`, since no provider adapter has connected it yet).
+                const connection = descriptor.connection;
+                assert.ok(connection);
+                assert.equal(connection.kind, 'oauth2-google');
+                assert.equal(connection.status, 'registered');
+                assert.equal(connection.scope, 'https://www.googleapis.com/auth/drive.file');
+                assert.equal(connection.rootFolderName, 'WAS');
+                assert.match(connection.connectedAt ?? '', /^\d{4}-\d{2}-\d{2}T/);
+                // The secret-bearing authorization code must never be echoed back anywhere.
+                assert.ok(!JSON.stringify(descriptor).includes('secret-auth-code'), 'the sanitized descriptor must not leak the authorization code');
+            }
+        },
+        {
+            id: 'backend.list-with-default',
+            name: 'lists the registered backend alongside the server default',
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('List Backends');
+                await space.registerBackend(gdriveRegistration('gdrive-personal'));
+                const backends = await space.backends();
+                assert.ok(backends);
+                assert.equal(backends.length, 2);
+                assert.ok(backends.some(backend => backend.id === 'default'));
+                const gdrive = backends.find(backend => backend.id === 'gdrive-personal');
+                assert.ok(gdrive);
+                assert.equal(gdrive.provider, 'google-drive');
+                assert.equal(gdrive.connection?.status, 'registered');
+                // No secret leaks on the list path either.
+                assert.ok(!JSON.stringify(gdrive).includes('secret-auth-code'));
+            }
+        },
+        {
+            id: 'backend.duplicate-id-conflict',
+            name: 'rejects a duplicate backend id with ConflictError',
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('Duplicate Backend');
+                await space.registerBackend(gdriveRegistration('gdrive-personal'));
+                await assert.rejects(space.registerBackend(gdriveRegistration('gdrive-personal')), (err) => err instanceof ConflictError);
+            }
+        },
+        {
+            id: 'backend.reserved-default-id-validation',
+            name: 'rejects registering the reserved "default" id with ValidationError',
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('Reserved Backend Id');
+                await assert.rejects(space.registerBackend(gdriveRegistration('default')), (err) => err instanceof ValidationError);
+            }
+        },
+        {
+            id: 'backend.update-create-then-replace',
+            name: 'updateBackend creates a record (descriptor) then replaces it in place (null)',
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('Update Backend');
+                // PUT to a fresh id creates the record -> 201 + sanitized descriptor.
+                const created = await space.updateBackend(gdriveRegistration('gdrive-personal'));
+                assert.ok(created);
+                assert.equal(created.id, 'gdrive-personal');
+                assert.equal(created.connection?.status, 'registered');
+                // PUT to the same id replaces it in place -> 204, no body -> null.
+                const replaced = await space.updateBackend({
+                    id: 'gdrive-personal',
+                    provider: 'google-drive',
+                    connection: { kind: 'oauth2-google', authorizationCode: 'fresh-code' }
+                });
+                assert.equal(replaced, null);
+            }
+        },
+        {
+            id: 'backend.select-on-collection',
+            name: 'selects a registered backend on a Collection (control plane)',
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('Select Backend');
+                await space.registerBackend(gdriveRegistration('gdrive-personal'));
+                const collection = await space.createCollection({
+                    id: 'on-gdrive',
+                    backend: { id: 'gdrive-personal' }
+                });
+                const description = await collection.describe();
+                assert.deepStrictEqual(description?.backend, { id: 'gdrive-personal' });
+                // "Collection Backend Selected" resolves to the registered descriptor.
+                const backend = await collection.backend();
+                assert.equal(backend?.id, 'gdrive-personal');
+                assert.equal(backend?.provider, 'google-drive');
+            }
+        },
+        {
+            id: 'backend.inert-data-plane',
+            name: 'a registered backend with no provider adapter is inert (data plane fails closed)',
+            optional: true,
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('Inert Backend');
+                await space.registerBackend(gdriveRegistration('gdrive-personal'));
+                const collection = await space.createCollection({
+                    id: 'on-gdrive',
+                    backend: { id: 'gdrive-personal' }
+                });
+                // The reference server registers no provider adapters, so writing a resource
+                // to the selected backend fails closed with `unsupported-backend` (409).
+                await assert.rejects(collection.add({ hello: 'world' }), (err) => err instanceof ConflictError &&
+                    (err.type ?? '').includes('unsupported-backend'));
+            }
+        },
+        {
+            id: 'backend.deregister-idempotent',
+            name: 'deregisters a backend and is idempotent',
+            run: async (ctx, state) => {
+                const { newSpace, gdriveRegistration } = state;
+                const space = await newSpace('Deregister Backend');
+                await space.registerBackend(gdriveRegistration('gdrive-personal'));
+                await space.deregisterBackend('gdrive-personal');
+                const backends = await space.backends();
+                assert.ok(backends);
+                assert.ok(!backends.some(backend => backend.id === 'gdrive-personal'));
+                // Deregistering again must not throw (idempotent).
+                await space.deregisterBackend('gdrive-personal');
+            }
+        }
+    ]
+};
+//# sourceMappingURL=client-backends.js.map

package/dist/suites/client-backends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-backends.js","sourceRoot":"","sources":["../../src/suites/client-backends.ts"],"names":[],"mappings":"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"}