@hypequery/serve 0.2.0 → 0.3.0

package/dist/client-config.js

@@ -25,6 +25,7 @@ export function extractClientConfig(api) {
         for (const [key, routeConfig] of Object.entries(api._routeConfig)) {
             config[key] = {
                 method: routeConfig.method,
+                path: api.queries[key]?.metadata?.path,
             };
         }
     }
@@ -33,6 +34,7 @@ export function extractClientConfig(api) {
         for (const [key, endpoint] of Object.entries(api.queries)) {
             config[key] = {
                 method: endpoint.method,
+                path: endpoint.metadata?.path,
             };
         }
     }
@@ -44,8 +46,8 @@ export function extractClientConfig(api) {
  *
  * @example
  * const config = defineClientConfig({
- *   hello: { method: 'GET' },
- *   createUser: { method: 'POST' },
+ *   hello: { method: 'GET', path: '/api/analytics/queries/hello' },
+ *   createUser: { method: 'POST', path: '/api/analytics/queries/createUser' },
  * });
  */
 export function defineClientConfig(config) {

package/dist/errors.js

@@ -12,6 +12,9 @@
  * ```
  */
 export class ServeHttpError extends Error {
+    status;
+    payload;
+    headers;
     constructor(status, type, message, headers) {
         super(message);
         this.name = 'ServeHttpError';

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export * from "./utils.js";
 export * from "./adapters/node.js";
 export * from "./adapters/fetch.js";
 export * from "./adapters/vercel.js";
+export { startServer, toNodeHandler, toFetchHandler } from "./adapters/standalone.js";
 export * from "./dev.js";
 export * from "./serve.js";
+export * from "./semantic/index.js";
 //# sourceMappingURL=index.d.ts.map

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,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,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,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -14,5 +14,7 @@ export * from "./utils.js";
 export * from "./adapters/node.js";
 export * from "./adapters/fetch.js";
 export * from "./adapters/vercel.js";
+export { startServer, toNodeHandler, toFetchHandler } from "./adapters/standalone.js";
 export * from "./dev.js";
 export * from "./serve.js";
+export * from "./semantic/index.js";

package/dist/openapi.js

@@ -168,7 +168,6 @@ const normalizeInfo = (options) => {
     };
 };
 export const buildOpenApiDocument = (endpoints, options) => {
-    var _a;
     const document = {
         openapi: "3.1.0",
         info: normalizeInfo(options),
@@ -182,7 +181,7 @@ export const buildOpenApiDocument = (endpoints, options) => {
         }
         const path = endpoint.metadata.path || "/";
         const method = endpoint.method.toLowerCase();
-        const pathItem = ((_a = document.paths)[path] ?? (_a[path] = {}));
+        const pathItem = (document.paths[path] ??= {});
         const operation = toOperation(endpoint, "Response");
         if (endpoint.metadata.requiresAuth) {
             needsSecurityScheme = true;

package/dist/pipeline.d.ts.map

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

package/dist/pipeline.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { createTenantScope, warnTenantMisconfiguration } from './tenant.js';
+import { warnTenantMisconfiguration } from './tenant.js';
+import { applySemanticTenantRuntime } from './semantic/utils/tenant-runtime.js';
 import { generateRequestId } from './utils.js';
 import { buildOpenApiDocument } from './openapi.js';
 import { buildDocsHtml } from './docs-ui.js';
@@ -259,7 +260,7 @@ export const executeEndpoint = async (options) => {
                     durationMs: Date.now() - startedAt,
                     error: new Error(errorMessage),
                 });
-                return createErrorResponse(403, 'UNAUTHORIZED', errorMessage, {
+                return createErrorResponse(403, 'FORBIDDEN', errorMessage, {
                     reason: 'missing_tenant_context',
                     tenant_required: true,
                 }, { 'x-request-id': requestId });
@@ -268,26 +269,13 @@ export const executeEndpoint = async (options) => {
                 context.tenantId = tenantId;
                 const mode = activeTenantConfig.mode ?? 'manual';
                 const column = activeTenantConfig.column;
-                if (mode === 'auto-inject' && column) {
-                    const contextValues = context;
-                    for (const key of Object.keys(contextValues)) {
-                        const value = contextValues[key];
-                        if (value && typeof value === 'object' && 'table' in value && typeof value.table === 'function') {
-                            contextValues[key] = createTenantScope(value, {
-                                tenantId,
-                                column,
-                            });
-                        }
-                    }
-                }
-                else if (mode === 'manual') {
-                    warnTenantMisconfiguration({
-                        queryKey: endpoint.key,
-                        hasTenantConfig: true,
-                        hasTenantId: true,
-                        mode: 'manual',
-                    });
-                }
+                applySemanticTenantRuntime(context, {
+                    queryKey: endpoint.key,
+                    metadata: metadataWithAuth,
+                    tenantId,
+                    mode,
+                    column,
+                });
             }
             else if (!tenantRequired) {
                 warnTenantMisconfiguration({

package/dist/query-logger.js

@@ -12,9 +12,7 @@
  * logging, and analytics work with any query backend.
  */
 export class ServeQueryLogger {
-    constructor() {
-        this.listeners = new Set();
-    }
+    listeners = new Set();
     /**
      * Subscribe to query events.
      * @returns Unsubscribe function.

package/dist/rate-limit.js

@@ -1,6 +1,7 @@
 export class MemoryRateLimitStore {
-    constructor(cleanupIntervalMs = 60000) {
-        this.entries = new Map();
+    entries = new Map();
+    cleanupTimer;
+    constructor(cleanupIntervalMs = 60_000) {
         // Periodic cleanup of expired entries to prevent memory leaks
         this.cleanupTimer = setInterval(() => {
             const now = Date.now();
@@ -72,7 +73,7 @@ const defaultKeyExtractor = (ctx) => {
  * ```
  */
 export const rateLimit = (config = {}) => {
-    const windowMs = config.windowMs ?? 60000;
+    const windowMs = config.windowMs ?? 60_000;
     const max = config.max ?? 100;
     const keyBy = config.keyBy ?? defaultKeyExtractor;
     const store = config.store ?? new MemoryRateLimitStore();

package/dist/router.js

@@ -11,9 +11,10 @@ export const applyBasePath = (basePath, path) => {
     return combined.replace(/\/+/g, "/").replace(/\/$/, combined === "/" ? "/" : "");
 };
 export class ServeRouter {
+    basePath;
+    routes = [];
     constructor(basePath = "") {
         this.basePath = basePath;
-        this.routes = [];
     }
     list() {
         return [...this.routes];

package/dist/semantic/datasets/dataset-endpoint.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Converts a DatasetInstance into a standard ServeEndpoint for semantic queries.
+ *
+ * The generated endpoint is a POST handler that:
+ * - Accepts dimensions, measures, filters, orderBy, limit, offset, by
+ * - Validates requested dimensions/measures/filters against the dataset contract
+ * - Executes via QueryBuilderFactoryLike
+ * - Applies Serve-managed tenant filtering when configured
+ * - Returns { data } or { data, meta } based on headers
+ */
+import { z } from 'zod';
+import type { AuthContext, ServeEndpoint } from '../../types.js';
+import type { QueryBuilderFactoryLike } from '@hypequery/datasets';
+import { type DatasetEntry } from './utils/dataset-entry.js';
+export type { DatasetEntry } from './utils/dataset-entry.js';
+declare const datasetResultSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    meta: z.ZodOptional<z.ZodObject<{
+        timingMs: z.ZodOptional<z.ZodNumber>;
+        sql: z.ZodOptional<z.ZodString>;
+        tenant: z.ZodOptional<z.ZodString>;
+        rowCount: z.ZodOptional<z.ZodNumber>;
+        pagination: z.ZodOptional<z.ZodObject<{
+            limit: z.ZodNumber;
+            offset: z.ZodNumber;
+            hasMore: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }, {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    }, {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    data: Record<string, unknown>[];
+    meta?: {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    } | undefined;
+}, {
+    data: Record<string, unknown>[];
+    meta?: {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    } | undefined;
+}>;
+export declare function createDatasetEndpoint<TAuth extends AuthContext>(name: string, entry: DatasetEntry<TAuth>, builderFactory: QueryBuilderFactoryLike): ServeEndpoint<z.ZodTypeAny, typeof datasetResultSchema, any, TAuth, any>;
+//# sourceMappingURL=dataset-endpoint.d.ts.map

package/dist/semantic/datasets/dataset-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-endpoint.d.ts","sourceRoot":"","sources":["../../../src/semantic/datasets/dataset-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,WAAW,EAGX,aAAa,EAEd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAkB7D,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGvB,CAAC;AAMH,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,WAAW,EAC7D,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAC1B,cAAc,EAAE,uBAAuB,GACtC,aAAa,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,mBAAmB,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAoG1E"}

package/dist/semantic/datasets/dataset-endpoint.js

@@ -0,0 +1,121 @@
+/**
+ * Converts a DatasetInstance into a standard ServeEndpoint for semantic queries.
+ *
+ * The generated endpoint is a POST handler that:
+ * - Accepts dimensions, measures, filters, orderBy, limit, offset, by
+ * - Validates requested dimensions/measures/filters against the dataset contract
+ * - Executes via QueryBuilderFactoryLike
+ * - Applies Serve-managed tenant filtering when configured
+ * - Returns { data } or { data, meta } based on headers
+ */
+import { z } from 'zod';
+import { runDatasetQuery, validateDatasetQuery, } from '@hypequery/datasets/internal';
+import { ServeHttpError } from '../../errors.js';
+import { resolveSemanticExecutionRuntime, resolveSemanticQueryBuilder, } from '../query-builder-context.js';
+import { buildDatasetQueryDescription } from './utils/dataset-query-metadata.js';
+import { resolveDatasetEntry } from './utils/dataset-entry.js';
+import { buildDatasetInputSchema } from './utils/semantic-input-schema.js';
+// ---------------------------------------------------------------------------
+// Zod schemas for dataset query input / output
+// ---------------------------------------------------------------------------
+const datasetResultMetaSchema = z.object({
+    timingMs: z.number().optional(),
+    sql: z.string().optional(),
+    tenant: z.string().optional(),
+    rowCount: z.number().optional(),
+    pagination: z.object({
+        limit: z.number(),
+        offset: z.number(),
+        hasMore: z.boolean(),
+    }).optional(),
+}).optional();
+const datasetResultSchema = z.object({
+    data: z.array(z.record(z.unknown())),
+    meta: datasetResultMetaSchema,
+});
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createDatasetEndpoint(name, entry, builderFactory) {
+    const resolved = resolveDatasetEntry(entry);
+    const ds = resolved.dataset;
+    const effectiveMaxLimit = resolved.maxLimit ?? ds.limits?.maxResultSize ?? 1000;
+    // Build a schema whose dimension/measure/filter fields are enumerated from
+    // this dataset's contract, so OpenAPI/docs and clients see the valid fields.
+    const datasetQueryInputSchema = buildDatasetInputSchema(ds);
+    const metadata = {
+        path: '', // filled by router.register
+        method: 'POST',
+        name: name,
+        summary: `Query the "${name}" semantic dataset`,
+        description: buildDatasetQueryDescription(ds, effectiveMaxLimit),
+        tags: ['datasets'],
+        requiresAuth: resolved.auth !== null ? undefined : false,
+        requiredRoles: resolved.requiredRoles,
+        requiredScopes: resolved.requiredScopes,
+        cacheTtlMs: resolved.cache,
+        visibility: 'public',
+        custom: {
+            usesServeTenantRuntime: true,
+        },
+    };
+    const handler = async (ctx) => {
+        const semanticContext = ctx;
+        const input = ctx.input ?? {};
+        const start = Date.now();
+        const runtime = resolveSemanticExecutionRuntime(semanticContext);
+        // Validate
+        const query = {
+            dimensions: input.dimensions,
+            measures: input.measures,
+            filters: input.filters,
+            orderBy: input.orderBy,
+            limit: Math.min(input.limit ?? effectiveMaxLimit, effectiveMaxLimit),
+            offset: input.offset,
+            by: input.by,
+        };
+        const executionContext = runtime ? { runtime } : undefined;
+        const validation = validateDatasetQuery(ds, query, executionContext);
+        if (!validation.valid) {
+            throw new ServeHttpError(400, 'VALIDATION_ERROR', validation.errors.join('; '));
+        }
+        // Build query
+        const runtimeBuilderFactory = resolveSemanticQueryBuilder(semanticContext, builderFactory);
+        if (ctx.tenantId) {
+            if (!runtime?.tenant || !ds.tenantKey) {
+                throw new ServeHttpError(500, 'INTERNAL_SERVER_ERROR', `Dataset endpoint "${name}" requires dataset tenantKey and serve tenant runtime when tenant isolation is enabled.`);
+            }
+        }
+        const result = await runDatasetQuery(ds, query, {
+            builderFactory: runtimeBuilderFactory,
+            context: executionContext,
+        });
+        const timingMs = Date.now() - start;
+        // Meta — opt in via the `includeMeta` input field or the x-include-meta header.
+        const includeMeta = input.includeMeta === true
+            || ctx.request?.headers?.['x-include-meta'] === 'true';
+        return {
+            data: result.data,
+            meta: includeMeta ? {
+                ...(result.meta ?? {}),
+                timingMs,
+            } : undefined,
+        };
+    };
+    return {
+        key: name,
+        method: 'POST',
+        inputSchema: datasetQueryInputSchema,
+        outputSchema: datasetResultSchema,
+        handler,
+        query: undefined,
+        middlewares: (resolved.middlewares ?? []),
+        auth: resolved.auth ?? null,
+        tenant: resolved.tenant,
+        metadata,
+        cacheTtlMs: resolved.cache ?? null,
+        defaultHeaders: undefined,
+        requiredRoles: resolved.requiredRoles,
+        requiredScopes: resolved.requiredScopes,
+    };
+}

package/dist/semantic/datasets/index.d.ts

@@ -0,0 +1,6 @@
+export { dataset, dimension, measure, belongsTo, hasMany, hasOne, sum, count, countDistinct, avg, min, max, divide, multiply, subtract, add, nullIfZero, coalesce, round, floor, ceil, eq, neq, gt, gte, lt, lte, inList, notInList, between, like, asc, desc, filter, order, createDatasetRegistry, } from '@hypequery/datasets';
+export type { FieldType, DimensionType, DimensionOptions, DimensionDefinition, MeasureOptions, MeasureDefinition, InferDimensionType, RelationshipKind, RelationshipDefinition, AggregationType, MeasureAggregation, AggregationSpec, FormulaExpr, DerivedMetricSpec, TimeGrain, MetricRef, BaseMetricRef, DerivedMetricRef, GrainedMetricRef, MetricContract, MetricFilter, MetricOrderBy, MetricQuery, DatasetQuery, MetricResultMeta, MetricResult, DatasetQueryResult, MetricHandle, ExecutionContext, SemanticExecutionRuntime, SemanticTenantRuntime, SemanticFilterDefinition, SemanticFiltersDefinition, DatasetConfig, DatasetLimits, DatasetInstance, BaseMetricConfig, DerivedMetricConfig, DatasetRegistryInstance, DatasetFieldNames, } from '@hypequery/datasets';
+export { createMetricEndpoint } from './metric-endpoint.js';
+export { createDatasetEndpoint } from './dataset-endpoint.js';
+export type { DatasetEntry } from './dataset-endpoint.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/semantic/datasets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/semantic/datasets/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,SAAS,EACT,OAAO,EACP,SAAS,EACT,OAAO,EACP,MAAM,EACN,GAAG,EACH,KAAK,EACL,aAAa,EACb,GAAG,EACH,GAAG,EACH,GAAG,EACH,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,GAAG,EACH,UAAU,EACV,QAAQ,EACR,KAAK,EACL,KAAK,EACL,IAAI,EACJ,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,MAAM,EACN,SAAS,EACT,OAAO,EACP,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,MAAM,EACN,KAAK,EACL,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/semantic/datasets/index.js

@@ -0,0 +1,5 @@
+// Re-export public datasets APIs for convenience
+export { dataset, dimension, measure, belongsTo, hasMany, hasOne, sum, count, countDistinct, avg, min, max, divide, multiply, subtract, add, nullIfZero, coalesce, round, floor, ceil, eq, neq, gt, gte, lt, lte, inList, notInList, between, like, asc, desc, filter, order, createDatasetRegistry, } from '@hypequery/datasets';
+// Serve-specific endpoint integration
+export { createMetricEndpoint } from './metric-endpoint.js';
+export { createDatasetEndpoint } from './dataset-endpoint.js';

package/dist/semantic/datasets/metric-endpoint.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Converts a MetricRef into a standard ServeEndpoint.
+ *
+ * The generated endpoint is a POST handler that:
+ * - Validates dimensions/filters against the metric's contract
+ * - Calls DatasetClient.execute() with the parsed query + tenant context
+ * - Returns { data } or { data, meta } based on headers
+ */
+import { z } from 'zod';
+import type { AuthContext, MetricEntry, ServeEndpoint } from '../../types.js';
+import type { DatasetClient, QueryBuilderFactoryLike } from '@hypequery/datasets';
+declare const metricResultSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    meta: z.ZodOptional<z.ZodObject<{
+        timingMs: z.ZodOptional<z.ZodNumber>;
+        sql: z.ZodOptional<z.ZodString>;
+        tenant: z.ZodOptional<z.ZodString>;
+        rowCount: z.ZodOptional<z.ZodNumber>;
+        pagination: z.ZodOptional<z.ZodObject<{
+            limit: z.ZodNumber;
+            offset: z.ZodNumber;
+            hasMore: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }, {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    }, {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    data: Record<string, unknown>[];
+    meta?: {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    } | undefined;
+}, {
+    data: Record<string, unknown>[];
+    meta?: {
+        tenant?: string | undefined;
+        timingMs?: number | undefined;
+        sql?: string | undefined;
+        rowCount?: number | undefined;
+        pagination?: {
+            limit: number;
+            offset: number;
+            hasMore: boolean;
+        } | undefined;
+    } | undefined;
+}>;
+export declare function createMetricEndpoint<TAuth extends AuthContext>(name: string, entry: MetricEntry<TAuth>, analytics: DatasetClient, defaultBuilderFactory: QueryBuilderFactoryLike): ServeEndpoint<z.ZodTypeAny, typeof metricResultSchema, any, TAuth, any>;
+export {};
+//# sourceMappingURL=metric-endpoint.d.ts.map

package/dist/semantic/datasets/metric-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-endpoint.d.ts","sourceRoot":"","sources":["../../../src/semantic/datasets/metric-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,WAAW,EAIX,WAAW,EACX,aAAa,EAGd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAsB,aAAa,EAAgC,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAwBpI,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGtB,CAAC;AAoDH,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,WAAW,EAC5D,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,EACzB,SAAS,EAAE,aAAa,EACxB,qBAAqB,EAAE,uBAAuB,GAC7C,aAAa,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,kBAAkB,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CA4GzE"}