@d-dash/core 0.1.0

package/dist/execution.js

@@ -0,0 +1,210 @@
+import { resolveWidgetTimeRange, } from "./runtime.js";
+/** Executes datasource query for a resolved widget request. */
+export async function executeWidgetQuery(registry, request) {
+    const adapter = registry.requireDatasource(request.datasourceId);
+    if (request.query.filters &&
+        adapter.capabilities?.supportsAdHocFilters === false) {
+        throw new CapabilityMismatchException("Datasource adapter does not support ad-hoc filters.", {
+            datasourceId: request.datasourceId,
+            widgetId: request.widgetId,
+        });
+    }
+    const queryRequest = {
+        metric: request.query.metric,
+        timeRange: request.resolvedTimeRange,
+        filters: request.query.filters,
+    };
+    const result = await adapter.query(queryRequest, request.context);
+    assertDatasourceQueryResult(result, request.datasourceId, request.widgetId);
+    return result;
+}
+/** Executes visualization render for a resolved widget request and frames. */
+export async function executeWidgetRender(registry, input) {
+    const adapter = registry.requireVisualization(input.request.visualization.type);
+    assertVisualizationCapability(input.request.visualization.type, adapter.capabilities);
+    const renderRequest = {
+        kind: input.request.visualization.type,
+        frames: input.frames,
+        options: input.request.options,
+        context: input.request.context,
+    };
+    await adapter.render(renderRequest, input.target);
+}
+/** Executes full widget flow: build request, query datasource, and render when data exists. */
+export async function executeWidget(input) {
+    const request = buildWidgetExecutionRequest({
+        dashboardId: input.dashboardId,
+        widget: input.widget,
+        dashboardTimeRange: input.dashboardTimeRange,
+        context: input.context,
+        now: input.now,
+    });
+    const result = await executeWidgetQuery(input.registry, request);
+    if (result.status === "error") {
+        return result;
+    }
+    await executeWidgetRender(input.registry, {
+        request,
+        frames: result.frames,
+        target: input.target,
+    });
+    return result;
+}
+/** Builds a resolved widget execution request from persisted widget and runtime context. */
+export function buildWidgetExecutionRequest(input) {
+    const resolvedTimeRange = resolveWidgetTimeRange(input.widget.timeRange, input.dashboardTimeRange, { now: input.now });
+    return {
+        dashboardId: input.dashboardId,
+        widgetId: input.widget.id,
+        datasourceId: input.widget.datasource,
+        query: input.widget.query,
+        visualization: input.widget.visualization,
+        resolvedTimeRange,
+        options: input.widget.options,
+        context: input.context,
+    };
+}
+class DatasourceQueryException extends Error {
+    code = "DATASOURCE_QUERY_FAILED";
+    details;
+    retriable = true;
+    constructor(message, details) {
+        super(message);
+        this.name = "DatasourceQueryException";
+        this.details = details;
+    }
+}
+function assertDatasourceQueryResult(result, datasourceId, widgetId) {
+    if (result.status !== "success" &&
+        result.status !== "partial" &&
+        result.status !== "error") {
+        throw new DatasourceQueryException("Datasource returned an invalid status.", {
+            datasourceId,
+            widgetId,
+            status: String(result.status),
+        });
+    }
+    if (!Array.isArray(result.frames)) {
+        throw new DatasourceQueryException("Datasource result frames must be an array.", {
+            datasourceId,
+            widgetId,
+            status: result.status,
+        });
+    }
+    // Validate frame payload at runtime to guard adapters crossing package boundaries.
+    for (let i = 0; i < result.frames.length; i += 1) {
+        const frame = result.frames[i];
+        if (!Array.isArray(frame.fields)) {
+            throw new DatasourceQueryException("DataFrame.fields must be an array.", {
+                datasourceId,
+                widgetId,
+                frameIndex: i,
+            });
+        }
+        for (let j = 0; j < frame.fields.length; j += 1) {
+            const field = frame.fields[j];
+            if (typeof field.name !== "string" || field.name.trim().length === 0) {
+                throw new DatasourceQueryException("DataField.name must be a non-empty string.", {
+                    datasourceId,
+                    widgetId,
+                    frameIndex: i,
+                    fieldIndex: j,
+                });
+            }
+            if (field.type !== "time" &&
+                field.type !== "number" &&
+                field.type !== "string" &&
+                field.type !== "boolean") {
+                throw new DatasourceQueryException("DataField.type is invalid.", {
+                    datasourceId,
+                    widgetId,
+                    frameIndex: i,
+                    fieldIndex: j,
+                    type: String(field.type),
+                });
+            }
+            if (!Array.isArray(field.values)) {
+                throw new DatasourceQueryException("DataField.values must be an array.", {
+                    datasourceId,
+                    widgetId,
+                    frameIndex: i,
+                    fieldIndex: j,
+                });
+            }
+            for (let k = 0; k < field.values.length; k += 1) {
+                if (!isValidScalarForType(field.values[k], field.type)) {
+                    throw new DatasourceQueryException("DataField.values contains invalid scalar value.", {
+                        datasourceId,
+                        widgetId,
+                        frameIndex: i,
+                        fieldIndex: j,
+                        valueIndex: k,
+                        expectedType: field.type,
+                    });
+                }
+            }
+        }
+    }
+    if ((result.status === "partial" || result.status === "error") &&
+        !isDDashError(result.error)) {
+        throw new DatasourceQueryException("Datasource partial/error result must include a structured error.", {
+            datasourceId,
+            widgetId,
+            status: result.status,
+        });
+    }
+}
+function isValidScalarForType(value, type) {
+    if (value === null) {
+        return true;
+    }
+    if (type === "string") {
+        return typeof value === "string";
+    }
+    if (type === "boolean") {
+        return typeof value === "boolean";
+    }
+    if (type === "number" || type === "time") {
+        return typeof value === "number" && Number.isFinite(value);
+    }
+    return false;
+}
+function isDDashError(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const maybeError = value;
+    return (typeof maybeError.code === "string" &&
+        typeof maybeError.message === "string");
+}
+class CapabilityMismatchException extends Error {
+    code = "CAPABILITY_MISMATCH";
+    details;
+    retriable = false;
+    constructor(message, details) {
+        super(message);
+        this.name = "CapabilityMismatchException";
+        this.details = details;
+    }
+}
+function assertVisualizationCapability(kind, capabilities) {
+    if (!capabilities) {
+        return;
+    }
+    if (kind === "timeseries" && capabilities.supportsTimeSeries === false) {
+        throw new CapabilityMismatchException("Visualization adapter does not support timeseries widgets.", { kind });
+    }
+    if (kind === "stat" && capabilities.supportsStat === false) {
+        throw new CapabilityMismatchException("Visualization adapter does not support stat widgets.", { kind });
+    }
+    if (kind === "table" && capabilities.supportsTable === false) {
+        throw new CapabilityMismatchException("Visualization adapter does not support table widgets.", { kind });
+    }
+    if (kind === "text" && capabilities.supportsTextWidget === false) {
+        throw new CapabilityMismatchException("Visualization adapter does not support text widgets.", { kind });
+    }
+    if (kind === "html" && capabilities.supportsHtmlWidget === false) {
+        throw new CapabilityMismatchException("Visualization adapter does not support html widgets.", { kind });
+    }
+}
+//# sourceMappingURL=execution.js.map

package/dist/execution.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { JsonArray, JsonObject, JsonPrimitive, JsonValue } from "./json";
+export type { DDashError, DDashErrorCode } from "./errors";
+export type { DashboardMeta, LayoutItem, MetricDefinition, PersistedDashboard, PersistedTimeRange, PersistedWidget, SchemaVersion, VisualizationKind, WidgetDisplay, WidgetQuery, WidgetVisualization, } from "./schema";
+export type { MigrationResult, VersionedPersistedDashboard, } from "./migrations";
+export { LATEST_SCHEMA_VERSION, migratePersistedDashboard, } from "./migrations.js";
+export type { ResolvedTimeRange, ResolvedWidgetExecutionRequest, RuntimeContext, RuntimeWidget, TimeRangeResolveError, TimeResolveOptions, } from "./runtime";
+export { resolveDashboardTimeRange, resolveWidgetTimeRange, } from "./runtime.js";
+export type { BuildWidgetExecutionRequestInput, ExecuteWidgetInput, ExecuteWidgetRenderInput, } from "./execution";
+export { buildWidgetExecutionRequest, executeWidget, executeWidgetQuery, executeWidgetRender, } from "./execution.js";
+export type { DataField, DataFieldType, DataFrame, DatasourceAdapter, DatasourceCapabilities, DatasourceQueryError, DatasourceQueryPartial, DatasourceQueryRequest, DatasourceQueryResult, DatasourceQuerySuccess, GridAdapter, GridCapabilities, GridLayoutChange, GridLayoutChangeHandler, ScalarValue, VisualizationAdapter, VisualizationCapabilities, VisualizationRenderRequest, } from "./adapters";
+export type { AdapterRegistry, RegistryDuplicatePolicy, RegistryError, RegistryOptions, } from "./registry";
+export { createAdapterRegistry } from "./registry.js";
+export type { DashboardValidationOptions, ValidationIssue, ValidationIssueCode, ValidationResult, } from "./validation";
+export { toSchemaValidationError, validatePersistedDashboard, } from "./validation.js";
+export type { ApplyDashboardLayoutInput, BindLayoutResizeInput, DashboardPreflightResult, DashboardRuntimeError, DashboardRuntime, DashboardRuntimeOptions, DashboardSession, ExecuteAllWidgetsInput, ExecuteSessionWidgetInput, ExecuteWidgetResult, RuntimeEvent, RuntimeEventHandler, } from "./dashboard-runtime";
+export { createDashboardRuntime } from "./dashboard-runtime.js";
+//# 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":"AAAA,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9E,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3D,YAAY,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,eAAe,EACf,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,EACjB,8BAA8B,EAC9B,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gCAAgC,EAChC,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,YAAY,EACV,0BAA0B,EAC1B,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { LATEST_SCHEMA_VERSION, migratePersistedDashboard, } from "./migrations.js";
+export { resolveDashboardTimeRange, resolveWidgetTimeRange, } from "./runtime.js";
+export { buildWidgetExecutionRequest, executeWidget, executeWidgetQuery, executeWidgetRender, } from "./execution.js";
+export { createAdapterRegistry } from "./registry.js";
+export { toSchemaValidationError, validatePersistedDashboard, } from "./validation.js";
+export { createDashboardRuntime } from "./dashboard-runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAWzB,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAQtB,OAAO,EACL,2BAA2B,EAC3B,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AA8BxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAStD,OAAO,EACL,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAiBzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,11 @@
+/** Primitive JSON scalar values. */
+export type JsonPrimitive = string | number | boolean | null;
+/** Any JSON value supported by persisted contracts. */
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+/** JSON object with recursively typed JSON values. */
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+/** JSON array with recursively typed JSON values. */
+export type JsonArray = JsonValue[];
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/D,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC"}

package/dist/json.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":""}

package/dist/migrations.d.ts

@@ -0,0 +1,21 @@
+import type { PersistedDashboard, SchemaVersion } from "./schema";
+/** Generic persisted dashboard shape that allows unsupported schema versions. */
+export type VersionedPersistedDashboard = Omit<PersistedDashboard, "schemaVersion"> & {
+    schemaVersion: number;
+};
+/** Result returned by schema migration utilities. */
+export type MigrationResult = {
+    dashboard: PersistedDashboard;
+    fromVersion: number;
+    toVersion: SchemaVersion;
+    migrated: boolean;
+};
+/** Current latest supported schema version for persisted dashboards. */
+export declare const LATEST_SCHEMA_VERSION: SchemaVersion;
+/**
+ * Migrates a versioned persisted dashboard to the latest schema version.
+ *
+ * Currently only schemaVersion=1 is supported and is treated as a no-op.
+ */
+export declare function migratePersistedDashboard(dashboard: VersionedPersistedDashboard): MigrationResult;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAElE,iFAAiF;AACjF,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,kBAAkB,EAClB,eAAe,CAChB,GAAG;IACF,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,EAAE,aAAiB,CAAC;AAatD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,2BAA2B,GACrC,eAAe,CAWjB"}

package/dist/migrations.js

@@ -0,0 +1,26 @@
+/** Current latest supported schema version for persisted dashboards. */
+export const LATEST_SCHEMA_VERSION = 1;
+class SchemaMigrationException extends Error {
+    code = "SCHEMA_UNSUPPORTED_VERSION";
+    constructor(version) {
+        super(`Unsupported schema version '${version}'. Supported versions: [${LATEST_SCHEMA_VERSION}].`);
+        this.name = "SchemaMigrationException";
+    }
+}
+/**
+ * Migrates a versioned persisted dashboard to the latest schema version.
+ *
+ * Currently only schemaVersion=1 is supported and is treated as a no-op.
+ */
+export function migratePersistedDashboard(dashboard) {
+    if (dashboard.schemaVersion !== LATEST_SCHEMA_VERSION) {
+        throw new SchemaMigrationException(dashboard.schemaVersion);
+    }
+    return {
+        dashboard: dashboard,
+        fromVersion: dashboard.schemaVersion,
+        toVersion: LATEST_SCHEMA_VERSION,
+        migrated: false,
+    };
+}
+//# sourceMappingURL=migrations.js.map

package/dist/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAkBA,wEAAwE;AACxE,MAAM,CAAC,MAAM,qBAAqB,GAAkB,CAAC,CAAC;AAEtD,MAAM,wBAAyB,SAAQ,KAAK;IACjC,IAAI,GAAG,4BAAqC,CAAC;IAEtD,YAAY,OAAe;QACzB,KAAK,CACH,+BAA+B,OAAO,2BAA2B,qBAAqB,IAAI,CAC3F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAsC;IAEtC,IAAI,SAAS,CAAC,aAAa,KAAK,qBAAqB,EAAE,CAAC;QACtD,MAAM,IAAI,wBAAwB,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACL,SAAS,EAAE,SAA+B;QAC1C,WAAW,EAAE,SAAS,CAAC,aAAa;QACpC,SAAS,EAAE,qBAAqB;QAChC,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,30 @@
+import type { DatasourceAdapter, GridAdapter, VisualizationAdapter } from "./adapters";
+import type { DDashError } from "./errors";
+import type { VisualizationKind } from "./schema";
+/** Registry behavior for handling duplicate adapter identifiers. */
+export type RegistryDuplicatePolicy = "reject" | "replace";
+/** Configuration options for creating an adapter registry. */
+export type RegistryOptions = {
+    duplicatePolicy?: RegistryDuplicatePolicy;
+};
+/** Runtime registry contract for datasource, visualization, and grid adapters. */
+export interface AdapterRegistry {
+    registerDatasource(adapter: DatasourceAdapter): void;
+    registerVisualization(adapter: VisualizationAdapter): void;
+    registerGrid(adapter: GridAdapter): void;
+    listDatasourceIds(): string[];
+    listVisualizationKinds(): VisualizationKind[];
+    listGridIds(): string[];
+    getDatasource(id: string): DatasourceAdapter | undefined;
+    getVisualization(kind: VisualizationKind): VisualizationAdapter | undefined;
+    getGrid(id: string): GridAdapter | undefined;
+    requireDatasource(id: string): DatasourceAdapter;
+    requireVisualization(kind: VisualizationKind): VisualizationAdapter;
+    requireGrid(id: string): GridAdapter;
+}
+/** Registry-level structured error envelope. */
+export type RegistryError = DDashError & {
+    code: "REGISTRY_DUPLICATE_ADAPTER" | "REGISTRY_ADAPTER_NOT_FOUND";
+};
+export declare function createAdapterRegistry(options?: RegistryOptions): AdapterRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG;IAC5B,eAAe,CAAC,EAAE,uBAAuB,CAAC;CAC3C,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrD,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3D,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAEzC,iBAAiB,IAAI,MAAM,EAAE,CAAC;IAC9B,sBAAsB,IAAI,iBAAiB,EAAE,CAAC;IAC9C,WAAW,IAAI,MAAM,EAAE,CAAC;IAExB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACzD,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,SAAS,CAAC;IAC5E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAE7C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACjD,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;IACpE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC;CACtC;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IACvC,IAAI,EAAE,4BAA4B,GAAG,4BAA4B,CAAC;CACnE,CAAC;AAoBF,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,eAAoB,GAC5B,eAAe,CAmFjB"}

package/dist/registry.js

@@ -0,0 +1,78 @@
+class RegistryException extends Error {
+    code;
+    details;
+    retriable;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "RegistryException";
+        this.code = code;
+        this.details = details;
+        this.retriable = false;
+    }
+}
+export function createAdapterRegistry(options = {}) {
+    const duplicatePolicy = options.duplicatePolicy ?? "reject";
+    const datasources = new Map();
+    const visualizations = new Map();
+    const grids = new Map();
+    return {
+        registerDatasource(adapter) {
+            registerWithPolicy(datasources, adapter.id, adapter, duplicatePolicy, "datasource");
+        },
+        registerVisualization(adapter) {
+            registerWithPolicy(visualizations, adapter.type, adapter, duplicatePolicy, "visualization");
+        },
+        registerGrid(adapter) {
+            registerWithPolicy(grids, adapter.id, adapter, duplicatePolicy, "grid");
+        },
+        listDatasourceIds() {
+            return Array.from(datasources.keys());
+        },
+        listVisualizationKinds() {
+            return Array.from(visualizations.keys());
+        },
+        listGridIds() {
+            return Array.from(grids.keys());
+        },
+        getDatasource(id) {
+            return datasources.get(id);
+        },
+        getVisualization(kind) {
+            return visualizations.get(kind);
+        },
+        getGrid(id) {
+            return grids.get(id);
+        },
+        requireDatasource(id) {
+            const adapter = datasources.get(id);
+            if (!adapter) {
+                throw notFoundError("datasource", id);
+            }
+            return adapter;
+        },
+        requireVisualization(kind) {
+            const adapter = visualizations.get(kind);
+            if (!adapter) {
+                throw notFoundError("visualization", kind);
+            }
+            return adapter;
+        },
+        requireGrid(id) {
+            const adapter = grids.get(id);
+            if (!adapter) {
+                throw notFoundError("grid", id);
+            }
+            return adapter;
+        },
+    };
+}
+function registerWithPolicy(map, key, value, policy, type) {
+    if (map.has(key) && policy === "reject") {
+        throw new RegistryException("REGISTRY_DUPLICATE_ADAPTER", `Duplicate ${type} adapter registration for '${key}'.`, { type, id: key });
+    }
+    map.set(key, value);
+}
+function notFoundError(type, id) {
+    return new RegistryException("REGISTRY_ADAPTER_NOT_FOUND", `No registered ${type} adapter found for '${id}'.`, { type, id });
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,68 @@
+import type { JsonObject } from "./json";
+import type { PersistedWidget, WidgetQuery, WidgetVisualization } from "./schema";
+/** Fully resolved absolute time range used for execution. */
+export type ResolvedTimeRange = {
+    from: number;
+    to: number;
+    source: "dashboard" | "widget";
+};
+/** Runtime context forwarded through query and render paths. */
+export type RuntimeContext = {
+    traceId: string;
+    featureFlags?: Record<string, boolean>;
+    cancellation?: {
+        isCancelled: boolean;
+    };
+};
+/** Execution-ready widget request built from persisted and resolved contracts. */
+export type ResolvedWidgetExecutionRequest = {
+    dashboardId: string;
+    widgetId: string;
+    datasourceId: string;
+    query: WidgetQuery;
+    visualization: WidgetVisualization;
+    resolvedTimeRange: ResolvedTimeRange;
+    options?: JsonObject;
+    context: RuntimeContext;
+};
+/** Runtime widget view model with effective time range. */
+export type RuntimeWidget = PersistedWidget & {
+    effectiveTimeRange: ResolvedTimeRange;
+};
+/** Time-range resolution error contract. */
+export type TimeRangeResolveError = {
+    code: "TIME_RANGE_RESOLVE_FAILED";
+    message: string;
+    details?: JsonObject;
+    retriable?: boolean;
+};
+/** Optional controls for time-range resolution. */
+export type TimeResolveOptions = {
+    now?: number;
+};
+/**
+ * Resolves dashboard-level time range input into absolute epoch millisecond bounds.
+ */
+export declare function resolveDashboardTimeRange(input: {
+    type: "relative";
+    value: string;
+} | {
+    type: "absolute";
+    from: number;
+    to: number;
+}, options?: TimeResolveOptions): ResolvedTimeRange;
+/**
+ * Resolves widget-level time range by honoring inherit/relative/absolute modes.
+ * When `inherit` (or undefined), the dashboard-resolved range is returned.
+ */
+export declare function resolveWidgetTimeRange(widgetTimeRange: {
+    type: "inherit";
+} | {
+    type: "relative";
+    value: string;
+} | {
+    type: "absolute";
+    from: number;
+    to: number;
+} | undefined, dashboardResolvedTimeRange: ResolvedTimeRange, options?: TimeResolveOptions): ResolvedTimeRange;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;CAChC,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,aAAa,EAAE,mBAAmB,CAAC;IACnC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG;IAC5C,kBAAkB,EAAE,iBAAiB,CAAC;CACvC,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAcF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CA8BnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EACX;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C,SAAS,EACb,0BAA0B,EAAE,iBAAiB,EAC7C,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAkCnB"}

package/dist/runtime.js

@@ -0,0 +1,102 @@
+class TimeRangeResolveException extends Error {
+    code = "TIME_RANGE_RESOLVE_FAILED";
+    details;
+    retriable = false;
+    constructor(message, details) {
+        super(message);
+        this.name = "TimeRangeResolveException";
+        this.details = details;
+    }
+}
+/**
+ * Resolves dashboard-level time range input into absolute epoch millisecond bounds.
+ */
+export function resolveDashboardTimeRange(input, options = {}) {
+    const now = Number.isFinite(options.now) ? Number(options.now) : Date.now();
+    if (input.type === "absolute") {
+        if (!Number.isFinite(input.from) ||
+            !Number.isFinite(input.to) ||
+            input.from > input.to) {
+            throw new TimeRangeResolveException("Invalid absolute dashboard time range.", {
+                type: input.type,
+            });
+        }
+        return {
+            from: input.from,
+            to: input.to,
+            source: "dashboard",
+        };
+    }
+    const parsed = parseRelativeRange(input.value, now);
+    return {
+        from: parsed.from,
+        to: parsed.to,
+        source: "dashboard",
+    };
+}
+/**
+ * Resolves widget-level time range by honoring inherit/relative/absolute modes.
+ * When `inherit` (or undefined), the dashboard-resolved range is returned.
+ */
+export function resolveWidgetTimeRange(widgetTimeRange, dashboardResolvedTimeRange, options = {}) {
+    if (!widgetTimeRange || widgetTimeRange.type === "inherit") {
+        return dashboardResolvedTimeRange;
+    }
+    const now = Number.isFinite(options.now) ? Number(options.now) : Date.now();
+    if (widgetTimeRange.type === "absolute") {
+        if (!Number.isFinite(widgetTimeRange.from) ||
+            !Number.isFinite(widgetTimeRange.to) ||
+            widgetTimeRange.from > widgetTimeRange.to) {
+            throw new TimeRangeResolveException("Invalid absolute widget time range.", {
+                type: widgetTimeRange.type,
+            });
+        }
+        return {
+            from: widgetTimeRange.from,
+            to: widgetTimeRange.to,
+            source: "widget",
+        };
+    }
+    const parsed = parseRelativeRange(widgetTimeRange.value, now);
+    return {
+        from: parsed.from,
+        to: parsed.to,
+        source: "widget",
+    };
+}
+function parseRelativeRange(expression, now) {
+    const trimmed = expression.trim();
+    const match = /^now-(\d+)([smhdw])$/i.exec(trimmed);
+    if (!match) {
+        throw new TimeRangeResolveException("Invalid relative time range expression. Expected format: now-<value><unit>.", { expression: trimmed });
+    }
+    const amount = Number(match[1]);
+    const unit = match[2].toLowerCase();
+    if (!Number.isInteger(amount) || amount <= 0) {
+        throw new TimeRangeResolveException("Relative time range amount must be a positive integer.", {
+            expression: trimmed,
+        });
+    }
+    const unitMs = unitToMs(unit);
+    const from = now - amount * unitMs;
+    return { from, to: now };
+}
+function unitToMs(unit) {
+    switch (unit) {
+        case "s":
+            return 1000;
+        case "m":
+            return 60 * 1000;
+        case "h":
+            return 60 * 60 * 1000;
+        case "d":
+            return 24 * 60 * 60 * 1000;
+        case "w":
+            return 7 * 24 * 60 * 60 * 1000;
+        default:
+            throw new TimeRangeResolveException("Unsupported relative time range unit.", {
+                unit,
+            });
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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