@hypequery/protocol-conformance 0.15.1 → 0.16.0

package/README.md

@@ -85,3 +85,11 @@ fixture family or adding an implementation.
 ## License
 
 Apache-2.0.
+
+## Client contract v1
+
+Both protocol adapters announce `client-contract-v1`. The runner resolves the
+family's compact success references and negative JSON Pointer patches before
+sending complete cases over NDJSON. It checks canonical identities, normalized
+HTTP/MCP output and exact safe rejection paths/messages, including boundary
+inputs. Fixture composition neither validates nor repairs runtime artifacts.

package/dist/adapters/client-contract.d.ts

@@ -0,0 +1,5 @@
+import type { FixtureRole, HandlerResult } from '../types.js';
+type Data = Record<string, unknown>;
+export declare function handleClientContract(role: FixtureRole, c: Data): HandlerResult;
+export {};
+//# sourceMappingURL=client-contract.d.ts.map

package/dist/adapters/client-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract.d.ts","sourceRoot":"","sources":["../../src/adapters/client-contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACpC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,GAAG,aAAa,CAqB9E"}

package/dist/adapters/client-contract.js

@@ -0,0 +1,29 @@
+import { decodeProtocolClientContract, prepareProtocolClientContract, validateProtocolClientContract, validateProtocolClientQuery, } from '@hypequery/protocol';
+import { clientContractTargets } from './utils/client-contract-targets.js';
+export function handleClientContract(role, c) {
+    if (c.mode === 'decode') {
+        decodeProtocolClientContract(c.value);
+        return { ok: true };
+    }
+    if (c.mode === 'query') {
+        const value = c.value;
+        const result = validateProtocolClientQuery(value.contract, value.endpoint, value.input, value.transport);
+        return { ok: true, output: { body: result.body, selectedMeasures: result.selectedMeasures, effectiveLimit: result.effectiveLimit } };
+    }
+    if (c.mode === 'relation') {
+        const value = c.value;
+        if (value.contract)
+            return { ok: true, output: clientContractTargets(validateProtocolClientContract(value.contract)) };
+        const left = validateProtocolClientContract(value.left), right = validateProtocolClientContract(value.right);
+        return { ok: true, output: {
+                sameEndpointSchemas: left.endpoints.filter(e => right.endpoints.some(r => r.id === e.id && r.schemaHash === e.schemaHash)).map(e => e.id),
+                sameContentHash: left.contentHash === right.contentHash,
+            } };
+    }
+    const contract = validateProtocolClientContract(c.value);
+    if (role !== 'identity')
+        return { ok: true };
+    const { contentHash: _hash, endpoints, ...root } = contract;
+    const prepared = prepareProtocolClientContract({ ...root, endpoints: endpoints.map(({ schemaHash: _schemaHash, ...endpoint }) => endpoint) });
+    return { ok: true, output: { canonical: prepared.canonical, sha256: prepared.contentHash } };
+}

package/dist/adapters/reference.d.ts

@@ -9,7 +9,7 @@ export declare const REFERENCE_HOSTILE_OBJECT_SUITE: {
     readonly count: 7;
     readonly mechanisms: readonly ["getter", "toJSON", "proxy", "custom-prototype", "symbol-key", "sparse-array", "cycle"];
 };
-export declare const REFERENCE_FAMILIES: readonly ["cache-keys-v1", "cache-preimages-v1", "tagged-values-v1", "identifiers-v1", "expressions-v1", "expressions-v2", "query-schemas-v1", "query-implementations-v1", "query-events-v1", "query-diagnostics-v1", "deployments-v2", "deployments-v3", "deployment-bundles-v1", "deployment-releases-v1", "semantic-invocations-v1", "semantic-invocations-v2"];
+export declare const REFERENCE_FAMILIES: readonly ["client-contract-v1", "cache-keys-v1", "cache-preimages-v1", "tagged-values-v1", "identifiers-v1", "expressions-v1", "expressions-v2", "query-schemas-v1", "query-implementations-v1", "query-events-v1", "query-diagnostics-v1", "deployments-v2", "deployments-v3", "deployment-bundles-v1", "deployment-releases-v1", "semantic-invocations-v1", "semantic-invocations-v2"];
 export declare function referenceHandle(family: string, role: FixtureRole, c: Case, section?: string): HandlerResult;
 export {};
 //# sourceMappingURL=reference.d.ts.map

package/dist/adapters/reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/adapters/reference.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc9D,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0BpC;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;CAWjC,CAAC;AAEX,eAAO,MAAM,kBAAkB,oWAiBrB,CAAC;AAEX,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,IAAI,EACP,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CA8Cf"}
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/adapters/reference.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc9D,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA6BpC;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;CAWjC,CAAC;AAEX,eAAO,MAAM,kBAAkB,0XAkBrB,CAAC;AAEX,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,IAAI,EACP,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAgDf"}

package/dist/adapters/reference.js

@@ -1,3 +1,4 @@
+import { handleClientContract } from './client-contract.js';
 // The TypeScript reference adapter. Maps each family/role/case to the public
 // root export of @hypequery/protocol and returns a wire result. Every operation
 // goes through the package's supported surface — this is exactly what a second
@@ -8,8 +9,10 @@ const STABLE_CODE = /^HQ_[A-Z0-9_]+$/;
 /** Turns a thrown protocol error into a wire rejection; rethrows anything else. */
 function mapError(error) {
     const code = error?.code;
-    if (typeof code === 'string' && STABLE_CODE.test(code))
-        return { ok: false, code };
+    if (typeof code === 'string' && STABLE_CODE.test(code)) {
+        const safe = error;
+        return { ok: false, code, ...(code.startsWith('HQ_CLIENT_') ? { output: { path: safe.path, message: safe.message } } : {}) };
+    }
     throw error;
 }
 function attempt(fn) {
@@ -43,6 +46,7 @@ export const REFERENCE_HOSTILE_OBJECT_SUITE = {
     ],
 };
 export const REFERENCE_FAMILIES = [
+    'client-contract-v1',
     'cache-keys-v1',
     'cache-preimages-v1',
     'tagged-values-v1',
@@ -62,6 +66,8 @@ export const REFERENCE_FAMILIES = [
 ];
 export function referenceHandle(family, role, c, section) {
     switch (family) {
+        case 'client-contract-v1':
+            return attempt(() => handleClientContract(role, c));
         case 'tagged-values-v1':
             return handleTaggedValue(role, c);
         case 'identifiers-v1':

package/dist/adapters/utils/client-contract-targets.d.ts

@@ -0,0 +1,4 @@
+import type { ProtocolClientContract } from '@hypequery/protocol';
+/** Callable targets, preserving normalized endpoint order without inventing dataset access. */
+export declare function clientContractTargets(contract: ProtocolClientContract): Record<string, unknown>;
+//# sourceMappingURL=client-contract-targets.d.ts.map

package/dist/adapters/utils/client-contract-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract-targets.d.ts","sourceRoot":"","sources":["../../../src/adapters/utils/client-contract-targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,+FAA+F;AAC/F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK/F"}

package/dist/adapters/utils/client-contract-targets.js

@@ -0,0 +1,7 @@
+/** Callable targets, preserving normalized endpoint order without inventing dataset access. */
+export function clientContractTargets(contract) {
+    return {
+        queryDatasetTargets: contract.endpoints.filter(e => e.kind === 'dataset').map(e => e.id),
+        queryMetricTargets: contract.endpoints.filter(e => e.kind === 'metric').map(e => ({ dataset: e.dataset, metric: e.id })),
+    };
+}

package/dist/client-contract-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { EnumeratedCase } from './types.js';
+export declare function composeClientContractCases(cases: EnumeratedCase[]): EnumeratedCase[];
+//# sourceMappingURL=client-contract-fixtures.d.ts.map

package/dist/client-contract-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-contract-fixtures.d.ts","sourceRoot":"","sources":["../src/client-contract-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAwBpF"}

package/dist/client-contract-fixtures.js

@@ -0,0 +1,61 @@
+function base(values, id) {
+    if (typeof id !== 'string' || !values.has(id))
+        throw new Error('Unknown client fixture base');
+    return structuredClone(values.get(id));
+}
+function patch(value, changes) {
+    for (const change of changes) {
+        if (!change.path.startsWith('/'))
+            throw new Error('Invalid client fixture pointer');
+        const parts = change.path.slice(1).split('/').map(part => part.replaceAll('~1', '/').replaceAll('~0', '~'));
+        let target = value;
+        for (const part of parts.slice(0, -1)) {
+            if (!Object.hasOwn(target, part))
+                throw new Error('Missing client fixture parent');
+            target = target[part];
+        }
+        const key = parts.at(-1);
+        if (key === '-' && Array.isArray(target))
+            target.push(structuredClone(change.value));
+        else
+            Object.defineProperty(target, key, { value: structuredClone(change.value), enumerable: true, writable: true, configurable: true });
+    }
+    return value;
+}
+export function composeClientContractCases(cases) {
+    const values = new Map(cases.filter(item => item.role === 'success' && item.case.mode === undefined)
+        .map(item => [item.id, item.case.value]));
+    return cases.map(item => {
+        const c = item.case;
+        if (c.base !== undefined)
+            return { ...item, case: { ...c, value: patch(base(values, c.base), c.set) } };
+        if (c.mode === 'query')
+            return { ...item, case: { ...c, value: { contract: base(values, c.contract), endpoint: c.endpoint, input: c.input, transport: c.transport ?? 'http' } } };
+        if (c.mode === 'relation')
+            return { ...item, case: { ...c, value: c.left === undefined ? { contract: base(values, c.contract) }
+                        : { left: base(values, c.left), right: base(values, c.right) } } };
+        if (c.mode === 'boundary') {
+            const generator = c.generator;
+            let value;
+            if (generator.type === 'endpoints')
+                value = { ...base(values, 'build'), endpoints: Array.from({ length: generator.count }, () => ({})) };
+            else if (generator.type === 'descriptors') {
+                const dimensions = Object.fromEntries(Array.from({ length: 256 }, (_, i) => ['field' + i, null]));
+                value = { ...base(values, 'build'), endpoints: Array.from({ length: generator.count }, () => ({ dimensions })) };
+            }
+            else if (generator.type === 'members')
+                value = Array.from({ length: generator.count }, () => null);
+            else if (generator.type === 'bytes')
+                value = { extra: 'x'.repeat(generator.count - 12) };
+            else if (generator.type === 'depth') {
+                value = 0;
+                for (let i = 1; i < generator.count; i++)
+                    value = [value];
+            }
+            else
+                throw new Error('Unknown client fixture generator');
+            return { ...item, case: { ...c, value } };
+        }
+        return item;
+    });
+}

package/dist/compare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwC7E,wBAAgB,WAAW,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CA2ElF"}
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwC7E,wBAAgB,WAAW,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CA+ElF"}

package/dist/compare.js

@@ -76,6 +76,11 @@ export function compareCase(ec, result) {
             if (code !== ec.case.error) {
                 return outcome(ec, 'fail', { expected: String(ec.case.error), actual: String(code) });
             }
+            if (ec.family === 'client-contract-v1') {
+                const o = output(result);
+                if (o.path !== ec.case.path || o.message !== ec.case.message)
+                    return outcome(ec, 'fail', { message: 'client failure path/message mismatch' });
+            }
             return outcome(ec, 'pass');
         }
         case 'non-portable': {
@@ -108,6 +113,9 @@ export function compareCase(ec, result) {
     }
 }
 function compareSuccessOutput(ec, o) {
+    if (ec.family === 'client-contract-v1' && ec.case.expected !== undefined && !deepEqual(o, ec.case.expected)) {
+        return outcome(ec, 'fail', { message: 'client normalized output mismatch' });
+    }
     if (ec.family === 'tagged-values-v1') {
         if (o.canonicalHex !== ec.case.canonicalHex) {
             return outcome(ec, 'fail', { expected: 'canonicalHex', actual: 'mismatch' });

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;AAM3D,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAiB1E;AAgDD,sEAAsE;AACtE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,UAAU,GACnB,cAAc,EAAE,CAmBlB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,UAAU,GACnB,cAAc,EAAE,CA0BlB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,UAAU,GACnB,cAAc,EAAE,CAElB"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;AAM3D,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAiB1E;AAgDD,sEAAsE;AACtE,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,UAAU,GACnB,cAAc,EAAE,CAoBlB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,UAAU,GACnB,cAAc,EAAE,CA0BlB;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,UAAU,GACnB,cAAc,EAAE,CAElB"}

package/dist/manifest.js

@@ -1,3 +1,4 @@
+import { composeClientContractCases } from './client-contract-fixtures.js';
 function decodePointerToken(token) {
     return token.replace(/~1/g, '/').replace(/~0/g, '~');
 }
@@ -63,7 +64,8 @@ function enumerateFile(family, file, loadJson) {
 /** Cases derived from the family fixture files, in manifest order. */
 export function enumerateFamilyCases(manifest, loadJson) {
     return manifest.families.flatMap((family) => {
-        const cases = family.files.flatMap((file) => enumerateFile(family, file, loadJson));
+        const rawCases = family.files.flatMap((file) => enumerateFile(family, file, loadJson));
+        const cases = family.name === 'client-contract-v1' ? composeClientContractCases(rawCases) : rawCases;
         // An identity case pins the canonical bytes and hash of the success case
         // that shares its id. Attach that success value so an adapter can derive
         // the canonical form without loading the success file itself.

package/fixtures/client-contract-v1/README.md

@@ -0,0 +1,29 @@
+# Semantic client contract v1
+
+Normative vectors for [RFC 0018](../../rfc/0018-semantic-client-contract.md).
+The family is required by the TypeScript/Python conformance gates.
+
+- success.json pins build, metric-only, empty and narrowed signed contracts.
+- identities.json pins canonical complete documents and both identity domains.
+- rejections.json pins malformed descriptors, identity failures, safe messages
+  and JSON Pointer paths, plus exact size/depth/count boundaries and text decoding.
+- queries.json pins accepted strict HTTP/MCP input and complete normalized output.
+- query-rejections.json pins invalid selections, types, nulls, operators and budgets.
+- relations.json pins cross-view schema stability and query-target visibility.
+- timezone-names.txt is the case-sensitive portable timezone registry. Runtime
+  package registries must match it; aliases are retained verbatim in identities.
+
+For compact review, cases can reference a success ID via base/contract/left/right.
+The conformance runner composes these references before dispatching the case;
+implementations receive complete inputs and need no fixture-file access. A set
+array adds/replaces fields in a deep-copied base using RFC 6901 JSON Pointers;
+- appends an array element. Parents must exist. It never recomputes identities:
+malformed shape validation must precede identity validation. The runner's boundary
+generators expand only synthetic byte, depth, endpoint, descriptor and array-member counts.
+Identity cases reuse the matching success value, as other fixture families do.
+
+The query compiler preserves fixed MCP tool names; empty target sets have required
+never-valued routing fields. JSON Schema pins structural types; call-time semantic
+validation additionally enforces selected fields, uniqueness, portable timezones
+and combined predicate budgets. No artifact identity authenticates a principal or
+certifies an endpoint's execution implementation.

package/fixtures/client-contract-v1/identities.json

@@ -0,0 +1,36 @@
+[
+  {
+    "id": "build",
+    "canonical": "{\"contentHash\":\"f1a7071cfac3615ef809ce91f14c59b1ee68807b099afe1fe9ead06db1f5ecd1\",\"endpoints\":[{\"dataset\":\"countries\",\"defaultMeasures\":[],\"dimensions\":{\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{},\"id\":\"countries\",\"kind\":\"dataset\",\"limits\":{\"defaultLimit\":100,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":1000,\"maxMeasures\":0,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":0},\"measures\":{},\"metadata\":false,\"path\":\"/api/v1/datasets/countries/query\",\"schemaHash\":\"9a5f50cd7564f283d2f0ee8f3f1cdc27731683c939e176bd25919a83d28d94ca\",\"time\":null},{\"dataset\":\"orders\",\"defaultMeasures\":[\"revenue\",\"orderCount\",\"latestLabel\"],\"dimensions\":{\"amount\":{\"groupable\":true,\"nullable\":\"unknown\",\"orderable\":true,\"type\":\"number\",\"wireType\":\"number-or-string\"},\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"},\"customer.active\":{\"groupable\":false,\"nullable\":true,\"orderable\":false,\"type\":\"boolean\",\"wireType\":\"boolean\"},\"customer.tier\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"amount\":{\"operators\":[\"between\",\"eq\",\"gt\",\"gte\",\"in\",\"lt\",\"lte\",\"neq\",\"notIn\"],\"type\":\"number\"},\"country\":{\"operators\":[\"eq\",\"in\",\"like\",\"neq\",\"notIn\"],\"type\":\"string\"},\"customer.active\":{\"operators\":[\"eq\",\"neq\"],\"type\":\"boolean\"},\"customer.tier\":{\"operators\":[\"eq\",\"in\"],\"type\":\"string\"},\"paidStatus\":{\"operators\":[\"eq\"],\"type\":\"string\"}},\"id\":\"orders\",\"kind\":\"dataset\",\"limits\":{\"defaultLimit\":100,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":1000,\"maxMeasures\":50,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"averageRevenue\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"customer.unique\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"latestLabel\":{\"having\":false,\"nullable\":true,\"wireType\":\"string\"},\"orderCount\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"revenue\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":true,\"path\":\"/api/v1/datasets/orders/query\",\"schemaHash\":\"88802c0d4798fd0758b7e7697f582b034afada967bfe0fdcb1cafd957144b1f3\",\"time\":{\"defaultTimezone\":\"UTC\",\"grains\":[\"day\",\"hour\",\"month\",\"week\"],\"periodFormat\":\"calendar-date-or-local-datetime-v1\",\"timezone\":true}},{\"dataset\":\"orders\",\"dimensions\":{\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"},\"customer.active\":{\"groupable\":false,\"nullable\":true,\"orderable\":false,\"type\":\"boolean\",\"wireType\":\"boolean\"},\"customer.tier\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"amount\":{\"operators\":[\"between\",\"eq\",\"gt\",\"gte\",\"in\",\"lt\",\"lte\",\"neq\",\"notIn\"],\"type\":\"number\"},\"country\":{\"operators\":[\"eq\",\"in\",\"like\",\"neq\",\"notIn\"],\"type\":\"string\"},\"customer.active\":{\"operators\":[\"eq\",\"neq\"],\"type\":\"boolean\"},\"customer.tier\":{\"operators\":[\"eq\",\"in\"],\"type\":\"string\"},\"paidStatus\":{\"operators\":[\"eq\"],\"type\":\"string\"}},\"id\":\"ordersRevenue\",\"kind\":\"metric\",\"limits\":{\"defaultLimit\":20,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":20,\"maxMeasures\":1,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"revenue\":{\"having\":false,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":true,\"path\":\"/api/v1/metrics/revenue\",\"schemaHash\":\"e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d\",\"time\":{\"defaultTimezone\":\"UTC\",\"grains\":[\"day\",\"hour\",\"month\",\"week\"],\"periodFormat\":\"calendar-date-or-local-datetime-v1\",\"timezone\":true}}],\"kind\":\"hypequery-client-contract\",\"version\":1,\"view\":\"build\"}",
+    "endpointHashes": {
+      "countries": "9a5f50cd7564f283d2f0ee8f3f1cdc27731683c939e176bd25919a83d28d94ca",
+      "orders": "88802c0d4798fd0758b7e7697f582b034afada967bfe0fdcb1cafd957144b1f3",
+      "ordersRevenue": "e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d"
+    },
+    "sha256": "f1a7071cfac3615ef809ce91f14c59b1ee68807b099afe1fe9ead06db1f5ecd1"
+  },
+  {
+    "id": "metric-only",
+    "canonical": "{\"contentHash\":\"3dc2252343be12ec4d2434a24dd86e4a4ec5aede037d646c44d14179d9672e81\",\"endpoints\":[{\"dataset\":\"orders\",\"dimensions\":{\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"},\"customer.active\":{\"groupable\":false,\"nullable\":true,\"orderable\":false,\"type\":\"boolean\",\"wireType\":\"boolean\"},\"customer.tier\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"amount\":{\"operators\":[\"between\",\"eq\",\"gt\",\"gte\",\"in\",\"lt\",\"lte\",\"neq\",\"notIn\"],\"type\":\"number\"},\"country\":{\"operators\":[\"eq\",\"in\",\"like\",\"neq\",\"notIn\"],\"type\":\"string\"},\"customer.active\":{\"operators\":[\"eq\",\"neq\"],\"type\":\"boolean\"},\"customer.tier\":{\"operators\":[\"eq\",\"in\"],\"type\":\"string\"},\"paidStatus\":{\"operators\":[\"eq\"],\"type\":\"string\"}},\"id\":\"ordersRevenue\",\"kind\":\"metric\",\"limits\":{\"defaultLimit\":20,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":20,\"maxMeasures\":1,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"revenue\":{\"having\":false,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":true,\"path\":\"/api/v1/metrics/revenue\",\"schemaHash\":\"e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d\",\"time\":{\"defaultTimezone\":\"UTC\",\"grains\":[\"day\",\"hour\",\"month\",\"week\"],\"periodFormat\":\"calendar-date-or-local-datetime-v1\",\"timezone\":true}}],\"kind\":\"hypequery-client-contract\",\"version\":1,\"view\":\"authorized\"}",
+    "endpointHashes": {
+      "ordersRevenue": "e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d"
+    },
+    "sha256": "3dc2252343be12ec4d2434a24dd86e4a4ec5aede037d646c44d14179d9672e81"
+  },
+  {
+    "id": "empty",
+    "canonical": "{\"contentHash\":\"7a31724c56ffb78f0e8e2ab022101c422671f6bb4291ae6c09b1cd634180507e\",\"endpoints\":[],\"kind\":\"hypequery-client-contract\",\"version\":1,\"view\":\"authorized\"}",
+    "endpointHashes": {},
+    "sha256": "7a31724c56ffb78f0e8e2ab022101c422671f6bb4291ae6c09b1cd634180507e"
+  },
+  {
+    "id": "narrowed",
+    "canonical": "{\"contentHash\":\"c350b9b6e0351acbbac7509bf5d889afa343b9fb5048d826265d8e9f5ef895d8\",\"endpoints\":[{\"dataset\":\"countries\",\"defaultMeasures\":[],\"dimensions\":{\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{},\"id\":\"countries\",\"kind\":\"dataset\",\"limits\":{\"defaultLimit\":10,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":10,\"maxMeasures\":0,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":0},\"measures\":{},\"metadata\":false,\"path\":\"/api/v1/datasets/countries/query\",\"schemaHash\":\"9a5f50cd7564f283d2f0ee8f3f1cdc27731683c939e176bd25919a83d28d94ca\",\"time\":null},{\"dataset\":\"orders\",\"defaultMeasures\":[\"revenue\",\"orderCount\",\"latestLabel\"],\"dimensions\":{\"amount\":{\"groupable\":true,\"nullable\":\"unknown\",\"orderable\":true,\"type\":\"number\",\"wireType\":\"number-or-string\"},\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"},\"customer.active\":{\"groupable\":false,\"nullable\":true,\"orderable\":false,\"type\":\"boolean\",\"wireType\":\"boolean\"},\"customer.tier\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"amount\":{\"operators\":[\"between\",\"eq\",\"gt\",\"gte\",\"in\",\"lt\",\"lte\",\"neq\",\"notIn\"],\"type\":\"number\"},\"country\":{\"operators\":[\"eq\",\"in\",\"like\",\"neq\",\"notIn\"],\"type\":\"string\"},\"customer.active\":{\"operators\":[\"eq\",\"neq\"],\"type\":\"boolean\"},\"customer.tier\":{\"operators\":[\"eq\",\"in\"],\"type\":\"string\"},\"paidStatus\":{\"operators\":[\"eq\"],\"type\":\"string\"}},\"id\":\"orders\",\"kind\":\"dataset\",\"limits\":{\"defaultLimit\":10,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":10,\"maxMeasures\":50,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"averageRevenue\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"customer.unique\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"latestLabel\":{\"having\":false,\"nullable\":true,\"wireType\":\"string\"},\"orderCount\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"},\"revenue\":{\"having\":true,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":true,\"path\":\"/api/v1/datasets/orders/query\",\"schemaHash\":\"88802c0d4798fd0758b7e7697f582b034afada967bfe0fdcb1cafd957144b1f3\",\"time\":{\"defaultTimezone\":\"UTC\",\"grains\":[\"day\",\"hour\",\"month\",\"week\"],\"periodFormat\":\"calendar-date-or-local-datetime-v1\",\"timezone\":true}},{\"dataset\":\"orders\",\"dimensions\":{\"country\":{\"groupable\":true,\"nullable\":false,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"},\"customer.active\":{\"groupable\":false,\"nullable\":true,\"orderable\":false,\"type\":\"boolean\",\"wireType\":\"boolean\"},\"customer.tier\":{\"groupable\":true,\"nullable\":true,\"orderable\":true,\"type\":\"string\",\"wireType\":\"string\"}},\"filters\":{\"amount\":{\"operators\":[\"between\",\"eq\",\"gt\",\"gte\",\"in\",\"lt\",\"lte\",\"neq\",\"notIn\"],\"type\":\"number\"},\"country\":{\"operators\":[\"eq\",\"in\",\"like\",\"neq\",\"notIn\"],\"type\":\"string\"},\"customer.active\":{\"operators\":[\"eq\",\"neq\"],\"type\":\"boolean\"},\"customer.tier\":{\"operators\":[\"eq\",\"in\"],\"type\":\"string\"},\"paidStatus\":{\"operators\":[\"eq\"],\"type\":\"string\"}},\"id\":\"ordersRevenue\",\"kind\":\"metric\",\"limits\":{\"defaultLimit\":10,\"maxDimensions\":50,\"maxFilterValues\":1000,\"maxLimit\":10,\"maxMeasures\":1,\"maxOffset\":10000,\"maxOrderBy\":50,\"maxPredicates\":100},\"measures\":{\"revenue\":{\"having\":false,\"nullable\":true,\"wireType\":\"string\"}},\"metadata\":true,\"path\":\"/api/v1/metrics/revenue\",\"schemaHash\":\"e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d\",\"time\":{\"defaultTimezone\":\"UTC\",\"grains\":[\"day\",\"hour\",\"month\",\"week\"],\"periodFormat\":\"calendar-date-or-local-datetime-v1\",\"timezone\":true}}],\"kind\":\"hypequery-client-contract\",\"version\":1,\"view\":\"authorized\"}",
+    "endpointHashes": {
+      "countries": "9a5f50cd7564f283d2f0ee8f3f1cdc27731683c939e176bd25919a83d28d94ca",
+      "orders": "88802c0d4798fd0758b7e7697f582b034afada967bfe0fdcb1cafd957144b1f3",
+      "ordersRevenue": "e282fb74777e65328d87cfe5caa0349104630cd88137b1842289e0c83676a98d"
+    },
+    "sha256": "c350b9b6e0351acbbac7509bf5d889afa343b9fb5048d826265d8e9f5ef895d8"
+  }
+]