semanticdb-v2 2.0.0-alpha.1 → 2.0.0-alpha.3

package/dist/physical/oracle-provider.d.ts

@@ -39,6 +39,7 @@ export declare class OracleProvider implements CoreComputeProvider {
     dateBucket(expression: string, level: string): string;
     dateShift(expression: string, granularity: string, offset: number): string;
     aggregateFunction(name: string, expression?: string): string;
+    stringify(expression: string): string;
     concat(expressions: readonly string[]): string;
     substring(expression: string, start: number, length: number): string;
     regex(expression: string, pattern: string, options?: string): string;

package/dist/physical/postgresql-provider.d.ts

@@ -24,6 +24,7 @@ export declare class PostgreSQLProvider implements CoreComputeProvider {
     dateBucket(expression: string, level: string): string;
     dateShift(expression: string, granularity: string, offset: number): string;
     aggregateFunction(name: string, expression?: string): string;
+    stringify(expression: string): string;
     concat(expressions: readonly string[]): string;
     substring(expression: string, start: number, length: number): string;
     regex(expression: string, pattern: string, options?: string): string;

package/dist/physical/provider.d.ts

@@ -13,7 +13,9 @@ export interface SqlRenderCapabilities {
     paginate(sql: string, pageSize: number, offset: number): string;
     dateBucket(expression: string, level: string): string;
     dateShift(expression: string, granularity: string, offset: number): string;
+    datePeriodBoundary?(expression: string, granularity: string, boundary: 'start' | 'end'): string;
     aggregateFunction(name: string, expression?: string): string;
+    stringify(expression: string): string;
     concat(expressions: readonly string[]): string;
     substring(expression: string, start: number, length: number): string;
     regex(expression: string, pattern: string, options?: string): string;

package/dist/physical/snowflake-provider.d.ts

@@ -31,6 +31,7 @@ export declare class SnowflakeProvider implements CoreComputeProvider {
     dateBucket(expression: string, level: string): string;
     dateShift(expression: string, granularity: string, offset: number): string;
     aggregateFunction(name: string, expression?: string): string;
+    stringify(expression: string): string;
     concat(expressions: readonly string[]): string;
     substring(expression: string, start: number, length: number): string;
     regex(expression: string, pattern: string, options?: string): string;

package/dist/planner/semantics/observation/operator-policy.d.ts

@@ -1,6 +1,6 @@
 import type { PredItemType } from '../../../logicform-types';
 import type { OperatorDefinition } from '../../../operators/index';
-declare const periodBoundaryOperator = "$periodBoundary";
+declare const periodBoundaryOperator = "$periodValue";
 export interface ObservationOperatorPolicy {
     readonly operator: typeof periodBoundaryOperator;
     readonly boundary: 'start' | 'end';

package/dist/planner/semantics/observation/types.d.ts

@@ -1,3 +1,3 @@
 import type { ResultPropertyTemporalMetadata } from '../../../operators/index';
 export type ObservationTemporalMetadata = ResultPropertyTemporalMetadata;
-export type ObservationOperator = '$periodBoundary';
+export type ObservationOperator = '$periodValue';

package/dist/planner/types.d.ts

@@ -1,4 +1,5 @@
 import type { CoreComputeProvider } from '../physical/index';
+import type { LogicformType } from '../logicform-types';
 import type { ResultProperty } from '../operators/index';
 import type { ComparableCategoryDefinition, TimeGranularity } from '../semantic-types/index';
 export interface FieldReferencePlan {
@@ -10,6 +11,8 @@ export interface FieldReferencePlan {
     readonly qualifier: string;
     readonly sql?: string;
     readonly timestampColumn?: string;
+    /** Source alias that supplies $TS when it differs from the Property's Schema. */
+    readonly timestampQualifier?: string;
     readonly isArray?: boolean;
     readonly comparable?: ComparableCategoryDefinition;
 }
@@ -55,6 +58,7 @@ export type Expression = {
     readonly sql: string;
     readonly qualifier?: string;
     readonly timestampColumn?: string;
+    readonly timestampQualifier?: string;
 } | {
     readonly kind: 'operator';
     readonly operator: string;
@@ -63,7 +67,7 @@ export type Expression = {
     readonly qualifier?: string;
     readonly schemaId?: string;
     readonly input?: Expression;
-    readonly components?: readonly Expression[];
+    readonly inputs?: readonly Expression[];
     readonly args: Readonly<Record<string, unknown>>;
     readonly query?: Readonly<Record<string, unknown>>;
 } | {
@@ -143,6 +147,8 @@ export interface GroupLimitPlan {
 export type RowIdentityPlan = {
     readonly kind: 'group';
     readonly names: readonly string[];
+    readonly separator: string;
+    readonly nullLabel: string;
 } | {
     readonly kind: 'property';
     readonly column: string;
@@ -160,9 +166,11 @@ export interface LogicalPlan {
     /** Physical mapping selected by the Planner for this logical Schema. */
     readonly mappingId?: string;
     /** Child relations combined by their compatible group identity. */
-    readonly composition?: readonly LogicalPlan[];
+    readonly subplans?: readonly LogicalPlan[];
     /** Optional query plan compiled as the derived-table source of this plan. */
     readonly sourcePlan?: LogicalPlan;
+    /** Normalized LogicForm corresponding to sourcePlan when generated rewrites need execution. */
+    readonly sourceLogicform?: LogicformType;
     readonly sourceAlias?: string;
     readonly fields: Readonly<Record<string, string>>;
     readonly fieldReferences?: Readonly<Record<string, FieldReferencePlan>>;

package/dist/plugins/hierarchy/types.d.ts

@@ -1,11 +1,12 @@
 export interface HierarchyLevelDefinition {
     readonly name: string;
-    readonly synonyms?: readonly string[];
+    readonly syno?: readonly string[];
     readonly codeLength: number;
 }
 export interface HierarchyDefinition {
     /** Property that physically stores the complete hierarchy code. */
-    readonly property: string;
+    /** Property storing the complete hierarchy code. Defaults to the Schema's only ID Property. */
+    readonly property?: string;
     /** Compact codes stop at their level; zero-padded codes fill remaining segments with zeroes. */
     readonly storage?: 'compact' | 'zero-padded';
     readonly levels: readonly HierarchyLevelDefinition[];

package/dist/schema/entity-identity.d.ts

@@ -1,5 +1,5 @@
 import type { SemanticDBPlugin } from '../plugins/index';
 import type { ResolvedSemanticProperty, ResolvedSemanticSchema } from '../semantic-types/index';
-export declare const isConcreteEntityId: (value: unknown) => value is string;
+export declare const isConcreteEntityId: (value: unknown) => value is string | number;
 export declare const resolveEntityIdProperty: (schema: ResolvedSemanticSchema) => ResolvedSemanticProperty;
 export declare const resolveEntityFilterProperty: (schema: ResolvedSemanticSchema, plugins?: readonly SemanticDBPlugin[]) => ResolvedSemanticProperty;

package/dist/schema-mappings/index.d.ts

@@ -1,4 +1,6 @@
 export { SchemaMappingRegistry } from './registry';
 export { parseDailyExpireAt } from './freshness';
-export type { SchemaMappingDefinition, SourceFreshnessPolicy } from './types';
+export type { SchemaMappingDefinition, SchemaMappingItem, SourceFreshnessPolicy } from './types';
 export type { SchemaMappingPredDefinition, SchemaMappingPredMatch, } from './types';
+export { fromYiAskSchemaMapping } from './yiask';
+export type { YiAskSchemaMappingItem, YiAskSchemaMappingRecord } from './yiask';

package/dist/schema-mappings/types.d.ts

@@ -1,4 +1,4 @@
-import type { QueryType } from '../logicform-types';
+import type { PredItemType, QueryType } from '../logicform-types';
 export type SourceFreshnessPolicy = {
     readonly mode: 'ttl';
     readonly ttlSeconds: number;
@@ -22,6 +22,12 @@ export interface SchemaMappingPredDefinition {
     /** Physical column used as the matched PredItem's operator input. */
     readonly column: string;
 }
+export interface SchemaMappingItem {
+    readonly sourceColumn?: string;
+    readonly mappingType?: 'property' | 'predItem' | 'ignored';
+    readonly propertyTarget?: readonly string[];
+    readonly predItem?: PredItemType;
+}
 export interface SchemaMappingDefinition {
     /** Stable identity when a Schema has multiple physical mappings. */
     readonly id?: string;
@@ -32,13 +38,8 @@ export interface SchemaMappingDefinition {
     readonly source: string;
     /** Optional trusted query compiled as a derived-table source instead of reading source directly. */
     readonly sourceSql?: string;
-    /**
-     * Supported logical properties and their physical columns. Missing means all
-     * Schema properties keep their configured physical IDs.
-     */
-    readonly properties?: Readonly<Record<string, string>>;
-    /** PredItem patterns implemented by physical measure columns in this source. */
-    readonly predMappings?: readonly SchemaMappingPredDefinition[];
+    /** Unified logical-to-physical mappings for properties and conditional PredItems. */
+    readonly mappings?: readonly SchemaMappingItem[];
     /** Higher values win when multiple candidates cover the same LogicForm. */
     readonly priority?: number;
     /** Missing means queries depending on this physical source are not cached. */

package/dist/schema-mappings/yiask.d.ts

@@ -0,0 +1,22 @@
+import type { PredItemType } from '../logicform-types';
+import type { SchemaMappingDefinition } from './types';
+export interface YiAskSchemaMappingItem {
+    readonly sourceColumn?: string;
+    readonly mappingType?: 'property' | 'predItem' | 'ignored';
+    readonly propertyTarget?: readonly string[];
+    readonly predItem?: PredItemType;
+}
+export interface YiAskSchemaMappingRecord {
+    readonly id: string | number;
+    readonly schemaSid: string;
+    readonly datasourceSid: string;
+    readonly sourceMode?: 'table' | 'demo';
+    readonly tablePath?: string;
+    readonly sourceSql?: string;
+    readonly physicalDatabase?: string;
+    readonly physicalSchema?: string;
+    readonly physicalTable?: string;
+    readonly mappings: readonly YiAskSchemaMappingItem[];
+    readonly enabled?: boolean;
+}
+export declare const fromYiAskSchemaMapping: (record: YiAskSchemaMappingRecord) => SchemaMappingDefinition;

package/dist/semantic-types/index.d.ts

@@ -4,6 +4,6 @@ export { SemanticTypeRegistry } from './registry';
 export { resolveSchema } from './resolve-schema';
 export { validateResolvedSchema } from './validate-resolved-schema';
 export { normalizePrimalQuery } from './primal-types/index';
-export type { ComparableCategoryDefinition, PropertySqlDefinition, PrimalType, ResolvedSemanticProperty, ResolvedSemanticSchema, LegacySemanticSchemaMetadata, ResolvedSemanticSchemaMetadata, SemanticSchemaMetadata, SemanticTypeNormalizeContext, SemanticPeriodEvaluationContext, SemanticTypeResultContext, SemanticTypeResultProperty, SemanticPropertyDraft, SemanticSchemaDraft, SemanticTypeDefinition, TimeGranularity, TemporalSemantics, } from './types';
+export type { ComparableCategoryDefinition, PropertySqlDefinition, PrimalType, ResolvedSemanticProperty, ResolvedSemanticSchema, LegacySemanticSchemaMetadata, ResolvedSemanticSchemaMetadata, SemanticSchemaMetadata, SemanticTypeNormalizeContext, SemanticPeriodEvaluationContext, SemanticTypeResultContext, SemanticTypeResultProperty, SemanticPropertyDraft, SemanticSchemaDraft, SemanticTypeDefinition, TimeGranularity, TemporalSemantics, TimeWatermarkPolicy, } from './types';
 export type { HierarchyDefinition, HierarchyLevelDefinition, ResolvedHierarchyDefinition, } from '../plugins/hierarchy/index';
 export declare const createSemanticTypeRegistry: () => SemanticTypeRegistry;

package/dist/semantic-types/types.d.ts

@@ -1,8 +1,15 @@
 import type { PropertyTypeDraft, SchemaTypeDraft } from 'semanticdb-core';
 import type { LogicformType, PredItemType } from '../logicform-types';
-export type PrimalType = 'string' | 'number' | 'boolean' | 'date' | 'object';
+/** Canonical primitive types use `entity`; `object` remains a legacy input alias. */
+export type PrimalType = 'string' | 'number' | 'boolean' | 'date' | 'entity' | 'object';
 export type TimeGranularity = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 export type TemporalSemantics = 'normal' | 'snapshot';
+export type TimeWatermarkPolicy = {
+    readonly type: 'database_latest';
+} | {
+    readonly type: 'now_offset';
+    readonly offset: number;
+};
 export interface PropertySqlDefinition {
     readonly sql: string;
 }
@@ -25,10 +32,13 @@ export interface SemanticPropertyDraft extends Omit<PropertyTypeDraft, '_id' | '
     readonly primal_type?: PrimalType;
     readonly isArray?: boolean;
     readonly granularity?: TimeGranularity;
+    /** Default hierarchy level when this Property references a hierarchy Entity. */
+    readonly level?: string;
     /** Derived during schema resolution from whether the property has udf.sql. */
     readonly is_dynamic?: boolean;
     readonly udf?: PropertySqlDefinition;
     readonly comparable?: ComparableCategoryDefinition;
+    readonly timeWatermark?: TimeWatermarkPolicy;
 }
 export interface ResolvedSemanticProperty extends Omit<SemanticPropertyDraft, 'id' | 'primal_type' | 'isArray' | 'is_dynamic'> {
     readonly id: string;
@@ -41,6 +51,7 @@ export interface SemanticSchemaDraft extends Omit<SchemaTypeDraft, '_id' | 'id'
     readonly id: string;
     readonly properties: readonly SemanticPropertyDraft[];
     readonly temporalSemantics?: TemporalSemantics;
+    readonly timeWatermark?: TimeWatermarkPolicy;
     /** Property that stores the parent node id for recursive tree queries. */
     readonly parentProperty?: string;
 }
@@ -49,6 +60,7 @@ export interface ResolvedSemanticSchema extends Omit<SchemaTypeDraft, '_id' | 'i
     readonly id: string;
     readonly properties: readonly ResolvedSemanticProperty[];
     readonly temporalSemantics?: TemporalSemantics;
+    readonly timeWatermark?: TimeWatermarkPolicy;
     /** Canonical logical name of the parent Property used by recursive tree queries. */
     readonly parentProperty?: string;
 }
@@ -56,7 +68,7 @@ export interface SemanticTypeNormalizeContext {
     readonly schema: ResolvedSemanticSchema;
     readonly property: ResolvedSemanticProperty;
     readonly now: Date;
-    readonly requestLatestDataDate: () => Promise<Date | undefined>;
+    readonly requestTimeWatermark: (requestedUpperBound: Date) => Promise<Date | undefined>;
 }
 /** Context used when deciding whether a value must be evaluated per time period. */
 export interface SemanticPeriodEvaluationContext {