react-semaphor 0.1.324 → 0.1.326

package/dist/types/dashboard.d.ts

@@ -812,6 +812,7 @@ declare interface DataModelEntityReference extends DatabaseEntityReference {
 declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
+    table?: string | null;
     datamodelId?: string | null;
     sql?: string | null;
     id: string;
@@ -2500,7 +2501,11 @@ export declare type TDataColumn = {
     label?: string;
     description?: string;
     qualifiedFieldName?: string;
-    role?: 'metric';
+    qualifiedEntityName?: string;
+    entityId?: string;
+    entityName?: string;
+    entityType?: EntityType;
+    role?: 'groupby' | 'metric' | 'sortby' | 'pivotby' | 'detail';
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
     format?: FormatSpec;

package/dist/types/data-app-sdk.d.ts

@@ -0,0 +1,378 @@
+import { JSX } from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+export declare function createSemaphorDataAppExecutor(): SemaphorDataAppExecutor;
+
+export declare function hasSemaphorInputValue(value: unknown): boolean;
+
+export declare function normalizeSemaphorInputOptions(options?: Array<{
+    label: string;
+    value: SemaphorDataAppOptionValue;
+} | SemaphorDataAppOptionValue>): {
+    label: string;
+    value: SemaphorDataAppOptionValue;
+}[];
+
+declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
+
+export declare type SemaphorDataAppControlInputSpec<TValue extends SemaphorDataAppInputValue = SemaphorDataAppInputValue> = SemaphorDataAppInputBase<TValue> & {
+    kind: 'control';
+    role: SemaphorDataAppControlRole;
+};
+
+export declare type SemaphorDataAppControlRole = 'grain' | 'metric' | 'dimension' | 'aggregation' | 'sqlParam';
+
+export declare type SemaphorDataAppExecutor = {
+    executeMetric(intent: SemaphorMetricIntent, context: SemaphorDataAppExecutorContext): Promise<SemaphorDataAppMetricData>;
+    executeRecords<TRecord extends Record<string, unknown> = Record<string, unknown>>(intent: SemaphorRecordsIntent, context: SemaphorDataAppExecutorContext): Promise<SemaphorDataAppRecordsData<TRecord>>;
+    executeInputOptions(intent: Extract<SemaphorAnalyticsIntent, {
+        kind: 'inputOptions';
+    }>, context: SemaphorDataAppExecutorContext): Promise<SemaphorDataAppInputOptionsData>;
+};
+
+export declare type SemaphorDataAppExecutorContext = {
+    token?: string;
+    apiBaseUrl?: string;
+    activeInputs?: SemaphorDataAppInputSnapshot[];
+};
+
+export declare type SemaphorDataAppFieldSpec = string | SemaphorFieldRef;
+
+export declare type SemaphorDataAppFilterInputSpec<TValue extends SemaphorDataAppInputValue = SemaphorDataAppInputValue> = SemaphorDataAppInputBase<TValue> & {
+    kind: 'filter';
+    field: SemaphorDataAppFieldSpec;
+    operator?: SemaphorInputOperator;
+    multi?: boolean;
+    source?: SemaphorSourceRef;
+};
+
+declare type SemaphorDataAppInputBase<TValue extends SemaphorDataAppInputValue> = {
+    id: string;
+    label?: string;
+    value?: TValue;
+    defaultValue?: TValue;
+    onValueChange?: (value: TValue | undefined) => void;
+    options?: Array<SemaphorDataAppInputOption | SemaphorDataAppOptionValue>;
+};
+
+export declare type SemaphorDataAppInputHandle<TValue extends SemaphorDataAppInputValue = SemaphorDataAppInputValue> = {
+    id: string;
+    kind: 'filter' | 'control';
+    label?: string;
+    field?: SemaphorFieldRef;
+    operator?: SemaphorInputOperator;
+    source?: SemaphorSourceRef;
+    controlRole?: SemaphorDataAppControlRole;
+    value: TValue | undefined;
+    options: SemaphorDataAppInputOption[];
+    isActive: boolean;
+    setValue(value: TValue | undefined): void;
+    clear(): void;
+    toAnalyticsInput(): SemaphorDataAppInputSnapshot<TValue>;
+};
+
+export declare type SemaphorDataAppInputOption = {
+    label: string;
+    value: SemaphorDataAppOptionValue;
+    count?: number;
+};
+
+export declare type SemaphorDataAppInputOptionsData = {
+    options: SemaphorDataAppInputOption[];
+};
+
+export declare type SemaphorDataAppInputOptionsResult = SemaphorDataAppQueryState & SemaphorDataAppInputOptionsData & {
+    id?: string;
+    intent?: Extract<SemaphorAnalyticsIntent, {
+        kind: 'inputOptions';
+    }>;
+};
+
+export declare type SemaphorDataAppInputOptionsSpec = SemaphorDataAppSourceSpec & {
+    id?: string;
+    label?: string;
+    field: SemaphorDataAppFieldSpec;
+    search?: string;
+    limit?: number;
+};
+
+export declare type SemaphorDataAppInputReference = SemaphorInputBinding | SemaphorDataAppInputSnapshot | SemaphorDataAppInputHandle;
+
+export declare type SemaphorDataAppInputSnapshot<TValue extends SemaphorDataAppInputValue = SemaphorDataAppInputValue> = SemaphorInputBinding & {
+    kind: 'filter' | 'control';
+    label?: string;
+    value?: TValue;
+    isActive: boolean;
+    operator?: SemaphorInputOperator;
+    source?: SemaphorSourceRef;
+    controlRole?: SemaphorDataAppControlRole;
+};
+
+export declare type SemaphorDataAppInputSpec<TValue extends SemaphorDataAppInputValue = SemaphorDataAppInputValue> = SemaphorDataAppFilterInputSpec<TValue> | SemaphorDataAppControlInputSpec<TValue>;
+
+export declare type SemaphorDataAppInputValue = SemaphorDataAppScalar | SemaphorDataAppScalar[];
+
+export declare type SemaphorDataAppMetricComparison = 'none' | 'previous_period' | 'same_period_last_year' | 'previous_year' | {
+    kind: 'previous_period' | 'previous_year' | 'target';
+    targetValue?: number;
+};
+
+export declare type SemaphorDataAppMetricData = {
+    value: number | string | null;
+    metrics?: Record<string, number | string | null>;
+    comparisonValue?: number | string | null;
+    delta?: number | null;
+    deltaPercent?: number | null;
+    records?: Array<Record<string, unknown>>;
+};
+
+export declare type SemaphorDataAppMetricResult = SemaphorDataAppQueryState & SemaphorDataAppMetricData & {
+    id?: string;
+    intent?: SemaphorMetricIntent;
+};
+
+export declare type SemaphorDataAppMetricSpec = SemaphorDataAppSourceSpec & {
+    id?: string;
+    label?: string;
+    metric: string;
+    metrics?: string[];
+    dateField?: SemaphorDataAppFieldSpec;
+    timeGrain?: SemaphorTimeGrain;
+    dimensions?: SemaphorDataAppFieldSpec[];
+    comparison?: SemaphorDataAppMetricComparison;
+    inputs?: SemaphorDataAppInputReference[];
+    limit?: number;
+};
+
+export declare type SemaphorDataAppNonEmptyArray<T> = [T, ...T[]];
+
+export declare type SemaphorDataAppOptionValue = string | number | boolean;
+
+export declare function SemaphorDataAppProvider({ token, apiBaseUrl, executor, children, }: SemaphorDataAppProviderProps): JSX.Element;
+
+export declare type SemaphorDataAppProviderProps = SemaphorDataAppExecutorContext & {
+    executor?: SemaphorDataAppExecutor;
+    children: ReactNode;
+};
+
+export declare type SemaphorDataAppQueryState = {
+    status: SemaphorDataAppQueryStatus;
+    isLoading: boolean;
+    error: Error | null;
+};
+
+export declare type SemaphorDataAppQueryStatus = 'idle' | 'loading' | 'success' | 'error';
+
+declare type SemaphorDataAppRecordsBaseSpec = SemaphorDataAppSourceSpec & {
+    id?: string;
+    label?: string;
+    dateField?: SemaphorDataAppFieldSpec;
+    timeGrain?: SemaphorTimeGrain;
+    orderBy?: SemaphorDataAppRecordsOrderBy;
+    inputs?: SemaphorDataAppInputReference[];
+    limit?: number;
+};
+
+export declare type SemaphorDataAppRecordsData<TRecord extends Record<string, unknown> = Record<string, unknown>> = {
+    records: TRecord[];
+    columns?: Array<{
+        name: string;
+        label?: string;
+        dataType?: SemaphorFieldRef['dataType'];
+        role?: SemaphorFieldRef['role'];
+    }>;
+    rowCount?: number;
+};
+
+export declare type SemaphorDataAppRecordsOrderBy = {
+    field: string;
+    direction: 'asc' | 'desc';
+};
+
+export declare type SemaphorDataAppRecordsResult<TRecord extends Record<string, unknown> = Record<string, unknown>> = SemaphorDataAppQueryState & SemaphorDataAppRecordsData<TRecord> & {
+    id?: string;
+    intent?: SemaphorRecordsIntent;
+};
+
+declare type SemaphorDataAppRecordsSelectorSpec = {
+    fields: SemaphorDataAppNonEmptyArray<SemaphorDataAppFieldSpec>;
+    dimensions?: SemaphorDataAppFieldSpec[];
+    measures?: string[];
+} | {
+    fields?: SemaphorDataAppFieldSpec[];
+    dimensions: SemaphorDataAppNonEmptyArray<SemaphorDataAppFieldSpec>;
+    measures?: string[];
+} | {
+    fields?: SemaphorDataAppFieldSpec[];
+    dimensions?: SemaphorDataAppFieldSpec[];
+    measures: SemaphorDataAppNonEmptyArray<string>;
+};
+
+export declare type SemaphorDataAppRecordsSpec = SemaphorDataAppRecordsBaseSpec & SemaphorDataAppRecordsSelectorSpec;
+
+export declare type SemaphorDataAppRuntime = SemaphorDataAppExecutorContext & {
+    executor?: SemaphorDataAppExecutor;
+};
+
+export declare type SemaphorDataAppScalar = string | number | boolean | null;
+
+export declare type SemaphorDataAppSourceSpec = {
+    source: SemaphorSourceRef;
+    domainId?: never;
+    dataset?: never;
+    datasetName?: never;
+    datasetId?: never;
+    connectionId?: never;
+} | {
+    source?: never;
+    domainId: string;
+    dataset?: string;
+    datasetName?: string;
+    datasetId?: string;
+    connectionId?: string;
+    sourceLabel?: string;
+};
+
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'snowflake' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+
+declare type SemaphorFieldRef = {
+    name: string;
+    label?: string;
+    role?: 'dimension' | 'measure' | 'date' | 'id' | 'unknown';
+    dataType?: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'unknown';
+};
+
+declare type SemaphorInputBinding = {
+    inputId: string;
+    field?: SemaphorFieldRef;
+};
+
+declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'between' | '>' | '>=' | '<' | '<=';
+
+declare type SemaphorInputOptionsIntent = {
+    kind: 'inputOptions';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
+    source: SemaphorSourceRef;
+    field: SemaphorFieldRef;
+    search?: string;
+    limit?: number;
+};
+
+declare type SemaphorMetricIntent = {
+    kind: 'metric';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    source: SemaphorSourceRef;
+    metric: string;
+    metrics?: string[];
+    label?: string;
+    dateField?: SemaphorFieldRef;
+    timeGrain?: SemaphorTimeGrain;
+    dimensions?: SemaphorFieldRef[];
+    comparison?: {
+        kind: 'previous_period' | 'previous_year' | 'target';
+        targetValue?: number;
+    };
+    inputs?: SemaphorInputBinding[];
+    limit?: number;
+};
+
+declare type SemaphorProtocolVersion = 1;
+
+declare type SemaphorRecordsIntent = {
+    kind: 'records';
+    version?: SemaphorProtocolVersion;
+    source: SemaphorSourceRef;
+    id?: string;
+    label?: string;
+    fields: SemaphorFieldRef[];
+    measures?: string[];
+    dateField?: SemaphorFieldRef;
+    timeGrain?: SemaphorTimeGrain;
+    limit?: number;
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    inputs?: SemaphorInputBinding[];
+};
+
+declare type SemaphorSourceRef = {
+    kind: 'semantic';
+    domainId: string;
+    datasetName: string;
+    datasetId?: string;
+    label?: string;
+    connectionId?: string;
+} | {
+    kind: 'physical';
+    connectionId: string;
+    tableName: string;
+    databaseName?: string;
+    schemaName?: string;
+    label?: string;
+    dialect?: SemaphorDialect;
+} | {
+    kind: 'sql';
+    connectionId: string;
+    sql: string;
+    dialect?: SemaphorDialect;
+    label?: string;
+};
+
+declare type SemaphorSqlIntent = {
+    kind: 'sql';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
+    source: Extract<SemaphorSourceRef, {
+        kind: 'sql' | 'physical';
+    }>;
+    sql?: string;
+    parameters?: Record<string, unknown>;
+    pythonCode?: string;
+    limit?: number;
+    rationale?: string;
+    fields?: SemaphorFieldRef[];
+    inputs?: SemaphorInputBinding[];
+};
+
+declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+
+export declare function toSemaphorActiveInputSnapshots(inputs: SemaphorDataAppInputReference[] | undefined): SemaphorDataAppInputSnapshot[];
+
+export declare function toSemaphorInputBinding(input: SemaphorDataAppInputReference): SemaphorInputBinding;
+
+export declare function toSemaphorInputBindings(inputs: SemaphorDataAppInputReference[] | undefined): SemaphorInputBinding[] | undefined;
+
+export declare function toSemaphorInputOptionsIntent(spec: SemaphorDataAppInputOptionsSpec): Extract<SemaphorAnalyticsIntent, {
+    kind: 'inputOptions';
+}>;
+
+export declare function toSemaphorInputSnapshots(inputs: SemaphorDataAppInputReference[] | undefined): SemaphorDataAppInputSnapshot[];
+
+export declare function toSemaphorInputSpec<TValue extends SemaphorDataAppInputValue = SemaphorDataAppInputValue>(spec: SemaphorDataAppInputSpec<TValue>): SemaphorInputBinding & {
+    kind: SemaphorDataAppInputSpec['kind'];
+    label?: string;
+    field?: SemaphorFieldRef;
+    operator?: SemaphorInputOperator;
+    source?: SemaphorSourceRef;
+};
+
+export declare function toSemaphorMetricIntent(spec: SemaphorDataAppMetricSpec): SemaphorMetricIntent;
+
+export declare function toSemaphorRecordsIntent(spec: SemaphorDataAppRecordsSpec): SemaphorRecordsIntent;
+
+export declare function useSemaphorDataAppRuntime(): SemaphorDataAppRuntime;
+
+export declare function useSemaphorInput<TValue extends SemaphorDataAppInputValue = SemaphorDataAppInputValue>(spec: SemaphorDataAppInputSpec<TValue>): SemaphorDataAppInputHandle<TValue>;
+
+export declare function useSemaphorInputOptions(spec: SemaphorDataAppInputOptionsSpec): SemaphorDataAppInputOptionsResult;
+
+export declare function useSemaphorMetric(spec: SemaphorDataAppMetricSpec): SemaphorDataAppMetricResult;
+
+export declare function useSemaphorRecords<TRecord extends Record<string, unknown> = Record<string, unknown>>(spec: SemaphorDataAppRecordsSpec): SemaphorDataAppRecordsResult<TRecord>;
+
+export { }

package/dist/types/main.d.ts

@@ -1813,7 +1813,7 @@ export declare function DashboardCreateDialogBase({ open, onOpenChange, onCreate
 export declare interface DashboardCreateDialogBaseProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
-    onCreateBlank: (data: DashboardCreateBlankData) => void;
+    onCreateBlank: (data: DashboardCreateBlankData) => void | Promise<void>;
     onAiCreateSuccess: (result: any) => void;
     isCreatingBlank: boolean;
     sources: DashboardAuthoringSource[];
@@ -2056,6 +2056,7 @@ declare type DashboardPlanCard = {
     priority: number;
     section?: string;
     query?: DashboardCardQueryIntent;
+    analyticsIntent?: SemaphorAnalyticsIntent;
     text?: string;
 };
 
@@ -2063,6 +2064,7 @@ declare type DashboardPlanFilterInput = {
     id: string;
     label: string;
     variableName: string;
+    scope?: DashboardInputScope;
     filter: TFilter;
     defaultValue?: unknown;
 };
@@ -2303,6 +2305,7 @@ export declare interface DataModelEntityReference extends DatabaseEntityReferenc
 export declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
+    table?: string | null;
     datamodelId?: string | null;
     sql?: string | null;
     id: string;
@@ -4360,17 +4363,125 @@ declare type SemanticExecutionPayload = {
     }>;
 };
 
+declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
+
 export declare const SemaphorContextProvider: ({ children, dashboardProps, }: {
     children: React.ReactNode;
     dashboardProps: DashboardProps;
 }) => JSX.Element;
 
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'snowflake' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+
+declare type SemaphorFieldRef = {
+    name: string;
+    label?: string;
+    role?: 'dimension' | 'measure' | 'date' | 'id' | 'unknown';
+    dataType?: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'unknown';
+};
+
+declare type SemaphorInputBinding = {
+    inputId: string;
+    field?: SemaphorFieldRef;
+};
+
+declare type SemaphorInputOptionsIntent = {
+    kind: 'inputOptions';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
+    source: SemaphorSourceRef;
+    field: SemaphorFieldRef;
+    search?: string;
+    limit?: number;
+};
+
+declare type SemaphorMetricIntent = {
+    kind: 'metric';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    source: SemaphorSourceRef;
+    metric: string;
+    metrics?: string[];
+    label?: string;
+    dateField?: SemaphorFieldRef;
+    timeGrain?: SemaphorTimeGrain;
+    dimensions?: SemaphorFieldRef[];
+    comparison?: {
+        kind: 'previous_period' | 'previous_year' | 'target';
+        targetValue?: number;
+    };
+    inputs?: SemaphorInputBinding[];
+    limit?: number;
+};
+
+declare type SemaphorProtocolVersion = 1;
+
 declare function SemaphorQueryClient({ children, }: {
     children: React.ReactNode;
 }): JSX.Element;
 export { SemaphorQueryClient as SemaphorDataProvider }
 export { SemaphorQueryClient }
 
+declare type SemaphorRecordsIntent = {
+    kind: 'records';
+    version?: SemaphorProtocolVersion;
+    source: SemaphorSourceRef;
+    id?: string;
+    label?: string;
+    fields: SemaphorFieldRef[];
+    measures?: string[];
+    dateField?: SemaphorFieldRef;
+    timeGrain?: SemaphorTimeGrain;
+    limit?: number;
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    inputs?: SemaphorInputBinding[];
+};
+
+declare type SemaphorSourceRef = {
+    kind: 'semantic';
+    domainId: string;
+    datasetName: string;
+    datasetId?: string;
+    label?: string;
+    connectionId?: string;
+} | {
+    kind: 'physical';
+    connectionId: string;
+    tableName: string;
+    databaseName?: string;
+    schemaName?: string;
+    label?: string;
+    dialect?: SemaphorDialect;
+} | {
+    kind: 'sql';
+    connectionId: string;
+    sql: string;
+    dialect?: SemaphorDialect;
+    label?: string;
+};
+
+declare type SemaphorSqlIntent = {
+    kind: 'sql';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
+    source: Extract<SemaphorSourceRef, {
+        kind: 'sql' | 'physical';
+    }>;
+    sql?: string;
+    parameters?: Record<string, unknown>;
+    pythonCode?: string;
+    limit?: number;
+    rationale?: string;
+    fields?: SemaphorFieldRef[];
+    inputs?: SemaphorInputBinding[];
+};
+
+declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+
 /**
  * Stable serializer for dashboard dirty checks.
  * This consolidates normalization + serialization into one call site, so
@@ -5141,7 +5252,11 @@ export declare type TDataColumn = {
     label?: string;
     description?: string;
     qualifiedFieldName?: string;
-    role?: 'metric';
+    qualifiedEntityName?: string;
+    entityId?: string;
+    entityName?: string;
+    entityType?: EntityType;
+    role?: 'groupby' | 'metric' | 'sortby' | 'pivotby' | 'detail';
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
     format?: FormatSpec;
@@ -6094,6 +6209,7 @@ export declare function useResourceManagement(resourceType: ResourceType, onDele
     isFetching: boolean;
     error: Error | null;
     createResource: UseMutateFunction<any, Error, CreateResourceRequest, void>;
+    createResourceAsync: UseMutateAsyncFunction<any, Error, CreateResourceRequest, void>;
     updateResource: UseMutateFunction<any, Error, {
     resourceId: string;
     data: UpdateResourceRequest | UpdateDashboardTemplateRequest;

package/dist/types/shared.d.ts

@@ -595,6 +595,7 @@ declare interface DataModelEntityReference extends DatabaseEntityReference {
 declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
+    table?: string | null;
     datamodelId?: string | null;
     sql?: string | null;
     id: string;

package/dist/types/surfboard.d.ts

@@ -822,6 +822,7 @@ declare interface DataModelEntityReference extends DatabaseEntityReference {
 declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
+    table?: string | null;
     datamodelId?: string | null;
     sql?: string | null;
     id: string;
@@ -2512,7 +2513,11 @@ export declare type TDataColumn = {
     label?: string;
     description?: string;
     qualifiedFieldName?: string;
-    role?: 'metric';
+    qualifiedEntityName?: string;
+    entityId?: string;
+    entityName?: string;
+    entityType?: EntityType;
+    role?: 'groupby' | 'metric' | 'sortby' | 'pivotby' | 'detail';
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
     format?: FormatSpec;

package/dist/types/types.d.ts

@@ -1277,6 +1277,7 @@ export declare interface DataModelEntityReference extends DatabaseEntityReferenc
 export declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
+    table?: string | null;
     datamodelId?: string | null;
     sql?: string | null;
     id: string;
@@ -3282,7 +3283,11 @@ export declare type TDataColumn = {
     label?: string;
     description?: string;
     qualifiedFieldName?: string;
-    role?: 'metric';
+    qualifiedEntityName?: string;
+    entityId?: string;
+    entityName?: string;
+    entityType?: EntityType;
+    role?: 'groupby' | 'metric' | 'sortby' | 'pivotby' | 'detail';
     expression?: string;
     calculatedFormula?: CalculatedFieldFormula;
     format?: FormatSpec;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.324",
+  "version": "0.1.326",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -57,6 +57,16 @@
       "import": "./dist/dashboard-authoring/index.js",
       "require": "./dist/dashboard-authoring/index.cjs"
     },
+    "./analytics-protocol": {
+      "types": "./dist/types/analytics-protocol.d.ts",
+      "import": "./dist/analytics-protocol/index.js",
+      "require": "./dist/analytics-protocol/index.cjs"
+    },
+    "./data-app-sdk": {
+      "types": "./dist/types/data-app-sdk.d.ts",
+      "import": "./dist/data-app-sdk/index.js",
+      "require": "./dist/data-app-sdk/index.cjs"
+    },
     "./appearance": {
       "types": "./dist/types/appearance.d.ts",
       "import": "./dist/appearance/index.js",

package/dist/chunks/calendar-preferences-dialog-CLXaVo3h.js

@@ -1 +0,0 @@
-"use strict";const e=require("react/jsx-runtime"),l=require("react"),t=require("./index-CMS4bp9G.js"),i=require("./switch-BXICAlvS.js"),G=require("./chevrons-up-down-Cuilz9aY.js");function W(n={}){var y,P,z,A;const{authToken:d,tokenProps:a}=t.useSemaphorContext(),x=n.enabled??!0,m=(d==null?void 0:d.accessToken)??null,f=(a==null?void 0:a.apiServiceUrl)??null,[L,C]=l.useState(!1),[j,b]=l.useState(!1),[h,g]=l.useState(!1),[N,c]=l.useState(null),[v,S]=l.useState(null),k=v||{tz:((P=(y=a==null?void 0:a.params)==null?void 0:y.calendarContext)==null?void 0:P.tz)||null,weekStart:((A=(z=a==null?void 0:a.params)==null?void 0:z.calendarContext)==null?void 0:A.weekStart)??null},p=l.useCallback(async()=>{if(!(!x||!m||!f)){C(!0),c(null);try{const o=await fetch(`${f}/v1/user-preferences/calendar`,{method:"GET",headers:{Authorization:`Bearer ${m}`}});if(!o.ok){const u=await o.json().catch(()=>({}));throw new Error(u.error||"Failed to fetch preferences")}const r=await o.json();S({tz:r.tz,weekStart:r.weekStart,source:r.source,isInherited:r.isInherited,userHasPrefs:r.userHasPrefs,inherited:r.inherited})}catch(o){const r=o instanceof Error?o.message:"Unknown error";c(r)}finally{C(!1)}}},[m,f,x]);l.useEffect(()=>{x&&p()},[x,p]);const T=l.useCallback(async o=>{if(!m||!f)return c("Not authenticated"),!1;b(!0),c(null);try{const r=await fetch(`${f}/v1/user-preferences/calendar`,{method:"PATCH",headers:{"Content-Type":"application/json",Authorization:`Bearer ${m}`},body:JSON.stringify(o)});if(!r.ok){const u=await r.json().catch(()=>({}));throw new Error(u.error||"Failed to update preferences")}return await p(),!0}catch(r){const u=r instanceof Error?r.message:"Unknown error";return c(u),!1}finally{b(!1)}},[m,f,p]),w=l.useCallback(async()=>{if(!m||!f)return c("Not authenticated"),!1;g(!0),c(null);try{const o=await fetch(`${f}/v1/user-preferences/calendar`,{method:"DELETE",headers:{Authorization:`Bearer ${m}`}});if(!o.ok){const u=await o.json().catch(()=>({}));throw new Error(u.error||"Failed to clear preferences")}const r=await o.text();if(r)try{const u=JSON.parse(r);return S({tz:u.tz,weekStart:u.weekStart,source:u.source,isInherited:u.isInherited??!0,userHasPrefs:!1,inherited:u.inherited}),!0}catch{}return await p(),!0}catch(o){const r=o instanceof Error?o.message:"Unknown error";return c(r),!1}finally{g(!1)}},[m,f,p]);return{preferences:k,isLoading:L,isSaving:j,isClearing:h,error:N,updatePreferences:T,clearPreferences:w,refetch:p}}const E=[{value:"America/New_York",label:"Eastern Time (US & Canada)"},{value:"America/Chicago",label:"Central Time (US & Canada)"},{value:"America/Denver",label:"Mountain Time (US & Canada)"},{value:"America/Los_Angeles",label:"Pacific Time (US & Canada)"},{value:"America/Phoenix",label:"Arizona"},{value:"America/Anchorage",label:"Alaska"},{value:"Pacific/Honolulu",label:"Hawaii"},{value:"Europe/London",label:"London"},{value:"Europe/Paris",label:"Paris, Berlin, Rome"},{value:"Asia/Tokyo",label:"Tokyo"},{value:"Asia/Shanghai",label:"Beijing, Shanghai"},{value:"Asia/Kolkata",label:"Mumbai, New Delhi"},{value:"Australia/Sydney",label:"Sydney"},{value:"UTC",label:"UTC"}],M=[{value:0,label:"Sunday"},{value:1,label:"Monday"},{value:6,label:"Saturday"}],H="text-[10px] font-medium uppercase tracking-[0.08em] text-muted-foreground";function _(){try{const n=Intl;if(n.supportedValuesOf)return n.supportedValuesOf("timeZone")}catch{}return E.map(n=>n.value)}function q(n){switch(n){case"tenant":return"tenant";case"organization":return"organization";case"system":return"system";default:return"default"}}function O(n){const d=E.find(a=>a.value===n);return d?d.label:n}function V(n){const d=M.find(a=>a.value===n);return d?d.label:String(n)}function Z({open:n,onOpenChange:d}){var D,U,F;const{preferences:a,isLoading:x,isSaving:m,isClearing:f,updatePreferences:L,clearPreferences:C}=W({enabled:n}),j=a.tz||((D=a.inherited)==null?void 0:D.tz)||Intl.DateTimeFormat().resolvedOptions().timeZone,b=a.weekStart??((U=a.inherited)==null?void 0:U.weekStart)??1,[h,g]=l.useState(!a.userHasPrefs),[N,c]=l.useState(!1),[v,S]=l.useState(j),[k,p]=l.useState(b),[T,w]=l.useState(!1),y=l.useMemo(()=>_(),[]),P=l.useMemo(()=>y.filter(s=>!E.some(R=>R.value===s)),[y]),z=l.useMemo(()=>O(v),[v]),A=a.inherited?O(a.inherited.tz):"UTC",o=a.inherited?V(a.inherited.weekStart):"Monday",r=q((F=a.inherited)==null?void 0:F.source);l.useEffect(()=>{if(!n){c(!1);return}N||(a.userHasPrefs!==void 0&&g(!a.userHasPrefs),S(j),p(b))},[n,N,a.userHasPrefs,j,b]);const u=async()=>{if(x){t.ue.error("Preferences are still loading. Please try again.");return}h?await C()?(t.ue.success("Now using default settings. Please refresh the page to apply changes.",{duration:5e3}),d(!1)):t.ue.error("Failed to save preferences. Please try again."):await L({tz:v,weekStart:k})?(t.ue.success("Preferences saved. Please refresh the page to apply changes.",{duration:5e3}),d(!1)):t.ue.error("Failed to save preferences. Please try again.")},$=()=>{d(!1)},I=m||f,B=I||x;return e.jsx(t.Dialog,{open:n,onOpenChange:d,children:e.jsxs(t.DialogContent,{className:"rounded-control border-border/60 sm:max-w-[440px] sm:rounded-control",children:[e.jsxs(t.DialogHeader,{children:[e.jsx(t.DialogTitle,{className:"text-[15px]",children:"Calendar preferences"}),e.jsx(t.DialogDescription,{className:"text-[13px] leading-5",children:"Set your timezone and week-start for date calculations and displays."})]}),e.jsxs("div",{className:"space-y-4 py-1",children:[e.jsxs(t.RadioGroup,{value:h?"defaults":"custom",onValueChange:s=>{c(!0),g(s==="defaults")},className:"space-y-0.5",children:[e.jsxs("label",{htmlFor:"mode-defaults",className:i.cn("flex cursor-pointer items-start gap-2 rounded-control px-2 py-1.5 hover:bg-muted/50",h&&"bg-muted/50"),onClick:()=>{c(!0),g(!0)},children:[e.jsx(t.RadioGroupItem,{value:"defaults",id:"mode-defaults",className:"mt-0.5"}),e.jsxs("div",{className:"flex-1 min-w-0",children:[e.jsxs("p",{className:"text-[13px] font-medium text-foreground",children:["Use ",r," defaults"]}),e.jsxs("p",{className:"text-[12px] text-muted-foreground",children:[A,", week starts ",o]})]})]}),e.jsxs("label",{htmlFor:"mode-custom",className:i.cn("flex cursor-pointer items-start gap-2 rounded-control px-2 py-1.5 hover:bg-muted/50",!h&&"bg-muted/50"),onClick:()=>{c(!0),g(!1)},children:[e.jsx(t.RadioGroupItem,{value:"custom",id:"mode-custom",className:"mt-0.5"}),e.jsx("p",{className:"flex-1 text-[13px] font-medium text-foreground",children:"Use custom settings"})]})]}),e.jsxs("div",{className:i.cn("space-y-4 border-t border-border/60 pt-4 transition-opacity",h&&"pointer-events-none opacity-50"),children:[e.jsxs("div",{className:"space-y-1.5",children:[e.jsx(i.Label,{className:H,children:"Timezone"}),e.jsxs(i.Popover,{open:T,onOpenChange:w,modal:!0,children:[e.jsx(i.PopoverTrigger,{asChild:!0,children:e.jsxs(i.Button,{variant:"outline",size:"xs",role:"combobox","aria-expanded":T,className:"w-full justify-between text-[12px] font-normal",disabled:h,children:[e.jsx("span",{className:"truncate",children:z}),e.jsx(G.ChevronsUpDown,{className:"ml-2 h-3.5 w-3.5 shrink-0 opacity-50"})]})}),e.jsx(i.PopoverContent,{className:"z-50 w-[--radix-popover-trigger-width] p-0",align:"start",children:e.jsxs(t.Command,{className:"overflow-visible",children:[e.jsx(t.CommandInput,{placeholder:"Search timezones…"}),e.jsxs(t.CommandList,{children:[e.jsx(t.CommandEmpty,{children:"No timezone found."}),e.jsx(t.CommandGroup,{heading:"Common",children:E.map(s=>e.jsxs(t.CommandItem,{value:`${s.value} ${s.label}`,onSelect:()=>{c(!0),S(s.value),w(!1)},children:[e.jsx(i.Check,{className:i.cn("h-3.5 w-3.5",v===s.value?"opacity-100":"opacity-0")}),e.jsx("span",{className:"flex-1",children:s.label}),e.jsx("span",{className:"text-[11px] text-muted-foreground",children:s.value})]},s.value))}),e.jsx(t.CommandSeparator,{}),e.jsx(t.CommandGroup,{heading:"All timezones",children:P.map(s=>e.jsxs(t.CommandItem,{value:s,onSelect:()=>{c(!0),S(s),w(!1)},children:[e.jsx(i.Check,{className:i.cn("h-3.5 w-3.5",v===s?"opacity-100":"opacity-0")}),s]},s))})]})]})})]})]}),e.jsxs("div",{className:"space-y-1.5",children:[e.jsx(i.Label,{className:H,children:"Week starts on"}),e.jsx(t.RadioGroup,{value:String(k),onValueChange:s=>{c(!0),p(Number(s))},className:"flex gap-4",disabled:h,children:M.map(s=>e.jsxs("label",{htmlFor:`week-start-${s.value}`,className:i.cn("flex cursor-pointer items-center gap-2 text-[13px]",h&&"cursor-not-allowed"),children:[e.jsx(t.RadioGroupItem,{value:String(s.value),id:`week-start-${s.value}`,disabled:h}),s.label]},s.value))})]})]})]}),e.jsxs(t.DialogFooter,{children:[e.jsx(i.Button,{variant:"outline",size:"xs",onClick:$,disabled:I,children:"Cancel"}),e.jsx(i.Button,{size:"xs",onClick:u,disabled:B,children:I?e.jsxs(e.Fragment,{children:[e.jsx(i.LoaderCircle,{className:"h-3.5 w-3.5 animate-spin"}),"Saving…"]}):"Save"})]})]})})}exports.CalendarPreferencesDialog=Z;

package/dist/chunks/dashboard-json-eGBWfSN1.js

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("react/jsx-runtime"),o=require("react"),s=require("./switch-BXICAlvS.js");require("./index-CMS4bp9G.js");require("./index-DRlMUglg.js");require("react-dom");function b(){const t=s.useDashboardStore(e=>e.dashboard),c=s.useDashboardStore(e=>e.actions.setDashboard),u=s.useDashboardStore(e=>e.showDashboardJSON),h=s.useDashboardStore(e=>e.actions.setShowDashboardJSON),a=o.useMemo(()=>t?JSON.stringify(t,null,2):"",[t]),[l,d]=o.useState(a),n=o.useRef(a);return o.useEffect(()=>{a!==n.current&&(d(a),n.current=a)},[a]),r.jsxs("div",{className:s.cn("relative p-2",{hidden:!u}),children:[r.jsxs(s.Button,{variant:"secondary",size:"sm",className:"absolute right-2 top-2 z-10 h-8",onClick:()=>h(!1),children:[r.jsx(s.X,{className:"mr-2 h-4 w-4"}),"Close"]}),r.jsx("div",{className:"h-[550px] overflow-hidden",children:r.jsx(s.CodeEditor,{value:l,onValueChange:e=>{d(e);try{const i=JSON.parse(e);n.current=JSON.stringify(i,null,2),c(i)}catch{}},language:"json"})})]})}exports.default=b;