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

package/dist/planner/types.d.ts

@@ -120,6 +120,9 @@ export interface JoinPlan {
     readonly targetSql?: string;
     readonly targetTimestampColumn?: string;
     readonly targetTimestampGranularity?: TimeGranularity;
+    /** Half-open validity interval columns on a versioned entity target. */
+    readonly targetValidityStartColumn?: string;
+    readonly targetValidityEndColumn?: string;
     readonly sourceArrayExpansionPath?: string;
 }
 export interface ArrayExpansionPlan {
@@ -144,6 +147,30 @@ export interface GroupLimitPlan {
     readonly partitionBy: readonly string[];
     readonly orderBy: readonly OrderPlan[];
 }
+export interface ValidityPeriodPlan {
+    readonly alias: string;
+    readonly labelColumn: string;
+    readonly asOfColumn: string;
+    readonly sourceAlias: string;
+    readonly startColumn: string;
+    readonly endColumn: string;
+    readonly periods: readonly {
+        readonly label: string;
+        readonly asOf: string;
+    }[];
+}
+export interface ObservationPeriodPlan {
+    readonly alias: string;
+    readonly labelColumn: string;
+    readonly asOfColumn: string;
+    readonly sourceAlias: string;
+    readonly lookupAlias: string;
+    readonly timestampColumn: string;
+    readonly periods: readonly {
+        readonly label: string;
+        readonly asOf: string;
+    }[];
+}
 export type RowIdentityPlan = {
     readonly kind: 'group';
     readonly names: readonly string[];
@@ -176,6 +203,10 @@ export interface LogicalPlan {
     readonly fieldReferences?: Readonly<Record<string, FieldReferencePlan>>;
     readonly joins?: readonly JoinPlan[];
     readonly arrayExpansions?: readonly ArrayExpansionPlan[];
+    /** Period spine used to evaluate a valid-time entity once per requested period. */
+    readonly validityPeriods?: ValidityPeriodPlan;
+    /** Period spine used to select the latest snapshot at each requested boundary. */
+    readonly observationPeriods?: ObservationPeriodPlan;
     readonly projections: readonly ProjectionPlan[];
     readonly columnProperties?: readonly ResultProperty[];
     readonly groupBy: readonly ProjectionPlan[];

package/dist/schema/dependent-projection.d.ts

@@ -0,0 +1,8 @@
+import type { PredItemType } from '../logicform-types';
+import type { ResolvedSemanticSchema } from '../semantic-types/index';
+/**
+ * Returns true when a scalar projection is functionally dependent on one of
+ * the supplied group keys. Same-Schema hierarchy uses `up`; scalar object
+ * relations use the relation key itself.
+ */
+export declare const isDependentProjection: (pred: PredItemType, groupby: readonly PredItemType[], schema: ResolvedSemanticSchema, resolveSchema?: (schemaId: string) => ResolvedSemanticSchema) => boolean;

package/dist/schema/index.d.ts

@@ -1,4 +1,5 @@
 export { buildFieldMap, getProperty, getSchema, } from './schema-registry';
 export { resolvePropertyPath } from './resolve-property-path';
+export { isDependentProjection } from './dependent-projection';
 export { isConcreteEntityId, resolveEntityFilterProperty, resolveEntityIdProperty, } from './entity-identity';
 export type { ResolvedPropertyPath, ResolvedRelationSegment, ResolvedSchemaLookup, } from './resolve-property-path';

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, TimeWatermarkPolicy, } from './types';
+export type { ComparableCategoryDefinition, PropertyHierarchyDefinition, 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

@@ -17,6 +17,11 @@ export interface ComparableCategoryDefinition {
     readonly values: readonly string[];
     readonly direction: 1 | -1;
 }
+/** Same-Schema Property drill metadata. `up` is the single-valued side. */
+export interface PropertyHierarchyDefinition {
+    readonly up?: string;
+    readonly down?: string;
+}
 /** Extension point for plugin-owned Schema draft metadata. */
 export interface SemanticSchemaMetadata {
 }
@@ -26,7 +31,7 @@ export interface ResolvedSemanticSchemaMetadata {
 /** Extension point for legacy plugin metadata removed from the canonical Schema shape. */
 export interface LegacySemanticSchemaMetadata {
 }
-export interface SemanticPropertyDraft extends Omit<PropertyTypeDraft, '_id' | '_sid' | 'id' | 'sid' | 'type' | 'primal_type' | 'isArray' | 'granularity' | 'is_observation' | 'is_snapshot' | 'temporalSemantics' | 'is_dynamic' | 'udf' | 'is_comparable' | 'comparable_order'> {
+export interface SemanticPropertyDraft extends Omit<PropertyTypeDraft, '_id' | '_sid' | 'id' | 'sid' | 'type' | 'primal_type' | 'isArray' | 'granularity' | 'is_observation' | 'is_snapshot' | 'temporalSemantics' | 'is_dynamic' | 'udf' | 'is_comparable' | 'comparable_order' | 'hierarchy'> {
     readonly id?: string;
     readonly type: string;
     readonly primal_type?: PrimalType;
@@ -39,6 +44,8 @@ export interface SemanticPropertyDraft extends Omit<PropertyTypeDraft, '_id' | '
     readonly udf?: PropertySqlDefinition;
     readonly comparable?: ComparableCategoryDefinition;
     readonly timeWatermark?: TimeWatermarkPolicy;
+    /** Same-Schema drill relationship. `up` identifies the single-valued parent Property. */
+    readonly hierarchy?: PropertyHierarchyDefinition;
 }
 export interface ResolvedSemanticProperty extends Omit<SemanticPropertyDraft, 'id' | 'primal_type' | 'isArray' | 'is_dynamic'> {
     readonly id: string;