@hypequery/serve 0.17.1 → 0.17.2

package/dist/index.d.ts

@@ -22,7 +22,12 @@ export { buildProtocolDeploymentContract } from './protocol-adapter.js';
 export type { BuildProtocolDeploymentOptions } from './protocol-adapter.js';
 export { analyzeCloudCompatibility, formatCloudCompatibilityDiagnostics, } from './cloud-compatibility.js';
 export type { CloudCompatibilityCode, CloudCompatibilityDiagnostic, CloudCompatibilitySeverity, } from './cloud-compatibility.js';
-export { ProtocolSchemaAdapterError, zodToProtocolSchema } from './protocol-schema-adapter.js';
+/**
+ * Re-exported from `@hypequery/datasets`, where it now lives beside the schema
+ * builders it converts. Kept here because it is a shipped export of this
+ * package and removing it would break importers for no benefit.
+ */
+export { ProtocolSchemaAdapterError, zodToProtocolSchema } from '@hypequery/datasets';
 /** @deprecated Import from `@hypequery/serve/dev` instead. */
 export { serveDev } from "./dev.js";
 export * from "./serve.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACxF,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EACL,yBAAyB,EACzB,mCAAmC,GACpC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC/F,8DAA8D;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACtF,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACxF,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EACL,yBAAyB,EACzB,mCAAmC,GACpC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC;;;;GAIG;AACH,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACtF,8DAA8D;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -18,7 +18,12 @@ export { startServer, toNodeHandler, toFetchHandler } from "./adapters/standalon
 export { createCacheObservability, detectBuilderCache } from "./cache-observability.js";
 export { buildProtocolDeploymentContract } from './protocol-adapter.js';
 export { analyzeCloudCompatibility, formatCloudCompatibilityDiagnostics, } from './cloud-compatibility.js';
-export { ProtocolSchemaAdapterError, zodToProtocolSchema } from './protocol-schema-adapter.js';
+/**
+ * Re-exported from `@hypequery/datasets`, where it now lives beside the schema
+ * builders it converts. Kept here because it is a shipped export of this
+ * package and removing it would break importers for no benefit.
+ */
+export { ProtocolSchemaAdapterError, zodToProtocolSchema } from '@hypequery/datasets';
 /** @deprecated Import from `@hypequery/serve/dev` instead. */
 export { serveDev } from "./dev.js";
 export * from "./serve.js";

package/dist/protocol-adapter.js

@@ -3,7 +3,7 @@ import { buildProtocolDatasetContract, } from '@hypequery/datasets';
 import { analyzeCloudCompatibility, formatCloudCompatibilityDiagnostics, } from './cloud-compatibility.js';
 import { resolveDatasetEntry } from './semantic/datasets/utils/dataset-entry.js';
 import { resolveMetricEntry } from './semantic/datasets/metric-endpoint.js';
-import { zodToProtocolSchema } from './protocol-schema-adapter.js';
+import { zodToProtocolSchema } from '@hypequery/datasets';
 import { resolveLocalAuthRequirement } from './auth-requirement.js';
 function reportCloudCompatibility(config, options) {
     const diagnostics = analyzeCloudCompatibility(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/serve",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "Code-first TypeScript runtime for validated ClickHouse analytics APIs, OpenAPI, auth, and tenancy",
   "keywords": [
     "clickhouse",
@@ -39,7 +39,7 @@
     "openapi-typescript": "^7.13.0",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.5",
-    "@hypequery/datasets": "^0.15.0"
+    "@hypequery/datasets": "^0.16.0"
   },
   "peerDependencies": {
     "tsx": "^4.0.0",

package/dist/protocol-schema-adapter.d.ts

@@ -1,9 +0,0 @@
-import type { ZodTypeAny } from 'zod';
-import { type ProtocolSchema } from '@hypequery/protocol';
-export declare class ProtocolSchemaAdapterError extends TypeError {
-    readonly path: string;
-    constructor(message: string, path?: string);
-}
-/** Converts the portable subset of a Zod v3 schema into RFC 0004. */
-export declare function zodToProtocolSchema(schema: ZodTypeAny | undefined, path?: string): ProtocolSchema;
-//# sourceMappingURL=protocol-schema-adapter.d.ts.map

package/dist/protocol-schema-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"protocol-schema-adapter.d.ts","sourceRoot":"","sources":["../src/protocol-schema-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,0BAA2B,SAAQ,SAAS;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAM;CAKxC;AA0OD,qEAAqE;AACrE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,IAAI,SAAM,GACT,cAAc,CAGhB"}

package/dist/protocol-schema-adapter.js

@@ -1,239 +0,0 @@
-import { validateCanonicalValue, validateProtocolSchema, } from '@hypequery/protocol';
-export class ProtocolSchemaAdapterError extends TypeError {
-    path;
-    constructor(message, path = '$') {
-        super(`${message} at ${path}`);
-        this.name = 'ProtocolSchemaAdapterError';
-        this.path = path;
-    }
-}
-function canonicalValue(input, path) {
-    try {
-        if (Array.isArray(input)) {
-            return validateCanonicalValue({
-                $hypequery: {
-                    type: 'array',
-                    version: 1,
-                    values: input.map((item, index) => canonicalValue(item, `${path}[${index}]`)),
-                },
-            });
-        }
-        if (typeof input === 'object' && input !== null) {
-            if ('$hypequery' in input)
-                return validateCanonicalValue(input);
-            const prototype = Object.getPrototypeOf(input);
-            if (prototype !== Object.prototype && prototype !== null) {
-                throw new ProtocolSchemaAdapterError('Default is not portable plain data', path);
-            }
-            return validateCanonicalValue({
-                $hypequery: {
-                    type: 'map',
-                    version: 1,
-                    entries: Object.entries(input)
-                        .sort(([left], [right]) => left.localeCompare(right))
-                        .map(([key, value]) => [key, canonicalValue(value, `${path}.${key}`)]),
-                },
-            });
-        }
-        return validateCanonicalValue(input);
-    }
-    catch (error) {
-        if (error instanceof ProtocolSchemaAdapterError)
-            throw error;
-        throw new ProtocolSchemaAdapterError('Default is not a canonical protocol value', path);
-    }
-}
-function typeName(schema) {
-    return String(schema?._def?.typeName ?? 'Unknown');
-}
-function description(schema) {
-    return typeof schema.description === 'string'
-        ? schema.description
-        : undefined;
-}
-function annotate(schema, result) {
-    const value = description(schema);
-    return value === undefined ? result : { ...result, description: value };
-}
-function convertString(schema, path) {
-    const result = { kind: 'string' };
-    for (const check of schema._def.checks) {
-        switch (check.kind) {
-            case 'min':
-                result.minLength = check.value;
-                break;
-            case 'max':
-                result.maxLength = check.value;
-                break;
-            case 'length':
-                result.minLength = check.value;
-                result.maxLength = check.value;
-                break;
-            default:
-                throw new ProtocolSchemaAdapterError(`Unsupported Zod string check "${String(check.kind)}"`, path);
-        }
-    }
-    return annotate(schema, result);
-}
-function convertNumber(schema, path) {
-    const result = { kind: 'number' };
-    for (const check of schema._def.checks) {
-        switch (check.kind) {
-            case 'int':
-                result.kind = 'integer';
-                break;
-            case 'min':
-                result[check.inclusive === false ? 'exclusiveMinimum' : 'minimum'] = check.value;
-                break;
-            case 'max':
-                result[check.inclusive === false ? 'exclusiveMaximum' : 'maximum'] = check.value;
-                break;
-            case 'finite':
-                break;
-            default:
-                throw new ProtocolSchemaAdapterError(`Unsupported Zod number check "${String(check.kind)}"`, path);
-        }
-    }
-    return annotate(schema, result);
-}
-function isOptionalProperty(schema) {
-    const name = typeName(schema);
-    return name === 'ZodOptional' || name === 'ZodDefault';
-}
-function nativeEnumValues(input) {
-    const values = Object.keys(input)
-        .filter(key => typeof input[String(input[key])] !== 'number')
-        .map(key => input[key]);
-    return [...new Set(values)];
-}
-function isUnconstrainedRecordKey(schema) {
-    if (schema === undefined || typeName(schema) !== 'ZodString')
-        return false;
-    const definition = schema._def;
-    return Array.isArray(definition.checks)
-        && definition.checks.length === 0
-        && definition.coerce !== true;
-}
-function convert(schema, path) {
-    const definition = schema._def;
-    switch (typeName(schema)) {
-        case 'ZodAny':
-        case 'ZodUnknown':
-            return annotate(schema, { kind: 'any' });
-        case 'ZodNever':
-        case 'ZodVoid':
-        case 'ZodUndefined':
-            return annotate(schema, { kind: 'void' });
-        case 'ZodNull':
-            return annotate(schema, { kind: 'null' });
-        case 'ZodBoolean':
-            return annotate(schema, { kind: 'boolean' });
-        case 'ZodString':
-            return convertString(schema, path);
-        case 'ZodNumber':
-            return convertNumber(schema, path);
-        case 'ZodLiteral':
-            return annotate(schema, {
-                kind: 'literal',
-                value: canonicalValue(definition.value, `${path}.value`),
-            });
-        case 'ZodEnum':
-            return annotate(schema, {
-                kind: 'enum',
-                values: [...definition.values],
-            });
-        case 'ZodNativeEnum': {
-            const values = nativeEnumValues(definition.values);
-            return annotate(schema, { kind: 'enum', values });
-        }
-        case 'ZodArray': {
-            const result = {
-                kind: 'array',
-                items: convert(definition.type, `${path}.items`),
-            };
-            if (definition.minLength?.value !== undefined)
-                result.minItems = definition.minLength.value;
-            if (definition.maxLength?.value !== undefined)
-                result.maxItems = definition.maxLength.value;
-            if (definition.exactLength?.value !== undefined) {
-                result.minItems = definition.exactLength.value;
-                result.maxItems = definition.exactLength.value;
-            }
-            return annotate(schema, result);
-        }
-        case 'ZodObject': {
-            if (typeName(definition.catchall) !== 'ZodNever') {
-                throw new ProtocolSchemaAdapterError('Unsupported Zod object catchall', path);
-            }
-            const shape = definition.shape();
-            const properties = Object.fromEntries(Object.entries(shape).map(([name, property]) => [
-                name,
-                convert(property, `${path}.properties.${name}`),
-            ]));
-            const required = Object.entries(shape)
-                .filter(([, property]) => !isOptionalProperty(property))
-                .map(([name]) => name);
-            const unknownProperties = definition.unknownKeys === 'passthrough'
-                ? 'preserve'
-                : definition.unknownKeys === 'strict'
-                    ? 'reject'
-                    : 'strip';
-            return annotate(schema, {
-                kind: 'object',
-                properties,
-                required,
-                unknownProperties,
-            });
-        }
-        case 'ZodRecord':
-            if (!isUnconstrainedRecordKey(definition.keyType)) {
-                throw new ProtocolSchemaAdapterError('Unsupported constrained Zod record key', path);
-            }
-            return annotate(schema, {
-                kind: 'record',
-                values: convert(definition.valueType, `${path}.values`),
-            });
-        case 'ZodUnion':
-            return annotate(schema, {
-                kind: 'union',
-                variants: definition.options.map((option, index) => convert(option, `${path}.variants[${index}]`)),
-            });
-        case 'ZodDiscriminatedUnion':
-            // RFC 0004 has no separate discriminator index. Converting every option
-            // drops only Zod's lookup metadata; each object's literal discriminator
-            // property remains part of its protocol variant.
-            return annotate(schema, {
-                kind: 'union',
-                variants: [...definition.options.values()].map((option, index) => convert(option, `${path}.variants[${index}]`)),
-            });
-        case 'ZodNullable':
-            return annotate(schema, {
-                kind: 'union',
-                variants: [convert(definition.innerType, `${path}.variants[0]`), { kind: 'null' }],
-            });
-        case 'ZodOptional':
-            return annotate(schema, convert(definition.innerType, path));
-        case 'ZodDefault': {
-            const inner = convert(definition.innerType, path);
-            if (inner.kind === 'void') {
-                throw new ProtocolSchemaAdapterError('Void schemas cannot carry defaults', path);
-            }
-            return annotate(schema, {
-                ...inner,
-                default: canonicalValue(definition.defaultValue(), `${path}.default`),
-            });
-        }
-        case 'ZodBranded':
-            return annotate(schema, convert(definition.type, path));
-        case 'ZodReadonly':
-            return annotate(schema, convert(definition.innerType, path));
-        default:
-            throw new ProtocolSchemaAdapterError(`Unsupported Zod type "${typeName(schema)}"`, path);
-    }
-}
-/** Converts the portable subset of a Zod v3 schema into RFC 0004. */
-export function zodToProtocolSchema(schema, path = '$') {
-    if (schema === undefined)
-        return validateProtocolSchema({ kind: 'any' });
-    return validateProtocolSchema(convert(schema, path));
-}