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

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

@@ -4,6 +4,12 @@ import type { LogicformType, PredItemType } from '../logicform-types';
 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;
 }
@@ -26,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;
@@ -42,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;
 }
@@ -50,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;
 }
@@ -57,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 {