Class SessionManager

Manages Matter sessions associated with peer connections.

Constructors

constructor

new SessionManager(context): SessionManager
Parameters
- context: SessionManagerContext
Returns SessionManager
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:46

Accessors

construction

get construction(): Construction<SessionManager>
Returns Construction<SessionManager>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:48

context

get context(): SessionManagerContext
Returns SessionManagerContext
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:49

insecureSessions

get insecureSessions(): Map<NodeId, InsecureSession>
Active insecure sessions.

Returns Map<NodeId, InsecureSession>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:57

owner

get owner(): unknown
Returns unknown
Deprecated
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:85

resubmissionStarted

get resubmissionStarted(): Observable<[session: Session], void>
Emits when resubmission is necessary due to timeout or network error.

Returns Observable<[session: Session], void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:77

sessionParameters

get sessionParameters(): SessionParameters
Our session parameters. These are the parameters we provide during session negotiation. The peer may specify different parameters.

Returns SessionParameters
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:62
set sessionParameters(parameters): void
Change session parameters.

Parameters values you omit in parameters will retain their current values. This only affects new sessions.
Parameters
- parameters: Partial<SessionParameters>
Returns void
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:69

sessions

get sessions(): BasicSet<SecureSession, SecureSession>
Active secure sessions.

Returns BasicSet<SecureSession, SecureSession>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:53

subscriptionsChanged

get subscriptionsChanged(): Observable<[session: SecureSession, subscription: Subscription], void>
Emits when there is a change to the subscription set.

Returns Observable<[session: SecureSession, subscription: Subscription], void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:73

Methods

clear

clear(): Promise<void>
Returns Promise<void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:128

clearSubscriptionsForNode

clearSubscriptionsForNode(fabricIndex, nodeId, flushSubscriptions?): Promise<void>
Parameters
- fabricIndex: FabricIndex
- nodeId: NodeId
- OptionalflushSubscriptions: boolean
Returns Promise<void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:130

close

close(): Promise<void>
Returns Promise<void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:127

createInsecureSession

createInsecureSession(options): InsecureSession
Parameters
- options: {
      initiatorNodeId?: NodeId;
      isInitiator?: boolean;
      sessionParameters?: Partial<SessionParameters>;
  }
  - OptionalinitiatorNodeId?: NodeId
  - OptionalisInitiator?: boolean
  - OptionalsessionParameters?: Partial<SessionParameters>
Returns InsecureSession
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:86

createSecureSession

createSecureSession(args): Promise<SecureSession>
Parameters
- args: {
      caseAuthenticatedTags?: CaseAuthenticatedTag[];
      fabric: undefined | Fabric;
      isInitiator: boolean;
      isResumption: boolean;
      peerNodeId: NodeId;
      peerSessionId: number;
      peerSessionParameters?: Partial<SessionParameters>;
      salt: Uint8Array;
      sessionId: number;
      sharedSecret: Uint8Array;
  }
  - OptionalcaseAuthenticatedTags?: CaseAuthenticatedTag[]
  - fabric: undefined | Fabric
  - isInitiator: boolean
  - isResumption: boolean
  - peerNodeId: NodeId
  - peerSessionId: number
  - OptionalpeerSessionParameters?: Partial<SessionParameters>
  - salt: Uint8Array
  - sessionId: number
  - sharedSecret: Uint8Array
Returns Promise<SecureSession>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:91

deleteResumptionRecord

deleteResumptionRecord(address): Promise<void>
Parameters
- address: PeerAddress
Returns Promise<void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:103

deleteResumptionRecordsForFabric

deleteResumptionRecordsForFabric(fabric): Promise<void>
Parameters
- fabric: Fabric
Returns Promise<void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:104

fabricFor

fabricFor(address): Fabric
Convenience function for accessing a fabric by address.
Parameters
- address: FabricIndex | PeerAddress
Returns Fabric
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:81

findGroupSession

findGroupSession(groupId, groupSessionId): void
Parameters
- groupId: number
- groupSessionId: number
Returns void
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:112

findOldestInactiveSession

findOldestInactiveSession(): SecureSession
Returns SecureSession
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:105

findResumptionRecordByAddress

findResumptionRecordByAddress(address): undefined | ResumptionRecord
Parameters
- address: PeerAddress
Returns undefined | ResumptionRecord
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:114

findResumptionRecordById

findResumptionRecordById(resumptionId): undefined | ResumptionRecord
Parameters
- resumptionId: Uint8Array
Returns undefined | ResumptionRecord
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:113

getActiveSessionInformation

getActiveSessionInformation(): {
    fabric: undefined | ExposedFabricInformation;
    isPeerActive: boolean;
    lastActiveTimestamp: undefined | number;
    lastInteractionTimestamp: undefined | number;
    name: string;
    nodeId: NodeId;
    numberOfActiveSubscriptions: number;
    peerNodeId: NodeId;
    secure: boolean;
}[]
Returns {
    fabric: undefined | ExposedFabricInformation;
    isPeerActive: boolean;
    lastActiveTimestamp: undefined | number;
    lastInteractionTimestamp: undefined | number;
    name: string;
    nodeId: NodeId;
    numberOfActiveSubscriptions: number;
    peerNodeId: NodeId;
    secure: boolean;
}[]
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:116

getNextAvailableSessionId

getNextAvailableSessionId(): Promise<number>
Returns Promise<number>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:106

getPaseSession

getPaseSession(): SecureSession
Returns SecureSession
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:108

getSession

getSession(sessionId): undefined | SecureSession
Parameters
- sessionId: number
Returns undefined | SecureSession
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:107

getSessionForNode

getSessionForNode(address): undefined | SecureSession
Parameters
- address: PeerAddress
Returns undefined | SecureSession
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:109

getUnsecureSession

getUnsecureSession(sourceNodeId?): undefined | InsecureSession
Parameters
- OptionalsourceNodeId: NodeId
Returns undefined | InsecureSession
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:111

removeAllSessionsForNode

removeAllSessionsForNode(address, sendClose?): Promise<void>
Parameters
- address: PeerAddress
- OptionalsendClose: boolean
Returns Promise<void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:110

saveResumptionRecord

saveResumptionRecord(resumptionRecord): Promise<void>
Parameters
- resumptionRecord: ResumptionRecord
Returns Promise<void>
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:115

updateAllSubscriptions

updateAllSubscriptions(): void
Returns void
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:129

`Static`[create]

[create](env): SessionManager
Parameters
- env: Environment
Returns SessionManager
- Defined in packages/protocol/dist/esm/session/SessionManager.d.ts:47

Class SessionManager

Index

Constructors

Accessors

Methods

Constructors

constructor

Parameters

Returns SessionManager

Accessors

construction

Returns Construction<SessionManager>

context

Returns SessionManagerContext

insecureSessions

Returns Map<NodeId, InsecureSession>

owner

Returns unknown

Deprecated

resubmissionStarted

Returns Observable<[session: Session], void>

sessionParameters

Returns SessionParameters

Parameters

Returns void

sessions

Returns BasicSet<SecureSession, SecureSession>

subscriptionsChanged

Returns Observable<[session: SecureSession, subscription: Subscription], void>

Methods

clear

Returns Promise<void>

clearSubscriptionsForNode

Parameters

Returns Promise<void>

close

Returns Promise<void>

createInsecureSession

Parameters

OptionalinitiatorNodeId?: NodeId

OptionalisInitiator?: boolean

OptionalsessionParameters?: Partial<SessionParameters>

Returns InsecureSession

createSecureSession

Parameters

OptionalcaseAuthenticatedTags?: CaseAuthenticatedTag[]

fabric: undefined | Fabric

isInitiator: boolean

isResumption: boolean

peerNodeId: NodeId

peerSessionId: number

OptionalpeerSessionParameters?: Partial<SessionParameters>

salt: Uint8Array

sessionId: number

sharedSecret: Uint8Array

Returns Promise<SecureSession>

deleteResumptionRecord

Parameters

Returns Promise<void>

deleteResumptionRecordsForFabric

Parameters

Returns Promise<void>

fabricFor

Parameters

Returns Fabric

findGroupSession

Parameters

Returns void

findOldestInactiveSession

Returns SecureSession

findResumptionRecordByAddress

Parameters

Returns undefined | ResumptionRecord

findResumptionRecordById

Parameters

Returns undefined | ResumptionRecord

getActiveSessionInformation

Returns { fabric: undefined | ExposedFabricInformation; isPeerActive: boolean; lastActiveTimestamp: undefined | number; lastInteractionTimestamp: undefined | number; name: string; nodeId: NodeId; numberOfActiveSubscriptions: number; peerNodeId: NodeId; secure: boolean; }[]

getNextAvailableSessionId

Returns Promise<number>

`Optional`initiatorNodeId?: NodeId

`Optional`isInitiator?: boolean

`Optional`sessionParameters?: Partial<SessionParameters>

`Optional`caseAuthenticatedTags?: CaseAuthenticatedTag[]

`Optional`peerSessionParameters?: Partial<SessionParameters>

Returns {
fabric: undefined | ExposedFabricInformation;
isPeerActive: boolean;
lastActiveTimestamp: undefined | number;
lastInteractionTimestamp: undefined | number;
name: string;
nodeId: NodeId;
numberOfActiveSubscriptions: number;
peerNodeId: NodeId;
secure: boolean;
}[]

`Static`[create]