react-semaphor 0.0.504 → 0.0.506

package/dist/dashboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-CGZJfir8.js"),r=require("../types/index.cjs");exports.Dashboard=e.Dashboard;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-B6aFim6x.js"),r=require("../types/index.cjs");exports.Dashboard=e.Dashboard;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;

package/dist/dashboard/index.js

@@ -1,4 +1,4 @@
-import { D as a } from "../chunks/index-CgeLnBe2.js";
+import { D as a } from "../chunks/index-B4zq9EOh.js";
 import { EMPTY_SELECTION as e } from "../types/index.js";
 export {
   a as Dashboard,

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/index-CGZJfir8.js"),t=require("./types/index.cjs"),a=require("./chunks/dashboard-plus-DkRjEQS7.js");require("react/jsx-runtime");require("react");require("react-dom");const o=["YYYY-MM-DD","MM/DD/YYYY","DD/MM/YYYY","MMMM DD, YYYY","MMM DD, YYYY","DD MMM YYYY","YYYY-MM","MMMM YYYY","custom"];exports.Dashboard=e.Dashboard;exports.DashboardWC=e.DashboardWC;exports.SemaphorDataProvider=e.SemaphorQueryClient;exports.SemaphorQueryClient=e.SemaphorQueryClient;exports.createSqlGenConfig=e.createSqlGenConfig;exports.fmt=e.fmt;exports.getColumnDataType=e.getColumnDataType;exports.getFilterValueType=e.getFilterValueType;exports.getFormattedTableNameForQuery=e.getFormattedTableNameForQuery;exports.getQualifiedTableName=e.getQualifiedTableName;exports.getSql=e.getSql;exports.invalidateToken=e.invalidateToken;exports.isBooleanDataType=e.isBooleanDataType;exports.isColumnInSqlGen=e.isColumnInSqlGen;exports.isDateDataType=e.isDateDataType;exports.isNumberDataType=e.isNumberDataType;exports.isTextDataType=e.isTextDataType;exports.resolveDataType=e.resolveDataType;exports.resolveDatamodelName=e.resolveDatamodelName;exports.useCard=e.useCard;exports.useDashboardActions=e.useDashboardActions;exports.useDashboardStore=e.useDashboardStore;exports.useDataColumns=e.useDataColumns;exports.useDateFilterHook=e.useDateFilterHook;exports.useEditorActions=e.useEditorActions;exports.useEditorAside=e.useEditorAside;exports.useEditorStore=e.useEditorStore;exports.useTextFilterHook=e.useTextFilterHook;exports.EMPTY_SELECTION=t.EMPTY_SELECTION;exports.ScheduleDashboard=a.ScheduleDashboard;exports.SelectComponent=a.SelectComponent;exports.Surfboard=a.DashboardPlus;exports.cleanCard=a.cleanCard;exports.downloadPdf=a.downloadPdf;exports.getDashbaordStateWithoutData=a.getDashbaordStateWithoutData;exports.DATE_FORMAT_VALUES=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/index-B6aFim6x.js"),t=require("./types/index.cjs"),a=require("./chunks/dashboard-plus-BFfj_pPX.js");require("react/jsx-runtime");require("react");require("react-dom");const o=["YYYY-MM-DD","MM/DD/YYYY","DD/MM/YYYY","MMMM DD, YYYY","MMM DD, YYYY","DD MMM YYYY","YYYY-MM","MMMM YYYY","custom"];exports.Dashboard=e.Dashboard;exports.DashboardWC=e.DashboardWC;exports.SemaphorDataProvider=e.SemaphorQueryClient;exports.SemaphorQueryClient=e.SemaphorQueryClient;exports.createSqlGenConfig=e.createSqlGenConfig;exports.fmt=e.fmt;exports.getColumnDataType=e.getColumnDataType;exports.getFilterValueType=e.getFilterValueType;exports.getFormattedTableNameForQuery=e.getFormattedTableNameForQuery;exports.getQualifiedTableName=e.getQualifiedTableName;exports.getSql=e.getSql;exports.invalidateToken=e.invalidateToken;exports.isBooleanDataType=e.isBooleanDataType;exports.isColumnInSqlGen=e.isColumnInSqlGen;exports.isDateDataType=e.isDateDataType;exports.isNumberDataType=e.isNumberDataType;exports.isTextDataType=e.isTextDataType;exports.resolveDataType=e.resolveDataType;exports.resolveDatamodelName=e.resolveDatamodelName;exports.useCard=e.useCard;exports.useDashboardActions=e.useDashboardActions;exports.useDashboardStore=e.useDashboardStore;exports.useDataColumns=e.useDataColumns;exports.useDateFilterHook=e.useDateFilterHook;exports.useEditorActions=e.useEditorActions;exports.useEditorAside=e.useEditorAside;exports.useEditorStore=e.useEditorStore;exports.useTextFilterHook=e.useTextFilterHook;exports.EMPTY_SELECTION=t.EMPTY_SELECTION;exports.ScheduleDashboard=a.ScheduleDashboard;exports.SelectComponent=a.SelectComponent;exports.Surfboard=a.DashboardPlus;exports.cleanCard=a.cleanCard;exports.downloadPdf=a.downloadPdf;exports.getDashbaordStateWithoutData=a.getDashbaordStateWithoutData;exports.DATE_FORMAT_VALUES=o;

package/dist/index.js

@@ -1,6 +1,6 @@
-import { D, c as Y, S as i, S as d, l, f as M, n as u, m, p as n, q as p, k as S, i as T, j as b, o as h, h as c, g as y, e as C, s as f, r as g, b as E, w as x, v as A, d as F, u as v, y as N, t as k, x as q, a as P } from "./chunks/index-CgeLnBe2.js";
+import { D, c as Y, S as i, S as d, l, f as M, n as u, m, p as n, q as p, k as S, i as T, j as b, o as h, h as c, g as y, e as C, s as f, r as g, b as E, w as x, v as A, d as F, u as v, y as N, t as k, x as q, a as P } from "./chunks/index-B4zq9EOh.js";
 import { EMPTY_SELECTION as _ } from "./types/index.js";
-import { S as G, a as H, D as I, c as L, d as O, g as V } from "./chunks/dashboard-plus-l7VBGMzZ.js";
+import { S as G, a as H, D as I, c as L, d as O, g as V } from "./chunks/dashboard-plus-CIhFBA0f.js";
 import "react/jsx-runtime";
 import "react";
 import "react-dom";

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/dashboard-plus-DkRjEQS7.js"),r=require("../types/index.cjs");exports.Surfboard=e.DashboardPlus;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/dashboard-plus-BFfj_pPX.js"),r=require("../types/index.cjs");exports.Surfboard=e.DashboardPlus;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;

package/dist/surfboard/index.js

@@ -1,4 +1,4 @@
-import { D as f } from "../chunks/dashboard-plus-l7VBGMzZ.js";
+import { D as f } from "../chunks/dashboard-plus-CIhFBA0f.js";
 import { EMPTY_SELECTION as a } from "../types/index.js";
 export {
   a as EMPTY_SELECTION,

package/dist/types/dashboard.d.ts

@@ -196,9 +196,9 @@ declare interface DataModelEntityReference extends DatabaseEntityReference {
 
 declare interface DataSource {
     connectionId: string;
-    semanticModelId?: string;
+    semanticDomainId?: string;
     connectionType: string;
-    mode: 'database' | 'upload' | 'url' | 'semanticModel';
+    mode: 'database' | 'upload' | 'url' | 'semanticDomain';
     dbSelection?: {
         database: string;
         schema: string;
@@ -246,10 +246,27 @@ export declare type ExportDataPayload = {
 };
 
 declare interface Field {
+    /**
+     * Unique identifier for this field instance (for joins, UI state, etc.).
+     * Should be unique within the context of the query or data model.
+     * Example: 'orders.customer_id', 'expr_12345', etc.
+     */
     id: string;
+    /**
+     * The physical/source column name in the database or data source.
+     * Used for mapping to the underlying data model and SQL generation (unless overridden by expression).
+     */
     name: string;
-    dataType: string;
+    /**
+     * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
+     */
     label: string;
+    /**
+     * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
+     * If not provided, should be auto-generated from label or name.
+     */
+    alias?: string;
+    dataType: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -361,6 +378,11 @@ declare interface GroupByColumn extends BaseColumn {
 declare interface GroupByField extends Field {
     role: 'groupby';
     granularity?: 'day' | 'week' | 'month' | 'quarter' | 'year';
+    /**
+     * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
+     * If present, used in SELECT and GROUP BY instead of just the column name.
+     */
+    expression?: string;
 }
 
 export declare type HtmlOptions = {
@@ -417,6 +439,31 @@ declare interface MetricColumn extends BaseColumn {
 declare interface MetricField extends Field {
     role: 'metric';
     aggregate: AggregateFunction;
+    /**
+     * Optional SQL expression for the metric (e.g., ship_date - order_date).
+     * If present, used as aggregate(expression) instead of aggregate(name).
+     */
+    expression?: string;
+    /**
+     * Optional parameters for future extensibility (e.g., window functions).
+     * * Example:
+     * {
+     aggregate: "SUM",
+     name: "sales",
+     parameters: {
+     window: "PARTITION BY region ORDER BY date ROWS BETWEEN 1 PRECEDING AND CURRENT ROW"
+     }
+     }
+
+     {
+     aggregate: "COUNT",
+     name: "order_id",
+     parameters: {
+     filter: "status = 'Active'"
+     }
+     }
+     */
+    parameters?: Record<string, any>;
     aliasTemplate?: string;
     valueAliases?: Record<string, string>;
 }

package/dist/types/main.d.ts

@@ -7,6 +7,7 @@ import { ComboBoxOption as ComboBoxOption_2 } from '../../components/surfboard/f
 import { CustomCard as CustomCard_2 } from '..';
 import { DateRange } from 'react-day-picker';
 import { default as default_2 } from 'react-grid-layout';
+import { Dialect as Dialect_2 } from '../types/explorer-types';
 import { DropdownItem as DropdownItem_2 } from '../types/dropdown-types';
 import { EmailSettings as EmailSettings_2 } from '..';
 import { FontSpec } from 'chart.js';
@@ -15,6 +16,7 @@ import { QueryObserverResult } from '@tanstack/query-core';
 import { RefetchOptions } from '@tanstack/query-core';
 import { StoreApi } from 'zustand';
 import { TBaseQuery as TBaseQuery_2 } from '..';
+import { TDbCapabilities as TDbCapabilities_2 } from '../types';
 import { TFilter as TFilter_2 } from '../surfboard/filter/types';
 import { TFilterValue as TFilterValue_2 } from '..';
 import { TStyle as TStyle_2 } from '..';
@@ -441,15 +443,16 @@ export declare interface DataModelEntityReference extends DatabaseEntityReferenc
 export declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     id: string;
+    domainId: string;
     label: string;
     description: string;
 }
 
 export declare interface DataSource {
     connectionId: string;
-    semanticModelId?: string;
+    semanticDomainId?: string;
     connectionType: string;
-    mode: 'database' | 'upload' | 'url' | 'semanticModel';
+    mode: 'database' | 'upload' | 'url' | 'semanticDomain';
     dbSelection?: {
         database: string;
         schema: string;
@@ -563,7 +566,7 @@ declare interface ExplorerActions {
     setActiveTabCard: (cardId: string | null) => void;
     updateDataSource: (dataSource: DataSource) => void;
     setDataSource: (dataSource: DataSource) => void;
-    updateSemanticModel: (semanticModelId: string) => void;
+    updateSemanticDomain: (semanticDomainId: string) => void;
     updateDirectSource: (updates: Partial<DataSource>) => void;
     getAvailableFields: () => Array<{
         id: string;
@@ -603,10 +606,27 @@ export declare type ExportDataPayload = {
 };
 
 export declare interface Field {
+    /**
+     * Unique identifier for this field instance (for joins, UI state, etc.).
+     * Should be unique within the context of the query or data model.
+     * Example: 'orders.customer_id', 'expr_12345', etc.
+     */
     id: string;
+    /**
+     * The physical/source column name in the database or data source.
+     * Used for mapping to the underlying data model and SQL generation (unless overridden by expression).
+     */
     name: string;
-    dataType: string;
+    /**
+     * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
+     */
     label: string;
+    /**
+     * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
+     * If not provided, should be auto-generated from label or name.
+     */
+    alias?: string;
+    dataType: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -771,6 +791,11 @@ export declare interface GroupByColumn extends BaseColumn {
 export declare interface GroupByField extends Field {
     role: 'groupby';
     granularity?: 'day' | 'week' | 'month' | 'quarter' | 'year';
+    /**
+     * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
+     * If present, used in SELECT and GROUP BY instead of just the column name.
+     */
+    expression?: string;
 }
 
 export declare type HtmlOptions = {
@@ -839,6 +864,31 @@ export declare interface MetricColumn extends BaseColumn {
 export declare interface MetricField extends Field {
     role: 'metric';
     aggregate: AggregateFunction;
+    /**
+     * Optional SQL expression for the metric (e.g., ship_date - order_date).
+     * If present, used as aggregate(expression) instead of aggregate(name).
+     */
+    expression?: string;
+    /**
+     * Optional parameters for future extensibility (e.g., window functions).
+     * * Example:
+     * {
+     aggregate: "SUM",
+     name: "sales",
+     parameters: {
+     window: "PARTITION BY region ORDER BY date ROWS BETWEEN 1 PRECEDING AND CURRENT ROW"
+     }
+     }
+
+     {
+     aggregate: "COUNT",
+     name: "order_id",
+     parameters: {
+     filter: "status = 'Active'"
+     }
+     }
+     */
+    parameters?: Record<string, any>;
     aliasTemplate?: string;
     valueAliases?: Record<string, string>;
 }
@@ -1356,6 +1406,14 @@ export declare const useEditorActions: () => Actions_2;
 export declare function useEditorAside(token?: AuthToken, _connectionQueryKey?: string): {
     connectionItems: ConnectionItem[];
     selectedConnectionId: string | undefined;
+    selectedConnection: {
+        id: string;
+        name: string;
+        type: string;
+        dialect?: Dialect_2;
+        uiType?: "database" | "api" | "s3";
+        capabilities: TDbCapabilities_2;
+    } | undefined;
     isConnectionsLoading: boolean;
     isConnectionsError: boolean;
     modelItems: DropdownItem_2[];

package/dist/types/surfboard.d.ts

@@ -199,9 +199,9 @@ declare interface DataModelEntityReference extends DatabaseEntityReference {
 
 declare interface DataSource {
     connectionId: string;
-    semanticModelId?: string;
+    semanticDomainId?: string;
     connectionType: string;
-    mode: 'database' | 'upload' | 'url' | 'semanticModel';
+    mode: 'database' | 'upload' | 'url' | 'semanticDomain';
     dbSelection?: {
         database: string;
         schema: string;
@@ -249,10 +249,27 @@ export declare type ExportDataPayload = {
 };
 
 declare interface Field {
+    /**
+     * Unique identifier for this field instance (for joins, UI state, etc.).
+     * Should be unique within the context of the query or data model.
+     * Example: 'orders.customer_id', 'expr_12345', etc.
+     */
     id: string;
+    /**
+     * The physical/source column name in the database or data source.
+     * Used for mapping to the underlying data model and SQL generation (unless overridden by expression).
+     */
     name: string;
-    dataType: string;
+    /**
+     * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
+     */
     label: string;
+    /**
+     * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
+     * If not provided, should be auto-generated from label or name.
+     */
+    alias?: string;
+    dataType: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -364,6 +381,11 @@ declare interface GroupByColumn extends BaseColumn {
 declare interface GroupByField extends Field {
     role: 'groupby';
     granularity?: 'day' | 'week' | 'month' | 'quarter' | 'year';
+    /**
+     * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
+     * If present, used in SELECT and GROUP BY instead of just the column name.
+     */
+    expression?: string;
 }
 
 export declare type HtmlOptions = {
@@ -420,6 +442,31 @@ declare interface MetricColumn extends BaseColumn {
 declare interface MetricField extends Field {
     role: 'metric';
     aggregate: AggregateFunction;
+    /**
+     * Optional SQL expression for the metric (e.g., ship_date - order_date).
+     * If present, used as aggregate(expression) instead of aggregate(name).
+     */
+    expression?: string;
+    /**
+     * Optional parameters for future extensibility (e.g., window functions).
+     * * Example:
+     * {
+     aggregate: "SUM",
+     name: "sales",
+     parameters: {
+     window: "PARTITION BY region ORDER BY date ROWS BETWEEN 1 PRECEDING AND CURRENT ROW"
+     }
+     }
+
+     {
+     aggregate: "COUNT",
+     name: "order_id",
+     parameters: {
+     filter: "status = 'Active'"
+     }
+     }
+     */
+    parameters?: Record<string, any>;
     aliasTemplate?: string;
     valueAliases?: Record<string, string>;
 }

package/dist/types/types.d.ts

@@ -193,9 +193,9 @@ declare interface DataModelEntityReference extends DatabaseEntityReference {
 
 declare interface DataSource {
     connectionId: string;
-    semanticModelId?: string;
+    semanticDomainId?: string;
     connectionType: string;
-    mode: 'database' | 'upload' | 'url' | 'semanticModel';
+    mode: 'database' | 'upload' | 'url' | 'semanticDomain';
     dbSelection?: {
         database: string;
         schema: string;
@@ -243,10 +243,27 @@ export declare type ExportDataPayload = {
 };
 
 declare interface Field {
+    /**
+     * Unique identifier for this field instance (for joins, UI state, etc.).
+     * Should be unique within the context of the query or data model.
+     * Example: 'orders.customer_id', 'expr_12345', etc.
+     */
     id: string;
+    /**
+     * The physical/source column name in the database or data source.
+     * Used for mapping to the underlying data model and SQL generation (unless overridden by expression).
+     */
     name: string;
-    dataType: string;
+    /**
+     * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
+     */
     label: string;
+    /**
+     * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
+     * If not provided, should be auto-generated from label or name.
+     */
+    alias?: string;
+    dataType: string;
     description?: string;
     qualifiedEntityName?: string;
     dateFormat?: DateFormatValue;
@@ -358,6 +375,11 @@ declare interface GroupByColumn extends BaseColumn {
 declare interface GroupByField extends Field {
     role: 'groupby';
     granularity?: 'day' | 'week' | 'month' | 'quarter' | 'year';
+    /**
+     * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
+     * If present, used in SELECT and GROUP BY instead of just the column name.
+     */
+    expression?: string;
 }
 
 export declare type HtmlOptions = {
@@ -414,6 +436,31 @@ declare interface MetricColumn extends BaseColumn {
 declare interface MetricField extends Field {
     role: 'metric';
     aggregate: AggregateFunction;
+    /**
+     * Optional SQL expression for the metric (e.g., ship_date - order_date).
+     * If present, used as aggregate(expression) instead of aggregate(name).
+     */
+    expression?: string;
+    /**
+     * Optional parameters for future extensibility (e.g., window functions).
+     * * Example:
+     * {
+     aggregate: "SUM",
+     name: "sales",
+     parameters: {
+     window: "PARTITION BY region ORDER BY date ROWS BETWEEN 1 PRECEDING AND CURRENT ROW"
+     }
+     }
+
+     {
+     aggregate: "COUNT",
+     name: "order_id",
+     parameters: {
+     filter: "status = 'Active'"
+     }
+     }
+     */
+    parameters?: Record<string, any>;
     aliasTemplate?: string;
     valueAliases?: Record<string, string>;
 }

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.0.504",
+  "version": "0.0.506",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",