@hypequery/datasets 0.2.1 → 0.4.0

package/dist/contract.d.ts

@@ -0,0 +1,101 @@
+import { type DatasetCatalogSource, type DimensionCatalogEntry, type MeasureCatalogEntry, type MetricCatalogEntry, type FilterCatalogEntry, type RelationshipCatalogEntry } from './catalog.js';
+import type { DatasetLimits } from './types.js';
+/**
+ * Version of the semantic contract format. Bump when the serialized shape
+ * changes in a way that snapshot consumers must account for.
+ */
+export declare const SEMANTIC_CONTRACT_VERSION = 1;
+export interface ContractDimension {
+    type: DimensionCatalogEntry['type'];
+    column?: string;
+    sql?: string;
+    label?: string;
+    description?: string;
+    filterable: boolean;
+    groupable: boolean;
+}
+export interface ContractMeasure {
+    aggregation: MeasureCatalogEntry['aggregation'];
+    field: string;
+    sql?: string;
+    label?: string;
+    description?: string;
+}
+export interface ContractMetric {
+    kind: MetricCatalogEntry['kind'];
+    valueType: MetricCatalogEntry['valueType'];
+    label?: string;
+    description?: string;
+    dimensions: string[];
+    measures?: string[];
+    filters: string[];
+    grains: string[];
+    grain?: string;
+    requires?: string[];
+}
+export interface ContractFilter {
+    field: string;
+    label?: string;
+    description?: string;
+    operators: string[];
+    valueType?: FilterCatalogEntry['valueType'];
+}
+export interface ContractRelationship {
+    kind: RelationshipCatalogEntry['kind'];
+    target: string;
+    from: string;
+    to: string;
+}
+export interface ContractDataset {
+    name: string;
+    source: string;
+    tenantKey?: string;
+    timeKey?: string;
+    requiresTenant: boolean;
+    supportedGrains: string[];
+    dimensions: Record<string, ContractDimension>;
+    measures: Record<string, ContractMeasure>;
+    metrics: Record<string, ContractMetric>;
+    filters: Record<string, ContractFilter>;
+    relationships: Record<string, ContractRelationship>;
+    limits?: DatasetLimits;
+}
+export interface SemanticContract {
+    version: number;
+    datasets: Record<string, ContractDataset>;
+    contentHash: string;
+}
+type SemanticContractWithoutHash = Omit<SemanticContract, 'contentHash'>;
+export interface SerializeSemanticContractOptions {
+    /**
+     * Include raw `sql` escape-hatch expressions for dimensions/measures.
+     *
+     * Defaults to `true` for trusted contexts (snapshots, CI, codegen) where the
+     * SQL already lives in the developer's source. Set to `false` when serving the
+     * contract to untrusted consumers so internal SQL is not exposed.
+     */
+    includeSql?: boolean;
+}
+/**
+ * Builds a deterministic semantic contract from dataset instances.
+ *
+ * The contract is a normalized, sorted projection of the dataset catalog with a
+ * version marker and content hash. Object keys and unordered arrays are sorted,
+ * and SQL escape hatches are whitespace-normalized so logically equal models
+ * produce identical JSON and hashes. This is the shared source consumed by
+ * snapshots, diffs, CI validation, docs, and codegen.
+ */
+export declare function serializeSemanticContract(datasets: Record<string, DatasetCatalogSource>, options?: SerializeSemanticContractOptions): SemanticContract;
+/**
+ * Serializes a contract with stable formatting for writing to disk and hashing.
+ */
+export declare function contractToStableJson(contract: SemanticContract | SemanticContractWithoutHash): string;
+/**
+ * Computes the SHA-256 content hash for a normalized contract.
+ *
+ * Uses `@noble/hashes` (audited, isomorphic, synchronous) rather than
+ * `node:crypto` so the contract stays usable in browser/edge runtimes.
+ */
+export declare function hashContract(contract: SemanticContract | SemanticContractWithoutHash): string;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

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

package/dist/contract.js

@@ -0,0 +1,161 @@
+import { sha256 } from '@noble/hashes/sha2';
+import { bytesToHex } from '@noble/hashes/utils';
+import { getDatasetCatalogs, } from './catalog.js';
+/**
+ * Version of the semantic contract format. Bump when the serialized shape
+ * changes in a way that snapshot consumers must account for.
+ */
+export const SEMANTIC_CONTRACT_VERSION = 1;
+/**
+ * Builds a deterministic semantic contract from dataset instances.
+ *
+ * The contract is a normalized, sorted projection of the dataset catalog with a
+ * version marker and content hash. Object keys and unordered arrays are sorted,
+ * and SQL escape hatches are whitespace-normalized so logically equal models
+ * produce identical JSON and hashes. This is the shared source consumed by
+ * snapshots, diffs, CI validation, docs, and codegen.
+ */
+export function serializeSemanticContract(datasets, options = {}) {
+    const includeSql = options.includeSql ?? true;
+    const catalogs = getDatasetCatalogs(datasets);
+    const contract = {
+        version: SEMANTIC_CONTRACT_VERSION,
+        datasets: sortedRecord(Object.entries(catalogs).map(([name, catalog]) => [name, datasetToContract(catalog, includeSql)])),
+    };
+    return {
+        ...contract,
+        contentHash: hashContract(contract),
+    };
+}
+function datasetToContract(catalog, includeSql) {
+    return {
+        name: catalog.name,
+        source: catalog.source,
+        ...(catalog.tenantKey !== undefined ? { tenantKey: catalog.tenantKey } : {}),
+        ...(catalog.timeKey !== undefined ? { timeKey: catalog.timeKey } : {}),
+        requiresTenant: catalog.requiresTenant,
+        supportedGrains: uniqueSorted(catalog.supportedGrains),
+        dimensions: sortedRecord(Object.entries(catalog.dimensions).map(([name, entry]) => [name, dimensionToContract(entry, includeSql)])),
+        measures: sortedRecord(Object.entries(catalog.measures).map(([name, entry]) => [name, measureToContract(entry, includeSql)])),
+        metrics: sortedRecord(Object.entries(catalog.metrics).map(([name, entry]) => [name, metricToContract(entry)])),
+        filters: sortedRecord(Object.entries(catalog.filters).map(([name, entry]) => [name, filterToContract(entry)])),
+        relationships: sortedRecord(Object.entries(catalog.relationships).map(([name, entry]) => [name, relationshipToContract(entry)])),
+        ...(catalog.limits !== undefined ? { limits: limitsToContract(catalog.limits) } : {}),
+    };
+}
+/**
+ * Emits dataset limits with a fixed key order. The source object's key order is
+ * author-controlled, so normalizing it keeps the contract hash stable for
+ * logically identical limits.
+ */
+function limitsToContract(limits) {
+    return {
+        ...(limits.maxDimensions !== undefined ? { maxDimensions: limits.maxDimensions } : {}),
+        ...(limits.maxFilters !== undefined ? { maxFilters: limits.maxFilters } : {}),
+        ...(limits.maxMeasures !== undefined ? { maxMeasures: limits.maxMeasures } : {}),
+        ...(limits.maxResultSize !== undefined ? { maxResultSize: limits.maxResultSize } : {}),
+    };
+}
+function dimensionToContract(entry, includeSql) {
+    return {
+        type: entry.type,
+        ...(entry.column !== undefined ? { column: entry.column } : {}),
+        ...(includeSql && entry.sql !== undefined ? { sql: normalizeSql(entry.sql) } : {}),
+        ...(entry.label !== undefined ? { label: entry.label } : {}),
+        ...(entry.description !== undefined ? { description: entry.description } : {}),
+        filterable: entry.filterable,
+        groupable: entry.groupable,
+    };
+}
+function measureToContract(entry, includeSql) {
+    return {
+        aggregation: entry.aggregation,
+        field: entry.field,
+        ...(includeSql && entry.sql !== undefined ? { sql: normalizeSql(entry.sql) } : {}),
+        ...(entry.label !== undefined ? { label: entry.label } : {}),
+        ...(entry.description !== undefined ? { description: entry.description } : {}),
+    };
+}
+function metricToContract(entry) {
+    return {
+        kind: entry.kind,
+        valueType: entry.valueType,
+        ...(entry.label !== undefined ? { label: entry.label } : {}),
+        ...(entry.description !== undefined ? { description: entry.description } : {}),
+        dimensions: uniqueSorted(entry.dimensions),
+        ...(entry.measures !== undefined ? { measures: uniqueSorted(entry.measures) } : {}),
+        filters: uniqueSorted(entry.filters),
+        grains: uniqueSorted(entry.grains),
+        ...(entry.grain !== undefined ? { grain: entry.grain } : {}),
+        ...(entry.requires !== undefined ? { requires: uniqueSorted(entry.requires) } : {}),
+    };
+}
+function filterToContract(entry) {
+    return {
+        field: entry.field,
+        ...(entry.label !== undefined ? { label: entry.label } : {}),
+        ...(entry.description !== undefined ? { description: entry.description } : {}),
+        operators: uniqueSorted(entry.operators ?? []),
+        ...(entry.valueType !== undefined ? { valueType: entry.valueType } : {}),
+    };
+}
+function relationshipToContract(entry) {
+    return {
+        kind: entry.kind,
+        target: entry.target,
+        from: entry.from,
+        to: entry.to,
+    };
+}
+/**
+ * Serializes a contract with stable formatting for writing to disk and hashing.
+ */
+export function contractToStableJson(contract) {
+    return JSON.stringify(contract, null, 2);
+}
+/**
+ * Computes the SHA-256 content hash for a normalized contract.
+ *
+ * Uses `@noble/hashes` (audited, isomorphic, synchronous) rather than
+ * `node:crypto` so the contract stays usable in browser/edge runtimes.
+ */
+export function hashContract(contract) {
+    return bytesToHex(sha256(contractToStableJson(contract)));
+}
+/**
+ * Locale-independent string comparison by UTF-16 code unit. Used everywhere the
+ * contract sorts, so the content hash is stable across environments (CI ICU
+ * versions, locales) rather than depending on `localeCompare`.
+ */
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** Builds an object whose keys are inserted in sorted order for stable JSON. */
+function sortedRecord(entries) {
+    return Object.fromEntries([...entries].sort(([left], [right]) => compareStrings(left, right)));
+}
+/** Deduplicates and sorts a list so logically-equal sets serialize identically. */
+function uniqueSorted(values) {
+    return Array.from(new Set(values)).sort(compareStrings);
+}
+/** Normalizes SQL escape-hatch whitespace so equivalent SQL hashes identically. */
+function normalizeSql(sql) {
+    const lines = sql
+        .replace(/\r\n/g, '\n')
+        .split('\n')
+        .map(line => line.replace(/\s+$/g, ''));
+    while (lines.length > 0 && lines[0].trim() === '') {
+        lines.shift();
+    }
+    while (lines.length > 0 && lines[lines.length - 1].trim() === '') {
+        lines.pop();
+    }
+    const indents = lines
+        .filter(line => line.trim().length > 0)
+        .map(line => line.match(/^\s*/)?.[0].length ?? 0);
+    const minIndent = indents.length > 0 ? Math.min(...indents) : 0;
+    return lines
+        .map(line => line.slice(minIndent))
+        .join('\n')
+        .trim();
+}

package/dist/index.d.ts

@@ -7,7 +7,9 @@ export { divide, multiply, subtract, add, nullIfZero, coalesce, round, floor, ce
 export { eq, neq, gt, gte, lt, lte, inList, notInList, between, like, asc, desc, filter, order, } from './query-helpers.js';
 export { createDatasetRegistry } from './registry.js';
 export { getDatasetCatalog, getDatasetCatalogs } from './catalog.js';
-export type { DatasetCatalog, DatasetCatalogMap, DimensionCatalogEntry, MeasureCatalogEntry, MetricCatalogEntry, FilterCatalogEntry, RelationshipCatalogEntry, } from './catalog.js';
+export type { DatasetCatalog, DatasetCatalogMap, DatasetCatalogSource, DimensionCatalogEntry, MeasureCatalogEntry, MetricCatalogEntry, FilterCatalogEntry, RelationshipCatalogEntry, } from './catalog.js';
+export { serializeSemanticContract, contractToStableJson, hashContract, SEMANTIC_CONTRACT_VERSION, } from './contract.js';
+export type { SemanticContract, SerializeSemanticContractOptions, ContractDataset, ContractDimension, ContractMeasure, ContractMetric, ContractFilter, ContractRelationship, } from './contract.js';
 export { generateDatasetTools, toOpenAITools, toAISDKTools, toMcpTools, } from './tools.js';
 export type { AISDKToolDefinition, DatasetToolAnalytics, DatasetToolMode, GenerateDatasetToolsOptions, JsonSchema, McpToolDefinition, OpenAIToolDefinition, SemanticToolDefinition, } from './tools.js';
 export { createDatasetClient } from './executor.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -16,6 +16,8 @@ export { eq, neq, gt, gte, lt, lte, inList, notInList, between, like, asc, desc,
 export { createDatasetRegistry } from './registry.js';
 // Catalog
 export { getDatasetCatalog, getDatasetCatalogs } from './catalog.js';
+// Semantic contract (stable, hashable export for snapshots/diffs/validation)
+export { serializeSemanticContract, contractToStableJson, hashContract, SEMANTIC_CONTRACT_VERSION, } from './contract.js';
 // Agent/tool metadata
 export { generateDatasetTools, toOpenAITools, toAISDKTools, toMcpTools, } from './tools.js';
 // Dataset client

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/datasets",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Semantic layer for defining datasets, metrics, and semantic queries",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,6 +29,7 @@
     "dist"
   ],
   "dependencies": {
+    "@noble/hashes": "^1.8.0",
     "zod": "^3.22.4"
   },
   "devDependencies": {