react-semaphor 0.1.420 → 0.1.421

package/dist/types/data-app-codegen-node.d.ts

@@ -75,7 +75,7 @@ export declare function isSemaphorDataAppCodegenSummary(value: unknown): value i
 
 declare type JsonRecord = Record<string, unknown>;
 
-export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "contract.manifest.json"];
+export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "USAGE.md", "contract.manifest.json"];
 
 export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
 
@@ -631,6 +631,15 @@ declare type SemaphorDataAppImplementationChecklist = {
     browserSmokeChecks: string[];
 };
 
+declare type SemaphorDataAppRawIdentifierFilterDiagnostic = {
+    kind: 'raw_identifier_filter_options';
+    inputId: string;
+    inputLabel: string;
+    optionSource: SemaphorDataAppRelationshipCandidateSource;
+    optionField: SemaphorDataAppRelationshipCandidateField;
+    missingEvidence: Array<'display_field' | 'relationship_display_path'>;
+};
+
 declare type SemaphorDataAppRelationshipCandidate = {
     source: SemaphorDataAppRelationshipCandidateSource;
     sourceFields: SemaphorDataAppRelationshipCandidateField[];
@@ -665,8 +674,9 @@ declare type SemaphorDataAppRequiredInputOption = {
 declare type SemaphorDataAppUnsupportedInsight = {
     title: string;
     requestedQuestion: string;
-    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
+    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'raw_identifier_filter_options' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
     suggestedModelingFix: string;
+    diagnostic?: SemaphorDataAppRawIdentifierFilterDiagnostic;
     relationshipCandidate?: SemaphorDataAppRelationshipCandidate;
     nextRepairAction?: {
         tool: 'semaphor_propose_semantic_model_change';

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

@@ -71,7 +71,7 @@ export declare function isSemaphorDataAppCodegenSummary(value: unknown): value i
 
 declare type JsonRecord = Record<string, unknown>;
 
-export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "contract.manifest.json"];
+export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "USAGE.md", "contract.manifest.json"];
 
 export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
 
@@ -621,6 +621,15 @@ declare type SemaphorDataAppImplementationChecklist = {
     browserSmokeChecks: string[];
 };
 
+declare type SemaphorDataAppRawIdentifierFilterDiagnostic = {
+    kind: 'raw_identifier_filter_options';
+    inputId: string;
+    inputLabel: string;
+    optionSource: SemaphorDataAppRelationshipCandidateSource;
+    optionField: SemaphorDataAppRelationshipCandidateField;
+    missingEvidence: Array<'display_field' | 'relationship_display_path'>;
+};
+
 declare type SemaphorDataAppRelationshipCandidate = {
     source: SemaphorDataAppRelationshipCandidateSource;
     sourceFields: SemaphorDataAppRelationshipCandidateField[];
@@ -655,8 +664,9 @@ declare type SemaphorDataAppRequiredInputOption = {
 declare type SemaphorDataAppUnsupportedInsight = {
     title: string;
     requestedQuestion: string;
-    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
+    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'raw_identifier_filter_options' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
     suggestedModelingFix: string;
+    diagnostic?: SemaphorDataAppRawIdentifierFilterDiagnostic;
     relationshipCandidate?: SemaphorDataAppRelationshipCandidate;
     nextRepairAction?: {
         tool: 'semaphor_propose_semantic_model_change';

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

@@ -576,9 +576,6 @@ declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | 'date' |
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorExecutionFieldRef = SemaphorFieldRef & {
-    semanticAggregate?: SemaphorAggregateFunction;
-    effectiveAggregate?: SemaphorAggregateFunction;
-    aggregateSource?: SemaphorMetricAggregateSource;
     derivedField?: SemaphorDerivedFieldDefinition;
 };
 
@@ -895,8 +892,6 @@ declare type SemaphorMatrixValueField = {
 
 declare type SemaphorMatrixValueFieldInput = SemaphorQueryField | SemaphorMatrixValueField;
 
-declare type SemaphorMetricAggregateSource = 'semantic_model' | 'caller_override' | 'default_sum';
-
 declare type SemaphorMetricAnalysis = {
     kind: 'period_change';
     orderBy?: 'absolute_change' | 'positive_change' | 'negative_change' | 'period';

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

@@ -361,7 +361,7 @@ declare type MatrixWarning = {
 
 export declare const semaphor: {
     source: {
-        semantic(spec: SemaphorSemanticSourceBuilderSpec): SemaphorSourceRef;
+        semantic(spec: SemaphorSemanticSourceBuilderSpec): SemaphorSemanticSourceRef;
         sql(spec: Omit<SemaphorSqlSourceBuilderSpec, "kind">): SemaphorSqlSourceBuilderSpec;
     };
     field: {
@@ -750,6 +750,20 @@ export declare type SemaphorDataAppQueryError = Error & {
     validationIssues?: SemaphorAnalyticsValidationIssue[];
 };
 
+export declare type SemaphorDataAppResultPreview = {
+    title: string;
+    summary: string;
+    columns: SemaphorDataAppResultPreviewColumn[];
+    rows: Array<Record<string, unknown>>;
+    truncatedRows: boolean;
+    truncatedColumns: boolean;
+};
+
+export declare type SemaphorDataAppResultPreviewColumn = {
+    key: string;
+    label: string;
+};
+
 export declare type SemaphorDataAppSourceHint = {
     file?: string;
     line?: number;
@@ -792,6 +806,7 @@ export declare type SemaphorDataAppTrace = {
             populatedMetricKeys?: string[];
             missingMeasures?: string[];
         };
+        resultPreview?: SemaphorDataAppResultPreview;
         executionResult?: SemaphorAnalyticsExecutionResult;
         errorMessage?: string;
     };
@@ -899,9 +914,6 @@ export declare type SemaphorDevtoolsProps = {
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorExecutionFieldRef = SemaphorFieldRef & {
-    semanticAggregate?: SemaphorAggregateFunction;
-    effectiveAggregate?: SemaphorAggregateFunction;
-    aggregateSource?: SemaphorMetricAggregateSource;
     derivedField?: SemaphorDerivedFieldDefinition;
 };
 
@@ -1252,7 +1264,7 @@ export declare type SemaphorMatrixValueField = {
 
 export declare type SemaphorMatrixValueFieldInput = SemaphorQueryField | SemaphorMatrixValueField;
 
-declare type SemaphorMetricAggregateSource = 'semantic_model' | 'caller_override' | 'default_sum';
+export declare function semaphorMetricAggregate(field: Pick<SemaphorFieldRef, 'aggregate'>): string;
 
 declare type SemaphorMetricAnalysis = {
     kind: 'period_change';

package/package.json

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