Interface IGraphOverlayStore

Strongly-typed persistence & lookup adapter for MJ: Graph Concepts and MJ: Graph Edges.

Decouples GraphStage from direct BaseEntity.Get() / .Set() calls and allows deterministic in-memory stores in unit tests and dry runs.

interface IGraphOverlayStore {
    LoadAuthorityTiers?(
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<GraphAuthorityTierDescriptor[]>;
    LoadConceptTypes?(
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<GraphConceptTypeDescriptor[]>;
    LoadExistingConcepts(
        graphID: string,
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<ExistingGraphConceptSeed[]>;
    LoadGroundingTargets?(
        groundingMode: GraphGroundingMode,
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<SchemaGroundingTarget[]>;
    LoadItemChunks?(
        contentItemID: string,
        contentSourceID: string,
        contentItemTitle: string,
        tags: readonly string[],
        authorityTier: GraphAuthorityTier,
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<ContentChunkSeedInput[]>;
    LoadItemTags?(
        contentItemID: string,
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<string[]>;
    UpsertConcept(
        graphID: string,
        concept: SynthesizedGraphConcept,
        status: GraphStageUpsertStatus,
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<string>;
    UpsertEdges(
        graphID: string,
        conceptID: string,
        edges: readonly SynthesizedGraphEdge[],
        status: GraphStageUpsertStatus,
        contextUser: UserInfo,
        provider: IMetadataProvider,
    ): Promise<number>;
}

Implemented by

EntityGraphOverlayStore

Index

Methods

LoadAuthorityTiers? LoadConceptTypes? LoadExistingConcepts LoadGroundingTargets? LoadItemChunks? LoadItemTags? UpsertConcept UpsertEdges

Methods

`Optional`LoadAuthorityTiers

LoadAuthorityTiers?(
contextUser: UserInfo,
provider: IMetadataProvider,
): Promise<GraphAuthorityTierDescriptor[]>
Optional loader for active MJ: Graph Authority Tiers (__mj.GraphAuthorityTier) to resolve AuthorityTierID and rank order.
Parameters
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<GraphAuthorityTierDescriptor[]>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:95

`Optional`LoadConceptTypes

LoadConceptTypes?(
contextUser: UserInfo,
provider: IMetadataProvider,
): Promise<GraphConceptTypeDescriptor[]>
Optional loader for active MJ: Graph Concept Types (__mj.GraphConceptType) to resolve ConceptTypeID and rank order.
Parameters
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<GraphConceptTypeDescriptor[]>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:89

LoadExistingConcepts

LoadExistingConcepts(
    graphID: string,
    contextUser: UserInfo,
    provider: IMetadataProvider,
): Promise<ExistingGraphConceptSeed[]>
Load existing concepts in the target graph for deduplication and hierarchy resolution.
Parameters
- graphID: string
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<ExistingGraphConceptSeed[]>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:82

`Optional`LoadGroundingTargets

LoadGroundingTargets?(
    groundingMode: GraphGroundingMode,
    contextUser: UserInfo,
    provider: IMetadataProvider,
): Promise<SchemaGroundingTarget[]>
Load candidate MJ schema/operational targets for grounding edges (Describes, Defines, Measures, Implements).
Parameters
- groundingMode: GraphGroundingMode
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<SchemaGroundingTarget[]>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:101

`Optional`LoadItemChunks

LoadItemChunks?(
    contentItemID: string,
    contentSourceID: string,
    contentItemTitle: string,
    tags: readonly string[],
    authorityTier: GraphAuthorityTier,
    contextUser: UserInfo,
    provider: IMetadataProvider,
): Promise<ContentChunkSeedInput[]>
Optional override for loading chunks when not present on record.Children.
Parameters
- contentItemID: string
- contentSourceID: string
- contentItemTitle: string
- tags: readonly string[]
- authorityTier: GraphAuthorityTier
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<ContentChunkSeedInput[]>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:108

`Optional`LoadItemTags

LoadItemTags?(
    contentItemID: string,
    contextUser: UserInfo,
    provider: IMetadataProvider,
): Promise<string[]>
Optional override for loading tag names when not present on record.GetExtension('Tag', 'tags').
Parameters
- contentItemID: string
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<string[]>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:119

UpsertConcept

UpsertConcept(
    graphID: string,
    concept: SynthesizedGraphConcept,
    status: GraphStageUpsertStatus,
    contextUser: UserInfo,
    provider: IMetadataProvider,
): Promise<string>
Upsert a synthesized concept into the target graph and return its persisted record ID.
Parameters
- graphID: string
- concept: SynthesizedGraphConcept
- status: GraphStageUpsertStatus
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<string>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:126

UpsertEdges

UpsertEdges(
    graphID: string,
    conceptID: string,
    edges: readonly SynthesizedGraphEdge[],
    status: GraphStageUpsertStatus,
    contextUser: UserInfo,
    provider: IMetadataProvider,
): Promise<number>
Upsert synthesized edges anchored at the persisted concept ID.
Parameters
- graphID: string
- conceptID: string
- edges: readonly SynthesizedGraphEdge[]
- status: GraphStageUpsertStatus
- contextUser: UserInfo
- provider: IMetadataProvider
Returns Promise<number>
- Defined in ContentPipeline/engine/src/stages/GraphStage.ts:135

Interface IGraphOverlayStore

Implemented by

Index

Methods

Methods

`Optional`LoadAuthorityTiers

Parameters

Returns Promise<GraphAuthorityTierDescriptor[]>

`Optional`LoadConceptTypes

Parameters

Returns Promise<GraphConceptTypeDescriptor[]>

LoadExistingConcepts

Parameters

Returns Promise<ExistingGraphConceptSeed[]>

`Optional`LoadGroundingTargets

Parameters

Returns Promise<SchemaGroundingTarget[]>

`Optional`LoadItemChunks

Parameters

Returns Promise<ContentChunkSeedInput[]>

`Optional`LoadItemTags

Parameters

Returns Promise<string[]>

UpsertConcept

Parameters

Returns Promise<string>

UpsertEdges

Parameters

Returns Promise<number>

Settings

On This Page

Interface IGraphOverlayStore

Implemented by

Index

Methods

Methods

OptionalLoadAuthorityTiers

Parameters

Returns Promise<GraphAuthorityTierDescriptor[]>

OptionalLoadConceptTypes

Parameters

Returns Promise<GraphConceptTypeDescriptor[]>

LoadExistingConcepts

Parameters

Returns Promise<ExistingGraphConceptSeed[]>

OptionalLoadGroundingTargets

Parameters

Returns Promise<SchemaGroundingTarget[]>

OptionalLoadItemChunks

Parameters

Returns Promise<ContentChunkSeedInput[]>

OptionalLoadItemTags

Parameters

Returns Promise<string[]>

UpsertConcept

Parameters

Returns Promise<string>

UpsertEdges

Parameters

Returns Promise<number>

Settings

On This Page

`Optional`LoadAuthorityTiers

`Optional`LoadConceptTypes

`Optional`LoadGroundingTargets

`Optional`LoadItemChunks

`Optional`LoadItemTags